SKUs y Stocks

SKUs

Listar SKUs

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/inventory/search

Obtiene una lista paginada de SKUs con filtros opcionales

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

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

Parámetros de consulta

account_idintegerOpcional

Filtrar por ID de cuenta

internal_idstringOpcional

Filtrar por ID interno del SKU

skustringOpcional

Filtrar por código SKU

barcodestringOpcional

Filtrar por código de barras

classificationintegerOpcional

Filtrar por ID de clasificación

per_pageintegerOpcional

Número de resultados por página (máx 100). Por defecto 20.

Default: 20

Respuestas

200

Lista paginada de SKUs

application/json

401

No autenticado

application/json

403

Prohibido

application/json

get

/inventory/search

HTTPcURLJavaScriptPython

GET /v2/inventory/search HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "data": [
    {
      "id": 1,
      "account_id": 10,
      "internal_sku": "INT-123",
      "sku": "SKU-001",
      "barcode": "1234567890123",
      "name": "Producto de ejemplo",
      "brand": "Marca",
      "supplier": "Proveedor",
      "classification": {
        "id": 1,
        "code": "default",
        "name": "General"
      },
      "attributes": {
        "unit_declared_value": 100.5,
        "weight": 1.2,
        "length": 10,
        "width": 5,
        "height": 2
      },
      "total_qty_available": 50,
      "stocks": [
        {
          "warehouse": "AR-01",
          "qty_available": 30,
          "qty_allocated": 10,
          "qty_total": 40,
          "details": [
            {
              "type": "LOTE",
              "number": "L123",
              "ellaboration_date": "2024-01-01",
              "expiration_date": "2025-01-01",
              "qty_available": 20,
              "qty_allocated": 5,
              "qty_total": 25
            }
          ]
        }
      ]
    }
  ],
  "links": {
    "first": "https://api.zipnova.com.xx/v2/inventory/skus?page=1",
    "last": "https://api.zipnova.com.xx/v2/inventory/skus?page=5",
    "prev": null,
    "next": "https://api.zipnova.com.xx/v2/inventory/skus?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "path": "https://api.zipnova.com.xx/v2/inventory/skus",
    "per_page": 20,
    "to": 20,
    "total": 100
  }
}

Mostrar detalles de un SKU

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/inventory/{sku}

Obtiene los detalles completos de un SKU específico.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

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

Parámetros de ruta

skustringRequerido

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

Parámetros de consulta

find_bystring · enumOpcional

Forzar campo de búsqueda: 'sku' o 'internal_sku'. Si no se especifica, intenta con ID, luego SKU, luego Internal SKU.

Valores posibles:

Respuestas

200

Detalles del SKU

application/json

401

No autenticado

application/json

403

Prohibido

application/json

404

SKU no encontrado

application/json

get

/inventory/{sku}

HTTPcURLJavaScriptPython

GET /v2/inventory/{sku} HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "id": 1,
  "account_id": 10,
  "internal_sku": "INT-123",
  "sku": "SKU-001",
  "barcode": "1234567890123",
  "name": "Producto de ejemplo",
  "brand": "Marca",
  "supplier": "Proveedor",
  "classification": {
    "id": 1,
    "code": "default",
    "name": "General"
  },
  "attributes": {
    "unit_declared_value": 100.5,
    "weight": 1.2,
    "length": 10,
    "width": 5,
    "height": 2
  },
  "total_qty_available": 50,
  "stocks": [
    {
      "warehouse": "AR-01",
      "qty_available": 30,
      "qty_allocated": 10,
      "qty_total": 40,
      "details": [
        {
          "type": "LOTE",
          "number": "L123",
          "ellaboration_date": "2024-01-01",
          "expiration_date": "2025-01-01",
          "qty_available": 20,
          "qty_allocated": 5,
          "qty_total": 25
        }
      ]
    }
  ]
}

Crear un nuevo SKU

post

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/inventory

