Árbol del API · Guías › Fechas, zonas horarias y montos
Fechas, zonas horarias y montos
Date · Money
Formatos de fechas, fechas con hora, importes y cantidades, y la zona horaria con Llave API.
Fechas
Una fecha sin hora (Date) se escribe AAAA-MM-DD, por ejemplo
"2026-10-24", tanto en los filtros como en las respuestas.
Los filtros por día, como from y to de
ordersConnection, incluyen los
dos extremos: from: "2026-10-01", to: "2026-10-31" trae todo octubre.
Fechas con hora y zona horaria
Una fecha con hora (DateTime) llega en ISO 8601 con microsegundos y el
desfase de su zona horaria:
{ "createdAt": "2026-10-24T11:42:08.000000-06:00" }Con Llave API, el día de los filtros se corta en la hora del centro de
México (America/Mexico_City) y las fechas con hora llegan en esa misma
zona, sin importar la zona del usuario de userId. Para comparar o guardar,
conviértelas a un instante (UTC) con la biblioteca de fechas de tu lenguaje;
no compares el texto.
Montos
Los importes (Money) llegan como texto decimal, con al menos dos y
hasta seis decimales: "4872.00", "2.125". Nunca llegan como número de
punto flotante, para que no se pierdan centavos.
- Léelos con un tipo decimal:
Decimalen Python,BigDecimalen Java o Ruby, o una biblioteca decimal en JavaScript. - Envíalos también como texto:
"2.50". Un número JSON (2.5) no se acepta. - El importe está en la moneda del documento; por ejemplo, la orden la indica
en
currency.
Cantidades y otros decimales
Las cantidades (Quantity) siguen la misma regla que los montos: texto
decimal con dos a seis decimales, como "1200.00". En una orden nueva deben
ser positivas.
Otros decimales, como el tipo de cambio (Decimal), también llegan como texto,
con hasta seis decimales.
Identificadores
Los identificadores (ID) llegan como texto, por ejemplo "48213".
Guárdalos como texto y envíalos igual; no hagas cuentas con ellos.