Comment ça marche

De la première interface à la mise en production.

API Manager s'installe chez vous, à côté de votre base Colibase. Nous le mettons en place avec vous et avec votre partenaire.

Étape 1 sur 6 · avec vous

Choisir les interfaces

On part de vos échanges réels : avec qui, quoi, à quelle fréquence. Vous n'activez que les interfaces utiles ; les autres restent invisibles.

  • Inventaire de vos partenaires et de leurs formats
  • Interfaces existantes ou à développer
  • Planning avec votre partenaire
Interfaces activées : std, reflex, gls

Étape 2 sur 6 · Colibase Solutions

Installer sur votre serveur

API Manager tourne sur votre serveur Windows, en service ou sous IIS, relié à votre base Colibase. Vos données restent chez vous.

  • Service Windows ou site IIS
  • Connexion à la base Colibase
  • Adresse et mot de passe de la documentation
Version 1.48 · base SRV-ERP\COLIBASE

Étape 3 sur 6 · avec votre partenaire

Paramétrer le partenaire

Les accès fournis par le partenaire (serveur SFTP, identifiants, clé d'API) et vos codes chez lui sont enregistrés dans Colibase.

  • Accès SFTP ou identifiants d'API du partenaire
  • Codes entrepôt, compte transporteur
  • Dossiers d'échange
Partenaire : GLS ShipIT-Farm · compte [à fournir]

Étape 4 sur 6 · avec vous

Planifier les traitements

Pour les échanges par fichiers, on fixe la plage horaire et la fréquence de chaque traitement.

  • Plage horaire par traitement
  • Fréquence en minutes
  • Suspension sans désinstaller
Remontées Reflex · 06:00-19:59 · toutes les 2 min

Étape 5 sur 6 · vous et votre partenaire

Recetter

On essaie chaque échange sur des cas réels : la documentation permet de lancer un appel et de voir la réponse, sans écrire de code.

  • Essais depuis la documentation
  • Contrôle dans Colibase
  • Validation par le partenaire
GET /Api/Customer/GetActiveCustomersList → 200

Étape 6 sur 6 · Colibase Solutions

Mettre en production

Les échanges tournent seuls. Votre supervision interroge le point de contrôle, et une erreur d'interface déclenche un e-mail.

  • Point de contrôle /health
  • E-mail en cas d'erreur d'interface
  • Journaux sur votre serveur
GET /health → {"status":"ok","db":"ok"}

Deux façons d'échanger

Le partenaire appelle, ou API Manager va chercher.

EN DIRECT · API

Le logiciel du partenaire appelle Colibase

Une boutique veut le stock, un outil crée une commande : il appelle l'adresse décrite dans la documentation et reçoit la réponse aussitôt.

Exemples : boutique Palladium CMS, création de clients et de commandes, Mediaco.

À HEURE FIXE · FICHIERS

API Manager dépose et relève les fichiers

Le partenaire travaille par fichiers sur un serveur SFTP. Un traitement planifié dépose ce qui part et intègre ce qui revient.

Exemples : WMS Reflex, logisticien EGO, export de fichiers clients.

Mise en place : [délai à fournir] selon l'interface.

Le plus long est souvent d'obtenir les accès du partenaire. Nous coordonnons avec lui.