> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Enum zona horaria de transacción

> Valores IANA permitidos (transaction_time_zone) para timeZone en transacciones y operationalHours.timezone en entidades — API gu1.

## Resumen

El enum **transaction\_time\_zone** de PostgreSQL es la lista permitida para:

* **`timeZone`** en [Crear transacción](/es/api-reference/transactions/create) y [Crear lote](/es/api-reference/transactions/create-batch)
* **`operationalHours.timezone`** en [Crear entidad](/es/api-reference/entities/create), [persona](/es/api-reference/person/create), [empresa](/es/api-reference/company/create) y creación automática

Si se omite en transacciones, `time_zone` queda en **`null`**. En entidades, `operational_hours` queda en **`null`** cuando no se envía el objeto `operationalHours`.

Es distinto de `deviceDetails.timezone` (zona reportada por el dispositivo) y de la zona horaria por defecto de la organización en la configuración del workspace.

## Valores permitidos

| Valor                            | Región (resumen)             |
| -------------------------------- | ---------------------------- |
| `UTC`                            | Tiempo universal coordinado  |
| `America/Noronha`                | Brasil (Fernando de Noronha) |
| `America/Argentina/Buenos_Aires` | Argentina                    |
| `America/Montevideo`             | Uruguay                      |
| `America/Sao_Paulo`              | Brasil (São Paulo)           |
| `America/Asuncion`               | Paraguay                     |
| `America/Santiago`               | Chile                        |
| `America/Caracas`                | Venezuela                    |
| `America/Manaus`                 | Brasil (Amazonas)            |
| `America/Cuiaba`                 | Brasil (Mato Grosso)         |
| `America/Bogota`                 | Colombia                     |
| `America/Lima`                   | Perú                         |
| `America/Rio_Branco`             | Brasil (Acre)                |
| `America/New_York`               | Este de EE. UU.              |
| `America/Chicago`                | Centro de EE. UU.            |
| `America/Mexico_City`            | México                       |
| `America/Los_Angeles`            | Pacífico de EE. UU.          |
| `Europe/London`                  | Reino Unido                  |
| `Europe/Lisbon`                  | Portugal                     |
| `Europe/Madrid`                  | España                       |
| `Europe/Paris`                   | Francia                      |
| `Europe/Berlin`                  | Alemania                     |
| `Europe/Rome`                    | Italia                       |
| `Asia/Dubai`                     | Emiratos Árabes Unidos       |
| `Asia/Kolkata`                   | India                        |
| `Asia/Shanghai`                  | China                        |
| `Asia/Tokyo`                     | Japón                        |
| `Australia/Sydney`               | Australia (Sídney)           |
| `Africa/Johannesburg`            | Sudáfrica                    |

Enviá el **string** exactamente como en la tabla (sensible a mayúsculas/minúsculas). No uses nombres de claves de enums en TypeScript.

## Uso

* **Transacciones:** `timeZone` opcional (metadata; omitir = `null`). No es obligatorio si `transactedAt` usa `Z`. Con datetime local + `timeZone`, la API puede guardar el UTC equivalente. Independiente de `operationalHours` en reglas de horario operativo.
* **Entidades (persona o empresa):** `operationalHours` opcional en raíz; si se envía el objeto, `timezone` es obligatorio. Ver [Crear entidad](/es/api-reference/entities/create).
* **GET transacción / entidad:** La respuesta incluye `timeZone` u `operationalHours` según corresponda.

## Ver también

* [Crear transacción](/es/api-reference/transactions/create)
* [Crear entidad](/es/api-reference/entities/create)
* [Obtener transacción](/es/api-reference/transactions/get)
