API de données d’entreprise : enrichissement et création ERP
Reliez vos applications à l’enrichissement des données d’entreprise. Un e-mail professionnel, domaine ou site suffit pour démarrer. La même API renvoie du JSON ou crée directement la fiche dans l’ERP.
Que permet l’API de données d’entreprise ?
L’API de données d’entreprise enrichit les fiches à partir des informations publiées sur les sites web et contrôle un numéro de TVA disponible. Un endpoint synchrone propose deux modes : enrich renvoie l’entreprise en JSON ; create crée aussi la fiche dans toutes les connexions ERP actives de l’entreprise. Un contrôle TVA infructueux active un indicateur sans arrêter le processus.
Deux résultats avec une seule intégration ERP
Enrichir ou créer
Utilisez enrich pour l’enrichissement des données dans votre application. Utilisez create pour créer des clients, prospects ou fournisseurs selon les capacités du connecteur. Après enrichissement, un nom d’entreprise, un domaine et un numéro de TVA non vide sont nécessaires.
Clés et attribution utilisateur
Les administrateurs d’entreprise et système gèrent les clés appartenant à l’entreprise, pour l’enrichissement seul ou aussi la création ERP. Chaque requête réelle indique l’e-mail d’un utilisateur existant pour l’attribution et utilise le quota habituel de l’entreprise.
Valeurs par défaut et champs fournis
Conservez les valeurs du payload ERP configuré et complétez-les par les champs compatibles ou des valeurs propres à chaque connexion. Les valeurs fournies restent dans le brouillon de la requête et ne remplacent pas le catalogue partagé des entreprises.
Fonctionnement
- 1
Créer une clé
Un administrateur d’entreprise ou système ouvre Clés API dans le menu du profil et choisit l’enrichissement seul ou l’accès avec création ERP.
- 2
Essayer la démonstration
Ouvrez la documentation API depuis le même menu. Les requêtes valides renvoient un exemple fixe sans quota consommé ni appel aux sites web, services TVA ou ERP.
- 3
Choisir le mode
Votre application serveur envoie un e-mail, domaine ou site avec la clé d’entreprise et l’e-mail de l’utilisateur attribué. Choisissez enrich ou create. La création utilise toutes les connexions actives et nécessite les écritures ERP autorisées.
- 4
Examiner le résultat
Recevez l’entreprise enrichie, l’indicateur TVA et, après création réussie, les références ERP. Conservez le même Idempotency-Key lors d’une nouvelle tentative de création.
Exemple : du formulaire commercial au prospect ERP
Une application commerciale interne reçoit un e-mail d’entreprise. Elle appelle enrich pour afficher les données en JSON. Si le processus autorisé nécessite un prospect ERP, elle utilise create avec le type de fiche et les valeurs de payload adaptés. Les fiches déjà associées sont renvoyées sans modification, plutôt que mises à jour.
L’enrichissement web ne constitue pas une vérification au registre des sociétés. Des données minimales absentes ou de possibles doublons ERP empêchent la création. Les connexions peuvent réussir partiellement ; les échecs renvoient des informations sûres et les écritures terminées ne peuvent pas être annulées ici. Cette API ne propose ni webhook générique ni endpoint par lots.
Questions fréquentes
L’enrichissement et la création ERP utilisent-ils des endpoints différents ?
Quels ERP peuvent recevoir le résultat de l’API ?
Qui gère les clés et teste les requêtes réelles ?
Un contrôle TVA infructueux bloque-t-il la création ERP ?
Une fiche ou une connexion à préparer ?
Configurez votre espace d’entreprise ou décrivez votre ERP et votre besoin via Contact.