Funcionamiento de Campos y Filtros de Fecha

Este documento explica cómo funcionan algunos campos clave relacionados con fechas y filtros de nuestra API de transacciones bancarias, cuya fuente de datos es el canal web de cada entidad.

?️ ¿Qué significan los campos operation_date y value_date?

• operation_date: Equivale al booking date o fecha contable.

• value_date: Equivale a la fecha valor.

Ambos se obtienen directamente de los datos mostrados por la entidad bancaria.
Cuando la entidad solo entrega uno de estos valores, asumimos que internamente los gestiona como uno solo. En ese caso, asignamos el mismo valor a ambos campos para mantener coherencia.

? ¿Cómo funcionan los filtros date_from y date_to?

Cuando envías un rango de fechas a nuestra API (date_from, date_to), nosotros:

1. Transmitimos esos mismos valores en la petición hacia la entidad bancaria, siempre que esta lo permita.

2. Si la entidad permite elegir qué fecha usar como filtro, seleccionamos operation_date.

3. Si no permite seleccionar, la fecha más común para filtrar por las propias entidades, suele ser operation_date.

? ¿Qué sucede si la entidad no permite filtrar por fecha?

En ese caso:

• Realizamos la consulta sin filtros hacia la entidad.

• Luego, aplicamos nosotros mismos el filtrado internamente usando el campo operation_date.

❓ ¿Por qué pasamos los filtros a la entidad en lugar de filtrar nosotros?

Nuestra API no tiene acceso directo a las bases de datos transaccionales de las entidades.
Por lo tanto, no podemos saber qué datos existen hasta que los recibimos. En otras palabras, operamos "a ciegas" hasta obtener respuesta.

Por eso, el filtro por fechas debe ser hecho en origen, en la petición enviada a la entidad, cuando es posible.