forumNouveau sujet

On nous a dit « on va faire une intégration API » — comment ça se passe concrètement, qu'attend-on de nous ?

NNuri N***Membre actifMembre de la communauté
Membre depuis
nov. 2023
Message
4
#1

Sur notre site e-commerce on tourne à environ 60-70 commandes par jour. Jusqu'à maintenant un employé saisissait chaque soir manuellement les factures et les mouvements de stock dans notre logiciel de comptabilité. On a signé avec une équipe de dev externe pour synchroniser automatiquement les commandes, les comptes clients et les stocks. Ils nous ont annoncé un budget de 45.000 TL et un délai de 3 semaines.

Lors du premier point ils nous ont dit : « Préparez les endpoints d'API de l'autre côté ainsi que l'environnement de test on s'occupe du reste ». Le problème c'est qu'on n'est pas une boîte tech. du coup quand on a appelé l'éditeur de notre logiciel comptable ils nous ont réclamé 12.000 TL de frais pour débloquer la licence API nous ont simplement envoyé un lien vers une doc et se sont retirés de l'affaire.

En pratique par quelles étapes passe ce genre de projet d'intégration API ? Pour que le chantier n'avance pas au ralenti, quels accès, comptes et données notre entreprise doit-elle fournir ? Un délai de 3 semaines, ça vous paraît réaliste ?

RRecep T***Nouveau membre
Poste
Représentant commercial terrain
Secteur
Logistique
Type d'organisation
filiale d'un groupe
Membre depuis
août 2026
Message
39

Doki · Configuration de sauvegarde · 2023

Plus utile#2

Réponse courte : une intégration API consiste à faire communiquer automatiquement votre site web et votre logiciel comptable selon des règles prédéfinies. Pour faire avancer le projet, vous devez faire activer la licence API de votre logiciel de compta, transmettre la documentation développeur à votre prestataire technique et lui fournir un environnement de test afin de travailler sans toucher aux données de production.

En temps normal, le processus suit quatre étapes. La première est le mapping de données : on fait correspondre chaque champ de votre site (nom du client, numéro fiscal, référence produit, taux de TVA, frais de port) avec le champ équivalent du logiciel de compta. La deuxième étape est le développement et l'intégration dans l'environnement de test (sandbox) : le dev y crée de fausses commandes pour valider le transfert vers la compta.

La troisième étape consiste à tester les cas d'erreur. Par exemple, comment réagit le système si le numéro de TC n'est pas renseigné, comment sont gérés les codes promo sur la facture, comment sont lettrés les annulations et retours en compta... Lors de la quatrième étape, on renseigne les clés d'API de production pour ouvrir le flux aux vraies commandes, tout en surveillant de très près les premiers jours.

On attendra principalement trois choses de votre part : 1) Les clés d'API et la documentation technique fournies par l'éditeur de compta, 2) L'accès à la base de test, 3) Votre validation écrite sur les règles métier (moment de facturation, logique de suivi des stocks, remises appliquées). Si le support du logiciel de compta fournit une doc complète sans traîner, 3 semaines est un délai tout à fait raisonnable ; mais si leur support est lent, comptez plutôt 5 semaines.

UUfuk S***Membre actif
Poste
Comptabilité préliminaire
Secteur
Agriculture
Type d'organisation
coopérative
Membre depuis
juin 2022
Message
74

Doki · Support à la réponse aux incidents · 2025

#3

L'erreur la plus critique, ce sont les références produits qui ne correspondent pas. Si les codes SKU de votre site ne sont pas rigoureusement identiques à ceux de votre logiciel de compta, l'intégration plantera dès le premier jour. Avant de donner le feu vert aux développeurs, vérifiez vous-même dans un fichier Excel que chaque référence produit matche parfaitement des deux côtés.

CCanMembre actif
Poste
Expert SEO
Membre depuis
mars 2024
Message
172
#4

Définissez bien par écrit si l'intégration est unidirectionnelle ou bidirectionnelle. Est-ce qu'on envoie juste les commandes du site vers la compta, ou est-ce que les stocks et les prix modifiés dans la compta doivent aussi se mettre à jour sur le site ? En bidirectionnel, il faut gérer les limites de requêtes API et les conflits d'écritures, ce qui rallonge directement le temps de dev.

KKader U***Membre actif
Poste
Employé de magasin
Secteur
Médias et édition
Type d'organisation
entreprise familiale
Membre depuis
juin 2024
Message
86
#5

On a fait une intégration similaire l'année dernière. Obtenir la licence API et les clés de test auprès de l'éditeur de compta nous a pris 9 jours entiers. L'équipe de dev a fini de coder en 12 jours, mais les tests ont pris 8 jours de plus parce que les lignes de transport et de remises posaient problème côté compta. Au total, la mise en prod a pris 29 jours.

OOrhan T***Membre actifMembre de la communauté
Membre depuis
mars 2024
Message
242
#6

Voici votre to-do list côté entreprise : 1) Demandez l'accès sandbox et la doc technique à votre éditeur de compta. 2) Cadrez avec votre expert-comptable les règles de gestion pour les annulations, retours et livraisons partielles, puis rédigez des consignes claires. 3) Avant le passage en production, faites générer des factures tests sur au moins 15 scénarios différents.

