Convenciones
Fechas y zonas horarias
ISO 8601, ventanas inclusivas y exclusivas, hora local del local y por qué el día del negocio no termina a medianoche
Actualizado el 2026-08-16Para: Principiantes · Desarrolladores
Las fechas son la fuente número uno de diferencias entre lo que muestra Bistro y lo que muestra tu integración. Vale la pena leer esta página entera antes de cerrar la primera conciliación.
Formato
Todas las fechas, de entrada y de salida, van en ISO 8601.
2026-08-16T14:30:00
- Se aceptan segundos; los milisegundos se ignoran.
- La
Tentre fecha y hora es obligatoria. - Si mandás solo la fecha, se interpreta como las 00:00 de ese día.
Inclusivo y exclusivo
Esta es la regla que hay que memorizar:
| Parámetro | Borde |
|---|---|
From / startDate | Inclusivo: incluye lo que ocurre exactamente en ese instante |
To / endDate | Exclusivo: excluye lo que ocurre exactamente en ese instante |
Para pedir todo el 15 de agosto:
From = 2026-08-15T00:00:00
To = 2026-08-16T00:00:00
Que los bordes sean inclusivo y exclusivo tiene una ventaja concreta: dos ventanas
consecutivas no se pisan y no dejan huecos. El To de una es el From de la
siguiente.
Zona horaria
Los timestamps de las operaciones vienen en la hora local del local, sin
sufijo de zona. Un 2026-08-15T21:30:00 de un local de Buenos Aires es las 21:30
de Buenos Aires.
El expiration del token, en cambio, viene en UTC.
| Dato | Zona |
|---|---|
created_at, updated_at | Hora local del local |
expiration del token | UTC |
Si tu integración cubre Argentina, México y España, no podés convertir todo con
una sola zona horaria. Cada local tiene la suya, y España además cambia de hora
dos veces al año. Guardá el timestamp tal como vino, junto al shop_code, y
convertí recién al reportar.