Webhook & API

REST API pour modifier les differents actions avec des applications tiers.

Commandes — changement de statut

Met à jour le statut d’une commande identifiée par son code (ex. OR0001).

POST /api/order/changeStatus/OR0001/
Corps (JSON)
{
  "status": "sent"
}

Valeurs possibles : sent, delivered, canceled

Réponses
Succès (200)
{
  "success": true,
  "document": {
    "code": "OR0001",
    "label": "2025-02-CMD-00001",
    "status": "sent",
    "client": "Nom du client",
    "total_ttc": "12000.00",
    "created_at": "2025-02-03T10:00:00+00:00"
  }
}
Erreur (4xx)
{
  "success": false,
  "error": "Order with code \"OR9999\" not found."
}

Transitions autorisées : validated → sent ou canceled ; sent → delivered ou canceled.

Factures — changement de statut

Met à jour le statut d’une facture identifiée par son code (ex. IN0001).

POST /api/invoice/changeStatus/IN0001/
Corps (JSON)
{
  "status": "paid"
}

Valeur possible : paid

Réponses
Succès (200)
{
  "success": true,
  "document": {
    "code": "IN0001",
    "label": "2025-02-FAC-00001",
    "status": "paid",
    "client": "Nom du client",
    "total_ttc": "12000.00",
    "created_at": "2025-02-03T10:00:00+00:00"
  }
}
Erreur (4xx)
{
  "success": false,
  "error": "Invoice with code \"IN9999\" not found."
}

Transition autorisée : validated → paid.

Limitations
  • Utilisez toujours le code (OR0001, IN0002)
  • Seules les transitions listées sont acceptées ; les autres renvoient 400.
  • Requête : POST uniquement, Content-Type: application/json.
  • Authentification non requise par défaut ; sécurisez l'accès en production si besoin.