Webhook Bon de commandes

Peopulse prend en charge les Webhooks pour permettre des notifications en temps réel lorsqu’un bon de commande se génère.

Pour recevoir ces notifications, le client doit configurer une URL de callback qui sera appelée automatiquement par Peopulse lorsqu’un de ces événements survient.

Peopulse utilise un format de payload léger pour les Webhooks. Ce payload contient uniquement les informations essentielles, notamment l’identifiant de l’entité concernée.

L’objectif est de minimiser la charge utile tout en permettant à votre système d’effectuer une requête GET vers l’API Peopulse afin de récupérer les détails complets de l’entité.

Structure des webhooks :

Header :

{
  "user-agent": "Symfony HttpClient (Curl)",
  "content-length": "100",
  "accept": "*/*",
  "accept-encoding": "gzip",
  "authorization": "Bearer eyJ0eXAiOiJKU….uqqTKcUzY6hikhsG2KtyrA",
  "content-type": "application/x-www-form-urlencoded",
  "x-forwarded-for": "10.X.10.X",
  "x-forwarded-host": "CallBack Url",
  "x-forwarded-proto": "https"
}

Body :

application/x-www-form-urlencoded

id=5744&
sitePeopulseId=SUPPORT00000001&
agencyPeopulseId=RHXNETT00000005&
event=PURCHASE_ORDER_CREATED
customerPeopulseId=SUPPORT

Détails de paramètres :

• id : identifiant unique de l’entité concernée (ex. : mission, bon de commande, etc.)
• sitePeopulseId : identifiant du site client dans Peopulse
• agencyPeopulseId : identifiant de l’agence émettrice dans Peopulse
• event : type d’événement déclencheur (EX : PURCHASE_ORDER_CREATED)
• customerPeopulseId : identifiant client