For the complete documentation index, see llms.txt. This page is also available as Markdown.

SKUs y Stocks

SKUs

get
/inventory/search

Obtiene una lista paginada de SKUs de la cuenta autenticada con filtros opcionales. Los resultados se ordenan por fecha de creación descendente.

Autorizaciones
AuthorizationstringRequerido

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

Parámetros de consulta
skustringOpcional

Filtrar por código SKU exacto

Example: SKU-001
barcodestringOpcional

Filtrar por código de barras (busca en barcode y warehouse_barcode)

Example: 7798164800034
internal_idstringOpcional

Filtrar por código SKU interno

Example: INT-001
classificationintegerOpcional

Filtrar por ID de clasificación (busca en classification_id y warehouse_classification_id)

Example: 1
per_pageinteger · máx: 100Opcional

Número de resultados por página (máximo 100, por defecto 20)

Default: 20Example: 20
pageintegerOpcional

Número de página

Example: 1
Respuestas
200

Lista paginada de SKUs

application/json

Representa un SKU del inventario con sus atributos físicos, stock por depósito y detalles de lote/serie.

idintegerOpcional

ID del SKU

Example: 1
account_idintegerOpcional

ID de la cuenta propietaria del SKU

Example: 10
skustringOpcional

Código único del SKU en la cuenta

Example: SKU-001
internal_skustring · nullableOpcional

SKU interno alternativo (ej. código propio del sistema del cliente)

Example: INT-123
barcodestring · nullableOpcional

Código de barras del producto

Example: 7798164800027
namestringOpcional

Nombre del SKU

Example: Remera manga corta talle M
brandstring · nullableOpcional

Marca del producto

Example: Marca ABC
supplierstring · nullableOpcional

Proveedor del producto

Example: Proveedor XYZ
total_qty_availableintegerOpcional

Cantidad total disponible sumando todos los depósitos

Example: 50
classification_idintegerOpcionalObsoleto

ID de la clasificación (campo deprecado, usar el objeto classification)

Example: 1
get
/inventory/search

Obtener detalles de un SKU

get
/inventory/{sku}

Obtiene los detalles completos de un SKU específico por ID, código SKU o código interno.

Autorizaciones
AuthorizationstringRequerido

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

Parámetros de ruta
skustringRequerido

ID, código SKU o código interno del SKU

Parámetros de consulta
find_bystring · enumOpcional

Forzar campo de búsqueda

Valores posibles:
Respuestas
200

Detalles del SKU

application/json

Representa un SKU del inventario con sus atributos físicos, stock por depósito y detalles de lote/serie.

idintegerOpcional

ID del SKU

Example: 1
account_idintegerOpcional

ID de la cuenta propietaria del SKU

Example: 10
skustringOpcional

Código único del SKU en la cuenta

Example: SKU-001
internal_skustring · nullableOpcional

SKU interno alternativo (ej. código propio del sistema del cliente)

Example: INT-123
barcodestring · nullableOpcional

Código de barras del producto

Example: 7798164800027
namestringOpcional

Nombre del SKU

Example: Remera manga corta talle M
brandstring · nullableOpcional

Marca del producto

Example: Marca ABC
supplierstring · nullableOpcional

Proveedor del producto

Example: Proveedor XYZ
total_qty_availableintegerOpcional

Cantidad total disponible sumando todos los depósitos

Example: 50
classification_idintegerOpcionalObsoleto

ID de la clasificación (campo deprecado, usar el objeto classification)

Example: 1
get
/inventory/{sku}

Crear un nuevo SKU

post
/inventory

Crea un nuevo SKU en el inventario de la cuenta autenticada.

Clasificación: se puede indicar mediante classification (código, recomendado) o classification_id (ID numérico). Se debe enviar al menos uno de los dos.

Volumen mínimo: el producto del largo × ancho × alto debe ser ≥ 65 cm³.

Apilabilidad: si stackable es true y no se envían stack_limit_for_storage/stack_limit_for_packing, se aplican los valores por defecto del sistema. stack_height_increment se inicializa con el valor de height si no se especifica.

