Ce guide vous accompagne de votre première requête jusqu'à la création d'un client et d'une facture. En 5 minutes, vous aurez une intégration fonctionnelle.Vous devez avoir votre clé API en main. Si ce n'est pas le cas, consultez la page Authentification.
Étape 1 : Valider votre accès#
Commencez par un appel simple pour vérifier que votre clé fonctionne.Si vous recevez un 200, votre clé est valide et l'API est accessible.Un 401 signifie que votre clé est invalide ou absente. Un 503 signifie qu'Acomba n'est pas démarré ou que le SDK est en pause. Consultez la page Codes d'erreur pour plus de détails.
Étape 2 : Lire un client existant#
Récupérez la fiche complète d'un client par son code.Vous pouvez aussi lire un client par son ID interne avec GET /api/customers/by-id/34. L'ID interne est immuable, contrairement au code qui peut changer.
Étape 3 : Créer un client#
Créez un nouveau client avec les champs minimum requis.L'id retourné est l'identifiant interne du client dans Acomba. Conservez-le pour vos opérations futures.
Étape 4 : Créer une facture#
Créez une facture pour le client que vous venez de créer. Le champ customer_code fait le lien avec la fiche client.
Et ensuite ?#
Vous avez validé votre accès, lu une fiche client, créé un client et créé une facture. Voici les prochaines étapes selon votre cas d'usage :Concepts clés
Comprenez la pagination, les modes brief/full et les réponses de mutation avant d'aller plus loin.Synchronisation incrémentale
Utilisez GET /api/helpers/updates pour récupérer uniquement les changements depuis votre dernière synchronisation.Paiements clients
Enregistrez des paiements sur vos factures avec POST /api/customers/payments.Inventaire
Gérez vos produits, articles et composantes avec les routes d'inventaire. 