Aller au contenu principal

Dossier

Un dossier représente la relation entre une entreprise et une opération dans Batis.

Il permet notamment de retrouver :

  • l'entreprise concernée ;
  • l'opération associée ;
  • le type d'intervention ;
  • les documents attendus ou déposés ;
  • les statuts de contrôle documentaire.

Informations exposées​

Les types d'intervention sont st (sous-traitant), st2 (sous-traitant de rang 2), be (bureau d'étude), supplier (fournisseur), provider (prestataire) et eg (entreprise générale).

  • operation contient le code et le titre de l'opération.
  • enterprise contient le nom, le code comptable, le pays et l'immatriculation. Le pays provient de l'adresse de l'entreprise ; lorsqu'il manque, la valeur est FR. L'immatriculation correspond au SIRET disponible, sinon à l'identifiant enregistré dans Batis (SIREN ou identifiant étranger).
  • parentFolderId est renseigné uniquement pour un ST2 dont le parent est accessible et appartient à la même opération. Il vaut null pour les autres types ou sans parent accessible.
  • L'activité, le corps d'état et les dates d'intervention valent null lorsque leur donnée est absente. Les dates sont exprimées en ISO 8601 UTC.
  • controlStateList expose les contrôles documentaires enregistrés dans Batis. Une liste de documents absente, une valeur null et une liste vide [] restent distinctes. Les détails publics comprennent id, note et comment pour les évaluations, et l'id du document administratif pour l'assurance décennale.

Selon les identifiants OAuth, customFields peut exposer les composants d’adresse et l’email du contact principal de l’entreprise. Voir Champs spécifiques.

La date updatedAt inclut la modification du dossier, les sources des champs spécifiques configurés et la dernière modification de configuration OAuth. Les règles de reprise sont détaillées dans Pagination et erreurs.

Parcours documentaire​

Le parcours standard est :

  1. lister les opérations accessibles ;
  2. lister les dossiers d'une opération ;
  3. lister les documents d'un dossier ;
  4. télécharger les fichiers nécessaires.

Transmettez les clés de la liste documentaire à GET /document-file/{fileKey}/download, encodées dans l’URL, avec le même token Bearer. Les fichiers principaux et les annexes privées de l’équipe sont accessibles selon les règles de visibilité.

curl "https://integration.batis.io/api/v1/folder?operationId=operation_123" \
  -H "Authorization: Bearer ACCESS_TOKEN"