MANUAL DE IMPLEMENTACI‡N VALIDACI‡N IDENTIFICACI‡N WSS

MANUAL%20DE%20IMPLEMENTACI%E2%80%A1N%20-%20VALIDACI%E2%80%A1N%20DE%20IDENTIFICACI%E2%80%A1N%20-%20WSS

User Manual:

Open the PDF directly: View PDF .
Page Count: 27

MANUAL DE IMPLEMENTACIÓN

WEB SERVICE

HISTORIA DE CRÉDITO

Historia de Crédito

Todas las referencias, ejemplos, ilustraciones y archivos adjuntos de este manual son de carácter didáctico, buscan facilitar el conocimiento y la

forma de implementar nuestros productos por parte de los suscriptores. Las tablas donde se señalan las equivalencias y los significados de ciertos

símbolos y siglas empleados en el mismo pueden ser actualizadas a lo largo de la vigencia del contrato, en respuesta a la evolución de los servicios

que préstamos. Los cambios materiales se darán a conocer a través de nuestra página web de manera oportuna.

La Compañía no asume responsabilidad por la manera en que el Suscriptor implemente el producto. El manual es solamente una herramienta de

ayuda.

CONTROL DE CAMBIOS

Fecha

Descripción del Cambio

Elaborado por

Aprobado por

03-01-2018

20-Oct-

2012

20-Oct-2012

Versión Inicial

ST&T

17-Ene-2014

Ajustes estructuras XSDs

ST&T

26-Feb-2014

Ajustes tabla de códigos de

respuesta

ST&T

18-Sep-2017

Adición nuevos códigos de

respuesta

Experian

20-Oct-2012

Versión Inicial

ST&T

17-Ene-2014

Ajustes estructuras XSDs

ST&T

26-Feb-2014

Ajustes tabla de códigos de

respuesta

ST&T

18-Sep-2017

Adición nuevos códigos de

respuesta

Experian

Creación de Documento ws con seguridad

Camilo Parra

Santiago Zapata

Historia de Crédito

DESCRIPCIÓN

El web service (WS) de la historia de crédito es un producto de DATACREDITO que permite obtener la información

suministrada por nuestra central a través del protocolo SOAP/HTTP.

OBJETIVOS

 Proveer información completa para facilitar el uso del WS.

 Mostrar el uso del WS a través de aplicaciones clientes implementadas en distintas plataformas.

 Mostrar la interpretación de los documentos XML utilizados en el WS.

FORMAS DE CONEXIÓN

El WS se puede acceder a través del protocolo SOAP.

El URL donde se encuentra publicado el WS es:

http://[host]:[port]/wss/dhws/services/DHService

Para consultar el WSDL (Web Service Description Language) del WS debe agregar la cadena ?wsdl al final del URL:

http://localhost:[port]/wss/dhws/services/DHService?wsdl

[host] es la maquina donde está instalado el WS y [port] el puerto por donde está atendiendo requerimiento.

Seguridad

El WS utiliza el estándar WS-I, por lo tanto, la seguridad esta implementado bajo WS-Security, el WS utiliza certificados

digitales tanto para el SSL(Point – to - Point) como para la firma del mensaje(Signature).

Para la autenticación, el WS utiliza UsernameToken, donde previamente se debe solicitar a Experian la generación de

un usuario y contraseña, para que esta sea enviada en la cabecera del mensaje.

Para poder realizar la firma del mensaje, se necesita como requisito principal tener el certificado de Experian que actúa

como servidor e incluirlo en el llavero (JKS o P12) junto al certificado de la entidad que solicita la conexión a Experian

(Cliente), se debe tener en cuenta que la petición generada debe tener las siguientes partes del mensaje firmadas:

Body

Namespace:

http://schemas.xmlsoap.org/soap/envelope/

Enconde: Content

UsernameToken

Namespace:

http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd

Encode: Element

Timestamp

Namespace:

http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd

Encode: Element

EL protocolo TLS soportado para la conexión es el TLS1.2, se recomienda utilizarlo por temas de seguridad.

Historia de Crédito

SERVICIOS

Servicio consultarHC

Permite obtener la información de las Personas Natural y Jurídica en formato XML.

Permite obtener la información de la historia de crédito en formato XML que incluye información de Ley de habeas Data.

Nombre del servicio consultarHC (5 Parámetros).Parámetros del servicio:

Parametro

Descripción

Tipo

Idsus

Es la identificación del suscriptor

String

Clasus

La clave del suscriptor

String

Tipoid

El tipo de identificación (Tabla 1)

String

Id

La identificación

String

Papellido

El primer apellido

String

La respuesta es un String que contiene un documento XML con la información de la historia de crédito de la identificación

consultada.

Servicio consultarHC para formularios

Permite obtener la información de la historia de crédito en formato XML que incluye información de Ley de habeas Data.

Dado un conjunto de variables adicionales.

Nombre del servicio consultarHC (6 Parámetros) Parámetros del servicio:

Parametro

Descripción

Tipo

Idsus

Es la identificación del suscriptor

String

Clasus

La clave del suscriptor

String

Tipoid

El tipo de identificación (Tabla 1)

String

Id

La identificación

String

Papellido

El primer apellido

String

Parametros

Parametro que contiene un documento XML con variables Socio

demográficas que van a ser utilizados por score a la medida para

generar un resultado.

String

La respuesta es un String que contiene un documento XML con la información de la historia de crédito de la identificación

