{"openapi":"3.0.3","info":{"title":"A10 Bridge — Webhook API","description":"Endpoint REST exposé par le plugin WooCommerce **A10 Bridge**.  \nLe back-end A10 (Optivac) appelle cet endpoint pour notifier en temps réel\nles changements de statut des commandes (confirmation, expédition, livraison).\n\n**Authentification** : toutes les requêtes doivent inclure le header\n`X-OPTIVAC-API-KEY` avec la clé configurée dans les réglages du plugin.\n","version":"1.2.0","contact":{"name":"Makeessens","url":"https://makeessens.fr"}},"servers":[{"description":"SwaggerHub API Auto Mocking","url":"https://virtserver.swaggerhub.com/cismartdevorganizati/a10-bridge-webhook/1.2.0"},{"url":"https://{shop_domain}/wp-json/a10-bridge/v1","description":"Instance WooCommerce cible","variables":{"shop_domain":{"default":"shop.example.com","description":"Domaine de la boutique WooCommerce"}}}],"security":[{"ApiKeyAuth":[]}],"paths":{"/webhook":{"post":{"summary":"Recevoir une notification de statut A10","operationId":"receiveWebhook","description":"Reçoit une notification push depuis le back-end A10.  \nLe plugin met à jour la commande WooCommerce correspondante\net déclenche les actions associées (email client, completion automatique, etc.).\n\n### Comportements par statut\n\n| Statut | Actions déclenchées |\n|--------|---------------------|\n| `CONFIRMED` | Note de commande admin |\n| `SHIPPED` | Sauvegarde tracking + email client + completion auto (si activée) |\n| `DELIVERED` | Idem `SHIPPED` |\n","tags":["Webhook"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookPayload"},"examples":{"confirmed":{"summary":"Commande confirmée fournisseur","value":{"woocommerceOrderId":"142","orderId":"A10-789","status":"CONFIRMED"}},"shipped":{"summary":"Commande expédiée avec tracking","value":{"woocommerceOrderId":"142","orderId":"A10-789","status":"SHIPPED","trackingUrl":"https://www.colissimo.fr/portail_colissimo/suivreResultat.do?parcelnumber=6X123456789FR","carrier":"Colissimo","shippedAt":"2026-04-10","estimatedDelivery":"2026-04-15"}},"delivered":{"summary":"Commande livrée","value":{"woocommerceOrderId":"142","orderId":"A10-789","status":"DELIVERED","carrier":"Colissimo","shippedAt":"2026-04-10"}}}}}},"responses":{"200":{"description":"Notification traitée avec succès","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"},"example":{"success":true}}}},"400":{"description":"Payload invalide (champ obligatoire manquant)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":"Missing woocommerceOrderId"}}}},"401":{"description":"Clé API absente ou invalide","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":"Clé API invalide."}}}},"404":{"description":"Commande WooCommerce introuvable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":"Order not found"}}}},"500":{"description":"Erreur interne — aucune clé API configurée côté plugin","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":"Clé API non configurée."}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-OPTIVAC-API-KEY","description":"Clé partagée entre le back-end A10 et le plugin WooCommerce.\nConfigurée dans **WooCommerce > A10 Bridge > Réglages**.\n"}},"schemas":{"WebhookPayload":{"type":"object","required":["woocommerceOrderId","status"],"properties":{"woocommerceOrderId":{"type":"string","description":"Identifiant de la commande côté WooCommerce.","example":"142"},"orderId":{"type":"string","description":"Identifiant de la commande côté A10.","example":"A10-789"},"status":{"type":"string","description":"Nouveau statut de la commande.","enum":["CONFIRMED","SHIPPED","DELIVERED"],"example":"SHIPPED"},"trackingUrl":{"type":"string","format":"uri","nullable":true,"description":"URL de suivi du colis chez le transporteur.\nRequis pour les statuts `SHIPPED` et `DELIVERED`.\n","example":"https://www.colissimo.fr/portail_colissimo/suivreResultat.do?parcelnumber=6X123456789FR"},"carrier":{"type":"string","nullable":true,"description":"Nom du transporteur.","example":"Colissimo"},"shippedAt":{"type":"string","format":"date","nullable":true,"description":"Date d'expédition au format ISO 8601 (`YYYY-MM-DD`).\nUtilisée pour calculer la date de livraison estimée si `estimatedDelivery` n'est pas fourni.\n","example":"2026-04-10"},"estimatedDelivery":{"type":"string","format":"date","nullable":true,"description":"Date de livraison estimée au format ISO 8601 (`YYYY-MM-DD`).\nSi absent, le plugin calcule automatiquement la date en ajoutant\nle délai configuré (défaut : 5 jours ouvrés) à `shippedAt`.\n","example":"2026-04-15"}}},"SuccessResponse":{"type":"object","properties":{"success":{"type":"boolean","example":true}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Message d'erreur lisible.","example":"Missing woocommerceOrderId"}}}}}}