PEFIN
SERASA - PEFIN (Pendências Financeiras)
Webservices SERASA
Endpoints
Produção: http://www.soawebservices.com.br/webservices/producao/serasa/pefin.asmx
Test-Drive: http://www.soawebservices.com.br/webservices/test-drive/serasa/pefin.asmx
Método: PEFIN
Descrição: Retorna consulta de pendências financeiras na SERASA
Headers:
Requisição SEM solicitar adicionais SOAP/XML:
Resposta SOAP/XML:
Requisição COM adicionais SOAP/XML:
Obs: Quando solicitado os adicionais serão cobrados alem do valor da consulta, verifique no portal o preço de cada adicional.
Exemplo de Resposta com Adicionais SOAP/XML:
Estrutura de Retorno do PEFIN:
Item | Tipo | Nome | Descrição |
1 | XML Node | SinteseCadastral | Sintese Cadastral |
2 | Integer | TotalOcorrencias | Quantidade de Restrições |
3 | Numeric(18,2) | ValorTotalOcorrencias | Valor Total das Restrições |
4 | XML Node | AlertaDocumentos | Alerta de Documentos |
5 | XML Node | PendenciasInternas | Pendências Internas |
6 | XML Node | PendenciasFinanceiras | Pendências Financeiras |
7 | XML Node | PendenciasBacen | Pendências Bacen |
8 | XML Node | Transacao | Informações de Status da Transação |
9 | Boolean | Status | Veja nota, TAG irá ser descontinuado |
10 | varchar(80) | Mensagem | Veja nota, TAG irá ser descontinuado |
Sintese Cadastral:
Item | Tipo | Nome | Descrição |
1.1 | varchar(8) | Documento | CPF da Pessoa |
1.2 | varchar(100) | Nome | Nome da Pessoa Física |
1.3 | varchar(100) | NomeMae | Nome da Mae em caso de PF |
1.4 | varchar(100) | NomeFantasia | Nome Fantasia em caso de PJ |
1.5 | Date | DataNascimento | Data de Nascimento (DD/MM/AAAA) em caso de PF |
1.6 | Date | DataFundacao | Data de Fundação (DD/MM/AAAA) em caso de PJ |
1.7 | Integer | SituacaoRFB | Codigo da Situação |
1.8 | varchar(20) | SituacaoDescricaoRFB | Descricao da Situação na RFB |
1.9 | Date | DataSituacaoRFB | Data da Situação (DD/MM/AAAA) |
Situações Receita Federal:
0-Inapta
2-Ativa/Regular
3-Pendente de Regularizacao
4-Nao Disponivel
6-Suspenso(a)
7-Baixada
9-Cancelado
ou
Nao Disponivel
Alerta de Documentos:
Item | Tipo | Nome | Descrição |
4 | XML Node | AlertaDocumentos | Node contendo informações sobre os alertas do documento consultado. |
4.1 | Integer | NumeroMensagem | Número da Mensagem |
4.2 | Integer | TotalMensagens | Total de Mensagens |
4.3 | varchar(6) | TipoDocumento | Tipo do Documento |
4.4 | varchar(20) | NumeroDocumento | Numero do Documento |
4.5 | varchar(4) | MotivoOcorrencia | Motivo da Ocorrencia |
4.6 | Date | DataOcorrencia | Data da Ocorrência (DD/MM/AAAA) |
Telefones Contato:
Item | Tipo | Nome | Descrição |
4.7 | XML Node | TelefonesContato | Node contendo informações sobre o Telefone de Contato do Alerta. |
4.7.1 | varchar(8) | Telefone | Numero do Telefone |
PendenciasInternas:
Item | Tipo | Nome | Descrição |
5.1 | Integer | TotalOcorrencias | Quantidade de Restrições deste bloco |
5.2 | Numeric(18,2) | ValorTotalOcorrencias | Valor Total das Restrições deste bloco |
5.3 | Date | OcorrenciaMaisAntiga | Data da Ocorrencia Mais Antiga (DD/MM/AAAA) |
5.4 | Date | OcorrenciaMaisRecente | Data da Ocorrencia Mais Recente (DD/MM/AAAA) |
5.5 | Numeric(18,2) | ValorTotalOcorrencias | Valor Total das Restrições |
5.6 | XML Node | PendenciasInternasDetalhe | Valor Total das Restrições |
PendenciasInternasDetalhe:
Item | Tipo | Nome | Descrição |
5.6.1 | Date | DataOcorrencia | Data da Ocorrência |
5.6.2 | varchar(30) | Modalidade | Modalidade do Titulo |
5.6.3 | varchar(1) | Avalista | Avalista do Titulo |
5.6.4 | varchar(3) | TipoMoeda | Tipo de Moeda Ex: R$ |
5.6.5 | numeric(18,2) | Valor | Valor o Titulo |
5.6.6 | varchar(16) | Contrato | Numero do Contrato |
5.6.7 | varchar(30) | Origem | Origem do Titulo |
5.6.8 | varchar(4) | Sigla | Sigla da Origem do Titulo |
5.6.9 | varchar(1) | SubJudice | SubJudice (S/N) |
5.6.10 | varchar(80) | SubJudiceDescricao | Descricao de SubJudice |
5.6.11 | varchar(1) | TipoAnotacao | Tipo de Anotação |
5.6.12 | varchar(100) | TipoAnotacaoDescricao | Descrição do Tipo de Anotação |
Obs: Este node pode se repetir várias vezes
PendenciasFinanceiras:
Item | Tipo | Nome | Descrição |
6.1 | Integer | TotalOcorrencias | Quantidade de Restrições deste bloco |
6.2 | Numeric(18,2) | ValorTotalOcorrencias | Valor Total das Restrições deste bloco |
6.3 | Date | OcorrenciaMaisAntiga | Data da Ocorrencia Mais Antiga (DD/MM/AAAA) |
6.4 | Date | OcorrenciaMaisRecente | Data da Ocorrencia Mais Recente (DD/MM/AAAA) |
6.5 | Numeric(18,2) | ValorTotalOcorrencias | Valor Total das Restrições |
6.6 | XML Node | PendenciasFinanceirasDetalhe | Valor Total das Restrições |
PendenciasFinanceirasDetalhe:
Item | Tipo | Nome | Descrição |
6.6.1 | Date | DataOcorrencia | Data da Ocorrência |
6.6.2 | varchar(30) | Modalidade | Modalidade do Titulo |
6.6.3 | varchar(1) | Avalista | Avalista do Titulo |
6.6.4 | varchar(3) | TipoMoeda | Tipo de Moeda Ex: R$ |
6.6.5 | numeric(18,2) | Valor | Valor o Titulo |
6.6.6 | varchar(16) | Contrato | Numero do Contrato |
6.6.7 | varchar(30) | Origem | Origem do Titulo |
6.6.8 | varchar(4) | Sigla | Sigla da Origem do Titulo |
6.6.9 | varchar(1) | SubJudice | SubJudice (S/N) |
6.6.10 | varchar(80) | SubJudiceDescricao | Descricao de SubJudice |
6.6.11 | varchar(1) | TipoAnotacao | Tipo de Anotação |
6.6.12 | varchar(100) | TipoAnotacaoDescricao | Descrição do Tipo de Anotação |
Obs: Este node pode se repetir várias vezes
PendenciasBacen:
Item | Tipo | Nome | Descrição |
7.1 | Integer | TotalOcorrencias | Quantidade de Restrições deste bloco |
7.2 | Numeric(18,2) | ValorTotalOcorrencias | Valor Total das Restrições deste bloco |
7.3 | Date | OcorrenciaMaisAntiga | Data da Ocorrencia Mais Antiga (DD/MM/AAAA) |
7.4 | Date | OcorrenciaMaisRecente | Data da Ocorrencia Mais Recente (DD/MM/AAAA) |
7.5 | Numeric(18,2) | ValorTotalOcorrencias | Valor Total das Restrições |
7.6 | XML Node | PendenciasBacenDetalhe | Valor Total das Restrições |
PendenciasBacenDetalhe:
Item | Tipo | Nome | Descrição |
7.6.1 | Date | DataOcorrencia | Data da Ocorrência |
7.6.2 | varchar(10) | NumeroCheque | Numero do Cheque |
7.6.3 | varchar(5) | AlineaCheque | Alinea de Devolução |
7.6.4 | varchar(5) | QuantidadeCCFBanco | Quantide Cheques Devolvidos |
7.6.5 | numeric(18,2) | Valor | Valor do Cheque |
7.6.6 | varchar(3) | Banco | Codigo do Banco |
7.6.7 | varchar(14) | NomeBanco | Nome do Banco |
7.6.8 | varchar(4) | Agencia | Agencia |
7.6.9 | varchar(30) | Cidade | Cidade |
7.6.10 | varchar(2) | UF | Estado |
Obs: Este node pode se repetir várias vezes
Participações Societárias:
Item | Tipo | Nome | Descrição |
8 | XML Node | Participacoes | Node contendo as participacoes societarias |
8.1 | XML Node | ParticipacaoSocietaria | Node contento os dados da participacao |
8.2 | varchar(8) | Pessoa | Tipo de Pessoa Fisica ou Juridica |
8.3 | varchar(14) | DocumentoEmpresa | CNPJ da Empresa em que participa |
8.4 | varchar(80) | Empresa | Razao Social da Empresa |
8.5 | numeric(18,2) | Percentual | Percentual de Participacao |
8.6 | varchar(2) | Estado | Unidade Federativa da Empresa |
8.7 | DateTime | DataUltimaAtualizacao | Data da ultima atualizacao no sistema |
Obs: Este node só irá aparecer se for solicitado como Adicional e será cobrado além da consulta
Risk Score:
Item | Tipo | Nome | Descrição |
9 | XML Node | RiskScore | Node contendo a Analise de Risco |
9.1 | XML Node | PessoaFisica | Tipo de Pessoa |
9.2 | varchar(4) | Modelo | Tipo de modelo estatistico utilizado |
9.3 | varchar(1) | Calculado | Flag se foi calculado, S/N, Dados insuficientes quando não calculado |
9.4 | varchar(3) | Classe | Classificacao do Risco |
9.5 | numeric(18) | PercentualInadimplentes | Percentual de inadimplentes nesta classificacao |
9.6 | varchar(200) | Descricao | Descricao da Classificacao |
Obs: Este node só irá aparecer se for solicitado como Adicional e será cobrado além da consulta
Limite de Crédito:
Item | Tipo | Nome | Descrição |
10 | XML Node | LimiteCredito | Node contendo Limite de Credito |
10.1 | XML Node | PessoaFisica | Tipo de Pessoa |
10.2 | varchar(4) | Valor | Valor sugerido para credito |
10.3 | XML Node | Observacoes | Observações sobre o limite de credito |
10.4 | varchar(100) | Item | Descrições, este node pode retornar mais de uma vez |
Obs: Este node só irá aparecer se for solicitado como Adicional e será cobrado além da consulta
Transacao:
Item | Tipo | Nome | Descrição |
11 | XML Node | Transacao | Node contendo mensagem padronizada sobre a transação. |
11.1 | varchar(2) | Status | Status da Transação |
11.2 | varchar(2) | CodigoStatus | Código de Status |
11.3 | varchar(2) | CodigoStatusDescricao | Descrição do Codigo de Status |
Atenção(*):
Todas as transações estão vindo agora com o Node XML <Transacao>, este node tem como finalidade padronizar as respostas de status e descrições. Quando estiver integrando suas aplicações nao utilizar as tags <Status> e <Descricao> porque elas serão descontinuadas em breve.
As mensagens de status novas estão documentadas no link abaixo: http://www.soawebservices.com.br/integracao/manuais/mensagens.aspx
Last updated