Respuesta / Buró de Crédito - Persona física

Edited

Json de respuesta

{
  "consultasEfectuadas": [
    {
      "claveOtorgante": "AAAAAAAAAA",
      "claveUnidadMonetaria": "MX",
      "consumidorNuevo": "Y",
      "fechaConsulta": "2015-11-23",
      "identificacionBuro": "0",
      "importeContrato": 20000,
      "indicadorTipoResponsabilidad": "I",
      "nombreOtorgante": "BANCO",
      "telefonoOtorgante": "9999999999",
      "tipoContrato": "PL"
    }
  ],
  "cuentas": [
    {
      "claveObservacion": "CA",
      "claveOtorgante": "MX",
      "claveUnidadMonetaria": "MX",
      "creditoMaximo": 25918,
      "fechaActualizacion": "2015-11-11",
      "fechaAperturaCAN": "2021-08-10",
      "fechaAperturaCuenta": "2011-05-16",
      "fechaCancelacionCAN": "2021-08-10",
      "fechaCierreCuenta": "2021-08-10",
      "fechaHistoricaMorosidadMasGrave": "2021-08-10",
      "fechaInicioReestructura": "2021-08-10",
      "fechaMasAntiguaHistoricoCAN": "2021-08-10",
      "fechaMasAntiguaHistoricoPagos": "2011-09-30",
      "fechaMasRecienteHistoricoCAN": "2021-08-10",
      "fechaMasRecienteHistoricoPagos": "2015-09-30",
      "fechaReporte": "2015-10-31",
      "fechaUltimaCompra": "2011-05-16",
      "fechaUltimoPago": "2015-10-07",
      "formaPagoActual": "01",
      "frecuenciaPagos": "M",
      "garantia": "GARANTIA 1234",
      "historicoCAN": "1111111222222------11111",
      "historicoPagos": "1XXXXXXXXXXXXXXXXXXXXXXX",
      "identificadorCAN": "123312",
      "identificadorDeCredito": "Y12345",
      "identificadorSociedadInformacionCrediticia": "0",
      "importeSaldoMorosidadHistMasGrave": 12345,
      "indicadorTipoResponsabilidad": "I",
      "limiteCredito": 5000000,
      "modoReportar": "A",
      "montoPagar": 720,
      "montoUltimoPago": "12345",
      "mopHistoricoMorosidadMasGrave": "02",
      "nombreOtorgante": "GUBERNAMENTALES",
      "numeroCuentaActual": "123456",
      "numeroPagos": 36,
      "numeroPagosVencidos": 642,
      "numeroTelefonoOtorgante": "5556581111",
      "registroImpugnado": "00",
      "saldoActual": 6791,
      "saldoVencido": 0,
      "tipoContrato": "PL",
      "tipoCuenta": "I",
      "totalPagosCalificadosMOP2": 1232,
      "totalPagosCalificadosMOP3": 12312,
      "totalPagosCalificadosMOP4": 3231,
      "totalPagosCalificadosMOP5": 1231,
      "totalPagosReportados": 232,
      "ultimaFechaSaldoCero": "2021-08-10",
      "valorActivoValuacion": "2312"
    }
  ],
  "declaracionesCliente": {
    "declaracionConsumidor": "ESTA ES UNA DECLARATIVA DE PRUEBA##CREDITO01POR CADA CREDITO EL CONSUMIDOR PUEDE MANIFESTAR SU INCONFORMIDAD##CREDITO02 CADA DECLARATIVA PUEDE CONTENER HASTA MIL PALABRAS##CREDITO03LAS DECLARATIVAS SE DESPLEGARAN DE ACUERDO CON LA SECUENCIA DE LOS CREDITOS EN EL REPORTE DE CREDITO"
  },
  "domicilios": [
    {
      "CP": "78430",
      "ciudad": "Ciudad",
      "coloniaPoblacion": "Colonia",
      "delegacionMunicipio": "SOLEDAD",
      "direccion1": "JOSE DEL BARRO 123",
      "direccion2": "DIR 2",
      "estado": "SLP",
      "extension": "55",
      "fax": "9999999999",
      "fechaReporteDireccion": "2008-08-22",
      "fechaResidencia": "2021-08-10",
      "indicadorEspecialDomicilio": "K",
      "numeroTelefono": "4448147417",
      "origenDelDomicilio": "MX",
      "tipoDomicilio": "C"
    }
  ],
  "empleos": [
    {
      "CP": "06500",
      "baseSalarial": "M",
      "cargo": "AUX",
      "ciudad": "CIUDAD",
      "claveMonedaSalario": "N
quot;, "coloniaPoblacion": "COLONIA", "delegacionMunicipio": "MUNICIPIO", "direccion1": "DIRECCION 1 DE EMPLEO", "direccion2": "COMPLEMENTO DIRECCIÓN EMPLEO", "estado": "CDMX", "extension": "55", "fax": "9999999999", "fechaContratacion": "2010-06-01", "fechaReportoEmpleo": "2014-10-01", "fechaUltimoDiaEmpleo": "2021-08-10", "fechaVerificacion": "2021-08-10", "modoVerificacion": "A", "nombreEmpresa": "REAL DE KIBAN, SA DE CV", "numeroEmpleado": "14806012887", "numeroTelefono": "4448184444", "origenRazonSocial": "MX", "salario": "3600" } ], "encabezado": { "claveOtorgante": "AAAAAAAAAA", "clavePais": "MX", "claveRetornoConsumidorPrincipal": "1", "numeroControlConsulta": 1, "numeroReferenciaOperador": "NUMERO_REFERENCIAOPERADOR", "version": "14" }, "hawkAlertBD": [ { "codigoClave": "513", "fechaReporte": "2021-08-10", "mensaje": "SERV. PUB. SANC.", "tipoInstitucion": "006" } ], "hawkAlertConsulta": [ { "codigoClave": "500", "fechaReporte": "2021-08-10", "mensaje": "DATOS GENERALES - COINCIDENCIA POR NOMBRE", "tipoInstitucion": "OFAC" } ], "historicoSaldos": [ { "creditoMaximo": 600000, "fechaMaximaMorosidad": "2021-08-10", "fechaReporte": "2021-08-10", "fechaUltimaCompra": "2020-08-31", "fechaUltimoPago": "2020-08-04", "limiteCredito": 350000, "montoAPagar": 500000, "montoMáximoMorosidad": 500000, "montoUltimoPago": 15000, "mopMaximaMorosidad": "09", "saldoActual": 400000, "saldoInsoluto": 400000, "saldoVencido": 500000, "ultimaVezSaldoCero": "2018-08-01" } ], "nombre": { "RFC": "RAOA810308IWA", "apellidoAdicional": "App Addiocional", "apellidoMaterno": "App Matero", "apellidoPaterno": "App Pater", "clavePais": "MX", "curp": "PAOP601007HSPNCN00", "edadesDependientes": "0135", "estadoCivil": "M", "fechaDefuncion": "2021-08-10", "fechaNacimiento": "1960-10-07", "fechaRecepcionInformacionDependientes": "2021-08-10", "nacionalidad": "MX", "numeroCedulaProfesional": "123456789", "numeroDependientes": "02", "numeroLicenciaConducir": "123456789", "numeroRegistroElectoral": "00000000537846", "prefijo": "SR", "primerNombre": "FICTICIO", "residencia": "1", "segundoNombre": "UNO", "sexo": "M", "sufijo": "JR" }, "resumenReporte": [ { "cuentasCerradas": 5, "cuentasClavesHistoriaNegativa": 2, "cuentasDisputa": 0, "cuentasNegativasActuales": 1, "cuentasPagosFijosHipotecas": 8, "cuentasRevolventesAbiertas": 1, "existenciaDeclaracionesConsumidor": "N", "fechaAperturaCuentaMRDespachoCobranza": "2021-08-10", "fechaAperturaCuentaMasAntigua": "2002-10-10", "fechaAperturaCuentaMasReciente": "2015-06-17", "fechaIngresoBD": "1995-12-05", "fechaSolicitudMasRecienteDespachoCobranza": "2021-08-10", "fechaSolicitudReporteMasReciente": "2015-10-29", "mensajesAlerta": "NNNNNN", "nuevaDireccionReportadaUltimos60Dias": "N", "numeroCuentas": 9, "numeroMOP0": "00", "numeroMOP1": "08", "numeroMOP2": "00", "numeroMOP3": "00", "numeroMOP4": "00", "numeroMOP5": "00", "numeroMOP6": "00", "numeroMOP7": "00", "numeroMOP96": "01", "numeroMOP97": "00", "numeroMOP99": "00", "numeroMOPUR": "00", "numeroSolicitudesUltimos6Meses": 12, "numeroTotalCuentasDespachoCobranza": 0, "numeroTotalSolicitudesDespachosCobranza": 0, "pctLimiteCreditoUtilizadoRevolventes": 0, "tipoMoneda": "MX", "totalCreditosMaximosPagosFijos": 45398, "totalCreditosMaximosRevolventes": 719, "totalLimitesCreditoRevolventes": 45000, "totalPagosPagosFijos": 2066, "totalPagosRevolventes": 0, "totalSaldosActualesPagosFijos": 10374, "totalSaldosActualesRevolventes": 0, "totalSaldosVencidosPagosFijos": 2816, "totalSaldosVencidosRevolventes": 0, "totalSolicitudesReporte": 13 } ], "scoreBuroCredito": [ { "codigoRazon1": "132", "codigoRazon2": "132", "codigoRazon3": "132", "codigoScore": "007", "nombreScore": "BC SCORE", "valorScore": 8982 }, { "codigoError": "02", "nombreScore": "BC SCORE" } ] }

