API du système POSPoint d'entrée unique à partir de votre POS to fiskaltrust.Middleware.
Créez des reçus, exécutez des paiements, émettez des reçus numériques et exportez des journaux par le biais d'une API HTTP axée sur les processus.
L’API vous permet de vous concentrer sur votre système tandis que fiskaltrust s’occupe de l’infrastructure des reçus. Au lieu de traiter les reçus comme une fonction secondaire ou un complément pour le consommateur, l’API de reçus traite les reçus comme un composant de système réglementé de première classe. Vous vous intégrez une fois et vous vous fiez à une API unifiée et open-source qui est maintenue au fur et à mesure de l’évolution des réglementations et des exigences opérationnelles.
L’API du système POS de fiskaltrust sert d’interface centrale entre les systèmes POS et le middleware de fiskaltrust. Elle offre un ensemble complet de fonctionnalités, y compris la fiscalisation (ou la signature) des reçus, l’exécution des paiements via différents fournisseurs, l’impression de reçus numériques et l’exportation de données depuis le middleware.
Grâce à des points de terminaison simples et cohérents, l’API prend en charge des fonctions clés : /echo pour les tests de connectivité, /order pour l’enregistrement des données de commande, /pay pour l’affectation des paiements, /sign pour le scellement conforme des transactions, /issue pour la génération de reçus numériques ou imprimables, et /journal pour les exportations prêtes à être auditées.
Des points d'extrémité d'API faciles à lire
International PosSystem-API
- /echo,un bilan de santé et une réinitialisation.
- /order,enregistrer les informations relatives à la commande et demander l'état ou le résultat de la commande.
- /pay,exécuter les paiements, attendre l'achèvement avec des délais d'attente, récupérer le résultat.
- /sign,finaliser les reçus avec les règles nationales et la chaîne de hachage.
- /issuecréer et mettre à jour le récépissé délivré, y compris l'état de la livraison.
- /journal,récupérer des entrées individuelles ou des plages pour les audits et les clôtures.
POS Dealer API. Conçue pour des intégrations stables, transparentes et à l'épreuve des audits.
Conçue pour une utilisation multiplateforme, l’API prend en charge les déploiements locaux et les instances hébergées dans les centres de données européens. Elle offre un stockage sécurisé des révisions et s’intègre au middleware fiskaltrust pour des mises à jour automatiques de la conformité.
Certaines parties de l’API et du middleware sont open source, ce qui garantit la transparence et la stabilité à long terme. Grâce à une documentation ouverte et à un modèle de données uniforme, les efforts de maintenance sont réduits et les solutions POS sont à l’épreuve des audits.
Une API, un comportement cohérent, indépendamment des exigences propres à chaque pays.
Concepts de base
L’API traite une transaction comme un voyage. Chaque étape modifie l’état du serveur. Vous transmettez un identifiant d’opération unique à chaque appel. Si le réseau tombe en panne, vous répétez le même appel avec le même identifiant.
Le backend déduplique et renvoie le premier résultat complété. Cette conception permet des tentatives sûres et des résultats prévisibles pour les étapes fiscales critiques.
- Point d’entrée central vers l’intergiciel pour la fiscalisation, les paiements, l’émission et les exportations.
- Les modèles d’appels processuels, avec état, qui se comportent comme une machine à état.
- Idempotence grâce à l’en-tête x-operation-id avec des réponses déterministes en cas de nouvelle tentative.
- Crochets de rappel pour observer les transitions d’état pendant les opérations de longue durée.
Une requête avec x-operation-id entre dans l'intergiciel
Middleware traitement
Réessayer avec le même x-operation-id
Terminé résultat
Point final de rappel x-operation-callback-state
Authentification et versionnement
L’accès est délimité par CashBox. Vous utilisez CashBoxId et AccessToken à partir du portail. L’API suit une version sémantique. Les ruptures sont limitées aux versions majeures et peuvent être épinglées dans l’URL en cas de besoin.
- Références : CashBoxId et AccessToken.
- Version sémantique, la plus récente par défaut, avec possibilité d’épinglage explicite.
Développeur POS
Authentification CashBoxId + AccessToken
V1
V2
V3
Modèles d'interface utilisateur asynchrone
L’API vous permet de vous concentrer sur votre système tandis que fiskaltrust s’occupe de l’infrastructure des reçus. Au lieu de traiter les reçus comme une fonction secondaire ou un complément pour le consommateur, l’API de reçus traite les reçus comme un composant de système réglementé de première classe. Vous vous intégrez une fois et vous vous fiez à une API unifiée et open-source qui est maintenue au fur et à mesure de l’évolution des réglementations et des exigences opérationnelles.
En-têtes et idempotence
Chaque appel critique accepte des en-têtes de contrôle. x-operation-id est votre clé d’idempotence. x-operation-lifetime définit la durée de validité de l’opération. Vous pouvez définir une URL de rappel par appel pour recevoir des messages d’état sans interrogation.
- x-operation-id, unique par opération pour dédupliquer les tentatives.
- x-operation-lifetime, fenêtre d’acceptation en millisecondes.
- x-operation-callback-state, notifier à chaque changement d’état.
- x-terminal-id et x-possystem-id facultatifs pour l’attribution.
État de la livraison et de la réception
Après l’émission, vous pouvez récupérer le contenu émis, le mettre à jour ou demander l’état de la livraison. Il existe des points de terminaison bloquants qui attendent jusqu’à un délai maximum et signalent que le contenu a été livré ou n’a pas été livré. Cela simplifie les flux d’utilisateurs à la caisse et évite les interrogations fréquentes.
Environnements
L’API fournit des environnements sandbox et production pour chaque point d’extrémité. Utilisez le bac à sable pour l’intégration et les tests automatisés. Promouvoir les mêmes appels en production lorsqu’ils sont prêts. L’API Aynchronous, les en-têtes et les rappels se comportent de la même manière dans les deux environnements.
Gestion des erreurs
Les appels renvoient les codes d’état HTTP standard. Les demandes mal formées ou les en-têtes manquants produisent des erreurs de la part du client. Les échecs d’authentification renvoient le code “non autorisé”. Le serveur signale les erreurs inattendues avec les détails du problème, le cas échéant. Les nouvelles tentatives avec le même identifiant d’opération renvoient le premier résultat terminé.
Utilisez une interface ouverte et documentée qui s'adapte à l'évolution de la réglementation ( ).
Comment ça marche en 3 étapes
Vous configurez un CashBox dans le portail et obtenez des informations d’identification. Votre point de vente appelle le panier, la commande et le paiement pour construire le parcours. Vous terminez par la signature et l’émission, puis vous lisez les écritures de journal pour la clôture quotidienne ou les audits. Vous répétez les étapes ratées en toute sécurité en réutilisant l’identifiant de l’opération.
1.
Inscrivez-vous sur le site fiskaltrust.Portal.
2.
Créez une caisse et connectez-la à votre POS ou ERP.
3.
Dirigez le parcours : panier, commande, paiement, signature, délivrance.
L'essentiel pour le développeur
Commencez par la spécification OpenAPI et la documentation en ligne. Examinez les diagrammes SynchronousAPI et le contrat d’en-tête. Construisez les tentatives avec l’idempotence et les rappels. Utilisez le bac à sable pour valider les transitions d’état et le comportement de livraison de la réception avant la production.
- Page de documentation sur l’API du système POS et fichier OpenAPI.
- Diagrammes de synchronisation et d’état de l’interface SynchronousAPI.
- Points de terminaison de l’environnement de travail pour l’écho, le panier, la commande, le paiement, la signature, l’émission, le journal.
Des questions sur l'intégration ? Notre équipe technique n'est qu'à un message.
Contactez nous