# Ubicaciones de cuenta

Una cuenta puede crear ubicaciones que pueden tener distintos usos. Todo parte de una dirección guardada, y sus usos incluyen:

* Pueden ser usados como **origen de envíos** (o destino de devoluciones)
* Pueden ser usados como **almacenes propios** de la cuenta, y poder gestionar stock de sus productos.
* Pueden habilitarse como **puntos de entrega de envíos.**

## Ubicaciones como orígenes de envío

A la hora de crear un envío es obligatorio indicar el origen del mismo. Los orígenes se dan de alta en la cuenta de cada vendedor.

## Listar direcciones

> Obtiene un listado paginado de las ubicaciones de de la cuenta.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Direcciones","description":"Gestión de direcciones guardadas"}],"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":{"SavedAddressResource":{"title":"Dirección guardada","properties":{"id":{"type":"integer"},"name":{"type":"string"},"document":{"type":"string","nullable":true},"street":{"type":"string"},"street_number":{"type":"string"},"street_extras":{"type":"string","nullable":true},"city":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"zipcode":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"hours":{"properties":{"open":{"type":"string","nullable":true},"close":{"type":"string","nullable":true}},"type":"object"},"use_for_shipping":{"type":"boolean"},"default_logistic_type":{"type":"string","nullable":true},"logistic_types":{"type":"array","items":{"type":"string"}},"accounts":{"description":"Cuentas asociadas con sus opciones de configuración","type":"array","items":{"properties":{"id":{"type":"integer"},"name":{"type":"string"},"options":{"properties":{"automatic_pickup":{"type":"boolean"},"automatic_status_change":{"type":"boolean"},"pickup_days":{"description":"0=Domingo, 6=Sábado","type":"array","items":{"type":"string"}},"use_preparation_time":{"type":"boolean"},"preparation_time":{"type":"integer","nullable":true},"use_for_shipping":{"type":"boolean"}},"type":"object"}},"type":"object"}}},"type":"object"}}},"paths":{"/addresses":{"get":{"tags":["Direcciones"],"summary":"Listar direcciones","description":"Obtiene un listado paginado de las ubicaciones de de la cuenta.","operationId":"1a96b192d00c18e56d22e8d998de8c74","parameters":[{"name":"account_id","in":"query","description":"Filtrar por ID de cuenta","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista paginada de direcciones guardadas","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SavedAddressResource"}},"links":{"type":"object"},"meta":{"type":"object"}},"type":"object"}}}}}}}}}
```

## Obtener una dirección

> Obtiene el detalle de una dirección de origen por ID.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Direcciones","description":"Gestión de direcciones guardadas"}],"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":{"SavedAddressResource":{"title":"Dirección guardada","properties":{"id":{"type":"integer"},"name":{"type":"string"},"document":{"type":"string","nullable":true},"street":{"type":"string"},"street_number":{"type":"string"},"street_extras":{"type":"string","nullable":true},"city":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"zipcode":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"hours":{"properties":{"open":{"type":"string","nullable":true},"close":{"type":"string","nullable":true}},"type":"object"},"use_for_shipping":{"type":"boolean"},"default_logistic_type":{"type":"string","nullable":true},"logistic_types":{"type":"array","items":{"type":"string"}},"accounts":{"description":"Cuentas asociadas con sus opciones de configuración","type":"array","items":{"properties":{"id":{"type":"integer"},"name":{"type":"string"},"options":{"properties":{"automatic_pickup":{"type":"boolean"},"automatic_status_change":{"type":"boolean"},"pickup_days":{"description":"0=Domingo, 6=Sábado","type":"array","items":{"type":"string"}},"use_preparation_time":{"type":"boolean"},"preparation_time":{"type":"integer","nullable":true},"use_for_shipping":{"type":"boolean"}},"type":"object"}},"type":"object"}}},"type":"object"}}},"paths":{"/addresses/{id}":{"get":{"tags":["Direcciones"],"summary":"Obtener una dirección","description":"Obtiene el detalle de una dirección de origen por ID.","operationId":"6affe96cb8b5431d79c2ce854ceec2e8","parameters":[{"name":"id","in":"path","description":"ID de la dirección","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Detalle de la dirección","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedAddressResource"}}}},"403":{"description":"Sin acceso a esta dirección"},"404":{"description":"Dirección no encontrada"}}}}}}
```

