Para utilização do envio e recebimento de arquivos SERASA, deve-se importar os layouts MILE serasa_layout_envio.xml e serasa_layout_retorno.xml, disponibilizados junto com o release 12.1.6.
Após a importação dos layouts no MILE (MILE: Model Integrator Layout Engine), estes podem ser modificados, de forma a atender alguma customização ou particularidade do ambiente. Para importa-los é necessário realizar os procedimentos abaixo:
Observação: A nomenclatura dos layouts, SERA_ENV (envio) e SERA_RET (retorno) são padrão para uso no protheus e não podem ser alterados.
Na alteração dos layouts é possível alterar as posiões de captura de dados, a ordem. Contudo, os segmentos pré-definidos no layout importado devem ser mantidos, para que os arquivos sejam gerados e lidos corretamente.
Estrutura do layout de envio SERASA
Este layout é utilizado pela rotina de processos SERASA (FINA770) que está disponível no Financeiro (SIGAFIN) em Atualizações/Contas a Receber/ SERASA - Processos.
Observação: a geração do arquivo de envio somente é possível caso existam lotes de envio gerados, também por meio da rotina de processos SERASA (FINA770).
Para gerar o arquivo de envio, na janela da rotina de processos SERASA, selecione e a opção Exportar lote. Para efetuar o processamento do arquivo de retorno SERASA, na janela da rotina de processos SERASA, selecione a opção Arquivo de retorno.
Estrutura do layout SERASA
O layout de envio SERASA possui a seguinte estrutura:
Header:
Campo | Início | Fim | Tamanho | Conteúdo |
---|---|---|---|---|
Código do Registro | 001 | 001 | 001 | '0' |
CNPJ | 002 | 010 | 009 | SM0->M0_CGC |
Data do Movimento | 011 | 018 | 008 | DtoS(dDataBase) |
DDD | 019 | 022 | 004 | A ser definido pelo usuário |
Telefone de contato | 023 | 030 | 008 | A ser definido pelo usuário |
Ramal telefone contato | 031 | 034 | 004 | A ser definido pelo usuário |
Nome do contato | 035 | 104 | 070 | A ser definido pelo usuário |
ID arquivo fixo | 105 | 119 | 015 | "SERASA-CONVEM04" |
Número da remessa | 120 | 125 | 006 | F770GetArq() |
Código envio de arquivo | 126 | 126 | 001 | "E" |
Diferencial de remessa | 127 | 130 | 004 | Space(4) |
Brancos | 131 | 533 | 403 | Space(403) |
Código de erros | 534 | 593 | 060 | Space(60) |
Sequência de registro | 594 | 600 | 007 | F770SeqReg() |
Detail:
Campo | Início | Fim | Tamanho | Conteúdo |
---|---|---|---|---|
Tipo Registro | 001 | 001 | 001 | "1" |
Código Operação | 002 | 002 | 001 | Fa770GetOp() |
Filial/Dígito Contratante | 003 | 008 | 006 | Configurável pelo usuário com as informações do CNPJ do contratante do serviço do Serasa |
Data Ocorrência | 009 | 018 | 008 | F770Vencto() |
Data Término Contrato | 017 | 024 | 008 | F770Vencto() |
Código Natureza Operação | 025 | 027 | 003 | FW9_TIPO |
Código Praça Embratel | 028 | 031 | 004 | SPACE(4) |
Tipo Pessoa | 032 | 032 | 001 | F770Client(1) |
Tipo Primeiro Documento | 033 | 033 | 001 | F770BTip() |
Primeiro Documento | 034 | 048 | 015 | F770Client(2) |
Motivo Baixa | 049 | 050 | 002 | SPACE(2) |
Tipo Segundo Documento | 051 | 051 | 001 | SPACE(1) |
Segundo Documento | 052 | 056 | 015 | SPACE(15) |
UF Documento | 067 | 068 | 002 | F770BEst() |
Coobrigado | 069 | 069 | 001 | SPACE(1) |
Tipo Documento Coobrigado | 070 | 070 | 001 | SPACE(1) |
Primeiro Documento Coobrigado | 071 | 085 | 015 | SPACE(15) |
Brancos | 086 | 087 | 002 | SPACE(2) |
Tipo Segundo Documento Coobrigado | 088 | 088 | 001 | SPACE(1) |
Segundo Documento Coobrigado | 089 | 103 | 015 | SPACE(15) |
UF Documento | 104 | 105 | 002 | SPACE(2) |
Nome Devedor Coobrigado | 106 | 175 | 070 | SPACE(70) |
Data Nascimento | 176 | 183 | 008 | SPACE(8) |
Nome Pai | 184 | 253 | 070 | SPACE(70) |
Nome Mãe | 254 | 323 | 070 | SPACE(70) |
Endereço Completo | 324 | 368 | 045 | F770Client(3) |
Bairro Correspondente | 369 | 105 | 020 | F770Client(4) |
Município Correspondente | 389 | 175 | 025 | F770Client(5) |
UF Cobrança | 414 | 415 | 002 | F770Client(6) |
CEP Cobrança | 416 | 423 | 008 | F770Client(7) |
Valor | 424 | 438 | 015 | F770ValTit() |
Identificação do Titulo enviado | 439 | 454 | 025 | FW9->FW9_IDTITU |
Brancos | 455 | 488 | 034 | SPACE(34) |
DDD Devedor | 489 | 492 | 004 | F770Client(8) |
Telefone Devedor | 493 | 501 | 009 | F770Client(9) |
Data Compromisso | 502 | 509 | 008 | F770Vencto() |
Valor Compromisso | 510 | 524 | 015 | F770ValTit() |
Brancos | 525 | 533 | 009 | SPACE(9) |
Códigos Erro | 534 | 593 | 060 | SPACE(60) |
Sequência Registro | 594 | 600 | 007 | F770SEQREG() |
Trailer:
Campo | Início | Fim | Tamanho | Conteúdo |
---|---|---|---|---|
Tipo registro | 001 | 001 | 001 | "9" |
Brancos | 002 | 002 | 001 | Space(1) |
Códigos erros | 003 | 008 | 006 | Space(6) |
Sequência registro | 594 | 600 | 007 | F770SeqReg() |
O layout de retorno SERASA possui a seguinte estrutura:
Campo | Início | Fim | Tamanho | Variável* |
---|---|---|---|---|
Tipo registro | 001 | 001 | 001 | TP_REG |
Lote | 120 | 125 | 006 | CD_LOTE |
Tipo arquivo | 126 | 126 | 001 | TP_ARQ |
Operação | 002 | 002 | 001 | CD_OPER |
Tipo operação | 025 | 027 | 003 | TP_OPER |
Cliente | 034 | 048 | 015 | CD_CLIENTE |
Valor | 424 | 438 | 015 | VL_SERASA |
Id do Título | 439 | 454 | 016 | ID_TIT |
Erro | 534 | 593 | 060 | CD_ERRO |
*Cada variável corresponde ao campo definido no layout de retorno. Caso o layout de retorno seja customizado, esses campos devem ser mantidos, apenas novos campos podem ser inseridos no layout.
**As variáveis são alimentadas a cada linha lida do arquivo. Para identificar se a linha corresponde ao Header, Detail ou Trailer do arquivo, valide o conteúdo da variável TP_REG, sendo: "0" = Header; "1" = Detail; "9" = Trailer.