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 les associations et les coopératives, le service Tickets de caisse est activé via une procédure guidée gérée par notre équipe d’assistance.
Pour demander l’activation :
- Achetez le forfait Assistance Premium (2 heures)
- Ouvrez un ticket d’assistance en précisant la demande d’activation du service Tickets de caisse pour une Association/Coopérative
L’un de nos conseillers vous recontactera dans les plus brefs délais afin de vous terminer la configuration.
Au cours de la procédure, il sera nécessaire de fournir les informations du représentant légal. En outre, le représentant légal devra disposer d’un accès au Cassetto Fiscale (portail fiscal italien) avec ses propres identifiants (nom d’utilisateur et mot de passe), requis pour finaliser correctement l’activation du service.
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, le service prend en charge la gestion de plusieurs entreprises. Pour activer la facturation pour chaque entreprise, il suffit d'effectuer la procédure de configuration dédiée via le point de terminaison Business Registry Configuration, en répétant l'opération pour chaque entreprise que vous souhaitez activer.
Une fois la configuration terminée, chaque entreprise pourra utiliser le service de manière indépendante avec ses propres paramètres de facturation.
Non, mais au-delà de 10 configurations, un coût supplémentaire de 1 € est appliqué.
Oui, les factures électroniques destinées à la Publique Administration sont automatiquement signées par le système avant leur envoi.
Il est également possible d’utiliser un certificat de signature personnalisé en activant la signature électronique qualifiée automatique (QES Automatic) via Openapi à l’aide du point de terminaison dédié POST /certificates/namirial-automatic. Une fois activé, il sera nécessaire d’inclure les identifiants du service dans l’en-tête de la requête d’envoi des factures, afin de permettre la signature avec le certificat configuré.
En cas d’utilisation d’une signature personnalisée, en plus du coût d’activation du certificat, des frais par signature s’appliquent à hauteur de 0,013 € avec un abonnement ou 0,045 € avec un système de rechargement.
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
Pour finaliser la configuration, vous pouvez enregistrer ce code directement dans la section dédiée du portail de l’Agence des revenus italienne. Pour plus de détails, veuillez consulter notre guide de configuration du code destinataire.
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.
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
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.
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.