API de diligence fournisseurs

Les équipes achats référencent un fournisseur une fois et le recontrôlent rarement ensuite. Prometiam couvre toute la boucle — résoudre, vérifier, cribler et surveiller — pour les fournisseurs immatriculés en Espagne, en France, au Royaume-Uni, en Irlande, en Pologne et en Norvège, depuis une seule API REST et une seule clé.

Le principe

Cinq étapes, appliquées à toute une base fournisseurs plutôt qu'une ligne à la fois. Résolvez un lot de fournisseurs avec POST /companies/lookup (jusqu'à 100 éléments, par company_number, nif, siren, vat, ou un nom approximatif avec match_score). Récupérez chaque fiche avec GET /companies/{id}?include=risk_flags,insolvency,lei pour le statut, dissolution_date, les dirigeants là où le registre les tient, l'indicateur AEAT espagnol des grands débiteurs, et le LEI. Criblez la raison sociale et ses dirigeants avec POST /sanctions/screen (jusqu'à 50 noms, offre Professional, bêta). Vérifiez les procédures collectives avec POST /insolvency/check (jusqu'à 100 éléments, entreprises uniquement, neuf marchés) — pour un fournisseur français, GET /insolvency/search?country=FR fait le même travail en lecture directe — et les procédures concursales espagnoles avec GET /search. Puis continuez à surveiller : POST /monitor pousse un webhook signé pour l'Espagne, l'Irlande et la Pologne, et un balayage quotidien GET /company-events/search couvre l'Espagne, la France et le Royaume-Uni.

Ce que cela ne couvre pas

L'Irlande et la Pologne sont couvertes au niveau entreprise, donc sans dirigeants à cribler ni avis d'insolvabilité pour un fournisseur qui y est immatriculé. La Norvège n'a pas de flux d'événements d'entreprise. Les bénéficiaires effectifs se limitent au registre britannique des Persons with Significant Control — tout autre registre renvoie des dirigeants, pas des bénéficiaires effectifs. Le criblage de sanctions est en bêta. Prometiam ne renvoie ni note de crédit, ni états financiers, ni données ESG, ni historique de marchés publics, et ce n'est pas un conseil juridique sur le point de savoir si un contrôle satisfait la loi française relative au devoir de vigilance ou la directive européenne CSDDD — l'API fournit les vérifications d'identité, de statut, de sanctions et de procédures collectives que ces obligations demandent en général.

Coût selon votre volume

POST /companies/lookup, GET /companies/{id} et POST /insolvency/check s'exécutent sur le même périmètre de base qu'une recherche d'entreprise, donc une base de 2 000 fournisseurs représente 2 000 + 2 000 + 2 000 = 6 000 requêtes — dans l'offre Starter (9,99 €/mois, 10 000 appels) à elle seule. Le criblage de sanctions demande l'offre Professional (29,99 €/mois, 100 000 appels) quelle que soit la taille de la base — c'est la seule étape limitée par le périmètre plutôt que par le volume, et là où le criblage complet des sanctions et du contrôle des exportations s'active vraiment. Chaque élément d'un lot compte pour une requête ; un lot plus grand que ce qu'il reste sur l'offre est refusé d'emblée avec 429 batch_exceeds_quota et max_items_now.

Lire la suite · Obtenir une clé API gratuite · Documentation de l'API

Les limites, dites clairement

Pays Dirigeants à cribler Avis d'insolvabilité Webhook Balayage quotidien
EspagneOuiOui — concursal, GET /searchOuiOui
FranceOuiOui — POST /insolvency/check et GET /insolvency/search?country=FRNonOui
Royaume-UniOuiOui — POST /insolvency/checkNonOui
IrlandeNon — niveau entreprisePas de couvertureOuiNon
PologneNon — niveau entreprisePas de couvertureOuiNon
NorvègeOuiOui — POST /insolvency/checkNonNon — pas de flux d'événements

Frequently asked questions

Qu'est-ce qu'une diligence fournisseur complète ?
Au minimum : confirmer que l'entité existe et qu'elle est active, cribler sa raison sociale et ses dirigeants là où le registre les tient, et vérifier l'absence de procédure collective. La loi française sur le devoir de vigilance et la directive CSDDD demandent cette même base. Prometiam n'est pas un conseil juridique sur la conformité d'une relation donnée — l'API fournit les vérifications d'identité, de statut, de sanctions et de procédures collectives que le dossier doit montrer avoir été faites.
Puis-je lancer cela sur plusieurs milliers de fournisseurs en une fois ?
Oui. POST /companies/lookup et POST /insolvency/check acceptent chacun jusqu'à 100 éléments par appel, POST /sanctions/screen jusqu'à 50 noms. Chaque élément compte pour une requête ; un lot trop grand est refusé d'emblée avec 429 batch_exceeds_quota, et max_items_now indique combien tiennent à cet instant. Le criblage de sanctions demande en plus l'offre Professional ; les trois autres endpoints fonctionnent sur toutes les offres.
Cela couvre-t-il les bénéficiaires effectifs, pas seulement les dirigeants ?
Seulement pour le Royaume-Uni, via le registre Persons with Significant Control sur la fiche entreprise. L'Espagne, la France, le Royaume-Uni et la Norvège renvoient tous des dirigeants, mais un dirigeant n'est pas un bénéficiaire effectif. L'Irlande et la Pologne sont couvertes au niveau entreprise : pas de dirigeants, pour aucun des deux usages. Pour un fournisseur avec un identifiant LEI, GET /lei/{lei}/relationships ajoute les parents directs et ultimes de niveau 2 du GLEIF.
Quels pays ont réellement une couverture des procédures collectives pour un contrôle fournisseur ?
Les procédures concursales espagnoles sont sur GET /search. La France, le Royaume-Uni et la Norvège sont couverts, entreprises uniquement, via POST /insolvency/check — pour un fournisseur français, GET /insolvency/search?country=FR répond directement à la même question. Six autres marchés sont couverts sans registre d'entreprise associé chez Prometiam : Allemagne, Autriche, Suisse, Finlande, États-Unis et Pays-Bas. L'Irlande et la Pologne n'ont pour l'instant aucune couverture des avis d'insolvabilité, sur aucun des deux endpoints.
Comment continuer à surveiller un fournisseur après son référencement ?
Deux façons. POST /monitor pousse un webhook signé sur les changements de statut, la dissolution et les nouvelles correspondances de sanctions, pour l'Espagne, l'Irlande et la Pologne. Pour l'Espagne, la France et le Royaume-Uni, un balayage quotidien GET /company-events/search capte capital_change, director_change, dissolution et le reste. La Norvège n'a pas de flux d'événements d'entreprise ; un fournisseur norvégien se surveille en relançant résolution et criblage sur un calendrier.