SDI

Number of APIs: 21

This service allows you to handle interactions with the Italian SDI (Sistema Di Interscambio)

You can configure your account to send invoices directly to the legal storage by setting the api_configuration to your needs

Before we begin

In order to operate, you should register our Recipient Code on the Italian Revenue Agency's website. Please follow this step-by-step guide and provide the following code when needed: JKKZDGR

## Get started:

1. Create an BusinessRegistryConfiguration with POST /businessregistryconfigurations for your fiscal_id and your email

2. A mail will be sent to your address to activate the account on the legal storage platform, if required.

3. Create an ApiConfiguration for your BusinessRegistryConfiguration with POST /api_configurations. This endpoint can be configured to receive all the notifications with a callback.

4. Create an XML invoice on the endpoint relative to your configuration

To see an example of the callback objects, plese check the Callbacks tab in the /api_configurations request


Please note that in the English translation:

Customer invoices: Fatture attive

Supplier invoices: Fatture passive

Legal storage: Certificazione a norma

Interacting with the legal storage

Legal Storage is the service that enables the legal preservation for your documents. All the stored documents are available into the legal storage management software, a third party software.

When creating a BusinessRegistryConfiguration, you will be asked to provide an email address which will be registed on the platform. You will receive an email containing all the steps to complete the registration and access the platform.

Reactivating a BusinessRegistryConfiguration

If you receive a callback but you have no credit left on your wallet, your account will be temporarily suspended: when this happens, you will be sent a reminder email immediately. In order to re-activate it after a wallet recharge, you would need to submit a PATCH request to /business_registry_configurations/{fiscal_id}/activate

## Interacting with the Public Administration (PA)

Invoices to the Public Administration are automatically detected and signed.

Contact Support: Name: Support

1. business registry configurations-{fiscal id} - {{baseUrl}}/business_registry_configurations/:fiscal_id

GET {{baseUrl}}/business_registry_configurations/:fiscal_id

---

2. business registry configurations-{fiscal id} - {{baseUrl}}/business_registry_configurations/:fiscal_id

DELETE {{baseUrl}}/business_registry_configurations/:fiscal_id

---

3. business registry configurations-{fiscal id} - {{baseUrl}}/business_registry_configurations/:fiscal_id/activate

PATCH {{baseUrl}}/business_registry_configurations/:fiscal_id/activate

---

4. business registry configurations - {{baseUrl}}/business_registry_configurations

GET {{baseUrl}}/business_registry_configurations

---

5. api configurations - {{baseUrl}}/api_configurations

GET {{baseUrl}}/api_configurations?fiscal_id=<string>

---

6. api configurations - {{baseUrl}}/api_configurations/:id

DELETE {{baseUrl}}/api_configurations/:id

---

7. invoices - {{baseUrl}}/invoices

POST {{baseUrl}}/invoices

---

8. invoices - {{baseUrl}}/invoices

GET