consultada. El documento corresponde a un esquema (informe.xsd) contra el que se puede validar el documento recibido.

El parámetro Parametros es un String que debe corresponder a un xml, en el cual pueden venir tantos campos parametro

como se desee, ejemplo:

Historia de Crédito

<v1:parametros>

<v1:parametro>

<v1:nombre>T</v1:nombre>

<v1:tipo>00</v1:tipo>

<v1:valor>0005</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>N</v1:nombre>

<v1:tipo>01</v1:tipo>

<v1:valor>19701029</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>N</v1:nombre>

<v1:tipo>02</v1:tipo>

<v1:valor>3</v1:valor>

</v1:parametro>

</parametros>

Los parámetros deben estar configurados de la siguiente manera:

Para tipo el valor debe estar en Mayúscula e identifica el tipo del parámetro N (Numérico) y T (Texto). Para cada nombre el

valor debe ser de dos caracteres que corresponden al número consecutivo del campo socio demográfico (Ej. 00,01, 03, …,

99). Y en valor la información acordada entre el suscriptor y DataCrédito que corresponde al tipo y consecutivo del parámetro.

Ej.: El valor acordado para fechas podría ser el número correspondiente al formato AAAAMMDD.

Servicio consultarHC para Decisor+ 1.0

Permite obtener la información de la historia de crédito en formato XML que incluye información de Ley de habeas Data.

Dado un conjunto de variables propias y cumpliendo con estándar propio de Decisor+1.0.

Nombre del servicio consultarHC (6 Parámetros) Parámetros del servicio:

Parametro

Descripción

Tipo

Idsus

Es la identificación del suscriptor

String

Clasus

La clave del suscriptor

String

Tipoid

El tipo de identificación (Tabla 1)

String

Id

La identificación

String

Papellido

El primer apellido

String

Parametros

Parametro que contiene un documento XML con variables Socio

demográficas que van a ser utilizados por score a la medida para

generar un resultado.

String

La respuesta es un String que contiene un documento XML con la información de la historia de crédito de la identificación

consultada. El documento corresponde a un esquema (informe.xsd) contra el que se puede validar el documento recibido.

El parámetro parametros es un String que debe corresponder a un xml, en el cual deben venir los campos parametro de

acuerdo a la siguiente especificación:

Historia de Crédito

Para tipo el valor debe estar en Mayúscula e identifica el tipo del parámetro N (Numérico) y T (Texto). Para cada nombre el

valor debe corresponder al nombre de la variable propia especificada en Decisor + 1.0 para la estrategia a consumir, y el

primer parámetro debe usarse con el nombre del servicio de reglas o estrategia a consumir SERREG.

Ejemplo:

< v1:parametros>

<v1:parametro>

<v1:nombre>SERREG</v1:nombre>

<v1:tipo>T</v1:tipo>

<v1:valor>Vehiculos</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>Ingresos</v1:nombre>

<v1:tipo>N</v1:tipo>

<v1:valor>3000000</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>Edad</v1:nombre>

<v1:tipo>N</v1:tipo>

<v1:valor>30</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>Genero</v1:nombre>

<v1:tipo>N</v1:tipo>

<v1:valor>1</v1:valor>

</v1:parametro>

</v1:parametros>

Servicio consultarHC para Decisor+ 3.0

Permite obtener la información de la historia de crédito en formato XML que incluye información de Ley de habeas Data.

Utiliza estándar propio de variables de formulario, que permiten consultar una estrategia específica de Decisor+ 3.0.

Se utiliza el método consultarHC (de 6 Parámetros)

Parámetros del servicio:

Parametro

Descripción

Tipo

Idsus

Es la identificación del suscriptor

String

Clasus

La clave del suscriptor

String

Tipoid

El tipo de identificación (Tabla 1)

String

Id

La identificación

String

Papellido

El primer apellido

String

Parametros

Parametro que contiene un documento XML con variables Socio

demográficas que van a ser utilizados por score a la medida para

generar un resultado.

String

La respuesta es un String que contiene un documento XML con la información de la historia de crédito de la identificación

consultada. El documento corresponde a un esquema (informe.xsd) contra el que se puede validar el documento recibido.

Historia de Crédito

El parámetro parametros es un String que debe corresponder a un xml, en el cual deben venir los campos parametro de

acuerdo a la siguiente especificación para Decisor+ 3.0:

Para tipo el valor debe estar en Mayúscula e identifica el tipo del parámetro N (Numérico) y T (Texto). Para cada nombre el

valor debe corresponder al nombre de la variable propia especificada en Decisor + 3.0 para la estrategia a ejecutar, los dos

primeros parámetros son la clave dentro del consumo del web service para la ejecución de la estrategia particular:

Primer Parámetro es el identificador de la estrategia: STRAID, que es un número asignado por la herramienta al final del

proceso de Aprobación de la misma, y que debe ser solicitado a DataCrédito. Ej: 950. (Este no va a cambiar con el tiempo,

independiente del número de versiones que se pasen a producción.)

Segundo Parámetro de formulario, es el nombre de la estrategia: STRNAM, que es una cadena de caracteres en mayúsculas

y minúsculas con la que se nombra la estrategia en RMA. Ej: SuperSymmetry

El resto de los parámetros son los que componen valores adicionales que captura y envía la entidad que consume el web

service de Historia de Crédito, con nombre y valor.