Definición

Descripción de cada uno de los segmentos y campos a enviar a BC

Segmento Encabezado (encabezado)

Sección que contiene los datos de control de la consulta a BC.

  • version

    • Definición: Indica la versión de Buró de Crédito utilizada.

    • Tipo: Texto.

    • Longitud: 2 caracteres.

  • numeroReferenciaOperador

    • Definición: Se devuelve el valor de numeroReferenciaOperador enviado en la consulta.

    • Tipo: Texto.

    • Longitud: 25 caracteres.

  • clavePais

    • Definición: Clave del país donde se realizó la consulta, por defecto es MX.

    • Tipo: Texto.

    • Longitud: 2 caracteres.

  • claveOtorgante

    • Definición: Clave del usuario o member code de quien realizó la consulta.

    • Tipo: Texto.

    • Longitud: 10 caracteres.

  • claveRetornoConsumidorPrincipal

    • Definición: Indica si la persona fue encontrada.

    • Tipo: Catálogo con los siguientes valores:

      • 1 - Encontrado

      • 0 - No encontrado

    • Longitud: 1 caracter.

Segmento Nombre (nombre)

Sección que contiene los datos de la persona a consultar en Buró de Crédito.

  • apellidoPaterno

    • Definición: Indica el apellido paterno de la persona.

    • Tipo: Texto.

    • Longitud: 26 caracteres.

  • apellidoMaterno

    • Definición: Indica el apellido materno de la persona.

    • Tipo: Texto.

    • Longitud: 26 caracteres.

  • apellidoAdicional

    • Definición: Indica un apellido adicional, en caso de tenerlo, de la persona.

    • Tipo: Texto.

    • Longitud: 26 caracteres.

  • primerNombre

    • Definición: Indica el nombre de la persona.

    • Tipo: Texto.

    • Longitud: 26 caracteres.

  • segundoNombre

    • Definición: Indica un segundo nombre, en caso de tenerlo, de la persona.

    • Tipo: Texto.

    • Longitud: 26 caracteres.

  • fechaNacimiento

    • Definición: Indica la fecha de nacimiento con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres.

  • RFC

    • Definición: Indica el RFC de la persona consultada; puede ir con o sin homoclave.

    • Tipo: Texto.

    • Longitud: 10-13 caracteres.

  • prefijo

    • Definición: Indica el prefijo personal o profesional.

    • Tipo: Catálogo de prefijos.

    • Longitud: 4 caracteres.

  • sufijo

    • Definición: Indica el sufijo personal del cliente.

    • Tipo: Catálogo de Sufijos.

    • Longitud: 4 caracteres.

  • nacionalidad

  • residencia

  • numeroLicenciaConducir

    • Definición: Número de licencia de conducir.

    • Tipo: Texto.

    • Longitud: 20 caracteres.

  • estadoCivil

  • sexo

  • numeroCedulaProfesional

    • Definición: Indica el número de cédula profesional del cliente.

    • Tipo: Texto.

    • Longitud: 20 caracteres.

  • numeroRegistroElectoral

    • Definición: Indica el número de identificación INE.

    • Tipo: Texto.

    • Longitud: 20 caracteres.

  • curp

    • Definición: Indica el CURP del cliente.

    • Tipo: Texto.

    • Longitud: 20 caracteres.

  • clavePais

    • Definición: Indica la clave del país de ciudadanía del dliente.

    • Tipo: Catálogo de países.

    • Longitud: 2 caracteres.

  • numeroDependientes

    • Definición: Indica el número de personas que dependen económicamente del dliente.

    • Tipo: Numérico.

    • Longitud: 2 caracteres.

  • edadesDependientes

    • Definición: Indica las edades de los dependientes mencionados en el campo anterior y se pueden indicar hasta 15 dependientes separados por comas sin espacios.

    • Tipo: Texto.

    • Longitud: 30 caracteres.

  • fechaRecepcionInformacionDependientes

    • Definición: Fecha en la que BC recibió la información más reciente de los dependientes con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres.

  • fechaDefuncion

    • Definición: Fecha en la que BC recibió la información de la defunción del cliente con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres.

