> ## Documentation Index
> Fetch the complete documentation index at: https://developers.paycode.com.mx/llms.txt
> Use this file to discover all available pages before exploring further.

# Zonas y Sucursales

Las zonas agrupan sucursales bajo una misma región geográfica o administrativa. Primero debes crear una zona y luego asociar sucursales a ella usando el `zone_code`.

***

## Obtener zonas

**Método:** `GET` **Endpoint:** `/Api/v2/regiones/obtener_regiones`

**Header requerido:** `Authorization: Bearer {token}`

***

## Crear zona

**Método:** `POST` **Endpoint:** `/Api/v2/regiones/crear_region`

**Header requerido:** `Authorization: Bearer {token}`

**Ejemplo de request:**

```json theme={null}
{
  "zones": [
    {
      "name": "Zona Norte",
      "zone_code": "321321321"
    }
  ]
}
```

**Descripción de los campos:**

| Campo       | Tipo   | Requerido | Descripción                    |
| ----------- | ------ | --------- | ------------------------------ |
| `name`      | string | Sí        | Nombre de la zona              |
| `zone_code` | string | Sí        | Identificador único de la zona |

<Note>
  Puedes crear múltiples zonas en una sola llamada enviando más de un objeto dentro del array `zones`.
</Note>

***

## Obtener sucursales

**Método:** `GET` **Endpoint:** `/Api/v2/sucursales/obtener_sucursales`

**Header requerido:** `Authorization: Bearer {token}`

***

## Crear sucursal

**Método:** `POST` **Endpoint:** `/Api/v2/sucursales/crear_sucursal`

**Header requerido:** `Authorization: Bearer {token}`

**Ejemplo de request:**

```json theme={null}
{
  "branches": [
    {
      "name": "Sucursal Centro",
      "zone_code": "321321321",
      "branch_code": "2525",
      "short_name": "Centro",
      "email": "centro@ejemplo.com",
      "phone": "5555555555",
      "address": "Calle Principal 123"
    }
  ]
}
```

**Descripción de los campos:**

| Campo         | Tipo   | Requerido | Descripción                                      |
| ------------- | ------ | --------- | ------------------------------------------------ |
| `name`        | string | Sí        | Nombre de la sucursal                            |
| `zone_code`   | string | Sí        | Código de la zona a la que pertenece la sucursal |
| `branch_code` | string | Sí        | Identificador único de la sucursal               |
| `short_name`  | string | No        | Nombre corto o abreviación de la sucursal        |
| `email`       | string | No        | Correo electrónico de la sucursal                |
| `phone`       | string | No        | Teléfono de la sucursal                          |
| `address`     | string | No        | Dirección física de la sucursal                  |

<Note>
  Puedes crear múltiples sucursales en una sola llamada enviando más de un objeto dentro del array `branches`.
</Note>