Ejemplo:

<v1:parametros>

<v1:parametro>

<v1:nombre>STRAID</v1:nombre>

<v1:tipo>T</v1:tipo>

<v1:valor>950</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>STRNAM</v1:nombre>

<v1:tipo>T</v1:tipo>

<v1:valor>SuperSymmetry</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>Ingresos</v1:nombre>

<v1:tipo>N</v1:tipo>

<v1:valor>3000000</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>Edad</v1:nombre>

<v1:tipo>N</v1:tipo>

<v1:valor>30</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>Genero</v1:nombre>

<v1:tipo>T</v1:tipo>

<v1:valor>M</v1:valor>

</v1:parametro>

</ v1:parametros>

La respuesta obtenida del consumo del método consultar HC de 6 parámetros, es una cadena de caracteres que cumple con

el esquema xsd informe.xsd

La respuesta es una decisión, y en respuesta personalizada las variables de resultado con su respectivo valor de acuerdo a la

programación de la estrategia.

Historia de Crédito

Se mantiene el web service modificando solo los parámetros a consumir.

Descripción de los campos de respuesta

La respuesta es un String.

Ejemplo de petición

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:v1="http://ws.hc.dc.com/v1">

<soapenv:Body>

<v1:consultarHC>

<v1:idsus>_consultarHC_idsus875136078</v1:idsus>

<v1:clasus>_consultarHC_clasus-1506835124</v1:clasus>

<v1:tipoid>_consultarHC_tipoid173806650</v1:tipoid>

<v1:id>_consultarHC_id-822228421</v1:id>

<v1:papellido>_consultarHC_papellido1168090375</v1:papellido>

<v1:parametros>

<v1:parametro>

<v1:nombre>00</v1:nombre>

<v1:tipo>T</v1:tipo>

<v1:valor>0005</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>01</v1:nombre>

<v1:tipo>N</v1:tipo>

<v1:valor>19701029</v1:valor>

</v1:parametro>

<v1:parametro>

<v1:nombre>02</v1:nombre>

<v1:tipo>N</v1:tipo>

<v1:valor>3</v1:valor>

</v1:parametro>

</parametros>

</v1:consultarHC>

</soapenv:Body>

</soapenv:Envelope>

Ejemplo de Respuesta

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-

instance">

<soapenv:Body>

<ws:consultarHCResponse xmlns:ws="http://ws.hc.dc.com/v1">

<ws:consultarHCReturn>&amp;lt;?xml version="1.0" encoding="UTF-8"?>

&amp;lt;informe version="1.1" fechaConsulta="1518041951503"

respuesta="02" /></ws:consultarHCReturn>

</ws:consultarHCResponse>

</soapenv:Body>

</soapenv:Envelope>

EJEMPLOS

Consumo usando JAVA

El siguiente es un ejemplo de consumo del web service por https con firma digital Utilizando Apache CXF 2.7.18

y JDK 1.7_080

Se recomienda agregar el certificado de Experian en el Truestore

$JAVA_HOME/jre/lib/security/jssecacerts

Historia de Crédito

Pre-Requisitos

JDK 1.7+

Apache CXF 2.7+ (La versión trae implementado WSS4j)

Certificado digital de firma público del servidor

Certificado digital SSL público del servidor

Certificado del Cliente firmado por una Entidad certificante (CA)

Para generar los respectivos llaveros pueden hacerlo por el Keytool del JDK o utilizar OpenSSL.

package co.com.datacredito.services.serviciohistoriacredito.v1;

import java.util.HashMap;

import java.util.Map;

import javax.xml.namespace.QName;

import org.apache.cxf.configuration.jsse.TLSClientParameters;

import org.apache.cxf.frontend.ClientProxy;

import org.apache.cxf.interceptor.LoggingInInterceptor;

import org.apache.cxf.interceptor.LoggingOutInterceptor;

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;

import org.apache.cxf.transport.http.HTTPConduit;

import org.apache.cxf.ws.security.wss4j.WSS4JOutInterceptor;

import org.apache.ws.security.WSConstants;

import org.apache.ws.security.handler.WSHandlerConstants;

import co.com.datacredito.callbackhandler.SignaturePwdClientCallBackHandler;

/**

* This class was generated by Apache CXF 2.7.18

* 2018-02-07T15:41:10.805-05:00

* Generated source version: 2.7.18

*

*/