Información de pallet (excluyentes entre sí):

  • Opción A: enviar units_per_master_case + master_cases_per_pallet (el sistema calcula total_units_per_pallet).

  • Opción B: enviar solo total_units_per_pallet.

Autorizaciones
AuthorizationstringRequerido

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

Cuerpo
skustring · máx: 100Requerido

Código único del SKU en la cuenta. Se sanitiza automáticamente (mayúsculas, sin espacios).

Example: SKU-001
namestring · máx: 100Requerido

Nombre descriptivo del SKU

Example: Camiseta Talle M
classificationstringOpcional

Código de clasificación del SKU (recomendado). Alternativa a classification_id. Usar GET /inventory/classifications para ver opciones.

Example: default
classification_idintegerOpcional

ID numérico de la clasificación. Alternativa a classification.

Example: 1
unit_declared_valuenumberRequerido

Valor declarado por unidad (para seguro y aduanas)

Example: 1800
currencystring · máx: 3 · nullableOpcional

Moneda del valor declarado (ISO 4217). Por defecto: moneda de la cuenta.

Example: ARS
weightnumber · mín: 0.01Requerido

Peso en gramos

Example: 280
lengthnumber · mín: 1Requerido

Largo en cm

Example: 32
widthnumber · mín: 1Requerido

Ancho en cm

Example: 22
heightnumber · mín: 1Requerido

Alto en cm. El volumen resultante (largo × ancho × alto) debe ser ≥ 65 cm³.

Example: 2
barcodestring · máx: 100 · nullableOpcional

Código de barras del SKU

Example: 7798164800034
internal_skustring · máx: 20 · nullableOpcional

Código SKU alternativo interno (para referencias cruzadas con otros sistemas)

Example: INT-001
brandstring · máx: 100 · nullableOpcional

Marca del producto

Example: Zipnova
supplierstring · máx: 100 · nullableOpcional

Nombre del proveedor

Example: Confecciones SA
tax_class_codestring · máx: 50 · nullableOpcional

Código de clase impositiva (para integraciones fiscales)

Example: IVA_21
stackableboolean · nullableOpcional

Indica si el SKU puede apilarse en almacenamiento y empaque. Si es true, se aplican los límites de apilamiento.

Example: false
stack_limit_for_storageinteger · mín: 1 · nullableOpcional

Máximo de unidades apilables en almacenamiento. Solo aplica si stackable es true.

Example: 10
stack_limit_for_packinginteger · mín: 1 · nullableOpcional

Máximo de unidades apilables al empacar. Solo aplica si stackable es true.

Example: 5
stack_height_incrementnumber · mín: 1 · nullableOpcional

Incremento de altura al apilar (en cm). Por defecto: igual al valor de height.

Example: 2
management_typestring · enum · nullableOpcional

Tipo de gestión de inventario: por lote (lot) o por número de serie (serial).

Valores posibles:
units_per_master_caseinteger · mín: 1 · nullableOpcional

Unidades por caja máster. Requiere enviar también master_cases_per_pallet. Excluyente con total_units_per_pallet.

Example: 12
master_cases_per_palletinteger · mín: 1 · nullableOpcional

Cajas máster por pallet. Requiere enviar también units_per_master_case. Excluyente con total_units_per_pallet.

Example: 40
total_units_per_palletinteger · mín: 1 · nullableOpcional

Total de unidades por pallet (cálculo directo). Excluyente con units_per_master_case y master_cases_per_pallet.

Example: 480
avoid_reclassificationboolean · nullableOpcional

Si es true, el sistema no reclasificará automáticamente el SKU aunque cambie de categoría.

Example: false
Respuestas
post
/inventory

Actualizar un SKU

put
/inventory/{sku}

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

El SKU se puede identificar por su ID numérico, su código (sku) o su código interno (internal_sku). Si el código es numérico, se busca primero por ID.

Clasificación: se puede cambiar mediante classification (código) o classification_id (ID numérico). No es necesario enviar ninguno si no se quiere cambiar la clasificación.

