Integración con DGT TESTRA

Capítulo 1: Introducción a TESTRA

TESTRA es el sistema de tramitación electrónica de sanciones de tráfico desarrollado por la Dirección General de Tráfico. Permite a las policías locales y autonómicas:

• Consultar en tiempo real los datos de vehículos matriculados en España
• Consultar datos de permisos de conducir y puntos disponibles
• Enviar boletines de denuncia de forma telemática
• Recibir acuses de recibo y números oficiales de boletín
• Consultar el estado de tramitación de denuncias enviadas

Ventajas de la integración

• Velocidad: Consultas en 1-2 segundos vs llamadas telefónicas de varios minutos
• Exactitud: Datos directos de la base de datos oficial, sin errores de transcripción
• Disponibilidad: 24 horas al día, 7 días a la semana
• Automatización: El sistema rellena automáticamente los formularios con los datos obtenidos
• Trazabilidad: Todas las consultas quedan registradas

Datos consultables

Sobre vehículos:

• Marca, modelo, color, cilindrada
• Número de bastidor (VIN)
• Fecha de primera matriculación
• Titular actual (nombre, DNI, dirección)
• Estado de ITV (última inspección, resultado, próxima caducidad)
• Estado del seguro (compañía, número de póliza, vigencia)
• Cargas y gravámenes (embargos, reservas de dominio)
• Bajas temporales o definitivas

Sobre conductores:

• Clases de permiso que posee (A, B, C, D, etc.)
• Fecha de expedición y caducidad de cada clase
• Puntos disponibles en el permiso
• Estado del permiso (vigente, suspendido, retirado)
• Antecedentes de sanciones (últimos 5 años)

Capítulo 2: Requisitos y configuración

Alta en TESTRA

El ayuntamiento debe solicitar el alta en TESTRA a la Jefatura Provincial de Tráfico correspondiente:

1. Solicitud formal firmada por el alcalde o concejal responsable
2. Documentación: CIF del ayuntamiento, competencias de la gestión municipal
3. Designación de un responsable técnico de la integración
4. Aceptación de las condiciones de uso y protección de datos

El proceso de alta puede tardar 2-4 semanas. Una vez aprobado, la DGT proporciona:

• Usuario TESTRA del ayuntamiento
• URL del servicio web (entorno de producción y test)
• Certificado digital del servicio TESTRA (para validación)
• Documentación técnica del protocolo

Certificado digital

Se requiere certificado digital del ayuntamiento (no personal). Certificados aceptados:

• Certificado de entidad local emitido por FNMT-RCM
• Certificado de administración pública de otras CA reconocidas

El certificado debe instalarse en el servidor donde corre ayuntamientosmart.com.

Configuración del sistema

En Configuración > Integraciones > DGT TESTRA, configure:

• Habilitar integración: Sí
• Usuario TESTRA: El usuario proporcionado por la DGT
• URL del servicio: https://testra.dgt.es/WSTESTRAv4 (producción)
• Ruta del certificado: /ruta/al/certificado.p12
• Contraseña del certificado: (si el .p12 está protegido)
• Timeout de consultas: 10 segundos (recomendado)
• Caché de consultas: 1 hora (para evitar consultas duplicadas)

Haga clic en 'Probar conexión' para verificar que todo funciona correctamente.

Capítulo 3: Consulta de vehículos

Consulta por matrícula

La operación más común es consultar los datos de un vehículo introduciendo su matrícula:

Desde la interfaz de usuario:

1. Vaya a Vehículos > Consultar DGT
2. Introduzca la matrícula (ej: 1234ABC) sin espacios ni guiones
3. Haga clic en 'Consultar'
4. En 1-2 segundos aparecerán todos los datos del vehículo

Desde el módulo de sanciones:

Al crear una sanción, al introducir la matrícula el sistema consulta automáticamente la DGT y rellena todos los campos (marca, modelo, titular, etc.)

Datos devueltos

La respuesta de TESTRA incluye:

{
  "matricula": "1234ABC",
  "bastidor": "VF1XXXXXXXXXXXX",
  "marca": "SEAT",
  "modelo": "IBIZA 1.2 TSI",
  "color": "BLANCO",
  "cilindrada": 1197,
  "fecha_matriculacion": "2020-05-15",
  "titular": {
    "tipo_persona": "F", // F=Física, J=Jurídica
    "nif": "12345678A",
    "nombre": "JOSE MARTINEZ GARCIA",
    "direccion": {
      "via": "CALLE EJEMPLO",
      "numero": "15",
      "piso": "3",
      "puerta": "A",
      "cp": "28001",
      "municipio": "MADRID",
      "provincia": "MADRID"
    }
  },
  "itv": {
    "ultima_inspeccion": "2025-04-10",
    "resultado": "FAVORABLE",
    "proxima_inspeccion": "2027-04-10",
    "caducada": false
  },
  "seguro": {
    "compania": "MAPFRE SEGUROS",
    "numero_poliza": "ES123456789",
    "fecha_efecto": "2025-01-01",
    "fecha_vencimiento": "2026-01-01",
    "vigente": true
  },
  "cargas": [
    {
      "tipo": "EMBARGO",
      "organismo": "AEAT",
      "fecha": "2024-06-15",
      "importe": 5000.00
    }
  ],
  "baja": null // null si está activo, o fecha de baja si está dado de baja
}

Validaciones automáticas

El sistema detecta automáticamente situaciones irregulares:

