Invoice

Le service prend actuellement en charge l'Italie, la France et l'Allemagne. Chaque pays applique ses propres réglementations et flux de transmission, mais tous peuvent être gérés via une seule API REST.

Oui. La même API permet de configurer les entreprises et de gérer la facturation électronique dans tous les pays pris en charge. Seuls certains champs et les méthodes de transmission requises par la réglementation locale varient d'un pays à l'autre.

Bien que l'intégration s'effectue via une seule API REST, chaque pays applique ses propres réglementations, formats et canaux de transmission.

• Italie : les factures électroniques sont transmises via le Sistema di Interscambio (SDI), qui gère l'envoi, la réception et les notifications d'état.
• France : la facturation électronique suit le cadre défini par la réglementation française, en utilisant le réseau Peppol et les canaux autorisés pour l'échange de documents électroniques.
• Allemagne : la facturation électronique utilise les standards définis par la réglementation allemande, tels que XRechnung et ZUGFeRD, avec une transmission via Peppol lorsque cela est prévu.

L'API Openapi gère automatiquement les différences entre les pays, ce qui permet d'intégrer une solution unique pour la configuration des entreprises, l'envoi, la réception et le suivi des factures électroniques sur tous les marchés pris en charge.

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 :

1. Achetez le forfait Assistance Premium (2 heures)
2. 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.

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.

Oui, mais cette fonctionnalité est disponible uniquement pour les services de Facturation Électronique France et Facturation Électronique Allemagne.

Pour envoyer une facture électronique B2B transfrontalière, vous devez utiliser le point de terminaison POST /WW-invoices. Avant l'envoi, le pays de l'émetteur doit être configuré à l'aide du point de terminaison de configuration correspondant.

À ce jour, les pays d'émission pris en charge sont uniquement :

• France (FR)
• Allemagne (DE)

Cette limitation concerne uniquement le pays de l'émetteur. Le destinataire de la facture peut être situé dans n'importe quel pays étranger, à condition que recipient.country soit différent de sender.country.

Le système sélectionne automatiquement la configuration appropriée en fonction des valeurs de sender.country et sender.fiscal_id. Si le destinataire est situé dans le même pays que l'émetteur, vous devez utiliser le point de terminaison dédié à la facturation électronique nationale.

Non, mais au-delà de 10 configurations, un coût supplémentaire de 1 € est appliqué.

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.

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
• E-mail
• 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. 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.

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, vous pouvez importer l’historique des factures via l’endpoint POST /IT-invoices_import.

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.

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.

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.

Italie

• Tickets de caisse électroniques : à partir de 0,009 € avec un abonnement ou 0,019 € avec une facturation à la consommation.
• Factures électroniques : à partir de 0,049 € avec un abonnement ou 0,154 € avec une facturation à la consommation.

France

• Factures électroniques : à partir de 0,017 € avec un abonnement ou 0,090 € avec une facturation à la consommation.

Allemagne

• Factures électroniques : à partir de 0,017 € avec un abonnement ou 0,090 € avec une facturation à la consommation.

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.