> For the complete documentation index, see [llms.txt](https://docs.zipnova.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zipnova.com/envios/recursos-api/almacenes-e-inventario/almacenes-y-stock.md).

# 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

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

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Almacenes","description":"Gestión de almacenes y bodegas"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}},"schemas":{"Warehouse":{"title":"Warehouse","description":"Definición de un almacén","properties":{"code":{"description":"Código único del almacén","type":"string"},"name":{"description":"Nombre del almacén","type":"string"},"type":{"description":"Tipo de almacén: system (gestionado por Zipnova) o account (propio de la cuenta)","type":"string","enum":["system","account"]},"owner_account_id":{"description":"ID de la cuenta propietaria. Omitido si es un almacén del sistema (type=system).","type":"integer","nullable":true},"enabled_account_ids":{"description":"IDs de las cuentas del usuario autenticado que tienen acceso a este almacén","type":"array","items":{"type":"integer"}},"address_id":{"description":"ID de la dirección física del almacén","type":"integer"}},"type":"object"}}},"paths":{"/warehouses":{"get":{"tags":["Almacenes"],"summary":"Listar almacenes","description":"Obtiene la lista paginada de almacenes disponibles para la cuenta autenticada.","operationId":"8236ca67871c3a9c9686e0fd9bb511dd","parameters":[{"name":"account_id","in":"query","description":"Filtrar almacenes habilitados para una cuenta específica","required":false,"schema":{"type":"integer"}},{"name":"page","in":"query","description":"Número de página (50 resultados por página)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista paginada de almacenes","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Warehouse"}},"links":{"properties":{"first":{"type":"string"},"last":{"type":"string"},"prev":{"type":"string","nullable":true},"next":{"type":"string","nullable":true}},"type":"object"},"meta":{"properties":{"current_page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"last_page":{"type":"integer"}},"type":"object"}},"type":"object"}}}}}}}}}
```

## Obtener un almacén

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

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Almacenes","description":"Gestión de almacenes y bodegas"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}},"schemas":{"DetailedWarehouse":{"title":"DetailedWarehouse","description":"Definición detallada de un almacén","properties":{"code":{"description":"Código único del almacén","type":"string"},"name":{"description":"Nombre del almacén","type":"string"},"type":{"description":"Tipo de almacén: system (gestionado por Zipnova) o account (propio de la cuenta)","type":"string","enum":["system","account"]},"owner_account_id":{"description":"ID de la cuenta propietaria. Null si es un almacén del sistema (type=system).","type":"integer","nullable":true},"enabled_account_ids":{"description":"IDs de las cuentas del usuario autenticado que tienen acceso a este almacén. Solo presente en almacenes de tipo account.","type":"array","items":{"type":"integer"}},"address":{"$ref":"#/components/schemas/Address"},"preparation_cutoff":{"description":"Hora límite de preparación de pedidos del día (formato HH:mm:ss)","type":"string"},"receiving_times":{"description":"Franjas horarias de recepción de mercadería disponibles en este almacén","type":"array","items":{"type":"string"}}},"type":"object"},"Address":{"title":"Dirección de orden","description":"Definición de una dirección utilizada en órdenes y envíos","properties":{"id":{"description":"Identificador","type":"integer"},"name":{"description":"Nombre","type":"string"},"street":{"description":"Calle","type":"string"},"street_number":{"description":"Número","type":"string"},"street_extras":{"description":"Extras (piso, dpto, etc.)","type":"string"},"zipcode":{"description":"Código postal","type":"string"},"phone":{"description":"Teléfono","type":"string"},"email":{"description":"Correo electrónico","type":"string"},"document":{"description":"Documento/CUIT","type":"string"},"city":{"description":"Ciudad/Localidad/Comuna","properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"description":"Provincia/Región/Estado","properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"country":{"description":"País","properties":{"id":{"type":"string"},"name":{"type":"string"}},"type":"object"},"location_latitude":{"description":"Latitud","type":"number"},"location_longitude":{"description":"Longitud","type":"number"},"location_type":{"description":"Tipo de ubicación","type":"string","nullable":true},"location_metadata":{"description":"Metadata de ubicación","type":"string","nullable":true},"is_accurate":{"description":"Indica si la geocodificación es precisa","type":"boolean","nullable":true},"created_at":{"description":"Fecha de creación","type":"string","format":"date-time"},"updated_at":{"description":"Fecha de última actualización","type":"string","format":"date-time"},"confirmed_at":{"description":"Fecha de confirmación de ubicación","type":"string","format":"date-time","nullable":true}},"type":"object"}}},"paths":{"/warehouses/{warehouse}":{"get":{"tags":["Almacenes"],"summary":"Obtener un almacén","description":"Obtiene el detalle de un almacén específico por código o ID.","operationId":"2f33efcd1d00ecda3f16f84ac98b8853","parameters":[{"name":"warehouse","in":"path","description":"Código o ID del almacén","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Detalle del almacén","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetailedWarehouse"}}}},"403":{"description":"Sin acceso al almacén"},"404":{"description":"Almacén no encontrado"}}}}}}
```

