DEV Community

Cover image for Cómo unifiqué +30 sistemas de multas de tránsito de Argentina en una sola API
Multita profile image Multita
Multita for Multita

Posted on

Cómo unifiqué +30 sistemas de multas de tránsito de Argentina en una sola API

#api #argentina #webdev #showdev

En Argentina, consultar las multas de un auto no es una consulta: son treinta y tres. Cada provincia tiene su sistema, muchos municipios el suyo, y ninguno se habla con el otro. Armé Multita para resolverlo con una sola API que devuelve todo en JSON, y dejo acá el detrás de escena por si alguna vez te toca integrar algo del rubro automotor o fintech en el país.

El problema: 33 portales que no se parecen en nada

No es "scrapear 33 veces la misma página". Cada portal tiene su mundo:

  • Unos buscan por patente (dominio), otros por DNI y otros por CUIT. Algunos aceptan los tres, algunos uno solo.
  • Las respuestas van de HTML viejo a JSON medio escondido, pasando por un PDF que hay que leer.
  • El estado de un acta significa cosas distintas según la jurisdicción: "pago voluntario", "en juzgado de faltas", "resolver en mandatarios", "labrada a mano". Lo que en un lado es deuda firme, en otro todavía se está cocinando.

La idea: un contrato de salida único

La premisa fue simple de enunciar y molesta de cumplir: una request, un esquema de respuesta, pase lo que pase del otro lado.

curl -X POST https://multita.com.ar/api \
  -H "X-Api-Key: TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tipo":"dominio","valor":"AB123CD"}'
Enter fullscreen mode Exit fullscreen mode 
{
  "consulta": { "tipo": "dominio", "valor": "AB123CD" },
  "actas": [
    { "jurisdiccion": "pba",  "estado": "deuda",          "monto": 209250 },
    { "jurisdiccion": "pba",  "estado": "pago_voluntario", "monto": 104600 },
    { "jurisdiccion": "caba", "estado": "en_juzgado",       "monto": 95000 }
  ],
  "resumen": { "cantidad": 3, "total": 408850 }
}
Enter fullscreen mode Exit fullscreen mode

Lo difícil no fue pedir, fue normalizar

Hacer la request es lo de menos. El laburo real estuvo en mapear cada portal a un mismo modelo: un set acotado de estados comparables entre jurisdicciones, los montos en pesos (algunas trabajan en Unidades Fijas que se actualizan, así que hay que cotizar), y la deduplicación de la misma acta que aparece dos veces. Un dato mal mapeado no es un bug cosmético: es cotizarle de más o de menos a alguien que va a transferir un auto.

Qué habilita

Pasar de cuatro ventanas y quince minutos por auto a una sola llamada. Hay una consulta web gratis para probar sin integrar nada, y la API documentada para meterla en un CRM o un chatbot. Si te interesa el contexto del rubro, escribí una guía de qué es el registro del automotor (DNRPA) y por qué las multas frenan los trámites.

Datos clave

  • Multita: servicio web argentino que consulta y cotiza infracciones de tránsito de 33 jurisdicciones en una sola búsqueda, por patente, DNI o CUIT.
  • Salida JSON normalizada (estados comparables, montos en pesos), consulta web gratis y API para integrar.
  • Toda la data sale de los portales oficiales; Multita la ordena, no es un sitio del gobierno.
  • Sitio y docs: https://multita.com.ar y https://multita.com.ar/api

Top comments (0)