public final class HCService_ServicioHistoriaCreditoPortWanHttps_Client {

private HCService_ServicioHistoriaCreditoPortWanHttps_Client() {

}

public static void main(String[] args) throws Exception{

//Configuracion de certificados SSL POINT-TO-POINT

System.setProperty("javax.net.ssl.trustStore","C:\\workspace_mars_adaptadores_ws\\p

rueba\\src\\main\\resources\\dev-servicesesb.datacredito.com.co.jks");

System.setProperty("javax.net.ssl.trustStorePassword","experian");

Historia de Crédito

System.setProperty("javax.net.ssl.keyStore","C:\\workspace_mars_adaptadores_ws\\prueba\\s

rc\\main\\resources\\dev-servicesesb.datacredito.com.co.jks");

System.setProperty("javax.net.ssl.keyStorePassword","experian");

JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean();

factory.setAddress("https://10.54.16.8:443/wss/dhws/services/DHService");

factory.setServiceClass(HCService.class);

Object client = factory.create();

LoggingOutInterceptor loggingOutInterceptor = new LoggingOutInterceptor();

loggingOutInterceptor.setPrettyLogging(true);

ClientProxy.getClient(client).getOutInterceptors().add(loggingOutInterceptor);

LoggingInInterceptor loggingInInterceptor = new LoggingInInterceptor();

loggingInInterceptor.setPrettyLogging(true);

ClientProxy.getClient(client).getInInterceptors().add(loggingInInterceptor);

// //Propiedades de seguridad: UsernameToken + Timestamp + Signature

Map<String, Object> propsOut = new HashMap<String, Object>();

propsOut.put(WSHandlerConstants.USER, "1-86074566");

propsOut.put(WSHandlerConstants.ACTION, WSHandlerConstants.USERNAME_TOKEN+ "

"+WSHandlerConstants.TIMESTAMP +" "+ WSHandlerConstants.SIGNATURE );

propsOut.put(WSHandlerConstants.SIG_PROP_FILE, "crypto.properties");

propsOut.put(WSHandlerConstants.SIGNATURE_USER, "experian.sign");

propsOut.put(WSHandlerConstants.ADD_UT_ELEMENTS, WSConstants.NONCE_LN + " " +

WSConstants.CREATED_LN);

propsOut.put(WSHandlerConstants.MUST_UNDERSTAND,"false");

propsOut.put(WSHandlerConstants.SIGNATURE_PARTS,

"{Content}{http://schemas.xmlsoap.org/soap/envelope/}Body;{Element}{http://docs.oasis-

open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-

1.0.xsd}UsernameToken;{Element}{http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-

wssecurity-utility-1.0.xsd}Timestamp;");

propsOut.put(WSHandlerConstants.SIG_KEY_ID, "DirectReference");

propsOut.put(WSHandlerConstants.SIG_ALGO, "http://www.w3.org/2000/09/xmldsig#rsa-

sha1");

propsOut.put(WSHandlerConstants.PASSWORD_TYPE, WSConstants.PW_TEXT);

propsOut.put(WSHandlerConstants.PW_CALLBACK_CLASS,

SignaturePwdClientCallBackHandler.class.getName());

WSS4JOutInterceptor wss4jOut = new WSS4JOutInterceptor(propsOut);

ClientProxy.getClient(client).getOutInterceptors().add(wss4jOut);

/*https URL hostname does not match the Common Name (CN) on the server

certificate in the client's truststore. Make sure server certificate

is correct, or to disable this check (NOT recommended for production) set the CXF

client TLS configuration property "disableCNCheck" to true.*/

HTTPConduit httpConduit = (HTTPConduit)

ClientProxy.getClient(client).getConduit();

TLSClientParameters tlsCP = new TLSClientParameters();

tlsCP.setDisableCNCheck(true);

httpConduit.setTlsClientParameters(tlsCP);

Historia de Crédito

HCService port = (HCService) client;

{

System.out.println("Invoking consultarHC...");

java.lang.String _consultarHC_idsus = "_consultarHC_idsus875136078";

java.lang.String _consultarHC_clasus = "_consultarHC_clasus-1506835124";

java.lang.String _consultarHC_tipoid = "_consultarHC_tipoid173806650";

java.lang.String _consultarHC_id = "_consultarHC_id-822228421";

java.lang.String _consultarHC_papellido = "_consultarHC_papellido1168090375";

com.dc.hc.ws.v1.Parametros _consultarHC_parametros = new

com.dc.hc.ws.v1.Parametros();

java.util.List<com.dc.hc.ws.v1.Parametro> _consultarHC_parametrosParametro = new

java.util.ArrayList<com.dc.hc.ws.v1.Parametro>();

com.dc.hc.ws.v1.Parametro _consultarHC_parametrosParametroVal1 = new

com.dc.hc.ws.v1.Parametro();

_consultarHC_parametrosParametroVal1.setNombre("Nombre-1465891762");

_consultarHC_parametrosParametroVal1.setTipo("Tipo1582206806");

_consultarHC_parametrosParametroVal1.setValor("Valor1397300700");

_consultarHC_parametrosParametro.add(_consultarHC_parametrosParametroVal1);

_consultarHC_parametros.getParametro().addAll(_consultarHC_parametrosParametro);

try {

java.lang.String _consultarHC__return = port.consultarHC(_consultarHC_idsus,

_consultarHC_clasus, _consultarHC_tipoid, _consultarHC_id, _consultarHC_papellido,

_consultarHC_parametros);

System.out.println("consultarHC.result=" + _consultarHC__return);

} catch (HCBException e) {

System.out.println("Expected exception: HCBException has occurred.");

System.out.println(e.toString());

}

}

System.exit(0);

}

}

Historia de Crédito

TERMINOS Y TABLAS

TABLA 1. Tipos de Identificación

1

C.C. Cédula de ciudadanía

2

NIT Número de identificación tributaria

3

N.E. Nit de extranjería

4

C.E. Cédula de Extranjería

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 2. Vigencia de Cédula

CODIGO DE ESTADO

DESCRIPCION

00

VIGENTE

12

SUSPENDIDA

21

FALLECIDO

29

CANCELADA

< 30 Y DIFERENTES DE LOS ANTERIORES

CANCELADA

>=30 y < 60

NO EXPEDIDA

>=60 y < 99

INDEFINIDO

99

EN TRAMITE

ESPACIOS EN BLANCO CUANDO NO SE CONOCE

Nota: Los estados corresponden a la información disponible en la base de datos de DataCrédito de acuerdo a la

última fecha de actualización recibida de la fuente oficial. Esta tabla está sujeta a modificaciones para ampliar la

definición

TABLA 3. Tipos de Cuenta

CCB

Cuentas corrientes Bancarias

TDC

Tarjeta de crédito

CBR

Cartera Bancaria Rotativa

CAU

Cartera Automotriz

CAB

Cartera Bancaria

CAC

Cartera Cooperativas de ahorro y crédito

Historia de Crédito

COF

Cartera corporaciones financieras

CFE

Cartera fondo de empleados

CVE

Cartera vestuario

CLB

Cartera editorial

COC

Cartera otros créditos

CTU

Cartera turismo

CAV

Cartera de ahorro y vivienda

CCL

Cartera de compañías de Leasing

CCC

Cartera de crédito de construcción

CFR

Cartera Finca Raíz

EST

Estatal

CCF

Cartera compañías de financiamiento comercial

CMU

Cartera Muebles

CCS

Cartera Compañías de Seguros

CBM

Créditos Bajo Monto

CEL.

Cartera de Electrodomésticos

CTC

Cartera de telefonía celular

CDC

Cartera de comunicaciones

DIC

Departamento de información comercial

CDB

Corredores de Bolsa

CSP

Empresas de Servicios Públicos

AGR

Cartera Agroindustrial

ALI

Cartera de Alimentos

CMZ

Cartera Comercializadoras

CSA

Carteras caja de compensación y salud

COM

Cartera Computadores

FER

Cartera Ferreterías

FUN

Cartera Fundaciones

GRM

Cartera Gremios

Historia de Crédito

IND

Cartera Industrial

LAB

Cartera Laboratorios

LBZ

Cartera Libranza

SEG

Cartera Seguridad

TRT

Cartera Transporte

EDU

Cartera Educación

SFI

Servicios Financieros

CAU

Cartera Automotriz

CON

Créditos de consumo

APD

Almacén por departamentos

AHO

Cuentas de ahorro y bancarias

CAS

Para el elemento consulta, sí tiene tipo de cuenta CAS quiere decir que fue consultado por el Centro de Atención y

Servicio.

SBG

Cartera de Sobregiro

MCR

Cartera Microcrédito

PCS

Créditos de bajo monto (código temporal, el definitivo es CBM)

MSJ

Libranza (código temporal, el definitivo es LBZ)

CAF

Estatal (código temporal, el definitivo es EST)

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 4. Códigos de Estados Tarjeta /Cartera

Código

Nombre

Comporta

miento

Vigente/

Cerrada

Descripción

01

AL DIA

N

Vigente

Este código de novedad se aplica a todas aquellas obligaciones que

se encontraban al día en el momento de extractar la información que

fue enviada a DataCrédito(fecha de corte).

02

T. NO ENTREGADA

N

Cerrada

Cuando una tarjeta no ha sido entregada por el banco o no ha sido

reclamada por el usuario.

03

CANCEL. MM

Cerrada

Cuando el cliente hace mal uso de la tarjeta y el suscriptor toma la

decisión de cancelarla.

04

T. ROBADA

N

Cerrada

Cuando el usuario de la tarjeta de crédito reporta a la entidad

emisora, que el plástico ha sido robado.

Historia de Crédito

05

CANCELADA VOL

N

Cerrada

Cuando el cliente cancela por voluntad propia el derecho a usar la

tarjeta.

06

CANCELADA MX

Cerrada

Cuando la tarjeta fue retirada del archivo maestro del suscriptor, sin

especificar el motivo. Adicionalmente muestra la mora máxima en

que incurrió la obligación.

07

T. EXTRAVIADA.

Cerrada

Cuando el usuario de la tarjeta de crédito reporta a la entidad

emisora que el plástico se ha extraviado.

08

PAGO VOL

N

Cerrada

Pago total de la Deuda (cancelación final de la obligación). Esta

novedad se presenta cuando la obligación ha llegado a su final su

saldo es igual a cero y no presenta ninguna mora en el vector de

comportamiento.

09

PAGO VOL MX 30

N

Cerrada

Pago total de la Deuda (cancelación final de la obligación). Esta

novedad se presenta cuando la obligación ha llegado a su final, su

saldo es igual a cero y en el vector de comportamiento presenta

una mora máxima de 30 días.

10

PAGO VOL MX 60

N

Cerrada

Pago total de la Deuda (cancelación final de la obligación). Esta

novedad se presenta cuando la obligación ha llegado a su final, su

saldo es igual a cero y en el vector de comportamiento presenta

una mora máxima de 60 días

11

PAGO VOL MX 90

N

Cerrada

Pago total de la Deuda (cancelación final de la obligación).. Esta

novedad se presenta cuando la obligación ha llegado a su final, su

saldo es igual a cero y en el vector de comportamiento presenta

una mora máxima de 90 días

12

PAGO VOL MX 120

N

Cerrada

Pago total de la Deuda (cancelación final de la obligación).. Esta

novedad se presenta cuando la obligación ha llegado a su final, su

saldo es igual a cero y en el vector de comportamiento presenta

una mora máxima de 120 días

13

AL DIA MORA 30

N

Vigente

En el vector de comportamiento presenta una mora máxima de 30 y

actualmente se encuentra al día.

14

AL DIA MORA 60

N

Vigente

En el vector de comportamiento presenta una mora máxima de 60 y

actualmente se encuentra al día.

15

AL DIA MORA 90

N

Vigente

En el vector de comportamiento presenta una mora máxima de 90 y

actualmente se encuentra al día.

16

AL DIA MORA 120

N

Vigente

En el vector de comportamiento presenta una mora máxima de 120

y actualmente se encuentra al día..

17

ESTA EN MORA 30

1

Vigente

La obligación se encuentra morosa entre 30 y 59 días.

18

ESTA EN MORA 60

2

Vigente

La obligación se encuentra morosa entre 60 y 89 días.

19

ESTA EN MORA 90

3

Vigente

La obligación se encuentra morosa entre 90 y 119 días.

20

ESTA EN MORA 120

4

Vigente

La obligación se encuentra morosa entre 120 días o más .

21

FM 60 ESTA M 30

1

Vigente

La obligación presenta en el vector de comportamiento una mora

máxima de 60 días y actualmente está en mora de 30 días. Fue

mora 60 y pasó a mora 30.

Historia de Crédito

22

FM 90 ESTA M 30

1

Vigente

La obligación presenta en el vector de comportamiento una mora

máxima de 90 días y actualmente está en mora de 30 días. Fue

mora 90 y pasó a mora 30. Fue mora 90 y pasó a mora 30.

23

FM 90 ESTA M 60

2

Vigente

La obligación presenta en el vector de comportamiento una mora

máxima de 90 días y actualmente está en mora de 60 días. Fue

mora 90 y pasó a mora 60

24

FM 120 ESTA M 30

1

Vigente

La obligación presenta en el vector de comportamiento una mora

máxima de 120 días y actualmente está en mora de 30 días. Fue

mora 120 y pasó a mora 30

25

FM 120 ESTA M 60

2

Vigente

La obligación presenta en el vector de comportamiento una mora

máxima de 120 días y actualmente está en mora de 60 días. Fue

mora 120 y pasó a mora 60.

26

FM 120 ESTA M 90

3

Vigente

La obligación presenta en el vector de comportamiento una mora

máxima de 120 días y actualmente está en mora de 90 días. Fue

mora 120 y pasó a mora 90.

27

RM 30 ESTA M 60

2

Vigente

La obligación presenta reincidencia en mora 30 y actualmente se

encuentra en mora 60.

28

RM 30 ESTA M 90

3

Vigente

La obligación presenta reincidencia en mora 30 y actualmente se

encuentra en mora 90.

29

RM 30 ESTA M 120

4

Vigente

La obligación presenta reincidencia en mora 30 y actualmente se

encuentra en mora 120.

30

RM 60 ESTA M 30

1

Vigente

La obligación presenta reincidencia en mora 60 y actualmente se

encuentra en mora 30.

31

RM 60 ESTA M 60

2

Vigente

La obligación presenta reincidencia en mora 60 y actualmente se

encuentra en mora 60.

32

RM 60 ESTA M 90

3

Vigente

La obligación presenta reincidencia en mora 60 y actualmente se

encuentra en mora 90.

33

RM 60 ESTA M 120

4

Vigente

La obligación presenta reincidencia en mora 60 y actualmente se

encuentra en mora 120.

34

RM 90 ESTA M 30

1

Vigente

La obligación presenta reincidencia en mora 90 y actualmente se

encuentra en mora 30.

35

RM 90 ESTA M 60

2

Vigente

La obligación presenta reincidencia en mora 90 y actualmente se

encuentra en mora 60.

36

RM 90 ESTA M 90

3

Vigente

La obligación presenta reincidencia en mora 90 y actualmente se

encuentra en mora 90.

37

RM 90 ESTA M 120

4

Vigente

La obligación presenta reincidencia en mora 90 y actualmente se

encuentra en mora 120.

38

RM 120 ESTA M 30

1

Vigente

La obligación presenta reincidencia en mora 120 y actualmente se

encuentra en mora 30.

39

RM 120 ESTA M 60

2

Vigente

La obligación presenta reincidencia en mora 120 y actualmente se

encuentra en mora 60.

Historia de Crédito

40

RM 120 ESTA M 90

3

Vigente

La obligación presenta reincidencia en mora 120 y actualmente se

encuentra en mora 90.

41

RM 120 ESTA M 120

4

Vigente

La obligación presenta reincidencia en mora 120 y actualmente se

encuentra en mora 120.

45

CART. CASTIGADA

C

Vigente

La entidad que reporta la obligación considera que la deuda en la

actualidad es incobrable

46

CART. RECUPERADA

D

Cerrada

Cuando la cancelación final de la deuda se logró por vías anormales

como cobro judicial, embargo, arreglo entre deudor y acreedor, etc.

Normalmente se trata de deudas que han pasado por dudoso

recaudo o cartera castigada.

47

DUDOSO RECAUDO

D

Vigente

Cuando a juicio de la entidad, el tiempo de morosidad de la deuda

pasó a ser considerada una deuda cuya probabilidad de recaudo es

totalmente dudosa.

49

TARJETA NO

RENOVADA

N

Cerrada

Cuando la entidad emisora de la tarjeta decide no renovarla para un

próximo periodo.

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 5. Comportamiento.

El comportamiento indica cómo ha sido el pago de las obligaciones del consultado durante los últimos dos años,

en el primer campo de izquierda a derecha, se encuentra el comportamiento del mes anterior a la fecha de la

última novedad.

N

Al día

1

Mora de 30 días

2

Mora de 60 días

3

Mora de 90 días

4

Mora de 120 días

5

Mora de 150 días

6

Mora de 180 días

-

No existe información disponible para este mes en específico

Espacio en blanco. No existe información disponible para este mes en específico

D

Dudoso recaudo (Solo se presenta cuando la consulta se hace con formato nuevo “M”).

C

Cartera castigada (Solo se presenta cuando la consulta se hace con formato nuevo “M”).

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

Historia de Crédito

TABLA 6. Códigos de Garante.

Código

Descripción Cartera

Descripción Tarjeta

00

Deudor Principal

Deudor Principal

01

Codeudor.

Amparada

02

Codeudor.

Amparada

03

Codeudor.

Amparada

04

Avalista.

Amparada

05

Deudor solidario.

Amparada

06

Coarrendatario.

Amparada

07

Otros Garantes.

Amparada

08

Fiador.

Amparada

09-95

No Aplica

Amparada

96

Cotitular

Cotitular

97

Comunal (solo para cuentas Microcredito-MCR)

Amparada

98-99

No Aplica

Amparada

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 7. Modalidad de Pago

0

No informó

M

Mensual

B

Bimensual

T

Trimestral

S

Semestral

A

Anual

V

Al vencimiento

O

Otro

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 8. Adjetivos

42

No Localizado

43

Cuenta en cobrador

Historia de Crédito

44

Fallecido

60

Línea suspendida

61

Incapacidad total ó permanente

62

Cobro pre-jurídico

63

Cobro jurídico

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 9. Tipo de Crédito

CMR

Comerciales

CNS

Consumo

HIP

Hipotecario

MIC

Microcrédito

TABLA 10. Tipo de Moneda

ML

Moneda legal

ME

Moneda Extranjera

TABLA 11. Tabla de garantías hábito de pago obligaciones vigentes

OTRAS

Son las garantías personales (Ej. Cheque personal, pagaré, etc.)

ADMIS

Admisibles, son las que cumplen las condiciones del artículo 30 y 40 del decreto 2360/93.

Tales como:

Que la garantía constituida tenga un valor establecido con base en criterios técnicos y

objetivos que sean suficientes para cubrir el monto de la obligación, y

Que la garantía ofrezca un respaldo jurídicamente eficaz, al pago de la obligación, (Ej.

Hipoteca, letra, pignoración)

TABLA 13. Códigos de consultas

01

Código de suscriptor no existe.

02

Clave errada

Historia de Crédito

03

Numero de terminal no existe

04

Tipo de documento errado

05

Numero de documento errado

06

Primer apellido errado

07

Fin-consulta tipo 2

08

Fin-consulta tipo 4

09

Fin-consulta tipo 7. NO existe este número de identificación en los archivos de validación de la base de datos.

10

Fin-consulta tipo 6. El apellido NO coincide con el registrado en la Registraduría Nacional del Estado Civil.

11

Terminal desactivada

12

Clave de consulta bloqueada

13

Fin-consulta tipo 1. La consulta fue efectiva.

14

Fin-consulta tipo 5. El apellido digitado si coincide con el registrado en la base de datos para ese número de

cédula, pero la persona NO tiene información comercial en la base de datos de DataCrédito.

15

Ingreso correcto

16

Su prepago ya está agotado

17

Clave vencida

18

Clave no habilitada

19

Modalidad de prepagos bloqueada

20

Modalidad de prepagos aún no habilitada

21

Su prepago ya fue vencido

23

No se pudo realizar la consulta, vuelva a intentar

24

Clave de Dcifra sin tabla

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 14. Calificaciones

La calificación corresponde a la obtenida por la entidad aplicando la normatividad vigente expedida por la

Superintendencia Financiera

CALIFICACIÓN

A

Historia de Crédito

B

C

D

E

N

+

TABLA 16. Estados de Cuentas corrientes y de ahorros

01

Activa

Vigente

02

Cancelada Mal manejo

Cerrada

05

Saldada

Cerrada

06

Embargada

Vigente

07

Embargada-Activa

Vigente

09

Inactiva

Cerrada

TABLA 17. Tipo de Obligación en cartera

0

No se encuentra información en este campo

1

Comerciales

2

Consumo

3

Hipotecario

4

Otro

5

Microcrédito

6

Libranza

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 18. Forma de pago total de cartera

0

Vigente

Historia de Crédito

1

Pago Voluntario

2

Proceso ejecutivo

3

Mandamiento de Pago

4

Reestructuración

5

Dación en pago

6

Cesión

7

Donación

8

Insoluta

9

Prescrita

TABLA 19. Tipo de Score

01

Predicta

02

Dcifra

04

Acierta

05

Por definir

06

Por definir

07

1nicia

08

Acierta M

09

Por definir

10

Score a la medida

41

Acierta A vehículo e hipotecario línea

45

Acierta A cooperativas línea

47

Acierta A financiero línea

48

Acierta A tarjeta de crédito línea

49

Acierta A telecomunicaciones línea

67

Acierta+

95

Acierta A instalamentos línea

Historia de Crédito

TABLA 20. Estado civil y género según

Registraduría Nacional del Estado Civil

1

Casada

Mujer

2

Viuda

Mujer

3

Mujer

Mujer

4

Hombre

Hombre

TABLA 21. Rango de Edad

1

18 a 21 años

2

22 a 28 años

3

29 a 35 años

4

36 a 45 años

5

46 a 55 años

6

56 a 65 años

7

66 años o más

TABLA 23. Razón de la consulta

00

Razón desconocida

01

Solicitud de producto

02

Revisión del portafolio por parte de la Entidad

03

Revisión del portafolio por parte del ciudadano

04

Solicitud de producto

05

Consulta del ciudadano por Internet

06

Consulta del ciudadano por CAS Virtual

07

Por definir

08

Por definir

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

E1

Modelo Stability

E2

Modelo Never Pay

E6

Pronostico

E3

Acierta 360 Línea

A3

Acierta Microcrédito solo Buró

A4

Acierta Microcrédito Cliente y Buró

A8

Otorga

E7

Predicta PJ

P4

Affordability

Q1

TrendView

Historia de Crédito

TABLA 24. Tipos de comentario

01

Comentario al Informe

02

Comentario de Tutela

03

Reclamo de Habito de Pago

04

Reclamo de Endeudamiento Global

05

Reclamo a Información de Identificación

06

Estado Ley 917 (Si en el texto del comentario viene la

palabra positivo quiere decir que la historia tiene un

reporte positivo de lo contrario negativo).

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 25. Tipos de reclamo

02

Actualizar información

03

Rectificar la información

04

Conocer la información

05

Otros

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 26. Estados de un reclamo

1

Colocado

2

Modificado

3

Aplicado

4

Devuelto

Nota: Esta tabla está sujeta a modificaciones para ampliar la definición

TABLA 28. Códigos de Alerta

Código

Fuente

Tipo

Descripción

990003**

001

El documento de identidad fue extraviado

990003**

002

El documento de identidad fue robado

990003**

003

Actualmente reside fuera de Colombia

990003**

004

Ha sido objeto de varios intentos de suplantación de identidad

990001*

004

La cedula tiene historia de crédito como Nit

Historia de Crédito

990001*

004

El cliente tiene actividad registrada como titular con establecimiento de comercio

990001*

006

Sin información en archivo de extranjeros

990001*

007

El apellido con el que se vuelve a consultar es diferente

990001

008

El cliente NO tiene actividad registrada como titular con establecimiento de comercio

990001

009

Si se está solicitando un microcrédito, sus deudas registradas llegan al tope máximo, decreto 919/2008

990001

010

El registro consultado ha presentado 3 nuevas direcciones en el último año

990001

011

El registro consultado ha presentado moras de más de 60 días o más en los últimos 6 meses

990001

012

Más de 3 consultas de diferentes entidades en los últimos 60 días

990001

999

Sin alertas en el grupo de servicio

990001

999

Sin alertas en el grupo Buro

990001

999

Sin alertas en el grupo demandas judiciales

990001

999

Sin alertas en el grupo verticales

000003

301

Coincidencia por nombre e identificación en lista .. al …….

000003

302

Coincidencia solo por identificación en lista .. al …….

000003

303

Coincidencia solo por nombre lista .. al …….

000003

304

No se encuentra coincidencia con listas .. al …….

000004

201

Coincidencia por nombre e identificación en lista .. al …….

000004

202

Coincidencia solo por identificación en lista .. al …….

000004

203

Coincidencia solo por nombre lista .. al …….

000002

101

Tiene ……. demandas cerradas y ……. abiertas la abierta mas reciente se instauro el …….

000002

102

Tiene …….embargos cerrados y …….abiertos el abierto mas reciente se coloco el …….

TABLA 28.1 Códigos de Fuente de Alerta

Código de

Fuente

Detalle

990001

Fuente Interna DataCrédito

990003

Fuente Externa El Ciudadano

000001

Fuente externa otras

000002

C.S. de la J

000003

Listas Restrictivas

Historia de Crédito

000004

P.E.P

TABLA 29. Situación del Titular

0

Normal

1

Concordato

2

Liquidación Forzosa

3

Liquidación Voluntaria

4

Proceso de Reorganización

5

Ley 550

6

Ley 1116

7

Otra

8

Liquidación Patrimonial

TABLA 30. Tipo de Contrato de la Obligación

1

Termino Definido

2

Término Indefinido

TABLA 31. Estado de Origen

0

Normal. Creación por apertura.

1

Reestructurada

2

Refinanciada

3

Transferida de otro producto

4

Comprada

TABLA 32. Códigos productos valores

62

Quanto o Quanto-V3

Historia de Crédito

TABLA 33. Tipo de Leyenda

TABLA 34. Tipo de estado de cuenta

1

Reclamo en Trámite

2

Reclamo en Discusión Judicial

3

Suplantación de Identidad

4

Investigación en Trámite o Actuación Administrativa

5

Reclamo en Trámite, Investigación en Trámite o Actuación Administrativa

6

Reclamo en Trámite, Suplantación de Identidad

7

Reclamo en Trámite, Investigación en Trámite o Actuación Administrativa,

Suplantación de Identidad

8

Investigación en Trámite o Actuación Administrativa, Suplantación de Identidad

9

Discusión Judicial, Investigación en Trámite o Actuación Administrativa

A

Discusión Judicial, Suplantación de Identidad

B

Discusión Judicial, Investigación en Trámite o Actuación Administrativa,

Suplantación de Identidad

(Sin Valor)

CV

Cancelada por Venta

CS

Cancelada por Siniestro