Créditos y consumo de una API de multas: cómo se concilia a fin de mes

A fin de mes aparecen dos números que rara vez coinciden: los créditos que la flota registró al consultar multas y los que informa el extracto del proveedor. La reacción habitual es buscar un error, y a menudo no lo hay: cada lado cuenta un evento distinto, en un momento distinto.

Conciliar no es comparar totales. Es cruzar movimientos: cada consulta de una patente con identificador propio, fecha y cantidad, que puedan aparearse una a una. Un total sirve para saber que algo no cierra; nunca para saber qué.

Antes de discutir un importe hay que fijar tres cosas: qué evento descuenta un crédito —un dominio consultado, una jurisdicción interrogada o un acta devuelta—, en qué período cae y con qué clave se cruzan las listas.

Qué evento descuenta un crédito

La pregunta previa no es cuántos créditos se gastaron, sino cuándo se gastan. “Una llamada a la API” es ambiguo: una integración puede emitir varias por una misma patente —la que acepta el trabajo, las que preguntan el estado mientras las jurisdicciones responden, la que baja el resultado— y sólo una debería debitar.

Para una API de infracciones, el contrato debería declarar:

• qué unidad se cobra: la consulta aceptada, la terminada, cada patente de un lote o cada fuente interrogada;
• qué respuestas no consumen: rechazos por validación, límites de ritmo o cancelaciones tempranas;
• qué ocurre con un resultado parcial, cuando algunas jurisdicciones respondieron y otras no;
• cuánto tiempo una repetición con la misma clave cuenta como el mismo movimiento.

El último punto es el que más ruido genera: un reintento sobre la misma patente que nadie deduplicó aparece como dos movimientos casi idénticos. Eso se decide al diseñar cuándo repetir sin duplicar el cargo, no sobre el extracto.

El corte del período no es obvio

Un movimiento tiene al menos tres relojes: cuándo se recibió la solicitud, cuándo terminó el trabajo y cuándo se asentó el débito. Un barrido de 800 dominios lanzado a las 23:50 del último día del mes puede terminar dentro del período siguiente.

Por eso el período debe declarar qué marca temporal lo gobierna, igual de los dos lados. El formato estándar de fecha y hora para protocolos de Internet incluye el desplazamiento horario junto al instante; sin ese dato hay que suponer una zona, y la suposición puede cambiar el mes del movimiento.

Si el corte se define en hora local, la zona debe nombrarse en vez de fijar un desplazamiento constante: los desplazamientos vigentes salen de la base de datos que mantiene IANA y pueden cambiar.

La cuota que informa la API no es un libro de movimientos

Muchas integraciones de flota intentan conciliar con los contadores que devuelve la API. El borrador activo del grupo HTTPAPI del IETF define campos RateLimit para comunicar la política de servicio y la cuota disponible; al 29 de agosto de 2026 sigue siendo un Internet-Draft, no un RFC publicado.

Esos campos regulan el ritmo del cliente: informan cuánto queda en una ventana, no cuánto se facturó. Un contador leído a las 15:04 no es una fila de un libro.

La conciliación necesita un extracto de movimientos, cada uno con identificador estable, fecha con zona, cantidad y credencial que lo originó. Si el proveedor sólo publica un tablero con el saldo de consultas, se puede detectar un desvío, pero no ubicarlo.

Cómo se cruzan las dos listas

Ambas partes exportan el período con la misma clave: el identificador que el proveedor devuelve al aceptar el trabajo y que el cliente guarda. Después se clasifican las diferencias, y ahí termina la discusión sobre el total:

• movimientos del extracto sin correlato en el registro propio;
• movimientos propios que el extracto no cobró;
• misma clave con cantidad distinta;
• movimientos cuya fecha cae a un lado y otro del corte.

Cada grupo tiene una causa esperable y una acción distinta. Los de borde se resuelven fijando el reloj rector; los duplicados, revisando la deduplicación de reintentos. Los que existen de un solo lado suelen venir de trabajos fuera del flujo principal —una prueba, un script que alguien corrió para una patente puntual, una credencial prestada—; por eso conviene que cada movimiento arrastre la credencial que lo pidió.

