Page tree

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.

  

Informações Gerais

 

Especificação

Produto

Microsiga Protheus

Módulo

SIGAFIN

Segmento Executor

Serviços & Jurídico

Projeto

M_SER_CTR010

IRM

PCREQ-3780

Requisito

PCREQ-8545

Subtarefa

M_CTR010-777

Release de Entrega Planejada

12.1.9

Réplica

 

País

( x ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

 


Objetivo

Disponibilizar o layout FAC Boleto para envio de arquivo ao SERASA que contém os dados de boleto dos títulos contidos no lote SERASA e a gravação de lote SERASA de boleto. 

Definição da Regra de Negócio

Atualmente a rotina de Processos SERASA gera lotes para envio ao SERASA que contemplam o layout FAC Simples. Este layout foi construído no MILE para que seja gerado o arquivo de envio ao SERASA de cada lote gerado, com base no modelo de dados existente na rotina de Processos SERASA. Os lotes gerados para envio de arquivo no layout FAC Boleto deverão gravar na tabela FW8 uma informação para identificação do lote, como sendo um lote de títulos com boleto e o modelo de dados deverá conter uma estrutura adicional para que sejam contemplados mais dois canais de envio, baseados na tabela FW9.

 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

FINA770 – Processos SERASA

Alteração

Atualizações -> Contas a Receber-> SERASA - Processos

-

FINA770AAlteraçãoNão se aplica-


Estrutura do arquivo de layout FAC Simples x FAC Boleto

Abaixo o comparativo das estruturas dos arquivos FAC Simples e FAC Boleto:

FAC SimplesFAC Boleto
Registro 0 - HeaderRegistro 0 - Header
Registro 1 - DetalhesRegistro 1 - Detalhes
-Registro 2 - Dados para emissão do boleto
-Registro 3 - Instruções do boleto
Registro 9 - TraillerRegistro 9 - Trailler


Estrutura do modelo de dados e canais MILE

A estrutura do modelo de dados atual da rotina de Processos SERASA, correspondente ao layout FAC Simples, é utilizada da seguinte maneira:

Canal/ModelRegistro
Canal MASTERFW8/MASTERFW8Registro 0 - Header
Canal TITULOFW9/TITULOFW9Registro 1 - Detalhe
Canal VIRTUAL/VIRTUALRegistro 9 - Trailler

Para o layout FAC Boleto, a estrutura do modelo deverá contemplar os models abaixo:

Canal/ModelRegistro
Canal MASTERFW8/MASTERFW8Registro 0 - Header
Canal TITULOFW9/TITULOFW9Registro 1 - Detalhe
Canal TITAUX1/TITAUX1Registro 2 - Dados para emissão do boleto
Canal TITAUX2/TITAUX2Registro 3 - Instruções do boleto
Canal VIRTUAL/VIRTUALRegistro 9 - Trailler

O modelo de dados MVC da rotina de Processos SERASA conta com a estrutura a seguir (seguindo a hierarquia):

  • MASTERFW8 - Tabela FW8
    • TITULOFW9 - Tabela FW9
      • SITTITFWA - Tabela FWA
      • MOVTITFWB - Tabela FWB
    • VIRTUAL - Tabela FW8
    • CONTADOR - Contador e totalizador da tabela FW9 (não deve ser utilizado no MILE)

Para que seja possível gerar, através do MILE, o arquivo no layout FAC Boleto, o modelo de dados deverá conter a seguinte estrutura*:

  • MASTERFW8 - Tabela FW8
    • TITULOFW9 - Tabela FW9
      • SITTITFWA - Tabela FWA
      • MOVTITFWB - Tabela FWB
    • TITAUX1 - Tabela FW9**
    • TITAUX2 - Tabela FW8**
    • VIRTUAL - Tabela FW8
    • CONTADOR - Contador e totalizador da tabela FW9 (não deve ser utilizado no MILE)

*A construção dos models deve respeitar a sequencia acima dentro da ModelDef(), caso contrário, a inserção das linhas no arquivo será feita de forma incorreta.

**Ambos os models auxiliares não devem ser habilitados para que sejam gravados na inclusão, alteração ou exclusão do lote, pois serão utilizados apenas como referência para geração do arquivo através do MILE.

Para cada linha da tabela FW9 (título), uma linha correspondente será inserida no arquivo. Os lotes gerados de títulos com boleto serão preenchidos com uma linha de detalhe de cada título, uma linha com os dados de emissão do boleto para cada título contido no lote e, caso necessário, uma linha com as instruções do boleto deve ser inserido no arquivo.


Estrutura do layout FAC Boleto

A estrutura do layout FAC Boleto é muito parecida com a estrutura do FAC Simples, sendo que as grandes diferenças entre os layouts é que no FAC Boleto existem os registros "2" e "3". A construção dos registros "0" e "1" são muito semelhantes as do FAC Simples, havendo a inserção de um ou outro dado complementar, conforme detalhado abaixo:

Registro "0" - Header

Sequência

Início

Tamanho

Tipo

Descrição

Preenchimento

01

001

001

C

Código do registro

 "0"

02

002

009

C

CNPJ da instituição informante

SM0->M0_CGC

03

011

008 

Data do movimento

dDataBase

04

019

004

Brancos

Space(4)

05 

023

008 

Brancos

Space(8)
06031004CBrancosSpace(4)
07035070CBrancosSpace(70)
08105015CIdentificação do arquivo"SERASA-CONVEM04"
09120006CNúmero da remessaF770GETARQ()
10126001C

Código de envio do arquivo:

"E" - Entrada

"R" - Retorno

"E"
11127004CBrancosSpace(4)
12131011CBrancosSpace(11)

13

142012CFilial do arquivoFW8->FW8_FILIAL
14154001CIdentificador FAC Boleto"B"
15155379CBrancosSpace(379)
16534060CBrancosSpace(60)
17594007CSequencial do registro no arquivoF770SEQREG()


Registro "1" - Detalhes

 

Sequência

Início

Tamanho

Tipo

Descrição

Preenchimento

01

001

001

C

Código do registro

 "1"

02

002

001

C

Código da Operação

I - Inclusão

E - Exclusão

FA770GETOP() 

03

003

006 

Brancos

Space(6) 

04

009

008

Data da ocorrência ( AAAAMMDD) – data do vencimento da dívida, não superior a 4 anos e 11 meses.                                        

F770VENCTO() 

05 

017 

008 

Data do término do contrato – formato “AAAAMMDD” . Caso não possua , repetir a data da ocorrência  (vide observação 1 para natureza  “DC”)

F770VENCTO() 

06 

025 

003 

C

Código de natureza da operação

FW9_TIPO 

07 

028 

004 

C

Brancos

Space(4) 

08

032

001

C

Tipo de pessoa do principal:

F – Física             

ou

J – Jurídica

F770CLIENT(1) 

09

033

001

C

Tipo do primeiro docto. do principal:

1 – CNPJ

ou

2 – CPF

F770BTip() 

10

034

015

C

Primeiro documento do principal:

CPF completo   à base + dígito ou

CNPJ completo à base + filial + dígito

Ajustado à direita e preenchido com zeros à esquerda

F770CLIENT(2) 

11

049

002

C

Brancos

Space(2) 

12 

051 

001 

C

Branco

Space(1) 

13 

052 

015 

C

Brancos

Space(15) 

14 

067 

002 

UF quando documento for RG, se não, espaços.

F770BEst() 
15069001C

Branco

Space(1)
16070001C

Branco           

Space(1)
17071015C

Brancos

Space(15)
18086002CBrancosSpace(2)
19088001CBranco

 

Space(1)
20089015CBrancosSpace(15)
21104002CBrancosSpace(2)
22106070CBrancosSpace(70)
23176008CBrancosSpace(8)
24184070CBrancosSpace(70)
25254070CBrancosSpace(70)
26324045CEndereço completoF770CLIENT(3)
27369020CBairro correspondenteF770CLIENT(4)
28389025CMunicípio correspondenteF770CLIENT(5)
29414002CUFF770CLIENT(6)
30416008CCEPF770CLIENT(7)
31424015CValorF770VALTIT()
32439050CChave do títuloFW9->(FW9_FILORI+FW9_PREFIX+FW9_NUM+FW9_PARCEL)
33489004CDDD do devedorF770CLIENT(8)
34493009CNúmero do telefone do devedorF770CLIENT(9)
35502008CData do compromisso assumido pelo devedorF770VENCTO()
36510015CValor total do compromisso assumido pelo devedorF770VALTIT()
37525006CBrancosSpace(7)
38531001C

Indicativo do Tipo de Comunicado ao Devedor:

B - Comunicado com Boleto Bancário

"B"
39532002CBrancosSpace(2)
40534060CBrancosSpace(60)
41594007CSequencia do registro no arquivo

F770SEQREG()

 

Registro "2" - Emissão do boleto

Sequência

Início

Tamanho

Tipo

Descrição

Preenchimento

01

001

001

C

Código do registro

 "2"

02

002

003

C

Código do banco

F770BANCO(1)

03

005

001

C

Dígito do banco

F770Banco(2)

04

006

015

C

Nome do banco

F770Banco(3)

05 

021

005

C

Primeiro campo da linha digitável

F770LinDig(1)*

06 

026

005

C

Segundo campo da linha digitável

F770LinDig(1)*

07 

031

005

C

Terceiro campo da linha digitável

F770LinDig(1)*

08

036

006

C

Quarto campo da linha digitável

F770LinDig(1)*

09

042

005

C

Quinto campo da linha digitável

F770LinDig(1)*
10047006CSexto campo da linha digitávelF770LinDig(1)*
11053001CSétimo campo da linha digitávelF770LinDig(1)*
12054014COitavo campo da linha digitávelF770LinDig(1)*
13068070C

Texto lo local de pagamento

Ex.: "Pagável em qualquer banco até o vencimento"

GetMV(MV_TXTLPAG)
14138070CBrancosSpace(70)
15208008CData do vencimento do boleto (se enviado em branco, será gerado o boleto com a informação "CONTRA APRESENTAÇÃO")F770Vencto("TITAUX1")
16216001C

Tipo de pessoa do cedente:

"F" - Física

"J" - Jurídica

F770CLIENT(1,"TITAUX1")
17217001C

Tipo do documento do cedente:

"1" - CNPJ

"2" - CPF

SM0->M0_TPINSC
18218015C

Documento do cedente:

CPF completo (base mais dígito)

CNPJ completo (base mais filial mais dígito)

Ajustado à direito e preenchido com zeros à esquerda. Obs.: Caso não informado será atribuído o CNPJ mais filial da Instituição Informante

SM0->M0_CGC
19233040C

Nome do cedente do título

Obs.: Caso não informado, será atribuído a razão social da Instituição Informante

SM0->M0_NOMECOM
20273025CCódigo e dígito da agência mais Código e dígito do cedenteF770Banco(5)
21298008CData do documentoF770Titulo(1)
22306025CNúmero do documentoFW9_NUM
23331005CTipo do documentoFW9_TIPO
24336003CBrancosSpace(3)
25339017CBrancosSpace(17)
26356003CBrancosSpace(3)
27359008CData de processamentodDataBase
28367025CNosso númeroF770Titulo(2)**
29392005CNúmero da carteiraF770Banco(4)***
30397003CEspécie de moedaF770Titulo(3)
31400009CBrancosSpace(9)
32409001CBrancoSpace(1)
33410009CBrancosSpace(9)
34419015CValor do boletoF770VALTIT("TITAUX1")
35434015CValor do desconto, se houverF770Titulo(4)
36449015CValor de outras deduções, se houverF770Titulo(5)
37464015CValor da mora ou multa, se houverF770Titulo(6)
38479015CValor de outros acréscimos, se houverF770Titulo(7)
39494015CValor total a ser cobradoF770ValTot()
40509001C

Tipo de pessoa do sacador:

"F" - Física

"J" - Jurídica

F770CLIENT(1,"TITAUX1")
41510001C

Tipo do primeiro documento do sacador:

"1" - CNPJ

"2" - CPF

F770BTip("TITAUX1")
42511015C

Documento do sacador:

CPF completo (base mais dígito)

CNPJ completo (base mais filial mais dígito)

Ajustado à direito e preenchido com zeros à esquerda. Obs.: Caso não informado será atribuído o CNPJ mais filial da Instituição Informante

F770CLIENT(2,"TITAUX1")
43526050CNome do Sacador / AvalistaF770Client(10,"TITAUX1")
44576018CBrancosSpace(18)
45594007CSequencia do registro no arquivoF770SEQREG()

*A função para retornar os dados da Linha Digitável obterá os dados do campo E1_CODDIG, ficando a cargo do cliente o preenchimento por meio de customização.

**A função para retornar os dados do Nosso Número obterá os dados do campo E1_NUMBCO ficando a cargo do cliente o preenchimento por meio de customização.

***O código da carteira deverá ser específico para cada banco, havendo a necessidade de retornar o código da carteira conforme o banco informado (campo A6_CARTEIR). 

 

Registro "3" - Dados do boleto

Sequência

Início

Tamanho

Tipo

Descrição

Preenchimento

01

001

001

C

Código do registro

"3"

02

002

070

C

Linha de instrução - 1

GetMV(MV_INSBOL1)

03

072

070

C

Linha de instrução - 2

GetMV(MV_INSBOL2)

04

142

070

C

Linha de instrução - 3

GetMV(MV_INSBOL3)

05 

212

070

C

Linha de instrução - 4

GetMV(MV_INSBOL4)

06 

282

070

C

Linha de instrução - 5

GetMV(MV_INSBOL5)

07 

352

070

C

Linha de instrução - 6

GetMV(MV_INSBOL6)

08

422

070

C

Linha de instrução - 7

GetMV(MV_INSBOL7)
09492070CLinha de instrução - 8GetMV(MV_INSBOL8)
10562032CBrancosSpace(32)
11594007CSequencia do registro no arquivoF770SEQREG()


Registro "9" - Trailler

Sequência

Início

Tamanho

Tipo

Descrição

Preenchimento

01

001

001

C

Código do registro

 "9"

02

002

001

C

Branco

Space(1)

03

003

591

C

Brancos

Space(591)

04

594

007

C

Sequencia do registro no arquivo

F770SEQREG()



Geração de Lotes do tipo FAC Boleto

Na geração do lote, deverá ser exibida uma pergunta adicional nos parâmetros, que permita ao usuário selecionar se aquele lote a ser gerado será um lote normal ou um lote de boletos. Caso seja selecionada a opção de lote de boletos, deverá ser apresentado ao usuário a relação dos títulos contendo apenas os títulos que possuem boleto. Para isso, a query de seleção deverá ser complementada para que retorne esses títulos quando selecionado a opção de lote de boleto.

Ao confirmar a gravação do lote de boleto, o campo FW8_TPFAC deverá ser gravado com o valor "B", que representa que o lote em questão é do tipo boleto. A gravação desse campo permitirá que o processamento do arquivo seja feito de corretamento quando o lote do tipo boleto.

 

Geração do arquivo de entrada no layout FAC Boleto

Deverá ser incluída no menudef do FINA770 uma opção exclusiva para a geração de arquivo de lotes FAC Boleto. A chamada deverá ser igual a que é feita para a função F770Export, que é a função responsável pela geração do FAC Simples. 

 

Identificador do layout FAC Boleto no MILE

O layout do FAC Boleto no MILE deverá ser identificado como "SERA_FAC" no MILE, assim, quando for chamado pela função de exportação de FAC Boleto, não haverá ambiguidade com relação ao layout FAC Simples "SERA_ENV".



Tabelas Utilizadas

  • FW8 – Cadastro de Contas a Pagar
  • FW9  Detalhes do Lote Serasa

Dicionário de Dados

 

Arquivo ou Código do Script: FW8 – Cabeçalho de lotes SERASA

  

Campo

FW8_TPFAC

Tipo

Caractere

Tamanho

1

Mandatório

Sim (  ) Não ( x )

Descrição

Identificador do tipo FAC (Boleto ou Simples)

Título

Tipo FAC

Picture

@!

Help de Campo

Caso o campo esteja preenchido com "B", trata-se de um lote do tipo FAC Boleto, caso esteja em branco, o lote será do tipo FAC Simples. 


Arquivo ou Código do Script: SA6 – Bancos

Campo

A6_DVBCO

Tipo

Caractere

Tamanho

1

Mandatório

Sim (  ) Não ( x )

Descrição

Digito Verific. Banco

Título

DV Banco

Picture

@!

Help de Campo

Informe o dígito verificador do código do banco

Grupo de Perguntas

Nome: FINA770

X1_ORDEM

13

X1_PERGUNT

Lote FAC Boleto

X1_TIPO

C

X1_TAMANHO

1

X1_GSC

C

X1_VAR01

MV_PAR13

X1_PRESEL

2

X1_DEF01

1=Sim

X1_DEF022=Não

X1_HELP

Se sim, serão apresentados apenas títulos com boleto para geração de um lote do tipo FAC Boleto. Caso contrário, será gerado o lote normal.

 

 

Nome: FIN770EXPB

X1_ORDEM

01

X1_PERGUNT

Filial

X1_TIPO

C

X1_TAMANHO

8

X1_GSC

G

X1_VAR01

MV_PAR01

X1_GRPSXG

033

X1_F3

SM0

X1_HELP

Selecione a filial do lote que será considerado para a geração do arquivo de envio SERASA.

X1_ORDEM

02

X1_PERGUNT

Lote

X1_TIPO

C

X1_TAMANHO

6

X1_GSC

G

X1_VAR01

MV_PAR02

X1_VALID

F770ValSX1(2)

X1_F3

FW8BOL

X1_HELP

Informar o lote que será considerado para geração do arquivo de exportação SERASA. 

X1_ORDEM

03

X1_PERGUNT

Nome do arquivo

X1_TIPO

C

X1_TAMANHO

30

X1_GSC

G

X1_VAR01

MV_PAR03

X1_HELP

Preencha o nome que será atribuído ao arquivo. Não é necessário preencher o caminho (pasta) ou extensão do arquivo.

X1_ORDEM

04

X1_PERGUNT

Extensão do arquivo

X1_TIPO

C

X1_TAMANHO

3

X1_GSC

G

X1_VAR01

MV_PAR04

X1_HELP

Preencha a extensão do arquivo.

 

Nome: FIN770EXP

X1_ORDEM

02

X1_PERGUNT

Lote

X1_VALID

F770ValSX1(1)

Consulta Padrão

Consulta: FW8BOL

Descrição

Lotes FAC Boleto

Tipo

Consulta Padrão

Tabela

“FW8”

Índice

“Lote”

Campo

“Código”; ”Data”

FiltroFW8_TPFAC == "B"

Retorno

FW8->FW8_LOTE

 

 

Consulta: FW8

Filtro

FW8_TPFAC == " "

Parâmetros

MV_INSBOL1

X6_VARMV_INSBOL1
X6_DESCRIC1ª Linha de instrução para Boleto
X6_TIPOCaracter
X6_PROPRISim
X6_PYMESim

 

MV_INSBOL2

X6_VARMV_INSBOL2
X6_DESCRIC2ª Linha de instrução para Boleto
X6_TIPOCaracter
X6_PROPRISim
X6_PYMESim

 

MV_INSBOL3

X6_VARMV_INSBOL3
X6_DESCRIC3ª Linha de instrução para Boleto
X6_TIPOCaracter
X6_PROPRISim
X6_PYMESim

 

MV_INSBOL4

X6_VARMV_INSBOL4
X6_DESCRIC4ª Linha de instrução para Boleto
X6_TIPOCaracter
X6_PROPRISim
X6_PYMESim

 

MV_INSBOL5

X6_VARMV_INSBOL5
X6_DESCRIC5ª Linha de instrução para Boleto
X6_TIPOCaracter
X6_PROPRISim
X6_PYMESim

 

MV_INSBOL6

X6_VARMV_INSBOL6
X6_DESCRIC6ª Linha de instrução para Boleto
X6_TIPOCaracter
X6_PROPRISim
X6_PYMESim

 

MV_INSBOL7

X6_VARMV_INSBOL7
X6_DESCRIC7ª Linha de instrução para Boleto
X6_TIPOCaracter
X6_PROPRISim
X6_PYMESim

 

MV_INSBOL8

X6_VARMV_INSBOL8
X6_DESCRIC8ª Linha de instrução para Boleto
X6_TIPOCaracter
X6_PROPRISim
X6_PYMESim

 

MV_TXTLPAG

X6_VARMV_TXTLPAG
X6_DESCRICTexto do local de pagamento para Boleto
X6_TIPOCaracter
X6_PROPRISim
X6_PYMESim

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.