Événements de commande : nouvelle commande, changement de statut, paiement, numéro de suivi, annulation d'un produit et avoir. Les paramètres de la requête, le choix de la notification et la forme de la réponse sont les mêmes pour tous et sont décrits dans la [vue d'ensemble de l'E-shop API](https://www.bulkgate.com/fr/documentation/eshop-api/eshop-api-vue-d-ensemble/).

## API URL

| ENDPOINT                                                         | ÉVÉNEMENT DE NOTIFICATION                            |
|:-----------------------------------------------------------------|:-----------------------------------------------------|
| `https://portal.bulkgate.com/api/1.0/eshop/order/new`            | `order_new`                                          |
| `https://portal.bulkgate.com/api/1.0/eshop/order/change-status`  | `order_status_change_<order_status_id>`              |
| `https://portal.bulkgate.com/api/1.0/eshop/order/payment`        | `order_payment_complete`, `order_payment_confirmation` |
| `https://portal.bulkgate.com/api/1.0/eshop/order/tracking-number`| `order_tracking_number`                              |
| `https://portal.bulkgate.com/api/1.0/eshop/order/product-cancel` | `order_product_cancel`                               |
| `https://portal.bulkgate.com/api/1.0/eshop/order/slip-add`       | `order_slip_add`                                     |

> [!NOTE]
> Si la requête n'atteint pas sa destination, renvoyez-la sur le [serveur de secours](https://www.bulkgate.com/fr/documentation/administration-api-et-tokens/serveur-de-secours/) `backup1.bulkgate.com`.

## Méthodes HTTP prises en charge

- `POST` - `application/json`

```http
POST /api/1.0/eshop/order/new HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
```

## Nouvelle commande

`eshop/order/new` déclenche la notification de l'événement `order_new`. Envoyez-la au moment où le client finalise sa commande.

```http-json
POST /api/1.0/eshop/order/new HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "language": "fr",
  "shop_id": "0",
  "variables": {
    "order_id": "10045",
    "order_total_paid": "49,90",
    "order_currency": "EUR",
    "order_payment": "Paiement à la livraison",
    "customer_firstname": "Jean",
    "customer_lastname": "Dupont",
    "customer_email": "jean.dupont@example.com",
    "customer_mobile": "777777777",
    "customer_country_id": "cz"
  }
}
```

## Changement de statut de la commande

`eshop/order/change-status` recherche la notification correspondant à un statut précis. Le nom de l'événement est composé de `order_status_change_` et de la valeur de la variable `order_status_id` ; envoyez donc toujours `order_status_id` — sans elle, le portail n'associe la notification à aucun statut. Les statuts pour lesquels une notification peut être configurée sont envoyés par votre boutique via la [configuration](https://www.bulkgate.com/fr/documentation/eshop-api/eshop-api-configuration/).

```http-json
POST /api/1.0/eshop/order/change-status HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "language": "fr",
  "variables": {
    "order_id": "10045",
    "order_status_id": "completed",
    "order_status": "Terminée",
    "customer_mobile": "777777777",
    "customer_country_id": "cz"
  }
}
```

La requête ci-dessus utilise la notification configurée pour l'événement `order_status_change_completed`.

## Paiement de la commande

`eshop/order/payment` recherche d'abord la notification `order_payment_complete` et, si elle n'est pas configurée, utilise `order_payment_confirmation`. Les notifications client et administrateur sont choisies séparément — le client peut ainsi recevoir `order_payment_complete` et les administrateurs `order_payment_confirmation`.

## Numéro de suivi

`eshop/order/tracking-number` déclenche la notification `order_tracking_number`. Transmettez le numéro de suivi et le transporteur dans les variables, p. ex. `order_carrier_tracking_number`, `order_carrier_name` et `order_carrier_url`.

```http-json
POST /api/1.0/eshop/order/tracking-number HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "language": "fr",
  "variables": {
    "order_id": "10045",
    "order_carrier_name": "Colissimo",
    "order_carrier_tracking_number": "Z1234567890",
    "customer_mobile": "777777777",
    "customer_country_id": "cz"
  }
}
```

## Annulation d'un produit et avoir

- `eshop/order/product-cancel` déclenche la notification `order_product_cancel` — un produit a été annulé dans la commande.
- `eshop/order/slip-add` déclenche la notification `order_slip_add` — un avoir a été émis pour la commande.

## Réponse

```json
{
    "data": {
        "customer": [
            {
                "status": "accepted",
                "message_id": "tmpde1bcd4b1d1",
                "part_id": ["tmpde1bcd4b1d1"],
                "number": "420777777777",
                "channel": "sms"
            }
        ]
    }
}
```

La signification des clés `customer` et `admin`, les erreurs d'envoi et les types d'erreurs sont décrits dans la [vue d'ensemble de l'E-shop API](https://www.bulkgate.com/fr/documentation/eshop-api/eshop-api-vue-d-ensemble/).
