Voltar para Pessoa Física
Relatório Intermediário TOP Score PF
Relatório intermediário com Score de crédito, incluindo todas as informações do relatório básico mais análise de score.
Produto
RELATORIO_INTERMEDIARIO_TOP_SCORE_PF
Endpoint
POST /client/person-information
Tipo
Pessoa Física
Formato
JSON
Guia de Implementação
Documentação completa, exemplos e informações complementares
Retorno do Relatório – Features
Blocos que englobam os reports – disponibilidade dos mesmos considera o report contratado.
Dados Cadastrais Possíveis campos de retorno para dados cadastrais da pessoa física:
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| registration | string | |
| documentNumber | string | Número do documento da pessoa física |
| consumerName | string | Nome da pessoa física |
| motherName | string | Nome da mãe |
| birthDate | string($date) | Data de nascimento do documento consultado |
| statusRegistration | string | Situação da pessoa física |
| statusDate | string($date) | Data da situação do documento da pessoa física |
Score Positivo Possíveis campos de retorno para o score Score_Positivo.
Para clientes com contrato PME considerar a feature Score_Positivo_PME
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| scoreResponse | ||
| score | integer | Pontuação do score |
| scoreModel | string | Modelo do score |
| range | string | Faixa do score |
| defaultRate | string | Probabilidade de Inadimplência |
| codeMessage | integer | Código da mensagem de score |
| message | string | Mensagem do score |
Participação Societária Possíveis campos de retorno o Participação Societária.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| partnershipResponse | ||
| businessDocument | string | Documento da empresa participada |
| companyName | string | Razão social da empresa participada |
| participationInitialDate | string($date) | Data inicial da participação |
| participationPercentage | number($double) | Percentual de participação |
| companyStatus | string | Situação da empresa participada |
| companyStatusCode | string | Código da situação da empresa participada |
| companyState | string | Estado da empresa participada |
| companyStatusDate | string($date) | Data da situação da empresa participada |
| updateDate | string($date) | Data de atualização da empresa participada |
| summary | ||
| count | number($int32) | Quantidade de empresas participadas |
| balance | number($double) | “Não se aplica” |
Documentos Roubados
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| stolenDocuments | ||
| occurrenceDate | String(date) | Data da ocorrência |
| documentType | String | Pessoa física ou jurídica |
| documentNumber | String | Número do documento |
| detailedReason | String | Razão detalhada |
| phone | ||
| regionCode | Integer | Código da região (DDD) |
| areaCode | Integer | Código de área (do país) |
| phoneNumber | Integer | Telefone |
| summary | ||
| count | Integer | Quantidade total dos itens |
Possíveis campos de retorno para dados de anotações negativas (Pendência Financeira, Restrição Financeira, Dívida Vencida, Cheque sem Fundo, Protestos, Ações Judiciais e Participações em Falência):
Anotações Negativas - Pendências Financeiras (PEFIN)
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| pefinResponse | ||
| occurrenceDate | string($date) | Data da ocorrência |
| legalNatureId | string | Identificador da natureza da dívida |
| legalNature | string | Natureza da dívida |
| contractId | string | Identificador do contrato |
| creditorBusinessId | string | CNPJ do credor |
| creditorName | string | Nome do credor |
| amount | number($double) | Valor da dívida |
| legalSquare | string | Praça |
| federalUnit | string | Estado |
| principal | boolean | Principal (true) ou Avalista (false) |
| cadus | string | Código de controle interno Serasa |
| dispute | ||
| civilCourtId | string | Identificador do tribunal civil |
| disputeIndicativeFlag | boolean | Indicador de sub judice |
| disputeMessagePt | string | Descrição do sub judice |
| distributorId | string | Identificador do distribuidor |
| trialDate | string($date) | Data do julgamento |
| trialId | string | Identificador do julgamento |
| trialSquareId | string | Praça/Localização do julgamento |
| summary | ||
| firstOcurrence | string($date) | Data da negativação mais recente |
| lastOcurrence | string($date) | Data da negativação mais antiga |
| count | integer($int32) | Quantidade total de pendências financeiras |
| balance | number($double) | Valor total de pendências financeiras |
Anotações Negativas - Restrições Financeiras (REFIN)
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| refinResponse | ||
| occurrenceDate | string($date) | Data da ocorrência |
| legalNatureId | string | Identificador da natureza da dívida |
| legalNature | string | Natureza da dívida |
| contractId | string | Identificador do contrato |
| creditorBusinessId | string | CNPJ do credor |
| creditorName | string | Nome do credor |
| amount | number($double) | Valor da dívida |
| legalSquare | string | Praça |
| city | string | Cidade |
| federalUnit | string | Estado |
| principal | boolean | Principal (true) ou Avalista (false) |
| cadus | string | Código de controle interno Serasa |
| summary | ||
| firstOcurrence | string($date) | Data da negativação mais recente |
| lastOcurrence | string($date) | Data da negativação mais antiga |
| count | integer($int32) | Quantidade total de restrições financeiras |
| balance | number($double) | Valor total de restrições financeiras |
Anotações Negativas - Dívidas Vencidas (Convem)
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| collectionRecordsResponse | ||
| occurrenceDate | string($date) | Data da ocorrência |
| legalNatureId | string | Identificador da natureza da dívida |
| legalNature | string | Natureza da dívida |
| contractId | string | Identificador do contrato |
| creditorBusinessId | string | CNPJ do credor |
| creditorName | string | Nome do credor |
| amount | number($double) | Valor da dívida |
| legalSquare | string | Praça |
| city | string | Cidade |
| federalUnit | string | Estado |
| principal | boolean | Principal (true) ou Avalista (false) |
| cadus | string | Código de controle interno Serasa |
| dispute | ||
| civilCourtId | string | Identificador do tribunal civil |
| disputeIndicativeFlag | boolean | Indicador de sub judice |
| disputeMessagePt | string | Descrição do sub judice |
| distributorId | string | Identificador do distribuidor |
| trialDate | string($date) | Data do julgamento |
| trialId | string | Identificador do julgamento |
| trialSquareId | string | Praça/Localização do julgamento |
| summary | ||
| firstOcurrence | string($date) | Data da negativação mais recente |
| lastOcurrence | string($date) | Data da negativação mais antiga |
| count | integer($int32) | Quantidade total de dívidas vencidas |
| balance | number($double) | Valor total de dívidas vencidas |
Anotações Negativas - Ações Judiciais
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| judgementFilingsResponse | ||
| occurrenceDate | string($date) | Data da ocorrência |
| legalNatureId | string | Identificador da natureza da dívida |
| legalNature | string | Natureza da dívida |
| amount | number($double) | Valor da dívida |
| distributor | string | Número do distribuidor |
| civilCourt | string | Identificador da vara judicial |
| principal | boolean | Principal (true) ou Avalista (false) |
| legalSquare | string | Praça |
| city | string | Cidade |
| state | string | Estado |
| cadus | string | Código de controle interno Serasa |
| dispute | ||
| civilCourtId | string | Identificador do tribunal civil |
| disputeIndicativeFlag | boolean | Indicador de sub judice |
| disputeMessagePt | string | Descrição do sub judice |
| distributorId | string | Identificador do distribuidor |
| trialDate | string($date) | Data do julgamento |
| trialId | string | Identificador do julgamento |
| trialSquareId | string | Praça/Localização do julgamento |
| summary | ||
| firstOcurrence | string($date) | Data da negativação mais recente |
| lastOcurrence | string($date) | Data da negativação mais antiga |
| count | integer($int32) | Quantidade total de ações judiciais |
| balance | number($double) | Valor total das ações judiciais |
Anotações Negativas – Participação em Falência
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| bankruptsResponse | ||
| occurrenceDate | string($date) | Data da participação da falência |
| companyDocumentId | string | CNPJ da empresa em falência |
| companyName | string | Razão social da empresa em falência |
| companyLegalNatureID | string | Tipo de falência |
| companyLegalNature | string | Descrição do tipo de falência |
| cadus | string | Código de controle interno Serasa |
| summary | ||
| firstOcurrence | string($date) | Data da negativação mais recente |
| lastOcurrence | string($date) | Data da negativação mais antiga |
| count | integer($int32) | Quantidade total de falências |
| balance | number($double) | Valor total das falências |
Anotações Negativas - Cheques Sem Fundo (CCF)
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| checkResponse | ||
| occurrenceDate | string($date) | Data da ocorrência |
| alinea | integer($int32) | Identificador do motivo da devolução do cheque |
| bankId | integer($int32) | Identificador do banco |
| bankName | string | Nome do banco |
| bankAgencyId | integer($int32) | Número da agência |
| checkNumber | string | Número do cheque |
| checkCount | integer($int32) | Quantidade de cheques |
| legalSquare | string | Praça |
| city | string | Cidade |
| federalUnit | string | Estado |
| cadus | string | Código de controle interno Serasa |
| summary | ||
| firstOcurrence | string($date) | Data da negativação mais recente |
| lastOcurrence | string($date) | Data da negativação mais antiga |
| count | integer($int32) | Quantidade total de cheques sem fundo |
| balance | number($double) | Valor total de cheques sem fundo |
Anotações Negativas – Protestos
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| notaryResponse | ||
| occurrenceDate | string($date) | Data da ocorrência |
| amount | number($double) | Valor da dívida |
| officeNumber | string | Número do cartório |
| legalSquare | string | Praça |
| city | string | Cidade |
| federalUnit | string | Estado |
| cadus | string | Código de controle interno Serasa |
| dispute | ||
| civilCourtId | string | Identificador do tribunal civil |
| disputeIndicativeFlag | boolean | Indicador de sub judice |
| disputeMessagePt | string | Descrição do sub judice |
| distributorId | string | Identificador do distribuidor |
| trialDate | string($date) | Data do julgamento |
| trialId | string | Identificador do julgamento |
| trialSquareId | string | Praça/Localização do julgamento |
| summary | ||
| firstOcurrence | string($date) | Data da negativação mais recente |
| lastOcurrence | string($date) | Data da negativação mais antiga |
| count | integer($int32) | Quantidade total de protestos |
| balance | number($double) | Valor total dos protestos |
Anotações Negativas – Mensagens Informativas
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| negativeSummary | ||
| message | string | Mensagens informativas dos negativos |
`Observação:
Também é possível adicionar features adicionais na consulta do relatório. Basta selecionar o campo <**optionalFeatures**> e adicionar o nome da feature em <**value**> na aba <**Params**>:
Ao realizar a consulta no relatório, as informações de features adicionais são exibidas no bloco <**optionalFeatures**>:
Retorno do Relatório – Features Opcionais
Score Positivo
Possíveis campos de retorno para o score Score Positivo. Para clientes com contrato PME considerar a feature Score_Positivo_PME
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| scoreResponse | ||
| score | integer | Pontuação do score |
| scoreModel | string | Modelo do score |
| range | string | Faixa do score |
| defaultRate | string | Probabilidade de Inadimplência |
| codeMessage | integer | Código da mensagem de score |
| message | string | Mensagem do score |
O dado de defaultRange pode ser retornado ou não a depender do modelo de score.
Participação Societária Possíveis campos de retorno o Participação Societária.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| partnershipResponse | ||
| businessDocument | string | Documento da empresa participada |
| companyName | string | Razão social da empresa participada |
| participationInitialDate | string($date) | Data inicial da participação |
| participationPercentage | number($double) | Percentual de participação |
| companyStatus | string | Situação da empresa participada |
| companyStatusCode | string | Código da situação da empresa participada |
| companyState | string | Estado da empresa participada |
| companyStatusDate | string($date) | Data da situação da empresa participada |
| updateDate | string($date) | Data de atualização da empresa participada |
| summary | ||
| count | number($int32) | Quantidade de empresas participadas |
| balance | number($double) | “Não se aplica” |
Consultas à Serasa Possíveis campos de retorno para Consultas à Serasa
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| Inquiry > | ||
| inquiryResponse | ||
| occurrenceDate | string($date) | Data da ocorrência |
| segmentDescription | string | Segmento da empresa |
| daysQuantity | integer | Quantidade de dias da última consulta |
| summary | string | Situação da empresa participada |
| count | integer | Quantidade total de itens |
| inquirySummary > | ||
| inquiryQuantity | ||
| actual | Integer | Quantidade de consultas mês atual |
| creditInquiriesQuantity | ||
| inquiryDate | string | AAAA-MM da consulta |
| occurrences | Integer | Quantidade de ocorrências do período |
| summary | ||
| count | integer | Quantidade total de itens |
Anotações e Consultas SPC Possíveis campos de retorno para Anotações e Consultas SPC
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| negativeData > spcNegative > spcNegativeResponse | ||
| occurrenceDate | string($date) | Data da ocorrência |
| contractId | string | Identificador do contrato |
| creditorName | string | Nome do credor da anotação |
| creditorCity | string | Cidade do credor da anotação |
| creditorFederalUnit | string | Estado do credor da anotação |
| amount | number($double) | Valor da dívida |
| city | string | Cidade |
| federalUnit | string | Estado |
| summary | ||
| count | integer($int32) | Quantidade total das anotações |
| balance | number($double) | Valor total das anotações |
| firstOcurrence | string($date) | Data da negativação mais recente |
| lastOcurrence | string($date) | Data da negativação mais antiga |
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| spcInquires > spcInquiresResponse | ||
| occurrenceDate | string($date) | Data da ocorrência |
| segmentDescription | string | Segmento da empresa |
| summary | string | |
| count | integer | Quantidade total de itens |
| spcInquirySummary > | ||
| spcInquiryQuantity | ||
| actual | Integer | Quantidade de consulta do mês atual |
| creditInquiriesQuantity | ||
| inquiryDate | string($date) | Data dos últimos 6 meses |
| occurrences | integer | Quantidade de consulta dos últimos 6 meses |
Comprometimento de Renda
Possíveis campos de retorno para o score Comprometimento de Renda, modelo HCOR.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| attributes > incomeCommitment | ||
| scoring | integer | Pontuação do score |
| attributeModel | string | Modelo do score |
| codeMessage | integer | Código da mensagem |
| message | string | Mensagem informativa |
Capacidade de Pagamento Possíveis campos de retorno para o score Capacidade de Pagamento, modelo HCPA.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| attributes > affordability | ||
| scoring | integer | Pontuação do score |
| attributeModel | string | Modelo do score |
| codeMessage | integer | Código da mensagem |
| message | string | Mensagem informativa |
Histórico de Pagamento Possíveis campos de retorno para o score Histórico de Pagamento.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| paymentshistory > paymentsHistoryResponse | ||
| initialDayRange | Integer | Início do intervalo de atraso de pagamento |
| finalDayRange | Integer | Final do intervalo de atraso de pagamento |
| range | String | Pontuação atribuída ao histórico |
| score | String | Faixa de valor calculada com base no histórico de pagamento |
Pontualidade de Pagamento Possíveis campos de retorno para o score Pontualidade de Pagamento, modelo HIPP.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| attributes > onTimePaymentsIndex | ||
| scoring | integer | Pontuação do score |
| attributeModel | string | Modelo do score |
| codeMessage | integer | Código da mensagem |
| message | string | Mensagem informativa |
Renda Estimada Possíveis campos de retorno para o score Renda Estimada.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| attributes > attributesResponse | arrayList | |
| scoring | integer | Pontuação do score |
| attributeModel | string | Modelo do score |
| codeMessage | integer | Código da mensagem |
| message | string | Mensagem informativa |
Recomendação e Limite de Crédito Possíveis campos de retorno para Recomendação e Limite de Crédito
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| code | Integer(int32) | Código de retorno do status |
| message | string | Mensagem de retorno do status |
| data | Dados | Dados de retorno da recomendação |
| proposalNumber | string | Número da proposta valor dinâmico |
| document | string | CPF do consumidor |
| consumerName | string | Nome do consumidor |
| transactionValue | number | Valor da operação |
| creationDate | string($date) | Data de criação da proposta |
| saleType | string | Tipo da venda se é cliente novo ou recorrente |
| saleTypeCode | Integer(int32) | Código do tipo da venda |
| riskLevelCode | Integer(int32) | Nível de risco do consumidor |
| recommendationType | string | Tipo da recomendação: 1 - positiva 2 - negativa 3 - análise manual |
| recommendationSaleType | string | Mensagem do tipo de recomendação |
| recommendedLimitValue | number | Valor do limite de crédito recomendado |
| analyzedCriteria | Critério de análise | Critério de análise |
| documentActive | boolean | CPF regular ou não |
| lowIncomeCommitment | boolean | Se tem baixo comprometimento de renda |
| noDelinquencie | boolean | Sem restritivo ativo |
| noProtests | boolean | Sem protesto ativo |
Localização Possíveis campos de retorno para dados de localização.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| registration | ||
| addresses | ||
| addressLine | string | Endereço |
| addressTypeCode | integer($int32) | Tipo de Endereço |
| addressTypeDescription | string | Descrição do tipo de endereço |
| addressNumber | string | Número |
| district | string | Bairro |
| zipCode | string | CEP |
| country | string | País |
| city | string | Cidade |
| state | string | Estado |
| addressComplement | string | Complemento do endereço |
| updateDate | string($date) | Data da última atualização |
| phones | ||
| regionCode | integer($int32) | Código da região |
| areaCode | Integer($int32) | DDD |
| phoneNumber | Integer($int64) | Número do telefone |
| phoneType | string | Tipo de telefone |
| phoneTypeCode | Integer($int32) | Código do tipo de telefone |
| updateDate | String | Data da última atualização |
Score de Fraude
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| scoreFraud > scoreFraudResponse | ||
| score | Integer | Modelo usado para obter score |
| scoreModel | String | Valor do score |
| recommendationRisk | String | Recomendação baseada no valor do score |
| message | String | Mensagem do modelo de score requisitado |
Índice Relacionamento Mercado Setor PF Possíveis campos de retorno para dados do modelo HIRF.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| attributes > attributesResponse | arrayList | |
| attributeModel | string | Modelo do score |
| codeMessage | integer | Código da mensagem |
| message | string | Mensagem informativa |
| attributes > attributesResponse > data | arrayList | Informações dos índices de Relacionamento com Mercado e Setor |
| code | string | Código do setor |
| codeDescription | string | Descrição do setor |
| codeMessage | string | Código do índice de relacionamento mercado e setor |
| message | string | Mensagem do índice de relacionamento mercado e setor |
Alerta de Óbito Possíveis campos de retorno para o Alerta de Óbito.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| obito > deathResponse | ||
| document | string | Documento consultado |
| alert | string | Tipo do alerta |
| codes > codes | ||
| messageCode | string | Código da mensagem |
| fullMessage | string | Mensagens referentes ao óbito |
Score de Curto Prazo Possíveis campos de retorno para o Score de Curto Prazo.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| scores > scoreResponse | ||
| score | integer | Pontuação do score |
| scoreModel | string | Modelo do score |
| range | string | Faixa do score |
| defaultRate | string | Probabilidade de Inadimplência |
| codeMessage | integer | Código da mensagem de score |
| message | string | Mensagem do score |
Agro Score
Análise de risco de crédito para produtores rurais pessoa física. Indica a probabilidade de um indivíduo pagar suas contas em dia nos próximos meses.
Possíveis campos de retorno para o Agro Score PF.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| scores > scoreResponse | ||
| score | integer | Pontuação do score |
| scoreModel | string | Modelo do score |
| range | string | Faixa do score |
| defaultRate | string | Probabilidade de Inadimplência |
| codeMessage | integer | Código da mensagem de score |
| message | string | Mensagem do score |
Agro Renda Estimada
Agro Renda oferece uma estimativa de renda mensal (R$) calibrada para produtores rurais ou pessoas físicas relacionadas às atividades agropecuárias.
Possíveis campos de retorno:
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| attributes > attributesResponse arrayList | ||
| scoring | integer | Pontuação do score |
| attributeModel | string | Modelo do score |
| codeMessage | integer | Código da mensagem |
| message | string | Mensagem informativa |
Segmentação Mosaic
O Mosaic oferece uma segmentação de mercado de pessoas físicas, com características de perfil de consumo.
Possible return fields for Segmentação Mosaic:
| Field Name | Type | Description |
|---|---|---|
| mosaic | ||
| code | String | Brazilian Society Classification Code |
| group | String | Brazilian Society Classification Group |
| description | String | Brazilian Society Classification Description |
Risco de crédito do perfil
Traz uma avaliação de risco da população geral que tem o mesmo perfil do documento consultado.
Possíveis campos de retorno para o Risco de Crédito do Perfil:
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| attributes > attributesResponse arrayList | ||
| scoring | integer | Pontuação do score |
| attributeModel | string | Modelo do score |
| codeMessage | integer | Código da mensagem |
| message | string | Mensagem informativa |
Achei Recheque Possíveis campos de retorno para informações de Achei Recheque, requisitadas por documento, banco ou CMC7.
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| checkFilings > checkFilingsResponse | ||
| bankNumber | integer | Número do banco |
| bankName | string | Nome do banco |
| agencyNumber | integer | Agência |
| accountNumberCheck | integer | Número da conta |
| initialCheckNumber | integer | Número do cheque inicial |
| finalCheckNumber | integer | Número do cheque final |
| holderNameAccount | string | Nome do titular da conta |
| checkAmount | number($double) | Valor do cheque |
| agencySquareCode | string | Praça da agência bancaria |
| agencyZipCode | integer | CEP da agência bancaria |
| briefDescriptionReason | string | Descrição do recheque |
| dateTimeInclusion | string($datetime) | Data e hora da inclusão |
| messageDescription | string | Mensagem descritiva |
| checkFilingsHistorical > checkFilingsHistoricalResponse | ||
| bankNumber | integer | Número do banco |
| bankName | string | Nome do banco |
| agencyNumber | integer | Agência |
| accountNumberCheck | integer | Número da conta |
| initialCheckNumber | integer | Número do cheque inicial |
| finalCheckNumber | integer | Número do cheque final |
| holderNameAccount | string | Nome do titular da conta |
| checkAmount | number($double) | Valor do cheque |
| agencySquareCode | string | Praça da agência bancaria |
| agencyZipCode | integer | CEP da agência bancaria |
| briefDescriptionReason | string | Descrição do recheque |
| dateTimeInclusion | string($datetime) | Data e hora da inclusão |
| messageDescription | string | Mensagem descritiva |
Renda Mais
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| attributes > attributesResponse | ||
| scoring | integer | Pontuação do score |
| attributeModel | string | Modelo do score |
| codeMessage | integer | Código da mensagem |
| message | string | Mensagem informativa |
Indicador de Recuperação de Crédito
| Nome do Campo | Tipo | Descrição |
|---|---|---|
| scoreResponse | ||
| score | integer | Pontuação do score |
| scoreModel | string | Modelo do score |
| range | string | Faixa do score |
| defaultRate | string | Probabilidade de Inadimplência |
| codeMessage | integer | Código da mensagem de score |
| message | string | Mensagem do score |
DOCUMENTOS DE APOIO
Tabela de Naturezas Das Anotações Concentre
| Tipo de Anotação | Código Natureza | Descrição Natureza |
|---|---|---|
| Protestos | ||
| Ações | BA EX FE FM JB JE JF TR | Busca e Apreensão Execução Execução Fiscal Estadual Execução Fiscal Municipal Busca e Apreensão - Pequenas Causas Execução - Pequenas Causas Execução Fiscal Federal Execução de Título Judicial Trabalhista |
| Falências/Concordatas | AF CD CR CS FD FR RC RE RH RR | Auto Falência Concordata Deferida Concordata Requerida Concordata Suspensiva Falência Decretada Falência Requerida Recuperação Judicial Concedida Recuperação Extrajudicial Requerida Recuperação Extrajudicial Homologada Recuperação Judicial Requerida |
| PIE | FD | Falência Decretada |
| ACHEI | 12 13 14 | Cheques sem fundo 2ª Apresentação Conta Encerrada Prática Espúria |
Tabela de Naturezas Das Anotações REFIN
| Código Natureza | Descrição |
|---|---|
| AD | Adiantamento a depositantes - c/c devedores em geral |
| AG | Empréstimos agrícolas e industriais - financiamentos de custeio de investimentos agrícolas e industriais |
| AR | Arrendamentos, inclusive leasing |
| CA | Operações de câmbio - operações e financiamentos de câmbio em geral |
| CB | CDC outros bens móveis |
| CH | Adiantamento a depositantes - cheques sem fundos acolhidos |
| CL | CDC veículos leves |
| CM | CDC motocicletas e motonetas |
| CR | Impedidos pelo Banco Central de obtenção de crédito rural |
| CT | Cartão de crédito |
| CV | CDC veículos pesados: tratores, ônibus, caminhões, barcos e aviões |
| C2 | Consórcio veículos pesados: tratores, ônibus, caminhões, barcos e aviões |
| C3 | Consórcio veículos leves |
| C4 | Consórcio motocicletas e motonetas |
| C5 | Consórcio outros bens móveis |
| EC | Empréstimos em contas - c/c garantidas, financiamentos de capital de giro, programas especiais, etc |
| FI | Créditos e financiamentos - empréstimos a pessoas físicas, financiamentos ao consumidor final, etc |
| IM | Operações imobiliárias em geral, inclusive de sociedades de poupança |
| IP | Débito IPVA |
| LL | Leasing veículos leves |
| LM | Leasing motocicletas e motonetas |
| LV | Leasing veículos pesados: tratores, ônibus, caminhões, barcos e aviões |
| OJ | Operações ajuizadas |
| OO | Outras operações - diversas operações que não se enquadram nas demais |
| RE | Operações de repasse - operações 63, FINAME, REINVEST, RECON, PROALCOOL, etc |
| SR | Seguro de risco decorrido |
| TD | Títulos descontados - descontos de duplicatas, promissórias e outros títulos |
| FIF | crédito e financiamento-financeira |
Notas:
- Esta tabela de naturezas agrupa as diversas modalidades operacionais, de modo a permitir o enquadramento das operações em geral, realizadas não só pelos bancos comerciais, como também pelas demais empresas do conglomerado financeiro.
- Ao código da natureza da operação poderá opcionalmente ser acrescentada a identificação da empresa do conglomerado em que a operação foi realizada, conforme padrões abaixo:
V – banco de investimento
I – crédito imobiliário
C – corretora de valores
T - turismo
F – financeira
P – poupança
S – seguradora
Se esta identificação não for colocada, a operação será considerada do Banco Comercial.
Tabela de Naturezas Das Anotações PEFIN
| COD | DESCRIÇÃO NATUREZA | ABREVIAÇÃO 12 POS |
|---|---|---|
| AD | Adiantamento a depositantes - conta corrente devedora | ADIANT CONTA |
| AG | Empréstimo / financiamento agrícola / rural-comercial, industrial e custeio | EMPRESTIMOS |
| AL | Aluguel | ALUGUEL |
| AR | Arrendamento, inclusive leasing | LEASING |
| C1 | Consórcio imóvel | CONS IMOVEIS |
| C2 | Consórcio veículos pesados: tratores, ônibus, caminhões, barcos e aviões | CONS VEI PES |
| C3 | Consórcio veículos | CONS VEICULO |
| C4 | Consórcio motocicletas e motonetas | CONS MOTOS |
| C5 | Consórcio outros bens móveis | CONS BENS |
| C6 | Consórcio passagens aéreas | CONS AEREO |
| CA | Operações de financiamento de câmbio em geral | OPER CAMBIO |
| CB | CDC outros bens móveis | CDC BENS |
| CC | Cota condominial | CONDOMINIO |
| CD | Crédito direto – crediário | CREDIARIO |
| CL | CDC veículos leves | CDC V LEVE |
| CM | CDC motocicletas e motonetas | CDC MOTOS |
| CO | Consórcio contemplado | CONS CONTEMP |
| CP | Crédito pessoal | CRED PESSOAL |
| CR | Impedidos de crédito rural pelo Bacen | IMPEDIDO BC |
| CT | Operações com cartão de crédito | CRED CARTAO |
| CV | CDC veículos pesados: tratores, ônibus, caminhões, barcos e aviões | CDC V PES |
| DC | Dívidas originárias de cheques | DIVIDAS CHEQ |
| DE | Dívidas originárias de cheque eletrônico | CHEQUE ELET |
| DP | Duplicata | DUPLICATA |
| EC | Empréstimos em conta, conta corrente garantida, capital de giro, programa especial | EMPRES CONTA |
| EE | Energia elétrica - faturas de fornecimento de luz | ENERGIA ELET |
| EG | Empréstimo consignado | EMPR CONSIG |
| FG | Gás - faturas de fornecimento de gás | FAT GAS |
| FI | Créditos e financiamentos | FINANCIAMENTO |
| HO | Despesas com hospitais | HOSPITAIS |
| IE | Instituição de ensino: bolsa restituível | INST ENSINO |
| IM | Operações imobiliárias | OPER IMOBIL |
| LL | Leasing veículos leves | LEAS VEICULO |
| LM | Leasing motocicletas e motonetas | LEAS MOTOS |
| LV | Leasing veículos pesados: tratores, ônibus, caminhões, barcos e aviões | LEAS VEI PES |
| ME | Mensalidades escolares | MENS ESCOLAR |
| NF | Notas fiscais | NOTA FISCAL |
| OA | Operações agrícolas – negociações produtos rurais, insumos, sementes etc. | OPER AGRIC |
| OJ | Operações ajuizadas | OPER AJUIZAD |
| OO | Outras operações | OUTRAS OPER |
| RE | Operações de repasse, FINAME, 63, REINVEST, RECON, PROALCOOL etc. | REPASSES |
| RR | Arrecadadores - prestadores de serviços | ARRECADADOR |
| SB | Saneamento básico - faturas de fornecimento de água | FAT AGUA |
| SF | Seguro fiança locatícia | SEG FIANCA |
| SG | Seguro garantia | SEG GARANTIA |
| SQ | Seguro quebra de garantia | SEG QUEBRA |
| SR | Seguro de risco decorrido | SEGURO RISCO |
| SS | Mensalidade de plano/seguro de saúde | SEGURO SAUDE |
| TC | Termo de confissão de dívida descumprido | CONFISS DIV |
| TD | Títulos descontados, duplicatas, promissórias, etc. | TIT DESCONTA |
| TE | Serviços de telefonia móvel pessoal / celular – outras contas após rescisão do contrato | TELEF MO |
| TF | Serviços de telefonia fixa – outras contas após rescisão do contrato | TELEF FX |
| TI | Serviços de dados e internet (speedy, aluguel de canais de dados e fibra ótica) | SERV DADOS |
| TM | Serviços de telefonia móvel pessoal / celular – res 221/00 | TELEF MOVEL |
| TP | Serviços de telefonia / vendas de produtos – vendas de aparelhos, instalação, aluguel de aparelhos | SERV TELEFON |
| TR | Serviços de telefonia – renegociação da dívida | RENEG DIVIDA |
| TT | Serviços de telefonia fixa – res 085/98 | TELEF FIXA |
| VM | Prestação de serviços - vendas de mercadorias | VENDA MERCAD |
Tabela de Naturezas Das Anotações Convem Devedores
| Código | Descrição |
|---|---|
| BC | COBRANÇA CAUCIONADA |
| BD | COBRANÇA DESCONTADA |
| BS | COBRANÇA SIMPLES |
| CC | CONTRATO DE CÂMBIO |
| CCC | CÉDULA DE CRÉDITO COMERCIAL |
| CCE | CÉDULA DE CRÉDITO À EXPORTAÇÃO |
| CCI | CÉDULA DE CRÉDITO INDUSTRIAL |
| CCR | CÉDULA DE CRÉDITO RURAL |
| CD | CONFISSÃO DE DÍVIDA |
| CDE | CERT EN76 JE |
| CH | CHEQUE |
| CHP | CÉDULA HIPOTECÁRIA |
| CJV | CONTA JUDICIALMENTE VERIFICADA |
| CM | CONTRATO DE MÚTUO |
| CPH | CÉDULA RURAL PIGNORATÍCIA HIPOTECÁRIA |
| CRH | CÉDULA RURAL HIPOTECÁRIA |
| CRP | CÉDULA RURAL PIGNORATÍCIA |
| CS | CONTA DE PRESTAÇÃO DE SERVIÇO |
| DM | DUPLICATA DE VENDA MERCANTIL |
| DMI | DUPLICATA DE VENDA MERCANTIL POR INDICAÇÃO |
| DR | DUPLICATA RURAL |
| DRI | DUPLICATA RURAL DE INDICAÇÃO |
| DS | DUPLICATA DE PRESTAÇÃO DE SERVIÇOS |
| DSI | DUPLICATA DE PRESTAÇÃO DE SERVIÇOS POR INDICAÇÃO |
| DV | DIVERSOS - QUANDO NÃO ENQUADRAR NA RELAÇÃO ACIMA |
| LC | LETRA DE CÂMBIO |
| LCN | LETRA DE CÂMBIO SEM ACEITE |
| NCC | NOTA DE CRÉDITO COMERCIAL |
| NCE | NOTA DE CRÉDITO À EXPORTAÇÃO |
| NCI | NOTA DE CRÉDITO INDUSTRIAL |
| NCR | NOTA DE CRÉDITO RURAL |
| NP | NOTA PROMISSÓRIA |
| NPR | NOTA PROMISSÓRIA RURAL |
| SJ | SENTENÇA JUDICIAL |
| TA | TERMO DE ACORDO |
| TM | TRIPLICATA DE VENDA MERCANTIL |
| TS | TRIPLICATA DE PRESTAÇÃO DE SERVIÇOS |
| W | WARRANT |
Tabela de índices dos dados cadastrais
| Código | Descrição |
|---|---|
| documentosAlternativos | |
| 1 | CARTEIRA DE IDENTIDADE (RG) |
| 2 | CARTEIRA DE IDENTIFICAÇÃO DE ESTRANGEIRO |
| 4 | CERTIFICAÇÃO MILITAR |
| 5 | CARTEIRA PROFISSIONAL |
| 6 | PASSAPORTE |
| tiposTelefone | |
| 1 | TELEFONE RESIDENCIAL |
| 2 | TELEFONE COMERCIAL |
| 3 | TELEFONE MOVEL |
| 4 | TELEFONE MOVEL |
| 5 | TELEFONE PÚBLICO |
| 6 | HOUSE HOLD-FAMILIA |
| 7 | ENDEREÇO DOMÉSTICO |
| 8 | TELEFONE MOVEL COMERCIAL |
| 9 | TELEFONE DE PARENTE |
| tipoEndereco | |
| 1 | RESIDENCIAL |
| 2 | COMERCIAL |
| educationLevelCode | |
| 1 | GRAU |
| 2 | GRAU |
| 3 | SUPERIOR COMPLETO |
| 4 | SUPERIOR INCOMPLETO |
| 5 | POS GRAD |
| 6 | ANALFABETO |
| 25 | MESTRADO |
| 33 | SUPERIOR COM |
| 35 | DOUTORADO |
| 44 | SUPERIOR INC |
| 45 | PHD |
| maritalStatus | |
| 1 | CASADO |
| 2 | SOLTEIRO |
| 3 | VIUVO |
| 4 | DIVORCIADO |
| 5 | SEPARADO |
| 9 | OUTRO |
ERROS E CÓDIGOS DE RETORNO/MENSAGEM
Para todas as funcionalidades listadas nesse documento estão sendo considerados os seguintes erros:
| Código | Descrição | Mensagem |
|---|---|---|
| 400 | Bad Request | Bad Request |
| 401 | Authorization Failed | Authorization Failed |
| 403 | Forbidden | Menor de idade protegido legalmente |
| 404 | Not Found | Documento não encontrado na Serasa Experian. |
| 412 | Documento Consultado Inválido | [ERROR][INVALID-REQUEST] Erro encontrado com a requisição, informe o documento a ser consultado válido em: [X-Document-Id]. |
| 412 | Feature Opcional Inexistente/Inválida | [ERROR][INVALID-REQUEST] Erro encontrado com a requisição, as [Features Opcionais] solicitadas [Não existem] ou [Não estão autorizadas] para o relatório [Features Opcionais]: [,...] |
| 412 | Usuário Sem Transações Cadastradas | [ERROR][USER-NOT-AUTHORIZED] Transações negadas: [,...] |
| 412 | Usuário Sem Logon ou CNPJ Vinculado no Client_Id | [ERROR][USER-NOT-AUTHORIZED] Usuário não autorizado. |
| 429 | Too Many Requests | Too Many Requests |
| 500 | Internal Server Error | Internal Server Error |
| 500 | Erro no Processamento de Uma ou Mais Informações | [ERROR][PROCESSING] Ocorreu um erro com as features: [,...] |
| default | Unexpected Error | Unexpected Error |