Segmento Domicilios (domicilios)

En esta sección se reportan todos los domicilios registrados en Buró de Crédito. Será una lista con N domicilios.

  • direccion1

    • Definición: Indica la calle y el número del domicilio de la persona.

    • Tipo: Texto.

    • Longitud: 40 caracteres.

  • direccion2

    • Definición: Indica la calle y el número del domicilio de la persona, se reporta este valor si el campo direccion1 es mayor a 40 caracteres.

    • Tipo: Texto.

    • Longitud: 80 caracteres.

  • coloniaPoblacion

    • Definición: Indica la colonia o población.

    • Tipo: Texto.

    • Longitud: 40 caracteres.

  • delegacionMunicipio

    • Definición: Indica la alcaldía o municipio del domicilio de la persona.

    • Tipo: Texto.

    • Longitud: 40 caracteres.

  • ciudad

    • Definición: Indica la ciudad del domicilio de la persona.

    • Tipo: Texto.

    • Longitud: 40 caracteres.

  • estado

    • Definición: Indica el estado del domicilio de la persona.

    • Tipo: Catálogo de estados.

    • Longitud: 4 caracteres.

  • cp

    • Definición: Indica el código postal.

    • Tipo: Texto.

    • Longitud: 5 caracteres.

  • fechaResidencia

    • Definición: Fecha desde la cual vive la persona en el domicilio con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres.

  • numeroTelefono

    • Definición: Indica el teléfono del domicilio.

    • Tipo: Numérico.

    • Longitud: 11 caracteres.

  • extension

    • Definición: Indica la extensión del teléfono del domicilio.

    • Tipo: Numerico.

    • Longitud: 8 caracteres.

  • fax

    • Definición: Indica el número de fax.

    • Tipo: Numérico.

    • Longitud: 11 caracteres.

  • tipoDomicilio

    • Definición: Tipo de domicilio.

    • Tipo: Catalogo de Tipo de Domicilio.

    • Longitud: 1 Caracter

  • indicadorEspecialDomicilio

  • fechaReporteDireccion

    • Definición: Indica la fecha en que se reportó la dirección a Buró de Crédito en formato YYYY-MM-DD

    • Tipo: Fecha.

    • Longitud: 1 Caracter

  • origenDelDomicilio

    • Definición: Indica el país de origen del domicilio

    • Tipo: Catálogo de Países.

    • Longitud: 2 Caracteres

Segmento Empleos (empleos)

