Importar y actualizar productos - Kameleoon Documentation

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. Recomendamos 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.

Solicitud HTTP

PUT https://api.products.kameleoon.com/import/products

Lista de parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
`shop_id`	String	Sí	Su Store Key. Puede encontrarla en Recommendations > Settings > Store settings en la aplicación Kameleoon. También puede contactar con su Customer Success Manager para obtener la clave.
`shop_secret`	String	Sí	Su Secret Key. Puede encontrarla en Recommendations > Settings > Store settings en la aplicación Kameleoon. También puede contactar con su Customer Success Manager para obtener la clave.
`items`	List	Sí	Una lista de artículos de producto. Encuentre en esta tabla los parámetros requeridos para `items`.
`webhook`	String	No	La URL del Webhook al que se enviará una solicitud POST al completarse la importación.

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, se enviará una solicitud POST al webhook designado.Ejemplo de una solicitud exitosa:

{
	"status": "success"
}

Ejemplo de una solicitud fallida:

{
	"status": "error", 
	"message": "MESSAGE"
}

Lista de parámetros para el objeto `items`

Si desea actualizar solo determinados productos, debe proporcionar todos los valores de los parámetros obligatorios para cada producto en la solicitud. Si se omite alguna propiedad obligatoria de un producto, el producto se ignorará durante la importación y no se realizará ningún cambio en nuestra base de datos. Por ejemplo, si solo desea actualizar el precio de un producto, debe incluir todos sus parámetros obligatorios, como categoría, nombre, imagen, etiquetas, etc.Para las propiedades no obligatorias, los valores omitidos provocarán que esas propiedades se eliminen de nuestra base de datos.

Parámetro	Tipo	Obligatorio	Descripción
`id`	String (longitud máx. 64)	Sí	Un ID único asignado al artículo
`group_id`	String (longitud máx. 64)	Opcional	El ID asociado al grupo del artículo
`name`	String (longitud máx. 255)	Sí	El nombre del artículo
`price`	Float (debe ser positivo)	Sí	El precio del artículo. Para indicar precios en varias ubicaciones, utilice en su lugar el objeto locations.
`oldprice`	Float (debe ser positivo)	Opcional	El precio anterior del artículo
`currency`	String	Sí	La moneda en la que se especificó el campo price
`url`	String	Sí	Una URL para asociar con el artículo
`picture`	String	Sí	Una URL que contiene una imagen del artículo
`available`	Boolean	Sí	Indica si el artículo está disponible para la compra. Utilice el endpoint update products para actualizar este valor más adelante
`categories`	Array de strings	Sí	Cada cadena representa un ID de categoría al que pertenece este producto.
`locations`	Array	Opcional	Array de precios del artículo en distintas ubicaciones. Encuentre en esta tabla los parámetros requeridos para `locations`
`accessories`	Array de strings	Opcional	Contiene los IDs de los productos accesorios relacionados con el artículo
`seasonality`	Array de enteros	Opcional	Representa los meses del año (enero=1, diciembre=12) en los que desea promocionar este artículo
`brand`	String	Opcional	El nombre de la marca del artículo
`barcode`	Integer	Opcional	Un valor de código de barras para el artículo
`price_margin`	Integer	Opcional	El margen de precio del artículo
`tags`	Array de strings	Opcional	Una lista de palabras clave que desea asociar con el artículo
`is_child`	Boolean	Opcional	Indica si este artículo es hijo de otro artículo
`is_fashion`	Boolean	Opcional	Indica si este artículo es un artículo de moda
`is_new`	Boolean	Opcional	Indica si este artículo es nuevo
`fashion`	Object	Opcional	Define varios parámetros adicionales para artículos de moda. Encuentre en esta tabla los parámetros requeridos para `fashion`
`stock_quantity`	Integer	Opcional	La cantidad de artículos en stock
`type_prefix`	String	Opcional	Un prefijo para distinguir el tipo de artículo
`model`	String	Opcional	El nombre del modelo del artículo
`params`	Object	Opcional	Añade parámetros personalizados. Encuentre en esta tabla los parámetros requeridos para `params`
`merchant`	String	Opcional	El comerciante que desea asociar con el artículo
`rating`	Integer	Opcional	Un valor entre 1 y 5. La valoración de usuario que desea asignar al artículo
`leftovers`	String	Opcional	Una descripción del stock restante. Por ejemplo, “one” representa un producto disponible como una sola unidad, “few” representa un producto en cantidades limitadas (hasta 10 unidades) y “lot” representa un producto disponible en cantidades de 10 o más unidades
`creation_date`	String	Opcional	Debe estar en el formato `yyyy-mm-dd`. Esta es la fecha de creación del artículo

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.

