Conecta consultas de infracciones por patente a CRMs, ERPs, sistemas de scoring, portales de flota y validaciones preoperativas sin construir scrapers propios.
Este repo no es un SDK ni un wrapper instalable. Es un kit publico de integracion para equipos que quieren evaluar la API de patente.ar antes de conectarla a un CRM, ERP, backoffice, marketplace, seguro o flujo de flota.
patente.ar centraliza APIs vehiculares para Argentina: consultas por patente o VIN, procesamiento asincronico, trazabilidad por request y documentacion pensada para equipos de producto, datos y operaciones.
- 109 jurisdicciones publicadas en patente.ar para busquedas de multas por patente.
- Endpoint unico con API key por producto, idempotencia y trazabilidad.
- Webhook firmado para flujos asincronicos y auditoria por request.
| Pieza | Para que sirve |
|---|---|
README.md |
Guia comercial y tecnica para integrar API multas Argentina. |
openapi/openapi.yaml |
Contrato OpenAPI 3.1 para documentacion, SDKs o pruebas. |
examples/curl/consulta.sh |
Prueba rapida desde terminal. |
examples/node/consulta.mjs |
Ejemplo Node.js con fetch. |
examples/python/consulta.py |
Ejemplo Python sin dependencias externas. |
webhooks/* |
Verificacion HMAC SHA-256 de webhooks de patente.ar. |
.github/workflows/validate.yml |
Validacion de sintaxis para ejemplos. |
POST https://api.patente.ar/v1/consultas
El producto queda definido por la API key emitida para infracciones. No hace falta inventar rutas como /v1/multas o /v1/vtv: el contrato publico se mantiene estable en POST /v1/consultas.
- Scoring vehicular.
- Flotas.
- Seguros.
- Marketplaces.
- Gestorias.
- Pedir una API key desde patente.ar.
- Copiar
.env.examplecomo.env. - Ejecutar un ejemplo:
export PATENTE_API_KEY="pa_live_xxx"
./examples/curl/consulta.sh
node examples/node/consulta.mjs
python3 examples/python/consulta.pyLa respuesta puede ser inmediata o asincronica. Cuando queda en proceso, patente.ar responde con 202 accepted y un requestId; el resultado final puede llegar por webhook.
Para probar API multas Argentina sin armar un backend desde cero, crea una cuenta en patente.ar, pedi habilitar la API infracciones y usa el Playground para ejecutar requests con API keys, payloads de ejemplo, idempotencia, webhooks y logs.
| Paso | Link | Que hacer |
|---|---|---|
| 1 | Crear cuenta en patente.ar | Registrar la cuenta de empresa o equipo que va a consumir la API. |
| 2 | Pedir habilitacion de la API | Solicitar que activen el producto infracciones y el esquema de creditos. |
| 3 | Abrir el Playground | Probar payloads reales de integracion, revisar respuestas y validar webhooks sin publicar credenciales. |
| 4 | Pasar a produccion | Configurar API keys, webhook firmado, idempotencia y trazabilidad por requestId. |
El Playground requiere iniciar sesion y tener el modulo API habilitado para la cuenta. Si todavia no aparece, pedi la habilitacion desde el link anterior.
POST /v1/consultas HTTP/1.1
Host: api.patente.ar
Authorization: Bearer pa_live_xxx
Content-Type: application/json
Idempotency-Key: orden-externa-001
x-token: orden-externa-001{
"patente": [
"AB123CD"
]
}{
"code": 202,
"status": "accepted",
"message": "La solicitud fue aceptada y se procesara en breve.",
"requestId": "req_01HZX...",
"timestamp": "2026-06-30T12:00:00.000Z"
}El repo mantiene 109 paginas por jurisdiccion con contexto local, fuente informativa, canales oficiales y notas de integracion. El README queda corto; la cobertura completa vive en GitHub Pages y en el sitemap publico.
- Indice completo: jurisdicciones
- Sitemap: sitemap.xml
- Pagina comercial: API multas en patente.ar
Ejemplos:
- Alcira Gigena - consulta web
- Almirante Brown - consulta web
- Alpa Corral - consulta web
- Alta Gracia - consulta web
- Arias - consulta web
- Avellaneda - consulta web
- Bahía Blanca - consulta web
- Berisso - consulta web
- Bonpland - consulta web
- Buenos Aires - consulta web
- CABA - consulta web
- Caminos de las Sierras - consulta web
Cuando el resultado esta disponible, patente.ar puede enviar un POST al webhook configurado para la API key.
Headers relevantes:
x-patente-timestampx-patente-signaturex-patente-request-idx-patente-api-keyx-tokensi fue enviado en el request original
La firma usa HMAC SHA-256 sobre:
timestamp.raw_body
Ver ejemplos en:
- Usar
Idempotency-Keyen todos los reintentos. - Guardar
requestIdyx-tokenpara conciliacion. - Validar
x-patente-signatureantes de procesar webhooks. - Reintentar
429y errores temporales con backoff. - No registrar API keys, webhook secrets ni payloads sensibles en logs.
| Codigo | Causa | Accion |
|---|---|---|
| 401 | API key ausente, revocada o invalida | Rotar o revisar la key en patente.ar |
| 402 | Creditos insuficientes | Cargar saldo o cambiar el producto contratado |
| 409 | Idempotencia ya en curso | Reusar el requestId previo o cambiar Idempotency-Key |
| 422 | Payload fuera de contrato | Revisar el ejemplo y normalizar la entrada |
| 429 | Rate limit | Reintentar con backoff |
- Producto: https://patente.ar/api-multas
- Crear cuenta: https://patente.ar/registro
- Habilitar API: https://patente.ar/contacto?asunto=Habilitar%20API%20infracciones
- Playground: https://patente.ar/desarrolladores/api?tab=playground
- Patente.ar: https://patente.ar
- Documentacion OpenAPI: openapi/openapi.yaml
MIT. Este repositorio contiene ejemplos de integracion; no incluye credenciales ni codigo backend de patente.ar.