Páginas filhas
  • SERASA Relato

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Para o uso direto em testes, deve-se utilizar (e.g. /home/jboss/intellector).

Bloco de código
languagejava
java -jar -cp. -Dserasa-relato.datadir=/home/jboss/intellector SerasaRelato.jar
Dica
Usando a execução acima, não esqueça de colocar no CLASSPATH todas as dependências; e o mesmo para JAVA_OPTS no JBoss.

 

Propriedades para o Acesso Seguro (HTTPS)

‘https.properties‘ – arquivos de propriedades do certificado e conexão ‘host-to-host‘ com a SERASA.

Bloco de código
languagehtml/xml
# Arquivo de properties para o SERASA PJ 
# $Revision: 1.2 $ 
# 
  
# Informações de autenticacao e certificados do serasa 
user.url=sitenet07.serasa.com.br 
user.root=/Homologa/consultahttps
user.jks=lVaxvlqeVH5ugq/rba5vYvSWhu8kYJqO3Q==O63WLqgqpA== 
user.cert=/home/jboss/intellector-files/serasa.jks 
#user.serasa.cert=e:/tools/desv/ws_tec/serasa/resources/serasa.jks
Dica

Existe no Site do Intellector, uma funcionalidade para configurar os arquivos de propriedades, lá você poderá gerar a senha criptografada.

Aviso

 Configurando SSL e HTTPS, leia aqui; sem Certificado ’não funciona’ e, entenda bem o conceito, leia sobre isso. Esse certificado é fornecido pela própria entidade, tipo host<->host.

 

Auditoria dos dados de Acesso

Para efeitos de auditoria, esse plugin persiste os dados da string de Envio e Retorno do acesso (dados brutos), sendo possível consultar esses dados via web service de Auditoria e verificar ou fazer uso dessas strings. O conteúdo dessa string bruta é composto pelos campos que compõe o layout de entrada e saída, especificada na documentação do SERASA.


Layouts para o Acesso

  • Nos Layouts são apresentados dados fixos, que provavelmente não sofrerão alterações; caso haja, a codificação do acesso também deverá ser alterada; basicamente, são dados transacionais.
  • Baixe aqui o Layout B49C/L49C.

‘layout_p002.xml‘ – Header do Registro P005 – Parcelas com cheques de Compromisso. 

