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:
- Solicitud formal firmada por el alcalde o concejal responsable
- Documentación: CIF del ayuntamiento, competencias de la gestión municipal
- Designación de un responsable técnico de la integración
- 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:
- Vaya a Vehículos > Consultar DGT
- Introduzca la matrícula (ej: 1234ABC) sin espacios ni guiones
- Haga clic en 'Consultar'
- 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:
- Introduzca el número del permiso (ej: ES987654321)
- El sistema consulta a TESTRA
- 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:
- Consulta los puntos disponibles del conductor
- Calcula los puntos resultantes tras la nueva sanción
- Si quedaría con 0 puntos, alerta de pérdida de vigencia del permiso
- 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:
- Complete todos los datos de la sanción (vehículo, conductor, infracción)
- Firme electrónicamente la sanción
- Haga clic en 'Enviar a DGT'
- El sistema genera el boletín en formato XML según especificaciones TESTRA
- Envía el boletín mediante web service SOAP
- Recibe acuse con número oficial de boletín DGT
- 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
- Vaya a Sanciones > Remesas DGT
- Haga clic en 'Nueva remesa'
- Seleccione las sanciones pendientes de enviar (filtro automático)
- Revise el listado (puede excluir alguna sanción si es necesario)
- Haga clic en 'Generar remesa'
- El sistema crea un archivo XML con todos los boletines
- Firma el archivo con el certificado del ayuntamiento
- Envía la remesa a TESTRA
Procesamiento de la remesa
La DGT procesa la remesa de forma asíncrona:
- Acusa recibo de la remesa (confirmación de recepción del archivo)
- Procesa cada boletín individualmente (puede tardar minutos u horas según carga)
- Genera un archivo de respuesta con el resultado de cada boletín
- El sistema descarga automáticamente el archivo de respuesta
- 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.):
- El sistema marca la sanción como 'Rechazada por DGT'
- Muestra el motivo del rechazo
- El usuario debe corregir el error
- Una vez corregido, puede reenviarse a DGT