# Gestión de Cuentas

## Listar cuentas

> Obtiene la lista paginada de cuentas accesibles por el usuario autenticado.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Cuentas","description":"Gestión de cuentas y configuraciones"}],"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":{"AccountApiResource":{"title":"Cuenta","properties":{"id":{"type":"integer"},"name":{"type":"string"},"logo":{"description":"URL del logo","type":"string","nullable":true},"company_name":{"type":"string"},"address":{"properties":{"address":{"type":"string"},"city":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"type":"string"},"zipcode":{"type":"string"}},"type":"object"},"national_tax_id":{"properties":{"number":{"type":"string"},"type":{"type":"string"}},"type":"object"},"state_tax_id":{"type":"string","nullable":true},"tax_category":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string","nullable":true},"contacts":{"properties":{"operations":{"properties":{"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true}},"type":"object","nullable":true},"administrative":{"properties":{"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true}},"type":"object","nullable":true}},"type":"object"}},"type":"object"}}},"paths":{"/accounts":{"get":{"tags":["Cuentas"],"summary":"Listar cuentas","description":"Obtiene la lista paginada de cuentas accesibles por el usuario autenticado.","operationId":"fdb900465f681a55e87b91bd5eb9d946","responses":{"200":{"description":"Lista paginada de cuentas","content":{"application/json":{"schema":{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AccountApiResource"}},"links":{"type":"object"},"meta":{"type":"object"}},"type":"object"}}}}}}}}}
```

## Obtener una cuenta

> Obtiene el detalle de una cuenta específica.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Cuentas","description":"Gestión de cuentas y configuraciones"}],"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":{"AccountApiResource":{"title":"Cuenta","properties":{"id":{"type":"integer"},"name":{"type":"string"},"logo":{"description":"URL del logo","type":"string","nullable":true},"company_name":{"type":"string"},"address":{"properties":{"address":{"type":"string"},"city":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"type":"string"},"zipcode":{"type":"string"}},"type":"object"},"national_tax_id":{"properties":{"number":{"type":"string"},"type":{"type":"string"}},"type":"object"},"state_tax_id":{"type":"string","nullable":true},"tax_category":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string","nullable":true},"contacts":{"properties":{"operations":{"properties":{"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true}},"type":"object","nullable":true},"administrative":{"properties":{"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true}},"type":"object","nullable":true}},"type":"object"}},"type":"object"}}},"paths":{"/accounts/{id}":{"get":{"tags":["Cuentas"],"summary":"Obtener una cuenta","description":"Obtiene el detalle de una cuenta específica.","operationId":"504008c1ea9cebbd81933a02788021d7","parameters":[{"name":"id","in":"path","description":"ID de la cuenta","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Detalle de la cuenta","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountApiResource"}}}},"403":{"description":"Sin acceso a esta cuenta"},"404":{"description":"Cuenta no encontrada"}}}}}}
```

## Actualizar cuenta

> Actualiza los datos de una cuenta existente.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Cuentas","description":"Gestión de cuentas y configuraciones"}],"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":{"AccountApiResource":{"title":"Cuenta","properties":{"id":{"type":"integer"},"name":{"type":"string"},"logo":{"description":"URL del logo","type":"string","nullable":true},"company_name":{"type":"string"},"address":{"properties":{"address":{"type":"string"},"city":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"state":{"type":"string"},"zipcode":{"type":"string"}},"type":"object"},"national_tax_id":{"properties":{"number":{"type":"string"},"type":{"type":"string"}},"type":"object"},"state_tax_id":{"type":"string","nullable":true},"tax_category":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string","nullable":true},"contacts":{"properties":{"operations":{"properties":{"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true}},"type":"object","nullable":true},"administrative":{"properties":{"name":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true}},"type":"object","nullable":true}},"type":"object"}},"type":"object"}}},"paths":{"/accounts/{id}":{"put":{"tags":["Cuentas"],"summary":"Actualizar cuenta","description":"Actualiza los datos de una cuenta existente.","operationId":"73d99e93a8a6762951bf0e55921c3ed8","parameters":[{"name":"id","in":"path","description":"ID de la cuenta","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Nombre de la cuenta","type":"string"},"email":{"description":"Email principal","type":"string","format":"email"},"phone":{"description":"Teléfono","type":"string"},"logo":{"description":"URL pública del logo (se descarga y almacena)","type":"string","format":"url"},"website":{"description":"Sitio web","type":"string","format":"url"},"address":{"description":"Todos los campos de dirección deben enviarse juntos","properties":{"address":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zipcode":{"type":"string"}},"type":"object"},"contacts":{"description":"Los tres campos de cada contacto deben enviarse juntos","properties":{"operations":{"properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string"}},"type":"object"},"administrative":{"properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string"}},"type":"object"}},"type":"object"}},"type":"object"}}}},"responses":{"200":{"description":"Cuenta actualizada exitosamente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountApiResource"}}}},"400":{"description":"Datos inválidos"},"403":{"description":"Sin acceso a esta cuenta"},"404":{"description":"Cuenta no encontrada"},"500":{"description":"Error al actualizar la cuenta"}}}}}}
```

## Obtener configuración de cuenta

> Obtiene la configuración de notificaciones y direcciones por defecto de una cuenta.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Cuentas","description":"Gestión de cuentas y configuraciones"}],"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"}}},"paths":{"/accounts/{id}/settings":{"get":{"tags":["Cuentas"],"summary":"Obtener configuración de cuenta","description":"Obtiene la configuración de notificaciones y direcciones por defecto de una cuenta.","operationId":"8d65574fc8a3a83c15c4d9bcff20c814","parameters":[{"name":"id","in":"path","description":"ID de la cuenta","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Configuración de la cuenta","content":{"application/json":{"schema":{"properties":{"account_id":{"type":"integer"},"recipient_notifications":{"properties":{"shipment_created":{"type":"boolean"},"shipment_shipped":{"type":"boolean"},"shipment_ready_for_pickup":{"type":"boolean"},"shipment_delivery_date_changed":{"type":"boolean"}},"type":"object"},"default_forward_address_id":{"type":"integer","nullable":true},"default_return_address_id":{"type":"integer","nullable":true}},"type":"object"}}}},"403":{"description":"Sin acceso a esta cuenta"},"404":{"description":"Cuenta no encontrada"}}}}}}
```