YYaseminMembre actif
Poste
Propriétaire PME
Membre depuis
juil. 2024
Message
98
#7

Votre logiciel de comptabilité est basé sur le cloud ou installé sur un serveur local dans vos bureaux ? S'il tourne sur une machine au bureau, il faudra une IP fixe et ouvrir des ports sur le serveur. Ça peut créer des failles de sécurité, sans compter que si la connexion saute au bureau l'intégration s'arrête net ; vous avez abordé ce point ?

TTaner E***Membre actif
Poste
Responsable des achats
Secteur
cuir
Type d'organisation
startup en phase de lancement
Membre depuis
juin 2023
Message
132
#8

au début notre comptable avait des erreurs sur les factures des clients étrangers qui n'avaient pas de numéro d'identification tc. franchement si vous avez des commandes de l'étranger ou que vous faites de la facturation b2b, mettez-vous d'accord dès maintenant sur le mapping des champs sinon les commandes restent bloquées dans le système.

edit : j'ai écrit une erreur ci-dessus, désolé.

SSinemExpert
Poste
Chef de projet
Membre depuis
oct. 2023
Message
176
#9

Mettez l'équipe de dev et le support technique de votre logiciel comptable dans une même boucle d'e-mails ou sur un canal dédié. Vous n'avez pas à maîtriser le jargon technique ni à faire le relais. Laissez les techniciens gérer directement entre eux les paramètres et les endpoints.

VVahide K***Membre actif
Poste
Graphiste
Secteur
Énergie
Type d'organisation
Entreprise de 120 personnes
Membre depuis
nov. 2023
Message
411
#10

Pour notre première intégration, on ne voulait pas payer 12.000 TL pour un environnement de test on a donc testé direct sur la base en production. Le dev a généré une facture test et un vrai client a reçu la facture e-arşiv ainsi que les notifications par SMS. Ce jour-là, on a vite compris que payer pour un environnement de test était en fait la meilleure des assurances.

OOnur M***Expert
Poste
Comptable
Secteur
Plastique
Type d'organisation
entreprise de taille moyenne
Membre depuis
mai 2023
Message
7
#11

Enregistré.

HHüseyin S***VétéranMembre de la communauté
Membre depuis
juil. 2022
Message
175
#12

La réponse ci-dessus va droit au but. Le vrai problème n'est pas le chiffre, mais la base sur laquelle il est calculé.

Les décisions hâtives finissent par être corrigées six mois plus tard. Je suis aussi curieux de savoir si d'autres font autrement.

İİbrahim Y***Membre actifMembre de la communauté
Membre depuis
déc. 2024
Message
182
#13

Il y a un point que je ne comprends pas. Si la propriété du code n'est pas mentionnée dans le contrat, vous perdez tout pouvoir de négociation au départ.

Je suis aussi curieux de savoir si d'autres font autrement.

HHilal B***Vétéran
Poste
Graphiste
Secteur
Électricité-électronique
Type d'organisation
distributeur régional
Membre depuis
déc. 2023
Message
17
#14

Je partage mon expérience. Les accès doivent être créés au nom de l'entreprise, pas avec des comptes personnels.

Je le note au cas où.

İİbrahim Y***Membre actifMembre de la communauté
Membre depuis
févr. 2026
Message
3
#15

je suis d'accord.

EElifMembre actif
Poste
Propriétaire de chaîne de cafés
Type d'organisation
Entreprise de production de 40 personnes
Membre depuis
août 2024
Message
63

Doki · Support à la réponse aux incidents · 2024

#16

Ne manquez rien : L'offre la moins chère est généralement la moins réfléchie.

À votre place j'irais par cette voie.

HHavva K***Membre actifMembre de la communauté
Membre depuis
juil. 2024
Message
111
#17

La solution qui semble bon marché finit souvent par coûter cher. Les accès doivent être créés au nom de l'entreprise, pas avec des comptes personnels.

Ce qui nous faisait perdre le plus de temps, c'était l'absence de clarté sur qui prenait les décisions. Si vous avez des questions, écrivez-moi, je répondrai au mieux.

MMehmet A***Expert
Poste
Développeur logiciel
Secteur
Formation
Type d'organisation
Entreprise de 300 personnes
Membre depuis
juil. 2022
Message
2
#18

Je me permets une petite mise en garde. Tout point non écrit est un point que les deux parties se rappelleront différemment plus tard.

À votre place, j'irais par cette voie.

KKübra G***Expert
Poste
Directeur des systèmes d'information
Secteur
Sport et fitness
Type d'organisation
Entreprise de 20 personnes
Membre depuis
nov. 2025
Message
10
#19

J'ai vécu la même chose. Un rapport d'avancement écrit hebdomadaire est bien plus utile que de demander des dates.

Commencez par un petit test, ne vous engagez pas sur tout d'un coup. Bon courage.

OOsman K***Membre actifMembre de la communauté
Membre depuis
mars 2024
Message
117
#20

Merci d'avoir écrit cela, c'est exactement ça. Les décisions hâtives finissent par être corrigées six mois plus tard.

N'hésitez pas à demander, celui qui ne demande pas paie toujours plus cher. Voilà, désolé si je me suis étendu.

Répondre