> 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/gestion-de-cuentas.md).

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