En esta sección se reportan todos los empleos registrados en buró de crédito, será una lista con N empleos de la persona.

  • nombreEmpresa

    • Definición: Indica el nombre del empleador

    • Tipo: Texto.

    • Longitud: 40 caracteres

  • direccion1

    • Definición: Indica la calle y el número del domicilio del empleo.

    • Tipo: Texto.

    • Longitud: 40 caracteres

  • direccion1

    • Definición: Indica la calle y el número del domicilio del empleo, se reporta este valor si el campo direccion1 es mayor a 40 caracteres.

    • Tipo: Texto.

    • Longitud: 40 caracteres

  • coloniaPoblacion

    • Definición: Indica la calle y el número del domicilio del empleo, se reporta este valor si el campo direccion1 es mayor a 40 caracteres.

    • Tipo: Texto.

    • Longitud: 40 caracteres

  • delegacionMunicipio

    • Definición: Indica la alcaldía o municipio del domicilio del empleo.

    • Tipo: Texto.

    • Longitud: 40 caracteres

  • ciudad

    • Definición: Indica la ciudad del domicilio del empleo.

    • Tipo: Texto.

    • Longitud: 40 caracteres

  • estado

    • Definición: Indica el estado del domicilio del empleo.

    • Tipo: Catálogo de estados.

    • Longitud: 4 caracteres

  • cp

    • Definición: indica el código postal del empleo.

    • Tipo: Texto.

    • Longitud: 5 caracteres

  • numeroTelefono

    • Definición: indica el teléfono del domicilio del empleo.

    • Tipo: Numerico.

    • Longitud: 11 caracteres

  • extension

    • Definición: indica la extensión del teléfono del domicilio del empleo.

    • Tipo: Numerico.

    • Longitud: 8 caracteres

  • fax

    • Definición: indica el número fax del empleo.

    • Tipo: Numerico

    • Longitud: 11 caracteres

  • cargo

    • Definición: indica el cargo u ocupación del cliente.

    • Tipo: Numerico

    • Longitud: 30 caracteres

  • fechaContratacion

    • Definición: indica la fecha en la que el empleador contrató al cliente con formato YYYY-MM-DD.

    • Tipo: Fecha

    • Longitud: 10 caracteres

  • claveMonedaSalario

    • Definición: indica la clave de la moneda con la cual le pagan al cliente su sueldo.

    • Tipo: Catálogo de Monedas.

    • Longitud: 2 caracteres

  • salario

    • Definición: indica el monto de ingreso por sueldo o salario.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • baseSalarial

    • Definición: indica la periodicidad con que le pagan al Cliente.

    • Tipo: Catálogo de Frecuencia de pagos.

    • Longitud: 1 caracter

  • numeroEmpleado

    • Definición: indica el número de empleado o de nómina que le asignó el empleador.

    • Tipo: Texto.

    • Longitud: 15 caracteres

  • fechaUltimoDiaEmpleo

    • Definición: indica la fecha en que el cliente dejó de trabajar con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaReportoEmpleo

    • Definición: indica la fecha en la que se reportó el ingreso del cliente al empleo con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaVerificacion

    • Definición: indica en la que el usuario verificó por última vez los datos del empleo del cliente con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • modoVerificacion

    • Definición: indica el modo en que se verificó el domicilio.

    • Tipo: Catálogo de Modo de reportar.

    • Longitud: 1 caracter

  • origenRazonSocial

    • Definición: indica el país de origen de la razón social del empleo.

    • Tipo: Catálogo de Países.

    • Longitud: 2 caracteres

Segmento Cuentas (cuentas)

