Comment utiliser l’API ouverte d’IABAKO ?

L’API ouverte d’IABAKO vous permet de connecter votre compte à n’importe quel système externe : site e-commerce, CRM, catalogue produit ou outil maison. Elle est accessible depuis Profil > Accès API, et réservée à l’abonnement Enterprise. La documentation complète se trouve sur iabako.readme.io/reference.

Concrètement, si vous recevez des commandes depuis une boutique en ligne ou depuis un CRM, l’API vous évite de ressaisir chaque commande à la main dans IABAKO. Elle vous permet d’importer les données automatiquement, les rattacher aux bons clients et aux bons produits, et maintenir tout à jour.

Ce que l’API permet de faire

L’API couvre les ressources principales de votre compte :

• Créer et lire des clients, des produits, des commandes et des ventes (factures).
• Importer les commandes de votre e-commerce directement dans IABAKO.
• Synchroniser les clients et leurs commandes depuis un CRM.
• Intégrer un catalogue produit venant d’un autre système.

L’accès est sécurisé par authentification via token JWT (OAuth2). Vous retrouvez votre token depuis Profil > Accès API.

Contrôler la mise à jour automatique des fiches clients et produits

Par défaut, quand l’API crée une nouvelle vente ou une commande, elle met à jour la fiche client et la fiche produit associées. C’est le comportement attendu : vos données restent toujours à jour. Mais dans certains cas, vous préférerez bloquer cette mise à jour.

Deux options existent pour cela :

• Depuis l’interface IABAKO : sur la fiche d’un client ou d’un produit créé via l’API, un switch vous permet de déconnecter la synchronisation manuellement.
• Depuis l’API : un attribut updateDisabled est disponible sur les objets Customer et Lines (pour les ventes et les commandes). Lorsque sa valeur est true, la création d’une vente ou d’une commande ne modifie rien sur la fiche client ni sur la fiche produit. Si le client existe déjà (par externalId ou numéro), il est simplement associé à la vente, sans aucune modification.

C’est un réglage que beaucoup d’utilisateurs découvrent trop tard, surtout quand ils gèrent des tarifs spécifiques par client et ne veulent pas qu’une synchronisation les écrase.

Ce qu’il faut savoir

• L’API ouverte est réservée à l’abonnement Enterprise (40 euros HT/mois, ou 32 euros HT/mois en annuel).
• L’API est enrichie régulièrement de nouvelles fonctionnalités. Consultez la documentation sur iabako.readme.io/reference pour suivre les évolutions.
• L’attribut updateDisabled concerne les objets Customer et Lines. Il n’empêche pas la création du document, il bloque uniquement la mise à jour des fiches associées.
• Si un client ou un produit n’existe pas encore au moment de l’appel API, il sera créé. L’attribut updateDisabled ne bloque que les mises à jour, pas les créations.
• Les intégrations e-commerce natives (WooCommerce, Shopify, PrestaShop, Wix) et l’intégration comptable Pennylane sont distinctes de l’API ouverte, même si elles sont aussi incluses dans l’abonnement Enterprise.

Pour aller plus loin

• Documentation API IABAKO (iabako.readme.io/reference)