> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importer et mettre à jour des produits

> Importez ou mettez à jour votre catalogue de produits dans Kameleoon en utilisant l'endpoint préféré pour les catalogues de plus de 50K produits.

Cet endpoint importe vos produits dans votre compte Kameleoon. C'est la méthode préférée pour importer votre catalogue si vous avez plus de 50K produits.

Kameleoon recommande fortement d'utiliser cet endpoint également pour mettre à jour la liste des produits et leurs propriétés, plutôt que de réimporter complètement votre catalogue quotidiennement.

> [!WARNING]
>
> Si vous utilisez exclusivement cet endpoint pour importer votre catalogue, assurez-vous que toutes les catégories ont d'abord été importées via l'[endpoint d'import de catégories](https://docs.kameleoon.com/fr/developer-docs/apis/product-recommendation-api-rest/all-endpoints/Import/import-categories.md). Tout produit sans catégorie connue sera ignoré lors du processus d'import.

Les données sont envoyées sous forme de [chaîne JSON](#exemple-de-requête-json) dans le corps de la requête.

## Limite de débit

* La limite de requêtes API (Rate Limit) est fixée à 40 requêtes par minute, avec un maximum d'1 requête toutes les 1,5 secondes.
* La limite de poids des requêtes API (Weight Limit) est plafonnée à 35 mégaoctets par requête.

## Liste des paramètres de requête

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `shop_id` | String | Oui | Store Key. Trouvez-le dans **Recommendations** > **Settings** > **Store settings** dans l'application Kameleoon. Contactez votre Customer Success Manager pour obtenir la clé si nécessaire. |
| `shop_secret` | String | Oui | Secret Key. Trouvez-la dans **Recommendations** > **Settings** > **Store settings** dans l'application Kameleoon. Contactez votre Customer Success Manager pour obtenir la clé si nécessaire. |
| `items` | List | Oui | Une liste d'articles produits. Trouvez dans [ce tableau](#liste-des-paramètres-pour-l’objet-items) les paramètres requis pour `items` |
| `webhook` | String | Non | L'URL Webhook. Kameleoon envoie une requête POST à cette URL à la fin de l'import. |

> [!NOTE]
>
> L'objectif du `webhook` est de notifier le développeur une fois qu'une requête est terminée. Une fois que tous les produits de l'appel API ont été importés et sont entièrement disponibles, Kameleoon envoie une requête POST au webhook désigné.
>
> Exemple d'une requête réussie :
>
> ```json theme={null}
> {
> 	"status": "success"
> }
> ```
>
> Exemple d'une requête échouée :
>
> ```json theme={null}
> {
> 	"status": "error", 
> 	"message": "MESSAGE"
> }
> ```

## Liste des paramètres pour l'objet `items`

> [!WARNING]
>
> Pour mettre à jour uniquement certains produits, fournissez toutes les valeurs des paramètres obligatoires pour chaque produit dans la requête. Si une propriété obligatoire d'un produit est omise, Kameleoon ignore ce produit lors de l'import et n'apporte aucune modification à la base de données. Par exemple, pour mettre à jour uniquement le prix d'un produit, incluez tous ses paramètres obligatoires, tels que categories, name, picture et available.
>
> Pour les propriétés non obligatoires, Kameleoon supprime toute valeur omise de la base de données.

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `id` | String (longueur max 64) | Oui | Un ID unique attribué à l'article |
| `group_id` | String (longueur max 64) | Optionnel | L'ID associé au groupe d'articles |
| `name` | String (longueur max 255) | Oui | Le nom de l'article |
| `price` | Float (doit être positif) | Oui | Le prix de l'article. Pour fournir des prix dans plusieurs lieux, utilisez plutôt l'objet [locations](#liste-des-paramètres-pour-l’objet-locations). |
| `oldprice` | Float (doit être positif) | Optionnel | Le prix précédent de l'article |
| `currency` | String | Oui | La devise dans laquelle le champ price a été spécifié |
| `url` | String | Oui | Une URL à associer à l'article |
| `picture` | String | Oui | Une URL contenant une image de l'article |
| `available` | Boolean | Oui | Indique si l'article est disponible à l'achat. Utilisez l'endpoint update products pour le mettre à jour ultérieurement |
| `categories` | Array of strings | Oui | Chaque chaîne représente un ID de [catégorie](https://docs.kameleoon.com/fr/developer-docs/apis/product-recommendation-api-rest/all-endpoints/Import/import-categories.md) auquel ce produit appartient. |
| `locations` | Array | Optionnel | Tableau des prix de l'article à différents endroits. Trouvez dans [ce tableau](#liste-des-paramètres-pour-l’objet-locations) les paramètres requis pour `locations` |
| `accessories` | Array of strings | Optionnel | Contient les IDs de produits des accessoires associés à l'article |
| `seasonality` | Array of integers | Optionnel | Représente les mois de l'année (Janvier=1, Décembre=12) où vous souhaitez promouvoir cet article |
| `brand` | String | Optionnel | Le nom de la marque de l'article |
| `barcode` | Integer | Optionnel | Une valeur de code-barres pour l'article |
| `price_margin` | Integer | Optionnel | La marge de prix pour l'article |
| `tags` | Array of strings | Optionnel | Une liste de mots-clés que vous souhaitez associer à l'article |
| `is_child` | Boolean | Optionnel | Indique si cet article est un enfant d'un autre article |
| `is_fashion` | Boolean | Optionnel | Indique si cet article est un article de mode |
| `is_new` | Boolean | Optionnel | Indique si cet article est un nouvel article |
| `fashion` | Object | Optionnel | Définit plusieurs paramètres supplémentaires pour les articles de mode. Trouvez dans [ce tableau](#liste-des-paramètres-pour-l’objet-fashion) les paramètres requis pour `fashion` |
| `stock_quantity` | Integer | Optionnel | La quantité de l'article en stock |
| `type_prefix` | String | Optionnel | Un préfixe pour distinguer le type d'article |
| `model` | String | Optionnel | Le nom du modèle de l'article |
| `params` | Object | Optionnel | Ajoutez des paramètres personnalisés. Trouvez dans [ce tableau](#liste-des-paramètres-pour-l’objet-params) les paramètres requis pour `params` |
| `merchant` | String | Optionnel | Le marchand que vous souhaitez associer à l'article |
| `rating` | Integer | Optionnel | Une valeur entre 1 et 5. La note utilisateur que vous souhaitez attribuer à l'article |
| `leftovers` | String | Optionnel | Une description du stock restant. Par exemple, "one" représente un produit disponible en une seule unité, "few" représente un produit en quantités limitées (jusqu'à 10 unités), et "lot" représente un produit disponible en quantités de 10 unités ou plus |
| `creation_date` | String | Optionnel | Doit être au format `yyyy-mm-dd`. C'est la date de création de l'article |

## Liste des paramètres pour l'objet `locations`

Utilisez l'objet `locations` pour fournir des informations sur les prix, les stocks et d'autres informations spécifiques à un lieu lorsque vous avez plusieurs lieux. Passez l'objet locations à l'intérieur de l'objet items des produits.

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `location` | String | Oui | Le lieu pour lequel vous souhaitez spécifier un prix. Ce champ est requis si le champ locations est fourni. |
| `price` | Float (doit être positif) | Optionnel | Le prix à cet endroit. |
| `oldprice` | Float (doit être positif) | Optionnel | Le prix précédent de l'article (par exemple, le prix régulier d'un article en solde). |
| `stock_quantity` | Int (doit être positif) | Optionnel | La quantité de l'article en stock. |
| `sizes` | Array of Strings | Optionnel | Une liste d'options de taille pour l'article. |
| `weight` | Int (doit être positif) | Optionnel | Le poids de l'article. |
| `delivery_types` | Object | Optionnel | Indique la disponibilité de l'article. Trouvez dans [ce tableau](#liste-des-paramètres-pour-l’objet-delivery_types) les paramètres requis pour `delivery_types` |

## Liste des paramètres pour l'objet `delivery_types`

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `store` | Int (doit être positif) | Oui | Nombre d'articles disponibles en magasin |
| `delivery` | Int (doit être positif) | Oui | Nombre d'articles disponibles à la livraison ou en entrepôt |

## Liste des paramètres pour l'objet `Params`

L'objet params vous permet de spécifier des valeurs de paramètres personnalisées pour l'article. Passez l'objet `params` à l'intérieur de l'objet `items` des produits.

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `name` | String | Oui | Le nom du paramètre |
| `value` | Array of Strings | Oui | Tableau de valeurs pour le paramètre |
| `unit` | String | Optionnel | Unité de mesure pour les valeurs. |

## Liste des paramètres pour l'objet `Fashion`

L'objet fashion vous permet de spécifier des informations supplémentaires sur les articles de mode. Passez l'objet fashion à l'intérieur de l'objet items des produits.

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `gender` | String | Optionnel | Un genre à associer à l'article. Par exemple, "m", "f" ou "female". |
| `sizes` | Array of Strings | Optionnel | Liste des tailles pour l'article. |
| `type` | String | Oui | Le type d'article de mode. Par exemple, "jacket". |

## Exemple de requête JSON

```json theme={null}
{
    "id": "myID",
    "group_id": "myGroup",
    "name": "myItem",
    "price": 1,
    "oldprice": 2,
    "currency": "USD",
    "url": "https://example.com/product",
    "picture": "https://example.com/product/image.png",
    "available": true,
    "categories": ["ID1", "ID2"],
    "locations": [
        {
            "location": "USA",
            "delivery_types": {
                "store": 10,
                "delivery": 50
            }
        },
        {
            "location": "CAN",
            "price": 60
        }
    ],
    "accessories": ["ID1", "ID2"],
    "seasonality": [1, 2, 3],
    "brand": "Acme",
    "barcode": 123456789,
    "price_margin": 10,
    "tags": ["TAG1", "TAG2"],
    "is_child": false,
    "is_fashion": true,
    "is_new": false,
    "fashion": {
        "gender": "m",
        "sizes": ["48", "50", "52"],
        "type": "jacket"
    },
    "stock_quantity": 60,
    "type_prefix": "prefix",
    "model": "Widget 3000",
    "params": [
        {
            "name": "Param 1",
            "value": ["bluetooth", "wi-fi"]
        },
        {
            "name": "Param 2",
            "value": [23]
        }
    ],
    "merchant": "MerchantName",
    "rating": 4,
    "leftovers": "one",
    "creation_date": "2021-12-21"
}
```


## OpenAPI

````yaml product-recommendation.api.json PUT /import/products
openapi: 3.1.0
info:
  title: Kameleoon Product Recommendation API
  version: 1.0.0
  description: >-
    REST API for importing product, category, and order data into Kameleoon,
    initializing recommendation sessions, and retrieving product
    recommendations, collections, and search results.
servers:
  - url: https://api.products.kameleoon.com
security: []
paths:
  /import/products:
    put:
      tags:
        - Import
      summary: Import and update products
      description: >-
        Import your products into your Kameleoon account. This is the preferred
        endpoint for catalogs with more than 50K products, and is recommended
        for updating products and their properties rather than fully
        re-importing your catalog daily. All categories must be imported first
        using the import categories endpoint, or products without a known
        category are ignored. Rate limit: 40 requests per minute (max 1 request
        every 1.5 seconds), capped at 35 MB per request.
      operationId: importProducts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - shop_id
                - shop_secret
                - items
              properties:
                shop_id:
                  type: string
                  description: >-
                    Store Key. Find this in **Recommendations** > **Settings** >
                    **Store settings** in the Kameleoon app. Contact your
                    Customer Success Manager for the key if necessary.
                shop_secret:
                  type: string
                  description: >-
                    Secret Key. Find this in **Recommendations** > **Settings**
                    > **Store settings** in the Kameleoon app. Contact your
                    Customer Success Manager for the key if necessary.
                items:
                  type: array
                  items:
                    type: object
                    required:
                      - id
                      - name
                      - price
                      - currency
                      - url
                      - picture
                      - available
                      - categories
                    properties:
                      id:
                        type: string
                        maxLength: 64
                        description: A unique ID assigned to the item.
                      group_id:
                        type: string
                        maxLength: 64
                        description: The ID associated with the item group.
                      name:
                        type: string
                        maxLength: 255
                        description: The name of the item.
                      price:
                        type: number
                        minimum: 0
                        description: >-
                          The price of the item. To provide prices in multiple
                          locations, use `locations` instead.
                      oldprice:
                        type: number
                        minimum: 0
                        description: The previous price of the item.
                      currency:
                        type: string
                        description: The currency in which `price` was specified.
                      url:
                        type: string
                        description: A URL to associate with the item.
                      picture:
                        type: string
                        description: A URL containing an image of the item.
                      available:
                        type: boolean
                        description: >-
                          Indicates whether the item is available for purchase.
                          Use the update products endpoint to update this later.
                      categories:
                        type: array
                        items:
                          type: string
                        description: >-
                          Category IDs this product belongs to. See the import
                          categories endpoint.
                      locations:
                        type: array
                        items:
                          type: object
                          required:
                            - location
                          properties:
                            location:
                              type: string
                              description: >-
                                The location this price applies to. Required if
                                the `locations` field is provided.
                            price:
                              type: number
                              description: The price at this location.
                            oldprice:
                              type: number
                              description: >-
                                The previous price of the item at this location
                                (for example, the regular price of a sale item).
                            stock_quantity:
                              type: integer
                              description: >-
                                The quantity of the item in stock at this
                                location.
                            sizes:
                              type: array
                              items:
                                type: string
                              description: >-
                                A list of size options for the item at this
                                location.
                            weight:
                              type: integer
                              description: The weight of the item.
                            delivery_types:
                              type: object
                              required:
                                - store
                                - delivery
                              properties:
                                store:
                                  type: integer
                                  description: Number of items available in-store.
                                delivery:
                                  type: integer
                                  description: >-
                                    Number of items available for delivery, or
                                    in the warehouse.
                          description: >-
                            Provides price, inventory, and other
                            location-specific information when you have multiple
                            locations.
                        description: Prices of the item in different locations.
                      accessories:
                        type: array
                        items:
                          type: string
                        description: Product IDs of related accessories for the item.
                      seasonality:
                        type: array
                        items:
                          type: integer
                          minimum: 1
                          maximum: 12
                        description: >-
                          Months of the year (January=1, December=12) to promote
                          this item.
                      brand:
                        type: string
                        description: The brand name of the item.
                      barcode:
                        type: integer
                        description: A barcode value for the item.
                      price_margin:
                        type: integer
                        description: The price margin for the item.
                      tags:
                        type: array
                        items:
                          type: string
                        description: Keywords to associate with the item.
                      is_child:
                        type: boolean
                        description: >-
                          Indicates whether this item is a child of another
                          item.
                      is_fashion:
                        type: boolean
                        description: Indicates whether this item is a fashion item.
                      is_new:
                        type: boolean
                        description: Indicates whether this item is a new item.
                      fashion:
                        type: object
                        required:
                          - type
                        properties:
                          gender:
                            type: string
                            description: >-
                              A gender to associate with the item. For example,
                              "m", "f", or "female".
                          sizes:
                            type: array
                            items:
                              type: string
                            description: List of sizes for the item.
                          type:
                            type: string
                            description: The type of fashion item. For example, "jacket".
                        description: Additional information about fashion items.
                      stock_quantity:
                        type: integer
                        description: The quantity of the item in stock.
                      type_prefix:
                        type: string
                        description: A prefix to distinguish the type of item.
                      model:
                        type: string
                        description: The model name of the item.
                      params:
                        type: array
                        items:
                          type: object
                          required:
                            - name
                            - value
                          properties:
                            name:
                              type: string
                              description: The name of the parameter.
                            value:
                              type: array
                              items:
                                type: string
                              description: Array of values for the parameter.
                            unit:
                              type: string
                              description: Unit of measurement for the values.
                          description: Custom parameter values for the item.
                        description: Custom parameters for the item.
                      merchant:
                        type: string
                        description: The merchant to associate with the item.
                      rating:
                        type: integer
                        minimum: 1
                        maximum: 5
                        description: The user rating to assign to the item.
                      leftovers:
                        type: string
                        description: >-
                          A description of the remaining stock: "one" (single
                          unit), "few" (up to 10 units), or "lot" (10 or more
                          units).
                      creation_date:
                        type: string
                        description: 'The date the item was created. Format: yyyy-mm-dd.'
                  description: >-
                    A list of product items. To update only some properties of a
                    product, you must still include all of that product's
                    mandatory parameters, or the product is ignored during
                    import.
                webhook:
                  type: string
                  description: >-
                    The webhook URL where a POST request is sent upon completion
                    of the import.
            example:
              shop_id: eehj3eu84299kg5ghw5a6743r8
              shop_secret: pmd5362597thrgq8k256ep01t0
              items:
                - id: myID
                  name: myItem
                  price: 1
                  currency: USD
                  url: https://example.com/product
                  picture: https://example.com/product/image.png
                  available: true
                  categories:
                    - ID1
                    - ID2
      responses:
        '204':
          description: >-
            Import accepted. Verified against a live response on 2026-09-24:
            this endpoint returns an empty 204 response on success, not a JSON
            body — the `{"status": "success"}` shape only applies to the
            asynchronous `webhook` callback payload, if a `webhook` was
            provided.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                    description: Request outcome.
              example:
                status: success
        '400':
          description: >-
            The request was rejected, most commonly for invalid
            `shop_id`/`shop_secret` credentials. Verified against a live
            response on 2026-09-24.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                    description: Request outcome.
                  message:
                    type: string
                    description: Error details (for example, "Incorrect shop credentials").
              example:
                status: error
                message: Incorrect shop credentials

````