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
Pour implémenter et utiliser correctement le service de facturation, nous vous recommandons de suivre pas à pas la documentation.
Les étapes clés sont:
-
Création de la Business Registry Configuration via POST /business_registry_configurations
Cela permet de configurer et de gérer les données de votre entreprise ou celles de vos clients, notamment les options de signature et de stockage légal.
ATTENTION: Une fois la configuration terminée, vous ne pourrez utiliser que l'endpoint correspondant à l'option choisie. -
Configuration des endpoints de notification via POST /api_configurations
Indiquez tous les événements pour lesquels vous souhaitez recevoir une notification. Toutes les notifications reçues du SDI seront envoyées aux endpoints configurés.
REMARQUE: Cette étape est indispensable pour recevoir les factures fournisseurs. Pour cela, vous devez également enregistrer notre Code Destinataire (JKKZDGR) sur le site de l'Agenzia delle Entrate. -
Envoi de la facture via POST /invoices
Cet endpoint permet d'envoyer des factures électroniques au Système d'Échange (SdI) en temps réel.
Openapi permet également d'importer les factures fournisseurs et clients via les endpoints listés sous "Import" dans la documentation.
Non, l'email renseigné lors de la configuration ne peut pas être modifié. Il est donc essentiel d'indiquer une adresse correcte à ce stade.
Non, si vous n'avez pas besoin de recevoir des factures fournisseurs, vous n'êtes pas obligé d'enregistrer le code destinataire.
Si votre compte a été suspendu pour insuffisance de crédit, vous pouvez le réactiver en envoyant une requête à PATCH /business_registry_configurations/{fiscal_id}/activate.
REMARQUE: Dès que votre compte est suspendu, vous recevez également un e-mail de rappel avec les instructions pour le réactiver, alors n'oubliez pas de vérifier votre boîte de réception.
Il y a deux raisons possibles pour lesquelles vous ne recevez pas les factures:
- Vous n'avez pas effectué la configuration
- Vous n'avez pas de crédit
Pour recevoir les factures, vous devez configurer le service via l'endpoint POST/api_configurations.
En particulier, vous devez définir la valeur "supplier-invoice" comme indiqué dans la documentation, et les factures seront envoyées au callback spécifié.
Vous pourrez ensuite récupérer les factures via GET/invoices.
IMPORTANT: Si le crédit est épuisé, les factures fournisseurs cessent d'être envoyées.
Non, aucune implémentation technique spécifique n’est nécessaire. Cependant, pour des raisons de sécurité, vous devez ouvrir un ticket pour demander l’ajout de votre domaine à notre liste blanche.
Il est possible d'activer la facturation pour l'envoi au Sdi, avec signature électronique et/ou avec stockage réglementaire.
Vous pouvez définir les options de facturation via l'endpoint POST /business_registry_configurations.
Cette première requête vous permet notamment d'indiquer si vous souhaitez utiliser l'API exclusivement pour l'envoi et la réception de factures ou si vous souhaitez également activer l'option de signature (apply_signature) et/ou le stockage conforme à la réglementation (apply_legal_storage).
Une fois la configuration terminée, il ne sera possible d'utiliser que l'endpoint de l'option définie.
Le service vous permet, en plus de l'envoi, d'ajouter la signature électronique à la facture électronique XML via l'endpoint POST /invoices_signature.
Cela permet de garantir l'intégrité des données contenues. Une facture signée a une plus grande "robustesse" juridique qu'un document non signé.
La signature est obligatoire pour les factures électroniques adressées à l'autorité de paiement.
L'API Facturation électronique SDI permet d'envoyer des factures électroniques XML au système d'échange (SdI) en temps réel via le point de terminaison POST /invoices.
En particulier, le format doit être explicité au stade de la demande à l'aide de l'en-tête content-type. La facture sera immédiatement mise en file d'attente et l'UUID de la facture sera obtenu comme rappel.
Vous pouvez envoyer et activer le stockage conforme à la réglementation pendant 10 ans pour les factures électroniques actives et passives via l'endpoint POST /invoices_legal_storage par l'intermédiaire de l'API.
Le stockage légal est obligatoire et garantit l'authenticité, l'intégrité, la fiabilité, la lisibilité et la récupération des factures. Le stockage conforme à la réglementation disponible via Openapi est conforme à la réglementation eIDAS.
Oui, l'endpoint POST /invoices_signature_legal_storage vous permet d'exécuter l'ensemble du processus de signature, d'envoi vers SDI et de stockage conforme à la réglementation en une seule demande.
Oui, vous pouvez importer via l'API l'historique des factures actives (via l'endpoint POST /customer_invoice_imports) et des factures passives (endpoint POST /supplier_invoice_imports).
En outre, il est possible d'envoyer des factures actives (via l'endpoint POST /customer_invoice_imports_legal_storage) et passives (endpoint POST /supplier_invoice_imports_legal_storage) au stockage.
Le code destinataire à définir est JKKZDGR.
Le mot "euro" doit être inscrit dans la description de la facture, sinon le système peut demander une confirmation manuelle.
Si le client est un particulier, le code SdI est toujours "0000000" (sept fois zéro).
Le service renvoie une réponse en temps réel.
Le coût de l'envoi d'une facture à la SdI est de 0,025 € par abonnement, soit 0,07 € par demande individuelle.
Le coût du stockage de la facture électronique est de 0,035 € et celui de la signature de la facture électronique est de 0,02 €.
Oui, il est possible d'activer un abonnement annuel et d'économiser ainsi sur le coût d'un appel unique.
Dans la section Abonnement de chaque API, vous pouvez voir les options disponibles (avec leurs prix et le pourcentage d'économie) et vous pouvez également activer l'abonnement de votre choix.
Dans la section Utilisation, au niveau de l'API, vous pouvez suivre vos demandes gratuites et vos demandes d'abonnement ou de recharge. Elles sont disponibles à la fois en mode graphique (période, mois et année) et avec un résumé textuel.