Trámites

Punto automatiza las matriculaciones y transferencias de vehículos con la DGT. Crea el trámite en una sola llamada adjuntando los documentos necesarios, y cuando haya un cambio de estado te avisaremos en tiempo real mediante eventos en tu webhook. También puedes consultar el estado en cualquier momento y descargar los documentos generados: Modelos 576, 05 y 06, Carta de pago IVTM, Justificante IVTM, Permiso de Circulación temporal, Ficha técnica temporal y Justificante de presentación.

Flujo

1. Crear el trámite con sus documentos
2. Recibir eventos de cambio de estado
3. Consultar el trámite y descargar documentos

Paso 1 — Crear el trámite

Matriculación

http

POST /v1/registrations
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

json

{
  "vin": "WBAWV31090P173837",
  "documents": [
    { "type": "national_id", "file": "<base64>" },
    { "type": "technical_sheet", "file": "<base64>" }
  ]
}

Respuesta:

json

{
  "id": "reg_k8mn2p",
  "vin": "WBAWV31090P173837",
  "vrm": null,
  "status": "PENDING"
}

El campo vrm (matrícula) estará vacío hasta que la DGT lo asigne al completarse el trámite.

Transferencia

http

POST /v1/transfers
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

json

{
  "documents": [
    { "type": "national_id", "file": "<base64>" },
    { "type": "sales_agreement", "file": "<base64>" },
    { "type": "veh_registration_cert", "file": "<base64>" }
  ]
}

Respuesta:

json

{
  "id": "trf_9xqr5w",
  "status": "PENDING"
}

Tipos de documento habituales

Tipo	Descripción
`national_id`	DNI / NIF
`foreigner_id`	NIE
`passport`	Pasaporte
`veh_registration_cert`	Permiso de circulación actual
`technical_sheet`	Ficha técnica
`sales_agreement`	Contrato de compraventa
`power_of_attorney`	Poder notarial

Consulta la Referencia API para el listado completo.

Paso 2 — Recibir eventos

Configura un webhook para recibir notificaciones en tiempo real cada vez que el estado de un trámite cambie o se genere un nuevo documento.

Crear una suscripción

http

POST /v1/webhooks
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

json

{
  "url": "https://tu-servidor.com/webhooks/punto",
  "events": ["registration.updated", "transfer.updated"]
}

Estructura del evento

json

{
  "event": "registration.updated",
  "data": {
    "id": "reg_k8mn2p",
    "status": "COMPLETED",
    "vrm": "1234ABC"
  }
}

Estados de un trámite

Estado	Descripción
`PENDING`	Trámite recibido, pendiente de procesarse
`PROCESSING`	En tramitación con la DGT
`COMPLETED`	Trámite completado con éxito
`FAILED`	El trámite no pudo completarse

Cuando el estado pase a COMPLETED, la matrícula (vrm) y los documentos generados estarán disponibles. Si pasa a FAILED, el objeto del trámite incluirá el motivo del error.

Gestionar webhooks

http

GET    /v1/webhooks        # Listar suscripciones activas
DELETE /v1/webhooks/{id}   # Eliminar una suscripción

Paso 3 — Consultar y descargar

Puedes consultar el estado de un trámite en cualquier momento:

http

GET /v1/registrations/{id}
GET /v1/transfers/{id}
Authorization: Bearer YOUR_API_KEY

Respuesta ejemplo (completado):

json

{
  "id": "reg_k8mn2p",
  "vin": "WBAWV31090P173837",
  "vrm": "1234ABC",
  "status": "COMPLETED",
  "documents": [
    { "type": "temp_veh_registration_cert", "url": "https://..." },
    { "type": "temp_technical_sheet", "url": "https://..." },
    { "type": "es_576_doc", "url": "https://..." },
    { "type": "es_ivtm_doc", "url": "https://..." }
  ]
}

Documentos generados

Documento	Tipo en la API
Permiso de Circulación temporal	`temp_veh_registration_cert`
Ficha técnica temporal	`temp_technical_sheet`
Modelo 576	`es_576_doc`
Modelo 05	`es_05_doc`
Modelo 06	`es_06_doc`
Carta de pago IVTM	`es_ivtm_doc`
Justificante IVTM	`es_ivtm_receipt_doc`
Justificante de presentación	`submission_receipt`

Opcional — Gestionar documentos de un trámite

Si necesitas añadir o eliminar documentos después de crear el trámite:

Matriculaciones:

http

POST   /v1/registrations/{id}/document
DELETE /v1/registrations/{id}/documents/{documentId}

Transferencias (solo en estado DRAFT):

http

POST   /v1/transfers/{id}/documents
DELETE /v1/transfers/{id}/documents/{documentId}

Las transferencias pueden crearse en modo borrador — sin enviarse a tramitar — para adjuntar documentos progresivamente y confirmar cuando estén todos listos:

http

POST /v1/transfers/{id}/confirm

Siguientes pasos

Informes DGT — solicita informes de vehículos sin crear un trámite
Firmas electrónicas — envía documentos a firmar
Referencia API — documentación completa de todos los endpoints