Los ajustes se agregan, no se editan

Las diferencias que sobreviven se corrigen con un ajuste: un movimiento nuevo, con identificador propio, que referencia al original y explica el motivo. Reescribir un período cerrado deja a las partes sin evidencia de qué pasó ni cuándo se corrigió.

Si la diferencia ya viajó en un comprobante emitido, la corrección sale por el circuito fiscal y no por el libro de créditos. El régimen general de facturación distingue clases de comprobantes según la operación y la condición de las partes; cuál corresponde lo confirma el área administrativa, y un documento emitido no se edita.

Antes del período siguiente conviene verificar que el evento facturable esté escrito y no inferido —si una patente con seis jurisdicciones cuesta uno o cuesta seis—; que cada respuesta devuelva el identificador del movimiento; que ambas partes usen el mismo reloj rector con zona declarada; que haya un registro de consumo propio, independiente del panel del proveedor; y qué plazo da el contrato para observarlo.

Una conciliación prolija no es la que da cero diferencias. Es la que puede explicar cada una de las que dio.

Metodología

Alcance

Procedimiento de conciliación entre el registro de consumo de una empresa y el extracto de créditos de su proveedor de consultas vehiculares. No cubre el diseño comercial de un plan ni el tratamiento contable o impositivo de cada organización.

Unidad de análisis

Un movimiento del libro de créditos: un evento facturable con identificador estable, fecha con desplazamiento horario, unidad y cantidad debitada.

Cobertura

Criterios derivados de los formatos estándar de fecha y hora, de la base de zonas horarias de IANA, del borrador activo de campos RateLimit y del régimen general de facturación, consultados el 29 de agosto de 2026.

Limitaciones

• Los eventos facturables, las ventanas de deduplicación y los plazos para observar un extracto los define cada contrato: acá se indica qué preguntar, no qué valor esperar.
• El tratamiento contable e impositivo de un ajuste debe confirmarse con los responsables administrativos de cada empresa; esta nota no es asesoramiento fiscal.
• Un extracto sin identificador por movimiento no se puede cruzar línea por línea y la comparación queda limitada a agregados.

Fuentes

• RFC 3339 — Date and Time on the Internet — RFC Editor (consultada el 2026-08-29)
• Base de datos oficial de zonas horarias — Internet Assigned Numbers Authority (consultada el 2026-08-29)
• Internet-Draft activo — RateLimit header fields for HTTP — Internet Engineering Task Force (consultada el 2026-08-29)
• Régimen general de facturación y clases de comprobantes — Agencia de Recaudación y Control Aduanero (consultada el 2026-08-29)

Preguntas frecuentes

¿Una consulta que falla consume crédito?

Depende del evento facturable que declare el contrato. Un rechazo por validación o un límite de ritmo normalmente no debería debitar, porque no se hizo trabajo. Una consulta que llegó a las fuentes y devolvió resultado parcial sí puede hacerlo. Lo importante es que la regla esté escrita y que el movimiento quede visible en el extracto.

¿Alcanza con comparar el total del extracto contra el del panel?

Sirve como alarma, no como conciliación. Un total igual puede esconder un cargo de más compensado por uno de menos, y un total distinto no dice dónde está la diferencia. Para resolverla hace falta cruzar movimientos con una clave común.

¿Un reintento automático descuenta dos veces?

No debería, si la solicitud repetida viaja con la misma clave de idempotencia y el proveedor la deduplica dentro de una ventana declarada. Cuando aparecen dos movimientos casi simultáneos con la misma clave, esa ventana o esa clave es lo primero que conviene revisar.

¿Qué pasa con una consulta iniciada el último día del mes?

Cae en un período o en el otro según qué marca temporal gobierne el corte: la de recepción, la de finalización o la del asiento del débito. Si las dos partes no eligen la misma, todos los meses van a aparecer diferencias de borde que no son errores de nadie.

Notas relacionadas