Envoyez des reçus électroniques et des factures à l’Agence fiscale facilement, rapidement et en toute sécurité
Automatisez l’envoi en temps réel des documents commerciaux et des factures électroniques via API, en garantissant la conformité réglementaire, la fiabilité opérationnelle et une sécurité maximale.
Pour configurer correctement une entreprise aux fins de la gestion de la facturation électronique B2B et vers l’Administration Publique, les données suivantes sont requises :
- Identifiant fiscal de l’entreprise (Code fiscal ou Numéro de TVA)
- Raison sociale
- Adresse e-mail pour l’envoi de communications et notifications (L’adresse e-mail indiquée ne pourra pas être modifiée après la création de la configuration.)
Lors de la configuration, il est également nécessaire de préciser comment vous souhaitez utiliser le service :
- Envoi uniquement de factures actives (customer_invoice)
- Réception uniquement de factures passives (supplier_invoice)
- Gestion complète du cycle de facturation (actif et passif)
Pour activer les fonctionnalités souhaitées, les champs correspondants doivent être définis sur true lors de la requête.
Il est également possible de configurer les types d’événements pour lesquels vous souhaitez recevoir des notifications.
Note importante pour la réception des factures passives
Pour recevoir correctement les factures des fournisseurs, il ne suffit pas de définir le champ supplier_invoice sur true. Il est nécessaire d’enregistrer notre Code Destinataire (PIC7CPS) sur le site de l’Agence des Revenus italienne (Agenzia delle Entrate) afin d’associer correctement le canal de réception.
Les informations nécessaires sont :
- Code fiscal
- Nom de l’entreprise
- Code fiscal
- Mot de passe
- PIN
Il est également nécessaire de définir le champ « receipts » sur true.
Les données doivent appartenir au sujet responsable de l’envoi des reçus. Par conséquent, si vous développez pour des tiers, les identifiants doivent être ceux du client final.
Les identifiants d’accès doivent être mis à jour trimestriellement, car l’Agence des Revenus italienne expire périodiquement les identifiants.
À cette étape, il est également possible de configurer les types d’événements pour lesquels recevoir des notifications.
Oui. Avec Openapi, il est possible de gérer, pour une même entreprise, à la fois l’ensemble du cycle de facturation électronique B2B et vers l’Administration Publique, ainsi que l’envoi des documents commerciaux (reçus électroniques) à l’Agence des Revenus italienne, en utilisant une seule API.
Lors de la configuration, il suffit de définir sur true les champs suivants :
- customer_invoice (factures actives)
- supplier_invoice (factures passives)
- receipts (documents commerciaux)
De cette manière, toutes les fonctionnalités nécessaires peuvent être activées via une seule intégration.
Oui, il est possible d’activer plusieurs entreprises en complétant la procédure de configuration via l’endpoint dédié (Business Registry Configuration).
Non, mais au-delà de 10 configurations, un coût supplémentaire de 1 € est appliqué.
Oui. Les factures électroniques destinées à l’Administration Publique sont automatiquement signées par le système avant l’envoi.
Lors de la transmission, il est toutefois possible de fournir les identifiants de votre propre certificat en utilisant le service EU-QES_automatic si vous souhaitez appliquer une signature numérique personnalisée.
En l’absence de certificat personnalisé, la signature numérique par défaut du service sera appliquée.
Oui, vous pouvez importer l’historique des factures via l’endpoint POST /IT-invoices_import.
Oui. Via l’endpoint PATCH /IT-configuration, il est possible de mettre à jour à tout moment différentes informations, notamment :
- Activation ou désactivation du service d’envoi de reçus (receipts)
- Identifiants d’authentification
- Types de notifications pour les événements
Note importante : il n’est pas possible de modifier l’adresse e-mail indiquée lors de la configuration. Il est donc essentiel de saisir dès le départ l’adresse correcte, car elle sera utilisée pour toutes les communications et notifications.
Les principales causes peuvent être :
- La configuration n’a pas été complétée correctement.
- Vous n’avez pas de crédit disponible.
Pour recevoir les factures passives, il est nécessaire de :
- Effectuer la configuration via POST /api_configurations.
- Définir la valeur supplier_invoice comme indiqué dans la documentation. Les factures seront ainsi envoyées au callback spécifié.
Vous pourrez ensuite les récupérer via GET /invoices.
IMPORTANT : si le crédit disponible est épuisé, les factures passives ne seront plus livrées.
Le Code Destinataire à définir pour la réception des factures est : PIC7CPS
Non. Si vous n’avez pas besoin de recevoir des factures passives, il n’est pas nécessaire d’enregistrer un Code Destinataire.
Oui. Lors de la récupération d’un reçu individuel, vous pouvez le télécharger au format JSON par défaut ou en PDF. Pour obtenir le PDF, il suffit de définir l’en-tête Content-Type sur "application/pdf".
Il est possible de configurer des notifications pour les événements suivants :
- receipt : lorsqu’un nouveau reçu est envoyé et prêt
- receipt-credentials : lorsqu’il y a des mises à jour des identifiants
- receipt-retry : lorsque la communication avec le portail de l’Agence des Revenus échoue et qu’une nouvelle tentative d’envoi sera effectuée
- customer-invoice : lorsqu’un changement d’état intervient sur les factures actives
- supplier-invoice : lorsqu’un changement d’état intervient sur les factures passives
- receipt-error : lorsque l’Agence des Revenus (AdE) renvoie une erreur pour un reçu électronique
Le système archive et rend disponibles les réponses relatives aux envois, annulations et retours des reçus pendant 12 mois. Passé ce délai, les données sont automatiquement supprimées.
Le service envoie les reçus électroniques en temps réel. Les délais de réponse dépendent de l’Agence des Revenus italienne.
Le coût est facturé en cas d’envoi, d’annulation et de retour.
Un coût supplémentaire de 1 € est appliqué au-delà de 10 configurations Business.
Dans la section Utilisation, au niveau de l’API, vous pouvez surveiller toutes les requêtes effectuées, qu’elles soient gratuites, via abonnement ou via crédit.
Deux modes d’affichage sont disponibles :
- Vue graphique : périodes mensuelles ou annuelles
- Résumé textuel : avec le détail de la consommation
Reçu fiscal : à partir de 0,009 € avec abonnement ou 0,019 € avec débit sur crédit
Factures électroniques : à partir de 0,049 € avec abonnement ou 0,154 € avec débit sur crédit
Oui, vous pouvez activer un abonnement annuel afin de réduire le coût par appel, aussi bien pour les reçus électroniques que pour les factures électroniques.
Dans la section Abonnements de chaque API, vous pouvez :
- Visualiser les options disponibles avec les prix et les pourcentages d’économie
- Activer l’abonnement de votre choix directement depuis l’interface.