• ITV caducada: Marca en rojo y sugiere añadir infracción adicional
• Seguro sin vigencia: Alerta grave, permite iniciar procedimiento de retirada de vehículo
• Vehículo embargado: Información relevante para posible inmovilización
• Vehículo dado de baja: No debería circular, infracción grave

Capítulo 4: Consulta de conductores

Consulta por número de permiso

Para consultar los datos del permiso de conducir:

1. Introduzca el número del permiso (ej: ES987654321)
2. El sistema consulta a TESTRA
3. Devuelve clases de permiso, puntos, estado, etc.

Datos devueltos

{
  "numero_permiso": "ES987654321",
  "nif_titular": "12345678A",
  "nombre_titular": "JOSE MARTINEZ GARCIA",
  "clases": [
    {
      "clase": "B",
      "fecha_expedicion": "2010-06-15",
      "fecha_caducidad": "2025-06-15",
      "vigente": true
    },
    {
      "clase": "A2",
      "fecha_expedicion": "2015-03-20",
      "fecha_caducidad": "2025-06-15",
      "vigente": true
    }
  ],
  "puntos_disponibles": 8, // De 0 a 15 puntos
  "estado": "VIGENTE", // VIGENTE, SUSPENDIDO, RETIRADO
  "suspension": null, // O datos de suspensión si aplica
  "antecedentes": [
    {
      "fecha": "2024-03-15",
      "infraccion": "Exceso de velocidad",
      "puntos_detraidos": 4,
      "importe": 200.00
    }
  ]
}

Cálculo automático de puntos tras sanción

Al imponer una sanción que detrae puntos, el sistema:

1. Consulta los puntos disponibles del conductor
2. Calcula los puntos resultantes tras la nueva sanción
3. Si quedaría con 0 puntos, alerta de pérdida de vigencia del permiso
4. Sugiere procedimientos adicionales (curso de recuperación de puntos)

Capítulo 5: Envío de boletines de denuncia

Proceso de envío

Una vez creada una sanción en el sistema, puede enviarse a la DGT:

1. Complete todos los datos de la sanción (vehículo, conductor, infracción)
2. Firme electrónicamente la sanción
3. Haga clic en 'Enviar a DGT'
4. El sistema genera el boletín en formato XML según especificaciones TESTRA
5. Envía el boletín mediante web service SOAP
6. Recibe acuse con número oficial de boletín DGT
7. Almacena el número de boletín vinculado a la sanción

Formato del boletín

El boletín se envía en formato XML:

<BoletinDenuncia>
  <Vehiculo>
    <Matricula>1234ABC</Matricula>
    <Bastidor>VF1XXXXXXXXXXXX</Bastidor>
  </Vehiculo>
  <Conductor>
    <NIF>12345678A</NIF>
    <Nombre>JOSE MARTINEZ GARCIA</Nombre>
    <NumeroPermiso>ES987654321</NumeroPermiso>
  </Conductor>
  <Infraccion>
    <Codigo>3.1</Codigo>
    <Descripcion>Circular en sentido contrario</Descripcion>
    <Articulo>Art. 29 RGC</Articulo>
    <Calificacion>GRAVE</Calificacion>
    <Importe>200.00</Importe>
    <Puntos>4</Puntos>
  </Infraccion>
  <DatosInfraccion>
    <Fecha>2026-01-10</Fecha>
    <Hora>15:30</Hora>
    <Lugar>CALLE ALCALA 100, MADRID</Lugar>
    <CodigoPostal>28001</CodigoPostal>
  </DatosInfraccion>
  <TécnicoDenunciante>
    <TIP>12345</TIP>
    <Nombre>JUAN GARCIA PEREZ</Nombre>
  </TécnicoDenunciante>
  <TipoDenuncia>IN_SITU</TipoDenuncia>
  <FechaNotificacion>2026-01-10T15:30:00</FechaNotificacion>
</BoletinDenuncia>

Acuse de recibo

La DGT devuelve un acuse con:

• Número de boletín oficial: Identificador único en la DGT (ej: DGT2026-MAD-00123456)
• Fecha de registro: Timestamp exacto del registro en la DGT
• Estado: ACEPTADO o RECHAZADO
• Motivo de rechazo: Si fue rechazado, descripción del error

El acuse queda almacenado vinculado a la sanción para auditoría.

Capítulo 6: Envío masivo de remesas

En lugar de enviar boletines uno a uno, puede generarse una remesa con múltiples boletines:

Creación de remesa

1. Vaya a Sanciones > Remesas DGT
2. Haga clic en 'Nueva remesa'
3. Seleccione las sanciones pendientes de enviar (filtro automático)
4. Revise el listado (puede excluir alguna sanción si es necesario)
5. Haga clic en 'Generar remesa'
6. El sistema crea un archivo XML con todos los boletines
7. Firma el archivo con el certificado del ayuntamiento
8. Envía la remesa a TESTRA

Procesamiento de la remesa

La DGT procesa la remesa de forma asíncrona:

1. Acusa recibo de la remesa (confirmación de recepción del archivo)
2. Procesa cada boletín individualmente (puede tardar minutos u horas según carga)
3. Genera un archivo de respuesta con el resultado de cada boletín
4. El sistema descarga automáticamente el archivo de respuesta
5. Actualiza el estado de cada sanción según el resultado (aceptada/rechazada)

Gestión de rechazos

Si algún boletín es rechazado (datos incorrectos, matrícula inexistente, etc.):

1. El sistema marca la sanción como 'Rechazada por DGT'
2. Muestra el motivo del rechazo
3. El usuario debe corregir el error
4. Una vez corregido, puede reenviarse a DGT