Crear vehículo desde RUNT

POST

/api/v1/external/vehiculos/crear

Consulta la API del RUNT con la placa y documento del propietario, obtiene todos los datos del vehículo (SOAT, RTM, RCC, RCE, tarjeta de operación, datos técnicos) y lo registra en el sistema. Si el vehículo ya existe, retorna error.

Solicitud

Autorización

Parámetros del Body application/jsonRequerido

Ejemplos

Solo campos obligatoriosCon datos del propietario

{
    "placa": "ABC123",
    "documento": "1022943269"
}

Ejemplos de solicitud

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Solo campos obligatoriosCon datos del propietario

curl --location '/api/v1/external/vehiculos/crear' \
--header 'Content-Type: application/json' \
--data '{
    "placa": "ABC123",
    "documento": "1022943269"
}'

Respuestas

🟢201

application/json

Vehículo creado exitosamente

Bodyapplication/json

Ejemplo

{
    "resultado": "OK",
    "datos": {
        "placa": "ABC123",
        "documento": "1022943269",
        "updated": true,
        "camposActualizadosDbReservas": [
            "marca",
            "linea",
            "modelo",
            "color",
            "clase",
            "vencimiento_soat",
            "vencimiento_tecnomecanica"
        ],
        "documentosS3": "procesando en background",
        "runt": {
            "placa": "ABC123",
            "marca": "CHEVROLET",
            "linea": "SPARK GT",
            "modelo": "2020",
            "color": "BLANCO",
            "clase": "AUTOMOVIL",
            "tipoServicio": "PUBLICO",
            "estadoAutomotor": "Activo",
            "cilindraje": "1206",
            "tipoCombustible": "GASOLINA"
        }
    }
}

🟠400

🟠401

🟠429

🔴500

Modificado en 2026-03-03 23:48:47

Obtener datos de preoperacional con paginación y filtros

Obtener vehiculos