Parámetro	Tipo	Obligatorio	Descripción
`location`	String	Sí	La ubicación para la que desea especificar un precio. Este campo es obligatorio si se proporciona el campo locations.
`price`	Float (debe ser positivo)	Opcional	El precio en esta ubicación.
`oldprice`	Float (debe ser positivo)	Opcional	El precio anterior del artículo (por ejemplo, el precio normal de un artículo en oferta).
`stock_quantity`	Int (debe ser positivo)	Opcional	La cantidad del artículo en stock.
`sizes`	Array de Strings	Opcional	Una lista de opciones de tamaño para el artículo.
`weight`	Int (debe ser positivo)	Opcional	El peso del artículo.
`delivery_types`	Object	Opcional	Indica la disponibilidad del artículo. Encuentre en esta tabla los parámetros requeridos para `delivery_types`

Lista de parámetros para el objeto `delivery_types`

Parámetro	Tipo	Obligatorio	Descripción
`store`	Int (debe ser positivo)	Sí	Número de artículos disponibles en tienda
`delivery`	Int (debe ser positivo)	Sí	Número de artículos disponibles para entrega
`delivery`	Int (debe ser positivo)	Sí	Número de artículos disponibles en el almacén

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.

Parámetro	Tipo	Obligatorio	Descripción
`name`	String	Sí	El nombre del parámetro
`value`	Array de Strings	Sí	Array de valores para el parámetro
`unit`	String	Opcional	Unidad de medida para los valores.

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.

Parámetro	Tipo	Obligatorio	Descripción
`gender`	String	Opcional	Un género que asociar al artículo. Por ejemplo, “m”, “f” o “female”.
`sizes`	Array de Strings	Opcional	Lista de tamaños para el artículo.
`type`	String	Sí	El tipo de artículo de moda. Por ejemplo, “jacket”.

Ejemplo de solicitud JSON

{
    "id": "myID", // String (max 64). Required
    "group_id": "myGroup", // String (max 64). Optional
    "name": "myItem", // String (max 255). Required
    "price": "1", // Float (positive). Required
    "oldprice": "2", // Float (positive). Optional
    "currency": "USD", // Currency code: USD, EUR. Required.
    "url": "https://example.com/product", // String (URL). Required
    "picture": "https://example.com/product/image.png", // String (URL). Required
    "available": true, // Boolean (true, false). Required
    "categories": ["ID1", "ID2", ...], // Array of categories IDs. Required.
    "locations": [ 
    {
        "location": "USA",
        "delivery_types": {
            "store": 10,
            "stock": 50  }
    },
    {
        "location": "CAN",
        "price": 60
    }
    ], // Array of prices in locations. See below. Optional
    "accessories": ["ID", "ID", ...], // Array of product IDs. Optional
    "seasonality": [1, 2, ...], // Array of integers (months: 1-12). Optional
    "brand": "...", // String. Optional
    "barcode": "...", // String. Optional
    "price_margin": "...",// Integer. Optional
    "tags": ["TAG1", "TAG2", ...], // Array of strings. Optional
    "is_child": false, // Boolean (true, false). Optional
    "is_fashion": true, // Boolean (true, false). Optional
    "is_new": false, // Boolean (true, false). Optional
    "fashion": {
        "gender": "m",
        "sizes": ["48", "50", "52"],
        "type": "jacket"
    }, // Object. See below. Optional
    "stock_quantity": 60, // Int (positive). Optional
    "type_prefix": "...", // String. Optional
    "model": "Widget 3000", // String. Optional
    "params": [ 
    {
        "name": "Param 1",
        "value": ["bluetooth", "wi-fi"]
    }, 
    {
        "name": "Param 2",
        "value": [23]
    }
    ], // Array of params data. See below. Optional
    "merchant": "...", // String. Optional
    "rating": 4, // Integer (1-5). Optional
    "leftovers": "one", // String (one, few, lot). Optional
    "creation_date": "...", // String. Optional. Format yyyy-mm-dd,
}

​Límite de velocidad

​Solicitud HTTP

​Lista de parámetros de consulta

​Lista de parámetros para el objeto items

​Lista de parámetros para el objeto locations

​Lista de parámetros para el objeto delivery_types

​Lista de parámetros para el objeto Params

​Lista de parámetros para el objeto Fashion

​Ejemplo de solicitud JSON

Límite de velocidad

Solicitud HTTP

Lista de parámetros de consulta

Lista de parámetros para el objeto `items`

Lista de parámetros para el objeto `locations`

Lista de parámetros para el objeto `delivery_types`

Lista de parámetros para el objeto `Params`

Lista de parámetros para el objeto `Fashion`

Ejemplo de solicitud JSON