Pour créer une commande, vous devrez au préalable :

  1. Identifier le contact qui prend la commande

  2. Identifier chaque conditionnement commandé.

Une fois que vous avez des informations, une commande minimale ressemblera à ceci :

POST /api/v1/orders

{

  "externalId": "mon-id-interne",

  "externalReference": "mon-numéro-de-commande",

  "contact": {

    "id": XXX,

    "externalReference": "la-reference-contact",

    "firstName": "Jean",

    "lastName": "Martin",

    "email": "jean.martin@hoteldela.gare"

  },

  "customer": {

    "name": Hôtel de la gare"

  },

  "invoicingAddress": {

    "recipient": "Hôtel de la gare",

    "street": "5, place de la gare",

    "zipCode": "12345",

    "city": "Trainville",

    "country": "FR"

  },

  "deliveryAddress": {

    "recipient": "Hôtel de la gare",

    "street": "5, place de la gare",

    "zipCode": "12345",

    "city": "Trainville",

    "country": "FR"

  },

  "items": [

    {

      "packaging": XXX,

      "externalReference": "la-reference-conditionnement",

      "orderedQuantity": 5

    }

  ]

}

Selon le cas, vous passerez :

  • Soit contact.id si vous avez accès à GET /api/v1/contacts

  • Soit contact.externalReference si vous êtes un partenaire de prise de commande et que vous récupérez GET /api/v1/contact_references.

Voir la documentation correspondante

Selon le cas, vous passerez dans un item :

  • Soit packaging si vous avez accès à GET /api/v1/packagings

  • Soit externalReference si vous êtes un partenaire de prise de commande et que vous récupérez GET /api/v1/packaging_references.

Voir la documentation correspondante