API Bling : ce qu'on peut faire et comment l'utiliser avec des agents IA
L'API de Bling, ERP brésilien, donne accès aux fiches et aux mouvements de l'ERP : produits, stock, commandes, factures fiscales (NF-e), contacts et finance. Elle sert aux boutiques en ligne, aux intégrateurs et aux entreprises qui relient places de marché et systèmes à Bling. La version actuelle exige une application enregistrée et l'autorisation OAuth du compte client.
Ce que propose l’API Bling
Produits
Fiches produits, variantes, prix et nomenclatures.
Stock
Consultation des soldes par dépôt et saisie des mouvements.
Commandes de vente
Création, consultation et changement de statut des commandes, y compris celles venant de boutiques connectées.
Factures fiscales
Émission et consultation de NF-e et NFC-e (factures électroniques fiscales brésiliennes) à partir des commandes.
Contacts
Clients, fournisseurs et transporteurs.
Comptes à payer et à recevoir
Titres financiers, règlements et catégories.
Webhooks
Alertes de changement sur les commandes, produits et stock pour réagir sans interroger sans cesse.
Comment accéder à l’API Bling
- Avec les identifiants de votre entrepriseOAuth 2.0 : vous enregistrez une application dans l'espace développeur de Bling et le compte de l'entreprise autorise les périmètres ; le jeton d'accès est renouvelé avec un jeton de rafraîchissement.
- L'API limite les requêtes par seconde et par jour ; les grosses synchronisations doivent passer par des webhooks.
- L'ancienne API par clé a été remplacée par la v3 avec OAuth ; les anciennes intégrations doivent migrer.
- Les factures émises ont un effet fiscal : gardez la validation humaine à cette étape.
Documentation officielle: developer.bling.com.br
Ce qu’un agent iTeam fait avec l’API Bling
Commande bloquée sans facture
L'agent repère les commandes facturables depuis plus d'un jour sans NF-e émise et prévient le service fiscal avec la cause probable, par exemple une fiche client incomplète.
Rupture avant qu'elle n'arrive
En croisant les ventes récentes et le solde par dépôt, l'agent signale les produits qui vont tomber à zéro dans la semaine et prépare la suggestion d'achat que l'acheteur validera.
Statut de commande sur WhatsApp
Le client B2B s'enquiert de sa commande et l'agent consulte statut, facture et transporteur dans Bling, sans solliciter le commercial.
Relance des titres échus
L'agent liste les créances échues, les regroupe par client et envoie le rappel avec le duplicata, en consignant le contact.
De l’identifiant à l’agent au travail, avec validation
Enregistrer l'application dans Bling
Dans l'espace développeur, créez l'app avec les périmètres minimaux (par exemple commandes et stock) et autorisez-la avec un utilisateur administrateur.
Stocker l'autorisation dans le coffre d'iTeam
iTeam renouvelle le jeton et chaque agent reçoit ses propres droits : le support lit les commandes, les achats lisent le stock, la finance lit les titres.
Valider avec une approbation humaine
Émission de facture, règlement de titre et modification de stock démarrent avec validation et sont tracés dans l'audit.
Équipes IA prêtes à l’emploi qui utilisent Bling
Questions sur l’API Bling
L'API de Bling est-elle gratuite ?
En général, l'accès à l'API est inclus dans l'abonnement Bling, dans les limites de l'offre. Vérifiez sur votre offre s'il y a des restrictions.
Faut-il programmer pour utiliser l'API de Bling avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation de Bling et l'équipe de déploiement configure les flux.
Peut-on émettre une facture fiscale par l'API ?
Oui, l'API permet d'émettre et de consulter les factures à partir des commandes, selon la configuration fiscale du compte.
