Tutoriel 2 — Pousser une commande Weboria → Commertra

Objectif : à chaque commande payée sur votre boutique Weboria, créer le ticket NF525 correspondant dans la caisse Commertra (avec décrément du stock).

Bonne nouvelle : ce flux est en partie déjà automatisé en interne (cf. consumer worker). Ce tutoriel montre comment l'enrichir / le surveiller / le compléter avec votre propre logique.

Pré-requis

• Site Weboria actif (rattaché à un tenant Commertra via site.commertra_company_id)
• API key Commertra scope read,write
• API key Weboria scope read (pour vérifier les commandes)

1. Lister les commandes Weboria du jour

curl "https://app.weboria.servolution.fr/api/v1/orders?status=paid&since=2026-05-10" \
  -H "X-API-Key: $WEBORIA_KEY"

2. Vérifier les tickets Commertra créés

curl "https://app.commertra.servolution.fr/api/v1/factures?source=weboria&limit=20" \
  -H "X-API-Key: $COMMERTRA_KEY"

3. Forcer la création d'un ticket si manquant

curl -X POST https://app.commertra.servolution.fr/api/v1/factures \
  -H "X-API-Key: $COMMERTRA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_email": "client@example.fr",
    "source": "weboria",
    "source_ref": "WBORD-2026-1234",
    "lignes": [
      {"sku": "PROD-A", "quantite": 2, "prix_unitaire_cents": 1990, "tva_pct": 20}
    ],
    "paiements": [
      {"mode": "stripe", "montant_cents": 3980, "ref": "pi_..."}
    ]
  }'

4. Cas d'usage : enrichir le ticket avec le code vendeur

Si vous voulez attribuer la vente Weboria à un vendeur Commertra spécifique (commission), passez code_vendeur dans le payload :

{
  ...
  "code_vendeur": "VND-007",
  ...
}

5. Webhooks (futur)

Au lieu de poller, vous pouvez vous abonner aux events :

Ressources

• Spec OpenAPI Weboria
• Spec OpenAPI Commertra