Skip to content

sdi.md

Latest commit

 

History

History
74 lines (50 loc) · 4.13 KB

sdi.md

File metadata and controls

74 lines (50 loc) · 4.13 KB
Raw

SDI

Description

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 receive supplier invoices, you need to register our Recipient Code on the Italian Revenue Agency's website. Please follow this step-by-step guide and provide the following code when required: JKKZDGR

Get started:

  1. Create an BusinessRegistryConfiguration with POST /business_registry_configurations 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.

Endpoints

Method Path Summary
POST /business_registry_configurations Create a Business Registry Configuration
GET /business_registry_configurations Retrieve a list of Business Registry Configuration
GET /business_registry_configurations/{fiscal_id} Retrieve a Business Registry Configuration
DELETE /business_registry_configurations/{fiscal_id} Delete a Business Registry Configuration
PATCH /business_registry_configurations/{fiscal_id}/activate Re-activate a Business Registry Configuration
POST /api_configurations Create an ApiConfiguration for a fiscal_id
GET /api_configurations Retrieve a list of ApiConfigurations
DELETE /api_configurations/{id} Delete of ApiConfigurations
POST /invoices Create an invoice
GET /invoices Retrieve collection of Invoice resources.
POST /invoices_signature Create an invoice applying the signature
POST /invoices_legal_storage Create an invoice applying legal storage
POST /invoices_signature_legal_storage Create an invoice applying the signature and legal storage
GET /invoices/{uuid} Retrieve Invoice resource.
GET /invoices_download/{uuid} Download a Invoice resource.
GET /invoices_notifications/{uuid} Retrieve collection of Invoice notifications.
POST /customer_invoice_imports Import customer invoice (fattura attiva)
POST /supplier_invoice_imports Import supplier invoice (fattura passiva)
POST /customer_invoice_imports_legal_storage Import customer invoice (fattura attiva)
POST /supplier_invoice_imports_legal_storage Import supplier invoice (fattura passiva)
POST /simulate/{type} Service Simulate