Skip to main content
PUT
Import and update products
Este endpoint importa sus productos en su cuenta de Kameleoon. Es el método preferido para importar su catálogo si tiene más de 50.000 productos. Kameleoon recomienda encarecidamente utilizar este endpoint también para actualizar la lista de productos y sus propiedades, en lugar de reimportar el catálogo completo cada día.
Si depende totalmente de este endpoint para importar su catálogo, asegúrese de que todas las categorías se hayan importado previamente utilizando el endpoint import categories. Cualquier producto sin una categoría conocida se ignorará durante el proceso de importación.
Los datos se envían como una cadena JSON en el cuerpo de la solicitud.

Límite de velocidad

  • El límite de solicitudes a la API (Rate Limit) está establecido en 40 solicitudes por minuto, con un máximo de 1 solicitud cada 1,5 segundos.
  • El límite de peso de las solicitudes a la API (Weight Limit) está limitado a 35 megabytes por solicitud.

Lista de parámetros de consulta

El propósito del webhook es notificar al desarrollador una vez que se ha completado una solicitud. Una vez importados y totalmente disponibles todos los productos de la llamada a la API, Kameleoon envía una solicitud POST al webhook designado.Ejemplo de una solicitud exitosa:
Ejemplo de una solicitud fallida:

Lista de parámetros para el objeto items

Para actualizar solo determinados productos, proporcione todos los valores de los parámetros obligatorios para cada producto en la solicitud. Si falta alguna propiedad obligatoria de un producto, Kameleoon ignora ese producto durante la importación y no realiza ningún cambio en la base de datos. Por ejemplo, para actualizar solo el precio de un producto, incluya todos sus parámetros obligatorios, como categories, name, picture y available.Para las propiedades no obligatorias, Kameleoon elimina los valores omitidos de la base de datos.

Lista de parámetros para el objeto locations

Utilice el objeto locations para proporcionar precios, inventario y otra información específica de la ubicación cuando tenga varias ubicaciones. Pase el objeto locations dentro del objeto product items.

Lista de parámetros para el objeto delivery_types

Lista de parámetros para el objeto Params

El objeto params permite especificar valores personalizados para los parámetros del artículo. Pase el objeto params dentro del objeto product items.

Lista de parámetros para el objeto Fashion

El objeto fashion permite especificar información adicional sobre los artículos de moda. Pase el objeto fashion dentro del objeto product items.

Ejemplo de solicitud JSON

Cuerpo

application/json
shop_id
string
requerido

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
string
requerido

Secret Key. Find this in Recommendations > Settings > Store settings in the Kameleoon app. Contact your Customer Success Manager for the key if necessary.

items
object[]
requerido

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
string

The webhook URL where a POST request is sent upon completion of the import.

Respuesta

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.