# Direcciones

La API Addresses es un sistema flexible basado en tipos. Cada dirección tiene un campo `type` que determina su ámbito y propósito; los mismos endpoints gestionan todos los tipos.

## Tipos de dirección

| Tipo | Ámbito | Descripción |
|---|---|---|
| `shipping_address` | Por usuario | Dirección personal de entrega del cliente |
| `billing_address` | Por usuario | Dirección de facturación del cliente |
| `storage_hub` | Todo el tenant | Punto de recogida, almacén, sucursal u otro lugar de recogida compartido |

> **`storage_hub` es un tipo especial:** pertenece al tenant, no a un usuario. Cualquier cliente puede obtener todos los centros de almacenamiento sin iniciar sesión. Úsalo para recogidas en tienda, listados de almacenes, puntos de entrega o ubicaciones físicas que gestione tu negocio.

## Qué puedes crear con `storage_hub`

- **Compra y recogida** — mostrar sucursales como puntos de recogida durante el pago
- **Red de almacenes** — ofrecer centros de despacho para logística o procesos B2B
- **Tiendas de revendedores** — permitir que los vendedores registren su tienda como punto de recogida
- **Red de entrega** — ofrecer ubicaciones de terceros o franquicias

Consulta la guía completa de [centros de almacenamiento](/es/addresses/storage-hubs).

## Objeto dirección

| Campo | Tipo | Descripción |
|---|---|---|
| `id` | integer | Identificador único de la dirección |
| `name` | string | Nombre del contacto o de la ubicación |
| `phone_number` | string | Número de teléfono de contacto |
| `address_line_1` | string | Dirección postal |
| `address_line_2` | string | Apartamento, planta o edificio |
| `city` | string | Ciudad |
| `state` | string | Estado o región |
| `post_code` | string | Código postal |
| `country` | string | Nombre del país |
| `country_code` | string | Código de país ISO |
| `landmark` | string | Punto de referencia o indicaciones cercanas |
| `formatted_address` | string | Dirección completa para mostrar |
| `type` | string | Tipo de dirección; consulta la tabla anterior |
| `current_address` | boolean | Indica si es la dirección seleccionada actualmente por el usuario (solo para tipos asociados a usuarios) |
| `coordinates.latitude` | number | Latitud GPS |
| `coordinates.longitude` | number | Longitud GPS |