Url de rappel des réservations (webhook)

Numéro de l’article2414
Dernière modification10 juin 2021

Cette article est pour les développeurs qui désire automatisé certaines tâches lorsqu’un réservation est faite ou modifier (example module externe de livraison).

Configuration

Dans les configuration section « Programmation », ajouter le Url complet de votre serveur:

Comelin fera un http POST avec le JSON de la réservation à chaque modification.

La propriété ‘Status’ est un chiffre:

2 = en cours (l’entreprise n’a pas encore terminée la réservation)
4 = complété (l’entreprise à facturée la réservation)
8= effacé (l’entreprise a manuellement effacée la réservation, souvent une annulation)

La propritée ‘ShippingMode’ est un string avec les valeurs suivantes:

‘InStorePickup’ : le client récupère en magasin
‘DropLocation’: le client récupère le colis à un point de chute, le nom du point des chutes dans la propriété ‘ShippingText’
‘ShipByMail’ : les colis est envoyé par la poste.
‘ShipByCarrier’ le colis est envoyé par le transporteur du client
‘LocalDelivery’ le colis est expédier via la livraison locale.

Le champs de texte ‘ShippingText’ peut-être affiché et lu, mais le contenue du texte peut-être en anglais ou français selon la langue du client; donc pas l’idéale pour des logiques de programmation.

Si la propriété ‘ShippingAddress’ n’est pas dans le JSON c’est parce que la réservation n’est pas livré.

Exemple de JSON envoyé:

{
  "Id": "C1703",
  "Status": 4,
  "CustomerName": "Beatrice Langlois",
  "BillingAddress": {
    "Street1": "310 rue Poirier",
    "Locality": "Montréal",
    "Region": "Québec",
    "RegionCode": "QC",
    "Country": "Canada",
    "CountryCode": "CA",
    "PostalCode": "H3R 7L3"
  },
  "ShippingAddress": {
    "Street1": "310 rue Poirier",
    "Locality": "Montréal",
    "Region": "Québec",
    "RegionCode": "QC",
    "Country": "Canada",
    "CountryCode": "CA",
    "PostalCode": "H3R 7L3"
  },
  "ShippingMode": "LocalDelivery",
  "ShippingText": "Livraison locale",
  "ShippingFee": 5,
  "Tax1": 6.45,
  "Tax2": 12.87,
  "Total": 148.32,
  "Lines": [
    {
      "Title": "Produit super cool",
      "Quantity": 1.0,
      "UnitPrice": 129.0,
      "UnitDiscount": 0.0,
      "SubTotal": 129.0
    }
  ],
    "Notes": [
 {
      "Date": "2021-06-16T15:14:23.7934Z",
      "Employee": "Julie",
      "Note": "Est-ce vous pouvez liver le produit par la porte de côté?",
      "IsCustomer": true
    },
    {
      "Date": "2021-06-10T15:14:23.7934Z",
      "Employee": "Julie",
      "Note": "oui certainement.",
      "IsCustomer": false
    }
  ]
}
10 juin 2021