Business Person - matteo.marengo@syensqo.com

Useful SAP Note: https://me.sap.com/notes/3611572

SDI EDOCUMENT ITALY SDI UPLOAD GUIDE

The SdI Upload tool for eDocument Italy package allows you manually upload notifications and invoices from Tax Authority portal (SdI) to your CPI tenant. In some cases SdI fails to submit invoices or notifications to CPI tenant. After several retries SdI stops retrying and the only way to submit missing data is manual upload. first your download from SdI web site missing data, then you upload them to your CPI tenant using this tool.

1. Provide Permissions
   1. Open CP Account Cockpit of your CPI tenant. Go to Authorisations.
   2. Grant to your user a role "ESBMessaging.send" from xxxxiflmap application. If you use SSO to login to CP web ui, grant same role to a user <user>@sso_ca where <user> is your user name.
   3. If you use Cloud Foundry environment then it is needed to create a service key with your user certificate.
2. Configure Integration Flow "SdI Upload App" (optional) 
   1. If necessary, change default settings of the tool. Normally this step is not required.
      1. receiveInvoiceEndpoint:  path to 'Italy Receive Invoice' integration flow (default /cxf/ItalyReceiveInvoice)
      2. receiveNotificationEndpoint: path to 'Italy Receive Notification' integration flow (default /cxf/ItalyReceiveNotification)
3. Deploy the Integration Flow "SdI Upload App"
   1. Deploy an integration flow "SdI Upload App".
   2. Go to Monitor -> Manage Integration Content. Wait till the integration flow gets status "Started" and copy its endpoint url to the clipboard.
   3. Note: Use the standard tenant runtime URL, not the SdI-specific custom ssl host configured for the SdI channel because your browser typically wont trust to server certificates deployed on that custom ssl host.
   4. Example of tool's URL: https://<host>/http/edocument_italy_sdi_upload/*
4. Use the tool
   1. Open the tool's URL in browser. The browser should display buttons for uploading invoices and invoice notifications.
   2. In case your browser is not configured for single-sign-on you will get a login popup, otherwise you will directly login into the tool using your SSO certificate. In case of issues (HTTP 403 Forbidden), check step 1 for necessary security settings of your user. You can also check the HTTP Access Log of your CPI tenant to troubleshoot login issues.
   3. Upload Invoice Notification
      1. Download an invoice notification from the Tax Authority portal.
      2. Click on 'Upload Invoice Notification'. Select the invoice notification file (or several files) and click "Upload!". The tool submits the data to your CPI tenant and displays the status.
      3. You can click "Start Again" to upload another invoice notification.
   4. Upload Invoice
      1. Download an invoice and its metadata from the Tax Authority portal. The supported metadata file is downloadable from a following section of the Tax Authority portal: Monitoraggio delle ricevute dei file trasmessi -> Dettaglio.
      2. Click on 'Choose files' button and select both invoice and its metadata file (or multiple files). Click on 'Correlate' button and in case if files are correct you will get Ok response for all files in Correlation column.
      3. To make a successful correlation the files for metadata should have the same name as invoice with additional postfix (_metaDato.xml) as in example: invoice: 12345.xml; metadata: 12345.xml_metaDato.xml;
      4. Click on 'Upload'. The tool submits the data to your CPI tenant and displays the status.
      5. You can click "Start Again" to upload another invoice(invoices).