Almacenes y stock

Tu cuenta puede tener acceso a Almacenes, ya sea para su uso con el servicio de Fulfillment, o para gestionar el stock de productos en tus propias ubicaciones.

Listar almacenes

get

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

/warehouses

Obtiene la lista paginada de almacenes disponibles para la cuenta autenticada.

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 almacenes habilitados para una cuenta específica

Example: 42

pageintegerOpcional

Número de página (50 resultados por página)

Example: 1

Respuestas

200

Lista paginada de almacenes

application/json

get/warehouses

HTTPcURLJavaScriptPython

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

200

Lista paginada de almacenes

{
  "data": [
    {
      "code": "ba-4",
      "name": "BA - Garín",
      "type": "system",
      "owner_account_id": null,
      "enabled_account_ids": [
        2
      ],
      "address_id": 2971
    }
  ],
  "links": {
    "first": "https://api.zipnova.com.ar/v2/warehouses?page=1",
    "last": "https://api.zipnova.com.ar/v2/warehouses?page=3",
    "prev": null,
    "next": "https://api.zipnova.com.ar/v2/warehouses?page=2"
  },
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 120,
    "last_page": 3
  }
}

Obtener un almacén

get

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

/warehouses/{warehouse}

Obtiene el detalle de un almacén específico por código o ID.

Autorizaciones

basicAuthbearerAuth

AuthorizationstringRequerido

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

Parámetros de ruta

warehousestringRequerido

Código o ID del almacén

Respuestas

200

Detalle del almacén

application/json

Definición detallada de un almacén

codestringOpcional

Código único del almacén

Example: ba-4

namestringOpcional

Nombre del almacén

Example: BA - Garín

typestring · enumOpcional

Tipo de almacén: system (gestionado por Zipnova) o account (propio de la cuenta)

Valores posibles:

owner_account_idinteger · nullableOpcional

ID de la cuenta propietaria. Null si es un almacén del sistema (type=system).

enabled_account_idsinteger[]Opcional

IDs de las cuentas del usuario autenticado que tienen acceso a este almacén. Solo presente en almacenes de tipo account.

Example: 2

preparation_cutoffstringOpcional

Hora límite de preparación de pedidos del día (formato HH:mm:ss)

Example: 17:00:00

receiving_timesstring[]Opcional

Franjas horarias de recepción de mercadería disponibles en este almacén

Example: Mañana (9 a 12)

403

Sin acceso al almacén

404

Almacén no encontrado

get/warehouses/{warehouse}

HTTPcURLJavaScriptPython

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

{
  "code": "ba-4",
  "name": "BA - Garín",
  "type": "system",
  "owner_account_id": null,
  "enabled_account_ids": [
    2
  ],
  "address": {
    "id": 2971,
    "name": "Zipnova - Garín",
    "street": "Tierra del Fuego",
    "street_number": "2498",
    "street_extras": "Nave 3 - GoodPark",
    "zipcode": "1619",
    "phone": "[phone]",
    "email": "[e-mail]",
    "document": "30-70835592-1",
    "city": {
      "id": 815,
      "name": "Garín"
    },
    "state": {
      "id": "AR-B",
      "name": "Buenos Aires"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    },
    "location_latitude": -34.4250302,
    "location_longitude": -58.7320621,
    "location_type": null,
    "location_metadata": null,
    "is_accurate": null,
    "created_at": "2020-12-01T18:31:01.000000Z",
    "updated_at": "2020-12-01T18:31:01.000000Z",
    "confirmed_at": null
  },
  "preparation_cutoff": "17:00:00",
  "receiving_times": [
    "Mañana (9 a 12)"
  ]
}

Obtener stock de un almacén

get

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

/warehouses/{warehouse}/stocks

Obtiene el stock paginado de todos los SKUs de las cuentas autorizadas en un almacén 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

warehousestringRequerido

Código o ID numérico del almacén

Example: ba-4

Parámetros de consulta

pageintegerOpcional

Número de página (50 resultados por página)

Example: 1

Respuestas

200

Stock paginado del almacén

application/json

403

Sin acceso al almacén

404

Almacén no encontrado

get/warehouses/{warehouse}/stocks

HTTPcURLJavaScriptPython

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

{
  "data": [
    {
      "sku": {
        "sku": "SKU-001",
        "internal_sku": "INT-001",
        "account_id": 42,
        "management_type": "units"
      },
      "warehouse": "AR-GBA-01",
      "qty_available": 100,
      "qty_allocated": 5,
      "qty_total": 110,
      "qty_warehouse": 110,
      "qty_on_hold_broken": 2,
      "qty_on_hold_expiration": 0,
      "qty_on_hold_for_review": 3,
      "updated_at": "2024-03-15T09:30:00-03:00"
    }
  ],
  "links": {
    "first": "https://api.zipnova.com.ar/v2/warehouses/ba-4/stocks?page=1",
    "last": "https://api.zipnova.com.ar/v2/warehouses/ba-4/stocks?page=5",
    "prev": null,
    "next": "https://api.zipnova.com.ar/v2/warehouses/ba-4/stocks?page=2"
  },
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 230,
    "last_page": 5
  }
}