Integración
Webhooks
Recibí los resultados asincrónicos en tu aplicación.
API v1AnteriorEntrega
La API envía un POST a la URL HTTPS configurada para el owner y el entorno. Reportes y módulos usan esa misma configuración. Respondé con un HTTP 2xx para confirmar la entrega.
Procesá de forma idempotente cada x-clasificar-delivery y consultá el historial de entregas si necesitás diagnosticar una falla.
Verificar la firma
| Header | Uso |
|---|---|
x-clasificar-event | Tipo de evento. |
x-clasificar-delivery | ID único de entrega para idempotencia y logs. |
x-clasificar-timestamp | Timestamp Unix para limitar replays. |
x-clasificar-signature | HMAC-SHA256 v1=<hex> del mensaje timestamp.rawBody. |
- Leé el body crudo antes de transformarlo a JSON.
- Rechazá timestamps fuera de una ventana breve, por ejemplo cinco minutos.
- Recalculá el HMAC de
timestamp.rawBodycon el secreto del entorno. - Compará la firma en tiempo constante y procesá el ID de entrega una sola vez.
Eventos
| Evento | Cuándo ocurre | Payload |
|---|---|---|
report.completed | El reporte inteligente terminó correctamente. | Agrega eventId y event al mismo DTO público que devuelve el polling; report contiene el informe normalizado. |
report.failed | El reporte inteligente no pudo completarse. | Agrega eventId y event al mismo DTO público fallido; report=null y error usa un código estable. |
vehicle.modules.completed | Una consulta modular terminó en completed o failed. | Incluye el mismo lifecycle público (id, status, plate y timestamps) y el resultado completed/partial/failed de cada módulo. |
| Estado de entrega | Significado |
|---|---|
pending | Entrega pendiente o esperando reintento. |
processed | Tu endpoint respondió 2xx y la entrega quedó confirmada. |
failed | Se agotaron los intentos o el endpoint respondió error. |
Payloads
Los eventos de reporte agregan eventId y event al mismo DTO público que devuelve el polling.
report.completed
JSON
{
"eventId": "evt_7c684544c40e4e3a8d526eafc2f9514d",
"event": "report.completed",
"id": "rep_8d2c7ef49d8b4c8fa27d1d8906229341",
"status": "completed",
"plate": "JFK106",
"report": {
"vehicle": {
"plate": "JFK106",
"make": "LAND ROVER",
"model": "RANGE ROVER 3.6 HSE TDV8",
"year": 2010,
"vehicleType": "AUTOMOTOR",
"firstRegistered": "2010-09-07",
"totalOwners": 2,
"currentOwners": 1,
"registryOffice": "02044 - CAPITAL FEDERAL N 044",
"currentLocation": {
"city": "CABA",
"province": "CAPITAL FEDERAL"
},
"locations": [
"C.AUTONOMA DE BS.AS, Ciudad Autonoma de Buenos Aires",
"CABA, CAPITAL FEDERAL"
],
"sourceDate": "2026-05-15",
"queryDate": "2026-05-15",
"quote": null
},
"possibleOwners": [
{
"name": "V******, S*",
"id": {
"type": "CUIT",
"value": "30*"
}
}
],
"results": {
"fines": {
"total": 1,
"amountTotal": 427495.5,
"currency": "ARS",
"items": [
{
"date": "2023-09-24T08:48:00-03:00",
"amount": 427495.5,
"status": "voluntary_payment",
"authority": null,
"reference": "Q29775884",
"description": "Exceso de velocidad de 10% a 30% más de la velocidad permitida",
"jurisdiction": "CABA",
"dueDate": null,
"discountedAmount": null
}
]
},
"vtv": {
"total": 1,
"items": [
{
"type": "vtv",
"date": "2024-08-26",
"sticker": "4581967",
"inspectionType": "inspection",
"detail": "Particulares",
"result": "approved",
"certificate": "6227143",
"jurisdiction": "CABA",
"facility": "9 de Julio Sur",
"dueDate": "2025-06-01"
}
]
},
"tax_debt": {
"total": 1,
"amountTotal": 235757.86,
"currency": "ARS",
"items": [
{
"period": "2026/3",
"description": "POSICION",
"dueDate": "2026-06-22",
"amount": 235757.86,
"updatedAmount": 235757.86,
"status": "expired",
"jurisdiction": "CABA"
}
]
},
"cng": {
"total": 1,
"items": [
{
"operationDate": "2024-03-12",
"workshop": "Taller GNC Ejemplo",
"workshopTaxId": "30-00000000-0",
"workshopCode": "GNC-123",
"wafer": "12345678",
"previousWafer": "87654321"
}
]
}
},
"digest": {
"summary": "El historial registra infracciones y deuda de patente en CABA.",
"headline": "Multas y deuda de patente detectadas",
"riskLevel": "high",
"highlights": [
"1 infracción en CABA por al menos $427.496.",
"Deuda de patente en CABA por aproximadamente $235.758."
],
"issues": [
{
"title": "Infracciones en CABA",
"severity": "high",
"detail": "Registra 1 infracción por al menos $427.496 en pago voluntario."
}
],
"positives": [],
"noRecords": [],
"ownershipEstimate": {
"estimatedHistoricalOwnerCount": 2,
"confidence": "medium",
"basis": "El resumen registral consolidado muestra 2 titulares históricos."
},
"recommendation": "Pedí el detalle actualizado de multas y deuda antes de avanzar."
}
},
"createdAt": "2026-05-15T12:00:00.000Z",
"updatedAt": "2026-05-15T12:03:00.000Z",
"completedAt": "2026-05-15T12:03:00.000Z"
}report.failed
JSON
{
"eventId": "evt_9fd393058c5c4a87ab65ff507f0b4db1",
"event": "report.failed",
"id": "rep_fbeccf4d234d4dd289e476590c32e249",
"status": "failed",
"plate": "ABC123",
"report": null,
"createdAt": "2026-05-15T09:45:18.323Z",
"updatedAt": "2026-05-15T09:46:39.093Z",
"completedAt": "2026-05-15T09:46:39.093Z",
"error": {
"code": "report_generation_failed",
"message": "The report could not be generated."
}
}