## Obtener stock de un almacén

> Obtiene el stock paginado de todos los SKUs de las cuentas autorizadas en un almacén específico.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Almacenes","description":"Gestión de almacenes y bodegas"}],"servers":[{"url":"https://api.zipnova.com.ar/v2","description":"v2 API - Argentina (AR)"},{"url":"https://api.zipnova.cl/v2","description":"v2 API - Chile (CL)"},{"url":"https://api.zipnova.com.mx/v2","description":"v2 API - México (MX)"}],"security":[{"basicAuth":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Autenticación básica HTTP utilizando token como nombre de usuario y secret como contraseña","scheme":"basic"},"bearerAuth":{"type":"http","description":"Token de autenticación Bearer OAuth para API V2","bearerFormat":"OAuth","scheme":"bearer"}},"schemas":{"Stock":{"title":"Stock","description":"Representa el stock de un SKU en un depósito específico, incluyendo cantidades disponibles, asignadas y en espera.","properties":{"sku":{"$ref":"#/components/schemas/SkuBasic"},"warehouse":{"description":"Código del depósito","type":"string"},"qty_available":{"description":"Cantidad disponible para asignar a envíos","type":"integer"},"qty_allocated":{"description":"Cantidad asignada a envíos pendientes","type":"integer"},"qty_total":{"description":"Cantidad total en el depósito (disponible + asignada + en espera)","type":"integer"},"qty_warehouse":{"description":"Cantidad física presente en el depósito","type":"integer"},"qty_on_hold_broken":{"description":"Cantidad retenida por daño","type":"integer"},"qty_on_hold_expiration":{"description":"Cantidad retenida por vencimiento próximo","type":"integer"},"qty_on_hold_for_review":{"description":"Cantidad retenida pendiente de revisión de calidad","type":"integer"},"updated_at":{"description":"Fecha de última actualización del stock","type":"string","format":"date-time"}},"type":"object"},"SkuBasic":{"title":"SkuBasic","description":"Información básica de un SKU","properties":{"sku":{"description":"Código SKU del producto","type":"string"},"internal_sku":{"description":"Código interno del SKU","type":"string"},"account_id":{"description":"ID de la cuenta propietaria del SKU","type":"integer"},"management_type":{"description":"Tipo de gestión del SKU en el almacén","type":"string"}},"type":"object"}}},"paths":{"/warehouses/{warehouse}/stocks":{"get":{"tags":["Almacenes"],"summary":"Obtener stock de un almacén","description":"Obtiene el stock paginado de todos los SKUs de las cuentas autorizadas en un almacén específico.","operationId":"67da8ccdb904b92595221461386fc372","parameters":[{"name":"warehouse","in":"path","description":"Código o ID numérico del almacén","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Número de página (50 resultados por página)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Stock paginado del almacén","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Stock"}},"links":{"properties":{"first":{"type":"string"},"last":{"type":"string"},"prev":{"type":"string","nullable":true},"next":{"type":"string","nullable":true}},"type":"object"},"meta":{"properties":{"current_page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"last_page":{"type":"integer"}},"type":"object"}},"type":"object"}}}},"403":{"description":"Sin acceso al almacén"},"404":{"description":"Almacén no encontrado"}}}}}}
```