Crea un nuevo SKU.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

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

Cuerpo

application/json

skustringRequerido

Código único del SKU

Example: SKU-001

namestringRequerido

Nombre del SKU

Example: Producto de ejemplo

classificationstringRequerido

Código de clasificación del SKU

Example: default

avoid_reclassificationbooleanOpcional

Si se activa, no se reclasificará automáticamente el SKU según su nombre.

Example: true

barcodestringOpcional

Código de barras del SKU

Example: 1234567890123

brandstringOpcional

Marca del SKU

Example: MarcaX

supplierstringOpcional

Proveedor del SKU

Example: ProveedorY

tax_class_codestringOpcional

Código de clase de impuesto

Example: TC01

unit_declared_valuenumber · floatRequerido

Valor declarado por unidad

Example: 100.5

weightnumber · floatRequerido

Peso en kg

Example: 1.2

lengthnumber · floatRequerido

Largo en cm

Example: 10

widthnumber · floatRequerido

Ancho en cm

Example: 5

heightnumber · floatRequerido

Alto en cm

Example: 2

stackablebooleanOpcional

Indica si el SKU es apilable

Example: true

stack_limit_for_storageintegerOpcional

Límite de apilamiento para almacenamiento (opcional, default: 10 si es apilable)

Example: 5

stack_limit_for_packingintegerOpcional

Límite de apilamiento para embalaje (opcional, default: 5 si es apilable)

Example: 3

stack_height_incrementnumber · floatOpcional

Incremento de altura por apilamiento en cm (opcional, default: altura del SKU si es apilable)

Example: 2

management_typestringOpcional

Tipo de gestión del SKU (opcional)

Example: Lote

units_per_master_caseintegerOpcional

Unidades por caja master (opcional)

Example: 24

master_cases_per_palletintegerOpcional

Cajas master por pallet (opcional)

Example: 10

total_units_per_palletintegerOpcional

Total de unidades por pallet (opcional)

Example: 240

Respuestas

201

SKU creado exitosamente

application/json

400

Solicitud inválida

application/json

401

No autenticado

application/json

403

Prohibido

application/json

500

Error interno del servidor

application/json

post

/inventory

HTTPcURLJavaScriptPython

POST /v2/inventory HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 478

{
  "sku": "SKU-001",
  "name": "Producto de ejemplo",
  "classification": "default",
  "avoid_reclassification": true,
  "barcode": "1234567890123",
  "brand": "MarcaX",
  "supplier": "ProveedorY",
  "tax_class_code": "TC01",
  "unit_declared_value": 100.5,
  "weight": 1.2,
  "length": 10,
  "width": 5,
  "height": 2,
  "stackable": true,
  "stack_limit_for_storage": 5,
  "stack_limit_for_packing": 3,
  "stack_height_increment": 2,
  "management_type": "Lote",
  "units_per_master_case": 24,
  "master_cases_per_pallet": 10,
  "total_units_per_pallet": 240
}

{
  "id": 1,
  "account_id": 10,
  "internal_sku": "INT-123",
  "sku": "SKU-001",
  "barcode": "1234567890123",
  "name": "Producto de ejemplo",
  "brand": "Marca",
  "supplier": "Proveedor",
  "classification": {
    "id": 1,
    "code": "default",
    "name": "General"
  },
  "attributes": {
    "unit_declared_value": 100.5,
    "weight": 1.2,
    "length": 10,
    "width": 5,
    "height": 2
  },
  "total_qty_available": 50,
  "stocks": [
    {
      "warehouse": "AR-01",
      "qty_available": 30,
      "qty_allocated": 10,
      "qty_total": 40,
      "details": [
        {
          "type": "LOTE",
          "number": "L123",
          "ellaboration_date": "2024-01-01",
          "expiration_date": "2025-01-01",
          "qty_available": 20,
          "qty_allocated": 5,
          "qty_total": 25
        }
      ]
    }
  ]
}