En esta sección se reportan todos los créditos o cuentas registrados en buró de crédito, será una lista con N créditos de la persona.

  • fechaActualizacion

    • Definición: indica la fecha más reciente en la que se actualizó el crédito con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • registroImpugnado

    • Definición: Si el valor es mayor a “00”, indica que el Cliente impugnó reclamó la información de la cuenta

    • Tipo: Numérico.

    • Longitud: 8 caracteres

  • claveOtorgante

    • Definición: Indica la clave del usuario que otorgó el crédito.

    • Tipo: Texto.

    • Longitud: 10 caracteres

  • nombreOtorgante

    • Definición: Indica el nombre del Usuario que reporta el Crédito.

    • Tipo: Catálogo de Tipo de negocio u otorgante.

    • Longitud: 16 caracteres

  • nombreOtorgante

    • Definición: Indica el nombre del Usuario que reporta el Crédito.

    • Tipo: Catálogo de Tipo de negocio u otorgante.

    • Longitud: 16 caracteres

  • numeroTelefonoOtorgante

    • Definición: Indica el número de teléfono del otorgante.

    • Tipo: Numérico.

    • Longitud: 11 caracteres

  • numeroCuentaActual

    • Definición: Indica el número de la Cuenta.

    • Tipo: Texto.

    • Longitud: 25 caracteres

  • indicadorTipoResponsabilidad

    • Definición: Indica el tipo de responsabilidad que tiene el Cliente con la cuenta.

    • Tipo: catalogo de Tipo de responsabilidad.

    • Longitud: 1 caracteres

  • tipoCuenta

    • Definición: Indica el tipo de responsabilidad que tiene el Cliente con la cuenta.

    • Tipo: catalogo de Tipo de cuenta.

    • Longitud: 25 caracteres

  • tipoContrato

    • Definición: Indica el tipo de producto que el Usuario le otorgó al Cliente.

    • Tipo: catalogo de Tipo de contrato.

    • Longitud: 2 caracteres

  • claveUnidadMonetaria

    • Definición: Indica el tipo de moneda de la cuenta.

    • Tipo: catalogo de TIpo de Moneda.

    • Longitud: 2 caracteres

  • valorActivoValuacion

    • Definición: Indica el importe del avaluo.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • numeroPagos

    • Definición: Indica el número total de pagos del crédito.

    • Tipo: Numérico.

    • Longitud: 4 caracteres

  • frecuenciaPagos

    • Definición: Indica el número total de pagos del crédito.

    • Tipo: Catálogo de Frecuencia de pagos.

    • Longitud: 1 caracter

  • montoPagar

    • Definición: Indica la cantidad que el Cliente deberá pagar en el siguiente período mensual, acorde al campo “frecuenciaPagos”.

      Ejemplo: Si la frecuencia de pagos es semanal, el “Monto a Pagar” será el pago semanal multiplicado por 4, etc.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • fechaAperturaCuenta

    • Definición: indica la fecha en la que se otorgó el crédito con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaUltimoPago

    • Definición: indica la fecha en la que se recibió el último pago del crédito con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaUltimaCompra

    • Definición: indica la fecha en la que el Cliente realizó la última compra o disposición de efectivo con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaCierreCuenta

    • Definición: indica la fecha en la que se cierra o liquida el crédito con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaReporte

    • Definición: indica la fecha en la que se reportó cambio o actualización a buró de crédito con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • modoReportar

    • Definición: indica la fecha en la que se reportó cambio o actualización a buró de crédito con formato YYYY-MM-DD.

    • Tipo: Catálogo de Modo de reportar.

    • Longitud: 1 caracter

  • ultimaFechaSaldoCero

    • Definición: indica la ultima fecha en la que se reportó saldo cero en el crédito formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • garantia

    • Definición: indica una descripción de la garantía utilizada para asegurar el crédito otorgado.

    • Tipo: Texto.

    • Longitud: 40 caracteres

  • creditoMaximo

    • Definición: indica el monto máximo autorizado en el crédito.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • saldoActual

    • Definición: Indica el importe total del adeudo que falta por pagar.

    • Tipo: Numérico.

    • Longitud: 10 caracteres

  • limiteCredito

    • Definición: Indica para créditos con tipo de cuenta Revolvente (R), el monto de crédito otorgado por el Usuario.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • saldoVencido

    • Definición: Indica todo el saldo vencido al período reportado.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • numeroPagosVencidos

    • Definición: Indica el número de pagos que no ha realizado el Cliente.

    • Tipo: Numérico.

    • Longitud: 4 caracteres

  • formaPagoActual

    • Definición: Indica el MOP del credito, es decir, indica si la cuenta está al corriente (sin atraso) o tiene atraso en sus pagos.

    • Tipo: Catálogo de MOP.

    • Longitud: 2 caracteres

  • historicoPagos

    • Definición: Indica el histórico de pagos de los últimos 24 meses, se reportan los mas recientes de izquierda a derecha.

    • Tipo: Cada valor reportado es un elemento del catálogo de Histórico de Pagos.

    • Longitud: 24 caracteres

  • fechaMasRecienteHistoricoPagos

    • Definición: Indica la fecha del último histórico de pagos integrado en la Base de Datos con formato YYYY-MM-DD.

    • Tipo: Fecha

    • Longitud: 10 caracteres

  • fechaMasAntiguaHistoricoPagos

    • Definición: Indica la fecha de inicio del histórico de pagos con formato YYYY-MM-DD.

    • Tipo: Fecha

    • Longitud: 10 caracteres

  • claveObservacion

    • Definición: Indica la clave de observación que identifica la situación actual del Crédito.

    • Tipo: Catálogo Claves de observación.

    • Longitud: 2 caracteres

  • totalPagosReportados

    • Definición: Indica el total de pagos reportados a buró de crédito.

    • Tipo: Numérico

    • Longitud: 3 caracteres

  • totalPagosCalificadosMOP2

    • Definición: Indica el total de pagos reportados a buró de crédito con MOP 2.

    • Tipo: Numérico

    • Longitud: 2 caracteres

  • totalPagosCalificadosMOP3

    • Definición: Indica el total de pagos reportados a buró de crédito con MOP 3.

    • Tipo: Numérico

    • Longitud: 2 caracteres

  • totalPagosCalificadosMOP4

    • Definición: Indica el total de pagos reportados a buró de crédito con MOP 4.

    • Tipo: Numérico

    • Longitud: 2 caracteres

  • totalPagosCalificadosMOP5

    • Definición: Indica el total de pagos reportados a buró de crédito con MOP 5.

    • Tipo: Numérico

    • Longitud: 2 caracteres

  • importeSaldoMorosidadHistMasGrave

    • Definición: Indica el importe del Saldo en la fecha en que la Cuenta o Crédito tuvo la morosidad más alta en la historia del Crédito.

    • Tipo: Numérico

    • Longitud: 9 caracteres

  • fechaHistoricaMorosidadMasGrave

    • Definición: Indica la fecha en que la Cuenta o Crédito tuvo la morosidad más alta en la historia del Crédito con formato YYYY-MM-DD.

    • Tipo: Fecha

    • Longitud: 9 caracteres

  • mopHistoricoMorosidadMasGrave

    • Definición: Indica el MOP más alto del crédito en su historia.

    • Tipo: Catálogo MOP.

    • Longitud: 2 caracteres

  • fechaInicioReestructura

    • Definición: Indica la fecha en la que se reportó por primera vez una reestructura con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • montoUltimoPago

    • Definición: Indica la cantidad más reciente de pago a la cuenta.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • identificadorDeCredito

    • Definición:

      La posición de la letra "Y" en la cadena de respuesta indica el tipo de mensaje de prevención asociado al crédito reportado:

      • Primera posición ("YNNNNNNNN") → El crédito fue otorgado por una empresa que reporta menos de 5,000 créditos. Puede mostrarse solo la "Y".

      • Segunda posición ("NY") → El crédito pertenece a un expediente con información sospechosa.

      • Ambas posiciones ("YY") → El crédito cumple ambas condiciones: fue otorgado por una empresa que reporta menos de 5,000 créditos y tiene información sospechosa.

    • Tipo: Texto.

    • Longitud: 20 caracteres

  • identificadorCAN

    • Definición: Indica los datos para identificar cuando el crédito es asociado a nómina (CAN).

    • Tipo: texto.

    • Longitud: 8 caracteres

  • fechaAperturaCAN

    • Definición: Indica la fecha de apertura del crédito asociado a nómina (CAN) con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaCancelacionCAN

    • Definición: Indica la fecha de cancelación del crédito asociado a nómina (CAN) con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • historicoCAN

    • Definición: Indica el histórico de pagos de los últimos 36 meses del crédito asociado a nómina (CAN), se reportan los mas recientes de izquierda a derecha.

    • Tipo: Cada valor reportado es un elemento del catálogo de Histórico de Pagos.

    • Longitud: 36 caracteres

  • fechaMasRecienteHistoricoCAN

    • Definición: Indica la fecha del último pago del crédito asociado a nómina (CAN) con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaMasAntiguaHistoricoCAN

    • Definición: Indica la fecha de inicio pago del crédito asociado a nómina (CAN) con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

