Contrato Mandato Persona Jurídica
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/descargarPDF/mandatoPersonaJuridicaVenta/{id}
En este caso el {id} es el retornado en el json de la consulta consolidada.
📦 Estructura JSON
{
"primerApellido": "PÉREZ",
"segundoApellido": "RODRÍGUEZ",
"nombres": "JUAN CARLOS",
"tipoDocumento": "cc",
"numeroDocumento": "1234566734534",
"direccion": "CALLE 34 #12-45",
"ciudad": "BOGOTÁ",
"telefono": "321312323423",
"email": "juan.perez@example.com",
"tieneSegundoPropietario": true,
"primerApellidoSegundoPropietario": "PÉREZ",
"segundoApellidoSegundoPropietario": "RODRÍGUEZ",
"nombresSegundoPropietario": "CARLOS ALBERTO",
"tipoDocumentoSegundoPropietario": "cc",
"numeroDocumentoSegundoPropietario": "3232312323",
"direccionSegundoPropietario": "CALLE 34 #12-46, BOGOTÁ",
"nombreRepresentante": "JOSE CARLOS",
"fechaFirmaContrato": "20-10-2025",
"fechaEntrega": "20-10-2025",
"kilometrajeAproximado": "1233",
"fechaImportacion": null,
"numeroDocImportacion": "23123123",
"carroConPrenda": true,
"valorPrenda": "",
"prendaFavorDe": "",
"carroConInscripcionPrenda": false,
"metodoPago": "MP2",
"cuentaBancariaPago": "",
"precioTotal": "180000000",
"precioGarantia": "",
"hojaNegocio": "",
"garantiaSatisfaccion": false,
"garantiaTotal": false,
"seguroResponsabilidad": false,
"seguroTodoRiesgo": false,
"duplicadoPlaca": false,
"duplicadoLicencia": false,
"datosComprador": true
}
Estructura JSON de Envío
🧍 Datos del Propietario Principal
| Atributo | Tipo | Requerido | Descripción |
|---|---|---|---|
primerApellido | String | ✅ | Primer apellido del comprador principal. |
segundoApellido | String | ✅ | Segundo apellido del comprador principal. |
nombres | String | ✅ | Nombres completos del comprador principal. |
tipoDocumento | String | ✅ | Tipo de documento de identidad del comprador. Debe ser uno de los siguientes valores: - cc → Cédula de ciudadanía.Documento de identificación nacional para ciudadanos colombianos. - ce → Cédula de extranjería.Documento de identificación para extranjeros residentes en Colombia. - nit → Número de Identificación Tributaria.Utilizado para empresas o personas jurídicas registradas ante la DIAN. - ti → Tarjeta de identidad.Documento de identificación para menores de edad en Colombia. - pa → Pasaporte.Documento de identificación internacional emitido por un país a sus ciudadanos. - ppt → Permiso por Protección Temporal.Documento otorgado a migrantes en situación de protección temporal. - cd → Carné diplomático.Documento de identificación emitido a funcionarios diplomáticos acreditados en Colombia. |
numeroDocumento | String | ✅ | Número del documento de identidad del comprador. |
direccion | String | ✅ | Dirección completa del comprador. |
ciudad | String | ✅ | Ciudad de residencia del comprador. |
telefono | String | ✅ | Teléfono de contacto del comprador. |
email | String | ✅ | Correo electrónico del comprador. |
🧍♂️ Datos del Segundo Propietario
| Atributo | Tipo | Requerido | Descripción |
|---|---|---|---|
tieneSegundoPropietario | Boolean | ✅ | Indica si el vehículo tiene un segundo comprador. Si es true, los siguientes campos son obligatorios. |
primerApellidoSegundoPropietario | String | ⚙️ Condicional | Primer apellido del segundo comprador. |
segundoApellidoSegundoPropietario | String | ⚙️ Condicional | Segundo apellido del segundo comprador. |
nombresSegundoPropietario | String | ⚙️ Condicional | Nombres completos del segundo comprador. |
tipoDocumentoSegundoPropietario | String | ⚙️ Condicional | Tipo de documento del segundo propietario (mismos valores que tipoDocumento). |
numeroDocumentoSegundoPropietario | String | ⚙️ Condicional | Número del documento del segundo comprador. |
direccionSegundoPropietario | String | ⚙️ Condicional | Dirección del segundo comprador. |
🚗 Datos del Vehículo y Venta
| Atributo | Tipo | Requerido | Descripción |
|---|---|---|---|
fechaFirmaContrato | String (formato dd-MM-yyyy) | ✅ | Fecha en la que se firma el contrato de compraventa. |
fechaEntrega | String (formato dd-MM-yyyy) | ✅ | Fecha acordada para la entrega del vehículo. |
fechaImportacion | String (formato dd-MM-yyyy) | ⚙️ Opcional | Fecha de importación del vehículo (si aplica). |
numeroDocImportacion | String | ⚙️ Opcional | Número del documento de importación (si aplica). |
kilometrajeAproximado | String | ✅ | Kilometraje aproximado del vehículo al momento de la venta. |
carroConPrenda | Boolean | ✅ | Indica si el vehículo tiene prenda activa. Si es true, deben completarse valorPrenda y prendaFavorDe. |
carroConInscripcionPrenda | Boolean | ✅ | Indica si el vehículo cuenta con inscripción formal de prenda ante las autoridades. |
valorPrenda | Number o String | ⚙️ Condicional | Valor monetario de la prenda del vehículo (si carroConPrenda = true). |
prendaFavorDe | String | ⚙️ Condicional | Entidad o persona a favor de la cual está constituida la prenda. |
duplicadoPlaca | Boolean | ✅ | Indica si el vehículo posee duplicado de placa. |
duplicadoLicencia | Boolean | ✅ | Indica si se trata de un duplicado de la licencia del vehículo. |
💰 Información de Pago y Negocio
| Atributo | Tipo | Requerido | Descripción |
|---|---|---|---|
metodoPago | String | ✅ | Código que indica el método de pago utilizado en la transacción. Valores posibles: - MP1 → Pago de prenda y valor restante por transferencia.- MP2 → Transferencia bancaria (pago total por transferencia).- MP3 → Trade-in con un vehículo y transferencia bancaria del saldo restante. |
cuentaBancariaPago | String | ⚙️ Opcional | Número o descripción de la cuenta bancaria donde se realizará el pago. |
precioTotal | Number o String | ✅ | Valor total de la compraventa del vehículo, expresado en la moneda local. |
hojaNegocio | String | ⚙️ Opcional | Código o número interno de la negociación. |
precioGarantia | String o Number | ⚙️ Opcional | Valor asociado a la garantía, si el vehículo incluye una cobertura adicional. |
Al finalizar la ejecución del servicio, y en caso de presentarse una alerta de riesgo, se envía automáticamente un correo electrónico a los usuarios con perfil “Administrador” de la empresa.