# 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"}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.zipnova.com/envios/recursos-api/almacenes-e-inventario/almacenes-y-stock.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.