Saltar al contenido principal
API POR VIN

API de vehicular recall

Verificá campañas de recall desde sistemas de posventa, garantía, seguros o CRM usando VIN como entrada principal y trazabilidad por API key.

Casos de uso

  • Validación de campañas pendientes antes de entregar o tomar un vehículo.
  • Alertas de seguridad para carteras de clientes o talleres autorizados.
  • Automatización de procesos de garantía y posventa con evidencia auditable.

Cobertura

  • Producto orientado a fuentes de recall habilitadas por marca o proveedor.
  • Entrada por VIN para evitar ambigüedad entre dominios y unidades físicas.
  • Resultado asincrónico por webhook con payload del proveedor contratado.

Formato de salida

  • Aceptación `202` con tracking de request.
  • Webhook de finalización con estado de campaña y payload normalizado.
  • Consumo asociado al producto `recall` y a la API key usada.
Contrato real

Un endpoint público, producto por API key

La integración no inventa rutas por producto. Todas las consultas entran por `POST /v1/consultas`; Patente.ar resuelve producto, créditos, proveedor y webhook desde la API key.

Ejemplo curl
curl -X POST https://api.patente.ar/v1/consultas \
  -H "Authorization: Bearer $PATENTE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: recall-0001" \
  -d '{  "vins": [    "8AJXXXXXXXX123456"  ]}'
Configuración
api_ar_api_name
recall_ford
integration_slug
recall-ford
credit_cost_key
recall
Respuesta aceptada
{
  "code": 202,
  "status": "accepted",
  "message": "La solicitud fue aceptada y se procesará en breve.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "product": "recall",
  "timestamp": "2026-05-20T15:00:00.000Z"
}
Webhook de resultado
{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "product": "recall",
  "apiArApiName": "recall_ford",
  "result": {
    "input": "8AJXXXXXXXX123456",
    "source": "recall-ford",
    "payload": "resultado normalizado de api.ar"
  }
}

Errores frecuentes

401 · Credencial inválida

La API key no corresponde al producto recall o fue revocada.

422 · VIN requerido

Este producto necesita VIN; la patente sola no alcanza para identificar la unidad.

409 · Idempotencia en curso

Ya existe una consulta activa con la misma clave de idempotencia.

Límites y créditos

El costo unitario se resuelve con la clave de crédito `recall`. Los límites de lote, rate limit y disponibilidad se configuran por contrato y quedan visibles en el dashboard de consumo.

Producto
recall
Entrada
VIN
Webhook
Opcional por key

Preguntas frecuentes

¿Recall se consulta por patente?

El producto de recall está modelado para VIN. Si además enviás patente, se conserva como dato auxiliar, pero la identificación principal es el VIN.

¿Qué marcas cubre?

La cobertura depende de las fuentes de recall habilitadas para la cuenta y puede ampliarse por contrato.

¿El webhook incluye el resultado exacto del proveedor?

Sí, Patente.ar entrega el payload normalizado y mantiene el request auditado por tenant, key y producto.

Solicitá acceso a API recall

Te entregamos credenciales, webhook, límites acordados y acompañamiento para probar el flujo completo antes de pasar a producción.

Consulta web de campañas recall
Solicitar acceso