## Crear dirección

> Crea una nueva dirección de origen en la libreta de contactos para una cuenta.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Direcciones","description":"Gestión de direcciones guardadas"}],"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":{"SavedAddressResource":{"title":"Dirección guardada","properties":{"id":{"type":"integer"},"name":{"type":"string"},"document":{"type":"string","nullable":true},"street":{"type":"string"},"street_number":{"type":"string"},"street_extras":{"type":"string","nullable":true},"city":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"zipcode":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"hours":{"properties":{"open":{"type":"string","nullable":true},"close":{"type":"string","nullable":true}},"type":"object"},"use_for_shipping":{"type":"boolean"},"default_logistic_type":{"type":"string","nullable":true},"logistic_types":{"type":"array","items":{"type":"string"}},"accounts":{"description":"Cuentas asociadas con sus opciones de configuración","type":"array","items":{"properties":{"id":{"type":"integer"},"name":{"type":"string"},"options":{"properties":{"automatic_pickup":{"type":"boolean"},"automatic_status_change":{"type":"boolean"},"pickup_days":{"description":"0=Domingo, 6=Sábado","type":"array","items":{"type":"string"}},"use_preparation_time":{"type":"boolean"},"preparation_time":{"type":"integer","nullable":true},"use_for_shipping":{"type":"boolean"}},"type":"object"}},"type":"object"}}},"type":"object"}}},"paths":{"/addresses":{"post":{"tags":["Direcciones"],"summary":"Crear dirección","description":"Crea una nueva dirección de origen en la libreta de contactos para una cuenta.","operationId":"01de3ff8415cd0efbfceb653462591a4","requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["account_id","name","document","email","phone","street","street_number","zipcode"],"properties":{"account_id":{"description":"ID de la cuenta","type":"integer"},"name":{"description":"Nombre del contacto (máx 50)","type":"string"},"document":{"description":"Número de documento/CUIT (máx 50)","type":"string"},"email":{"description":"Email (máx 150)","type":"string","format":"email"},"phone":{"description":"Teléfono (máx 50)","type":"string"},"street":{"description":"Calle (máx 50)","type":"string"},"street_number":{"description":"Número (máx 10)","type":"string"},"street_extras":{"description":"Piso, depto, etc. (máx 190)","type":"string"},"city_id":{"description":"ID de ciudad del sistema (alternativa a city+state+zipcode)","type":"integer"},"city":{"description":"Nombre de ciudad (requerido si no se envía city_id)","type":"string"},"state":{"description":"Nombre de provincia/estado (requerido si no se envía city_id)","type":"string"},"zipcode":{"description":"Código postal (máx 5)","type":"string"},"hours":{"description":"Horario de atención","properties":{"open":{"description":"Hora de apertura (máx 7 chars)","type":"string"},"close":{"description":"Hora de cierre (máx 7 chars)","type":"string"}},"type":"object"},"default_logistic_type":{"description":"Tipo logístico por defecto","type":"string"},"logistic_types":{"description":"Tipos logísticos habilitados para esta dirección","type":"array","items":{"type":"string"}},"options":{"description":"Opciones de recolección","properties":{"automatic_pickup":{"description":"Solicitar recolección automáticamente al crear envíos","type":"boolean"},"automatic_status_change":{"description":"Cambiar estado automáticamente al confirmar recolección","type":"boolean"},"pickup_days":{"description":"Días disponibles para recolección (0=Domingo, 6=Sábado)","type":"array","items":{"type":"integer"}},"use_preparation_time":{"description":"Usar tiempo de preparación para calcular fecha de despacho","type":"boolean"},"preparation_time":{"description":"Tiempo de preparación en minutos","type":"integer"},"use_for_shipping":{"description":"Habilitar como dirección de despacho","type":"boolean"}},"type":"object"}},"type":"object"}}}},"responses":{"201":{"description":"Dirección creada exitosamente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedAddressResource"}}}},"400":{"description":"Datos inválidos o ciudad no encontrada"},"403":{"description":"Sin permiso para crear direcciones en esta cuenta"}}}}}}
```

## Actualizar una dirección

> Actualiza los datos de una dirección de origen. Si la dirección ya está asociada a envíos, los campos de ubicación (calle, ciudad, etc.) no pueden modificarse.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Direcciones","description":"Gestión de direcciones guardadas"}],"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":{"SavedAddressResource":{"title":"Dirección guardada","properties":{"id":{"type":"integer"},"name":{"type":"string"},"document":{"type":"string","nullable":true},"street":{"type":"string"},"street_number":{"type":"string"},"street_extras":{"type":"string","nullable":true},"city":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"zipcode":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"hours":{"properties":{"open":{"type":"string","nullable":true},"close":{"type":"string","nullable":true}},"type":"object"},"use_for_shipping":{"type":"boolean"},"default_logistic_type":{"type":"string","nullable":true},"logistic_types":{"type":"array","items":{"type":"string"}},"accounts":{"description":"Cuentas asociadas con sus opciones de configuración","type":"array","items":{"properties":{"id":{"type":"integer"},"name":{"type":"string"},"options":{"properties":{"automatic_pickup":{"type":"boolean"},"automatic_status_change":{"type":"boolean"},"pickup_days":{"description":"0=Domingo, 6=Sábado","type":"array","items":{"type":"string"}},"use_preparation_time":{"type":"boolean"},"preparation_time":{"type":"integer","nullable":true},"use_for_shipping":{"type":"boolean"}},"type":"object"}},"type":"object"}}},"type":"object"}}},"paths":{"/addresses/{id}":{"put":{"tags":["Direcciones"],"summary":"Actualizar una dirección","description":"Actualiza los datos de una dirección de origen. Si la dirección ya está asociada a envíos, los campos de ubicación (calle, ciudad, etc.) no pueden modificarse.","operationId":"5d0358f950969672ed06d90475e4288f","parameters":[{"name":"id","in":"path","description":"ID de la dirección","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["account_id"],"properties":{"account_id":{"description":"ID de la cuenta","type":"integer"},"name":{"description":"Nombre del contacto (máx 50)","type":"string"},"document":{"description":"Número de documento/CUIT (máx 50)","type":"string"},"email":{"description":"Email (máx 150)","type":"string","format":"email"},"phone":{"description":"Teléfono (máx 50)","type":"string"},"street":{"description":"Calle — no editable si la dirección tiene envíos (máx 50)","type":"string"},"street_number":{"description":"Número — no editable si la dirección tiene envíos (máx 10)","type":"string"},"street_extras":{"description":"Piso, depto — no editable si tiene envíos (máx 190)","type":"string"},"city_id":{"description":"ID de ciudad — no editable si tiene envíos","type":"integer"},"city":{"description":"Nombre de ciudad — no editable si tiene envíos","type":"string"},"state":{"description":"Nombre de provincia — no editable si tiene envíos","type":"string"},"zipcode":{"description":"Código postal — no editable si tiene envíos (máx 10)","type":"string"},"hours":{"properties":{"open":{"type":"string"},"close":{"type":"string"}},"type":"object"},"default_logistic_type":{"type":"string"},"logistic_types":{"type":"array","items":{"type":"string"}},"options":{"properties":{"automatic_pickup":{"type":"boolean"},"automatic_status_change":{"type":"boolean"},"pickup_days":{"description":"0=Domingo, 6=Sábado","type":"array","items":{"type":"integer"}},"use_preparation_time":{"type":"boolean"},"preparation_time":{"type":"integer"},"use_for_shipping":{"type":"boolean"}},"type":"object"}},"type":"object"}}}},"responses":{"200":{"description":"Dirección actualizada exitosamente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedAddressResource"}}}},"400":{"description":"Datos inválidos o intento de editar campos protegidos"},"403":{"description":"Sin permiso para editar esta dirección"},"404":{"description":"Dirección no encontrada"}}}}}}
```


---

# 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/cuentas-y-origenes/ubicaciones-de-cuenta.md?ask=<question>
```

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.