Aller au contenu principal

Suppliers

Un supplier représente une entreprise partenaire ou sous-traitante de l'annuaire de votre équipe. La liste inclut les entreprises fermées et celles sans dossier. Les entités légales et les autres intervenants ne sont pas des suppliers.

Endpoints​

GET /supplier
GET /document?supplierRegistrationNumber={registrationNumber}
GET /document?type=st-contract&supplierRegistrationNumber={registrationNumber}

Les listes acceptent updatedSince pour les exports incrémentaux. Les chemins ci-dessus sont relatifs à https://integration.batis.io/api/v1.

Identité et indicateurs​

id est l'identifiant Batis stable du fournisseur. registrationNumber correspond au SIRET si le NIC est renseigné, sinon au SIREN ou à l'immatriculation étrangère. Conservez id comme clé de synchronisation : l'immatriculation peut être corrigée.

La réponse expose l'identité, l'adresse, le contact de l'entreprise, les activités et périmètres, les rattachements directs aux groupes, les risques enregistrés et les indicateurs disponibles. isClosed indique la présence d'une date de fermeture.

updatedAt désigne la date de modification de la fiche fournisseur. Batis l'actualise également lorsqu'au moins un calcul signale un changement de risque pendant le recalcul global des risques. Les mises à jour ciblées de risque, la simple création de l'enregistrement de risque et les modifications de métadonnées URSSAF seules ne sont pas propagées. Une modification isolée d'indicateur ou de conformité ne garantit donc pas l'actualisation de cette date.

  • groupAccountingCode compare exactement le code comptable et couvre les groupes correspondants et leurs sous-groupes. groupList conserve tous les rattachements directs du fournisseur dans l'équipe, sans dupliquer le fournisseur.
  • riskType filtre un risque enregistré, dont PQQ pour la préqualification. risk: null signifie qu'aucun risque n'est enregistré ; cela ne signifie pas que tous les risques sont faux.
  • financialSituation est disponible si un fournisseur d'information financière est configuré et un score existe. prequalification est disponible si le module est activé ; sans statut enregistré, son statut est UNKNOWN. Les données indisponibles valent null.
  • evaluation.score est la moyenne des notes numériques des contrôles d'évaluation enregistrés sur les dossiers intervenants de l'équipe, comme pour le calcul du risque d'évaluation. Sans note, evaluation vaut null. Les notes et scores égaux à zéro sont conservés.
  • iban expose le numéro de compte renseigné dans le RIB courant avec le scope integration:read, ou null s'il est absent. La lecture ne déclenche aucune synchronisation externe ni recalcul de risque.

Inclure les pièces dans les fournisseurs​

GET /supplier?includeAdministrativeDocuments=true

includeAdministrativeDocuments accepte uniquement true ou false. Absent ou égal à false, le champ administrativeDocuments est omis. Avec true, chaque fournisseur de la page inclut les types obligatoires du segment, même sans dépôt, et les types facultatifs déposés ; les types invisibles sont exclus. Cette liste interne n'est ni paginée ni filtrée par le updatedSince des fournisseurs.

Pour la reprise des exports et la réconciliation des suppressions, consulter Pagination et erreurs.

Lorsqu’une pièce dispose d’un fichier, transmettez administrativeDocuments[].file.key, encodée dans l’URL, à GET /document-file/{fileKey}/download. Le téléchargement respecte la sélection courante de cette liste : les pièces remplacées ou devenues invisibles retournent 404. Un fichier partagé doit également être rattaché à un fournisseur accessible. Voir le contrat de téléchargement.