Skip to main content
Pour les volumes sans contrainte de temps réel — contrôle périodique d’un stock de dossiers, reprise d’archives lors d’une migration — le lot évite de consommer votre débit temps réel : vous déposez, vous clôturez, tout est analysé sous 24 heures (la plupart des lots finissent bien avant). Un lot resté ouvert expire 24 heures après sa création. Une entreprise peut conserver simultanément 3 lots ouverts, 400 documents non purgés et 5 Gio de documents en attente. Une réponse 429 invite à clôturer, annuler ou attendre la purge d’un lot avant de reprendre les dépôts.

​
Le cycle en trois gestes

1. Créer le lot — avec, si vous le souhaitez, une adresse de notification de fin :
2. Déposer les documents un par un (200 maximum par lot) — le dépôt est immédiat, rien n’est analysé à ce moment ; le fichier attend chiffré puis est supprimé après traitement :
Chaque document accepte aussi agencyPostalCode, le code postal de l’agence qui l’a contrôlé, avec les mêmes règles que pour l’analyse d’un document : un code inconnu est refusé dès le dépôt. 3. Clôturer — la fenêtre de complétion démarre (expiresAt) :

​
Suivre et relire

GET /api/v1/batches/{id} rend le statut, les compteurs et le détail document par document. Chaque document succeeded porte un consultationId : le résultat complet se relit sur GET /api/v1/consultations/{id} — même format que partout ailleurs. À la fin du lot, si vous avez fourni une webhookUrl, l’événement batch.completed vous est notifié — signé comme tous les événements.

​
États d’un document

Un document en erreur, annulé ou expiré n’est jamais compté. Le choix d’utilisation de l’IA est relu au traitement, même pour un document déposé auparavant. Si l’IA est désactivée, les documents administratifs encore en attente passent errored avec error: "ia_desactivee", sans appel au moteur. Les nouveaux dépôts administratifs sont refusés avec 403 et ce même code. Les contrôles d’identité et la lecture des résultats précédents restent accessibles selon le contrat ; un traitement déjà transmis peut se terminer.

​
Annuler

POST /api/v1/batches/{id}/cancel arrête le lot : les documents non traités passent canceled, les analyses déjà rendues restent acquises et relisibles.