Intégrer Salla/Zid à vos systèmes internes via API

Que signifie intégrer Salla ou Zid à vos systèmes internes ?

Connecter votre boutique Salla ou Zid à vos systèmes internes via une API signifie que la boutique échange automatiquement des données avec vos autres systèmes (stocks, comptabilité, ERP, CRM et transporteurs) sans aucune saisie manuelle. Au lieu qu'un employé recopie chaque commande depuis le tableau de bord de la boutique dans le logiciel comptable, la commande part vers le bon système dès qu'elle est passée, le stock se met à jour dans les deux sens, la facture est émise et l'expédition est préparée, le tout en quelques secondes et sans erreur de recopie.

Cet article explique, à l'intention d'un chef d'entreprise, ce qu'offrent les API de Salla et de Zid, les principaux scénarios d'intégration et la manière de construire une intégration solide qui résiste à l'exploitation quotidienne.

Pourquoi avez-vous besoin de cette intégration ?

À mesure que les ventes augmentent, la saisie manuelle devient le goulet d'étranglement le plus dangereux : des commandes recopiées à la main qui arrivent en retard ou erronées, un stock affiché comme disponible sur la boutique alors qu'il est en réalité épuisé à l'entrepôt, et des chiffres de vente qui ne concordent pas entre la boutique et la comptabilité en fin de mois. Tous ces problèmes ont une même origine : des systèmes isolés qui ne communiquent pas entre eux. L'intégration par API transforme ces îlots séparés en un système unique, si bien que le travail en double disparaît et que les chiffres se rapprochent automatiquement.

• Gain de temps : des heures quotidiennes de saisie se transforment en une synchronisation instantanée, sans intervention humaine.
• Précision des stocks : un seul solde exact s'affiche sur la boutique et à l'entrepôt ; plus de vente d'un article épuisé ni de blocage d'un article disponible.
• Une comptabilité rigoureuse : chaque commande arrive en comptabilité avec sa valeur, sa taxe et les données de sa facture prêtes.
• Une meilleure expérience client : des confirmations et des mises à jour d'expédition plus rapides, car le processus est automatisé de bout en bout.

Qu'offrent les API de Salla et de Zid aux développeurs ?

Salla et Zid proposent tous deux des API REST modernes, avec une plateforme dédiée aux développeurs et aux partenaires. Leurs principales offres :

• API REST : un accès programmatique aux produits, aux commandes, aux clients, aux stocks et aux catégories, en lecture comme en écriture.
• Authentification OAuth : une connexion sécurisée qui autorise l'application sans partager de mot de passe, avec des périmètres d'accès définis.
• Webhooks : des notifications en temps réel que la plateforme pousse vers votre système lorsqu'un événement se produit (nouvelle commande, changement de statut, inscription d'un client) au lieu que votre système interroge sans cesse la boutique.
• Place de marché d'applications : la possibilité de publier votre application pour que d'autres commerçants l'utilisent, si vous souhaitez transformer votre intégration en produit.

Ces outils suffisent pour construire presque n'importe quel scénario d'intégration, à condition qu'il soit conçu avec soin.

Les scénarios d'intégration les plus utiles

En pratique, la plupart des commerçants ont besoin d'une ou plusieurs de ces intégrations :

• Synchroniser les commandes avec la comptabilité ou l'ERP : chaque nouvelle commande crée automatiquement une écriture et une facture dans votre système financier.
• Synchronisation bidirectionnelle des stocks : une vente sur la boutique diminue le solde de l'entrepôt, et la réception de nouvelles marchandises met instantanément à jour la disponibilité sur la boutique.
• Pousser les produits de votre système vers la boutique : gérer les produits et les prix depuis un système central unique, puis les publier automatiquement sur Salla ou Zid.
• Synchroniser les clients avec un CRM : chaque nouveau client entre dans votre outil de gestion de la relation client pour activer le marketing et le suivi.
• Connecter l'expédition et la logistique : créer automatiquement une étiquette d'expédition et envoyer le numéro de suivi au client.
• Facturation électronique : générer pour chaque transaction une facture conforme aux exigences de l'Autorité de la zakat, des impôts et des douanes (ZATCA).

Webhooks ou interrogation périodique (polling)

Il existe deux façons de savoir qu'un nouvel événement s'est produit dans la boutique. La première est le polling : votre système demande à la boutique toutes les quelques minutes « Y a-t-il une nouvelle commande ? » ; c'est simple, mais lent et gourmand en ressources. La seconde, meilleure, ce sont les webhooks : vous indiquez une seule fois l'adresse de votre système à la plateforme, et elle vous pousse chaque événement au moment même où il se produit. Les webhooks sont plus rapides et plus légers, mais ils exigent que votre système soit toujours disponible pour recevoir les notifications, avec un mécanisme de nouvelle tentative si une livraison échoue temporairement.

Comment construire une intégration solide et durable ?

Une intégration réussie n'est pas un simple appel d'API ; c'est une couche intermédiaire soigneusement conçue. Les points essentiels qu'elle doit garantir :

• Une correspondance précise des champs : faire correspondre les produits et les codes de la boutique à leurs équivalents dans votre système interne, afin que les données ne se mélangent jamais.
• L'idempotence : garantir qu'une même commande n'est jamais enregistrée deux fois si la notification arrive plus d'une fois.
• Des nouvelles tentatives intelligentes : si une connexion échoue temporairement, le système réessaie automatiquement au lieu de perdre l'événement.
• Le respect des limites de débit : les plateformes plafonnent le nombre de requêtes par minute, et l'intégration doit les respecter sans tomber en panne.
• Journalisation et rapprochement : un tableau de bord qui montre ce qui a été synchronisé et ce qui a échoué, avec un rapport quotidien qui garantit qu'aucune commande ne se perd en silence.

Négliger ces détails, c'est toute la différence entre une intégration qui fonctionne en démonstration puis s'effondre au bout d'une semaine, et une intégration qui tourne discrètement pendant des années.

Les erreurs courantes à éviter

Ce qui fait le plus souvent échouer les projets d'intégration : se contenter d'une synchronisation à sens unique en oubliant le sens inverse, ignorer les cas d'échec si bien que des commandes disparaissent sans que personne ne s'en aperçoive, ou ne pas disposer d'environnement de test, de sorte que les modifications sont testées sur une boutique en production avec de vraies commandes. La règle d'or : construire l'intégration pour qu'elle gère l'échec autant que la réussite, et la tester dans un environnement séparé avant la mise en production.

Le rôle d'Origami

Chez Origami, société technologique, nous construisons des intégrations fiables au-dessus de Salla et de Zid : nous connectons votre boutique à votre comptabilité, à votre ERP, à votre CRM ou à vos transporteurs, et nous concevons la couche intermédiaire avec nouvelles tentatives, rapprochement et journalisation complète. Et si vous n'avez pas encore tranché entre une plateforme prête à l'emploi et une boutique sur mesure, notre article Boutique sur mesure ou Salla/Zid vous aide à décider avant que nous lancions l'intégration.

Une bonne intégration est invisible : seul son résultat se voit. Des chiffres qui concordent, un stock exact et une équipe libérée pour ce qui compte.

Sources

• Plateforme des développeurs Salla : salla.dev
• Zid, plateforme de boutiques en ligne : zid.sa
• Autorité de la zakat, des impôts et des douanes (ZATCA), facturation électronique : zatca.gov.sa