Para saber más
Fechas y horas
Las respuestas dan las fechas en UTC. Cuando escribes, envía un instante ISO 8601 con desplazamiento. Una fecha sin hora como 2026-10-17 se lee en la zona horaria del negocio de la cuenta cuando está en un filtro; una escritura solo la admite en un campo que sea una fecha simple.
El trabajo de alquiler se organiza en días, y un día depende de dónde esté el negocio. Por eso la API separa tres cosas: el instante (exacto, UTC), el desplazamiento que envías con él y la zona horaria del negocio de la cuenta, que decide qué significa una fecha sin hora.
En las respuestas
Enlace a esta sección: En las respuestasLas fechas son cadenas ISO 8601 en UTC (date-time), por ejemplo 2026-10-17T08:00:00Z. Conviértelas a la hora local en tu propio código.
Cuando escribes
Enlace a esta sección: Cuando escribesEnvía cada fecha y hora como un instante ISO 8601 con desplazamiento, por ejemplo 2026-10-17T10:00:00+02:00. Un instante con desplazamiento designa el mismo momento sea cual sea la zona; las respuestas lo devuelven en UTC. El contrato REST y las herramientas MCP exigen el desplazamiento en cada fecha y hora que escribes.
La única excepción es un campo que es una fecha simple, sin hora: invoiceDate y dueDate de PUT /api aceptan una fecha sin hora como 2026-10-17, sin hora ni desplazamiento. En cualquier otro sitio, si una escritura con una fecha sin hora devuelve validation_error, añade una hora y un desplazamiento.
La zona horaria del negocio
Enlace a esta sección: La zona horaria del negocioLa cuenta tiene una zona horaria IANA, que es en la que se leen las fechas sin hora de los filtros. Léela una vez con GET /api, en el campo timezone, junto con la moneda y el idioma. No la deduzcas del país ni del servidor en el que ejecutas.
Filtros de fecha en las listas
Enlace a esta sección: Filtros de fecha en las listasLas listas que los admiten aceptan dos familias de filtros, una para la hora de creación y otra para la última actualización: createdOn, createdAfter, createdBefore, createdFrom, createdTo, y los mismos nombres con updated. Cada uno acepta una fecha sin hora, interpretada en la zona horaria del negocio, o un instante ISO 8601 con desplazamiento.
| Filtro | Significado |
|---|---|
…On | Cae en esta fecha. |
…After | Es posterior a esta fecha. |
…Before | Es anterior a esta fecha. |
…From | Es igual o posterior a esta fecha. |
…To | Es igual o anterior a esta fecha. |
Con una fecha sin hora, …After deja fuera ese día entero y …Before se detiene al inicio de ese día, mientras que …From empieza al principio del día y …To lo incluye entero.
Para una sincronización incremental, updatedFrom y updatedBefore forman una ventana semiabierta. La guía sobre sincronizar datos muestra cómo usarlos sin perder registros.
Fechas en las herramientas MCP
Enlace a esta sección: Fechas en las herramientas MCPLas herramientas de listado de MCP reciben un único objeto dateFilters en lugar de parámetros separados: dateFilters: { field: { gte, lte, gt, lt, on } }. Una fecha sin hora en gte o on es el inicio de ese día del negocio, y en lte el final de ese día; gt significa después del final de ese día y lt antes de su inicio. Un instante con desplazamiento se aplica tal cual, salvo con on, que cubre todo el día del negocio que lo contiene.
Si una consulta por días devuelve registros que no esperabas, comprueba primero la zona horaria: la misma fecha sin hora abarca instantes distintos en zonas horarias distintas.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasGuías
Tipos de datos
El dinero es una cadena decimal, las fechas son ISO 8601, una propiedad puede estar presente y ser null, y los campos personalizados son mapas. Interpreta cada tipo una sola vez, en el borde de tu integración.
Guías
Sincronizar datos
Filmo v1 no envía webhooks, así que mantienes otro sistema sincronizado consultando periódicamente: lee lo que cambió en ventanas de tiempo semiabiertas y ejecuta un barrido aparte para encontrar lo que se eliminó. No sigas el cursor de paginación para decidir qué cambió o qué desapareció.
Para saber más
Importes y monedas
Todo importe monetario es una cadena decimal con dos decimales, como
"1234., nunca un número de coma flotante, con una excepción: los precios de50" priceConfigydefaultExpensesde un servicio y elcustomPricede un accesorio son números JSON. Cada documento lleva su propia moneda, que puede diferir de la de la cuenta.
¿Te ha resultado útil esta página?