API y desarrolladores

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:

{
  "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:

{
  "items": [
    {
      "variant_id": 6110,
      "sku": "CAM-AZU-S-001",
      "name": "AZUL - S",
      "quantity": 1,
      "base_price": "205.00"
    }
  ]
}
¿Necesitas ayuda?