Fonctionnalités
Une API pour l'ERP, des interfaces pour vos partenaires.
Tout ce qui suit existe et tourne en production chez nos clients. Les écrans sont ceux de la WebApi Colibase 1.48, sur une base de démonstration.
01 · L'API de l'ERP
Un autre logiciel lit et écrit dans Colibase.
Votre site, votre outil de prise de commande ou celui d'un partenaire appelle API Manager ; la réponse arrive en JSON, directement depuis la base Colibase.
- Clients : recherche par code, SIREN, centrale d'achat ou classification ; fiche complète, adresses, contacts
- Création : client, adresse, contact, accès web, commande client
- Pas de doublon : une commande dont le numéro existe déjà est refusée
- Stock : disponible par article, pour afficher le bon chiffre ailleurs que dans l'ERP

« Liste des clients actifs » essayée depuis la documentation : la réponse vient de la base (clients fictifs).

Un document par interface : seules celles qui sont activées apparaissent.
02 · La documentation
Celui qui branche son logiciel n'a pas besoin de nous appeler.
La documentation est générée par l'API elle-même (OpenAPI 3, Swagger) : elle décrit toujours la version installée, appel par appel, et permet de les essayer.

Accès protégé : adresse de la documentation personnalisable et mot de passe. La session dure 8 heures.
03 · Logistique externalisée
L'entrepôt du logisticien, branché sur votre ERP.
Colibase envoie ce que le logisticien doit savoir, et récupère ce qu'il a fait.
Vers l'entrepôt
Familles, articles, fournisseurs, destinataires, réceptions attendues, ordres de préparation.
Vers Colibase
Réceptions, préparations, expéditions, mouvements et états de stock.
Trois interfaces : Reflex (WMS Hardis), Mediaco (JSON, avec un accusé de réception pour chaque message) et EGO (XML).

Module Reflex : chaque message du WMS a son appel, dans les deux sens.

Module GLS : quinze appels, de l'étiquette à la preuve de livraison.
04 · Transport
L'étiquette part de l'expédition Colibase.
- GLS ShipIT-Farm : envoi et étiquettes (PDF ou imprimante Zebra), annulation, réimpression, fin de journée, enlèvement ponctuel
- Après l'envoi : numéro de suivi enregistré dans Colibase, suivi du colis, preuve de livraison en PDF, points relais
- DSV : réservation de transport routier depuis l'expédition
- Erreurs lisibles : chaque code d'erreur du transporteur est traduit en libellé
05 · Boutique en ligne
La boutique Palladium CMS suit l'ERP.
- Articles créés, mis à jour ou retirés de la vente ; images et notices servies depuis les dossiers de l'ERP
- Stock complet ou seulement ce qui a changé
- Commandes web déposées en fichier de commande que Colibase importe ; un fichier déjà écrit n'est jamais écrasé
- Synchronisation complète lancée depuis l'ERP, avec son avancement. Échanges protégés par une clé

Module Palladium CMS Sync : articles, stock, commandes et synchronisation.

Module Facturation numérique : du contrôle à l'assemblage du Factur-X.
06 · Factures
Facturer sans y penser, au format qui sera exigé.
- Factur-X : contrôle des règles EN 16931, XML CII, validation PDF/A-3 et assemblage de la facture
- Facturation automatique des bons de livraison, un par un ou tous ceux qui sont autorisés
- Stock externe : import d'un avis d'expédition pour facturer, en simulation d'abord ; un avis déjà importé est refusé
- Amazon : les fichiers de règlement sont importés pour la facturation
07 · Traitements planifiés
Les échanges tournent seuls, aux heures choisies.
Chaque traitement a sa plage horaire, sa fréquence et peut être suspendu. On voit ceux qui tournent et on peut arrêter celui qui est en cours.
| Traitement | Plage | Fréquence | État |
|---|---|---|---|
| Remontées du WMS Reflex | 06:00 – 19:59 | 2 min | Actif |
| Messages du logisticien (SFTP) | 06:00 – 19:59 | 5 min | Actif |
| Commandes vers préparations | 08:00 – 12:00 | 1 min | Actif |
| Facturation des bons de livraison | 00:00 – 23:59 | 60 min | Suspendu |
Exemple de planification [valeurs à valider].
08 · Surveillance
Vous êtes prévenu avant que le client appelle.
- Point de contrôle : une adresse dit si l'API et la base répondent, avec le temps de réponse et la version. Votre outil de supervision l'interroge
- E-mail en cas d'erreur sur les interfaces logisticien et transporteur
- Journaux : chaque échange est tracé dans des fichiers, sur votre serveur
$ curl https://api.vergers-demo.fr/health { "status": "ok", "db": "ok", "session": "ready", "checkedAtUtc": "2026-10-27T12:47:34Z", "latencyMs": 5, "version": "1.48" }
Réponse réelle, base de démonstration (adresse modifiée).
