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.

Listado de almacenes

GET /v2/warehouses

Obtiene un listado de almacenes a los que tienes acceso, tanto los de Zipnova como los de tu propia cuenta.

Response

200

{
	"data": [
		{
			"code": "wh-xxxs-6",
			"name": "Santiago 1",
			"type": "account",
			"owner_account_id": 1952,
			"enabled_account_ids": [
				1952
			],
			"address_id": 37073
		},
		{
			"code": "wh-xxxs-5",
			"name": "Colina",
			"type": "account",
			"owner_account_id": 1952,
			"enabled_account_ids": [
				1952
			],
			"address_id": 3702
		},
		{
			"code": "ba-9",
			"name": "BA - Reconquista",
			"type": "system",
			"owner_account_id": null,
			"enabled_account_ids": [
				1952
			],
			"address_id": 330093
		}
	],
	"links": {
		"first": "https://api.zipnova.com.ar/v2/warehouses?page=1",
		"last": "https://api.zipnova.com.ar/v2/warehouses?page=1",
		"prev": null,
		"next": null
	},
	"meta": {
		"current_page": 1,
		"from": 1,
		"last_page": 1,
		"links": [
			{
				"url": null,
				"label": "« Previous",
				"active": false
			},
			{
				"url": "https://api.zipnova.com.ar/v2/warehouses?page=1",
				"label": "1",
				"active": true
			},
			{
				"url": null,
				"label": "Next »",
				"active": false
			}
		],
		"path": "https://api.zipnova.com.ar/v2/warehouses",
		"per_page": 50,
		"to": 3,
		"total": 3
	}
}

Detalle de almacén

GET /v2/warehouses/{code}

Obtiene un detalle de un almacén determinado

Response

200

{
	"code": "ba-9",
	"name": "BA - Reconquista",
	"type": "system",
	"owner_account_id": null,
	"address": {
		"id": 330093,
		"saved_address_id": null,
		"name": "Zipnova - Reconquista",
		"street": "Martin de Gainza",
		"street_number": "2500",
		"street_extras": "Parque Industrial Reconquista",
		"zipcode": "1736",
		"phone": "000000",
		"email": "[email protected]",
		"document": "30-71614257-0",
		"city": {
			"id": 1875,
			"name": "Trujui"
		},
		"state": {
			"id": "AR-B",
			"name": "Buenos Aires"
		},
		"country": {
			"id": "AR",
			"name": "Argentina"
		},
		"location_latitude": -34.6141805,
		"location_longitude": -58.7339999,
		"location_type": null,
		"location_metadata": null,
		"is_accurate": null,
		"created_at": "2023-09-01T17:12:18.000000Z",
		"updated_at": "2025-09-28T02:31:14.000000Z",
		"confirmed_at": "2023-09-01T17:12:18.000000Z"
	},
	"preparation_cutoff": "2025-10-03T17:00:00.000000Z",
	"receiving_times": null
}

Stock en almacenes

GET /v2/warehouses/{code}/stocks

Obtiene un detalle de stocks de tu cuenta en un almacén determinado.

Response

200

{
	"data": [
		{
			"sku": {
				"sku": "X42847G4.1",
				"internal_sku": "XXX9530612",
				"account_id": 12345,
				"management_type": null
			},
			"warehouse": "ba-9",
			"qty_available": 306,
			"qty_allocated": 0,
			"qty_total": 309,
			"qty_warehouse": 309,
			"qty_on_hold_broken": 0,
			"qty_on_hold_expiration": 0,
			"qty_on_hold_for_review": 3,
			"updated_at": "2025-10-03T13:47:43.000000Z"
		},
		{
			"sku": {
				"sku": "X4284R4.2",
				"internal_sku": "XXX9530613",
				"account_id": 12345,
				"management_type": null
			},
			"warehouse": "ba-9",
			"qty_available": 310,
			"qty_allocated": 0,
			"qty_total": 310,
			"qty_warehouse": 310,
			"qty_on_hold_broken": 0,
			"qty_on_hold_expiration": 0,
			"qty_on_hold_for_review": 0,
			"updated_at": "2025-10-03T13:47:43.000000Z"
		},
		{
			"sku": {
				"sku": "X52315Z1",
				"internal_sku": "XXX9530614",
				"account_id": 12345,
				"management_type": null
			},
			"warehouse": "ba-9",
			"qty_available": 936,
			"qty_allocated": 1,
			"qty_total": 946,
			"qty_warehouse": 946,
			"qty_on_hold_broken": 0,
			"qty_on_hold_expiration": 0,
			"qty_on_hold_for_review": 9,
			"updated_at": "2025-10-03T13:54:53.000000Z"
		},
		{
			"sku": {
				"sku": "X42905Z4.1",
				"internal_sku": "XXX9530615",
				"account_id": 12345,
				"management_type": null
			},
			"warehouse": "ba-9",
			"qty_available": 96,
			"qty_allocated": 0,
			"qty_total": 96,
			"qty_warehouse": 96,
			"qty_on_hold_broken": 0,
			"qty_on_hold_expiration": 0,
			"qty_on_hold_for_review": 0,
			"updated_at": "2025-10-02T19:30:22.000000Z"
		}
	],
	"links": {
		"first": "https://api.zipnova.com.ar/v2/warehouses/ba-9/stocks?page=1",
		"last": "https://api.zipnova.com.ar/v2/warehouses/ba-9/stocks?page=3",
		"prev": null,
		"next": "https://api.zipnova.com.ar/v2/warehouses/ba-9/stocks?page=2"
	},
	"meta": {
		"current_page": 1,
		"from": 1,
		"last_page": 3,
		"links": [
			{
				"url": null,
				"label": "« Previous",
				"active": false
			},
			{
				"url": "https://api.zipnova.com.ar/v2/warehouses/ba-9/stocks?page=1",
				"label": "1",
				"active": true
			},
			{
				"url": "https://api.zipnova.com.ar/v2/warehouses/ba-9/stocks?page=2",
				"label": "2",
				"active": false
			},
			{
				"url": "https://api.zipnova.com.ar/v2/warehouses/ba-9/stocks?page=3",
				"label": "3",
				"active": false
			},
			{
				"url": "https://api.zipnova.com.ar/v2/warehouses/ba-9/stocks?page=2",
				"label": "Next »",
				"active": false
			}
		],
		"path": "https://api.zipnova.com.ar/v2/warehouses/ba-9/stocks",
		"per_page": 50,
		"to": 50,
		"total": 128
	}
}