API Reference
Commandes
Creation, historique et suivi des commandes.
Les endpoints commandes sont sous /api/v1/orders. Une commande dans Qovans cree un ARC (Accuse de Reception de Commande) dans Cegid.
Endpoints
| Methode | Path | Description |
|---|---|---|
| POST | /orders | Creer une commande depuis le panier |
| GET | /orders | Historique des commandes |
| GET | /orders/{stub}/{number} | Detail d'une commande Cegid |
| GET | /orders/site-references | References site des commandes |
| GET | /orders/pieces/{nature}/{number} | Document Cegid par nature et numero |
Creer une commande
POST /api/v1/orders
Content-Type: application/json
{
"delivery_address_id": "ADR001",
"delivery_mode": "standard",
"department_code": "14",
"external_reference": "PO-2026-001",
"comment": "Livraison matin uniquement"
}Ce qui se passe :
- Le backend valide le panier (stock, prix)
- Cree un ARC dans Cegid via l'API (
POST /orders) - Vide le panier
- Envoie les notifications email (client + depot)
Si Cegid est indisponible (VPN down, weekend), la commande echoue avec un 503.
Historique
GET /api/v1/orders?skip=0&limit=20L'historique est lu en temps reel depuis Cegid. Il inclut toutes les commandes du client, pas seulement celles passees via Qovans.
Suivi
Le detail d'une commande affiche les lignes, le timeline (commande → preparation → bon de livraison → facture) et les documents lies.