Pour les clients SIGN DE

Guide d’intégration SIGN ES pour les clients SIGN DE

Ce guide vous aide à intégrer avec succès l’API fiskaly SIGN ES et décrit toutes les étapes nécessaires que vous et vos commerçants devez suivre.

Configuration — Création des organisations

La création et la configuration des organisations fonctionnent de la même manière que dans SIGN DE.

Note : dans SIGN ES, chaque organisation gérée représente un contribuable (identifié par son NIF/identifiant fiscal). Vous devez créer une organisation gérée par contribuable — et non par emplacement ou magasin.

La création d’organisations (gérées) se fait via la Management API fiskaly. L’ajout d’utilisateurs et la création de clés API se font également via la Management API. Notre guide du processus d’intégration décrit plus en détail ces étapes initiales.

SIGN ES

Comme vous êtes déjà familier avec notre API SIGN DE, l’implémentation de SIGN ES devrait être relativement simple. Le flux de processus a été conçu pour être identique pour les deux API. Afin de faciliter encore davantage le processus, les différences et similitudes avec SIGN DE sont présentées dans les endpoints individuels.

SIGN ES vs. SIGN DE

Une fois la structure organisationnelle créée, vous pouvez continuer étape par étape en utilisant les endpoints de l’API SIGN ES suivants :

PUT : Créer les informations du contribuable

Utilisez cet endpoint pour créer le contribuable. Cette étape ne doit être effectuée qu’une seule fois.

Contribuable : Dans SIGN ES, une organisation gérée représente un contribuable et son territoire fiscal (l’adresse légale de l’entreprise). Au sein de chaque organisation gérée, un contribuable doit être créé. Important : en cas de modification des données du contribuable, une nouvelle organisation gérée doit être créée car les données du contribuable ne peuvent pas être modifiées par la suite.

📘Différences avec SIGN DE

Pour l’instant, il n’existe pas d’endpoint équivalent dans SIGN DE.

PUT : Créer un signataire

Utilisez cet endpoint pour créer au moins un signataire. Concernant les champs private_key et public_key : ces informations de certificat seront fournies par fiskaly.

Signataires : Dans SIGN ES, un signataire représente le dispositif de signature. Au moins un signataire doit être créé, mais dans les scénarios avec un volume de factures particulièrement élevé, plusieurs signataires peuvent être créés. Le signataire contient un certificat qui doit être associé au contribuable dans les serveurs de l’administration fiscale.

Note : ce certificat de dispositif est fourni par fiskaly ou, s’il est disponible, vous pouvez également utiliser un certificat existant.

💡Similitudes avec SIGN DE

Le signataire correspond au TSS dans SIGN DE. Contrairement à SIGN DE, un signataire peut être utilisé immédiatement car il ne possède pas d’états différents. Le processus d’implémentation est donc encore plus simple.

PUT : Créer un client

Utilisez cet endpoint pour créer un client. Le client identifie de manière unique un terminal, un dispositif de caisse, une application ou tout autre dispositif utilisé pour émettre des factures.

Clients : Dans SIGN ES, un client représente le dispositif de caisse. Pour émettre des factures, vous avez besoin d’un client par dispositif de caisse et d’au moins un dispositif de signature.

💡Similitudes avec SIGN DE

Le client correspond à l’entité client dans SIGN DE. Chaque client est connecté à un signataire — de la même manière que chaque client est connecté à un TSS dans SIGN DE, à la seule différence que la connexion entre le client et le signataire dans SIGN ES se fait dans le corps de la requête et non dans les paramètres de chemin.

• Dans SIGN ES, les clients peuvent avoir deux états : ENABLED et DISABLED.
• Dans SIGN DE, les états correspondants sont REGISTERED et DEREGISTERED.

Note : contrairement à SIGN DE, le passage de l’état d’un client à DISABLED est irréversible dans SIGN ES.

PUT : Créer une facture

