API de multas e infracciones para tu sistema

Guía para evaluar e integrar la API de infracciones

La API de multas.ar permite consultar infracciones por patente en Argentina desde un ERP, TMS o sistema propio. Recibe lotes de hasta 500 patentes y devuelve un resultado JSON con enlaces a los archivos disponibles. La consulta se procesa de forma asíncrona: aceptar el pedido no significa que el resultado ya esté listo.

Qué revisar antes de integrar

Definí qué vehículos necesitás consultar, el volumen esperado y qué jurisdicciones necesitás cubrir. La cobertura depende de las fuentes habilitadas y de su disponibilidad; una fuente que no respondió no equivale a un vehículo sin infracciones. El resultado es informativo y no reemplaza un certificado oficial de libre deuda.

Con la cuenta aprobada, usá el Playground para evaluar una consulta real y su resultado. La prueba muestra el costo, requiere confirmación y consume créditos. Para conectar tu sistema, configurá una API key, las IP de salida autorizadas y un webhook HTTPS que pueda recibir notificaciones.

Webhook y reintentos sin duplicar operaciones

Guardá el requestId para seguir la consulta y relacionar el resultado con tu pedido. Si necesitás repetir el envío por una desconexión, conservá la misma Idempotency-Key y el mismo lote: la API recupera la operación original. Usar esa clave con otro lote devuelve un conflicto.

El webhook informa el resultado final y puede entregarse más de una vez. Verificá su autenticidad según la documentación del panel y registrá cada entrega antes de aplicar cambios. El secreto de firma es independiente de la API key; si no disponés de él, contrastá la notificación con el resultado obtenido mediante una consulta autenticada. Respondé con un código 2xx cuando hayas recibido la entrega de forma segura.

Créditos y archivos de resultados

En Infracciones se reservan créditos por patentes únicas y el consumo se confirma cuando el proveedor acepta el pedido. Un rechazo definitivo anterior a esa aceptación libera la reserva. Un resultado posterior con errores no implica una devolución automática. Revisá el precio vigente y el saldo en el panel; los valores de los ejemplos son ficticios.

El JSON final informa credits_used y credits_left, junto con los enlaces disponibles a CSV, Excel y ZIP de actas, según la modalidad habilitada. results.jurisdictions identifica las jurisdicciones intentadas, no necesariamente las que respondieron. results.error, cuando tiene valor, es un enlace al CSV de errores: no es un mensaje de error. Revisá ese archivo y el detalle de cada patente antes de interpretar el lote como completo.

Descargá los archivos dentro de su vigencia y tratá sus enlaces y el requestId como información confidencial. La API deja de entregar el enlace del CSV de resultados a los 30 días; eso no garantiza el borrado del archivo en su origen. Las condiciones de cada formato están detalladas en la documentación de la cuenta.

Cómo interpretar el estado de la consulta

accepted: Pedido aceptado

Guardá el requestId. Un HTTP 202 todavía no contiene el resultado final.

processing: Consulta en curso

Esperá el webhook o consultá el estado con las credenciales que originaron el pedido.

completed: Resultado disponible

Procesá el JSON y revisá los archivos de resultados y de errores. No significa que todas las fuentes hayan respondido.

failed: La operación terminó con un fallo

Revisá status y error, aunque la lectura devuelva HTTP 200. No lo interpretes como ausencia de infracciones.

Errores que tu integración debe contemplar

• 401 / 403: Revisá la credencial, la habilitación de la cuenta y las IP autorizadas.
• 402: El saldo no alcanza para reservar la consulta. Revisá los créditos disponibles.
• 409: Revisá si reutilizaste la misma Idempotency-Key con un lote distinto.
• 422: Corregí las patentes inválidas: se rechaza el lote completo.
• 429 / 503: Consultá error.retryable y respetá Retry-After cuando venga informado. Conservá la clave de idempotencia al reintentar el mismo pedido.

Ejemplos del intercambio JSON

Ejemplos ficticios del formato de Infracciones. No ejecutan consultas: la patente, los identificadores, los créditos y la cobertura son ilustrativos. El dominio example.invalid no entrega archivos. La documentación completa y las direcciones de conexión están en el panel de la cuenta habilitada.

1. Cuerpo del pedido

{
  "patentes": [
    "AB123CD"
  ]
}

2. Aceptación · HTTP 202

{
  "requestId": "req_ejemplo_001",
  "status": "accepted",
  "timestamp": "2026-10-16T12:00:00.000Z",
  "timezone": "UTC"
}

3. Resultado final

{
  "api": "infracciones",
  "requestId": "req_ejemplo_001",
  "status": "completed",
  "timestamp": "2026-10-16T12:05:00.000Z",
  "results": {
    "csv": "https://example.invalid/resultados.csv",
    "error": null,
    "jurisdictions": "caba;pba",
    "credits_used": 1,
    "credits_left": 99
  }
}

Guía revisada el 2026-10-16.