Documents

Envoyez toutes les données du transport. La réponse est renvoyée après génération et stockage du PDF chiffré.

Une référence non nulle est unique par organisation et environnement. Répéter la référence avec les mêmes données normalisées et metadata renvoie le résultat original dans les 24 heures (200), sans émettre un autre PDF. Une nouvelle création renvoie 201. Des données différentes ou une référence d'un autre identifiant produisent 409 sans divulguer de documents. Sans référence, la déduplication n'est pas garantie.

Une référence dont le résultat a expiré renvoie 409 DOCUMENT_WINDOW_EXPIRED. Si le document est supprimé, son contenu n'est pas renvoyé et sa référence n'est pas réutilisable ; la nouvelle tentative renvoie 404. Utilisez les endpoints PUT pour rectifier.

Vous pouvez demander un jeton sk_demo_ sans compte ni organisation enregistrée. Il dure 24 heures à partir de son émission et fonctionne uniquement depuis l’IP publique qui l’a demandé. Un changement de réseau ou d’IP nécessite un autre jeton. La démo ajoute demo: true, expires_at, qr_url (alias de url) et pdf_url (alias de pdf_download_url). document_locale est la langue choisie lors de la demande du jeton (es par défaut). Les données et PDF temporaires sont distincts de l’archive réelle et ne sont pas chiffrés comme les documents réels.

Identifiez le document précédent par UUID et envoyez toutes les données corrigées, sans modifications partielles. Seule la dernière version du même identifiant peut être rectifiée. Un document de plus de 24 heures peut être rectifié sans renvoyer son contenu précédent. Un document supprimé renvoie 404 et ne peut pas être rectifié.

Un document rectificatif est généré avec de nouveaux UUID, PDF et QR ; l'original et son QR sont conservés. Remettez le nouveau PDF au conducteur. Le champ reference du corps correspond à la nouvelle version, pas au document de l'URL.

Répéter le même PUT avec les mêmes données normalisées et metadata renvoie la rectification déjà émise pendant les 24 heures suivant sa création, sans générer une autre version. Cette vérification précède le rejet d'un document déjà rectifié et fonctionne aussi si la nouvelle tentative identifie le même document par référence. Modifier les données d'un document déjà rectifié renvoie 409. Un résultat expiré renvoie 409 DOCUMENT_WINDOW_EXPIRED. Si la rectification renvoyée est supprimée, la nouvelle tentative renvoie 404. Pour une autre rectification, utilisez l'UUID ou la référence de la dernière version.

Suppression logique pour corriger des erreurs détectées lors de la génération d'un document, exclusivement avant sa remise au transporteur ou au conducteur et avant son utilisation pour un transport. L'intégration doit confirmer les deux conditions ; respecter le délai ne suffit pas. Si le document a déjà été remis ou utilisé, il doit être rectifié par PUT.

Autorisée uniquement tant que l'heure du serveur est antérieure à created_at + 2 heures ; à exactement 2 heures, elle n'est plus autorisée. Ni une consultation ni une nouvelle tentative ne redémarrent le délai. Chaque version utilise sa propre date de création. Seule la dernière version de l'identifiant authentifié peut être supprimée.

Le PDF, les données et la traçabilité sont conservés, mais le document disparaît de la liste. Les consultations par UUID ou référence, le téléchargement authentifié, le QR et les nouvelles tentatives qui renverraient le contenu répondent 404. La consultation d'état répond uniquement avec status: deleted pendant la fenêtre de consultation de 24 heures. La référence reste réservée. Aucun endpoint de réactivation n'existe ; la suppression conserve le fichier pour permettre une récupération future.

Répéter DELETE dans les mêmes 2 heures renvoie 204 sans modifier la date de suppression. Au-delà, la réponse est 409.

Le premier accès réussi au lien QR bloque aussi la suppression avec 409 DOCUMENT_ALREADY_ACCESSED. Cet accès ne prouve pas, à lui seul, que le transport a eu lieu.

Renvoie des résumés sans PDF, secret QR ni metadata. Le serveur applique toujours la fenêtre de 24 heures et l'isolation des identifiants. Tri décroissant par date de création, avec UUID pour départager, pagination par page et filtres inclusifs de date de transport. La fenêtre est évaluée à chaque requête ; elle ne constitue pas un instantané stable entre les pages. L'historique n'est pas accessible.

Les documents supprimés ne figurent pas dans la liste.

Récupère le résultat original dans les 24 heures, uniquement pour l'identifiant ayant émis le document. Inclut tous les champs acceptés et normalisés et la metadata sans modification sémantique.

Un UUID ou une référence inexistant, appartenant à un autre identifiant ou hors fenêtre renvoie le même 404, sans confirmer l'existence ni le propriétaire. Chaque référence identifie sa propre version et ne redirige pas vers une rectification ultérieure.

Un document supprimé renvoie 404. Utilisez la consultation d'état pour savoir s'il est supprimé.

Renvoie uniquement l'état d'un document de l'identifiant authentifié pendant les 24 heures suivant sa création. Un document supprimé répond 200 avec {"status":"deleted"} ; aucune donnée de transport, PDF, lien QR ni metadata n'est renvoyé. Un document actif répond avec {"status":"active"}.

Un UUID inexistant, d'un autre identifiant ou hors des 24 heures renvoie le même 404. La suppression n'étend pas cette fenêtre.

Renvoie les octets exacts du PDF stocké, sans le régénérer. Exige l'identifiant propriétaire et un document de moins de 24 heures. Cette limite ne modifie ni la conservation légale ni la validité du QR.

Un document supprimé renvoie 404 sans livrer le PDF.