Utiliser les points retrait

Ce guide présente les détails des commandes livrées en point retrait, explique en quoi elles diffèrent des commandes livrées à domicile, et détaille les informations spécifiques à ces commandes devant être traitées.

Détails de la commande

La méthode orders.list ou orders.get renvoie des informations sur la commande. Par exemple, l'URL permettant d'appeler Orders.list serait :

GET https://www.googleapis.com/content/v2.1/{merchantId}/orders

Vous trouverez ci-dessous un exemple de réponse JSON indiquant les détails d'une commande livrée en point retrait.

Champs à noter

Champ Description
shippingDetails.type Type de livraison : delivery pour les commandes livrées à domicile ou pickup pour les commandes livrées en point retrait.
shippingDetails.carrier Transporteur utilisé pour la commande livrée en point retrait.
pickupDetails.collectors Nom(s) et numéro(s) de téléphone de la ou des personnes autorisées à récupérer le colis au point retrait. Ils sont fournis par le client au moment de la commande.
pickupDetails.locationId ID d'emplacement du point retrait, tel que spécifié par le fournisseur du point retrait.
pickupDetails.address Adresse du point retrait. Pour les commandes livrées en point retrait, le nom du destinataire correspond au nom de l'entreprise qui héberge le point retrait.

Exemple de réponse

"kind": "content#order",
"id": "foo",
"merchantId": 123,
"merchantOrderId": "bar",
"customer": {
  "fullName": "John Doe"
},
"lineItems": [
  {
    "id": "sample_line_item_1",
    "shippingDetails": {
      "method": {
        "type": "pickup",
        "methodName": "Standard",
        "carrier": "Colissimo",
        "minDaysInTransit": 1,
        "maxDaysInTransit": 2
      },
      "shipByDate": 2019-01-01,
      "deliverByDate": 2019-01-03
    }
  }
],
"pickupDetails": {
  "collectors": [
    {
      "name": Jane Doe,
      "phoneNumber": +XX XX XXX XX XX
    }
  ],
  "locationId": qwerty,
  "address": {
    "recipientName": "Pickup Point Name",
    "streetAddress": ["8 Rue de Londres"],
    "locality": "Paris",
    "region": "Ile-de-France",
    "country": "France",
    "postalCode": "75009",
    "isPostOfficeBox": false,
    "fullAddress": [
      "Pickup Point Name",
      "8 Rue de Londres",
      "75009 Paris",
      "France"
  }
},

Mettre à jour l'état de livraison d'une commande à livrer en point retrait

Vous pouvez mettre à jour l'état des commandes livrées en point retrait en utilisant les mêmes méthodes que pour les commandes livrées à domicile : shiplineitems et updateshipment. Pour plus d'informations, consultez le guide Utiliser Orders API.

Lorsque vous traitez des commandes livrées en point retrait, gardez à l'esprit les points suivants :

  • Assurez-vous que les paramètres trackingID et carrier sont correctement définis pour la livraison. La valeur de trackingID doit être la valeur fournie par le transporteur utilisé pour la commande livrée en point retrait.
  • Nous faisons passer l'état de la livraison à readyForPickup une fois la commande livrée au point retrait. Cet état est renvoyé lors de l'appel de orders.list ou de orders.get.
  • Une fois que le client a retiré l'article, nous faison passer l'état de la livraison à delivered. Cet état est renvoyé lors de l'appel de order.list ou de orders.get.