Partager des données avec Socleo via l’API Circuit ouvert

Une API permet de « connecter » un logiciel à un autre logiciel ou service afin d'échanger des données.


Circuit ouvert est une API de Socleo. Grâce à elle, vous pouvez interopérer votre logiciel Socleo avec d’autres outils. Vous pouvez l'utiliser gratuitement. 

Les informations que vous pourrez transmettre et recevoir concernent vos :  

  • produits (et éventuellement vos fournisseurs)
  • commandes (et éventuellement vos clients)
  • niveaux de stock (inventaires)
 

Concrètement, à quoi sert l’API Circuit ouvert ? 

Circuit ouvert vous évite de saisir plusieurs fois des informations sur différents outils. En effet, son objectif est de faire gagner du temps aux circuits courts.

Exemple : Une conserverie utilise Socleo pour vendre sa production et centraliser ses commandes. Pour la fabrication de ses conserves, son équipe utilise le logiciel X. Sur ce dernier, elle a besoin de connaître les quantités à préparer pour chaque type de conserve. Elle utilise donc Circuit ouvert pour récupérer automatiquement les informations liées aux commandes de ses clients.


La ressaisie manuelle est chronophage et peut être source d’erreurs, Circuit ouvert a donc un réel intérêt.

Comme mentionné, notre API vous permet d’échanger certaines données. Cela répond aux objectifs expliqués ci-dessous.

Transmission de l'offre produit

Socleo ➡️

  • Exporter le catalogue de vos produits commercialisés depuis Socleo vers un autre outil de commercialisation / distribution.
  • Afficher les produits commercialisés via votre site Socleo sur le logiciel de gestion des achats de vos clients.

Socleo ⬅️

  • Réception de l’offre produit
  • Importer un catalogue de produits. 

Envoi des commandes

Socleo ➡️

  • Transmettre les commandes de vos clients à vos fournisseurs ou prestataires logistiques.
  • Envoyer à vos clients des données concernant leurs commandes (avis d’expédition, etc.).

Réception des commandes

Socleo ⬅️

  • Récupérer l'ensemble des commandes de vos clients afin de les regrouper sur Socleo (ex : les commandes faites via une caisse).
  • Recevoir sur Socleo toutes les commandes de vos clients saisies depuis leur logiciel de gestion des achats. 

Transmission d’inventaires

Socleo ⬅️

  • Mettre à jour votre inventaire sur Socleo depuis les données d’un autre outil.
     

Comment utiliser l’API Circuit ouvert ? 

Mise en place

1) Contactez-nous depuis le formulaire d'assistance Nous vous transmettrons les éléments suivants, gratuitement. 
  • L'URL d'appel du web service
  • Un identifiant pour votre structure
  • La version de l’API utilisée 
  • La clé de sécurité
De votre côté, vous n’avez rien à nous communiquer.

2) Transmettez la clef de sécurité à l’équipe de l’outil avec lequel vous envisagez de connecter votre logiciel Socleo.

Il est de votre responsabilité de conserver la clé de sécurité de façon sûre et de la transmettre uniquement à des tiers de confiance. 
 

Est-ce que l’API Circuit Ouvert va évoluer ? 

Oui, une nouvelle API est en cours de création. 
 

Pour conclure, voici plus d'informations techniques sur Circuit ouvert : 
La classification des produits
Le manuel technique de le version 2.3.3