Reclasificación automática: si el depósito tiene configurada la reclasificación automática, el sistema puede actualizar la clasificación del SKU al recibir mercadería. Para evitarlo, enviar avoid_reclassification: true.

Volumen mínimo: si se actualizan las dimensiones, el producto largo × ancho × alto debe seguir siendo ≥ 65 cm³.

Información de pallet: mismas reglas que al crear (excluyentes entre sí: total_units_per_pallet vs units_per_master_case + master_cases_per_pallet).

Autorizaciones
AuthorizationstringRequerido

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

Parámetros de ruta
skustringRequerido

ID numérico, código SKU o código interno del SKU a actualizar

Example: SKU-001
Cuerpo
namestring · máx: 100Opcional

Nombre descriptivo del SKU

Example: Camiseta Talle M v2
classificationstringOpcional

Código de clasificación. Alternativa a classification_id.

Example: default
classification_idintegerOpcional

ID numérico de la clasificación. Alternativa a classification.

Example: 1
unit_declared_valuenumberOpcional

Valor declarado por unidad

Example: 2000
currencystring · máx: 3 · nullableOpcional

Moneda del valor declarado (ISO 4217)

Example: ARS
weightnumber · mín: 0.01Opcional

Peso en gramos

Example: 300
lengthnumber · mín: 1Opcional

Largo en cm

Example: 34
widthnumber · mín: 1Opcional

Ancho en cm

Example: 24
heightnumber · mín: 1Opcional

Alto en cm

Example: 3
barcodestring · máx: 100 · nullableOpcional

Código de barras del SKU

Example: 7798164800041
brandstring · máx: 100 · nullableOpcional

Marca del producto

Example: Zipnova
supplierstring · máx: 100 · nullableOpcional

Nombre del proveedor

Example: Confecciones SA
tax_class_codestring · máx: 50 · nullableOpcional

Código de clase impositiva

Example: IVA_21
stackableboolean · nullableOpcional

Indica si el SKU puede apilarse

Example: true
stack_limit_for_storageinteger · mín: 1 · nullableOpcional

Máximo de unidades apilables en almacenamiento

Example: 10
stack_limit_for_packinginteger · mín: 1 · nullableOpcional

Máximo de unidades apilables al empacar

Example: 5
stack_height_incrementnumber · mín: 1 · nullableOpcional

Incremento de altura al apilar (en cm)

Example: 3
management_typestring · enum · nullableOpcional

Tipo de gestión de inventario: por lote (lot) o por número de serie (serial).

Valores posibles:
units_per_master_caseinteger · mín: 1 · nullableOpcional

Unidades por caja máster. Requiere master_cases_per_pallet. Excluyente con total_units_per_pallet.

Example: 12
master_cases_per_palletinteger · mín: 1 · nullableOpcional

Cajas máster por pallet. Requiere units_per_master_case. Excluyente con total_units_per_pallet.

Example: 40
total_units_per_palletinteger · mín: 1 · nullableOpcional

Total de unidades por pallet. Excluyente con units_per_master_case y master_cases_per_pallet.

Example: 480
avoid_reclassificationboolean · nullableOpcional

Si es true, evita que el depósito reclasifique automáticamente el SKU.

Example: false
Respuestas
200

SKU actualizado exitosamente

application/json

Representa un SKU del inventario con sus atributos físicos, stock por depósito y detalles de lote/serie.

idintegerOpcional

ID del SKU

Example: 1
account_idintegerOpcional

ID de la cuenta propietaria del SKU

Example: 10
skustringOpcional

Código único del SKU en la cuenta

Example: SKU-001
internal_skustring · nullableOpcional

SKU interno alternativo (ej. código propio del sistema del cliente)

Example: INT-123
barcodestring · nullableOpcional

Código de barras del producto

Example: 7798164800027
namestringOpcional

Nombre del SKU

Example: Remera manga corta talle M
brandstring · nullableOpcional

Marca del producto

Example: Marca ABC
supplierstring · nullableOpcional

