Histórico da Página
Atenção: A implementação dos layouts SERASA de envio e retorno está disponível somente para a versão 12 do Protheus,
aa partir do release 12.1.6.
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, os mesmos poderão : Model Integrator Layout Engine), estes podem ser modificados, de forma a atender alguma customização ou particularidade do ambiente do usuário. Para importar os layouts no MILE, basta serem adotados . Para importa-los é necessário realizar os procedimentos abaixo:
Ao selecionar a opção "Importar" dentro do MILE (no SIGACFG, acessar o menu Ambiente > Aceleradores > Mile > Layouts), será exibida
- No Configurador (SIGACFG) acesse Ambiente > Workflow > Layouts
- Selecione a opção Importar.
- É exibida a tela para seleção do caminho
- do arquivo
- do layout MILE para importação.
Efetuar
- Efetue o procedimento para cada arquivo de layout separadamente
- .
- Ao final confirme a importação dos layouts SERA_ENV e SERA_RET.
- Ao importá-los é possível realizar a alteração.
Observação: A Uma vez os layouts importados, os mesmos poderão ser alterados. 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 poderão ser alteradas as posições é possível alterar as posiões de captura dos de dados, a ordem e etc. Contudo 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
Estrutura do layout de retorno SERASA
Após a importação e, caso seja opção do usuário, customização dos layouts, ambos serão utilizados Este layout é utilizado pela rotina de processos SERASA (FINA770), que está disponível no menu do SIGAFIN, na entrada Atualizações > Financeiro (SIGAFIN) em Atualizações/Contas a Receber > / SERASA - Processos.
Observação: a geração do arquivo de envio só somente é possível quando existirem caso existam lotes de envio gerados, também através da também por meio da rotina de processos SERASA (FINA770).
Para gerar o arquivo de envio, na janela da rotina de processos SERASA, deve-se utilizar selecione e a opção Exportar lote. Para efetuar o processamento do arquivo de retorno SERASA, na janela da rotina de processos SERASA, deve-se utilizar 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, validar valide o conteúdo da variável TP_REG, sendo: "0" = Header; "1" = Detail; "9" = Trailer.





