API Platon · Vue d'ensemble

Qu'est-ce que Platon ?

Platon est l'API REST Limpidius permettant d'émettre des tickets dématérialisés structurés à partir des transactions de caisse. Vous envoyez une seule requête contenant le détail de la transaction (lignes produits, ventilation de TVA, moyen de paiement) et Platon prend en charge la génération du ticket et sa remise au client.

Platon prend en charge les modes de remise suivants :

Email : le ticket est envoyé directement dans la boîte de réception du client.
Impression : un ticket papier est généré sur le terminal de caisse.
Email et impression : les deux canaux sont utilisés simultanément.
Sans impression : la transaction est enregistrée sans aucune remise.

Authentification

Toutes les requêtes doivent inclure un jeton Bearer valide dans l'en-tête Authorization. Voir Authentification pour savoir comment obtenir un jeton.

Shell
 # Inclure cet en-tête dans chaque requête
Authorization: Bearer {YOUR_ACCESS_TOKEN} 

Codes de statut HTTP

Code	Signification
`201 Created`	La requête a été acceptée et la transaction traitée avec succès.
`400 Bad Request`	Le corps de la requête est mal formé ou des champs obligatoires sont absents.
`401 Unauthorized`	Le jeton fourni est absent, invalide ou expiré.
`422 Unprocessable Entity`	La requête est bien formée mais contient des valeurs invalides.
`429 Too Many Requests`	Vous avez dépassé la limite d'appels autorisée.
`500 Internal Server Error`	Une erreur inattendue est survenue de notre côté. Réessayez avec un backoff exponentiel.

Idempotence

Le champ requestId (UUID v4) est obligatoire sur chaque requête de transaction. Si le même requestId est soumis plusieurs fois, seule la première requête est traitée : les doublons suivants sont ignorés silencieusement. Vous pouvez ainsi rejouer sans risque une requête en échec, sans traiter la transaction deux fois.

Générez un nouvel UUID v4 pour chaque nouvelle transaction. Ne réutilisez le même UUID que pour rejouer exactement la même requête.

À suivre · API Platon

Transactions