Uploaded by Pablo Andres Gomez Rodriguez

Mundial - Manual de Usuario WS SOATyAP - SOAP v3.9

advertisement
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
MANUAL DE USUARIO
WEB SERVICES SOAT PROTOCOLO SOAP
Compañía Mundial de Seguros
Diciembre, 2021
Manual de Usuario
Página 1 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
CONTROL DE CAMBIOS
Versión
1.0
2.0
Fecha
01/01/2011
01/11/2012
Descripción
Documento Inicial
Inclusión de venta de pólizas de AP
Autor
Erwin Zárate – GTC
Mario Niño - GTC
2.1
01/08/2013
Ajustes en la tarifación actual
Mario Niño - GTC
2.2
05/10/2016
Métodos agregados Numeral 5.1.30 al 5.1.39
Andrés Quintero DyD
2.3
2.4
2.5
2.6
2.7
2.8
05/12/2016
19/01/2017
17/02/2017
12/10/2017
19/12/2017
31/05/2018
Ingreso aplicación, manual técnico y tarifación
Consumo y expedición métodos AP
Cotizador y diccionario de errores
Etiqueta fec naci y porcentaje descuento
Campos Integración recaudo PAYU
Andrés Camacho DyD
Andrés Camacho DyD
Andrés Camacho DyD
Andrés Camacho DyD
Andrés Camacho DyD
Andrés Camacho DyD
2.9
29/10/2018
Inclusión de emisión pólizas RCE autos –
ap
3.0
11/06/2019
Ajuste de métodos y diagrama de
Jessica Millán GSN
actividades para el proceso de expedición
3.1
28/08/2019
Se agrega método ExpedirPoliza y
AnulacionPoliza para la gestión de
individuales
3.5
Metdo
DescargarArchivoPolElectronica(5.1.41)
Finalización póliza Fasecolda (5.3.6)
DescargarArchivoPolElectronica
16/06/2020 Se agrega método
Andrés Camacho DyD
Nicol Martinez MNS
Leonardo Wilches
ConsultarInfoVehiculoRuntDocFasec
3.6
05/05/2021 Se agrega método ConsultarPropietarios Alejandro Arias
3.7
22/07/2021 Se agregan errores y validaciones de
Nicol Martinez MNS
Documento de identidad, Dirección y
Nombres.
Manual de Usuario
Página 2 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
3.8
28/072021 Se agrega método AnularPolizaXML y
Jessica Millan
actualización método expedirPolizaXML
3.9
21/12/2021 Se agrega campos al método
Jessica Millan
CalcularPoliza
Contenido
1.
INTRODUCCIÓN
5
2.
REQUERIMIENTOS DEL SISTEMA
5
3.
VALIDACIONES QUE REALIZA LA APLICACIÓN
5
3.1.
VALIDACIÓN EXPEDICIÓN DE POLIZAS SOAT
5
3.2.
VALIDACIÓN DE CARACTERES ESPECIALES
7
3.3.
VALIDACION DEL FORMATO DE LA PLACA
8
3.4.
VALIDACION EN LAS VIGENCIAS DE LA POLIZA SOAT
8
3.5.
VALIDACION DE LA INFORMACION SOAT
9
3.6.
VALIDACIONES ESPECÍFICAS PARA REEEMPLAZOS SOAT
9
3.7.
VALIDACIONES ESPECÍFICAS PARA ANULACIONES SOAT
9
4.
PROCEDIMIENTO PARA LA CREACION DE USUARIOS
10
5.
INGRESO A LA APLICACIÓN
10
5.1.
METODOS WEB
10
5.1.1.
CONSULTAR FORMULARIOS DISPONIBLES
10
5.1.2.
CONSULTAR INFORMACION BASE DE DATOS
11
5.1.3.
CONSULTAR INFORMACIÓN DE UN FORMULARIO
12
5.1.4.
CONSULTAR CLASES DE VEHICULO
12
5.1.5.
CONSULTAR CARTERA
12
5.1.6.
CONSULTAR INFORMACIÓN DEL VEHICULO
12
5.1.7.
CONSULTAR SERVICIOS DE UN VEHICULO
12
5.1.8.
CONSULTAR MOTIVOS DE ANULACION
12
Manual de Usuario
Página 3 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
5.1.9.
CONSULTAR MOTIVOS DE REEMPLAZO
12
5.1.10. CONSULTAR TARIFAS
13
5.1.11. CONSULTAR TIPOS DE DIRECCION
13
5.1.12. CONSULTAR TIPOS DE DOCUMENTO
13
5.1.13. CONSULTAR TIPOS DE PERSONA
13
5.1.14. CONSULTAR ÚLTIMO ESTADO DE UN FORMULARIO
13
5.1.15. CONSULTAR ESTADO DEL FORMULARIO
13
5.1.16. DESCARGAR ARCHIVO PÓLIZA ELETRÓNICA
13
5.1.17. DESCARGAR ARCHIVO PÓLIZA ELETRÓNICA SOAP CLIENTE
13
5.1.18. GENERAR TASA RUNT
14
5.1.19. CONSULTAR CONVENIO AP
14
5.1.20. SOLICITAR PAPELERÍA AL INTERMEDIARIO
14
5.1.21. CONSULTAR INFORMACIÓN TOMADOR ACCIDENTES PERSONALES
14
5.1.22. CONSULTAR TIPOS DE PÓLIZAS DE ACCIDENTES PERSONALES
14
5.1.23. CONSULTAR CANTIDAD DE PÓLIZAS DE ACCIDENTES PERSONALES POR TOMADOR
14
5.1.24. CONSULTAR INFORMACIÓN DEL VEHICULO RUNT BASICA
15
5.1.25. CONSULTAR INFORMACIÓN DEL VEHICULO RUNT PROPIETARIO
18
5.1.26. CONSULTAR INFORMACIÓN DEL VEHICULO RUNT PROPIETARIO Y CÓDIGO FASECOLDA
ConsultarInfoVehiculoRuntDocFasec
23
5.1.27. CONSULTAR INFORMACIÓN PROPIETARIOS
28
5.1.28. CALCULAR POLIZA
33
5.1.29. EXPEDIR POLIZA XML
41
5.1.30. ANULAR POLIZA
54
5.2.
TAMAÑO DE LA TRANSACCIÓN Y DE LOS ARCHIVOS A INTERCAMBIAR
56
6.
PROCESO DE EXPEDICIÓN
56
7.
DICCIONARIO DE ERRORES
59
Manual de Usuario
Página 4 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
1. INTRODUCCIÓN
En el presente manual se muestra el funcionamiento general y validaciones correspondientes de
la aplicación para la expedición de pólizas del Seguro Obligatorio de Accidentes de Tránsito
“SOAT”, en los consumos que se realizan a través del Web Service.
WSDL /SOATMundial.asmx?wsld
2. REQUERIMIENTOS DEL SISTEMA
El ingreso al sistema debe realizarse vía Web en computadores (servidores) con las siguientes
características mínimas:
Sistema operativo
Memoria equipo
Canal de comunicaciones
Windows 7 o Superior
1 GB o superior
Banda Ancha óptimo 1M en adelante
3. VALIDACIONES QUE REALIZA LA APLICACIÓN
3.1. VALIDACIÓN EXPEDICIÓN DE POLIZAS SOAT
Validaciones utilizadas dentro de la aplicación Web de SOAT y que deben ser aplicadas para
los diferentes procesos - validación de campos:
MODELO (AÑO)
-
Manual de Usuario
Debe ser numérico.
No puede ser cero.
No puede ser menor a 1900 por antigüedad.
No puede ser superior a un año hacia el futuro (ej. Año actual 2019, año de modelo del
vehículo 2021).
Página 5 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
IDENTIFICACIÓN DEL TOMADOR
-
Debe ser numérico.
Debe tener mínimo 4 dígitos (la cantidad de caracteres varia conforme al tipo de
identificación del tomador)
Si es NIT, debe tener 9 digitos
No puede ser cero (0)
TELEFONO
-
Debe tener mínimo 7 dígitos.
DIRECCION
-
Debe tener mínimo 6 dígitos.
MOTOR Y CHASIS
-
Cada uno debe tener mínimo 4 caracteres.
CAPACIDAD
-
Debe ser numérico.
Si es clase de vehículo 3 “CARGA O MIXTOS”, la capacidad no puede ser cero.
Si es clase de vehículo 3 “CARGA O MIXTOS” y la capacidad es igual a 1, se indica que debe
seleccionar la clase de vehículo 2 “CAMPEROS Y CAMIONETAS”.
PASAJEROS
-
Debe ser numérico.
No puede ser mayor a 99.
La cantidad de pasajeros no puede ser cero, en ninguna tarifa.
CILINDRAJE
-
Manual de Usuario
Debe ser numérico
Si la clase de vehículo es diferente a 3 “CARGA O MIXTOS”, el cilindraje debe tener mínimo
2 dígitos.
Página 6 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Si el tipo de combustible de la clase de vehículo es diferente a “ELECTRICO”, el cilindraje
no puede ser cero.
-
LINEA DEL VEHICULO
Si se selecciona la opción SIN LINEA dentro de una marca, debe ingresar la descripción de
la línea.
-
3.2. VALIDACIÓN DE CARACTERES ESPECIALES
Para los siguientes campos:
-
Modelo (Año)
Placa
Cilindraje
Motor
Chasis
Capacidad
Pasajeros
Documento tomador
Nombre
Apellido 1
Apellido 2
Dirección
No se permite que contengan alguno de los siguientes caracteres especiales:
●
●
●
●
●
●
●
●
●
●
●
Slash "/"
Asterisco "*"
Arroba "@"
Ampersand "&" Excepto en el campo razón social (Apellido 1)
Porcentaje "%"
Coma "," Excepto en el campo capacidad para los decimales
Punto y coma ";"
Dos puntos ":"
Signos de admiración "!", "¡"
Signos de interrogación "¿", "?",
Llaves "{", "}"
Manual de Usuario
Página 7 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
●
●
●
●
Cedilla "ç"
Signo pesos "$"
Igual "="
Comilla Sencilla "'"
3.3. VALIDACION DEL FORMATO DE LA PLACA
Para la placa se validan diferentes formatos dependiendo de la clase:
A: Letra A-Z
#: Numero de 0-9
Clase 1 “MOTOCICLETA” y 10 “MOTOCARRO”
-
AAA##
AAA##A
-
-
Clase 3 “CARGA O MIXTO”
AAA### AAA## AAA##A
AA###
AA####
Clase 4 “OFICIALES”
AAA### AA####
Otras Clases
-
AAA###
3.4. VALIDACION EN LAS VIGENCIAS DE LA POLIZA SOAT
-
-
Manual de Usuario
Valida que los días, meses y años de las fechas de expedición, vigencia desde y vigencia
hasta, estén dentro de los rangos correctos.
Valida que la fecha vigencia desde no sea mayor que la fecha vigencia hasta.
Valida que la vigencia sea de un año.
Si existe una póliza vigente para la placa, solo permite la expedición con anticipación de
30 días o menos para que finalice la póliza vigente, teniendo en cuenta que no se crucen
las vigencias.
Solo permite expedir pólizas que empiezan vigencia hasta máximo 30 días hacia el futuro.
Valida que no exista una póliza vigente para la placa en las mismas vigencias de la póliza
que se está expidiendo.
Solo permite anular las pólizas hasta el mismo día antes de que inicien vigencia.
No se permite la expedición de pólizas retroactivas.
Página 8 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
3.5. VALIDACION DE LA INFORMACION SOAT
-
El año del modelo debe ser superior a 1900
El año del modelo puede ser hasta máximo un (1) año mayor que el año actual
El campo de pasajeros requiere un valor numérico mayor a cero.
Si no es anulación, el formulario que va a ser expedido debe estar disponible y debe estar
asignado al punto de venta que lo va a expedir.
La vigencia del endoso debe ser de un año.
Como máximo puede haber una diferencia de 2 pesos entre la prima total recibida y la
prima total definida.
La antigüedad del vehículo debe estar entre 0 y 99.
Los datos del vehículo: pasajeros, capacidad, cilindraje y antigüedad se deben encontrar
dentro de los rangos establecidos para cada tarifa.
La fecha de expedición debe ser menor o igual a la fecha de inicio de vigencia.
El número de documento del tomador se debe encontrar dentro del rango definido
según el tipo de persona (Jurídica, Natural), el tipo de documento y el sexo.
Si la placa es diferente de TL (transito libre), se verifica que no exista ninguna otra póliza
vigente para la placa.
Si el código de marca es ZZ y no viene texto de marca, se asigna el texto “SIN MARCA”.
Si el código de modelo es 999 y no viene texto del modelo, se asigna el texto “SIN LINEA”.
Como máximo puede haber una diferencia de 2 pesos entre la prima + la contribución
correspondiente para la tarifa en nuestra base de datos, y la prima total recibida.
3.6. VALIDACIONES ESPECÍFICAS PARA REEEMPLAZOS SOAT
-
Se verifica que exista la póliza que se va a reemplazar.
La vigencia del endoso debe ser igual a la de la póliza original.
Se verifica que el código del motivo sea válido para un reemplazo.
La prima total y los gastos deben ser iguales, porque ambos deben ser cero.
3.7. VALIDACIONES ESPECÍFICAS PARA ANULACIONES SOAT
-
Manual de Usuario
La vigencia del endoso debe ser igual a la póliza original.
Se verifica que la póliza no esté cancelada para permitir la anulación.
Si la póliza tiene más de un endoso no se puede anular
Si la póliza esta recaudada no se puede anular.
La prima de la anulación (devolución) y la prima de la expedición pueden tener como
Página 9 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
máximo una diferencia de 2 pesos.
4. PROCEDIMIENTO PARA LA CREACION DE USUARIOS
Para la creación y activación de un nuevo usuario para la expedición de pólizas del Seguro
Obligatorio de Accidentes de Tránsito “SOAT” u otro producto, es necesario contar con la
siguiente información obligatoria:
Identificar a la persona encargada
El intermediario debe recopilar la siguiente información sobre la persona que va a estar
encargada de la expedición en el área de tecnología:
-
Nombre completo.
Número de documento.
E-mail.
Teléfono.
Enviar información a la sucursal
El intermediario debe enviar la información recopilada a la sucursal y/o gerencia de producto
para continuar el proceso de asignación de usuario.
5. INGRESO A LA APLICACIÓN
Para ingresar al servicio y a los métodos expuestos se realiza por IP pública notificando cual
es la IP desde la cual se va a realizar la conexión para incluirla en una lista blanca de acceso
dado que para el consumo el sitio está protegido por validación de IP. Adicionalmente todos
los métodos requieren obligatoriamente autenticación básica, es decir, usuario y contraseña
que se asigna desde Seguros Mundial para que el consumo sea satisfactorio.
5.1. METODOS WEB
En esta sección se muestran los métodos web disponibles en el Web Service. Se encuentra
una descripción básica del método y los parámetros de entrada aplicables a la expedición del
producto SOAT y Accidentes Personales.
5.1.1. CONSULTAR FORMULARIOS DISPONIBLES
consultarFormulariosDisponibles
Este método retorna los formularios disponibles para una sucursal, un intermediario y un
punto de venta específicos (para el aliado permite conocer los formularios que se encuentran
disponibles para su uso en la expedición)
Manual de Usuario
Página 10 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Ilustración 1. Proceso para consulta y uso de formularios
5.1.2. CONSULTAR INFORMACION BASE DE DATOS
consultarInfoBD
Este método retorna la información de la base de datos a la cual está conectado. Hay que
verificar este método para diferenciar el ambiente de pruebas del ambiente de
producción. La base de datos se llama “producción” y la base de datos de pruebas puede
Manual de Usuario
Página 11 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
llamarse “pruebas” o “desarrollo”.
5.1.3. CONSULTAR INFORMACIÓN DE UN FORMULARIO
consultarInfoFormularioExp
Este método retorna la información de un formulario expedido específico (permite
conocer el estado en que se encuentra un formulario, es decir, si esta emitido o anulado,
etc).
5.1.4. CONSULTAR CLASES DE VEHICULO
consultarClases
Este método retorna el listado de clases de vehículos definidas por el Ministerio de
Transporte.
5.1.5. CONSULTAR CARTERA
consultarCartera
Este método permite consultar la información de la lectura de los valores de cartera por
el código del asegurado.
5.1.6. CONSULTAR INFORMACIÓN DEL VEHICULO
consultarInfoVehiculo
Este método retorna la información de un vehículo para una placa específica (como un
historial de la placa en el sistema de seguros mundial, las expediciones que ha tenido y
sus datos correspondientes)
5.1.7. CONSULTAR SERVICIOS DE UN VEHICULO
consultarServicios
Este método retorna el listado de servicios de un vehículo definidos por el Ministerio de
transporte.
5.1.8. CONSULTAR MOTIVOS DE ANULACION
consultarMotivosAnulacion
Este método retorna los motivos posibles de anulación de una póliza.
5.1.9. CONSULTAR MOTIVOS DE REEMPLAZO
consultarMotivosReemplazo
Este método retorna los motivos posibles de reemplazo de una póliza (aplica para los
Manual de Usuario
Página 12 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
aliados que tienen habilitado el reemplazo de pólizas)
5.1.10. CONSULTAR TARIFAS
consultarTarifas
Este método retorna las tarifas del año actual para todas las clases de vehículos.
5.1.11. CONSULTAR TIPOS DE DIRECCION
consultarTiposDireccion
Este método retorna el listado de tipos de dirección que puede tener el tomador.
5.1.12. CONSULTAR TIPOS DE DOCUMENTO
consultarTiposDocumento
Este método retorna los tipos de documento que puede tener el tomador para expedirle
una póliza.
5.1.13. CONSULTAR TIPOS DE PERSONA
consultarTiposPersona
Este método retorna los tipos de persona que se pueden seleccionar para el tomador.
5.1.14. CONSULTAR ÚLTIMO ESTADO DE UN FORMULARIO
consultarUltEstadoFormulario
Este método retorna el último movimiento que se ha realizado para un formulario
específico. Si el resultado es vacío, quiere decir que se ha expedido el formulario.
5.1.15. CONSULTAR ESTADO DEL FORMULARIO
consultarEstadoFormulario
Este Método retorna el estado actual del formulario ingresando el número del mismo.
5.1.16. DESCARGAR ARCHIVO PÓLIZA ELETRÓNICA
DescargarArchivoPolElectronica
Este método retorna la copia de la póliza expedida por el punto de venta en formato
binario
5.1.17. DESCARGAR ARCHIVO PÓLIZA ELETRÓNICA SOAP CLIENTE
DescargarArchivoPolElectronicaSoapClient
Este método retorna la copia de la póliza expedida por el punto de venta en formato
Manual de Usuario
Página 13 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
binario para el cliente soap
5.1.18. GENERAR TASA RUNT
generarTasaRunt
Este método retorna un valor de tasa RUNT para un formulario y un tipo de movimientos
específicos.
5.1.19. CONSULTAR CONVENIO AP
consultarConvenioAP
Este método retorna si un punto de venta tiene convenio para la venta de AP en caso
contrario devuelve nulo.
5.1.20. SOLICITAR PAPELERÍA AL INTERMEDIARIO
SolicitarPapeleriaIntermediario
Este método permite solicitar asignación de papelería en una cantidad de rangos que el
usuario ingrese
5.1.21. CONSULTAR INFORMACIÓN TOMADOR ACCIDENTES PERSONALES
ConsultarInfoTomadorAP
Este método permite consultar información del tomador de la póliza de accidentes
personales
5.1.22. CONSULTAR TIPOS DE PÓLIZAS DE ACCIDENTES PERSONALES
ConsultarTiposPolizaAP
Este método retorna el listado de los tipos de pólizas para el producto accidentes
personales habilitadas por año de vigencia, en las peticiones para el campo
<ap_tipo_poliza> validar convenio:
Tipos (Plan de póliza)
1-7/24
3-Plata
5-Platino
6-Diamante
5.1.23. CONSULTAR CANTIDAD DE PÓLIZAS DE ACCIDENTES PERSONALES POR
TOMADOR
consultarcntAP
Manual de Usuario
Página 14 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Este método retorna la cantidad de pólizas de accidentes personales para un tomador. Si
devuelve valor true significa que ha excedido la cantidad permitida, pero si devuelve valor
false quiere decir que aún puede tener más pólizas AP
5.1.24. CONSULTAR INFORMACIÓN DEL VEHICULO RUNT BASICA
ConsultarInfoVehiculoRunt
Este método retorna la información registrada en el organismo de tránsito.
Descripción de campos entrada
Campo
placa
puntoVta
Descripción
Placa del vehiculo
codigo de punto de venta
Tipo
string
long
Requerido
SI
SI
Descripción de campos salida
Campo
Descripción
idConsulta
id de la consulta al runt
string
Nullea
ble
NO
snConsultaRuntExitosa
estado de la consulta Runt
bool
NO
observacionesServicio
idTipoServicio
tipoServicio
idClaseVehiculo
claseVehiculo
idMarca
marca
idLinea
linea
aaaa_modelo
idColor
color
noSerie
noMotor
noChasis
mensaje de error
Id tipo servicio runt
Tipo servicio Runt
Id clase de vehiculo en el runt
Clase de vehiculo en el runt
Id de marca en el Runt
Marca del vehiculo
Id linea del veiculo en el runt
Linea del vehiculo
año del modelo
Id del color
Color del vehiculo
Nro de serie
Nro de motor
Nro de chasis
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
Manual de Usuario
Tipo
Página 15 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
noVin
cnt_cc
divipola
cnt_toneladas
pesoBrutoVehicular
cnt_ocupantes
codMarcaSise
codLineaSise
codClaseSise
cod_destino
homologaciones
idTipoCarroceria
tipoCarroceria
idTipoCombustible
tipoCombustible
estadoDelVehiculo
organismoTransito
Nro de Vin
nro de cilindros
codigo de municipio
capacidad de carga
peso del vehiculo
capacidad de pasajeros
codigo de marca vehiculo Seg Mun
codigo de linea vehiculo Seg Mun
codigo clase vehiculo Seg Mun
codigo de servicio vehiculo Seg Mun
listado de clases Seg Mundial de vehicul
o homologables con el runt
id tipo de carroceria
tipo de carroceria
id tipo de combustible
tipo de combustible
estado del vehiculo “ACTIVO” – “CANCE
LADO”
organismo de transito
string
string
string
string
string
string
string
string
string
int
List<HomologacionClaseMarcaLi
neaServicio>
string
string
int
string
string
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
int
SI
SI
SI
SI
SI
SI
Descripción de campos salida HomologacionClaseMarcaLineaServicio
Campo
Descripción
Tipo
clase
codMarcaSise
codLineaSise
codDestinoSise
objeto con definicion de clase vehiculo Seg
Mun
codigo de marca vehiculo Seg Mun
codigo de linea vehiculo Seg Mun
codigo de servicio vehiculo Seg Mun
`ClaseVehiculo`
string
string
int
Nulleable
NO
SI
SI
SI
Descripción de campos salida ClaseVehiculo
Campo
codClase
txtDesc
codTipoVehMinTrans
Descripción
codigo clase vehiculo Seg Mun
descripcion clase vehiculo Seg Mun
codigo de tipo vehiculo Min transportes
Tipo
int
string
int
Nulleable
NO
NO
SI
Request:
Manual de Usuario
Página 16 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
POST /SOATMundial.asmx HTTP/1.1
SOAPAction: "http://www.mundialseguros.com.co/ConsultarInfoVehiculoRunt"
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultarInfoVehiculoRunt xmlns="http://www.mundialseguros.com.co/">
<placa>string</placa>
<puntoVta>long</puntoVta>
</ConsultarInfoVehiculoRunt>
</soap:Body>
</soap:Envelope>
Response:
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultarInfoVehiculoRuntResponse xmlns="http://www.mundialseguros.com.co/">
<ConsultarInfoVehiculoRuntResult>
<idConsulta>string</idConsulta>
<snConsultaRuntExitosa>string</snConsultaRuntExitosa>
<observacionesServicio>string</observacionesServicio>
<idTipoServicio>string</idTipoServicio>
<tipoServicio>string</tipoServicio>
<idClaseVehiculo>string</idClaseVehiculo>
<claseVehiculo>string</claseVehiculo>
<idMarca>string</idMarca>
<marca>string</marca>
<idLinea>string</idLinea>
<linea>string</linea>
<aaaa_modelo>string</aaaa_modelo>
<idColor>string</idColor>
<color>string</color>
<noSerie>string</noSerie>
<noMotor>string</noMotor>
<noChasis>string</noChasis>
<noVin>string</noVin>
<cnt_cc>string</cnt_cc>
<divipola>string</divipola>
<cnt_toneladas>string</cnt_toneladas>
<pesoBrutoVehicular>string</pesoBrutoVehicular>
<cnt_ocupantes>string</cnt_ocupantes>
<codMarcaSise>string</codMarcaSise>
<codLineaSise>string</codLineaSise>
<codClaseSise>string</codClaseSise>
<cod_destino>string</cod_destino>
<homologaciones>
<HomologacionClaseMarcaLineaServicio>
<clase xsi:nil="true">
<codClase>int</codClase>
<txtDesc>string</txtDesc>
Manual de Usuario
Página 17 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<codTipoVehMinTrans>int</codTipoVehMinTrans>
</clase>
<codMarcaSise>string</codMarcaSise>
<codLineaSise>string</codLineaSise>
<codDestinoSise>int</codDestinoSise>
</HomologacionClaseMarcaLineaServicio>
<HomologacionClaseMarcaLineaServicio>
<clase xsi:nil="true">
<codClase>int</codClase>
<txtDesc>string</txtDesc>
<codTipoVehMinTrans>int</codTipoVehMinTrans>
</clase>
<codMarcaSise>string</codMarcaSise>
<codLineaSise>string</codLineaSise>
<codDestinoSise>int</codDestinoSise>
</HomologacionClaseMarcaLineaServicio>
</homologaciones>
<idTipoCarroceria>string</idTipoCarroceria>
<tipoCarroceria>string</tipoCarroceria>
<idTipoCombustible>string</idTipoCombustible>
<tipoCombustible>string</tipoCombustible>
<estadoDelVehiculo>string</estadoDelVehiculo>
<organismoTransito>string</organismoTransito>
</ConsultarInfoVehiculoRuntResult>
</ConsultarInfoVehiculoRuntResponse>
</soap:Body>
</soap:Envelope>
5.1.25. CONSULTAR INFORMACIÓN DEL VEHICULO RUNT PROPIETARIO
ConsultarInfoVehiculoRuntDoc
Este método retorna la información registrada en el organismo de tránsito, y una
colección con propietarios del vehiculo.
Descripción de campos entrada
Campo
placa
Descripción
Placa del vehiculo
Tipo
string
puntoVta
codigo de punto de venta
long
Requerido
SI
SI
Descripción de campos salida
Campo
Descripción
idConsulta
id de la consulta al runt
string
Nullea
ble
NO
snConsultaRuntExitosa
estado de la consulta Runt
bool
NO
Manual de Usuario
Tipo
Página 18 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
observacionesServicio
idTipoServicio
tipoServicio
idClaseVehiculo
claseVehiculo
idMarca
marca
idLinea
linea
aaaa_modelo
idColor
color
noSerie
noMotor
noChasis
noVin
cnt_cc
divipola
cnt_toneladas
pesoBrutoVehicular
cnt_ocupantes
codMarcaSise
codLineaSise
codClaseSise
cod_destino
homologaciones
idTipoCarroceria
tipoCarroceria
idTipoCombustible
tipoCombustible
estadoDelVehiculo
organismoTransito
Propietarios
informacionDescuento
Manual de Usuario
mensaje de error
Id tipo servicio runt
Tipo servicio Runt
Id clase de vehiculo en el runt
Clase de vehiculo en el runt
Id de marca en el Runt
Marca del vehiculo
Id linea del veiculo en el runt
Linea del vehiculo
año del modelo
Id del color
Color del vehiculo
Nro de serie
Nro de motor
Nro de chasis
Nro de Vin
nro de cilindros
codigo de municipio
capacidad de carga
peso del vehiculo
capacidad de pasajeros
codigo de marca vehiculo Seg Mun
codigo de linea vehiculo Seg Mun
codigo clase vehiculo Seg Mun
codigo de servicio vehiculo Seg Mun
listado de clases Seg Mundial de vehicul
o homologables con el runt
id tipo de carroceria
tipo de carroceria
id tipo de combustible
tipo de combustible
estado del vehiculo `ACTIVO` - `CANCEL
ADO`
organismo de transito
Listado de propietarios
Colección de descuentos
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
int
List<HomologacionClaseMarcaLi
neaServicio>
string
string
int
string
string
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
int
`List<Propietario>`
List<informacionDescuento>
SI
SI
SI
SI
SI
SI
Página 19 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Descripción de campos salida HomologacionClaseMarcaLineaServicio
Campo
Descripción
Tipo
clase
codMarcaSise
codLineaSise
codDestinoSise
objeto con definicion de clase vehiculo Seg
Mun
codigo de marca vehiculo Seg Mun
codigo de linea vehiculo Seg Mun
codigo de servicio vehiculo Seg Mun
`ClaseVehiculo`
string
string
int
Nulleable
NO
SI
SI
SI
Descripción de campos salida ClaseVehiculo
Campo
codClase
txtDesc
codTipoVehMinTrans
Descripción
codigo clase vehiculo Seg Mun
descripcion clase vehiculo Seg Mun
codigo de tipo vehiculo Min transportes
Tipo
int
string
int
Nulleable
NO
NO
SI
Tipo
int
string
string
string
string
string
list<Direccion>
string
Nulleable
NO
NO
SI
SI
SI
SI
SI
SI
Tipo
string
int
string
string
boolean
decimal
boolean
Nulleable
SI
NO
NO
NO
NO
NO
NO
Descripción de campos salida Propietario
Campo
tipoDocumento
noDocumento
nombreCompleto
nombre
apellido1
apellido2
direcciones
celular
Descripción
tipo de documento runt
nro de documento
nombre completo
nombre
primer apellido
segundo apellido
direcciones
celular propietario
Descripción de campos salida informacionDescuento
Campo
Descripción
id
identificador Seg Mun
cod_tipo_doc
tipo de documento Seg Mun
nro_doc
nro de documento
nro_placa
Nro_placa del vehículo consultado
aplica
Indica si aplica o no el descuento
porcentaje
Porcentaje del descuento que aplica
acumula
Indica si acumula descuentos
Manual de Usuario
Página 20 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Request:
POST /SOATMundial.asmx HTTP/1.1
SOAPAction: "http://www.mundialseguros.com.co/ConsultarInfoVehiculoRuntDoc"
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultarInfoVehiculoRuntDoc xmlns="http://www.mundialseguros.com.co/">
<placa>string</placa>
<puntoVta>long</puntoVta>
</ConsultarInfoVehiculoRuntDoc >
</soap:Body>
</soap:Envelope>
Response:
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultarInfoVehiculoRuntDocResponse xmlns="http://www.mundialseguros.com.co/">
<ConsultarInfoVehiculoRuntDocResult>
<idConsulta>string</idConsulta>
<snConsultaRuntExitosa>string</snConsultaRuntExitosa>
<observacionesServicio>string</observacionesServicio>
<idTipoServicio>string</idTipoServicio>
<tipoServicio>string</tipoServicio>
<idClaseVehiculo>string</idClaseVehiculo>
<claseVehiculo>string</claseVehiculo>
<idMarca>string</idMarca>
<marca>string</marca>
<idLinea>string</idLinea>
<linea>string</linea>
<aaaa_modelo>string</aaaa_modelo>
<idColor>string</idColor>
<color>string</color>
<noSerie>string</noSerie>
<noMotor>string</noMotor>
<noChasis>string</noChasis>
<noVin>string</noVin>
<cnt_cc>string</cnt_cc>
<divipola>string</divipola>
<cnt_toneladas>string</cnt_toneladas>
<pesoBrutoVehicular>string</pesoBrutoVehicular>
<cnt_ocupantes>string</cnt_ocupantes>
<codMarcaSise>string</codMarcaSise>
<codLineaSise>string</codLineaSise>
<codClaseSise>string</codClaseSise>
<cod_destino>string</cod_destino>
<homologaciones>
<HomologacionClaseMarcaLineaServicio>
<clase xsi:nil="true">
Manual de Usuario
Página 21 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<codClase>int</codClase>
<txtDesc>string</txtDesc>
<codTipoVehMinTrans>int</codTipoVehMinTrans>
</clase>
<codMarcaSise>string</codMarcaSise>
<codLineaSise>string</codLineaSise>
<codDestinoSise>int</codDestinoSise>
</HomologacionClaseMarcaLineaServicio>
<HomologacionClaseMarcaLineaServicio>
<clase xsi:nil="true">
<codClase>int</codClase>
<txtDesc>string</txtDesc>
<codTipoVehMinTrans>int</codTipoVehMinTrans>
</clase>
<codMarcaSise>string</codMarcaSise>
<codLineaSise>string</codLineaSise>
<codDestinoSise>int</codDestinoSise>
</HomologacionClaseMarcaLineaServicio>
</homologaciones>
<idTipoCarroceria>string</idTipoCarroceria>
<tipoCarroceria>string</tipoCarroceria>
<idTipoCombustible>string</idTipoCombustible>
<tipoCombustible>string</tipoCombustible>
<estadoDelVehiculo>string</estadoDelVehiculo>
<organismoTransito>string</organismoTransito>
<Propietarios>
<Propietario>
<tipoDocumento>string</tipoDocumento>
<noDocumento>string</noDocumento>
<nombreCompleto>string</nombreCompleto>
<nombre>string</nombre>
<apellido1>string</apellido1>
<apellido2>string</apellido2>
<direcciones xsi:nil="true" />
<celular>string</celular>
</Propietario>
<Propietario>
<tipoDocumento>string</tipoDocumento>
<noDocumento>string</noDocumento>
<nombreCompleto>string</nombreCompleto>
<nombre>string</nombre>
<apellido1>string</apellido1>
<apellido2>string</apellido2>
<direcciones xsi:nil="true" />
<celular>string</celular>
</Propietario>
</Propietarios>
<informacionDescuento>
<InformacionDescuento>
<id>string</id>
<cod_tipo_doc>int</cod_tipo_doc>
<nro_doc>string</nro_doc>
<nro_placa>string</nro_placa>
<aplica>boolean</aplica>
<porcentaje>decimal</porcentaje>
<acumula>boolean</acumula>
</InformacionDescuento>
Manual de Usuario
Página 22 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<InformacionDescuento>
<id>string</id>
<cod_tipo_doc>int</cod_tipo_doc>
<nro_doc>string</nro_doc>
<nro_placa>string</nro_placa>
<aplica>boolean</aplica>
<porcentaje>decimal</porcentaje>
<acumula>boolean</acumula>
</InformacionDescuento>
</informacionDescuento>
<noPlaca>string</noPlaca>
</ConsultarInfoVehiculoRuntDocResult>
</ConsultarInfoVehiculoRuntDocResponse >
</soap:Body>
</soap:Envelope>
5.1.26. CONSULTAR INFORMACIÓN DEL VEHICULO RUNT PROPIETARIO Y CÓDIGO
FASECOLDA
ConsultarInfoVehiculoRuntDocFasec
Este método retorna la información registrada en el organismo de tránsito, y una colección con
propietarios del vehiculo, adicionalmente se agrega el código fasecolda aproximado partiendo
del nombre del tipo de vehiculo, marca y línea.
Descripción de campos entrada
Campo
placa
puntoVta
Descripción
Placa del vehiculo
codigo de punto de venta
Tipo
string
long
Requerido
SI
SI
Descripción de campos salida
Campo
Descripción
idConsulta
id de la consulta al runt
string
Nullea
ble
NO
snConsultaRuntExitosa
estado de la consulta Runt
bool
NO
observacionesServicio
idTipoServicio
tipoServicio
idClaseVehiculo
mensaje de error
Id tipo servicio runt
Tipo servicio Runt
Id clase de vehiculo en el runt
string
string
string
string
SI
SI
SI
SI
Manual de Usuario
Tipo
Página 23 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
claseVehiculo
idMarca
marca
idLinea
linea
aaaa_modelo
idColor
color
noSerie
noMotor
noChasis
noVin
cnt_cc
divipola
cnt_toneladas
pesoBrutoVehicular
cnt_ocupantes
codMarcaSise
codLineaSise
codClaseSise
cod_destino
homologaciones
idTipoCarroceria
tipoCarroceria
idTipoCombustible
tipoCombustible
estadoDelVehiculo
organismoTransito
Propietarios
codFasecolda
Clase de vehiculo en el runt
Id de marca en el Runt
Marca del vehiculo
Id linea del veiculo en el runt
Linea del vehiculo
año del modelo
Id del color
Color del vehiculo
Nro de serie
Nro de motor
Nro de chasis
Nro de Vin
nro de cilindros
codigo de municipio
capacidad de carga
peso del vehiculo
capacidad de pasajeros
codigo de marca vehiculo Seg Mun
codigo de linea vehiculo Seg Mun
codigo clase vehiculo Seg Mun
codigo de servicio vehiculo Seg Mun
listado de clases Seg Mundial de vehicul
o homologables con el runt
id tipo de carroceria
tipo de carroceria
id tipo de combustible
tipo de combustible
estado del vehiculo `ACTIVO` - `CANCEL
ADO`
organismo de transito
Listado de propietarios
Código fasecolda aproximado según
imformación del runt
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
int
List<HomologacionClaseMarcaLi
neaServicio>
string
string
int
string
string
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
SI
int
`List<Propietario>`
String
SI
SI
SI
SI
SI
SI
SI
SI
Descripción de campos salida HomologacionClaseMarcaLineaServicio
Campo
Manual de Usuario
Descripción
Tipo
Nulleable
Página 24 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
clase
codMarcaSise
codLineaSise
codDestinoSise
objeto con definicion de clase vehiculo Seg
Mun
codigo de marca vehiculo Seg Mun
codigo de linea vehiculo Seg Mun
codigo de servicio vehiculo Seg Mun
`ClaseVehiculo`
string
string
int
NO
SI
SI
SI
Descripción de campos salida ClaseVehiculo
Campo
codClase
txtDesc
codTipoVehMinTrans
Descripción
codigo clase vehiculo Seg Mun
descripcion clase vehiculo Seg Mun
codigo de tipo vehiculo Min transportes
Tipo
int
string
int
Nulleable
NO
NO
SI
Tipo
int
string
string
string
string
string
list<Direccion>
string
Nulleable
NO
NO
SI
SI
SI
SI
SI
SI
Descripción de campos salida Propietario
Campo
tipoDocumento
noDocumento
nombreCompleto
nombre
apellido1
apellido2
direcciones
celular
Descripción
tipo de documento runt
nro de documento
nombre completo
nombre
primer apellido
segundo apellido
direcciones
celular propietario
Request:
POST /SOATMundial.asmx HTTP/1.1
SOAPAction: "http://www.mundialseguros.com.co/ConsultarInfoVehiculoRuntDocFasec"
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultarInfoVehiculoRuntDocFasec xmlns="http://www.mundialseguros.com.co/">
<placa>string</placa>
<puntoVta>long</puntoVta>
</ConsultarInfoVehiculoRuntDocFasec >
</soap:Body>
</soap:Envelope>
Manual de Usuario
Página 25 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Response:
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultarInfoVehiculoRuntDocFasecResponse xmlns="http://www.mundialseguros.com.co/">
<ConsultarInfoVehiculoRuntDocFasecResult>
<idConsulta>string</idConsulta>
<snConsultaRuntExitosa>string</snConsultaRuntExitosa>
<observacionesServicio>string</observacionesServicio>
<idTipoServicio>string</idTipoServicio>
<tipoServicio>string</tipoServicio>
<idClaseVehiculo>string</idClaseVehiculo>
<claseVehiculo>string</claseVehiculo>
<idMarca>string</idMarca>
<marca>string</marca>
<idLinea>string</idLinea>
<linea>string</linea>
<aaaa_modelo>string</aaaa_modelo>
<idColor>string</idColor>
<color>string</color>
<noSerie>string</noSerie>
<noMotor>string</noMotor>
<noChasis>string</noChasis>
<noVin>string</noVin>
<cnt_cc>string</cnt_cc>
<divipola>string</divipola>
<cnt_toneladas>string</cnt_toneladas>
<pesoBrutoVehicular>string</pesoBrutoVehicular>
<cnt_ocupantes>string</cnt_ocupantes>
<codMarcaSise>string</codMarcaSise>
<codLineaSise>string</codLineaSise>
<codClaseSise>string</codClaseSise>
<cod_destino>string</cod_destino>
<homologaciones>
<HomologacionClaseMarcaLineaServicio>
<clase xsi:nil="true">
<codClase>int</codClase>
<txtDesc>string</txtDesc>
<codTipoVehMinTrans>int</codTipoVehMinTrans>
</clase>
<codMarcaSise>string</codMarcaSise>
<codLineaSise>string</codLineaSise>
<codDestinoSise>int</codDestinoSise>
</HomologacionClaseMarcaLineaServicio>
<HomologacionClaseMarcaLineaServicio>
<clase xsi:nil="true">
<codClase>int</codClase>
<txtDesc>string</txtDesc>
<codTipoVehMinTrans>int</codTipoVehMinTrans>
</clase>
<codMarcaSise>string</codMarcaSise>
<codLineaSise>string</codLineaSise>
<codDestinoSise>int</codDestinoSise>
Manual de Usuario
Página 26 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
</HomologacionClaseMarcaLineaServicio>
</homologaciones>
<idTipoCarroceria>string</idTipoCarroceria>
<tipoCarroceria>string</tipoCarroceria>
<idTipoCombustible>string</idTipoCombustible>
<tipoCombustible>string</tipoCombustible>
<estadoDelVehiculo>string</estadoDelVehiculo>
<organismoTransito>string</organismoTransito>
<Propietarios>
<Propietario>
<tipoDocumento>string</tipoDocumento>
<noDocumento>string</noDocumento>
<nombreCompleto>string</nombreCompleto>
<nombre>string</nombre>
<apellido1>string</apellido1>
<apellido2>string</apellido2>
<direcciones xsi:nil="true" />
<celular>string</celular>
</Propietario>
<Propietario>
<tipoDocumento>string</tipoDocumento>
<noDocumento>string</noDocumento>
<nombreCompleto>string</nombreCompleto>
<nombre>string</nombre>
<apellido1>string</apellido1>
<apellido2>string</apellido2>
<direcciones xsi:nil="true" />
<celular>string</celular>
</Propietario>
</Propietarios>
<codFasecolda>string</codFasecolda>
</ConsultarInfoVehiculoRuntDocFasecResult>
</ConsultarInfoVehiculoRuntDocFasecResponse >
</soap:Body>
</soap:Envelope>
Descripción vehículos homologables tarifas
Controles aplicados en los parámetros del XML para cada clase vehículo
cod_clas
e
1
2
txt_desc
control_xml
MOTOCICLETA
CAMPEROS Y CAMIONETAS
3
4
5
6
CARGA O MIXTOS
OFICIALES ESPECIALES
AUTOMOVILES FAMILIARES
VEH. PARTICULARES 6 O MAS
PASAJEROS
AUTOS DE NEGOCIO
ALQUILER ENSEÐANZA
cnt_cc
cnt_cc,aaaa_modelo,cnt_toneladas,cnt_ocupantes,cod_d
estino
cnt_toneladas
cnt_cc,cod_destino
cnt_cc,aaaa_modelo,cnt_ocupantes,cod_destino
cnt_cc,aaaa_modelo,cnt_ocupantes,cod_destino
7
Manual de Usuario
cnt_cc,aaaa_modelo,cnt_ocupantes,cod_destino
Página 27 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
8
9
10
BUSES O BUSETAS
S. PUB. INTERMUNICIPAL
MOTO CARRO
cnt_ocupantes,cod_destino
cnt_ocupantes,cod_destino
cnt_cc
Códigos de servicios configurados en el proceso:
CÓDIGO
SERVICIO
1
2
3
4
DESCRIPCIÓN
SERVICIO
Particular
Público
Diplomático
Oficial
SERVICIO
MUNDIAL
1
2
5
3
5.1.27. CONSULTAR INFORMACIÓN PROPIETARIOS
ConsultarPropietarios
Este método permite la actualización de la consulta de propietarios.
Descripción de campos entrada
Campo
Descripción
idRunt
documento
tipoDoc
placa
codSuc
puntoVta
Placa del vehiculo
Número de documento
Codigo tipo de documento
Placa del vehiculo
Codigo Sucursal
codigo de punto de venta
Tipo
int
int
int
string
int
int
Requerido
SI
Si
Si
Si
Si
SI
Descripción de campos salida
Descripción de campos salida Propietario
Campo
tipoDocumento
noDocumento
nombreCompleto
nombre
apellido1
apellido2
Manual de Usuario
Descripción
tipo de documento runt
nro de documento
nombre completo
nombre
primer apellido
segundo apellido
Tipo
int
string
string
string
string
string
Nulleable
NO
NO
SI
SI
SI
SI
Página 28 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
direcciones
celular
direcciones
celular propietario
list<Direccion>
string
SI
SI
Diagrama del flujo Modificado.
Ilustración 2 Flujo Consulta Runt Propietarios
Manual de Usuario
Página 29 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Manual de Usuario
Página 30 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Manual de Usuario
Página 31 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Request:
POST /SOATMundial.asmx HTTP/1.1
SOAPAction: "http://www.mundialseguros.com.co/ ConsultarPropietarios"
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultarPropietarios xmlns="http://www.mundialseguros.com.co/">
<idRunt>string</idRunt>
<documento>string</documento>
<tipoDoc>string</tipoDoc>
<placa>string</placa>
<codSuc>short</codSuc>
<puntoVta>long</puntoVta>
</ConsultarPropietarios> </soap:Body>
</soap:Envelope>
Response:
Content-Type: text/xml; charset=utf-8
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ConsultarPropietariosResponse xmlns="http://www.mundialseguros.com.co/">
<ConsultarPropietariosResult>
<Propietario>
<tipoDocumento>string</tipoDocumento>
<noDocumento>string</noDocumento>
<nombreCompleto>string</nombreCompleto>
<nombre>string</nombre>
<apellido1>string</apellido1>
<apellido2>string</apellido2>
<direcciones>
<Direccion xsi:nil="true" />
<Direccion xsi:nil="true" />
</direcciones>
<celular>string</celular>
</Propietario>
<Propietario>
<tipoDocumento>string</tipoDocumento>
<noDocumento>string</noDocumento>
<nombreCompleto>string</nombreCompleto>
<nombre>string</nombre>
<apellido1>string</apellido1>
<apellido2>string</apellido2>
<direcciones>
<Direccion xsi:nil="true" />
<Direccion xsi:nil="true" />
</direcciones>
<celular>string</celular>
</Propietario>
</ConsultarPropietariosResult>
</ConsultarPropietariosResponse> </soap:Envelope>
Manual de Usuario
Página 32 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
5.1.28. CALCULAR POLIZA
CalcularPoliza
Método que permite realizar el cálculo de una póliza
Con la información que retorna el runt se consume este método para que nos arroje la
tarifa correcta para el vehículo seleccionado, tener en cuenta que al hacer la consulta de
la placa y se evidencie que en el response para el parámetro <codEstadoFecFasecolda>
este el número 88, se debe permitir al cliente ingresar manualmente las fechas de
vigencia (esto con motivo que en fasecolda no se encuentra registro de pólizas activas)
Además, se incluyen cuatro campos en el response y dos campos en el request del
calculo acorde a la ley 2161 de 2021 para la aplicación de descuento, si el vehículo y
propietario aplica.
Campos incluidos en el request: <CodTipoDoc> y <NroDoc>
Campos incluidos en el response:
<PjeDescuentoLey> (indica el porcentaje de descuento que se aplica)
<ImpDescuentoLey> (indica el valor en pesos de descuento que se aplica)
<CodCausal> (indica código de causal de la no aplicación)
<DescripcionCausal> (Indica descripción del causal de la no aplicación)
Ej:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<CalcularPoliza xmlns="http://www.mundialseguros.com.co/">
<datosVehiculo>
<Clase>5</Clase>
<Cilindraje>1600</Cilindraje>
<Capacidad>0.00</Capacidad>
<Modelo>2021</Modelo>
<Pasajeros>5</Pasajeros>
<CodigoSucursal>14</CodigoSucursal>
<CodigoAgente>13158</CodigoAgente>
<CodigoPuntoVenta>99001</CodigoPuntoVenta>
Manual de Usuario
Página 33 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<Placa>EIR612</Placa>
<CodTipoDoc>1</CodTipoDoc>
<NroDoc>1030123123</NroDoc>
</datosVehiculo>
</CalcularPoliza>
</soap:Body>
</soap:Envelope>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<CalcularPolizaResponse xmlns="http://www.mundialseguros.com.co/">
<CalcularPolizaResult>
<PjeDescuentoLey>decimal</PjeDescuentoLey>
<ImpDescuentoLey>decimal</ImpDescuentoLey>
<CodCausal>string</CodCausal>
<DescripcionCausal>string</DescripcionCausal>
<Tarifa>521</Tarifa>
<FechaExpedicion>2021/12/27</FechaExpedicion>
<FechaInicioVigencia>2021/12/28</FechaInicioVigencia>
<FechaFinVigencia>2021/12/27</FechaFinVigencia>
<ValorPrima>256900</ValorPrima>
<ValorContribucion>128450</ValorContribucion>
<ValorTasaRUNT>1900</ValorTasaRUNT>
<ValorDescuento>0</ValorDescuento>
<ValorTotalPoliza>385350</ValorTotalPoliza>
<ValorTotalPagar>387250</ValorTotalPagar>
<Mensaje>string</Mensaje>
<ResultadoExito>true</ResultadoExito>
<DiasVigencia>365</DiasVigencia>
<codEstadoFecFasecolda>88</codEstadoFecFasecolda>
</CalcularPolizaResult>
</CalcularPolizaResponse>
</soap:Body>
</soap:Envelope>
También tener en cuenta cuando se evidencie para el mismo parámetro el resultado -999, se
deben mantener las fechas que arroje el sistema (esto debido a que encontró registros de
pólizas activas en fasecolda)
Ej:
<?xml version="1.0" encoding="utf-8"?>
Manual de Usuario
Página 34 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<CalcularPoliza xmlns="http://www.mundialseguros.com.co/">
<datosVehiculo>
<Clase>5</Clase>
<Cilindraje>1600</Cilindraje>
<Capacidad>0.00</Capacidad>
<Modelo>2021</Modelo>
<Pasajeros>5</Pasajeros>
<CodigoSucursal>14</CodigoSucursal>
<CodigoAgente>13158</CodigoAgente>
<CodigoPuntoVenta>99001</CodigoPuntoVenta>
<Placa>EIR612</Placa>
<CodTipoDoc>1</CodTipoDoc>
<NroDoc>1030123123</NroDoc>
</datosVehiculo>
</CalcularPoliza>
</soap:Body>
</soap:Envelope>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<CalcularPolizaResponse xmlns="http://www.mundialseguros.com.co/">
<CalcularPolizaResult>
<PjeDescuentoLey>decimal</PjeDescuentoLey>
<ImpDescuentoLey>decimal</ImpDescuentoLey>
<CodCausal>string</CodCausal>
<DescripcionCausal>string</DescripcionCausal>
<Tarifa>521</Tarifa>
<FechaExpedicion>2021/12/27</FechaExpedicion>
<FechaInicioVigencia>2021/12/28</FechaInicioVigencia>
<FechaFinVigencia>2021/12/27</FechaFinVigencia>
<ValorPrima>256900</ValorPrima>
<ValorContribucion>128450</ValorContribucion>
<ValorTasaRUNT>1900</ValorTasaRUNT>
<ValorDescuento>0</ValorDescuento>
<ValorTotalPoliza>385350</ValorTotalPoliza>
<ValorTotalPagar>387250</ValorTotalPagar>
<Mensaje>string</Mensaje>
<ResultadoExito>true</ResultadoExito>
<DiasVigencia>365</DiasVigencia>
<codEstadoFecFasecolda>-999</codEstadoFecFasecolda>
</CalcularPolizaResult>
</CalcularPolizaResponse>
Manual de Usuario
Página 35 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
</soap:Body>
</soap:Envelope>
FECHA DE FINALIZACION POLIZA FASECOLDA
Para realizar el cumplimiento a Circular Externa 021 de 2017 emitida por la
Superintendencia financiera en la que se indican: "Establecer la obligación de desarrollar
mecanismos para verificar la existencia de pólizas, previo el registró ante el RUNT, con el
fin de evitar que exista duplicidad”.
Se ha integrado al método de CalcularPoliza en el Request ingresando la placa:
Request
<CalcularPoliza>
<datosVehiculo>
<Clase>5</Clase>
<Cilindraje>1598</Cilindraje>
<Capacidad>0</Capacidad>
<Modelo>2013</Modelo>
<Pasajeros>5</Pasajeros>
<CodigoSucursal>14</CodigoSucursal>
<CodigoAgente>80001401</CodigoAgente>
<CodigoPuntoVenta>60700</CodigoPuntoVenta>
<Placa>HAV757</Placa>
< CodTipoDoc>1</ CodTipoDoc>
< NroDoc>1030123123</ NroDoc>
</datosVehiculo>
</CalcularPoliza>
Response
<CalcularPolizaResponse xmlns="http://www.mundialseguros.com.co/">
<CalcularPolizaResult>
<PjeDescuentoLey>decimal</PjeDescuentoLey>
<ImpDescuentoLey>decimal</ImpDescuentoLey>
<CodCausal>string</CodCausal>
<DescripcionCausal>string</DescripcionCausal>
<Tarifa>521</Tarifa>
<FechaExpedicion>30/05/2018</FechaExpedicion>
<FechaInicioVigencia>31/05/2018</FechaInicioVigencia>
<FechaFinVigencia>30/05/2019</FechaFinVigencia>
<ValorPrima>242400</ValorPrima>
Manual de Usuario
Página 36 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<ValorContribucion>121200</ValorContribucion>
<ValorTasaRUNT>1610</ValorTasaRUNT>
<ValorDescuento>0</ValorDescuento>
<ValorTotalPoliza>363600</ValorTotalPoliza>
<ValorTotalPagar>365210</ValorTotalPagar>
<Mensaje>string</Mensaje>
<ResultadoExito>true</ResultadoExito>
<DiasVigencia>365</DiasVigencia>
<codEstadoFecFasecolda>-999</codEstadoFecFasecolda>
<ResultadoExito>true</ResultadoExito>
<DiasVigencia>364</DiasVigencia>
</CalcularPolizaResult>
</CalcularPolizaResponse>
Estas son las fechas que deben persistir para que sea usado en el método expedir póliza
XML
a) A continuación, se muestra un ejemplo para el método expuesto:
Vehículo IXV419
Se realiza la consulta de la placa IXV419 ante el RUNT; registrado como AUTOMOVIL con servicio
Particular marca RENAULT línea SANDERO DYNAMIQUE como se ve en la tabla adjunta este
vehículo se puede emitir tanto AUTOMOVIL FAMILIAR como AUTO DE NEGOCIO ALQUIER
ENSEÑANZA por lo que el servicio retorna en la etiqueta homologaciones las cuales sean
aplicables.
Retorno (ConsultarInfoVehiculoRunt)
Homologaciones:
HomologacionClaseMarcaLineaServicio:
clase:
codClase: 5
txtDesc: "AUTOMOVILES FAMILIARES"
codTipoVehMinTrans: 1
codMarcaSise: RN
codLineaSise: 999
codDestinoSise: 1
clase:
codClase: 7
Manual de Usuario
Página 37 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
txtDesc: "AUTOS DE NEGOCIO ALQUILER ENSEÐANZA"
codTipoVehMinTrans: 7
codMarcaSise: RN
codLineaSise: 999
codDestinoSise: 1
Calculo homologación AUTOMOVILES FAMILIARES
Con la información retornada se valida el valor de la póliza para la tarifa seleccionada
Ejemplo: AUTOMOVILES FAMILIARES
Request
CalcularPoliza:
datosVehiculo:
Clase: 5
Cilindraje: 1598
Capacidad: "0.00"
Modelo: 2017
Pasajeros: 5
FechaInicioVigencia: "10/06/2017"
FechaFinVigencia: "10/06/2018"
CodigoSucursal: 14
CodigoAgente: 13158
CodigoPuntoVenta: 99001
CodTipoDoc: 1
NroDoc: 1030123123
Response
DatosTarifa:
PjeDescuentoLey: decimal
ImpDescuentoLey: decimal
CodCausal: string
DescripcionCausal: string
Tarifa: 521
FechaExpedicion: "09/06/2017"
FechaInicioVigencia: "10/06/2017"
FechaFinVigencia: "10/06/2018"
ValorPrima: 224800
ValorContribucion: 112400
Manual de Usuario
Página 38 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
ValorTasaRUNT: 1610
ValorDescuento: 0
ValorTotalPoliza: 337200
ValorTotalPagar: 338810
Mensaje: NULL
ResultadoExito: true
DiasVigencia: 365
Calculo homologación AUTOS DE NEGOCIO ALQUILER ENSEÑANZA
Request:
CalcularPoliza:
datosVehiculo:
Clase: 7
Cilindraje: 1598
Capacidad: "0.00"
Modelo: 2017
Pasajeros: 5
FechaInicioVigencia: "10/06/2017"
FechaFinVigencia: "10/06/2018"
CodigoSucursal: 14
CodigoAgente: 13158
CodigoPuntoVenta: 99001
CodTipoDoc: 1
NroDoc: 1030123123
Response
DatosTarifa:
PjeDescuentoLey: decimal
ImpDescuentoLey: decimal
CodCausal: string
DescripcionCausal: string
Tarifa: 721
FechaExpedicion: "09/06/2017"
FechaInicioVigencia: "10/06/2017"
FechaFinVigencia: "10/06/2018"
ValorPrima: 284500
ValorContribucion: 142250
ValorTasaRUNT: 1610
ValorDescuento: 0
Manual de Usuario
Página 39 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
ValorTotalPoliza: 426750
ValorTotalPagar: 428360
Mensaje: NULL
ResultadoExito: true
DiasVigencia: 365
b) Seguidamente encontramos el siguiente ejemplo:
Ejemplo: BDW852
Se realiza la consulta de la placa BDW852 registrado como CAMIONETA servicio Particular marca
SUBARU y línea LEGACY 4WD SW capacidad de pasajeros 5
Según tabla de homologación se debe emitir como AUTOMOVIL FAMILIAR
Retorno (ConsultarInfoVehiculoRunt)
homologaciones:
HomologacionClaseMarcaLineaServicio:
clase:
codClase: 5
txtDesc: "AUTOMOVILES FAMILIARES"
codTipoVehMinTrans: 1
codMarcaSise: SU
codLineaSise: 999
codDestinoSise: 1
idTipoCarroceria:23
tipoCarroceria:STATION WAGON
Calculo homologación CAMIONETA carrocería STATION WAGON
Request
datosVehiculo:
Clase: 5
Cilindraje: 2200
Capacidad: 0
Modelo: 1993
Pasajeros: 5
FechaInicioVigencia: ""
FechaFinVigencia: ""
CodigoSucursal: 14
CodigoAgente: 80000957
Manual de Usuario
Página 40 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
CodigoPuntoVenta: 29203
CodTipoDoc: 1
NroDoc: 1030123123
Response
DatosTarifa:
PjeDescuentoLey: decimal
ImpDescuentoLey: decimal
CodCausal: string
DescripcionCausal: string
Tarifa: 522
FechaExpedicion: "12/06/2017"
FechaInicioVigencia: "13/06/2017"
FechaFinVigencia: "12/06/2018"
ValorPrima: 279100
ValorContribucion: 139550
ValorTasaRUNT: 1610
ValorDescuento: 0
ValorTotalPoliza: 418650
ValorTotalPagar: 420260
Mensaje: NULL
ResultadoExito: true
DiasVigencia: 364
5.1.29. EXPEDIR POLIZA XML
expedirPolizaXML
Este método recibe un conjunto de datos en un XML, que contiene toda la información
del tomador, del vehículo, de la tarifación, tomador de pólizas de accidentes personales
y las vigencias de la póliza. Retorna un valor que indica si la transacción fue exitosa (-1) o
si fue fallida (0), en este último caso se retorna un mensaje con la descripción del error.
Este método valido la información consultada anteriormente en el método
ConsultarInfoVehiculoRunt y que esta coincida con la información de la póliza enviada, se
incluyen etiquetas para la expedición de la póliza de accidentes personales para el caso
puntual que es el producto SOAT y AP, adicional se incluyen etiquetas para la expedición
de la póliza de Responsabilidad Civil para el caso puntual que es el producto SOAT + AP +
RCE y recaudo automatico.
Manual de Usuario
Página 41 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
COTIZADOR
Este campo se trabaja sobre el método expedirPolizaXML con la etiqueta, <cotizador/> o
<cotizador> </Cotizador> antes del campo </Table> y contiene toda la información de la
emisión de la póliza validando la información consultada anteriormente en el método
ConsultarInfoVehiculoRunt. Por los datos que retorna el RUNT en ocasiones
inconsistente y que acorde a las reglas de negocio que en el consumo de los servicios para
canales donde la interacción del cliente final incluye el pago del SOAT, esta pre validación
tiene como objetivo dar una respuesta a los terceros que les permita detener el pago y
que sea corregida la información de la póliza soat bien sea porque falta completar algún
campo o bien sea por que el cliente sea quien deba actualizar información ante el
organismo de tránsito. Una vez aplicadas las correcciones se procede posteriormente a
realizar la expedición. Es opcional y retorna un valor que indica si la transacción fue
exitosa (-1) o si fue fallida (0).
BONO DE DESCUENTO AUTORIZADO
Se debe modificar el archivo XML que se utiliza para consumir el método
ExpedirPolizaXML,
agregando
el
campo
<pje_bono_descuento>20</pje_bono_descuento>, justo antes de la etiqueta de cierre
</Table>. El valor a enviarse dentro de esta etiqueta puede darse de dos formas en
porcentaje o en pesos.
•
Para el caso del porcentaje la etiqueta solo permite valor entre 0 y 20 según sea el descuento
autorizado para el punto de venta. Si el intermediario va a manejar un descuento de cara al
cliente ejemplo del 5% en la etiqueta <pje_bono_descuento> deberá enviar como valor el
doble del descuento en este caso 10.
De manera adicional para que el descuento enviado en porcentaje lo tome la
expedición, se debe tomar el campo <ValorPrima></ValorPrima> entregado por el
servicio CalcularPoliza y a este valor aplicarle la siguiente formula:
Descuento = round(ValorPrima * 0.77 * ((porcentaje bono de descuento) /100))
Por tanto, en los campos:
<imp_prima> = (ValorPrima – Descuento) + ValorContribucion
<imp_pagado> = (ValorPrima – Descuento) + ValorContribucion + ValorTasaRUNT
Manual de Usuario
Página 42 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
•
Para el caso del descuento en pesos debe enviarse valores entre 0 y el máximo autorizado
por la gerencia de soat en la etiqueta <pje_bono_descuento>. En este caso debe enviarse el
valor exacto del descuento que se manejará de cara al cliente.
De misma manera para aplicarse el descuento en pesos se debe tomar el campo
(ValorPrima – ValorDescuentoPesos) + ValorContribucion = imp_prima
(ValorPrima – ValorDescuentoPesos) + ValorContribucion + ValorTasaRUNT =
imp_pagado
Nota: Para vehículos eléctricos no aplica realizar descuento, teniendo en cuenta que ya
por ley se esta realizando dicho descuento.
FECHA DE NACIMIENTO TOMADOR PÓLIZA ACCIDENTES PERSONALES
Se debe tener en cuenta validar la fecha de nacimiento del tomador de la póliza de
accidentes personales por lo cual el intermediario debe enviar la etiqueta
<fec_naci>dd/mm/aaaa</fec_naci> para calcular la edad y aplicar la regla en la expedición
de dicha póliza
Resaltado cabecera Http donde se envía <usuario:password> codificado base 64
POST /soatmundial.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
Authorization: basic <usuario:password>
Ejemplo de request con la etiqueta cotizador, estructura de accidentes personales y estructura de
descuento que se envía en el método ExpedirPolizaXML.
REQUEST COTIZACIÓN
<NewDataSet>
<Table>
<cod_suc>14</cod_suc>
<fec_emision>06/07/2021</fec_emision>
<cod_grupo_endo>1</cod_grupo_endo>
<fec_vig_desde>17/07/2021</fec_vig_desde>
<fec_vig_hasta>16/07/2022</fec_vig_hasta>
<txt_apellido1>CASTRO</txt_apellido1>
<txt_apellido2></txt_apellido2>
<txt_nombre>CARLOS</txt_nombre>
<cod_tipo_persona>F</cod_tipo_persona>
Manual de Usuario
Página 43 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<cod_tipo_doc>1</cod_tipo_doc>
<nro_doc>4313189</nro_doc>
<cod_tipo_dir>1</cod_tipo_dir>
<txt_direccion>cll 33</txt_direccion>
<cod_dpto>11</cod_dpto>
<cod_municipio>11001</cod_municipio>
<cod_tipo_telef>8</cod_tipo_telef>
<txt_telefono>3100000000</txt_telefono>
<imp_prima_total>463663</imp_prima_total>
<imp_gtos_emi>0</imp_gtos_emi>
<imp_iva>0</imp_iva>
<cod_usuario_solicitud>WS_FULLCAR</cod_usuario_solicitud>
<cod_marca_min_trans>ZZ</cod_marca_min_trans>
<cod_modelo_min_trans>999</cod_modelo_min_trans>
<cod_tipo_veh_min_trans>1</cod_tipo_veh_min_trans>
<aaaa_modelo>2016</aaaa_modelo>
<txt_patente>UHZ34D</txt_patente>
<txt_motor>JLZCEJ43341</txt_motor>
<txt_chasis>9FLA36FZ0GBF64753</txt_chasis>
<cod_destino>1</cod_destino>
<cnt_toneladas>0.00</cnt_toneladas>
<cnt_ocupantes>2</cnt_ocupantes>
<cnt_cc>150</cnt_cc>
<cod_pais_matricula>1</cod_pais_matricula>
<cod_clase_soat>1</cod_clase_soat>
<nro_asociado>121</nro_asociado>
<nro_formulario>92000014</nro_formulario>
<cod_motivo>0</cod_motivo>
<txt_marca>FIRENZE</txt_marca>
<txt_modelo>HY150T</txt_modelo>
<imp_pagado>465463</imp_pagado>
<fec_mov>06/07/2021</fec_mov>
<cod_tipo_agente>1</cod_tipo_agente>
<cod_agente>80001142</cod_agente>
<cod_pto_vta>42973</cod_pto_vta>
<imp_tasa_runt>1800</imp_tasa_runt>
<txt_correo>jesmillan@segurosmundial.com.co</txt_correo>
<txt_vin>9FLA36FZ0GBF64753</txt_vin>
<ap_tomador>0</ap_tomador>
<ap_txt_apellido1>CASTRO</ap_txt_apellido1>
<ap_txt_apellido2></ap_txt_apellido2>
<ap_txt_nombre>CARLOS</ap_txt_nombre>
<ap_cod_tipo_persona>F</ap_cod_tipo_persona>
<ap_cod_tipo_doc>1</ap_cod_tipo_doc>
<ap_nro_doc>4313189</ap_nro_doc>
<ap_cod_tipo_dir>1</ap_cod_tipo_dir>
<ap_txt_direccion>cll 33</ap_txt_direccion>
<ap_cod_dpto>11</ap_cod_dpto>
<ap_cod_municipio>11001</ap_cod_municipio>
Manual de Usuario
Página 44 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<ap_pais>1</ap_pais>
<ap_txt_sexo></ap_txt_sexo>
<ap_cod_tipo_telef>8</ap_cod_tipo_telef>
<ap_txt_telefono>3100000000</ap_txt_telefono>
<ap_fec_emision>06/07/2021</ap_fec_emision>
<ap_fec_vig_desde>17/07/2021</ap_fec_vig_desde>
<ap_fec_vig_hasta>16/07/2022</ap_fec_vig_hasta>
<fec_naci>13/01/1984</fec_naci>
<ap_valor_asegurado>5000000</ap_valor_asegurado>
<ap_valor_poliza>12000</ap_valor_poliza>
<ap_placa_asistencia>UHZ34D</ap_placa_asistencia>
<ap_vigencia>2020</ap_vigencia>
<aplicarecaudo_au/>
<franquiciaId>PSE</franquiciaId>
<imp_valor_me>465463</imp_valor_me>
<tipo_Pago>PSE</tipo_Pago>>
<pje_bono_descuento>12</pje_bono_descuento> #De cara al cliente tiene 6% de descuento en SOAT
<cotizador/>
</Table>
</NewDataSet>
RESPONSE
XML Response (Ejemplo)
<nro_formulario>92000014</nro_formulario>
<sn_procesado>-1</sn_procesado>
REQUEST XML EMISION
<NewDataSet>
<Table>
<cod_suc>14</cod_suc>
<fec_emision>06/07/2021</fec_emision>
<cod_grupo_endo>1</cod_grupo_endo>
<fec_vig_desde>17/07/2021</fec_vig_desde>
<fec_vig_hasta>16/07/2022</fec_vig_hasta>
<txt_apellido1>CASTRO</txt_apellido1>
<txt_apellido2></txt_apellido2>
<txt_nombre>CARLOS</txt_nombre>
<cod_tipo_persona>F</cod_tipo_persona>
<cod_tipo_doc>1</cod_tipo_doc>
<nro_doc>4313189</nro_doc>
<cod_tipo_dir>1</cod_tipo_dir>
<txt_direccion>cll 33</txt_direccion>
<cod_dpto>11</cod_dpto>
<cod_municipio>11001</cod_municipio>
<cod_tipo_telef>8</cod_tipo_telef>
<txt_telefono>3100000000</txt_telefono>
<imp_prima_total>463663</imp_prima_total>
<imp_gtos_emi>0</imp_gtos_emi>
Manual de Usuario
Página 45 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<imp_iva>0</imp_iva>
<cod_usuario_solicitud>WS_FULLCAR</cod_usuario_solicitud>
<cod_marca_min_trans>ZZ</cod_marca_min_trans>
<cod_modelo_min_trans>999</cod_modelo_min_trans>
<cod_tipo_veh_min_trans>1</cod_tipo_veh_min_trans>
<aaaa_modelo>2016</aaaa_modelo>
<txt_patente>UHZ34D</txt_patente>
<txt_motor>JLZCEJ43341</txt_motor>
<txt_chasis>9FLA36FZ0GBF64753</txt_chasis>
<cod_destino>1</cod_destino>
<cnt_toneladas>0.00</cnt_toneladas>
<cnt_ocupantes>2</cnt_ocupantes>
<cnt_cc>150</cnt_cc>
<cod_pais_matricula>1</cod_pais_matricula>
<cod_clase_soat>1</cod_clase_soat>
<nro_asociado>121</nro_asociado>
<nro_formulario>92000014</nro_formulario>
<cod_motivo>0</cod_motivo>
<txt_marca>FIRENZE</txt_marca>
<txt_modelo>HY150T</txt_modelo>
<imp_pagado>465463</imp_pagado>
<fec_mov>06/07/2021</fec_mov>
<cod_tipo_agente>1</cod_tipo_agente>
<cod_agente>80001142</cod_agente>
<cod_pto_vta>42973</cod_pto_vta>
<imp_tasa_runt>1800</imp_tasa_runt>
<txt_correo>jesmillan@segurosmundial.com.co</txt_correo>
<txt_vin>9FLA36FZ0GBF64753</txt_vin>
<ap_tomador>0</ap_tomador>
<ap_txt_apellido1>CASTRO</ap_txt_apellido1>
<ap_txt_apellido2></ap_txt_apellido2>
<ap_txt_nombre>CARLOS</ap_txt_nombre>
<ap_cod_tipo_persona>F</ap_cod_tipo_persona>
<ap_cod_tipo_doc>1</ap_cod_tipo_doc>
<ap_nro_doc>4313189</ap_nro_doc>
<ap_cod_tipo_dir>1</ap_cod_tipo_dir>
<ap_txt_direccion>cll 33</ap_txt_direccion>
<ap_cod_dpto>11</ap_cod_dpto>
<ap_cod_municipio>11001</ap_cod_municipio>
<ap_pais>1</ap_pais>
<ap_txt_sexo></ap_txt_sexo>
<ap_cod_tipo_telef>8</ap_cod_tipo_telef>
<ap_txt_telefono>3100000000</ap_txt_telefono>
<ap_fec_emision>06/07/2021</ap_fec_emision>
<ap_fec_vig_desde>17/07/2021</ap_fec_vig_desde>
<ap_fec_vig_hasta>16/07/2022</ap_fec_vig_hasta>
<fec_naci>13/01/1984</fec_naci>
<ap_valor_asegurado>5000000</ap_valor_asegurado>
<ap_valor_poliza>12000</ap_valor_poliza>
Manual de Usuario
Página 46 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<ap_placa_asistencia>UHZ34D</ap_placa_asistencia>
<ap_vigencia>2020</ap_vigencia>
<aplicarecaudo_au/>
<franquiciaId>VISA</franquiciaId>
<descripcionRecaudo>SNH85D</descripcionRecaudo>
<nro_transaccionId>547936889</nro_transaccionId>
<imp_valor_me>465463</imp_valor_me>
<tipo_Pago>PSE</tipo_Pago>
<processingDate>2020-01-14 08:50:56</processingDate>
<txt_banco_pse>BANCOLOMBIA</txt_banco_pse>
<cod_bco_pse>1007</cod_bco_pse>
<cod_pse>547936889</cod_pse>
<pje_bono_descuento>12</pje_bono_descuento> #De cara al cliente tiene 6% de descuento en SOAT
</Table>
</NewDataSet>
RESPONSE
XML Response Final sin etiqueta cotizador (Ejemplo)
<nro_formulario>92000014</nro_formulario>
<sn_procesado>-1</sn_procesado>
Nota: Los campos resaltados en verde aplican únicamente cuando se utiliza la pasarela de pagos de
Seguros Mundial.
CONSIDERACIONES METODO EXPEDIR POLIZA XML
a) TABLA DE DESCRIPCIÓN PARÁMETRO DE ENTRADA (XML)
Parámetros de entrada a tener en cuenta para expedición SOAT
Campo
cod_suc
fec_emision
cod_grupo_endo
Tipo
numeric
smalldatetime
numeric
fec_vig_desde
fec_vig_hasta
txt_apellido1
txt_apellido2
txt_nombre
cod_tipo_persona
smalldatetime
smalldatetime
varchar
varchar
varchar
tipo_persona
cod_tipo_doc
nro_doc
numeric
varchar
2
20
Not Null
Not Null
cod_tipo_dir
numeric
2
Null
txt_direccion
varchar
60
Not Null
Manual de Usuario
Longitud
3
2
100
30
30
Requerido
Not Null
Not Null
Not Null
Not Null
Not Null
Not Null
Null
Null
Not Null
Descripción
Código de la sucursal
Fecha de emisión de la póliza de SOAT
Tipo de endoso de la póliza de SOAT (hace referencia
al tipo de movimiento, 1= Expedición)
Fecha de vigencia desde de la póliza de SOAT
Fecha de vigencia hasta de la póliza de SOAT
1er apellido del tomador de la póliza de SOAT
2do apellido del tomador de la póliza de SOAT
Nombre del tomador de la póliza de SOAT
Tipo de persona del tomador de la póliza de SOAT. F
NAUTRAL – J JURIDICO
Tipo de documento del tomador de la póliza de SOAT
Numero de documento del tomador de la póliza de
SOAT
Tipo de dirección del Tomador de la póliza de SOAT
(valor por defecto 1)
Dirección del tomador de la póliza de SOAT
Página 47 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
cod_dpto
numeric
3
Not Null
Código del departamento del tomador de la póliza de
SOAT
cod_municipio
numeric
6
Not Null
cod_tipo_telef
txt_telefono
imp_prima_total
numeric
varchar
numeric
2
20
9
Null
Not Null
Not Null
imp_gtos_emi
cod_usuario_solicitud
cod_marca_min_trans
cod_modelo_min_trans
cod_tipo_veh_min_trans
numeric
varchar
varchar
varchar
varchar
18
10
3
5
2
Not Null
Null
Not Null
Not Null
Not Null
aaaa_modelo
txt_patente
txt_motor
txt_chasis
cod_destino
cnt_toneladas
cnt_ocupantes
numeric
varchar
varchar
varchar
numeric
numeric
int
4
15
30
30
2
18
Not Null
Not Null
Not Null
Not Null
Not Null
Not Null
Not Null
Código del municipio del tomador de la póliza de
SOAT
Tipo de teléfono del tomador de la póliza de SOAT
Número telefónico del Tomador de la póliza de SOAT
Valor total de la prima de la póliza de SOAT (prima +
contribución)
Gastos emisión de la póliza de SOAT
Código del usuario que genero la póliza
Código de la marca en Ministerio de Transportes
Código del modelo en Ministerio de Transportes
Código del tipo de vehículo en Ministerio de
Transportes
Año del modelo
Número de placa
Numero de motor
Numero de chasis
Servicio del vehículo
Capacidad en toneladas del vehículo
Número de pasajeros
cnt_cc
cod_pais_matricula
cod_clase_soat
nro_asociado
numeric
numeric
numeric
numeric
5
2
2
3
Not Null
Not Null
Not Null
Not Null
Cilindraje del vehículo
Código del país de matricula
Código de la clase de vehículo
Código de la tarifa del vehículo según tabla del
Ministerio de Transportes
nro_formulario
nro_digito_chequeo
numeric
numeric
10
1
Not Null
Not Null
cod_motivo
int
pje_descuento
txt_marca
numeric
varchar
4
60
Null
Null
Número de formulario de póliza
Digito de chequeo del tomador de la póliza (por
defecto 0)
Código del motivo de la anulación o reemplazo (aplica
solo si se tiene habilitada para el aliado anulaciones y
reemplazos de pólizas expedidas)
Porcentaje de descuento si existe
Texto de la marca cuando no existe en el listado del
Ministerio de Transportes
txt_modelo
nro_formulario_reem
varchar
numeric
80
10
Not Null
Null
cod_valor
imp_pagado
fec_mov
nro_cheque
numeric
numeric
smalldatetime
numeric
2
18
4
5
Not Null
Not Null
Not Null
Null
cod_banco_emi
cod_conducto
nro_tarjeta
nro_aut_tarjeta
numeric
numeric
varchar
numeric
3
2
20
6
Null
Not Null
Null
Null
Manual de Usuario
Not Null
Modelo del vehículo
Numero de póliza de reemplazo (Aplica para procesos
donde se esté generando el reemplazo a una póliza)
Código de la forma de pago
Total pagado
Fecha del movimiento
Número de consignación o Null de acuerdo al tipo de
pago
Código del banco de la cuenta
Forma de pago
Número de tarjeta
Número de autorización de la tarjeta
Página 48 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
nro_voucher_tarjeta
nro_consec_pago
cod_tipo_agente
cod_agente
cod_pto_vta
imp_tasa_runt
txt_correo
txt_vin
numeric
numeric
int
int
int
numeric
varchar
varchar
8
2
5
18
80
20
Null
Not Null
Not Null
Not Null
Not Null
Not Null
Not Null
Not Null
Not null
Not Null
Número de voucher de la tarjeta
Numero consecutivo de pago
Código del tipo de agente
Código del agente
Código del punto de venta
Valor tasa RUNT
Correo electrónico del tomador de la póliza de SOAT
Número del VIN del vehículo para modelos 2011 o
superiores. Para los vehículos anteriores, se debe
enviar "NA". Tamaño estándar de 17 caracteres según
lo definido por el Ministerio de Transporte.
Número correspondiente al tipo de póliza que se le va
a emitir al cliente
Identificador si el tomador es diferente a la póliza
soat. 0 si Tomador AP Igual Tomador SOAT y 1 si el
tomador de AP es diferente del tomador de la póliza
SOAT
1er apellido del tomador de la póliza de accidentes
personales
2do apellido del tomador de la póliza de accidentes
personales
Nombre del tomador de la póliza de accidentes
personales
Tipo de persona del tomador de la póliza AP.
F NAUTRAL – J JURIDICO
Tipo de documento del tomador de la póliza AP
Numero de documento del tomador de la póliza AP
ap_tipo_poliza
numeric
2
Not Null
ap_tomador
numeric
1
ap_txt_apellido1
varchar
100
Not Null
ap_txt_apellido2
varchar
30
Null
ap_txt_nombre
varchar
30
Not Null
60
Not Null
Tipo de dirección del Tomador de la póliza AP (valor
por defecto 1)
Dirección del tomador de la póliza AP
numeric
3
Not Null
Código del departamento del tomador de la póliza AP
ap_cod_municipio
numeric
6
Not Null
Código del municipio del tomador de la póliza AP
ap_pais
numeric
2
rc_id_regla
Int
Not Null
Regla de tarifación para la póliza de RCE
rc_cod_fasecolda
Int
Null
Codigo fasecolda del vehículo para la póliza de RCE
rc_fec_vig_desde
smalldatetime
Not Null
Fecha de vigencia desde de la póliza de RCE
rc_fec_vig_hasta
smalldatetime
Not Null
Fecha de vigencia hasta de la póliza de RCE
rc_imp_iva
Numeric
18
Not Null
Iva de la póliza de RCE
varchar
30
null
Identificador único de la consulta,
valor correspondiente a un GUID, devuelto por el
método web
ap_cod_tipo_persona
Not Null
ap_cod_tipo_doc
ap_nro_doc
numeric
varchar
2
20
ap_cod_tipo_dir
numeric
2
ap_txt_direccion
varchar
ap_cod_dpto
idConsulta
<cotizador/>
<aplicarecaudo_au/>
Manual de Usuario
Codigo del país del tomador de la póliza AP (valor por
defecto 1)
Campo opcional para realizar validación de las reglas
de negocio en los datos ingresados para la expedición
de pólizas sin confirmar aún la transacción
Campo opcional para indicar al Ws que se debe
aplicar el recaudo de automático de la póliza, el envió
Página 49 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
franquiciaId
descripcionRecaudo
nro_transaccionId
imp_valor_me
varchar
50
Null
varchar
Numeric
Numeric
Varchar
150
12
18,2
5
Null
Null
Null
Null
tipo_Pago
Datetime
Null
processingDate
varchar
50
Null
Numeric
5
null
Numeric
12
Null
de esta etiqueta obliga que se envié la información
del pago que se describe a continuación, esta
etiqueta solo se tendrá en cuanta cuando no se a
modo de cotización
Indica la franquicia usada para el pago tanto en
tarjeta crédito o PSE, ej:
<franquiciaId>VISA</franquiciaId>
Descripción del pago enviado a la pasarla de pagos
Nro de transacción del sistema expedidor.
Valor del pago en la pasarela
PSE para pagos con PSE, TC para pago con tarjeta de
crédito, ej <tipo_Pago>TC</tipo_Pago>,
<tipo_Pago>PSE</tipo_Pago>
Fecha y hora de la transacción en la pasarela
Formato yyyy-MM-dd HH:mm:ss
Para el pago con tarjeta crédito enviar la franquicia,
para PSE, se envía el banco del pago PSE,
ej tarjeta crédito:
<txt_banco_pse>VISA</txt_banco_pse >
ej pse:
<txt_banco_pse>BANCOLOMBIA</ txt_banco_pse >
txt_banco_pse
cod_bco_pse
cod_pse
Enviar código de banco devuelto por la pasarela de
pago, para tarjeta de crédito si la franquicio es VISA
enviar 10 para las demás 28
Código de autorización para tarjeta crédito, código
CUS para pago con PSE, si el nro recibido por la
pasarel a incluye letras reemplzar por el nro 99
De los anteriores campos se muestra a continuación un diccionario de datos por cada campo para
conocer el valor que puede recibir acorde al proceso que se esté realizando.
cod_grupo_endo
cod_grupo_en
do
1
2
3
4
5
6
7
10
descripcion
EXPEDICION
MODIFICACION
CANCELACION
RENOVACION
MODIFICACION SIN COBRO DE
PRIMA
DECLARACION
ANULACION DE POLIZA
REHABILITACION VIDA
cod_tipo_persona
Manual de Usuario
Página 50 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
cod_tipo_perso
na
F
J
descripcio
n
NATURAL
JURIDICA
cod_tipo_doc
cod_tipo_d
oc
1
2
3
4
5
abreviatu
ra
CC
CE
NIT
TI
PS
6 TSS
7
8
9
10
11
12
SEN
FDI
RC
ASI
MSI
TP
descripcion
CEDULA DE CIUDADANIA
CEDULA DE EXTRANJERIA
NRO DE NIT
TARJETA DE IDENTIDAD
PASAPORTE
TARJETA DEL SEGURO SOCIAL
EXTR
SOC.EXTRANJERA SIN NIT EN
COLO
FIDEICOMISO
REGISTRO CIVIL
ADULTO SIN IDENTIFICACION
MENOR SIN IDENTIFICACION
TARJETA PROFESIONAL
cod_tipo_dir
txt_desc
1 DOMICILIO
OFICINA/COMERCI
2 AL
6 APARTADO AEREO
cod_tipo_dir
cod_motivo (aplica solo para reemplazos y/o anulaciones) en expediciones se deja valor por
defecto 0
cod_motiv
o
1
2
3
5
6
Manual de Usuario
txt_desc
PERDIDA DE LA POLIZA
CAMBIO DE DATOS DEL TOMADOR
CAMBIO PLACA
CAMBIO DE MODELO
CAMBIO DE PLACA POR ERROR
Página 51 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
7 ERROR EN TIPO DE VEHICULO
8 CAMBIO DE SERVICIO
9 ERROR DE IMPRESION
CAMBIO DE DATOS DE CHASIS Y/O
10 VIN
11 DETERIORO DE LA POLIZA
12 ERROR DE IMPRESION
14 POLIZA NO ENTREGADA
15 PERDIDA DE PAPELERIA
17 CANCELACIÓN DE POLIZA
MODIFICACION POR CAMBIOS
18 VARIOS
20 POLIZA CARGADA EN OSIRIS
ANULACION POR REVERSION DE
21 ENDOSO
23 ERROR DE IMPRESION
24 NO UTILIZACION POLIZA
25 ERROR DEL CLIENTE
26 NO APLICA
28 NO UTILIZACION POLIZA
29 ERROR DEL CLIENTE
30 ERROR DE DIGITACION
31 NO APLICA
32 ANULADO POR NO CONVENIO AP
33 NO UTILIZACION POLIZA AP
4 CAMBIO EN CILINDRAJE
16 DEVOLUCION INTERMEDIARIOS
34 CAMBIO DE DATOS DEL MOTOR
35 CAMBIO DE LINEA
36 CAMBIO DE PASAJEROS
37 CAMBIO DE TONELAJE
13 ERROR DE DIGITACION
38 CAMBIO PAÍS DEL VEHICULO
19 CAMBIO DE MARCA Y/O LINEA
22 ERROR DE DIGITACION
CANCELACIÓN POR
39 CHATARRIZACIÓN
Manual de Usuario
Página 52 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
0
27
40
41
NO APLICA
ERROR DE IMPRESION
RETARIFACIÓN PARCIAL
RETARIFACIÓN TOTAL
CAMBIO PLACA, PASAJEROS Y
42 TOMADOR
cod_clase
cod_clas
e
0
1
2
3
4
5
6
7
8
9
10
clase
Sin Clase
MOTOCICLETA
CAMPEROS Y CAMIONETAS
CARGA O MIXTOS
OFICIALES ESPECIALES
AUTOMOVILES FAMILIARES
VEH. PARTICULARES 6 O MAS
PASAJEROS
AUTOS DE NEGOCIO ALQUILER
ENSEÐANZA
BUSES O BUSETAS
S. PUB. INTERMUNICIPAL
MOTO CARRO
txt_desc_r
ed
Sin C
MOTOS
CAMP
CA O
OE
AF
VEH P
AUTNE
PUBUR
INTER
MOTO
cod_tipo_telef
cod_tipo_tel
ef
1
2
3
4
5
6
7
8
9
10
11
Manual de Usuario
txt_desc
PBX /
CONMUTADOR
CASA
OFICINA
OFICINA 2
OFICINA 3
TELEFAX
TELFAX 2
CELULAR
BEEPER
E-MAIL
RESIDENCIA
Página 53 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
12 RESIDENCIA 2
13 TRANSFERENCIAS
b) PARÁMETROS DE SALIDA
Parámetros de salida a tener en cuenta en el consumo del método ExpedirPólizaXML
Campo
nro_formulario
Tipo
int
sn_procesado
int
txt_error
varchar
Longitud
4
4
200
Descripción
Número formulario
Indicador de respuesta de la expedición, si es 0 no se permite la
expedicon de la poliza
Texto del error en caso que se presente de la expedición, ver tabla de
diccionario de errores
5.1.30. ANULAR POLIZA
AnularPolizaXML
Este método recibe un conjunto de datos en un XML, que contiene toda la necesaria para
la anulación de una póliza de SOAT con sus productos asociados. Retorna un valor que
indica si la transacción fue exitosa (-1) o si fue fallida (0), en este último caso se retorna
un mensaje con la descripción del error.
Validaciones sobre el método:
• Si el SOAT tiene asociado AP y/o RC se realizará la anulación de los tres
productos.
• Se va a validar que la póliza se está anulando el mismo día de la expedición.
• Se valida que el formulario corresponda al punto de venta o al agente.
Resaltado cabecera Http donde se envía <usuario:password> codificado base 64
POST /SOATMundial.asmx HTTP/1.1
Host: swproductosmundial.mundialseguros.com.co
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: http://www.mundialseguros.com.co/AnularPolizaXML
Authorization: basic <usuario:password>
REQUEST
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<AnularPolizaXML xmlns="http://www.mundialseguros.com.co/">
<modelo>
Manual de Usuario
Página 54 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
<nro_formulario>92000410</nro_formulario>
<cod_suc>14</cod_suc>
<cod_tipo_agente>1</cod_tipo_agente>
<cod_agente>80001142</cod_agente>
<cod_pto_vta>42973</cod_pto_vta>
<cod_grupo_endo>7</cod_grupo_endo>
<cod_motivo>13</cod_motivo>
<cod_usuario_solicitud>WS_FULLCAR</cod_usuario_solicitud>
<txt_patente>USF14E</txt_patente>
<fec_anulacion>23/06/2021</fec_anulacion>
</modelo>
</AnularPolizaXML>
</soap:Body>
</soap:Envelope>
RESPONSE
XML Response (Ejemplo)
<nro_formulario>92000410</nro_formulario>
<sn_procesado>-1</sn_procesado>
CONSIDERACIONES METODO ANULAR POLIZA
a) TABLA DE DESCRIPCIÓN PARÁMETRO DE ENTRADA
Parámetros de entrada a tener en cuenta para la anulación
Campo
Tipo
Longitu
d
cod_suc
Integer
3
nro_formulario
Integer
10
cod_motivo
Integer
cod_grupo_endo
Integer
2
cod_usuario
String
10
cod_agente
Integer
cod_pto_vta
Integer
cod_tipo_agente
Integer
txt_patente
String
fec_anulacion
Smalldatetime
5
6
Requerid
o
Not
Null
Not
Null
Not
Null
Not
Null
Not
Null
Not
Null
Not
Null
Not
Null
Not
Null
Not
Null
Descripción
Código de la sucursal
Número de formulario de póliza
Código del motivo de la anulación
Código de endoso, para anulación debe ser 7
Código del usuario que anula la póliza
Código del agente
Código del punto de venta
Código del tipo de agente
Placa asociada al número de formulario que se
anulara
Fecha de anulación de la póliza (día en curso)
b) PARÁMETROS DE SALIDA
Manual de Usuario
Página 55 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Parámetros de salida a tener en cuenta en el consumo del método ExpedirPólizaXML
Campo
Tipo
Longitud
nro_formulario
int
4
sn_procesado
int
4
txt_error
varchar
200
Descripción
Número formulario
Indicador de respuesta de la expedición, si es 0 no se permite la
expedicon de la poliza
Texto del error en caso que se presente en la anulación, ver tabla de
diccionario de errores
5.2. TAMAÑO DE LA TRANSACCIÓN Y DE LOS ARCHIVOS A INTERCAMBIAR
TAMAÑO DE LOS ARCHIVOS DE CADA SERVICIO
Se establece el promedio tamaño de cada archivo en bytes por cada transacción.
TIEMPO DE RESPUESTA DE CADA SERVICIO
Se realiza el seguimiento a las transacciones realizadas en un lapso de una semana; y los
servicios web expuestos obtuvieron los siguientes tiempos dados en segundos y milésimas de
segundos.
6. PROCESO DE EXPEDICIÓN
A continuación, se detalla a través del diagrama de actividades el proceso de expedición para el producto SOAT
y de igual manera para la combinación SOAT y AP:
Manual de Usuario
Página 56 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Manual de Usuario
Página 57 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
Manual de Usuario
Página 58 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
7. DICCIONARIO DE ERRORES
Descripción de las validaciones por cada campo del XML y los errores retornados conocidos.
codigo_error
E0000
E0101
E0102
E0103
E0104
E0105
E0106
E0107
E0108
E0109
E0110
E0111
E0112
E0113
E0114
E0115
E0116
E0117
E0118
E0119
E0120
E0121
E0122
E0123
E0124
E0125
E0126
E0127
E0128
E0129
E0130
E0131
Manual de Usuario
descripcion_error
Error inesperado
LA FECHA DE EXPEDICION NO PUEDE SER VACIA
LA FECHA DE EXPEDICION NO PUEDE SER ANTERIOR A HOY
LA FECHA DE EXPEDICION NO PUEDE SER FUTURA
FALTA VIGENCIA DESDE
LA FECHA DE VIGENCIA DESDE DEBE SER SUPERIOR A LA DE EXPEDICION
FALTA VIGENCIA HASTA
LA FECHA DE VIGENCIA DESDE NO PUEDE SER MAYOR A LA FECHA DE VIGENCIA HASTA
FECHAS DE VIGENCIA INCORRECTAS, DEBE SER MESES COMPLETOS
FALTA INFORMACION TOMADOR
FALTA INFORMACION VEHICULO
FALTA INFORMACION PAGO
SE REQUIERE VALOR PAGADO
SE REQUIERE FORMA DE PAGO
FALTA TIPO PERSONA
FALTA TIPO DOCUMENTO
CODIGO DEL TIPO DE DOCUMENTO NO HABILITADO PARA LA EMISION
SE REQUIERE IDENTIFICACION TOMADOR
LONGITUD IDENTIFICACION TOMADO NO VALIDA
IDENTIFICACION TOMADOR DEBE SER NUMERICO
LONGITUD IDENTIFICACION NIT
FALTA APELLIDO1
FALTA NOMBRE
FALTA CAMPO TXT_SEXO O NO ES VALIDO
FORMATO CORREO ELECTRONICO NO ES VALIDO
EL CODIGO DEL DEPARTAMENTO NO EXISTE
EL CODIGO DEL MUNICIPIO NO EXISTE
EL CODIGO DEL PAIS NO EXISTE
FALTA TIPO DE DIRECCION
FALTA DIRECCION
FALTA TIPO DE TELEFONO
TELEFONO NO ES VALIDO
Página 59 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
E0132
E0128
E0129
E0130
E0131
E0132
E0128
E0129
E0130
E0131
E0132
E0133
E0134
E0135
E0136
E0137
E0138
E0139
E0140
E0141
E0142
E0143
E0144
E0145
E0146
E0147
E0148
E0149
E0150
E0151
E0152
E0153
E0154
E0155
E0156
E0157
E0158
Manual de Usuario
LONGITUD DEL NUMERO TELEFONICO NO ES VALIDA
FALTA TIPO DE DIRECCION
FALTA DIRECCION
FALTA TIPO DE TELEFONO
TELEFONO NO ES VALIDO
LONGITUD DEL NUMERO TELEFONICO NO ES VALIDA
FALTA TIPO DE DIRECCION
FALTA DIRECCION
FALTA TIPO DE TELEFONO
TELEFONO NO ES VALIDO
LONGITUD DEL NUMERO TELEFONICO NO ES VALIDA
FALTA CODIGO CLASE
FALTA CODIGO TARIFA
FALTA MODELO
EL MODELO ES MUY ANTIGUO
EL MODELO ES SUPERIOR A UN AÑO EN EL FUTURO
FALTA PLACA
CARACTERES NO VALIDOS EN PLACA
FALTA MOTOR
LONGITUD DEL ID MOTOR NO ES VALIDO
CARACTERES NO VALIDOS EN MOTOR
FALTA CHASIS
LONGITUD DEL ID CHASIS NO ES VALIDO
CARACTERES NO VALIDOS EN CHASIS
FALTA SERVICIO
FALTA PAIS MATRICULA
EL CODIGO DEL PAIS NO ESTA HABILITADO PARA SOAT
FALTA CODIGO MARCA
FALTA CODIGO MODELO
FORMATO VIN NO ES VALIDO
DEBE INGRESAR LA DESCRIPCION DE LA LINEA
CILINDRAJE NO ES VALIDO
PASAJEROS. PARA LA TARIFA SELECCIONADA PASAJEROS NO PUEDE SER CERO
PASAJEROS. PARA LA TARIFA SELECCIONADA PASAJEROS NO PUEDE SER MENOR A 6
PASAJEROS. PARA LA TARIFA SELECCIONADA PASAJEROS NO PUEDE SER MENOR A 13
FALTA CAPACIDAD
FALTA CAPACIDAD. Utilice Tarifa Camperos o Camionetas
Página 60 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
E0159
E0160
E0161
E0162
E0163
E0164
E0165
E0166
E0167
E0201
E0202
E0203
E0204
E0205
E0206
E0207
E0208
E0209
E0210
E0211
E0212
E0213
E0214
E0215
E0216
E0217
E0218
E0219
E0220
E0221
E0222
E0223
E0224
E0225
Manual de Usuario
FALTA CAPACIDAD, Para la tarifa seleccionada la capacidad no puede ser mayor a 1
FALTA CODIGO DE MOVIMIENTO, COD_GRUPO_ENDO
FALTA NRO DE FORMULARIO
FALTA CODIGO DE PUNTO DE VENTA
FALTA CODDIGO DE SUCURSAL
FALTA CODIGO TIPO DE AGENTE
FALTA CODIGO DE AGENTE
SE REQUIERE CODIGO DE USUARIO
FALTA INFORMACION POLIZA SOAT
NO EXISTE SUCURSAL
NO EXISTE MUNICIPIO
TIPO DE DIRECCION NO EXISTE
TIPO DE TELEFONO NO EXISTE
EL CODIGO DE LA CLASE NO EXISTE
EL CODIGO DEL MOTIVO NO EXISTE
EL CODIGO DE LA CLASE NO EXISTE
EL CODIGO DE LA MARCA NO EXISTE
EL CODIGO DE LA LINEA NO EXISTE
EL CODIGO DEL TIPO DE AGENTE NO EXISTE
EL CODIGO DEL TIPO DE VEHICULO NO EXISTE
EL CODIGO DEL USUARIO NO EXISTE
EL INTERMEDIARIO ASOCIADO AL USUARIO SE ENCUENTRA INACTIVO, POR FAVOR
COMUNICARSE CON LA SUCURSAL
EL PUNTO DE VENTA ASOCIADO AL USUARIO SE ENCUENTRA INACTIVO, POR FAVOR
COMUNICARSE CON LA SUCURSAL
EL FORMULARIO {0} YA ESTA EXPEDIDO PARA LA PLACA {1}
EL FORMULARIO {0} NO SE PUEDE ANULAR PORQUE NO HA SIDO EXPEDIDO
EL FORMULARIO {0} NO ESTA CARGADO EN LA PAPELERIA
EL FORMULARIO {0} NO ESTA DISPONIBLE
EL FORMULARIO {0} NO ESTA ASIGANDO AL PUNTO DE VENTA {1}
SERVICIO. PARA LA TARIFA SELECCIONADA NO APLICA
LONGITUD DE LA PLACA NO ES VALIDA
FORMATO DE LA PLACA NO ES VALIDO
Para atender tu solicitud, comunícate a nuestra línea nacional de atención al cliente
018000 112684, de lunes a viernes de 8am a 5pm.
ERROR DE COMUNICACION, COMUNIQUESE CON LA SUCURSAL, NO SE ENCONTRO LA
POLIZA {0}
LA POLIZA QUE INTENTA REEMPLAZAR ESTA ANULADA
Página 61 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
E0226
E0227
E0228
E0229
E0230
E0231
E0232
E0233
E0234
E0235
E0236
E0237
E0238
E0239
E0240
E0241
E0242
E0243
E0244
E0245
E0246
E0247
E0248
E0249
E0250
E0251
E0252
E0253
E0254
E0255
E0256
E0257
E0258
E0259
E0260
Manual de Usuario
LA POLIZA QUE INTENTA ANULAR YA ESTA ANULADA
SOLO SE PUEDE REEMPLAZAR EL ULTIMO FORMULARIO DE LA PLACA
SOLO SE PUEDE ANULAR EL ULTIMO FORMULARIO DE LA PLACA
EL CILINDRAJE NO PUEDE SER SUPERIOR A {0}
SE REQUIERE CILINDRAJE
PASAJEROS. PARA LA TARIFA SELECCIONADA PASAJEROS NO PUEDE SER MAYOR A {0}
NO EXISTE EL USUARIO
NO TIENE AUTORIZACION PARA EXPEDIR LA VIGENCIA INGRESADA
NO TIENE AUTORIZACION PARA EXPEDIR POLIZAS CON FECHA DE INICIO FUTURA
SUPERIOR A {0}
{0} TIENE UNA VIGENCIA ACTIVA DESDE --->{1:dd/MM/yyyy} HASTA ---> {2:dd/MM/yyyy}
ERROR DE COMUNICACION, COMUNIQUESE CON LA SUCURSAL
Sr. Usuario, su punto de venta no está autorizado para la emisión de reemplazos,
ERROR DE COMUNICACION, COMUNIQUESE CON LA SUCURSAL
Sr.Usuario, la póliza que está intentando reemplazar ha excedido el número máximo de
movimientos permitidos por vigencia
LA POLIZA NO SE PUEDE REEMPLAZAR. SOLO LA PUEDE ANULAR.
NO SE PUEDE REEMPLAZAR LA POLIZA, LOS DATOS GENERAN CAMBIO DE TARIFA {0}
LA POLIZA QUE INTENTA REEMPLAZAR NO ESTA VIGENTE
NO SE PUEDE REEMPLAZAR LA POLIZA, LOS DATOS GENERAN CAMBIO DE TARIFA {0}
ERROR DE COMUNICACION, COMUNIQUESE CON LA SUCURSAL, NO SE ENCONTRO LA
POLIZA
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL MOTOR
EL MOTIVO ACTUAL NO PERMITE MODIFICAR LA PLACA
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL CHASIS
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL CILINDRAJE
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL NUMERO DE PASAJEROS
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL MODELO
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL SERVICIO
EL MOTIVO ACTUAL NO PERMITE MODIFICAR LA LINEA
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL TONELAJE
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL VIN
EL MOTIVO ACTUAL NO PERMITE MODIFICAR LA MARCA
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL NOMBRE DE TOMADOR
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL PRIMER APELLIDO DEL TOMADOR
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL SEGUNDO APELLIDO DEL TOMADOR
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL TIPO DE DOCUMENTO
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL NUMERO DE DOCUMENTO
Página 62 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
E0261
E0262
E0263
E0264
E0265
E0266
E0267
E0268
E0269
E0270
E0271
E0272
E0273
E0273
E0274
E0275
E0276
E0277
E0278
E0279
E0280
E0281
E0282
E0283
E0284
E0285
E0286
E0287
E0288
Manual de Usuario
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL SEXO
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL TIPO DE PERSONA
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL TIPO DE DIRECCION
EL MOTIVO ACTUAL NO PERMITE MODIFICAR LA DIRECCION
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL TIPO DE TELEFONO
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL TELEFONO
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL MUNICIPIO
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL DEPARTAMENTO
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL CORREO
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL PAIS DEL VEHICULO
LA POLIZA YA ESTA VIGENTE, NO SE PUEDE ANULAR
LA PÓLIZA NO SE PUEDE ANULAR, EL SOAT ES IRREVOCABLE
CODIGO DE TARIFA INCORRECTO, DEBERIA SER: {0} VERIFIQUE
CODIGO DE TARIFA INCORRECTO, DEBERIA SER: {0} VERIFIQUE
LA VIGENCIA NO PUEDE SER INFERIOR A LOS {0} DÃAS. POR FAVOR VERIFIQUE LA
FECHA DE VIGENCIA.
FECHAS DE VIGENCIA INCORRECTAS, DEBE SER MESES COMPLETOS
EL OBJETO DE TIPO 'DATOSVEHICULO' VIENE NULO. ES REQUERIDO PARA PODER
REALIZAR EL CÃLCULO DE LAPÓLIZA.
SE REQUIERE EL VALOR DEL CAMPO 'CAPACIDAD', PARA PODER REALIZAR EL CÃLCULO
DE LA PÓLIZA
SE REQUIERE EL VALOR DEL CAMPO 'CILINDRAJE', PARA PODER REALIZAR EL CÃLCULO
DE LA PÓLIZA.
SE REQUIERE EL VALOR DEL CAMPO 'CLASE', PARA PODER REALIZAR EL CÃLCULO DE
LA PÓLIZA.
SE REQUIERE EL VALOR DEL CAMPO 'MODELO', PARA PODER REALIZAR EL CÃLCULO
DE LA PÓLIZA
SE REQUIERE EL VALOR DEL CAMPO 'PASAJEROS', PARA PODER REALIZAR EL CÃLCULO
DE LA PÓLIZA
SE REQUIERE EL VALOR DEL CAMPO 'CODIGOSUCURSAL', PARA PODER REALIZAR EL
CÃLCULO DE LA PÓLIZA
SE REQUIERE EL VALOR DEL CAMPO 'CODIGOAGENTE', PARA PODER REALIZAR EL
CÃLCULO DE LA PÓLIZA
SE REQUIERE EL VALOR DEL CAMPO 'CODIGOPUNTOVENTA', PARA PODER REALIZAR
EL CÃLCULO DE LA PÓLIZA
LA FECHA DE VIGENCIA INICIAL NO ES UNA FECHA PÓLIZA
LA FECHA DE VIGENCIA FINAL NO ES UNA FECHA PÓLIZA
LA FECHA DE VIGENCIA INICIAL NO PUEDE SER MAYOR A LA FECHA DE VIGENCIA FINAL.
LA FECHA INICIAL DE VIGENCIA NO PUEDE SER INFERIOR O IGUAL A LA FECHA DE
EXPEDICION.
Página 63 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
E0289
E0321
E0322
S05
SO1
LA FECHA FINAL DE VIGENCIA NO PUEDE SER INFERIOR A LA FECHA ACTUAL.
LONGITUD DIRECCION
EL NOMBRE DEL TOMADOR DE LA POLIZA ES DIFERENTE Y NO SE PUEDE CAMBIAR
Indicia que se debe surtir los controles en la aplicación cliente
No se permite la emisión de la poliza
Campo
cod_suc
Validaciones
Existencia Código Valido
Mensajes
EL CODIGO DE LA SUCURSAL NO EXISTE
fec_emision
FormatoFechas
LA FECHA DE EXPEDICION ES INVALIDA (DD/MM/AAAA)
fec_emision < fecHoy
LA FECHA DE EXPEDICION NO PUEDE SER ANTERIOR A HOY
fec_emision > fecHoy
LA FECHA DE EXPEDICION NO PUEDE SER FUTURA
1 EXPEDICION
EL CODIGO DEL MOVIMIENTO NO ES VALIDO
cod_grupo_endo
5 MODIFICACION
7 ANULACION
fec_vig_desde
Código Diferente a los
habilitados ws soat
FormatoFechas
El valor para el código de grupo de movimiento no es una referencia vá
lida
LA FECHA DE VIGENCIA DESDE ES INVALIDA (DD/MM/AAAA)"
fec_emision < fec_vig_desde
LA FECHA DE VIGENCIA DESDE DEBE SER SUPERIOR A LA DE
EXPEDICION
NO TIENE AUTORIZACION PARA EXPEDIR LA VIGENCIA INGRESADA
fec_vig_hasta
diasVigencia,
cod_usuario_solicitud
fec_vig_desde <>
fec_vig_hasta
FormatoFechas
FECHAS DE VIGENCIA INCORRECTAS, DEBE SER MESES COMPLETOS
txt_apellido1
fec_vig_desde fec_vig_hasta diasVigencia
Caracteres inválidos texto
txt_apellido2
Reemplazos afectando un
campo no solicitado
Caracteres inválidos texto
EL MOTIVO ACTUAL NO PERMITE MODICAR EL PRIMER APELLIDO DEL
TOMADOR
CARACTERES NO VALIDOS EN APELLIDO 2 DE TOMADOR
txt_nombre
Reemplazos afectando un
campo no solicitado
Caracteres inválidos texto
EL MOTIVO ACTUAL NO PERMITE MODICAR EL SEGUNDO APELLIDO
DEL TOMADOR
CARACTERES NO VALIDOS EN NOMBRE TOMADOR
cod_tipo_persona
Reemplazos afectando un
campo no solicitado
F NATURAL - J JURÍDICAS
EL MOTIVO ACTUAL NO PERMITE MODICAR EL NOMBRE DE
TOMADOR"
nro_digito_chequeo
EL MOTIVO ACTUAL NO PERMITE MODICAR EL TIPO DE PERSONA
cod_tipo_doc
Reemplazos afectando un
campo no solicitado
Existencia Código Valido
Existencia Código Valido
CODIGO DEL TIPO DE DOCUMENTO NO HABILITADO PARA SOAT
cod_tipo_doc <> "5"
IDENTICACION TOMADOR DEBE SER NUMERICO
Manual de Usuario
La vigencia del endoso es diferente a la vigencia anterior
LA FECHA DE VIGENCIA HASTA ES INVALIDA (DD/MM/AAAA)"
CARACTERES NO VALIDOS EN APELLIDO 1 DE TOMADOR
EL CODIGO DEL TIPO DE DOCUMENTO NO EXISTE
Página 64 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
LONGITUD IDENTICACION NIT
cod_tipo_dir
cod_tipo_doc "3" , nro_doc >
9 digitos
Reemplazos afectando un
campo no solicitado
Código Diferente a los
habilitados ws soat
Caracteres inválidos
numéricos
Reemplazos afectando un
campo no solicitado
Existencia Código Valido
EL MOTIVO ACTUAL NO PERMITE MODICAR EL TIPO DE DIRECCION
txt_direccion
Reemplazos afectando un
campo no solicitado
Caracteres inválidos texto
EL MOTIVO ACTUAL NO PERMITE MODICAR LA DIRECCION
cod_dpto
Reemplazos afectando un
campo no solicitado
Existencia Código Valido
Reemplazos afectando un
campo no solicitado
Existencia Código Valido
EL MOTIVO ACTUAL NO PERMITE MODICAR EL DEPARTAMENTO
cod_municipio
Existencia Código Valido
txt_sexo
cod_tipo_telef
Reemplazos afectando un
campo no solicitado
Reemplazos afectando un
campo no solicitado
Existencia Código Valido
LOS CODIGOS DE PAIS, DEPARTAMENTO Y MUNICIPIO NO SON
VALIDOS
EL MOTIVO ACTUAL NO PERMITE MODICAR EL MUNICIPIO
EL MOTIVO ACTUAL NO PERMITE MODICAR EL TIPO DE TELEFONO
txt_telefono
Reemplazos afectando un
campo no solicitado
Caracteres inválidos texto
txt_telefono < 7 digitos
LONGITUD DEL NUMERO TELEFONICO
Reemplazos afectando un
campo no solicitado
validar que el cálculo de la
aplicación sea igual
validar que el cálculo de la
aplicación sea igual
Existencia Código Valido
EL MOTIVO ACTUAL NO PERMITE MODICAR EL TELEFONO
Existencia Código Valido
EL CODIGO DE LA MARCA NO EXISTE
Reemplazos afectando un
campo no solicitado
Existencia Código Valido
EL MOTIVO ACTUAL NO PERMITE MODICAR LA MARCA
Sin línea <> 999
El valor para el código de modelo no es una referencia válida
Existencia Código Valido
EL CODIGO DEL TIPO DE VEHICULO NO EXISTE"
validar tabla
tipo_veh_min_trans
El valor para el código de tipo de veh¡culo no es una referencia válida
nro_doc
imp_prima_total
imp_gtos_emi
cod_usuario_solicit
ud
cod_marca_min_tr
ans
cod_modelo_min_
trans
cod_tipo_veh_min
_trans
Manual de Usuario
EL MOTIVO ACTUAL NO PERMITE MODICAR EL TIPO DE DOCUMENTO
El valor para el código de tipo de documento del tomador no es una ref
erencia válida
CARACTERES NO VALIDOS EN IDENTICACION TOMADOR"
EL MOTIVO ACTUAL NO PERMITE MODICAR EL NUMERO DE
DOCUMENTO
EL CODIGO DEL TIPO DE DIRECCION NO EXISTE
CARACTERES NO VALIDOS EN DIRECCION DE TOMADOR
EL CODIGO DEL DEPARTAMENTO NO EXISTE
LOS CODIGOS DEPARTAMENTO Y MUNICIPIO NO SON VALIDOS
EL MOTIVO ACTUAL NO PERMITE MODICAR EL SEXO
EL CODIGO DEL TIPO DE TELEFONO NO EXISTE
CARACTERES NO VALIDOS EN TELEFONO DE TOMADOR
El valor de la prima no corresponde a los datos suministrados
La prima total debe ser igual a los gastos de emisi¢n para este tipo de e
ndoso
EL CODIGO DEL USUARIO NO EXISTE
EL CODIGO DE LA LINEA NO EXISTE
Página 65 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
aaaa_modelo
Modelo numeric
EL MODELO DEBE SER NUMERICO
aaaa_modelo < 1900
EL MODELO ES MUY ANTIGUO"
aaaa_modelo > anoMaximo
EL MODELO ES SUPERIOR A UN AÑO EN EL FUTURO
CARACTERES NO VALIDOS EN MODELO
txt_motor
Caracteres inválidos
numéricos
Reemplazos afectando un
campo no solicitado
("^([AZ]{3})(\d{3})$"(_txt_patente)
("(?=^.{7}$)[A-Za-z]+[09]")(txt_patente)
Caracteres inválidos
alfanuméricos
Reemplazos afectando un
campo no solicitado
Superior a 4 digitos
CARACTERES NO VALIDOS EN MOTOR
txt_chasis
Caracteres inválidos
alfanuméricos
Reemplazos afectando un
campo no solicitado
Superior a 4 digitos
EL MOTIVO ACTUAL NO PERMITE MODICAR EL CHASIS
cod_destino
Reemplazos afectando un
campo no solicitado
Emisiones pólizas atados a
otra vigente
txtPatenteVig + txt_vin +
txt_motor
Existencia Código Valido
Caracteres inválidos
numéricos
cod_clase de uso/servicio sea
valido
Reemplazos afectando un
campo no solicitado
se valida el valor de la
capacidad en toneladas
1= Utilice Tarifa Camperos o
Camionetas
capacidad > 0
Caracteres inválidos
numéricos
Caracteres inválidos
numéricos
pasajeros = 0
SERVICIO DEBE SER NUMERICO
cod_clase PasajerosTarifa >
cantidad
pasajeros < 6
PASAJEROS. PARA LA TARIFA SELECCIONADA PASAJEROS NO PUEDE
SER MAYOR A
PASAJEROS PARA LA TARIFA SELECCIONADA PASAJEROS NO PUEDE
SER MENOR A 6"
PASAJEROS PARA LA TARIFA SELECCIONADA PASAJEROS NO PUEDE
SER MENOR A 13
txt_patente
cnt_toneladas
cnt_ocupantes
pasajeros < 13
Manual de Usuario
EL MOTIVO ACTUAL NO PERMITE MODICAR EL MODELO
FORMATO DE LA PLACA
FORMATO DE LA PLACA
CARACTERES NO VALIDOS EN PLACA
EL MOTIVO ACTUAL NO PERMITE MODICAR LA PLACA
LONGITUD DEL MOTOR
EL MOTIVO ACTUAL NO PERMITE MODICAR EL MOTOR
LONGITUD DEL CHASIS
TIENE UNA VIGENCIA ACTIVA DESDE--> fecVericarIni HASTA-->
EL CODIGO DEL SERVICIO NO EXISTE
SERVICIO. PARA LA TARIFA SELECCIONADA APLICAN SOLAMENTE LOS
SIGUIENTES SERVICIOS
EL MOTIVO ACTUAL NO PERMITE MODICAR EL SERVICIO
CAPACIDAD DEBE SER NUMERICO
CAPACIDAD PUEDE SER MAXIMO 1
CAPACIDAD DEBE SER CERO
CARACTERES NO VALIDOS EN CAPACIDAD
PASAJEROS DEBE SER NUMERICO
PARA LA TARIFA SELECCIONADA PASAJEROS NO PUEDE SER CERO"
Página 66 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
cnt_cc
CILINDRAJE DEBE SER NUMERICO
cod_pais_matricula
Caracteres inválidos
numéricos
lonCilindraje < 2 And
_cod_clase <> 3
MaxCilindraje > cilindros0 +
cod_clase
Caracteres inválidos
numéricos
Reemplazos afectando un
campo no solicitado
Existencia Código Valido
EL MOTIVO ACTUAL NO PERMITE MODICAR EL PAÍS DEL VEHICULO
cod_clase_soat
Reemplazos afectando un
campo no solicitado
Existencia Código Valido
Valida tarifa cod_clase,
Código de tarifa incorrecto, debería ser: "@ " Verifique !
LONGITUD DEL CILINDRAJE
EL CILINDRAJE NO PUEDE SER SUPERIOR A
CARACTERES NO VALIDOS EN CILINDRAJE
EL MOTIVO ACTUAL NO PERMITE MODIFICAR EL CILINDRAJE
EL CODIGO DEL PAIS NO ESTA HABILITADO PARA SOAT
EL CODIGO DE LA CLASE NO EXISTE
cilindros, aaaa_modelo
nro_asociado
capacidad, pasajeros
nro_formulario
formulario ya Expedido
YA ESTA EXPEDIDO PARA LA PLACA" + txt_patente
Consultar Estado Formulario
EL FORMULARIO NO ESTA CARGADO EN LA PAPELERIA
formulario ya Expedido
EL FORMULARIO NO SE PUEDE ANULAR PORQUE NO HA SIDO
EXPEDIDO
nro_digito_cheque
o
cod_motivo
persona jurídica hace calculo
den Del 0 a 9
Existencia Código Valido
EL CODIGO DEL MOTIVO NO EXISTE
El valor para el código de motivo no es una referencia válida
nro_formulario_re
em
cod_valor
Código Diferente a los
habilitados ws soat
Reemplazos afectando un
campo no solicitado
ingresar descripción de la
línea
Numero formulario soat
estado = 16
1 EFECTIVO
cod_agente
Se valida EstadoAgente
EL INTERMEDIARIO ASOCIADO AL USUARIO SE ENCUENTRA INACTIVO,
POR FAVOR COMUNICARSE CON LA SUCURSAL
El valor para el código de agente no es una referencia válida
cod_pto_vta
se valida EstadoPtoVta
EL PUNTO DE VENTA ASOCIADO AL USUARIO SE ENCUENTRA
INACTIVO, POR FAVOR COMUNICARSE CON LA SUCURSAL
EL FORMULARIO NO ESTA ASIGNADO AL PUNTO DE VENTA
txt_marca
txt_modelo
cod_pto_vta - nro_formulario
txt_correo
txt_vin
Manual de Usuario
EL MOTIVO ACTUAL NO PERMITE MODICAR LA MARCA
DEBE INGRESAR LA DESCRIPCION DE LA LINEA
El formulario anterior no tiene un estado v lido para realizar el endoso
formas de pago habilitadas
Caracteres inválidos^\w+([+.']\w+)*@\w+([.]\w+)*\.\w+([-.]\w+)*$")"
Reemplazos afectando un
campo no solicitado
caracteres inválidos
FORMATO CORREO ELECTRONICO
Caracteres inválidos
numéricos
EL MOTIVO ACTUAL NO PERMITE MODICAR EL VIN
EL MOTIVO ACTUAL NO PERMITE MODICAR EL CORREO
FORMATO VIN
Página 67 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
ap_tipo_poliza
ap_tomador
ap_txt_apellido1
Código Diferente a los
habilitados ws soat
0 si Tomador AP Igual
Tomador SOAT
1 si Tomador AP diferente
Tomador SOAT
Caracteres inválidos texto
El valor para el código de agente no es una referencia válida
El valor para el código de tipo de documento del tomador no es una ref
erencia válida
CARACTERES NO VALIDOS EN APELLIDO 1 DE TOMADOR AP
cod_tipo_doc <>
ap_cod_tipo_doc, _nro_doc
<> ap_nro_doc, txt_apellido1
<> ap_txt_apellido1,
txt_apellido2 <>
ap_txt_apellido2
Caracteres invalidos texto
CARACTERES NO VALIDOS EN APELLIDO 2 DE TOMADOR AP
ap_txt_nombre
Caracteres invalidos texto
CARACTERES NO VALIDOS EN NOMBRE TOMADOR AP
ap_cod_tipo_doc
Existencia Código Valido
EL CODIGO DEL TIPO DE DOCUMENTO NO EXISTE
CODIGO DEL TIPO DE DOCUMENTO NO HABILITADO PARA AP
ap_nro_doc
Código Diferente a los
habilitados ws soat
Tomadores diferentes
ap_txt_apellido2
EL TOMADOR DE LA POLIZA DE AP ES DERENTE AL DE LA POLIZA DE
SOAT Y EL VALOR DEL CAMPO QUE IDENTICA SI LOS TOMADORES
SON DERENTES ES IGUAL A 0
cod_tipo_doc <> "5"
EL TOMADOR DE LA POLIZA DE AP ES IGUAL AL DE LA POLIZA DE
SOAT Y EL VALOR DEL CAMPO QUE IDENTICA SI LOS TOMADORES
SON DIFERENTES ES IGUAL A 1
IDENTICACION TOMADOR AP DEBE SER NUMERICO
ap_nro_doc < 4 digitos
LONGITUD DE IDENTICACION TOMADOR AP
Caracteres invalidos
numéricos
Existencia Código Valido
CARACTERES NO VALIDOS EN IDENTICACION TOMADOR AP "
CARACTERES NO VALIDOS EN DIRECCION DE TOMADOR AP
ap_cod_dpto
Caracteres invalidos
alfanuméricos
Existencia Código Valido
ap_cod_tipo_telef
Existencia Código Valido
EL CODIGO DEL TIPO DE TELEFONO NO EXISTE
ap_txt_telefono
ap_txt_telefono < 7 digitos
LONGITUD DEL NUMERO TELEFONICO TOMADOR AP
CARACTERES NO VALIDOS EN TELEFONO DE TOMADOR AP
ap_fec_vig_desde
Caracteres invalidos
numéricos
fec_emision<>ap_fec_emisio
n
fec_vig_desde<>ap_fec_vig_
desde
fec_vig_hasta<>ap_fec_vig_h
asta
FormatoFechas
ap_fec_vig_hasta
FormatoFechas
LA FECHA DE VIGENCIA HASTA DE AP ES INVALIDA (DD/MM/AAAA)"
ap_valor_asegurad
o
ap_valor_poliza
valor numeric
EL VALOR ASEGURADO DE LA POLIZA AP DEBE SER NUMERICO
se valida el Valor Póliza AP y
Consultar Tipo PolizaAP
valor numeric
El VALOR DE LA POLIZA DE AP NO ES UN VALOR VALIDO PARA ESTA
TARIFA
VALOR DE LA POLIZA DEBE SER NUMERICO
ap_placa_asistenci
a
si aplica asistencia se ingresó
la txt_patente
DEBE ENVIAR LA PLACA DE LA POLIZA DE SOAT COMO PLACA DE
ASISTENCIA DE AP
ap_cod_tipo_dir
ap_txt_direccion
ap_fec_emision
Manual de Usuario
EL CODIGO DEL TIPO DE DIRECCION NO EXISTE
EL CODIGO DEL DEPARTAMENTO NO EXISTE
FECHA DE VIGENCIA HASTA DE AP ES DERENTE A LA DE SOAT
FECHA DE EMISION DE AP ES DERENTE A LA DE SOAT
LA FECHA DE VIGENCIA DESDE DE AP ES INVALIDA (DD/MM/AAAA
Página 68 de 69
Mundial de Seguros – Expedición WS SOAT
____________________________________________________________________________________________
nro_formulario
cod_pto_vta
cod_pto_vta
Manual de Usuario
txt_patente <>
_ap_placa_asistencia
Placa Asistencia AP
habilitados ws soat y ap
Consultar Fecha Expedición
<> fec_emision
PtovtaReemplazo habilitados
ws soat
CantidadReemplazosPoliza
habilitados ws soat
LA PLACA DE ASISTENCIA DE AP DEBE SER LA MISMA DE LA POLIZA DE
SOAT
LA PLACA DE ASISTENCIA DE AP NO APLICA PARA ESTA TARIFA
LA PÓLIZA NO SE PUEDE ANULAR, EL SOAT ES IRREVOCABLE.
SR. USUARIO, SU PUNTO DE VENTA NO ESTÁ AUTORIZADO PARA LA
EMISIÓN DE REEMPLAZOS, POR FAVOR INDICAR AL CLIENTE QUE SE
COMUNIQUE CON LA LÍNEA DE ATENCIÓN 01 8000 111935 OPCIÓN 4,
O QUE ACCEDA A LA PÁGINA DE INTERNET
HTTP://WWW.SOATMUNDIAL.COM.CO/, SECCIÓN RECURSOS
DESCARGABLES, PARA VERIFICAR EN EL LISTADO DE PUNTOS
AUTORIZADOS DONDE PUEDE REALIZAR EL REEMPLAZO DE LA
PÓLIZA
SR. USUARIO, LA PÓLIZA QUE ESTÁ INTENTANDO REEMPLAZAR HA
EXCEDIDO EL NÚMERO MÁXIMO DE MOVIMIENTOS PERMITIDOS POR
VIGENCIA, POR FAVOR INDICAR AL CLIENTE QUE SE COMUNIQUE CON
LA LÍNEA DE ATENCIÓN 01 8000 111935 OPCIÓN 4, O QUE ACCEDA A
LA PÁGINA DE INTERNET HTTP://WWW.SOATMUNDIAL.COM.CO/,
SECCIÓN RECURSOS DESCARGABLES, PARA VERIFICAR EN EL LISTADO
DE PUNTOS AUTORIZADOS DONDE PUEDE REALIZAR EL REEMPLAZO
DE LA PÓLIZA
Página 69 de 69
Download