Proveedor del producto

Example: Proveedor XYZ
total_qty_availableintegerOpcional

Cantidad total disponible sumando todos los depósitos

Example: 50
classification_idintegerOpcionalObsoleto

ID de la clasificación (campo deprecado, usar el objeto classification)

Example: 1
put
/inventory/{sku}

Eliminar un SKU

delete
/inventory/{sku}

Elimina permanentemente un SKU del inventario. La operación falla (409) si el SKU no puede eliminarse por alguna de estas razones:

  • Tiene stock disponible en algún depósito.

  • Tiene movimientos de inventario registrados.

  • Está asociado a uno o más productos activos.

  • Está referenciado en órdenes o envíos pendientes.

El campo reasons en la respuesta 409 detalla por qué no puede eliminarse.

Autorizaciones
AuthorizationstringRequerido

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

Parámetros de ruta
skustringRequerido

ID numérico, código SKU o código interno del SKU a eliminar

Example: SKU-001
Respuestas
200

SKU eliminado exitosamente.

application/json
messagestringOpcionalExample: SKU eliminado exitosamente
delete
/inventory/{sku}

Listar clasificaciones de SKUs

get
/inventory/classifications

Obtiene una lista de todos los tipos de clasificación de SKUs disponibles.

Autorizaciones
AuthorizationstringRequerido

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

Respuestas
200

Lista de clasificaciones

application/json

Tipo de clasificación de SKU para operaciones de almacén. La clasificación determina los requisitos especiales de manipulación y almacenamiento.

idintegerOpcional

ID de la clasificación

Example: 1
codestringOpcional

Código de la clasificación, utilizado en la API para referenciar la clasificación

Example: default
namestringOpcional

Nombre descriptivo de la clasificación

Example: General
descriptionstring · nullableOpcional

Descripción detallada de la clasificación

Example: Productos sin requerimientos especiales de manipulación
instructionsstring · nullableOpcional

Instrucciones operativas para el almacén

Example: Apilar en estanterías estándar.
get
/inventory/classifications

Stocks y Movimientos

Listar movimientos de un SKU

get
/inventory/{sku}/movements

Obtiene una lista paginada de movimientos para un SKU específico con filtros opcionales.

Autorizaciones
AuthorizationstringRequerido

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

Parámetros de ruta
skustringRequerido

ID, código SKU o código interno del SKU

Parámetros de consulta
find_bystring · enumOpcional

Forzar campo de búsqueda

Valores posibles:
date_fromstring · dateOpcional

Fecha inicial (YYYY-MM-DD). Por defecto 180 días atrás.

Example: 2024-01-01
date_tostring · dateOpcional

Fecha final (YYYY-MM-DD). Por defecto hoy.

Example: 2024-06-30
warehousestringOpcional

Código del almacén para filtrar

per_pageintegerOpcional

Número de resultados por página (máx 100)

Default: 20
Respuestas
200

Lista paginada de movimientos del SKU

application/json

Representa un movimiento de inventario de un SKU en un depósito (entrada, salida, ajuste, etc.).

idintegerOpcional

ID del movimiento

Example: 4521
created_atstring · date-timeOpcional

Fecha y hora en que se registró el movimiento

Example: 2024-03-15T09:30:00-03:00
warehousestring · nullableOpcional

Código del depósito donde ocurrió el movimiento

Example: AR-GBA-01
get
/inventory/{sku}/movements

Listar tipos de movimiento

get
/inventory/movement_types

Obtiene una lista de todos los tipos de movimiento de inventario disponibles.

Autorizaciones
AuthorizationstringRequerido

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

Respuestas
200

Lista de tipos de movimiento

application/json

Motivo o tipo de movimiento de inventario. Usar el campo code al referenciar un tipo de movimiento en otras operaciones.

codestringOpcional

Código del tipo de movimiento

Example: SHIPMENT
namestringOpcional

Nombre descriptivo del tipo de movimiento

Example: Descontado por envío
get
/inventory/movement_types

Última actualización