colisdocs

Facturer dès la validation

Un déclencheur n8n sur parcel.approved : vous êtes prévenu, et la facture part avec le code du colis en référence.

Le problème

Le client valide un mardi soir, vous le voyez le jeudi, la facture part la semaine suivante. Entre les deux, rien ne relie la validation à ce que vous facturez.

La démarche

1. Le nœud. Installez n8n-nodes-colis depuis l’écran Community nodes de n8n, voir Webhooks & n8n.

2. Le déclencheur. Un Colis Trigger sur parcel.approved seulement, avec des identifiants Colis API qui portent le DROP_WEBHOOK_SECRET du déploiement. Copiez sa Production URL.

3. Le déploiement. Collez cette adresse dans DROP_WEBHOOK_URL, le même secret dans DROP_WEBHOOK_SECRET, redéployez, puis activez le workflow.

4. Le workflow. En parallèle, après le déclencheur :

  • un message Slack ou un Send Email : « {{ $json.data.filename }} a été validé le {{ $json.data.decidedAt }} », avec {{ $json.data.url }} ;
  • le nœud de facturation que vous utilisez, avec {{ $json.data.code }} en référence, pour rapprocher la facture du colis plus tard.

Ajoutez parcel.changes_requested au déclencheur et un nœud If sur {{ $json.type }} pour vous renvoyer plutôt le commentaire du client, {{ $json.data.comment }}.

À surveiller

  • Le déploiement ne s’abonne pas tout seul. La page de livraison n’a pas d’API d’abonnement : l’adresse du déclencheur va dans DROP_WEBHOOK_URL, et un changement demande un redéploiement.
  • Dédupliquez sur webhook-id. Un événement est tenté trois fois au plus, et une nouvelle tentative porte le même identifiant.
  • Un récepteur en panne rate l’événement. Rien n’est rejoué après la troisième tentative. colis statut ou l’opération Get Status du nœud Colis restent là pour vérifier.

Sur cette page