Licencias de Conducción

Para consumir el servicio REST, es necesario hacer un llamado POST, usando una autenticación básica en los “headers" con el usuario y la contraseña proporcionados.

🔗 Endpoints disponibles

POSThttp://localhost:8081/app/servicioRuntCedulaLicencias

📦 Estructura JSON

{
	"tipoDocumento": "cc",
	"numeroDocumento": "39430590",
	"primerApellido": "GARCIA"
}

Estructura JSON de Envío

La solicitud al servicio debe enviarse en formato JSON, con los siguientes atributos:

Atributo	Tipo	Descripción
tipoDocumento	String	Campo que indica el tipo de documento a consultar. Ejemplo: Cédula, pasaporte, etc.
numeroDocumento	String	Campo que indica Número del documento de identidad a consultar.
primerApellido	String	Campo que indica el primer apellido de la persona a consultar.

Tipos de documentos permitidos

El campo tipoDocumento debe enviarse como uno de los siguientes códigos:

Código	Descripción
cc	Cédula de ciudadanía
ce	Cédula de extranjería
cd	Carnet diplomático
pep	Permiso Especial de Permanencia
ti	Tarjeta de identidad
pa	Pasaporte
ppt	Permiso por protección temporal
rc	Registro civil

🧾 Respuesta

✅ Ejemplo de respuesta (200 OK)

{
    "idConsulta": "6a68e3ddb8b51684e49fd9a6",
    "numeroDocumento": "39430590",
    "licencias": [
        {
            "numeroLicencia": "1069723860",
            "otExpide": "SECRETARIA DISTRITAL DE MOVILIDAD DE BOGOTA ",
            "fechaExpedicion": "16/01/2026",
            "estadoLicencia": "ACTIVA",
            "detalleLicencia": [
                {
                    "categoria": "C1",
                    "fechaExpedicion": "2026-01-16T14:46:35.000-05:00",
                    "fechaVencimiento": "2029-01-16T00:00:00.000-05:00"
                },
                {
                    "categoria": "B1",
                    "fechaExpedicion": "2026-01-16T14:46:35.000-05:00",
                    "fechaVencimiento": "2036-01-16T00:00:00.000-05:00"
                }
            ]
        }
    ],
    "error": null
}

Estructura JSON de Respuesta

En todos los casos exitosos, se retorna una estructura JSON con los siguientes atributos:

Atributo	Tipo	Descripción
idConsulta	String	Campo que indica el id de la consulta.
numeroDocumento	String	Campo que indica el número de documento consultado.
licencias	Array<JSONObject>	Listado de licencias de conducción encontradas asociadas al documento consultado.
error	null	Campo que siempre se retorna como null en las respuestas exitosas.

Cada objeto del arreglo licencias tiene la siguiente estructura:

Atributo	Tipo	Descripción
numeroLicencia	String	Campo que indica el número de la licencia de conducción.
otExpide	String	Campo que indica el organismo de tránsito que expidió la licencia.
fechaExpedicion	String	Campo que indica la fecha de expedición de la licencia, en formato dd/MM/yyyy.
estadoLicencia	String	Campo que indica el estado actual de la licencia. Valores posibles: ACTIVA, INACTIVA, VENCIDA.
detalleLicencia	Array<JSONObject>	Listado de las categorías habilitadas en la licencia.

Cada objeto del arreglo detalleLicencia tiene la siguiente estructura:

Atributo	Tipo	Descripción
categoria	String	Campo que indica la categoría de la licencia. Ejemplo: A2, B1, C1.
fechaExpedicion	String	Campo que indica la fecha y hora de expedición de la categoría, en formato ISO 8601.
fechaVencimiento	String	Campo que indica la fecha de vencimiento de la categoría, en formato ISO 8601.
categoriaAntigua	String	Campo que indica el código de la categoría bajo la nomenclatura anterior. Solo se incluye cuando aplica.

El campo serialVersionUID presente en la respuesta original del servicio es un identificador interno de serialización y no aporta información relevante para el consumidor del servicio.

❌ Ejemplo de respuesta de error

En caso de que exista un error en el servicio se devuelve un Json Object

{
  "statusCode": 401,
  "error": "La empresa no tiene permisos para consumir este servicio"
}

{
  "statusCode": 500,
  "error": "Ha ocurrido un error interno, contacte con el administrador"
}

Estructura JSON Response Error

Atributo	Tipo	Descripción
statusCode	Int	Campo que indica el código de estado de respuesta HTTP
error	String	Campo que indica mensaje con detalle del error ocurrido