Segmento histórico de saldos (historicoSaldos)

Segmento con el resumen de histórico de saldos

  • fechaReporte

    • Definición: Indica la fecha en la que se actualizó la información en la Base de Datos de Buró De Crédito, con formato YYYY-MM-DD

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • montoAPagar

    • Definición: Indica la cantidad total de los créditos a pagar al periodo reportado.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • fechaUltimoPago

    • Definición: indica la fecha del pago más reciente efectuado por el cliente con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaUltimaCompra

    • Definición: indica la fecha más reciente reportada en la que el Cliente efectuó una compra o disposición del crédito con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • creditoMaximo

    • Definición: indica el monto del crédito máximo más alto en los créditos del cliente.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • saldoActual

    • Definición: indica el monto total del adeudo para liquidar sus cuentas.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • limiteCredito

    • Definición: indica el monto total de lineas de crédito otorgado en sus cuentas.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • saldoVencido

    • Definición: indica el monto total no liquidado al periodo reportado.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • montoMaximoMorosidad

    • Definición: indica el importe del saldo en la fecha que la cuenta tuvo la morosidad más alta en la historia del crédito.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • fechaMaximaMorosidad

    • Definición: indica la fecha en la que la Cuenta tuvo la morosidad más alta con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • mopMaximaMorosidad

    • Definición: indica MOP de máxima morosidad que tuvo el crédito.

    • Tipo: Catálogo de MOP.

    • Longitud: 2 caracteres

  • saldoInsoluto

    • Definición: indica el monto del crédito pendiente de amortizar al mes que se reportó.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • montoUltimoPago

    • Definición: indica el monto mas reciente del pago realizado a la cuenta.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • ultimaVezSaldoCero

    • Definición: indica la última vez que la cuenta tuvo saldo cero con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

Segmento Consultas (consultasEfectuadas)

Segmento donde se indica todas las instituciones que han consultado al cliente

  • fechaConsulta

    • Definición: Fecha en la quela institución consultó al cliente con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • claveOtorgante

    • Definición: Indica la clave del usuario que otorgó el crédito.

    • Tipo: Texto.

    • Longitud: 10 caracteres

  • nombreOtorgante

    • Definición: Indica el nombre del Usuario que reporta el Crédito.

    • Tipo: Texto.

    • Longitud: 16 caracteres

  • telefonoOtorgante

    • Definición: Indica el número de teléfono del otorgante.

    • Tipo: Numérico.

    • Longitud: 11 caracteres

  • tipoContrato

    • Definición: Indica el tipo de producto que el Usuario le otorgó al Cliente.

    • Tipo: catalogo de Tipo de contrato.

    • Longitud: 2 caracteres

  • claveUnidadMonetaria

    • Definición: Indica el tipo de moneda de la cuenta.

    • Tipo: catalogo de TIpo de Moneda.

    • Longitud: 2 caracteres

  • importeContrato

    • Definición: Es el importe del crédito.

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • indicadorTipoResponsabilidad

    • Definición: Indica el tipo de responsabilidad que tiene el Cliente con la cuenta.

    • Tipo: catalogo de Tipo de responsabilidad.

    • Longitud: 1 caracter

  • consumidorNuevo

    • Definición: Si este campo presenta una “Y” significa que la consulta es referente a un nuevo Cliente cuyo nombre y dirección fueron ingresados a la Base de Datos de BC a consecuencia de la consulta.

    • Tipo: Texto.

    • Longitud: 1 caracter

Segmento Resumen del Informe Buró (resumenReporte)

