SKUs

Listado de SKUs

En este endpoint podrás obtener un listado de SKUS y sus totales de inventario.

GET /inventory/search
Parámetros GET disponibles:
account_id int Filtrar por cuenta account_id=50
sku string Filtro por código de SKU sku=DIS4BL
barcode string Filtro por código de barras barcode=7712123990034
classification int Filtro por ID de clasificación classification=1. (Ej. 1=General, 2=Colchones)

Atención: Ver detalle de un SKU para una explicación de cada atributo de un SKU.

Ejemplo:

GET https://api.zippin.com.ar/v2/inventory/search

RESPONSE 200

{
    "data": [
        {
            "id": 9796,
            "account_id": 47,
            "internal_sku": "SOC0009796",
            "sku": "PATAX5RECTA",
            "barcode": "sd",
            "name": "Juego de patas X5 recta",
            "classification_id": 1,
            "attributes": {
                "unit_declared_value": 100,
                "weight": 2000,
                "length": 10,
                "width": 10,
                "height": 10
            },
            "total_qty_available": 97,
            "stocks": [
                {
                    "warehouse": "ba-2",
                    "qty_available": 97,
                    "qty_allocated": 0,
                    "qty_total": 97
                }
            ]
        },
        {
            "id": 9797,
            "account_id": 47,
            "internal_sku": "SOC0009797",
            "sku": "PAMAD",
            "barcode": "sd",
            "name": "Juego de patas X6 conica",
            "classification_id": 1,
            "attributes": {
                "unit_declared_value": 100,
                "weight": 900,
                "length": 10,
                "width": 20,
                "height": 8
            },
            "total_qty_available": 44,
            "stocks": [
                {
                    "warehouse": "ba-2",
                    "qty_available": 44,
                    "qty_allocated": 0,
                    "qty_total": 44
                }
            ]
        }
    ],
    "links": {
        "first": "https://api.zippin.com.ar/v2/inventory/search?account_id=47&page=1",
        "last": "https://api.zippin.com.ar/v2/inventory/search?account_id=47&page=2",
        "prev": null,
        "next": "https://api.zippin.com.ar/v2/inventory/search?account_id=47&page=2"
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 2,
        "path": "https://api.zippin.com.ar/v2/inventory/search",
        "per_page": "40",
        "to": 40,
        "total": 75
    }
}

Detalle de un SKU

En este endpoint podrás obtener un detalle completo de los datos de un SKU y sus cantidades almacenadas.

GET /inventory/{sku_id}
sku_id int ID de SKU
Descripción de los atributos del SKU.
account_id int ID de Cuenta
internal_sku string ID del SKU en el almacén
sku string Código del SKU para el seller
barcode string Código de barras del SKU (EAN, ISBN, UPC)
name string Nombre del SKU
classification_id int ID de clasificación
unit_declared_value float Valor monetario de una unidad de SKU
width|length|height int Dimensiones del SKU en centímetros
weight int Peso del SKU en gramos
total_qty_available int Cantidad disponible para nuevas ordenes en todos los almacenes
stocks array Array con datos valores de inventario por cada almacén
warehouse string Código del almacén
qty_available int Cantidad disponible para nuevas ordenes en un almacén
qty_allocated int Cantidad reservada en ordenes no despachadas en un almacén.
qty_total int Total de inventario almacenado.

Ejemplo:

GET https://api.zippin.com.ar/v2/inventory/9737

RESPONSE 200

{
    "id": 9737,
    "account_id": 47,
    "internal_sku": "SOC0009737",
    "sku": "137006",
    "barcode": "7796442057939",
    "name": "Colchón de espuma 160x200",
    "classification_id": 2,
    "attributes": {
        "unit_declared_value": 2000,
        "weight": 40000,
        "length": 200,
        "width": 160,
        "height": 25
    },
    "total_qty_available": 10,
    "stocks": [
        {
            "warehouse": "ba-2",
            "qty_available": 10,
            "qty_allocated": 0,
            "qty_total": 10
        }
    ]
}

Movimientos de almacén

Este endpoint permite obtener los movimientos de inventario para un SKU y almacén determinados.

GET /inventory/{sku_id}/movements
sku_id int ID del SKU
Filtros en el query string:
warehouse string Código del almacén. Ejemplo ba-2
date_from date Fecha de inicio para el filtrado de movimientos. Ej. 2019-09-01. Por default es 180 días atrás.
date_to date Fecha de fin para el filtrado de movimientos. Ej. 2019-09-30. Por default es hoy.

Ejemplo:

GET https://api.zippin.com.ar/v2/inventory/9737/movements?warehouse=ba-2

RESPONSE 200
{
    "data": [
        {
            "id": 882,
            "created_at": "2019-11-27T11:52:19+0000",
            "sku": {
                "id": 9737,
                "sku": "137006",
                "internal_sku": "SOC0009737",
                "account_id": 47
            },
            "warehouse": "ba-2",
            "movement": {
                "qty_changed": 7,
                "type": "IN",
                "reason": "Ingreso por recepcion",
                "comments": null
            }
        },
        {
            "id": 861,
            "created_at": "2019-11-27T11:51:58+0000",
            "sku": {
                "id": 9737,
                "sku": "137006",
                "internal_sku": "SOC0009737",
                "account_id": 47
            },
            "warehouse": "ba-2",
            "movement": {
                "qty_changed": 3,
                "type": "IN",
                "reason": "Ingreso por recepcion",
                "comments": null
            }
        }
    ],
    "links": {
        "first": "https://api.zippin.com.ar/v2/inventory/9737/movements?warehouse=ba-2&page=1",
        "last": "https://api.zippin.com.ar/v2/inventory/9737/movements?warehouse=ba-2&page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.zippin.com.ar/v2/inventory/9737/movements",
        "per_page": 20,
        "to": 2,
        "total": 2
    }
}