Récupérer les informations pour la BI
Objectif : alimenter un outil de BI avec les données opérationnelles disponibles dans Batis.
Parcours
- Extraire les opérations accessibles.
- Extraire les dossiers rattachés à chaque opération.
- Extraire les documents et leurs statuts.
- Extraire les suppliers et leurs indicateurs de conformité.
- Extraire les documents et contrats des suppliers lorsque le CSV attendu demande un niveau de détail.
- Joindre les données avec les référentiels du système d'information tiers si nécessaire.
- Charger les données dans l'entrepôt BI.
Chargement incrémental
Après un premier chargement complet, utilisez updatedSince pour récupérer uniquement les éléments créés ou modifiés depuis la dernière extraction réussie.
Conservez une date de synchronisation par famille de données :
- opérations ;
- dossiers ;
- documents ;
- fournisseurs ;
- référentiels du catalogue, si l'entrepôt BI les consomme.
Chaque réponse expose un updatedAt sur les ressources synchronisables. À la fin d'un traitement réussi, stockez le plus grand updatedAt traité pour la famille concernée et réutilisez-le comme prochain updatedSince.
Pour les opérations, updatedAt tient aussi compte des modifications du groupe, de son entité légale, des sources des champs spécifiques configurés et de leur configuration. Une modification ou une suppression de configuration réémet les opérations pour les identifiants OAuth concernés. Conservez une borne par client OAuth et famille de ressources ; remplacez entièrement l'objet customFields reçu et retirez-le s'il est absent. Le filtre updatedSince est inclusif : dédupliquez par id et ne mettez à jour la date de synchronisation qu'après le parcours réussi de toutes les pages. Les statuts exposés sont notified, in-progress, received et archived.
La pagination ne constitue pas un instantané global et les suppressions ne sont pas exposées comme événements. Prévoyez une réconciliation complète ; les règles détaillées sont décrites dans Pagination et erreurs.
Fournisseurs et conformité
Utilisez supplier.id comme clé stable de fournisseur. Avec includeAdministrativeDocuments=true, chaque fournisseur expose ses pièces administratives applicables ; remplacez cette liste complète à chaque réception.
Le filtre fournisseur groupAccountingCode inclut les sous-groupes. Les risques, scores financiers, préqualifications et moyennes d'évaluation sont lus depuis les données Batis ; le scope integration:read permet aussi de lire l'IBAN du RIB courant.
Pour les fournisseurs, dédupliquez par id et conservez une borne updatedSince. Avec includeAdministrativeDocuments=true, remplacez la liste complète reçue pour chaque fournisseur : elle n'est pas limitée par le filtre incrémental externe. Prévoyez une réconciliation complète pour les suppressions, détachements, rattachements sans horodatage et changements de sélection liés au temps. Les fichiers référencés sont téléchargeables via GET /document-file/{fileKey}/download, avec la clé encodée dans l’URL et le token Bearer. Seules les pièces administratives courantes et visibles restent accessibles.
Données typiques
- opérations par statut ;
- dossiers par entreprise ;
- documents attendus, déposés, validés ou expirés ;
- suppliers conformes, non conformes ou bloquants ;
- documents suppliers absents, non conformes ou arrivant à expiration ;
- contrats actifs, expirés, en attente de signature ou arrivant à échéance ;
- délais de complétude documentaire ;
- rapprochements avec les codes du système d'information tiers.
Endpoints utiles
GET /operation?updatedSince={lastOperationSync}
GET /supplier?updatedSince={lastSupplierSync}
GET /folder?operationId={operationId}&updatedSince={lastFolderSync}
GET /document?folderId={folderId}&updatedSince={lastDocumentSync}
GET /document?supplierRegistrationNumber={registrationNumber}&updatedSince={lastDocumentSync}
GET /catalog/operations?updatedSince={lastCatalogOperationSync}
GET /catalog/enterprises?updatedSince={lastCatalogEnterpriseSync}