> 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/cuentas-y-origenes/ubicaciones-de-cuenta.md).

# 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"}}}}}}
```