> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/import-conversions/api-conversions-and-product-catalog.md).
# API Conversions et catalogue de produits
Cette API est exclusivement dédiée à l'envoi des conversions et des produits vers le CDP de Commanders Act. Si vous souhaitez envoyer des événements d'achat server-side, consultez la [source API de tracking HTTP](https://doc.commandersact.com/features/sources/sources-catalog/server/http-tracking-api) page.
## Commanders Act Data API v2.0.0
> Faites défiler vers le bas pour consulter les exemples de code, les requêtes d'exemple et les réponses. Sélectionnez une langue pour les exemples de code depuis les onglets ci-dessus ou le menu de navigation mobile.
Il est fortement recommandé d'envoyer plusieurs objets dans une seule requête HTTP. Cette API permet le streaming au format JSON séparé par des retours à la ligne ou ndjson ()
### Limites de débit
* Vous pouvez envoyer jusqu'à 30 requêtes par seconde
* Vous pouvez avoir jusqu'à 30 connexions simultanées
* Si vous envoyez de nombreuses conversions/produits/etc. en lot, la vitesse de téléversement sera limitée à 30 conversions/produits/etc. par seconde
#### Exemples de limitation de débit
* Si vous envoyez 1 conversion par requête, vous serez limité à 30 requêtes par seconde
* Si vous envoyez 90 conversions dans une seule requête, votre téléversement sera terminé en environ 3 secondes
* Si vous envoyez 40 requêtes, chacune avec une conversion dans la même seconde, 30 d'entre elles seront traitées et 10 seront rejetées
* Si vous envoyez 3 requêtes, chacune avec 100 conversions, elles seront terminées en 10 secondes
### Limitations
* Vous pouvez envoyer jusqu'à 150 éléments de conversion
### Formats de date
Utilisez le format long avec fuseau horaire pour transmettre des dates ISO-8601. Les formats suivants sont acceptés :
* "2019-04-29T13:47:47.315Z"
* "2019-04-29T13:47:47Z"
* "2019-04-29T13:47:47.315+02:00"
* "2019-04-29T13:47:47+02:00"
### Erreurs
Les erreurs sont toujours renvoyées sous forme de tableau d'objets dans la propriété de premier niveau "errors".
#### Erreurs dans les opérations en lot
Pour les opérations en lot, vous pouvez avoir les propriétés "errors" et "data" en même temps, car certains objets peuvent avoir des erreurs tandis que d'autres non. Les erreurs de lot sont agrégées, ce qui signifie qu'il n'y aura pas une erreur pour chaque occurrence d'une erreur, mais une erreur par type d'erreur avec le nombre d'occurrences et quelques exemples de numéros de ligne ou d'ID.
```
{
"errors": [
{
"code": "YOU_CAN_CHECK_THIS_IN_CODE",
"detail": "Cela explique l'erreur",
"meta": {
"context_property_example": "value_example",
"error_count": 3,
"line_numbers": [34, 45],
"ids": [
"c9017b85-8016-4f13-88b4-18d57c67b866",
"12e0c3cb-7e8d-462f-9232-f7c61a900738"
]
}
}
]
"data": {
"accepted_object_count": 4,
"rejected_object_count": 3
}
}
```
#### Objet d'erreur
Les objets d'erreur ont les propriétés suivantes
| Propriété | Type | Obligatoire | Description |
| --------- | ------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | string | true | Toujours présent et contient un code d'erreur qui peut être vérifié par programme |
| detail | string | true | Message lisible par un humain qui explique le problème. Vous ne devez pas vérifier la valeur de cette propriété par programme, car elle peut changer |
| meta | object | false | Objet spécifique à l'erreur qui contient des détails sur ce qui a généré l'erreur |
URL de base :
* [https://api.commander1.com/v2/{siteId}](https://api.commander1.com/v2/%7BsiteId%7D)
## Authentification
* Authentification HTTP, schéma : bearer. Le token sera fourni par notre équipe support/consulting
## Par défaut
### Créer ou mettre à jour les conversions
> Exemples de code
```
POST https://api.commander1.com/v2/{siteId}/conversions/bulk HTTP/1.1
Host: api.commander1.com
Content-Type: application/x-ndjson
Accept: application/json
Authorization: Bearer NJtcKaoCYu...mGZDxRgMBMUw==
```
`POST /conversions/bulk`
Ce point de terminaison crée et met à jour des conversions. Votre requête sera traitée de manière asynchrone. Le traitement de la requête et les mises à jour de la base de données peuvent prendre jusqu'à 1 heure.
> Paramètre du corps
```
{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","user":{"user_email":"user@example.com"},"type":"offline","status":"in_progress","created":"2018-01-01T20:00:00.000+01:00","updated":"2018-01-01T20:00:00.000+01:00","acknowledged":true,"currency":"EUR","comment":"Le colis doit être inférieur à 30 cm sur 30 cm","billing_address":{"country":"France","iso_country_code":"FR","country_code":"FRA","region":"Ile-de-France","locality":"Paris","postal_code":"75009","recipient":"Commanders Act","street_address":"3-5 Rue Saint-Georges","full_address":null,"label":"home","coordinates":{"latitude":48.857764,"longitude":2.33935}},"contact_address":{"country":"France","iso_country_code":"FR","country_code":"FRA","region":"Ile-de-France","locality":"Paris","postal_code":"75009","recipient":"Commanders Act","street_address":"3-5 Rue Saint-Georges","full_address":null,"label":"home","coordinates":{"latitude":48.857764,"longitude":2.33935}},"shipping_address":{"country":"France","iso_country_code":"FR","country_code":"FRA","region":"Ile-de-France","locality":"Paris","postal_code":"75009","recipient":"Commanders Act","street_address":"3-5 Rue Saint-Georges","full_address":null,"label":"home","coordinates":{"latitude":48.857764,"longitude":2.33935}},"shipping_provider":"UPS","shipping_tracking_code":"702c7a16-2c3d-4946-bb35-69ba540773f6","payment_method":"card","original_quantity":3,"cancelled_quantity":1,"returned_quantity":1,"exchanged_quantity":0,"final_quantity":1,"original_amount":30,"cancelled_amount":10,"returned_amount":10,"exchanged_amount":0,"shipping_amount":0,"discount_amount":0,"tax_amount":5,"final_amount":10,"custom":{"internal_reference":"fa34dc2","referer":"user@example.com","website_version":"2.4"},"conversion_items":[{"id":"68cd1310-4b7a-454c-99fb-2510f0e156ec","original_quantity":3,"cancelled_quantity":1,"returned_quantity":1,"exchanged_quantity":0,"final_quantity":1,"original_amount":30,"cancelled_amount":10,"returned_amount":10,"exchanged_amount":0,"final_amount":10,"price":10,"original_item":true,"custom":{"remarketing_campaign":"christmas_2018","time_to_checkout":"25 minutes","ab_testing_group":"3245fcda"},"product":{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson","category_1":"Maison","category_2":"Cuisine","category_3":"Accessoires","category_4":"Contenants","category_5":"Mugs","tags":["mugs","anse","blanc","marque"],"condition":"new","availability":"in_stock","availability_date":"2019-02-06T17:41:31.427+01:00","expiration_date":"2019-02-06T17:41:31.427+01:00","price":10,"sale_price":8,"currency":"EUR","image_link":"https://commandersact.com/images/shopping/mug_hi_res.jpg","link":"https://commandersact.com/shopping/mug","brand":"Commanders Act","width":6.4,"length":7.3,"height":9.5,"weight":80.7,"size":"medium","colors":["white","red"],"gtin":"134588842456789000","mpn":"134588842","custom":{"internal_category_id":721,"warehouse":"building B","box_barcode":1830135586179}}},{"id":"68cd1310-4b7a-454c-99fb-2510f0e156ec","original_quantity":3,"cancelled_quantity":1,"returned_quantity":1,"exchanged_quantity":0,"final_quantity":1,"original_amount":30,"cancelled_amount":10,"returned_amount":10,"exchanged_amount":0,"final_amount":10,"price":10,"original_item":true,"custom":{"remarketing_campaign":"christmas_2018","time_to_checkout":"25 minutes","ab_testing_group":"3245fcda"},"product":{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson","category_1":"Maison","category_2":"Cuisine","category_3":"Accessoires","category_4":"Contenants","category_5":"Mugs","tags":["mugs","anse","blanc","marque"],"condition":"new","availability":"in_stock","availability_date":"2019-02-06T17:41:31.427+01:00","expiration_date":"2019-02-06T17:41:31.427+01:00","price":10,"sale_price":8,"currency":"EUR","image_link":"https://commandersact.com/images/shopping/mug_hi_res.jpg","link":"https://commandersact.com/shopping/mug","brand":"Commanders Act","width":6.4,"length":7.3,"height":9.5,"weight":80.7,"size":"medium","colors":["white","red"],"gtin":"134588842456789000","mpn":"134588842","custom":{"internal_category_id":721,"warehouse":"building B","box_barcode":1830135586179}}}]}
{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","user":{"user_email":"user@example.com"},"type":"offline","status":"in_progress","created":"2018-01-01T20:00:00.000+01:00","updated":"2018-01-01T20:00:00.000+01:00","acknowledged":true,"currency":"EUR","comment":"Le colis doit être inférieur à 30 cm sur 30 cm","billing_address":{"country":"France","iso_country_code":"FR","country_code":"FRA","region":"Ile-de-France","locality":"Paris","postal_code":"75009","recipient":"Commanders Act","street_address":"3-5 Rue Saint-Georges","full_address":null,"label":"home","coordinates":{"latitude":48.857764,"longitude":2.33935}},"contact_address":{"country":"France","iso_country_code":"FR","country_code":"FRA","region":"Ile-de-France","locality":"Paris","postal_code":"75009","recipient":"Commanders Act","street_address":"3-5 Rue Saint-Georges","full_address":null,"label":"home","coordinates":{"latitude":48.857764,"longitude":2.33935}},"shipping_address":{"country":"France","iso_country_code":"FR","country_code":"FRA","region":"Ile-de-France","locality":"Paris","postal_code":"75009","recipient":"Commanders Act","street_address":"3-5 Rue Saint-Georges","full_address":null,"label":"home","coordinates":{"latitude":48.857764,"longitude":2.33935}},"shipping_provider":"UPS","shipping_tracking_code":"702c7a16-2c3d-4946-bb35-69ba540773f6","payment_method":"card","original_quantity":3,"cancelled_quantity":1,"returned_quantity":1,"exchanged_quantity":0,"final_quantity":1,"original_amount":30,"cancelled_amount":10,"returned_amount":10,"exchanged_amount":0,"shipping_amount":0,"discount_amount":0,"tax_amount":5,"final_amount":10,"custom":{"internal_reference":"fa34dc2","referer":"user@example.com","website_version":"2.4"},"conversion_items":[{"id":"68cd1310-4b7a-454c-99fb-2510f0e156ec","original_quantity":3,"cancelled_quantity":1,"returned_quantity":1,"exchanged_quantity":0,"final_quantity":1,"original_amount":30,"cancelled_amount":10,"returned_amount":10,"exchanged_amount":0,"final_amount":10,"price":10,"original_item":true,"custom":{"remarketing_campaign":"christmas_2018","time_to_checkout":"25 minutes","ab_testing_group":"3245fcda"},"product":{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson","category_1":"Maison","category_2":"Cuisine","category_3":"Accessoires","category_4":"Contenants","category_5":"Mugs","tags":["mugs","anse","blanc","marque"],"condition":"new","availability":"in_stock","availability_date":"2019-02-06T17:41:31.427+01:00","expiration_date":"2019-02-06T17:41:31.427+01:00","price":10,"sale_price":8,"currency":"EUR","image_link":"https://commandersact.com/images/shopping/mug_hi_res.jpg","link":"https://commandersact.com/shopping/mug","brand":"Commanders Act","width":6.4,"length":7.3,"height":9.5,"weight":80.7,"size":"medium","colors":["white","red"],"gtin":"134588842456789000","mpn":"134588842","custom":{"internal_category_id":721,"warehouse":"building B","box_barcode":1830135586179}}},{"id":"68cd1310-4b7a-454c-99fb-2510f0e156ec","original_quantity":3,"cancelled_quantity":1,"returned_quantity":1,"exchanged_quantity":0,"final_quantity":1,"original_amount":30,"cancelled_amount":10,"returned_amount":10,"exchanged_amount":0,"final_amount":10,"price":10,"original_item":true,"custom":{"remarketing_campaign":"christmas_2018","time_to_checkout":"25 minutes","ab_testing_group":"3245fcda"},"product":{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson","category_1":"Maison","category_2":"Cuisine","category_3":"Accessoires","category_4":"Contenants","category_5":"Mugs","tags":["mugs","anse","blanc","marque"],"condition":"new","availability":"in_stock","availability_date":"2019-02-06T17:41:31.427+01:00","expiration_date":"2019-02-06T17:41:31.427+01:00","price":10,"sale_price":8,"currency":"EUR","image_link":"https://commandersact.com/images/shopping/mug_hi_res.jpg","link":"https://commandersact.com/shopping/mug","brand":"Commanders Act","width":6.4,"length":7.3,"height":9.5,"weight":80.7,"size":"medium","colors":["white","red"],"gtin":"134588842456789000","mpn":"134588842","custom":{"internal_category_id":721,"warehouse":"building B","box_barcode":1830135586179}}}]}
{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","user":{"user_email":"user@example.com"},"type":"offline","status":"in_progress","created":"2018-01-01T20:00:00.000+01:00","updated":"2018-01-01T20:00:00.000+01:00","acknowledged":true,"currency":"EUR","comment":"Le colis doit être inférieur à 30 cm sur 30 cm","billing_address":{"country":"France","iso_country_code":"FR","country_code":"FRA","region":"Ile-de-France","locality":"Paris","postal_code":"75009","recipient":"Commanders Act","street_address":"3-5 Rue Saint-Georges","full_address":null,"label":"home","coordinates":{"latitude":48.857764,"longitude":2.33935}},"contact_address":{"country":"France","iso_country_code":"FR","country_code":"FRA","region":"Ile-de-France","locality":"Paris","postal_code":"75009","recipient":"Commanders Act","street_address":"3-5 Rue Saint-Georges","full_address":null,"label":"home","coordinates":{"latitude":48.857764,"longitude":2.33935}},"shipping_address":{"country":"France","iso_country_code":"FR","country_code":"FRA","region":"Ile-de-France","locality":"Paris","postal_code":"75009","recipient":"Commanders Act","street_address":"3-5 Rue Saint-Georges","full_address":null,"label":"home","coordinates":{"latitude":48.857764,"longitude":2.33935}},"shipping_provider":"UPS","shipping_tracking_code":"702c7a16-2c3d-4946-bb35-69ba540773f6","payment_method":"card","original_quantity":3,"cancelled_quantity":1,"returned_quantity":1,"exchanged_quantity":0,"final_quantity":1,"original_amount":30,"cancelled_amount":10,"returned_amount":10,"exchanged_amount":0,"shipping_amount":0,"discount_amount":0,"tax_amount":5,"final_amount":10,"custom":{"internal_reference":"fa34dc2","referer":"user@example.com","website_version":"2.4"},"conversion_items":[{"id":"68cd1310-4b7a-454c-99fb-2510f0e156ec","original_quantity":3,"cancelled_quantity":1,"returned_quantity":1,"exchanged_quantity":0,"final_quantity":1,"original_amount":30,"cancelled_amount":10,"returned_amount":10,"exchanged_amount":0,"final_amount":10,"price":10,"original_item":true,"custom":{"remarketing_campaign":"christmas_2018","time_to_checkout":"25 minutes","ab_testing_group":"3245fcda"},"product":{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson","category_1":"Maison","category_2":"Cuisine","category_3":"Accessoires","category_4":"Contenants","category_5":"Mugs","tags":["mugs","anse","blanc","marque"],"condition":"new","availability":"in_stock","availability_date":"2019-02-06T17:41:31.427+01:00","expiration_date":"2019-02-06T17:41:31.427+01:00","price":10,"sale_price":8,"currency":"EUR","image_link":"https://commandersact.com/images/shopping/mug_hi_res.jpg","link":"https://commandersact.com/shopping/mug","brand":"Commanders Act","width":6.4,"length":7.3,"height":9.5,"weight":80.7,"size":"medium","colors":["white","red"],"gtin":"134588842456789000","mpn":"134588842","custom":{"internal_category_id":721,"warehouse":"building B","box_barcode":1830135586179}}},{"id":"68cd1310-4b7a-454c-99fb-2510f0e156ec","original_quantity":3,"cancelled_quantity":1,"returned_quantity":1,"exchanged_quantity":0,"final_quantity":1,"original_amount":30,"cancelled_amount":10,"returned_amount":10,"exchanged_amount":0,"final_amount":10,"price":10,"original_item":true,"custom":{"remarketing_campaign":"christmas_2018","time_to_checkout":"25 minutes","ab_testing_group":"3245fcda"},"product":{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson","category_1":"Maison","category_2":"Cuisine","category_3":"Accessoires","category_4":"Contenants","category_5":"Mugs","tags":["mugs","anse","blanc","marque"],"condition":"new","availability":"in_stock","availability_date":"2019-02-06T17:41:31.427+01:00","expiration_date":"2019-02-06T17:41:31.427+01:00","price":10,"sale_price":8,"currency":"EUR","image_link":"https://commandersact.com/images/shopping/mug_hi_res.jpg","link":"https://commandersact.com/shopping/mug","brand":"Commanders Act","width":6.4,"length":7.3,"height":9.5,"weight":80.7,"size":"medium","colors":["white","red"],"gtin":"134588842456789000","mpn":"134588842","custom":{"internal_category_id":721,"warehouse":"building B","box_barcode":1830135586179}}}]}
```
#### Paramètres
| Nom | Dans | Type | Obligatoire | Description |
| ------------- | ------ | ------------------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Authorization | header | string | true | Jeton d'autorisation |
| overwrite | query | boolean | false | Détermine si les conversions doivent être entièrement remplacées (`true`) ou partiellement mises à jour (`false` - par défaut). |
| body | body | [Conversion](#tocs_conversion) | true | Conversions sous forme de chaînes JSON délimitées par des retours à la ligne |
### Comportement du paramètre overwrite
Le `overwrite` paramètre url détermine comment les conversions sont traitées lorsqu'un `id` est trouvé :
* **`false`** *(par défaut)*:
* Seuls les champs spécifiés seront mis à jour.
* Les champs non spécifiés conserveront leurs valeurs existantes.
* **`true`**:
* La conversion existante sera **entièrement remplacée** par les nouvelles données fournies.
Si vous devez remplacer entièrement une conversion, définissez `overwrite=true`.
> Exemples de réponses
> Réponse 202
```
{
"data": {
"accepted_object_count": 4,
"rejected_object_count": 0
}
}
```
> 400 Impossible d'analyser la ligne nd-json
```
{
"errors": [
{
"code": "PARSE_ERROR",
"detail": "Impossible d'analyser nd-json"
}
],
"data": {}
}
```
> 400 Propriété requise manquante
```
{
"errors": [
{
"code": "MISSING_REQUIRED_PROPERTY",
"detail": "la propriété requise 'id' est manquante\n",
"meta": {
"line_numbers": [
34,
45
],
"error_count": 2,
"ids": [
"c9017b85-8016-4f13-88b4-18d57c67b866",
"12e0c3cb-7e8d-462f-9232-f7c61a900738"
]
}
}
],
"data": {
"accepted_object_count": 4,
"rejected_object_count": 2
}
}
```
> 400 Type de propriété invalide
```
{
"errors": [
{
"code": "INVALID_PROPERTY_TYPE",
"detail": "La propriété \"original_amount\" n'est pas un nombre",
"meta": {
"property": "original_amount",
"line_numbers": [
34,
45
],
"error_count": 2,
"ids": [
"c9017b85-8016-4f13-88b4-18d57c67b866",
"12e0c3cb-7e8d-462f-9232-f7c61a900738"
]
}
}
],
"data": {
"accepted_object_count": 4,
"rejected_object_count": 2
}
}
```
> 400 Format de propriété invalide
```
{
"errors": [
{
"code": "INVALID_PROPERTY_FORMAT",
"detail": "La propriété \"original_amount\" n'est pas un nombre",
"meta": {
"property": "original_amount",
"line_numbers": [
34,
45
],
"error_count": 2,
"ids": [
"c9017b85-8016-4f13-88b4-18d57c67b866",
"12e0c3cb-7e8d-462f-9232-f7c61a900738"
]
}
}
],
"data": {
"accepted_object_count": 4,
"rejected_object_count": 2
}
}
```
> 401 L'en-tête Authorization est manquant
```
{
"errors": [
{
"code": "MISSING_AUTHORIZATION_HEADER",
"detail": "L'en-tête \"Authorization\" est requis"
}
]
}
```
> 401 Le type de token est manquant
```
{
"errors": [
{
"code": "UNKNOWN_TOKEN_TYPE",
"detail": "Le type de token est manquant"
}
]
}
```
> 401 Le type de token est invalide
```
{
"errors": [
{
"code": "INVALID_TOKEN_TYPE",
"detail": "Le type de token \"Bear\" est invalide. Attendu : \"Bearer\" à la place"
}
]
}
```
> 401 Le token fourni est inconnu
```
{
"errors": [
{
"code": "UNKNOWN_TOKEN",
"detail": "Le token fourni est inconnu. Veuillez contacter notre équipe support support@commandersact.com"
}
]
}
```
> Réponse 403
```
{
"errors": [
{
"code": "SITE_ACCESS_FORBIDDEN",
"detail": "Vous n'avez pas accès à ce site"
}
]
}
```
> Trop de requêtes
```
{
"description": "Vous avez trop de connexions ouvertes",
"errors": [
{
"code": "CONNECTION_LIMIT_REACHED",
"detail": "Votre compte est limité à 30 connexions simultanées"
}
]
}
```
```
{
"description": "Vous avez atteint la limite de requêtes",
"errors": [
{
"code": "REQUEST_LIMIT_REACHED",
"detail": "Votre compte est limité à 30 requêtes par seconde"
}
]
}
```
> Réponse 500
```
{
"errors": [
{
"code": "SERVER_ERROR",
"detail": "Une erreur interne s'est produite. Veuillez contacter notre équipe support support@commandersact.com"
}
]
}
```
#### Réponses
| Statut | Signification | Description | Schéma |
| ------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | ------ |
| 202 | [Accepté](https://tools.ietf.org/html/rfc7231#section-6.3.3) | Tous les objets sont acceptés pour le traitement | Aucun |
| 400 | [Requête incorrecte](https://tools.ietf.org/html/rfc7231#section-6.5.1) | Impossible de traiter la requête ou une partie de la requête en raison d'une erreur client | Aucun |
| 401 | [Non autorisé](https://tools.ietf.org/html/rfc7235#section-3.1) | Impossible d'identifier l'appelant de l'API | Aucun |
| 403 | [Interdit](https://tools.ietf.org/html/rfc7231#section-6.5.3) | L'appelant de l'API n'a pas accès à cette ressource | Aucun |
| 429 | [Trop de requêtes](https://tools.ietf.org/html/rfc6585#section-4) | Trop de requêtes | Aucun |
| 500 | [Erreur interne du serveur](https://tools.ietf.org/html/rfc7231#section-6.6.1) | Erreur interne du serveur | Aucun |
#### Schéma de réponse
### Créer ou mettre à jour les produits
> Exemples de code
```
POST https://api.commander1.com/v2/{siteId}/products/bulk HTTP/1.1
Host: api.commander1.com
Content-Type: application/x-ndjson
Authorization: Bearer NJtcKaoCYu...mGZDxRgMBMUw==
```
`POST /products/bulk`
Ce point de terminaison crée et met à jour des produits. Votre requête sera traitée de manière asynchrone. Le traitement de la requête et les mises à jour de la base de données peuvent prendre jusqu'à 24 heures.
> Paramètre du corps
```
{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson","category_1":"Maison","category_2":"Cuisine","category_3":"Accessoires","category_4":"Contenants","category_5":"Mugs","tags":["mugs","anse","blanc","marque"],"condition":"new","availability":"in_stock","availability_date":"2019-02-06T17:41:31.427+01:00","expiration_date":"2019-02-06T17:41:31.427+01:00","price":10,"sale_price":8,"currency":"EUR","image_link":"https://commandersact.com/images/shopping/mug_hi_res.jpg","link":"https://commandersact.com/shopping/mug","brand":"Commanders Act","width":6.4,"length":7.3,"height":9.5,"weight":80.7,"size":"medium","colors":["white","red"],"gtin":"134588842456789000","mpn":"134588842","custom":{"internal_category_id":721,"warehouse":"building B","box_barcode":1830135586179}}
{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson","category_1":"Maison","category_2":"Cuisine","category_3":"Accessoires","category_4":"Contenants","category_5":"Mugs","tags":["mugs","anse","blanc","marque"],"condition":"new","availability":"in_stock","availability_date":"2019-02-06T17:41:31.427+01:00","expiration_date":"2019-02-06T17:41:31.427+01:00","price":10,"sale_price":8,"currency":"EUR","image_link":"https://commandersact.com/images/shopping/mug_hi_res.jpg","link":"https://commandersact.com/shopping/mug","brand":"Commanders Act","width":6.4,"length":7.3,"height":9.5,"weight":80.7,"size":"medium","colors":["white","red"],"gtin":"134588842456789000","mpn":"134588842","custom":{"internal_category_id":721,"warehouse":"building B","box_barcode":1830135586179}}
{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson","category_1":"Maison","category_2":"Cuisine","category_3":"Accessoires","category_4":"Contenants","category_5":"Mugs","tags":["mugs","anse","blanc","marque"],"condition":"new","availability":"in_stock","availability_date":"2019-02-06T17:41:31.427+01:00","expiration_date":"2019-02-06T17:41:31.427+01:00","price":10,"sale_price":8,"currency":"EUR","image_link":"https://commandersact.com/images/shopping/mug_hi_res.jpg","link":"https://commandersact.com/shopping/mug","brand":"Commanders Act","width":6.4,"length":7.3,"height":9.5,"weight":80.7,"size":"medium","colors":["white","red"],"gtin":"134588842456789000","mpn":"134588842","custom":{"internal_category_id":721,"warehouse":"building B","box_barcode":1830135586179}}
```
#### Paramètres
| Nom | Dans | Type | Obligatoire | Description |
| ------------- | ------ | ------------------------ | ----------- | ------------------------------------------------------------------------- |
| Authorization | header | string | true | Jeton d'autorisation |
| body | body | [Produit](#tocs_product) | true | Produits sous forme de chaînes JSON délimitées par des retours à la ligne |
#### Réponses
| Statut | Signification | Description | Schéma |
| ------ | -------------------------------------------------------------------------- | --------------- | ------ |
| 202 | [Accepté](https://tools.ietf.org/html/rfc7231#section-6.3.3) | Accepté | Aucun |
| 207 | [Multi-statuts](https://tools.ietf.org/html/rfc2518#section-10.2) | Multi-statuts | Aucun |
| 401 | [Non autorisé](https://tools.ietf.org/html/rfc7235#section-3.1) | Non autorisé | Aucun |
| 405 | [Méthode non autorisée](https://tools.ietf.org/html/rfc7231#section-6.5.5) | Entrée invalide | Aucun |
## Schémas
### Conversion
```
{
"id": "db050bb1-810d-4420-a6fb-c1ce472a4ca9",
"user": {
"email": "user@example.com",
"consent_categories": [1,3]
},
"type": "offline",
"status": "in_progress",
"created": "2018-01-01T20:00:00.000+01:00",
"updated": "2018-01-01T20:00:00.000+01:00",
"acknowledged": true,
"currency": "EUR",
"comment": "Le colis doit être inférieur à 30 cm sur 30 cm",
"billing_address": {
"country": "France",
"iso_country_code": "FR",
"country_code": "FRA",
"region": "Ile-de-France",
"locality": "Paris",
"postal_code": "75009",
"recipient": "Commanders Act",
"street_address": "3-5 Rue Saint-Georges",
"full_address": null,
"label": "home",
"coordinates": {
"latitude": 48.857764,
"longitude": 2.33935
}
},
"contact_address": {
"country": "France",
"iso_country_code": "FR",
"country_code": "FRA",
"region": "Ile-de-France",
"locality": "Paris",
"postal_code": "75009",
"recipient": "Commanders Act",
"street_address": "3-5 Rue Saint-Georges",
"full_address": null,
"label": "home",
"coordinates": {
"latitude": 48.857764,
"longitude": 2.33935
}
},
"shipping_address": {
"country": "France",
"iso_country_code": "FR",
"country_code": "FRA",
"region": "Ile-de-France",
"locality": "Paris",
"postal_code": "75009",
"recipient": "Commanders Act",
"street_address": "3-5 Rue Saint-Georges",
"full_address": null,
"label": "home",
"coordinates": {
"latitude": 48.857764,
"longitude": 2.33935
}
},
"shipping_provider": "UPS",
"shipping_tracking_code": "702c7a16-2c3d-4946-bb35-69ba540773f6",
"payment_method": "card",
"original_quantity": 3,
"cancelled_quantity": 1,
"returned_quantity": 1,
"exchanged_quantity": 0,
"final_quantity": 1,
"original_amount": 30,
"cancelled_amount": 10,
"returned_amount": 10,
"exchanged_amount": 0,
"shipping_amount": 0,
"discount_amount": 0,
"tax_amount": 5,
"final_amount": 10,
"custom": {
"internal_reference": "fa34dc2",
"referer": "user@example.com",
"website_version": "2.4"
},
"conversion_items": [
{
"id": "68cd1310-4b7a-454c-99fb-2510f0e156ec",
"original_quantity": 3,
"cancelled_quantity": 1,
"returned_quantity": 1,
"exchanged_quantity": 0,
"final_quantity": 1,
"original_amount": 30,
"cancelled_amount": 10,
"returned_amount": 10,
"exchanged_amount": 0,
"final_amount": 10,
"price": 10,
"original_item": true,
"custom": {
"remarketing_campaign": "christmas_2018",
"time_to_checkout": "25 minutes",
"ab_testing_group": "3245fcda"
},
"product": {
"id": "db050bb1-810d-4420-a6fb-c1ce472a4ca9",
"name": "Mug Commanders Act",
"description": "Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson",
"category_1": "Maison",
"category_2": "Cuisine",
"category_3": "Accessoires",
"category_4": "Contenants",
"category_5": "Mugs",
"tags": [
"mugs",
"anse",
"blanc",
"marque"
],
"condition": "new",
"availability": "in_stock",
"availability_date": "2019-02-06T17:41:31.427+01:00",
"expiration_date": "2019-02-06T17:41:31.427+01:00",
"price": 10,
"sale_price": 8,
"currency": "EUR",
"image_link": "https://commandersact.com/images/shopping/mug_hi_res.jpg",
"link": "https://commandersact.com/shopping/mug",
"brand": "Commanders Act",
"width": 6.4,
"length": 7.3,
"height": 9.5,
"weight": 80.7,
"size": "medium",
"colors": [
"blanc",
"rouge"
],
"gtin": "134588842456789000",
"mpn": "134588842",
"custom": {
"internal_category_id": 721,
"warehouse": "building B",
"box_barcode": 1830135586179
}
}
},
{
"id": "68cd1310-4b7a-454c-99fb-2510f0e156ec",
"original_quantity": 3,
"cancelled_quantity": 1,
"returned_quantity": 1,
"exchanged_quantity": 0,
"final_quantity": 1,
"original_amount": 30,
"cancelled_amount": 10,
"returned_amount": 10,
"exchanged_amount": 0,
"final_amount": 10,
"price": 10,
"original_item": true,
"custom": {
"remarketing_campaign": "christmas_2018",
"time_to_checkout": "25 minutes",
"ab_testing_group": "3245fcda"
},
"product": {
"id": "db050bb1-810d-4420-a6fb-c1ce472a4ca9",
"name": "Mug Commanders Act",
"description": "Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson",
"category_1": "Maison",
"category_2": "Cuisine",
"category_3": "Accessoires",
"category_4": "Contenants",
"category_5": "Mugs",
"tags": [
"mugs",
"anse",
"blanc",
"marque"
],
"condition": "new",
"availability": "in_stock",
"availability_date": "2019-02-06T17:41:31.427+01:00",
"expiration_date": "2019-02-06T17:41:31.427+01:00",
"price": 10,
"sale_price": 8,
"currency": "EUR",
"image_link": "https://commandersact.com/images/shopping/mug_hi_res.jpg",
"link": "https://commandersact.com/shopping/mug",
"brand": "Commanders Act",
"width": 6.4,
"length": 7.3,
"height": 9.5,
"weight": 80.7,
"size": "medium",
"colors": [
"blanc",
"rouge"
],
"gtin": "134588842456789000",
"mpn": "134588842",
"custom": {
"internal_category_id": 721,
"warehouse": "building B",
"box_barcode": 1830135586179
}
}
}
]
}
```
Il est recommandé d'utiliser autant de champs que possible afin de pouvoir construire de bons segments avec des conditions avancées
#### Propriétés
| Nom | Type | Obligatoire | Restrictions | Description |
| ------------------------- | ----------------------------------------- | ----------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id | string(1-50) | true | aucun | ID de conversion. Utilisé comme clé pour les mises à jour |
| user | object | true | aucun | Toutes les propriétés que vous ajoutez ici seront utilisées comme conditions pour faire correspondre les utilisateurs dans notre base de données. Vous devez vous assurer que les valeurs utilisées dans ces propriétés sont uniques. Utilisez les mêmes noms de propriétés que ceux définis dans l'interface des variables pour l'utilisateur. |
| » user.email | string(1-250) | false | aucun | E-mail de l'utilisateur |
| »user.consent\_categories | string | false | aucun | Catégories de consentement de l'utilisateur, pour être autorisé à partager des conversions avec des partenaires |
| type | string(1-250) | true | aucun | Type de conversion (online, offline, call, etc.) |
| status | string | true | aucun | Statut de votre conversion (voir la liste des valeurs possibles ci-dessous). Les conversions avec le statut "pending" ne sont pas incluses dans les sommes et compteurs agrégés par défaut sur un utilisateur. |
| created | string(ISO-8601) | true | aucun | Moment où la conversion a eu lieu. Voir la section « Formats de date » ci-dessus pour la liste des formats autorisés. |
| updated | string(ISO-8601) | false | aucun | Moment où la conversion a été mise à jour. Voir la section « Formats de date » ci-dessus pour la liste des formats autorisés. |
| acknowledged | boolean | false | aucun | À définir sur true si la conversion a été accusée réception |
| currency | string(ISO-4217) | true | aucun | Devise |
| comment | string(1-250) | false | aucun | Commentaire de l'acheteur |
| billing\_address | [Adresse](#tocs_address) | false | aucun | Il est recommandé d'utiliser autant de champs que possible afin de pouvoir construire de bons segments avec des conditions avancées |
| contact\_address | [Adresse](#tocs_address) | false | aucun | Il est recommandé d'utiliser autant de champs que possible afin de pouvoir construire de bons segments avec des conditions avancées |
| shipping\_address | [Adresse](#tocs_address) | false | aucun | Il est recommandé d'utiliser autant de champs que possible afin de pouvoir construire de bons segments avec des conditions avancées |
| shipping\_provider | string(1-250) | false | aucun | Transporteur |
| shipping\_tracking\_code | string(1-250) | false | aucun | Code de suivi d'expédition |
| payment\_method | string | false | aucun | Type de moyen de paiement (voir la liste des valeurs possibles ci-dessous) |
| payment\_provider | string | false | aucun | Prestataire de paiement utilisé pour cette transaction |
| quantite\_initiale | float | false | lecture seule | Somme de tous les articles dans la conversion d'origine (CALCULATED) |
| quantite\_annulee | float | false | lecture seule | Quantité des articles annulés dans la conversion (CALCULATED) |
| quantite\_retournee | float | false | lecture seule | Quantité des articles retournés dans la conversion (CALCULATED) |
| quantite\_echangee | float | false | lecture seule | Quantité des articles échangés dans la conversion (CALCULATED) |
| quantite\_finale | float | false | lecture seule | Quantité d'articles dans la transaction finale pour cette conversion (original\_quantity - cancelled\_quantity - returned\_quantity - exchanged\_quantity) (CALCULATED) |
| montant\_initial | float | false | écriture unique | Montant initial pour cette conversion (frais de livraison et taxes inclus) |
| montant\_annule | float | false | aucun | Montant annulé pour cette conversion |
| montant\_retourne | float | false | aucun | Montant retourné pour cette conversion |
| montant\_echange | float | false | aucun | Montant échangé pour cette conversion |
| frais\_de\_livraison | float | false | aucun | Montant des frais de livraison pour cette conversion |
| montant\_remise | float | false | aucun | Montant de remise pour cette conversion |
| montant\_taxe | float | false | aucun | Montant de taxe pour cette conversion |
| montant\_final | float | false | aucun | Montant final pour cette conversion après retours, échanges, annulations, etc. (frais de livraison et taxes inclus). Cela représente le montant global de la transaction entre l'acheteur et le vendeur |
| personnalisé | object | false | aucun | Objet contenant des propriétés personnalisées |
| articles\_de\_conversion | \[[ConversionItem](#tocs_conversionitem)] | true | aucun | Liste des produits dans la conversion + leurs propres attributs. Vous ne pouvez pas avoir le même produit deux fois dans une conversion, sauf si vous fournissez un ID d'article de conversion |
**Valeurs énumérées**
| Propriété | Valeur |
| --------------- | ------------------------------------ |
| status | annulé |
| status | livré |
| status | en\_cours |
| status | partiellement\_livré |
| status | partiellement\_retourné |
| status | partiellement\_expédié |
| status | expédition\_en\_attente |
| status | retourné |
| status | expédié |
| status | en\_attente |
| payment\_method | par\_virement\_bancaire\_à\_l'avance |
| payment\_method | par\_facture |
| payment\_method | carte |
| payment\_method | par\_chèque\_à\_l'avance |
| payment\_method | paiement\_à\_la\_livraison |
| payment\_method | coupon |
| payment\_method | prélèvement\_automatique |
| payment\_method | système\_de\_paiement\_en\_ligne |
| payment\_method | autre |
### ConversionItem
```
{
"id": "68cd1310-4b7a-454c-99fb-2510f0e156ec",
"original_quantity": 3,
"cancelled_quantity": 1,
"returned_quantity": 1,
"exchanged_quantity": 0,
"final_quantity": 1,
"original_amount": 30,
"cancelled_amount": 10,
"returned_amount": 10,
"exchanged_amount": 0,
"final_amount": 10,
"price": 10,
"original_item": true,
"custom": {
"remarketing_campaign": "christmas_2018",
"time_to_checkout": "25 minutes",
"ab_testing_group": "3245fcda"
},
"product": {
"id": "db050bb1-810d-4420-a6fb-c1ce472a4ca9",
"name": "Mug Commanders Act",
"description": "Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson",
"category_1": "Maison",
"category_2": "Cuisine",
"category_3": "Accessoires",
"category_4": "Contenants",
"category_5": "Mugs",
"tags": [
"mugs",
"anse",
"blanc",
"marque"
],
"condition": "new",
"availability": "in_stock",
"availability_date": "2019-02-06T17:41:31.427+01:00",
"expiration_date": "2019-02-06T17:41:31.427+01:00",
"price": 10,
"sale_price": 8,
"currency": "EUR",
"image_link": "https://commandersact.com/images/shopping/mug_hi_res.jpg",
"link": "https://commandersact.com/shopping/mug",
"brand": "Commanders Act",
"width": 6.4,
"length": 7.3,
"height": 9.5,
"weight": 80.7,
"size": "medium",
"colors": [
"blanc",
"rouge"
],
"gtin": "134588842456789000",
"mpn": "134588842",
"custom": {
"internal_category_id": 721,
"warehouse": "building B",
"box_barcode": 1830135586179
}
}
}
```
Il est recommandé d'utiliser autant de champs que possible afin de pouvoir construire de bons segments avec des conditions avancées
#### Propriétés
| Nom | Type | Obligatoire | Restrictions | Description |
| ------------------- | ------------------------ | ----------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id | string | true | aucun | ID de cet article dans la conversion. Cet ID est requis. Si vous n'avez pas d'ID d'article dans votre base de données et que le même ID de produit ne peut pas être répété dans une conversion, vous pouvez utiliser l'ID du produit comme valeur. Ce champ est utilisé pour identifier l'article lors des mises à jour. |
| quantite\_initiale | float | true | aucun | Quantité d'articles dans la conversion d'origine |
| quantite\_annulee | float | false | aucun | Quantité d'articles annulés |
| quantite\_retournee | float | false | aucun | Quantité d'articles retournés |
| quantite\_echangee | float | false | aucun | Quantité d'articles échangés |
| quantite\_finale | float | false | aucun | Quantité d'articles dans la transaction finale (original\_quantity - cancelled\_quantity - returned\_quantity - exchanged\_quantity) |
| montant\_initial | float | false | aucun | Montant initial pour cet article |
| montant\_annule | float | false | aucun | Montant annulé pour cet article |
| montant\_retourne | float | false | aucun | Montant retourné pour cet article |
| montant\_echange | float | false | aucun | Montant échangé pour cet article |
| montant\_final | float | false | aucun | Montant final pour cet article (original\_amount - cancelled\_amount - returned\_amount - exchanged\_amount) |
| prix | float | false | aucun | Prix de l'article (en utilisant la même devise que pour la conversion) |
| article\_initial | boolean | false | aucun | Si cet article était présent dans la conversion d'origine. Cette valeur est automatiquement définie à false pour tous les articles ajoutés lors des mises à jour de conversion |
| personnalisé | object | false | aucun | Objet contenant des propriétés personnalisées |
| produit | [Produit](#tocs_product) | true | aucun | Il existe trois façons d'avoir des informations produit dans vos conversion items. La première consiste à mettre les propriétés du produit inline pour chaque conversion item. La deuxième consiste à synchroniser votre catalogue de produits avec notre base de données à l'aide du endpoint "POST /products/bulk" et à n'envoyer que les ID produit dans les conversion items (notre serveur copiera les propriétés du produit depuis le catalogue). La troisième est une combinaison des précédentes et implique d'avoir un catalogue de produits et d'envoyer les informations produit inline. Si une propriété est présente à la fois dans le produit du catalogue et dans le produit inline, les propriétés du produit inline écraseront celles du catalogue. Cette méthode est utile lorsque les informations produit sont incomplètes ou complémentaires dans les produits inline.
Il est recommandé d'envoyer les produits inline, sauf lorsque vous ne disposez pas de toutes les informations produit. Dans la plupart des cas, vous n'avez pas besoin d'utiliser le catalogue. Il est recommandé d'utiliser autant de champs que possible afin de pouvoir construire de bons segments avec des conditions avancées.
Lorsque vous n'envoyez que l'ID du produit dans un conversion item, vous devez vous assurer que votre catalogue contient déjà le produit, sinon les propriétés du produit ne seront pas ajoutées à votre conversion item.
|
### Adresse
```
{
"country": "France",
"iso_country_code": "FR",
"country_code": "FRA",
"region": "Ile-de-France",
"locality": "Paris",
"postal_code": "75009",
"recipient": "Commanders Act",
"street_address": "3-5 Rue Saint-Georges",
"full_address": null,
"label": "home",
"coordinates": {
"latitude": 48.857764,
"longitude": 2.33935
}
}
```
Il est recommandé d'utiliser autant de champs que possible afin de pouvoir construire de bons segments avec des conditions avancées
#### Propriétés
| Nom | Type | Obligatoire | Restrictions | Description |
| ----------------- | ---------------- | ----------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| pays | string(1-250) | false | aucun | Nom lisible du pays |
| code\_pays\_iso | string(ISO-3166) | false | aucun | Code pays ISO-3166 |
| code\_pays | string | false | aucun | Utilisez ce champ si vous utilisez des codes pays autres qu'ISO-3166 |
| région | string(1-250) | false | aucun | Région administrative |
| localité | string(1-250) | false | aucun | Nom de ville, village, bourg, etc. |
| code\_postal | string(1-250) | false | aucun | Code postal |
| destinataire | string(1-250) | false | aucun | Nom du destinataire |
| adresse\_rue | string(1-250) | false | aucun | Nom de rue, numéro de rue, numéro d'immeuble, etc. |
| adresse\_complete | string(1-250) | false | aucun | Adresse complète sous forme de chaîne pouvant contenir des sauts de ligne. Non utilisable dans la segmentation mais disponible pour les exports |
| étiquette | string(1-250) | false | aucun | Étiquette pour cette adresse (domicile, travail, etc.) |
| coordonnées | object | false | aucun | Coordonnées de cette adresse |
| » latitude | float | false | aucun | Latitude |
| » longitude | float | false | aucun | Longitude |
### Produit
```
{
"id": "db050bb1-810d-4420-a6fb-c1ce472a4ca9",
"name": "Mug Commanders Act",
"description": "Le mug en grès blanc avec anse en C est le gobelet parfait pour toute boisson",
"category_1": "Maison",
"category_2": "Cuisine",
"category_3": "Accessoires",
"category_4": "Contenants",
"category_5": "Mugs",
"tags": [
"mugs",
"anse",
"blanc",
"marque"
],
"condition": "new",
"availability": "in_stock",
"availability_date": "2019-02-06T17:41:31.427+01:00",
"expiration_date": "2019-02-06T17:41:31.427+01:00",
"price": 10,
"sale_price": 8,
"currency": "EUR",
"image_link": "https://commandersact.com/images/shopping/mug_hi_res.jpg",
"link": "https://commandersact.com/shopping/mug",
"brand": "Commanders Act",
"width": 6.4,
"length": 7.3,
"height": 9.5,
"weight": 80.7,
"size": "medium",
"colors": [
"blanc",
"rouge"
],
"gtin": "134588842456789000",
"mpn": "134588842",
"custom": {
"internal_category_id": 721,
"warehouse": "building B",
"box_barcode": 1830135586179
}
}
```
Il existe trois façons d'avoir des informations produit dans vos conversion items. La première consiste à mettre les propriétés du produit inline pour chaque conversion item. La deuxième consiste à synchroniser votre catalogue de produits avec notre base de données à l'aide du endpoint "POST /products/bulk" et à n'envoyer que les ID produit dans les conversion items (notre serveur copiera les propriétés du produit depuis le catalogue). La troisième est une combinaison des précédentes et implique d'avoir un catalogue de produits et d'envoyer les informations produit inline. Si une propriété est présente à la fois dans le produit du catalogue et dans le produit inline, les propriétés du produit inline écraseront celles du catalogue. Cette méthode est utile lorsque les informations produit sont incomplètes ou complémentaires dans les produits inline. Il est recommandé d'envoyer les produits inline, sauf lorsque vous ne disposez pas de toutes les informations produit. Dans la plupart des cas, vous n'avez pas besoin d'utiliser le catalogue. Il est recommandé d'utiliser autant de champs que possible afin de pouvoir construire de bons segments avec des conditions avancées. Lorsque vous n'envoyez que l'ID du produit dans un conversion item, vous devez vous assurer que votre catalogue contient déjà le produit, sinon les propriétés du produit ne seront pas ajoutées à votre conversion item.
#### Propriétés
| Nom | Type | Obligatoire | Restrictions | Description |
| ------------------- | ---------------------- | ----------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id | string(1-50) | true | aucun | Identifiant unique de l'article (essayez d'utiliser l'identifiant le plus spécifique ou le SKU), comme une référence. S'il existe plusieurs occurrences pour le même identifiant, seule la dernière sera enregistrée |
| nom | string(1-500) | false | aucun | Nom de l'article |
| description | string(max 5000 chars) | false | aucun | Description de l'article |
| categorie\_1 | string(1-250) | false | aucun | Catégorie principale de l'article |
| categorie\_2 | string(1-250) | false | aucun | Deuxième sous-catégorie de l'article |
| categorie\_3 | string(1-250) | false | aucun | Troisième sous-catégorie de l'article |
| categorie\_4 | string(1-250) | false | aucun | Quatrième sous-catégorie de l'article |
| categorie\_5 | string(1-250) | false | aucun | Cinquième sous-catégorie de l'article. Si vous avez plus de cinq niveaux de catégorie, vous pouvez choisir de concaténer les niveaux restants comme 'Bikes/Parts/Wheels/Front' ou simplement ignorer les niveaux restants comme 'Bikes', selon vos besoins de segmentation. |
| tags | \[string] | false | aucun | Tableau de tags pour le produit. Les tags peuvent être n'importe quelle chose qui décrit le produit : fait main, écologique, résistant à la chaleur, etc. |
| état | string | false | aucun | État actuel du produit dans votre boutique (voir la liste des valeurs possibles ci-dessous) |
| disponibilité | string | false | aucun | Disponibilité actuelle de l'article dans votre boutique. Veillez à indiquer la disponibilité de l'article sur la page de votre boutique et à la tenir à jour (voir la liste des valeurs possibles ci-dessous) |
| date\_disponibilite | string(ISO-8601) | false | aucun | Date à laquelle le produit est devenu ou deviendra disponible. Voir la section « Formats de date » ci-dessus pour la liste des formats autorisés. |
| date\_expiration | string(ISO-8601) | false | aucun | Date à laquelle le produit est devenu ou deviendra indisponible. Voir la section « Formats de date » ci-dessus pour la liste des formats autorisés. |
| prix | float | false | aucun | Prix par défaut de l'article. Dans une conversion, vous pouvez spécifier le prix réel auquel l'article a été vendu en cas de soldes, remises, etc. |
| prix\_soldé | float | false | aucun | Prix par défaut de l'article pendant les périodes de soldes. Dans une conversion, vous pouvez spécifier le prix réel auquel l'article a été vendu en cas de remises |
| currency | string(ISO-4217) | false | aucun | Devise utilisée pour les prix indiqués. Notez que vous devez utiliser la même devise pour les produits et les conversions |
| lien\_image | string(url) | false | aucun | URL de l'image du produit |
| lien | string(url) | false | aucun | URL du site web où vous pouvez acheter l'article |
| marque | string(1-250) | false | aucun | Marque de l'article |
| largeur | float | false | aucun | Largeur de l'article en centimètres (cm) |
| longueur | float | false | aucun | Longueur de l'article en centimètres (cm) |
| hauteur | float | false | aucun | Hauteur de l'article en centimètres (cm) |
| poids | float | false | aucun | Poids de l'article en grammes (g) |
| taille | string(1-250) | false | aucun | Taille de l'article lorsque la largeur, la hauteur et les longueurs ne s'appliquent pas. Vous pouvez utiliser n'importe quelle valeur décrivant la taille. Exemples : S, XL, grand |
| couleurs | \[string] | false | aucun | Couleurs du produit |
| genre | string(1-250) | false | aucun | Genre pour les produits spécifiques à un genre (masculin, féminin, unisexe) |
| gtin | string(1-250) | false | aucun | Numéro d'identification commerciale internationale de l'article. Numéros pris en charge : UPC (Amérique du Nord, 12 chiffres), EAN (Europe, 13 chiffres), JAN (Japon, 8 à 13 chiffres), ISBN (livres, 13 chiffres) |
| mpn | string(1-250) | false | aucun | Numéro de pièce du fabricant du matériau |
| personnalisé | object | false | aucun | Objet contenant des propriétés personnalisées |
**Valeurs énumérées**
| Propriété | Valeur |
| ------------- | ------------------ |
| état | neuf |
| état | reconditionné |
| état | d'occasion |
| disponibilité | en\_stock |
| disponibilité | disponible |
| disponibilité | précommande |
| disponibilité | rupture\_de\_stock |
| genre | masculin |
| genre | féminin |
| genre | unisexe |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/import-conversions/api-conversions-and-product-catalog.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.