> ## 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 fuso horário da transação

> Lista de valores IANA permitidos pelo enum transaction_time_zone para o campo timeZone em transações e operationalHours.timezone em entidades — API gu1.

## Visão geral

O enum **transaction\_time\_zone** do PostgreSQL é a lista permitida para:

* **`timeZone`** em [Criar transação](/pt/api-reference/transactions/create) e [Criar lote](/pt/api-reference/transactions/create-batch)
* **`operationalHours.timezone`** em [Criar entidade](/pt/api-reference/entities/create), [pessoa](/pt/api-reference/person/create), [empresa](/pt/api-reference/company/create) e criação automática

Se omitido em transações, `time_zone` permanece **`null`**. Em entidades, `operational_hours` permanece **`null`** quando o objeto `operationalHours` não é enviado.

É diferente de `deviceDetails.timezone` (fuso reportado pelo dispositivo) e do fuso padrão da organização nas configurações do workspace.

## Valores permitidos

| Valor                            | Região (resumo)              |
| -------------------------------- | ---------------------------- |
| `UTC`                            | Tempo universal coordenado   |
| `America/Noronha`                | Brasil (Fernando de Noronha) |
| `America/Argentina/Buenos_Aires` | Argentina                    |
| `America/Montevideo`             | Uruguai                      |
| `America/Sao_Paulo`              | Brasil (São Paulo)           |
| `America/Asuncion`               | Paraguai                     |
| `America/Santiago`               | Chile                        |
| `America/Caracas`                | Venezuela                    |
| `America/Manaus`                 | Brasil (Amazonas)            |
| `America/Cuiaba`                 | Brasil (Mato Grosso)         |
| `America/Bogota`                 | Colômbia                     |
| `America/Lima`                   | Peru                         |
| `America/Rio_Branco`             | Brasil (Acre)                |
| `America/New_York`               | Leste dos EUA                |
| `America/Chicago`                | Centro dos EUA               |
| `America/Mexico_City`            | México                       |
| `America/Los_Angeles`            | Pacífico dos EUA             |
| `Europe/London`                  | Reino Unido                  |
| `Europe/Lisbon`                  | Portugal                     |
| `Europe/Madrid`                  | Espanha                      |
| `Europe/Paris`                   | França                       |
| `Europe/Berlin`                  | Alemanha                     |
| `Europe/Rome`                    | Itália                       |
| `Asia/Dubai`                     | Emirados Árabes Unidos       |
| `Asia/Kolkata`                   | Índia                        |
| `Asia/Shanghai`                  | China                        |
| `Asia/Tokyo`                     | Japão                        |
| `Australia/Sydney`               | Austrália (Sydney)           |
| `Africa/Johannesburg`            | África do Sul                |

Envie o **string** exatamente como na tabela (diferencia maiúsculas/minúsculas). Não use nomes de chaves de enum TypeScript.

## Uso

* **Transações:** `timeZone` opcional (metadata; omitir = `null`). Não é obrigatório quando `transactedAt` usa `Z`. Com datetime local + `timeZone`, a API pode gravar o UTC equivalente. Independente de `operationalHours` nas regras de horário operacional.
* **Entidades (pessoa ou empresa):** `operationalHours` opcional na raiz; se o objeto for enviado, `timezone` é obrigatório. Ver [Criar entidade](/pt/api-reference/entities/create).
* **GET transação / entidade:** A resposta inclui `timeZone` ou `operationalHours` conforme o caso.

## Veja também

* [Criar transação](/pt/api-reference/transactions/create)
* [Criar entidade](/pt/api-reference/entities/create)
* [Obter transação](/pt/api-reference/transactions/get)