Actualizar un SKU existente

put

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/inventory/{sku}

Actualiza un SKU existente en el sistema. Todos los campos son opcionales y solo se actualizarán los proporcionados.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

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

Parámetros de ruta

skustringRequerido

ID interno o código SKU del SKU a actualizar

Cuerpo

application/json

namestringOpcional

Nombre del SKU

Example: Producto actualizado

classificationstringOpcional

Código de clasificación del SKU

Example: default

avoid_reclassificationbooleanOpcional

Si se activa, no se reclasificará automáticamente el SKU según su nombre.

Example: true

barcodestringOpcional

Código de barras del SKU

Example: 1234567890123

brandstringOpcional

Marca del SKU

Example: MarcaX

supplierstringOpcional

Proveedor del SKU

Example: ProveedorY

tax_class_codestringOpcional

Código de clase de impuesto

Example: TC01

unit_declared_valuenumber · floatOpcional

Valor declarado por unidad

Example: 150.75

weightnumber · floatOpcional

Peso en kg

Example: 1.5

lengthnumber · floatOpcional

Largo en cm

Example: 12

widthnumber · floatOpcional

Ancho en cm

Example: 6

heightnumber · floatOpcional

Alto en cm

Example: 3

stackablebooleanOpcional

Indica si el SKU es apilable

Example: true

stack_limit_for_storageintegerOpcional

Límite de apilamiento para almacenamiento

Example: 5

stack_limit_for_packingintegerOpcional

Límite de apilamiento para embalaje

Example: 3

stack_height_incrementnumber · floatOpcional

Incremento de altura por apilamiento en cm

Example: 3

management_typestringOpcional

Tipo de gestión del SKU

Example: lot

units_per_master_caseintegerOpcional

Unidades por caja master

Example: 24

master_cases_per_palletintegerOpcional

Cajas master por pallet

Example: 10

total_units_per_palletintegerOpcional

Total de unidades por pallet

Example: 240

Respuestas

200

SKU actualizado exitosamente

application/json

401

No autenticado

application/json

403

Prohibido

application/json

404

SKU no encontrado

application/json

422

Error de validación

application/json

500

Error interno del servidor

application/json

put

/inventory/{sku}

HTTPcURLJavaScriptPython

PUT /v2/inventory/{sku} HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 463

{
  "name": "Producto actualizado",
  "classification": "default",
  "avoid_reclassification": true,
  "barcode": "1234567890123",
  "brand": "MarcaX",
  "supplier": "ProveedorY",
  "tax_class_code": "TC01",
  "unit_declared_value": 150.75,
  "weight": 1.5,
  "length": 12,
  "width": 6,
  "height": 3,
  "stackable": true,
  "stack_limit_for_storage": 5,
  "stack_limit_for_packing": 3,
  "stack_height_increment": 3,
  "management_type": "lot",
  "units_per_master_case": 24,
  "master_cases_per_pallet": 10,
  "total_units_per_pallet": 240
}

{
  "id": 1,
  "account_id": 10,
  "internal_sku": "INT-123",
  "sku": "SKU-001",
  "barcode": "1234567890123",
  "name": "Producto de ejemplo",
  "brand": "Marca",
  "supplier": "Proveedor",
  "classification": {
    "id": 1,
    "code": "default",
    "name": "General"
  },
  "attributes": {
    "unit_declared_value": 100.5,
    "weight": 1.2,
    "length": 10,
    "width": 5,
    "height": 2
  },
  "total_qty_available": 50,
  "stocks": [
    {
      "warehouse": "AR-01",
      "qty_available": 30,
      "qty_allocated": 10,
      "qty_total": 40,
      "details": [
        {
          "type": "LOTE",
          "number": "L123",
          "ellaboration_date": "2024-01-01",
          "expiration_date": "2025-01-01",
          "qty_available": 20,
          "qty_allocated": 5,
          "qty_total": 25
        }
      ]
    }
  ]
}