Bloco de código
languagehtml/xml
<?xml version="1.0" encoding="ISO-8859-1"?> 
<!-- layout_p002.xml - Registro P002 - Outras Opcoes de Consulta Pessoa Juridica -->
<serasapj> 
    <field> 
    <!-- Tipo de registro TIPO-REG -->
        <name>P002</name> 
        <size>4</size> 
        <type>S</type> 
    </field> 
    <field> 
    <!-- codigo da 1a opcao para consultar outro produto, feature ou base (ver tabela 30 -->
        <name>IP20</name> 
        <size>4</size> 
        <type>S</type> 
    </field> 
    <field> 
    <!-- chave de acesso para consultar a 1a opcao se necessario -->
        <name>Q</name> 
        <size>21</size> 
        <type>S</type> 
    </field> 
  
    <field> 
    <!-- codigo da 2a opcao para consultar outro produto, feature ou base (ver tabela 30 -->
        <name> </name> 
        <size>4</size> 
        <type>S</type> 
    </field> 
    <field> 
    <!-- chave de acesso para consultar a 2a opcao se necessario -->
        <name> </name> 
        <size>21</size> 
        <type>S</type> 
    </field> 
  
    <field> 
    <!-- codigo da 3a opcao para consultar outro produto, feature ou base (ver tabela 30 -->
        <name> </name> 
        <size>4</size> 
        <type>S</type> 
    </field> 
    <field> 
    <!-- chave de acesso para consultar a 3a opcao se necessario -->
        <name> </name> 
        <size>21</size> 
        <type>S</type> 
    </field> 
  
    <field> 
    <!-- codigo da 4a opcao para consultar outro produto, feature ou base (ver tabela 30 -->
        <name> </name> 
        <size>4</size> 
        <type>S</type> 
    </field> 
    <field> 
    <!-- chave de acesso para consultar a 4a opcao se necessario -->
        <name> </name> 
        <size>21</size> 
        <type>S</type> 
    </field> 
  
    <field> 
    <!-- filler de COMPLEMENTO do registro P002 -->
        <name> </name> 
        <size>11</size> 
        <type>S</type> 
    </field> 
</serasapj>

  

  • Arquivo layout_p006.xml - Opções de consulta do Cadastro Sintético. 

...

  • Para o preenchimento da HashMap de entrada, é imprescindivel entender é imprescindível entender layout B49C e, devem conter as seguintes chaves de entrada (UPPERCASE); cada campo contém os seguintes dados, sendo eles validados pelo Compilador:
    1. ‘description‘ – propriedade da tag “field”, contem a descrição do campo
    2. ‘type‘ – propriedade da tag “field”, define o tipo de dado Pure Java, como StringIntegerDoubleDate e Boolean.
    3. ‘format‘ – propriedade da tag “field”, contem o formato do dado; atualmente, só os dados de datas tem esse campo preenchido.
    4. ‘field‘ – tag relativa ao nome do campo, escrito em maiúsculas (não necessariamente), como por ex. ‘TPRESPOSTA‘.

...

  • Exemplo ‘com‘ um contador… observe que ‘counter=R104_NUMRELAT‘ indica quantos registros, se existirem, ‘R104‘ foram retornados pelo SERASA. 
Bloco de código
languagehtml/xml
<!-- Obs.: quando counter=alguma_coisa, entao todo o bloco       --> 
<!-- abaixo sofrerah um looping baseado nesse counter            --> 
<saida id="R104" counter="R104_NUMRELAT" >
    <register description="Data da Fundação" type="Date" format="yyyymmdd">R104_DATAFUNDACAO_</register>
    <register description="Data do CNPJ" type="Date" format="yyyymmdd">R104_DATACNPJ_</register>
    <register description="Número de Filiais" type="String" format="">R104_NUMEROFILIAIS_</register>
    <register description="Código SERASA" type="String" format="">R104_CODIGOSERASA_</register>
</saida>

  

...

Bloco de código
languagehtml/xml
<saida id="R203" counter="" > 
     <register description="Descrição do Período" type="String" format="">R203_DESCREG</register> 
     <register description="Quantidade do período" type="String" format="">R203_QTDPERIODO</register> 
     <register description="Percentual do Período" type="String" format="">R203_PERPERIODO</register> 
</saida>

  

Dica
TODOS os registros seguem a mesma lógica e, o ’XML completo com todos os registros do acesso’, importado pelo Compilador, pode ser baixado aqui.

 

Registros Disponíveis
 
  • Registro R102 – Relato Endereços
  • Registro R103 – Relato Localização
  • Registro R104 – Relato Atividade
  • Registro R105 – Relato Filiais
  • Registro R107 – Relato Controle Societário (Atualização e Capital Social)
  • R108 – Relato Controle Societário (Detalhes dos Sociosdos Sócios)
  • Registro R109 – Relato Quadro Administrativo (atualização)
  • Registro R110 – Relato Quadro Administrativo (detalhes)
  • Registro R111 – Relato quadro administrativo (Detalhes cont.)
  • Registro R114 – Relato Participações (Detalhes Participantes)
  • Registro R115 – Relato Participações (Detalhes Participantes continuação)
  • Registro R202 – Relato Potencial de Negócios
  • Registro R203 – Relato Histórico de Pagamento
  • Registro R301 – Relato Controle de Consultas Passagem
  • Registro R302 – Relato Últimas Consultas
  • Registro R381 – Grafias
  • Registro R401 – RELATO – RiskScoring (12 meses)
  • Registro R412 – RELATO – Informações do Concentre – Resumo
    1. n = ‘R412_NUMOCORR‘ – contator do número de ocorrências do Concentre
Dica

 A variável abaixo deverá ser preenchida com total valor, somente se a discriminação for ’PROTESTO’; caso contrário, virá ’zerado’.virá ’zera

 

  1. R412_TOTALVALOR_n‘

...

  1. n
Marcados com: acessos, plugins, relato, serasa, serasa relato
Publicado em Acessos

...