Segmento que contiene el resumen de la información en el expediente del Cliente

  • fechaIngresoBD

    • Definición: Indica la fecha que se se registró por primera vez la información del Cliente en la Base de Datos de BC, con formato YYYY-MM-DD

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaIngresoBD

    • Definición: Indica la fecha que se se registró por primera vez la información del Cliente en la Base de Datos de BC, con formato YYYY-MM-DD

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • numeroMOP7

    • Definición: Indica el número de Cuentas con MOP = 07.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOP6

    • Definición: Indica el número de Cuentas con MOP = 06.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOP5

    • Definición: Indica el número de Cuentas con MOP = 05.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOP4

    • Definición: Indica el número de Cuentas con MOP = 04.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOP3

    • Definición: Indica el número de Cuentas con MOP = 03.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOP2

    • Definición: Indica el número de Cuentas con MOP = 02.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOP1

    • Definición: Indica el número de Cuentas con MOP = 01.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOP0

    • Definición: Indica el número de Cuentas con MOP = 00.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOPUR

    • Definición: Indica el número de Cuentas con MOP = UR.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroCuentas

    • Definición: Indica el total de Cuentas registradas en el expediente del Cliente

    • Tipo: Numérico.

    • Longitud: 4 caracteres

  • cuentasPagosFijosHipotecas

    • Definición: Número total de Cuentas de Pagos Fijos (I) e Hipotecarios (M) registradas en el expediente del Cliente.

    • Tipo: Numérico.

    • Longitud: 4 caracteres

  • cuentasRevolventesAbiertas

    • Definición: Número total de Cuentas Revolventes (R) y Sin Límite Pre-establecido (O) registradas en el expediente del Cliente.

    • Tipo: Numérico.

    • Longitud: 4 caracteres

  • cuentasCerradas

    • Definición: Número total de cuentas cerradas (con fecha cierre de cuenta).

    • Tipo: Numérico.

    • Longitud: 4 caracteres

  • cuentasNegativasActuales

    • Definición: Número total de Cuentas con MOP Actual = 02, 03, 04, 05, 06, 07,96, 97 y 99 registradas en el expediente del Cliente.

    • Tipo: Numérico.

    • Longitud: 4 caracteres

  • cuentasClavesHistoriaNegativa

    • Definición: Número total de cuentas con MOP actual = UR o 01 que tienen MOP histórico = 02, 03, 04, 05, 06, 07, 96, 97 y 99 en la historia de pagos.

    • Tipo: Numérico.

    • Longitud: 4 caracteres

  • cuentasDisputa

    • Definición: Número de cuentas con “Clave de Observación” = AD “Cuenta en Aclaración”

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroSolicitudesUltimos6Meses

    • Definición: Número de solicitudes de consulta del expediente del Cliente en los últimos 6 meses

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • nuevaDireccionReportadaUltimos60Dias

    • Definición: Indica si las direcciones actuales del Cliente han sido recibidas en los últimos 60 días. Los valores permitidos son Y=Si, N=No

    • Tipo: Texto.

    • Longitud: 1 caracteres

  • mensajesAlerta

  • existenciaDeclaracionesConsumidor

    • Definición: Indica si existe una “Declarativa” del Consumidor. Los valores permitidos son Y=Si, N=No

    • Tipo: Texto.

    • Longitud: 1 caracter

  • tipoMoneda

    • Definición: Indica la moneda en la que fue otorgado el Crédito.

    • Tipo: catalogo de TIpo de Moneda.

    • Longitud: 2 caracteres

  • totalCreditosMaximosRevolventes

    • Definición: Indica la suma de los importes de los “Créditos Máximos” de las cuentas Activas Revolventes (R) y Sin Límite Pre-establecido (O).

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • totalLimitesCreditoRevolventes

    • Definición: Indica la suma de los importes de “Límites de Crédito” de las cuentas Activas Revolventes (R) y Sin Límite Pre-establecido (O).

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • totalSaldosActualesRevolventes

    • Definición: Indica la suma de los importes de “Saldo Actual” de las cuentas Activas Revolventes (R) y Sin Límite Pre-establecido (O).

    • Tipo: Numérico.

    • Longitud: 10 caracteres

  • totalSaldosVencidosRevolventes

    • Definición: Indica la suma de los importes de “Saldo Vencido” de las cuentas Revolventes (R) y Sin Límite Pre-establecido (O).

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • totalPagosRevolventes

    • Definición: Indica la suma de los importes de “Importe de Pago” de las cuentas Activas Revolventes (R) y Sin Límite Pre-establecido (O).

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • pctLimiteCreditoUtilizadoRevolventes

  • totalCreditosMaximosPagosFijos

    • Definición: Indica la suma de los importes de “Créditos Máximos” de las cuentas Activas de Pagos Fijos (I) e Hipotecario (M).

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • totalSaldosActualesPagosFijos

    • Definición: Indica la suma de los importes de “Saldo Actual” de las cuentas Activas de Pagos Fijos (I) e Hipotecario (M).

    • Tipo: Numérico.

    • Longitud: 10 caracteres

  • totalSaldosVencidosPagosFijos

    • Definición: Indica la suma de los importes de “Saldo Vencido” de las cuentas Activas de Pagos Fijos (I) e Hipotecario (M).

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • totalPagosPagosFijos

    • Definición: Indica la suma de los importes de “Importe de Pago” de las cuentas Activas de Pagos Fijos (I) e Hipotecario (M).

    • Tipo: Numérico.

    • Longitud: 9 caracteres

  • numeroMOP96

    • Definición: Indica el número de Cuentas con MOP = 96.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOP97

    • Definición: Indica el número de Cuentas con MOP = 97.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • numeroMOP99

    • Definición: Indica el número de Cuentas con MOP = 99.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • fechaAperturaCuentaMasAntigua

    • Definición: Indica la fecha más antigua de apertura de una cuenta con formato YYYY-MM-DD

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • fechaAperturaCuentaMasReciente

    • Definición: Indica la fecha más reciente de apertura de una cuenta con formato YYYY-MM-DD

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • totalSolicitudesReporte

    • Definición: Número de consultas realizadas al expediente, sin incluir la consulta actual.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • fechaSolicitudReporteMasReciente

    • Definición: Indica la fecha más reciente en que se consultó el expediente del Cliente, no se incluye la consulta actual con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • numeroTotalCuentasDespachoCobranza

    • Definición: Número de cuentas que reportan Despachos de Cobranza o Administradoras de Cartera con KOB= YY.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • fechaAperturaCuentaMRDespachoCobranza

    • Definición: Contiene la fecha de apertura de la cuenta más reciente que se encuentra en Despacho de Cobranza o Administradora de Cartera con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • numeroTotalSolicitudesDespachosCobranza

    • Definición: Número de consultas realizadas por Despachos de Cobranza o Administradoras de Cartera al expediente del Cliente, no se incluye la consulta actual.

    • Tipo: Numérico.

    • Longitud: 2 caracteres

  • fechaSolicitudMasRecienteDespachoCobranza

    • Definición: Indica la fecha más reciente en que se consultó el expediente del Cliente realizada por un Despacho de Cobranza o Administradora de Cartera con KOB = YY, no se incluye la consulta actual con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

