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.
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
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.
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.
- Oas file url https://console.openapi.com/oas/fr/sdi.openapi.json
- Fork or import with Postman
- Production domain sdi.openapi.it
- Sandbox domain test.sdi.openapi.it
-
Production Scopes 21
- GET sdi.openapi.it/invoices
- POST sdi.openapi.it/invoices
- GET sdi.openapi.it/invoices_download
- DELETE sdi.openapi.it/business_registries
- POST sdi.openapi.it/business_registry_configurations
- POST sdi.openapi.it/api_configurations
- DELETE sdi.openapi.it/api_configurations
- GET sdi.openapi.it/api_configurations
- DELETE sdi.openapi.it/business_registry_configurations
- GET sdi.openapi.it/business_registry_configurations
- GET sdi.openapi.it/invoices_notifications
- POST sdi.openapi.it/supplier_invoice_imports
- POST sdi.openapi.it/customer_invoice_imports
- GET sdi.openapi.it/invoices_stats
- PATCH sdi.openapi.it/business_registry_configurations
- POST sdi.openapi.it/invoices_signature
- POST sdi.openapi.it/invoices_legal_storage
- POST sdi.openapi.it/invoices_signature_legal_storage
- POST sdi.openapi.it/supplier_invoice_imports_legal_storage
- POST sdi.openapi.it/customer_invoice_imports_legal_storage
- POST sdi.openapi.it/simulate-supplier-invoice
-
Sandbox Scopes 20
- GET test.sdi.openapi.it/invoices
- POST test.sdi.openapi.it/invoices
- GET test.sdi.openapi.it/invoices_download
- POST test.sdi.openapi.it/business_registry_configurations
- POST test.sdi.openapi.it/api_configurations
- DELETE test.sdi.openapi.it/api_configurations
- GET test.sdi.openapi.it/api_configurations
- DELETE test.sdi.openapi.it/business_registry_configurations
- GET test.sdi.openapi.it/business_registry_configurations
- GET test.sdi.openapi.it/invoices_notifications
- POST test.sdi.openapi.it/supplier_invoice_imports
- POST test.sdi.openapi.it/customer_invoice_imports
- GET test.sdi.openapi.it/invoices_stats
- PATCH test.sdi.openapi.it/business_registry_configurations
- POST test.sdi.openapi.it/invoices_signature
- POST test.sdi.openapi.it/invoices_legal_storage
- POST test.sdi.openapi.it/invoices_signature_legal_storage
- POST test.sdi.openapi.it/supplier_invoice_imports_legal_storage
- POST test.sdi.openapi.it/customer_invoice_imports_legal_storage
- POST test.sdi.openapi.it/simulate