Eliminar un SKU

delete

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/inventory/{sku}

Elimina un SKU específico del sistema si no tiene stock ni movimientos asociados.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

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

Parámetros de ruta

skustringRequerido

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

Respuestas

200

SKU eliminado exitosamente

application/json

401

No autenticado

application/json

403

Prohibido

application/json

404

SKU no encontrado

application/json

409

Conflicto al eliminar el SKU

application/json

500

Error interno del servidor

application/json

delete

/inventory/{sku}

HTTPcURLJavaScriptPython

DELETE /v2/inventory/{sku} HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "message": "SKU eliminado exitosamente.",
  "data": {
    "deleted_sku_id": 1,
    "deleted_sku_code": "SKU-001"
  }
}

Listar tipos de clasificación de SKUs

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/inventory/classifications

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

Respuestas

200

Lista de clasificaciones

application/json

401

No autenticado

application/json

403

Prohibido

application/json

get

/inventory/classifications

HTTPcURLJavaScriptPython

GET /v2/inventory/classifications HTTP/1.1
Host: api.zipnova.com.ar
Accept: */*

{
  "data": [
    {
      "id": "1",
      "code": "default",
      "name": "General",
      "description": "Productos sin otra categorización"
    }
  ]
}

Stocks y Movimientos

Listar movimientos de un SKU

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/inventory/{sku}/movements

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

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

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

Parámetros de ruta

skustringRequerido

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

Parámetros de consulta

find_bystring · enumOpcional

Forzar campo de búsqueda: 'sku' o 'internal_sku'. Si no se especifica, intenta con ID, luego SKU, luego Internal SKU.

Valores posibles:

date_fromstring · dateOpcional

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

Example: 2024-01-01

date_tostring · dateOpcional

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

Example: 2024-06-30

warehousestringOpcional

Código del warehouse para filtrar movimientos

per_pageintegerOpcional

Número de resultados por página (máx 100). Por defecto 20.

Default: 20

Respuestas

200

Lista paginada de movimientos del SKU

application/json

401

No autenticado

application/json

403

Prohibido

application/json

404

SKU no encontrado

application/json

get

/inventory/{sku}/movements

HTTPcURLJavaScriptPython

GET /v2/inventory/{sku}/movements HTTP/1.1
Host: api.zipnova.com.ar
Authorization: Basic username:password
Accept: */*

{
  "data": [
    {
      "id": 1,
      "created_at": "2024-01-01T12:00:00Z",
      "sku": {
        "sku": "SKU-001",
        "internal_sku": "INT-123",
        "account_id": 10
      },
      "warehouse": "AR-01",
      "movement": {
        "qty_changed": 5,
        "type": "IN",
        "code": "RECEIPT",
        "reason": "Received from supplier",
        "comments": "Initial stock received"
      }
    }
  ],
  "links": {
    "first": "https://api.zipnova.com.xx/v2/inventory/skus/SKU-001/movements?page=1",
    "last": "https://api.zipnova.com.xx/v2/inventory/skus/SKU-001/movements?page=5",
    "prev": null,
    "next": "https://api.zipnova.com.xx/v2/inventory/skus/SKU-001/movements?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "path": "https://api.zipnova.com.xx/v2/inventory/skus/SKU-001/movements",
    "per_page": 20,
    "to": 20,
    "total": 100
  }
}

Listar tipos de movimiento de inventario

get

https://api.zipnova.com.ar/v2https://api.zipnova.cl/v2https://api.zipnova.com.mx/v2

/inventory/movement_types

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

Respuestas

200

Lista de tipos de movimiento

application/json

401

No autenticado

application/json

403

Prohibido

application/json

get

/inventory/movement_types

HTTPcURLJavaScriptPython

GET /v2/inventory/movement_types HTTP/1.1
Host: api.zipnova.com.ar
Accept: */*

[
  {
    "code": "adjustment",
    "name": "Ajuste manual"
  }
]