## Actualizar configuración de cuenta

> Actualiza las notificaciones a destinatarios y las direcciones por defecto de una cuenta.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Cuentas","description":"Gestión de cuentas y configuraciones"}],"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"}}},"paths":{"/accounts/{id}/settings":{"put":{"tags":["Cuentas"],"summary":"Actualizar configuración de cuenta","description":"Actualiza las notificaciones a destinatarios y las direcciones por defecto de una cuenta.","operationId":"fd66cad89c1e0081d9a5a3a4087e66f6","parameters":[{"name":"id","in":"path","description":"ID de la cuenta","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"recipient_notifications":{"properties":{"shipment_created":{"type":"boolean"},"shipment_shipped":{"type":"boolean"},"shipment_ready_for_pickup":{"type":"boolean"},"shipment_delivery_date_changed":{"type":"boolean"}},"type":"object"},"default_forward_address_id":{"description":"ID de dirección de despacho por defecto","type":"integer"},"default_return_address_id":{"description":"ID de dirección de devolución por defecto","type":"integer"}},"type":"object"}}}},"responses":{"200":{"description":"Configuración actualizada. Retorna el mismo objeto que GET /accounts/{id}/settings","content":{"application/json":{"schema":{"properties":{"account_id":{"type":"integer"},"recipient_notifications":{"properties":{"shipment_created":{"type":"boolean"},"shipment_shipped":{"type":"boolean"},"shipment_ready_for_pickup":{"type":"boolean"},"shipment_delivery_date_changed":{"type":"boolean"}},"type":"object"},"default_forward_address_id":{"type":"integer","nullable":true},"default_return_address_id":{"type":"integer","nullable":true}},"type":"object"}}}},"400":{"description":"Datos inválidos o dirección no pertenece a la cuenta"},"403":{"description":"Sin acceso a esta cuenta"},"404":{"description":"Cuenta no encontrada"}}}}}}
```

## Resumen de facturación

> Obtiene el resumen de balance y límite de crédito de una cuenta.

```json
{"openapi":"3.0.0","info":{"title":"Zipnova Shipping API V2","version":"2.0.0"},"tags":[{"name":"Cuentas","description":"Gestión de cuentas y configuraciones"}],"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"}}},"paths":{"/accounts/{id}/billing":{"get":{"tags":["Cuentas"],"summary":"Resumen de facturación","description":"Obtiene el resumen de balance y límite de crédito de una cuenta.","operationId":"47ffc0eca6d49da07e61c0af93e2454b","parameters":[{"name":"id","in":"path","description":"ID de la cuenta","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Resumen de facturación","content":{"application/json":{"schema":{"properties":{"account_id":{"type":"integer"},"balance":{"description":"Balance actual (deuda)","type":"number"},"credit_limit":{"description":"Límite de crédito","type":"number"},"credit_limit_currency":{"type":"string"},"available":{"description":"Crédito disponible","type":"number"}},"type":"object"}}}},"403":{"description":"Sin acceso a esta cuenta"},"404":{"description":"Cuenta 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/gestion-de-cuentas.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.