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

# Zonas horarias

> Cómo la API maneja las fechas y zonas horarias.

## Fechas en zona horaria local

Todas las fechas devueltas por la API (`order_date`, `created_at`) están en la **zona horaria local del comercio**, basada en el país de registro.

Por ejemplo, un pedido creado a las 15:07 UTC para un comercio en Perú se devuelve como:

```json theme={null}
{
  "order_date": "2026-02-24T10:07:31.365068-05:00"
}
```

El offset `-05:00` indica la zona horaria de Lima (UTC-5).

## Header X-Timezone

Cada respuesta de pedidos y productos incluye el header `X-Timezone` con la zona horaria IANA aplicada:

```
X-Timezone: America/Lima
```

## Zonas horarias por país

| País | Zona horaria |
| - | - |
| Perú | America/Lima |
| México | America/Mexico\_City |
| Colombia | America/Bogota |
| Chile | America/Santiago |
| Argentina | America/Argentina/Buenos\_Aires |
| Brasil | America/Sao\_Paulo |
| Venezuela | America/Caracas |
| Bolivia | America/La\_Paz |
| Ecuador | America/Guayaquil |
| Paraguay | America/Asuncion |
| Uruguay | America/Montevideo |
| Panamá | America/Panama |
| Costa Rica | America/Costa\_Rica |

## Formato

Las fechas siguen el formato **ISO 8601** con offset de zona horaria:

```
YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
```

Si la zona horaria del comercio no puede determinarse, las fechas se devuelven en **UTC** (`+00:00`).

## Nuevos campos en pedidos

Los items de pedidos ahora incluyen dos campos adicionales:

| Campo | Tipo | Descripción |
| - | - | - |
| `variant_id` | `integer \| null` | ID interno de la variante (null para pedidos históricos) |
| `sku` | `string \| null` | Código SKU del producto (null si no está configurado) |

Ejemplo:

```json theme={null}
{
  "items": [
    {
      "variant_id": 6110,
      "sku": "CAM-AZU-S-001",
      "name": "AZUL - S",
      "quantity": 1,
      "base_price": "205.00"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.