Productos

Productos

Un producto es una unidad vendible que puede estar compuesto por uno o más SKU

get
/products/search

Retorna un listado paginado de productos de la cuenta autenticada. También incluye productos de cuentas proveedoras asociadas (dropshipping). En el listado, los SKUs solo incluyen código y unidades; para ver atributos físicos completos usar GET /products/{id}.

Autorizaciones
AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de consulta
per_pageinteger · máx: 100Opcional

Cantidad de productos por página (máximo 100, por defecto 50)

Default: 50Example: 50
searchstringOpcional

Búsqueda de texto libre por nombre o código de referencia del producto

Example: camiseta
supplier_idintegerOpcional

Filtrar por ID de proveedor asociado a la cuenta. Cuando se especifica, solo se retornan productos de ese proveedor.

Example: 5
sort_bystring · enumOpcional

Campo por el que ordenar los resultados

Default: created_atValores posibles:
sort_directionstring · enumOpcional

Dirección del ordenamiento

Default: descValores posibles:
pageintegerOpcional

Número de página

Example: 1
Respuestas
200

Listado paginado de productos

application/json

Respuesta paginada del listado de productos.

get
/products/search

Obtener detalle de producto

get
/products/{product}

Retorna el detalle completo de un producto, incluyendo los atributos físicos de cada SKU (peso, dimensiones, código de barras, clasificación, etc.) y el stock disponible por depósito.

Autorizaciones
AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta
productintegerRequerido

ID del producto

Example: 1
Respuestas
200

Detalle del producto

application/json

Representa un producto del catálogo con sus SKUs asociados.

idintegerOpcional

ID del producto

Example: 1
account_idintegerOpcional

ID de la cuenta propietaria del producto

Example: 12
reference_codestringOpcional

Código de referencia único del producto en la cuenta

Example: PROD-001
namestringOpcional

Nombre del producto. Si es un producto de proveedor, el nombre del proveedor se antepone entre corchetes.

Example: [Proveedor X] Producto Ejemplo
created_atstring · date-timeOpcional

Fecha de creación del producto

Example: 2024-06-01T12:00:00Z
updated_atstring · date-timeOpcional

Fecha de última actualización del producto

Example: 2024-06-01T12:00:00Z
get
/products/{product}

Crear producto

post
/products

Crea un nuevo producto para la cuenta autenticada.

Los SKUs se especifican en el campo skus, donde cada entrada puede ser:

  • Referencia a SKU existente: pasar el código del SKU como string (ej. "SKU-001").

  • Nuevo SKU inline: pasar un objeto con los datos del SKU a crear.

Al crear el producto, se calculan automáticamente el peso total y el volumen total a partir de las dimensiones de los SKUs y las unidades por SKU.

Autorizaciones
AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Cuerpo

Datos para crear un nuevo producto con SKUs asociados.

reference_codestring · máx: 255Requerido

Código de referencia único del producto en la cuenta. Se sanitiza automáticamente (se convierten caracteres especiales).

Example: PROD-001
namestring · máx: 255Requerido

Nombre del producto

Example: Camiseta Manga Corta
Respuestas
post
/products

Actualizar producto

put
/products/{product}

Actualiza los datos de un producto existente de la cuenta autenticada. Todos los campos son opcionales; solo se actualizan los que se envíen.

Si se envía el campo skus, reemplaza completamente la lista de SKUs asociados al producto (operación de sincronización). Los SKUs no incluidos en el listado serán desvinculados del producto (aunque no eliminados del inventario). Cada entrada puede ser una referencia a un SKU existente (string con el código) o un objeto con datos para crear un nuevo SKU.

Tras cualquier modificación de SKUs, se recalculan automáticamente el peso total y el volumen total del producto.

Autorizaciones
AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta
productintegerRequerido

ID del producto

Example: 1
Cuerpo

Datos para actualizar un producto existente. Todos los campos son opcionales; solo se actualizan los que se envíen. Si se envía el campo skus, reemplaza completamente la lista de SKUs asociados al producto.

namestring · máx: 255Opcional

Nombre del producto

Example: Camiseta Manga Corta v2
reference_codestring · máx: 100Opcional

Código de referencia único del producto en la cuenta. Se sanitiza automáticamente.

Example: PROD-001-V2
Respuestas
200

Producto actualizado exitosamente

application/json

Representa un producto del catálogo con sus SKUs asociados.

idintegerOpcional

ID del producto

Example: 1
account_idintegerOpcional

ID de la cuenta propietaria del producto

Example: 12
reference_codestringOpcional

Código de referencia único del producto en la cuenta

Example: PROD-001
namestringOpcional

Nombre del producto. Si es un producto de proveedor, el nombre del proveedor se antepone entre corchetes.

Example: [Proveedor X] Producto Ejemplo
created_atstring · date-timeOpcional

Fecha de creación del producto

Example: 2024-06-01T12:00:00Z
updated_atstring · date-timeOpcional

Fecha de última actualización del producto

Example: 2024-06-01T12:00:00Z
put
/products/{product}

Eliminar producto

delete
/products/{product}

Elimina un producto específico para la cuenta autenticada.

Autorizaciones
AuthorizationstringRequerido

Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña

Parámetros de ruta
productintegerRequerido

ID del producto

Respuestas
200

Producto eliminado exitosamente. Los SKUs con stock o asociados a otros productos no se eliminan del inventario (se retornan en skus_kept).

application/json
messagestringOpcionalExample: Producto eliminado exitosamente
product_idintegerOpcionalExample: 42
skus_deletedstring[]Opcional

Códigos de SKUs eliminados del inventario junto con el producto

Example: SKU-001
skus_keptstring[]Opcional

Códigos de SKUs que no se eliminaron porque tienen stock o están asociados a otros productos

Example: SKU-002
skus_kept_reasonstringOpcionalExample: SKUs con stock o asociados a otros productos
delete
/products/{product}

Última actualización