Utilisez cet endpoint pour créer une facture. client_id et invoice_id dans les paramètres de chemin doivent être définis par vous.

Factures : Dans SIGN ES, il existe six types de factures : la facture simplifiée, la facture complète, la facture rectificative, la facture d’enrichissement, la facture externe et la facture de régularisation :

1. La facture simplifiée contient uniquement des informations sur l’émetteur, mais aucune information sur le destinataire de la facture. Cette facture ne peut être émise que jusqu’à un montant de 400 € et dans certains cas spécifiques jusqu’à un montant de 3 000 € (ventes au détail, restaurants, services de stationnement…).
2. La facture complète comprend des informations à la fois sur l’émetteur et sur le destinataire de la facture ; c’est le type le plus couramment utilisé pour les services fournis par des professionnels ou des entreprises.
3. La facture rectificative doit être émise chaque fois qu’une erreur s’est produite, par exemple en cas de montant incorrect. Dans cette facture, les commerçants doivent indiquer s’il s’agit d’une rectification par substitution ou d’une rectification par différences.
4. La facture d’enrichissement peut être émise lorsque la facture originale a été créée sans destinataire, et que la seule modification requise est l’ajout de destinataire(s).
5. La facture externe est destinée à saisir les détails des factures émises avant l’intégration de l’API SIGN ES. Cela garantit que des corrections peuvent être effectuées en conformité avec les réglementations. La création d’une facture externe ne déclenche pas de transmission aux autorités fiscales, ni ne génère de fichier XML pour la facture. Une fois qu’une facture externe est créée et qu’un UUID lui est attribué, cet UUID peut être référencé lors de l’émission d’une facture rectificative ou d’enrichissement.
6. La facture de régularisation peut être émise pour régulariser des informations de facture incorrectes qui ne nécessitent pas de rectification légale.

💡Similitudes avec SIGN DE

Les factures dans SIGN ES correspondent aux transactions dans SIGN DE. Contrairement à SIGN DE, les factures sont directement soumises à l’administration fiscale compétente. La réponse retourne la facture signée et inclut également son état de synchronisation et de transmission à l’administration fiscale compétente.

📘Différences avec SIGN DE

Étant donné qu’il n’existe pas de réglementation exigeant que les transactions soient démarrées, mises à jour et finalisées en Espagne, cette partie de SIGN ES est beaucoup plus simple que SIGN DE. Contrairement à SIGN DE, les factures remises au consommateur doivent inclure un code d’identification et un QR code, qui doivent être placés selon des directives spécifiques.

Les détails sont disponibles ici : Conformité des factures.

PATCH : Mettre à jour une facture

Utilisez cet endpoint pour mettre à jour une facture. Cet endpoint ne doit être utilisé que pour annuler une facture déjà créée.

📘Différences avec SIGN DE

Dans SIGN DE, il n’existe pas d’endpoint spécifique pour annuler des reçus. La gestion des annulations en Espagne est donc beaucoup plus simple.

Comment créer un reçu numérique

Après avoir créé une facture, vous pouvez créer un reçu numérique pour votre facture en utilisant notre endpoint de reçu numérique. L’URL retournée peut facilement être affichée sous forme de QR code au consommateur lors du processus de paiement et le reçu n’a plus besoin d’être imprimé. Cela réduit les coûts, protège l’environnement, améliore la satisfaction des clients et crée un nouveau point de contact client pour le commerçant.

Pour en savoir plus sur le reçu numérique au-delà de sa fonctionnalité de base, comment améliorer la fidélité des clients et tirer parti de l’écosystème de partenaires fiskaly, contactez-nous via sales@fiskaly.com. Pour la visualisation d’un tel reçu numérique, consultez notre guide du reçu numérique et n’hésitez pas à utiliser notre API de reçu disponible en accès libre.

Prêt à aller plus loin ?

Consultez notre SIGN ES Quick Start — nous avons créé une collection Postman qui vous permet de parcourir les fonctions les plus importantes de cette API.