Facturation Électronique SDI

  1. Home
  2. Bibliothèque d'API
  3. Facturation Électronique SDI
Facturation électronique facile, rapide et avec des normes de sécurité élevées

Automatise l'envoi, la signature, la réception et le stockage numérique des factures électroniques via l'API

Toutes les connaissances dont vous avez besoin

Vous trouverez ici quelques conseils à prendre en compte pour aborder cette API. Si vous préférez, nous fournissons des exemples de code, la documentation OAS3, la possibilité d'essayer l'API en direct via Swagger UI ou d'importer l'intégralité de la collection dans Postman. Nous proposons également un environnement Sandbox où vous pouvez expérimenter toutes sortes de requêtes de manière totalement gratuite.

Conseils utiles pour commencer Facturation Électronique SDI

Obtenir le Token dans la section appropriée avant de commencer.

Utilisez l'outil en ligne ou générez-le via l'API. Définissez la date d'expiration, un nom utile et ajoutez maintenant un ensemble d'étendues pour limiter les actions possibles que votre jeton peut effectuer.
En savoir plus sur l'API oauth Gérer mes jetons

Configurer l'entreprise

Configurer l'entreprise avec /business_registry_configurations en choisissant entre les types de factures suivants : facture normale, facture signée et facture signée et conservée. Si vous avez choisi d'activer la conservation, les informations d'identification seront envoyées à l'adresse e-mail indiquée lors de la configuration. Attention, l'adresse e-mail et le numéro de TVA sont des données uniques. Cette opération doit être effectuée uniquement lorsque vous configurez l'entreprise pour la première fois.

Configurer les notifications pour gérer les approbations et les rejets

Configurer les callbacks avec /api_configurations en définissant une ou plusieurs de ces options si nécessaire : 'supplier-invoice' (facture passive), 'customer-invoice' (facture active), 'customer-notification' (notification de rejet ou d'acceptation), 'legal-storage-missing-vat', 'legal-storage-receipt' (reçu de conservation). De cette façon, vous recevrez un appel avec l'objet facture directement à l'URL que vous avez fournie.
Cette opération doit être effectuée uniquement lorsque vous configurez l'entreprise pour la première fois.
Si vous êtes intéressé par le cycle passif, suivez d'abord ce guide : https://openapi.it/en/blog/register-recipient-code-italian-revenue-agency.html

Envoyer la première facture

Utilisez les endpoints /invoices, /invoices_signature, /invoices_legal_storage ou /invoices_signature_legal_storage en fonction de vos besoins. Ils permettent d'envoyer la facture en mode XML (compatible avec la norme XML de facturation) ou en mode JSON.
Une fois la facture envoyée, la notification sera reçue à l'URL indiquée dans la configuration des notifications.
La réponse à un envoi de facture contiendra un uuid qui pourra être utilisé ultérieurement pour récupérer la facture /invoices, les notifications éventuelles /invoices_notifications ou télécharger la facture /invoices_download.