> 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 produits
## Commanders Act Data API v2.0.0
> Faites défiler vers le bas pour les exemples de code, les requêtes et les réponses d'exemple. Sélectionnez une langue pour les exemples de code dans 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 sauts de 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 en masse de nombreuses conversions/produits/etc., 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 niveau supérieur "errors".
#### Erreurs dans les opérations groupées
Pour les opérations groupées, vous pouvez avoir en même temps les propriétés "errors" et "data", car certains objets peuvent contenir des erreurs tandis que d'autres non. Les erreurs groupées sont agrégées, ce qui signifie qu'il n'y aura pas une erreur pour chaque occurrence d'une erreur, mais une erreur pour chaque 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": "Cette erreur est expliquée ici",
"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 le code d'erreur qui peut être vérifié par programmation |
| detail | string | true | Message lisible par l'humain qui explique le problème. Vous ne devez pas vérifier la valeur de cette propriété par programmation car elle peut changer |
| meta | objet | false | Objet spécifique à l'erreur qui contient des détails sur ce qui a généré l'erreur |
URLs de base :
* [https://api.commander1.com/v2/{siteId}](https://api.commander1.com/v2/%7BsiteId%7D)
## Authentification
* Authentification HTTP, schéma : bearer. Le jeton sera fourni par notre équipe support/conseil
## Par défaut
### Créer ou mettre à jour des 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`
Cet endpoint crée et met à jour des conversions. Votre requête sera traitée de manière asynchrone. Le traitement de la requête et la mise à 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 mesurer moins de 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":"Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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":"bâtiment 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":"Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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":"bâtiment 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 mesurer moins de 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":"Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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":"bâtiment 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":"Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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":"bâtiment 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 mesurer moins de 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":"Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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":"bâtiment 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":"Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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":"bâtiment B","box_barcode":1830135586179}}}]}
```
#### Paramètres
| Nom | Dans | Type | Obligatoire | Description |
| ------------- | ------- | ------------------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Authorization | en-tête | string | true | Jeton d'autorisation |
| écrasement | requête | booléen | false | Détermine si les conversions doivent être entièrement remplacées (`true`) ou partiellement mises à jour (`false` - par défaut). |
| corps | corps | [Conversion](#tocs_conversion) | true | Conversions sous forme de chaînes JSON délimitées par des sauts de ligne |
### Comportement du paramètre Overwrite
Le `écrasement` Le paramètre d'URL détermine comment les conversions sont traitées lorsqu'une conversion existante `ID` est trouvée :
* **`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 une conversion entièrement, définissez `overwrite=true`.
> Exemples de réponse
> 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é obligatoire '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 jeton est manquant
```
{
"errors": [
{
"code": "UNKNOWN_TOKEN_TYPE",
"detail": "Le type de jeton est manquant"
}
]
}
```
> 401 Le type de jeton est invalide
```
{
"errors": [
{
"code": "INVALID_TOKEN_TYPE",
"detail": "Le type de jeton \"Bear\" est invalide. \"Bearer\" est attendu à la place"
}
]
}
```
> 401 Le jeton fourni est inconnu
```
{
"errors": [
{
"code": "UNKNOWN_TOKEN",
"detail": "Le jeton 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 traitement | Aucune |
| 400 | [Mauvaise requête](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 côté client | Aucune |
| 401 | [Non autorisé](https://tools.ietf.org/html/rfc7235#section-3.1) | Impossible d'identifier l'appelant de l'API | Aucune |
| 403 | [Interdit](https://tools.ietf.org/html/rfc7231#section-6.5.3) | L'appelant de l'API n'a pas accès à cette ressource | Aucune |
| 429 | [Trop de requêtes](https://tools.ietf.org/html/rfc6585#section-4) | Trop de requêtes | Aucune |
| 500 | [Erreur interne du serveur](https://tools.ietf.org/html/rfc7231#section-6.6.1) | erreur interne du serveur | Aucune |
#### Schéma de réponse
### Créer ou mettre à jour des 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`
Cet endpoint crée et met à jour des produits. Votre requête sera traitée de manière asynchrone. Le traitement de la requête et la mise à 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":"Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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":"bâtiment B","box_barcode":1830135586179}}
{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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":"bâtiment B","box_barcode":1830135586179}}
{"id":"db050bb1-810d-4420-a6fb-c1ce472a4ca9","name":"Mug Commanders Act","description":"Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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":"bâtiment B","box_barcode":1830135586179}}
```
#### Paramètres
| Nom | Dans | Type | Obligatoire | Description |
| ------------- | ------- | ------------------------ | ----------- | --------------------------------------------------------------------- |
| Authorization | en-tête | string | true | Jeton d'autorisation |
| corps | corps | [Produit](#tocs_product) | true | Produits sous forme de chaînes JSON délimitées par des sauts de ligne |
#### Réponses
| Statut | Signification | Description | Schéma |
| ------ | -------------------------------------------------------------------------- | --------------- | ------ |
| 202 | [Accepté](https://tools.ietf.org/html/rfc7231#section-6.3.3) | Accepté | Aucune |
| 207 | [Multi-statut](https://tools.ietf.org/html/rfc2518#section-10.2) | Multi-statut | Aucune |
| 401 | [Non autorisé](https://tools.ietf.org/html/rfc7235#section-3.1) | Non autorisé | Aucune |
| 405 | [Méthode non autorisée](https://tools.ietf.org/html/rfc7231#section-6.5.5) | Entrée invalide | Aucune |
## 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 mesurer moins de 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": "Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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",
"red"
],
"gtin": "134588842456789000",
"mpn": "134588842",
"custom": {
"internal_category_id": 721,
"warehouse": "bâtiment 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": "Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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",
"red"
],
"gtin": "134588842456789000",
"mpn": "134588842",
"custom": {
"internal_category_id": 721,
"warehouse": "bâtiment 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 | objet | 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 | Adresse e-mail de l'utilisateur |
| »user.consent\_categories | string | false | aucun | Catégories de consentement de l'utilisateur, afin d'ê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 dont le statut est "pending" ne sont pas incluses dans les sommes et les comptes par défaut agrégés 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 une 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 une liste des formats autorisés. |
| acknowledged | booléen | false | aucun | Définissez 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 | Fournisseur de paiement utilisé pour cette transaction |
| original\_quantity | float | false | lecture seule | Somme de tous les articles dans la conversion d'origine (CALCULÉ) |
| cancelled\_quantity | float | false | lecture seule | Quantité d'articles annulés dans la conversion (CALCULÉ) |
| returned\_quantity | float | false | lecture seule | Quantité d'articles retournés dans la conversion (CALCULÉ) |
| exchanged\_quantity | float | false | lecture seule | Quantité d'articles échangés dans la conversion (CALCULÉ) |
| final\_quantity | float | false | lecture seule | Quantité d'articles dans la transaction finale pour cette conversion (original\_quantity - cancelled\_quantity - returned\_quantity - exchanged\_quantity) (CALCULÉ) |
| original\_amount | float | false | écriture unique | Montant d'origine pour cette conversion (prix d'expédition et taxes inclus) |
| cancelled\_amount | float | false | aucun | Montant annulé pour cette conversion |
| returned\_amount | float | false | aucun | Montant retourné pour cette conversion |
| exchanged\_amount | float | false | aucun | Montant échangé pour cette conversion |
| shipping\_amount | float | false | aucun | Montant d'expédition pour cette conversion |
| discount\_amount | float | false | aucun | Montant de la remise pour cette conversion |
| tax\_amount | float | false | aucun | Montant de la taxe pour cette conversion |
| final\_amount | float | false | aucun | Montant final pour cette conversion après retours, échanges, annulations, etc. (prix d'expédition et taxes inclus). Cela représente le montant total de la transaction entre l'acheteur et le vendeur |
| personnalisé | objet | false | aucun | Objet contenant des propriétés personnalisées |
| conversion\_items | \[[ConversionItem](#tocs_conversionitem)] | true | aucun | Liste des produits dans la conversion + leurs propres attributs. Vous ne pouvez pas avoir deux fois le même produit dans une conversion à moins de fournir un ID d'élément de conversion |
**Valeurs énumérées**
| Propriété | Valeur |
| --------------- | ------------------------------- |
| status | canceled |
| status | delivered |
| status | in\_progress |
| status | partially\_delivered |
| status | partially\_returned |
| status | partially\_shipped |
| status | pending\_shipment |
| status | returned |
| status | shipped |
| status | pending |
| payment\_method | by\_bank\_transfer\_in\_advance |
| payment\_method | by\_invoice |
| payment\_method | card |
| payment\_method | check\_in\_advance |
| payment\_method | cod |
| payment\_method | coupon |
| payment\_method | direct\_debit |
| payment\_method | online\_payment\_system |
| payment\_method | other |
### 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": "Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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",
"red"
],
"gtin": "134588842456789000",
"mpn": "134588842",
"custom": {
"internal_category_id": 721,
"warehouse": "bâtiment 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 élément dans la conversion. Cet ID est requis. Si vous n'avez pas d'ID d'élément 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'élément dans les mises à jour. |
| original\_quantity | float | true | aucun | Quantité d'articles dans la conversion d'origine |
| cancelled\_quantity | float | false | aucun | Quantité d'articles annulés |
| returned\_quantity | float | false | aucun | Quantité d'articles retournés |
| exchanged\_quantity | float | false | aucun | Quantité d'articles échangés |
| final\_quantity | float | false | aucun | Quantité d'articles dans la transaction finale (original\_quantity - cancelled\_quantity - returned\_quantity - exchanged\_quantity) |
| original\_amount | float | false | aucun | Montant d'origine pour cet article |
| cancelled\_amount | float | false | aucun | Montant annulé pour cet article |
| returned\_amount | float | false | aucun | Montant retourné pour cet article |
| exchanged\_amount | float | false | aucun | Montant échangé pour cet article |
| final\_amount | float | false | aucun | Montant final pour cet article (original\_amount - cancelled\_amount - returned\_amount - exchanged\_amount) |
| price | float | false | aucun | Prix de l'article (en utilisant la même devise que pour la conversion) |
| original\_item | booléen | false | aucun | Indique si cet article était présent dans la conversion d'origine. Ce champ est automatiquement défini sur false pour tous les articles ajoutés lors des mises à jour de conversion |
| personnalisé | objet | false | aucun | Objet contenant des propriétés personnalisées |
| product | [Produit](#tocs_product) | true | aucun | Il existe trois façons d'avoir des informations produit dans vos éléments de conversion. La première consiste à mettre les propriétés du produit en inline pour chaque élément de conversion. La deuxième consiste à synchroniser votre catalogue produits avec notre base de données à l'aide du point de terminaison "POST /products/bulk" et à n'envoyer que les ID des produits dans les éléments de conversion (notre serveur copiera les propriétés du produit depuis le catalogue). La troisième est une combinaison des précédentes et implique de disposer d'un catalogue produits et d'envoyer les informations produit en 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 en 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 élément de conversion, 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 élément de conversion.
|
### 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 |
| ------------------ | ---------------- | ----------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| country | string(1-250) | false | aucun | Nom lisible du pays |
| iso\_country\_code | string(ISO-3166) | false | aucun | Code pays ISO-3166 |
| country\_code | string | false | aucun | Utilisez ce champ au cas où vous utilisez des codes pays autres que ISO-3166 |
| region | string(1-250) | false | aucun | Région administrative |
| locality | string(1-250) | false | aucun | Nom de la ville, du village, etc. |
| postal\_code | string(1-250) | false | aucun | Code postal |
| recipient | string(1-250) | false | aucun | Nom du destinataire |
| street\_address | string(1-250) | false | aucun | Nom de la rue, numéro de rue, numéro d'immeuble, etc. |
| full\_address | string(1-250) | false | aucun | Adresse complète sous forme de chaîne de caractères pouvant contenir des sauts de ligne. Non utilisable dans la segmentation mais disponible pour les exports |
| label | string(1-250) | false | aucun | Libellé de cette adresse (domicile, travail, etc.) |
| coordinates | objet | 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": "Mug en grès blanc avec anse en C est la tasse parfaite pour n'importe quelle 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",
"red"
],
"gtin": "134588842456789000",
"mpn": "134588842",
"custom": {
"internal_category_id": 721,
"warehouse": "bâtiment B",
"box_barcode": 1830135586179
}
}
```
Il existe trois façons d'avoir des informations produit dans vos éléments de conversion. La première consiste à mettre les propriétés du produit en inline pour chaque élément de conversion. La deuxième consiste à synchroniser votre catalogue produits avec notre base de données à l'aide du point de terminaison "POST /products/bulk" et à n'envoyer que les ID des produits dans les éléments de conversion (notre serveur copiera les propriétés du produit depuis le catalogue). La troisième est une combinaison des précédentes et implique de disposer d'un catalogue produits et d'envoyer les informations produit en 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 en 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 élément de conversion, 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 élément de conversion.
#### 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), par exemple une référence. S'il existe plusieurs occurrences pour le même identifiant, seule la dernière sera enregistrée |
| name | string(1-500) | false | aucun | Nom de l'article |
| description | string(max 5000 chars) | false | aucun | Description de l'article |
| category\_1 | string(1-250) | false | aucun | Catégorie principale de l'article |
| category\_2 | string(1-250) | false | aucun | Deuxième sous-catégorie de l'article |
| category\_3 | string(1-250) | false | aucun | Troisième sous-catégorie de l'article |
| category\_4 | string(1-250) | false | aucun | Quatrième sous-catégorie de l'article |
| category\_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 suivants 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 tout ce qui étiquette le produit : fait main, écologique, résistant à la chaleur, etc. |
| condition | string | false | aucun | État actuel du produit dans votre boutique (voir ci-dessous la liste des valeurs possibles) |
| availability | 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 maintenir à jour (voir ci-dessous la liste des valeurs possibles) |
| availability\_date | string(ISO-8601) | false | aucun | Date à laquelle le produit est devenu ou deviendra disponible. Voir la section "Date formats" ci-dessus pour la liste des formats autorisés. |
| expiration\_date | string(ISO-8601) | false | aucun | Date à laquelle le produit est devenu ou deviendra indisponible. Voir la section "Date formats" ci-dessus pour la liste des formats autorisés. |
| price | float | false | aucun | Prix par défaut de l'article. Dans une conversion, vous pouvez préciser le prix réel auquel l'article a été vendu en cas de soldes, de remises, etc. |
| sale\_price | float | false | aucun | Prix par défaut de l'article pendant les périodes de soldes. Dans une conversion, vous pouvez préciser 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 |
| image\_link | string(url) | false | aucun | URL de l'image du produit |
| link | string(url) | false | aucun | URL du site web où vous pouvez acheter l'article |
| brand | string(1-250) | false | aucun | Marque de l'article |
| width | float | false | aucun | Largeur de l'article en centimètres (cm) |
| length | float | false | aucun | Longueur de l'article en centimètres (cm) |
| height | float | false | aucun | Hauteur de l'article en centimètres (cm) |
| weight | float | false | aucun | Poids de l'article en grammes |
| size | string(1-250) | false | aucun | Taille de l'article lorsque la largeur, la hauteur et la longueur ne sont pas applicables. Vous pouvez utiliser toute valeur décrivant la taille. Exemples : S, XL, large |
| colors | \[string] | false | aucun | Couleurs du produit |
| gender | string(1-250) | false | aucun | Genre pour les produits spécifiques à un genre (male, female, unisex) |
| gtin | string(1-250) | false | aucun | Numéro international d'identification commerciale 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 | Référence fabricant de l'article |
| personnalisé | objet | false | aucun | Objet contenant des propriétés personnalisées |
**Valeurs énumérées**
| Propriété | Valeur |
| ------------ | -------------- |
| condition | nouveau |
| condition | refurbished |
| condition | used |
| availability | in\_stock |
| availability | available |
| availability | pre\_order |
| availability | out\_of\_stock |
| gender | male |
| gender | female |
| gender | unisex |
---
# 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.