Le service vous permet d'envoyer des reçus fiscaux à l'Agence des Revenus italienne (Fatture e Corrispettivi) rapidement et en toute sécurité, augmentant ainsi l'efficacité et réduisant les coûts. La solution API ne nécessite aucun abonnement, et le coût par facture commence à partir de 0,009 €.
Le service est conçu pour répondre à tous les besoins des clients, tels que l'envoi de reçus (document commercial en ligne), les annulations, les retours, les remises et les différents modes de paiement (ex. tickets restaurant ou paiements en espèces). Les reçus sont transmis en temps réel et gérés jusqu'à l'obtention d'une réponse positive de l'Agence des Revenus.
L'adoption des reçus électroniques élimine l'obligation de tenir un registre des reçus et de conserver des copies des documents commerciaux remis aux clients (comme cela était requis auparavant avec les copies de reçus fiscaux), optimisant ainsi les coûts et le temps opérationnel.
Le Reçu Électronique fait partie de API Invoice, la nouvelle API conçue pour rendre les services de facturation disponibles non seulement en Italie, mais aussi en Europe et à l'international.
Notre solution s'intègre parfaitement aux systèmes de gestion existants, garantissant la conformité aux réglementations italiennes et une gestion efficace des documents fiscaux. Il est possible de configurer et de gérer la transmission des reçus pour plusieurs entreprises (Configuration du Registre des Entreprises).
CONFIGURATION ENTREPRISE (DONNÉES DE LA SOCIÉTÉ)
Lors de la première demande, il sera nécessaire de configurer les données de l'entreprise souhaitant envoyer des reçus fiscaux. Pour les intégrateurs tiers, les informations du client final doivent être fournies, notamment :
- Code fiscal
- Nom de l'entreprise
- Données d'authentification de l'Agence des Revenus (Code fiscal, Mot de passe, PIN)
- Notifications spécifiques aux événements
Le code fiscal doit appartenir à la personne responsable de l'envoi des reçus électroniques pour l'entreprise et doit correspondre à celui défini dans l'Espace Privé de l'Agence des Impôts. Pour plus de détails, nous vous recommandons de consulter le guide dédié.
EXEMPLE DE DEMANDE DE CONFIGURATION
POST /IT-configurations
La demande doit être effectuée en se référant à l'endpoint suivant et en passant le code fiscal de l'entreprise :
https://invoice.openapi.com/IT-configurations/{fiscal_id}
Dans le payload, il sera nécessaire d'inclure les données mentionnées précédemment :
{
"fiscal_id": "string",
"name": "string",
"email": "string",
"receipts": "true",
"supplier_invoice": false,
"legal_storage": false,
"signature": false,
"receipts_authentication": {
"taxCode": "XXXXXXXXXXXXX",
"password": "1234567891****d",
"pin": "1********4"
},
"api_configurations": [
{
"event": "receipt",
"callback": {
"url": "https://your-server.site/123232"
}
},
{
"event": "receipt-error",
"callback": {
"url": "https://your-server.site/error"
}
}
]
}
À ce stade, il est essentiel d'activer le service de reçus en mettant le paramètre "receipts" à true pour activer l'envoi des reçus électroniques.
Les configurations existantes de l'entreprise peuvent être mises à jour à tout moment via une requête PATCH en passant le code fiscal.
ENVOI DES REÇUS FISCAUX
POST /IT-receipts
Lors de l'envoi d'un reçu fiscal, plusieurs articles peuvent être inclus dans le même reçu.
EXEMPLE DE DEMANDE DE REÇU ÉLECTRONIQUE
https://invoice.openapi.com/IT-receipts
Dans la demande d'envoi du reçu, les informations suivantes doivent être fournies pour chaque article :
- Quantité
- Description
- Prix unitaire TTC (unit_price*)
- Code du taux de TVA (vat_rate_code*)
- Montant de la remise appliquée (discount*)
- Statut de gratuité du produit (complimentary*)
- Montant payé en espèces en euros.
En outre, d'autres éléments liés au paiement peuvent être spécifiés, tels que le montant payé électroniquement ou via des tickets restaurant ainsi que les remises appliquées.
Il s'agit d'un exemple de charge utile de la demande d'accusé de réception électronique :
{
"fiscal_id": "YourCompanyFiscal_id",
"items": [
{
"quantity": 11,
"description": "test",
"unit_price": 10,
"vat_rate_code": "22",
"discount": 0,
"complimentary": true
}
],
"invoice_issuing": false,
"services_uncollected_amount": 0,
"goods_uncollected_amount": 0,
"electronic_payment_amount": 0,
"ticket_restaurant_payment_amount": 0,
"ticket_restaurant_quantity": 0,
"discount": 0,
"linked_receipt": "string",
"cash_payment_amount": 4.5
}
RÉPONSE D'ENVOI DE REÇU
La réponse inclura toutes les informations précédemment indiquées plus :
- ID : Identifiant unique du reçu.
- ID de la transaction : Identifiant attribué au document par l'Autorité fiscale.
- Date de création du document
- Code de la loterie
- Éventuel code et message d'erreur
- Numéro et date du document
- État du reçu (new, retry, submitted, ready, failed, voided)
- Type (vente, retour, annulation)
- Montant total du reçu, TVA incluse.
{
"data"
{
"fiscal_id": "YourCompanyFiscal_id",
"items": [
{
"quantity": 11,
"description": "test",
"unit_price": 10,
"vat_rate_code": "22",
"discount": 0,
"complimentary": true
}
],
"cash_payment_amount": 4.5,
"id": "679cd95***************23",
"invoice_issuing": false,
"services_uncollected_amount": 0,
"goods_uncollected_amount": 0,
"electronic_payment_amount": 0,
"ticket_restaurant_payment_amount": 0,
"ticket_restaurant_quantity": 0,
"discount": 0,
"linked_receipt": "string",
"lottery_code": null,
"created_at": "2025-01-31T14:08:20.000Z",
"error_message": null,
"error_code": null,
"total_amount": 0,
"document_number": "",
"document_date": null,
"transaction_id": null,
"owner": "[email protected]",
"create_timestamp": 1738332500,
"status": "new",
"type": "sale"
},
"success": true,
"message": "",
"error": null
}
Le service permet à tout moment d'accéder à la liste des reçus et de les filtrer par identifiant fiscal, numéro de document, état, date de création du document ou du reçu.
Notre API pour l'envoi de reçus fiscaux en Italie est la solution idéale pour simplifier et moderniser la gestion des documents fiscaux. Grâce à une intégration rapide et flexible, elle permet d'automatiser l'envoi des reçus de manière sécurisée et efficace, garantissant une pleine conformité avec les réglementations en vigueur. Elle est idéale pour tous les types d'entreprises tels que les chaînes de magasins, la GDO (Grande Distribution Organisée) et les logiciels de gestion qui souhaitent optimiser leurs flux opérationnels, réduire les erreurs, le papier et les délais de traitement.
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
Le Service de Reçu Électronique est une API qui permet d'envoyer des documents commerciaux de manière simple, rapide et sécurisée. Grâce à cette solution, vous pouvez gérer l'envoi des reçus électroniques en temps réel, même pour de grands volumes, et gérer des opérations telles que des annulations, des retours, des remises et différents modes de paiement (par exemple, les tickets restaurant et les paiements en espèces).
Ce service fait partie de l'API Invoice, une nouvelle API conçue pour offrir des solutions de facturation non seulement au niveau national, mais aussi au niveau européen et international.
Le Service API d'envoi de reçus est la solution idéale pour simplifier et moderniser la gestion des documents fiscaux. Grâce à une intégration rapide, flexible et sécurisée, il permet d'automatiser l'envoi des reçus, en garantissant une conformité totale aux réglementations en vigueur.
Il est parfait pour des activités telles que les chaînes de magasins, la grande distribution organisée (GDO) et les logiciels de gestion, qui souhaitent optimiser les flux opérationnels, réduire l'utilisation du papier et minimiser les erreurs, tout en accélérant les délais de traitement.
La réglementation actuelle n’oblige pas à remettre une copie du reçu au client. Toutefois, il est possible d’utiliser les données disponibles dans la réponse pour générer un PDF à envoyer numériquement ou à imprimer.
Le service est fourni en temps réel. Cependant, en cas de problèmes avec l'Agenzia delle Entrate, l'envoi restera en file d'attente jusqu'à ce que l'opération soit confirmée comme réussie.
Le Service de Reçu Électronique ne comporte pas de frais d'activation. Les frais varient en fonction de l'utilisation : pour chaque demande d'envoi, d'annulation ou de retour, le coût commence à 0,009 € pour un abonnement ou 0,019 € par demande unique avec crédit.
Le choix entre émettre une facture ou un reçu fiscal dépend principalement du type de client et de la nature de la transaction :
-
Client professionnel ou titulaire d’un numéro de TVA (B2B) :
- Facture obligatoire : Lorsque le client est une entreprise, un professionnel ou une entité (c'est-à-dire titulaire d’un numéro de TVA), la loi exige l’émission d’une facture. Cela permet notamment aux entreprises de déduire la TVA ou de comptabiliser correctement leurs coûts.
- Facture électronique : Dans les transactions entre entités basées en Italie (et pour les transactions avec les administrations publiques), la réglementation impose l’utilisation de la facturation électronique.
-
Client privé (B2C) :
- Reçu fiscal : Pour les ventes au détail destinées aux consommateurs finaux ne possédant pas de numéro de TVA, l’émission d’un reçu fiscal via une caisse enregistreuse agréée est généralement suffisante.
- Facture sur demande : Si un consommateur privé demande explicitement une facture (par exemple pour des raisons de garantie ou autres), le fournisseur est tenu de l’émettre, même si la transaction concerne un client final.
Oui, un service API (SdI) est disponible pour l’envoi et la réception de factures électroniques destinées aux entreprises et aux administrations publiques.
Oui, le service peut être entièrement intégré pour des tiers. Toutefois, pour l'activer, il est nécessaire d'utiliser les identifiants d'accès à l'Agenzia delle Entrate du destinataire des reçus.
Les API proposées par Openapi font partie des services définis par l'Agence des Revenus italienne comme "Velocizzatori" (Accélérateurs).
En plus de respecter toutes les directives imposées par l'Agence des Revenus, les identifiants des clients (conformément à la réglementation) ne sont pas stockés par Openapi. Seule leur empreinte est enregistrée (un encodage à sens unique qui ne permet pas de comprendre les identifiants mais uniquement de vérifier s'ils ont été modifiés).
Ainsi, les identifiants sont toujours gérés exclusivement par l'utilisateur, qui les utilise dans l'"accélérateur" pour finaliser l'envoi ou la lecture des données transactionnelles.
Pour plus de détails, veuillez consulter la note officielle de l'Agence des Revenus italienne.
Oui, pour émettre des reçus, il est nécessaire de se connecter au portail de l'Agence des Impôts.
Ensuite, il faut suivre les étapes suivantes:
1. Vérifiez que le nom d'utilisateur est bien celui de l'entreprise dans le coin supérieur droit
2. Allez dans le menu de gauche à la rubrique Il tuo profilo (=Votre profil) et ensuite à la rubrique Incarichi (=Affectations)
3. Cliquez sur Gestisci incarichi come gestore (=Gérer les missions en tant que responsable)
4. Cliquez sur Aggiungi incaricato (=Ajouter une mission)
5. Dans le champ Code fiscal, saisissez le CF de la personne légalement responsable de l'envoi des reçus, tandis que dans le champ tipo incarico (=Type d'affectation), sélectionnez la valeur Affectation et sauvegardez
ATTENTION: le code fiscal est le même que celui qui doit être transmis lors de la configuration de l'entreprise (POST /IT-configuration) dans 'taxCode', sous 'receipts_authentication'
6. Dans la liste des agents mis à jour, sous la valeur que vous venez de saisir, cliquez sur Azioni (=Actions) et Gestisci servizi (=Gérer les services)
7. Une liste d'entrées sélectionnables s'ouvre. Cliquez sur Servizi per (=Services pour), puis sur Trasmissione dati IVA (=Transmission des données TVA)
Accreditamento e censimento dispositivi Personale (=Sélectionnez le poste Accréditation et dispositifs de recensement Personnel) et enregistrez
Énergie sans carbone pour notre nuage 
Low CO2
Openapi SpA Unipersonale - Société soumise à la direction et au contrôle de Open Holding Srl - Viale Filippo Tommaso Marinetti 221 - 00143 Rome - Registre des Entreprises REA 1378273 - Capital social € 50.000,00 entièrement versé – N° TVA IT12485671007 - Code destinataire 'USAL8PV' - PEC : 
Openapi est certifiée : Système de gestion de la qualité UNI EN ISO 9001:2015 - Qualité des données ISO 25012:2014 - Gestion de la sécurité ISO/IEC 27001:2022 - Égalité des sexes selon UNI PdR 125:2022
Tous les prix sont à considérer hors TVA éventuelle, droits de timbre éventuels, frais de secrétariat et/ou taxes ou impôts autrement désignés s'ils sont dus. Tous les logos mentionnés sur le portail sont protégés par des droits d'auteur et appartiennent à leurs propriétaires respectifs.