Segmento Hawk Alert HI Hawk Inquiry (hawkAlertBD)

Segmento que contiene información de una base de datos reportada por usuarios ligados a operaciones fraudulentas.

  • fechaReporte

    • Definición: Fecha en que la que fue reportado el posible fraude en la Base de Datos de Hawk por un Usuario con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • codigoClave

    • Definición: Código para tipificar la prevención.

    • Tipo: Catálogo de Hawk.

    • Longitud: 3 caracteres

  • tipoInstitucion

    • Definición: Nombre genérico del Usuario que reportó el probable fraude.

    • Tipo: Texto.

    • Longitud: 16 caracteres

  • mensaje

    • Definición: Descripción de la prevención.

    • Tipo: Texto (Para entender los textos puedes ver nuestro catálogo de Hawk buscando por códigoClave).

    • Longitud: 48 caracteres

Segmento Hawk Alert HR Hawk Response (hawkAlertConsulta)

Segmento que contiene información reportada por instituciones ligados a operaciones fraudulentas.

  • fechaReporte

    • Definición: Fecha en que la que fue reportado el posible fraude en la Base de Datos de Hawk por un Usuario con formato YYYY-MM-DD.

    • Tipo: Fecha.

    • Longitud: 10 caracteres

  • codigoClave

    • Definición: Código para tipificar la prevención.

    • Tipo: Catálogo de Hawk.

    • Longitud: 3 caracteres

  • tipoInstitucion

    • Definición: Nombre genérico del Usuario que reportó el probable fraude.

    • Tipo: Texto.

    • Longitud: 16 caracteres

  • mensaje

    • Definición: Descripción de la prevención.

    • Tipo: Texto (Para entender los textos puedes ver nuestro catálogo de Hawk buscando por códigoClave).

    • Longitud: 48 caracteres

Segmento Declarativa del Consumidor (declaracionesCliente)

Segmento que contiene la Declarativa del Cliente cuando no está conforme con el resultado de alguna Impugnación o Reclamación a un crédito

  • declaracionConsumidor

    • Definición: Descripción de la inconformidad de un crédito reportada por el usuario a BC.

    • Tipo: Texto (Para entender los textos puedes ver nuestro catálogo de Hawk buscando por códigoClave).

    • Longitud: 12,000 caracteres

Segmento Score (scoreBuroCredito)

Segmento que contiene la información asociada a a los Scores solicitados por el usuario a BC

  • nombreScore

    • Definición: Se presenta el valor “BC Score” para expresar que se solicitó un modelo estadístico (Score o Estimador de Ingresos).

    • Tipo: Texto (Para entender los textos puedes ver nuestro catálogo de Hawk buscando por códigoClave).

    • Longitud: 30 caracteres

  • codigoScore

    • Definición: Ver anexo Código de score.

    • Tipo: Texto (Para entender los textos puedes ver nuestro catálogo de Hawk buscando por códigoClave).

    • Longitud: 30 caracteres

  • valorScore

    • Definición: Indicará la calificación del score solicitado. En caso de no poder calcularse el score, se indicará en este campo el código de exclusión (valor negativo) que explica la causa por la cual no se pudo generar.

    • Tipo: Texto (Hacer referencia a los códigos de exclusión si no pudimos obtener un valor positivo).

    • Longitud: 4 caracteres

  • codigoRazon1

    • Definición: Indica la razón 1 por la cual se le está asignando al cliente el valorScore.

    • Tipo: Catálogo Razón Score.

    • Longitud: 30 caracteres

  • codigoRazon2

    • Definición: Indica la razón 2 por las cual se le está asignando al cliente el valorScore.

    • Tipo: Catálogo Razón Score.

    • Longitud: 30 caracteres

  • codigoRazon3

    • Definición: Indica la razón 3 por las cual se le está asignando al cliente el valorScore.

    • Tipo: Catálogo Razón Score.

    • Longitud: 30 caracteres

  • codigoError

    • Definición: Indica el código de error de BC que se presentó al obtener el score del cliente. Si existió un error solo se devuelve este campo y el de nombreScore.

    • Tipo: Catálogo de Códigos de error Score.

    • Longitud: 2 caracteres

JSON

"scoreBuroCredito": [
    {
      "codigoRazon1": "132",
      "codigoRazon2": "132",
      "codigoRazon3": "132",
      "": "007",
      "": "BC SCORE",
      "": 8982
    },
    {
      "": "02",
      "nombreScore": "BC SCORE"
    }
  ]