Histórico da Página
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 | XXXXX-XXXX | 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 | - |
Estrutura do arquivo de layout FAC Simples x FAC Boleto
Abaixo o comparativo das estruturas dos arquivos FAC Simples e FAC Boleto:
FAC Simples | FAC Boleto |
---|---|
Registro 0 - Header | Registro 0 - Header |
Registro 1 - Detalhes | Registro 1 - Detalhes |
- | Registro 2 - Dados para emissão do boleto |
- | Registro 3 - Instruções do boleto |
Registro 9 - Trailler | Registro 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/Model | Registro |
---|---|
Canal MASTERFW8/MASTERFW8 | Registro 0 - Header |
Canal TITULOFW9/TITULOFW9 | Registro 1 - Detalhe |
Canal VIRTUAL/VIRTUAL | Registro 9 - Trailler |
Para o layout FAC Boleto, a estrutura do modelo deverá contemplar os models abaixo:
Canal/Model | Registro |
---|---|
Canal MASTERFW8/MASTERFW8 | Registro 0 - Header |
Canal TITULOFW9/TITULOFW9 | Registro 1 - Detalhe |
Canal TITAUX1/TITAUX1 | Registro 2 - Dados para emissão do boleto |
Canal TITAUX2/TITAUX2 | Registro 3 - Instruções do boleto |
Canal VIRTUAL/VIRTUAL | Registro 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)
- TITULOFW9 - Tabela FW9
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)
- TITULOFW9 - Tabela FW9
**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 = '1' - detalhes | "0" |
02 | 002 | 009 | C | CNPJ da instituição informante | SM0->M0_CGC |
03 | 011 | 008 | C | Data do movimento | dDataBase |
04 | 019 | 004 | C | Brancos | Space(4) |
05 | 023 | 008 | C | Brancos | Space(8) |
06 | 031 | 004 | C | Brancos | Space(4) |
07 | 035 | 070 | C | Brancos | Space(70) |
08 | 105 | 015 | C | Identificação do arquivo | "SERASA-CONVEM04" |
09 | 120 | 006 | C | Número da remessa | F770GETARQ() |
10 | 126 | 001 | C | Código de envio do arquivo: "E" - Entrada "R" - Retorno | "E" |
11 | 127 | 004 | C | Brancos | Space(4) |
12 | 131 | 011 | C | Brancos | Space(11) |
13 | 142 | 012 | C | Filial do arquivo | FW8->FW8_FILIAL |
14 | 154 | 001 | C | Identificador FAC Boleto | "B" |
15 | 155 | 379 | C | Brancos | Space(379) |
16 | 534 | 060 | C | Brancos | Space(60) |
17 | 594 | 007 | C | Sequencial do registro no arquivo | F770SEQREG() |
Registro "1" - Detalhes
Sequência | Início | Tamanho | Tipo | Descrição | Preenchimento |
01 | 001 | 001 | C | Código do registro = '1' - detalhes | "1" |
02 | 002 | 001 | C | Código da Operação I - Inclusão E - Exclusão | FA770GETOP() |
03 | 003 | 006 | C | Brancos | Space(6) |
04 | 009 | 008 | C | Data da ocorrência ( AAAAMMDD) – data do vencimento da dívida, não superior a 4 anos e 11 meses. | F770VENCTO() |
05 | 017 | 008 | C | 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 | C | UF quando documento for RG, se não, espaços. | F770BEst() |
15 | 069 | 001 | C | Branco | Space(1) |
16 | 070 | 001 | C | Branco | Space(1) |
17 | 071 | 015 | C | Brancos | Space(15) |
18 | 086 | 002 | C | Brancos | Space(2) |
19 | 088 | 001 | C | Branco
| Space(1) |
20 | 089 | 015 | C | Brancos | Space(15) |
21 | 104 | 002 | C | Brancos | Space(2) |
22 | 106 | 070 | C | Brancos | Space(70) |
23 | 176 | 008 | C | Brancos | Space(8) |
24 | 184 | 070 | C | Brancos | Space(70) |
25 | 254 | 070 | C | Brancos | Space(70) |
26 | 324 | 045 | C | Endereço completo | F770CLIENT(3) |
27 | 369 | 020 | C | Bairro correspondente | F770CLIENT(4) |
28 | 389 | 025 | C | Município correspondente | F770CLIENT(5) |
29 | 414 | 002 | C | UF | F770CLIENT(6) |
30 | 416 | 008 | C | CEP | F770CLIENT(7) |
31 | 424 | 015 | C | Valor | F770VALTIT() |
32 | 439 | 050 | C | Chave do título | FW9->(FW9_FILORI+FW9_PREFIX+FW9_NUM+FW9_PARCEL) |
33 | 489 | 004 | C | DDD do devedor | F770CLIENT(8) |
34 | 493 | 009 | C | Número do telefone do devedor | F770CLIENT(9) |
35 | 502 | 008 | C | Data do compromisso assumido pelo devedor | F770VENCTO() |
36 | 510 | 015 | C | Valor total do compromisso assumido pelo devedor | F770VALTIT() |
37 | 525 | 006 | C | Brancos | Space(7) |
38 | 531 | 001 | C | Indicativo do Tipo de Comunicado ao Devedor: B - Comunicado com Boleto Bancário | "B" |
39 | 532 | 002 | C | Brancos | Space(2) |
40 | 534 | 060 | C | Brancos | Space(60) |
41 | 594 | 007 | C | Sequencia do registro no arquivo | F770SEQREG() |
Registro "2" - Dados do boleto
Sequência | Início | Tamanho | Tipo | Descrição | Preenchimento |
01 | 001 | 001 | C | Código do registro = '1' - detalhes | "1" |
02 | 002 | 001 | C | Código da Operação I - Inclusão E - Exclusão | FA770GETOP() |
03 | 003 | 006 | C | Brancos | Space(6) |
04 | 009 | 008 | C | Data da ocorrência ( AAAAMMDD) – data do vencimento da dívida, não superior a 4 anos e 11 meses. | F770VENCTO() |
05 | 017 | 008 | C | 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() |
Tabelas Utilizadas
- FW8 – Cadastro de Contas a Pagar
Registro "1" - Detalhes
Sequência | Início | Tamanho | Tipo | Descrição | Preenchimento |
01 | 001 | 001 | C | Código do registro = '1' - detalhes | "1" |
02 | 002 | 001 | C | Código da Operação I - Inclusão E - Exclusão | FA770GETOP() |
03 | 003 | 006 | C | Brancos | Space(6) |
04 | 009 | 008 | C | Data da ocorrência ( AAAAMMDD) – data do vencimento da dívida, não superior a 4 anos e 11 meses. | F770VENCTO() |
05 | 017 | 008 | C | 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) |
Registro "1" - Detalhes
Sequência
Início
Tamanho
Tipo
Descrição
Preenchimento
01
001
001
C
Código do registro = '1' - detalhes
02
002
001
C
Código da Operação
I - Inclusão
E - Exclusão
03
003
006
C
Brancos
04
009
008
C
Data da ocorrência ( AAAAMMDD) – data do vencimento da dívida, não superior a 4 anos e 11 meses.
05
017
008
C
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”)
06
025
003
C
Código de natureza da operação
07
028
004
C
Brancos
08
032
001
C
Tipo de pessoa do principal:
F – Física
ou
J – Jurídica
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. |
Grupo de Perguntas
Nome: FINA770
X1_ORDEM | 11 |
X1_PERGUNT | Lote FAC Boleto |
X1_TIPO | C |
X1_TAMANHO | 1 |
X1_GSC | C |
X1_VAR01 | MV_PAR12 |
X1_PRESEL | 2 |
X1_DEF01 | 1=Sim |
X1_DEF02 | 2=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. |
Consulta Padrão
Consulta: FW8BOL
Descrição | Lotes FAC Boleto |
Tipo | Consulta Específica |
Tabela | “FW8” |
Índice | “Lote” |
Campo | “Código”; ”Descrição” |
Retorno | FW8->FW8_LOTE |
(Opcional)
Estrutura de Menu
<Informações utilizadas na linha Datasul>.
Procedimentos
Procedimento |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Módulo |
|
|
|
Programa base |
|
|
|
Nome Menu | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Registro padrão | Sim | Sim | Sim |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Release de Liberação |
|
|
|
Programas
Programa |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Nome Externo |
|
|
|
Nome Menu/Programa | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Nome Verbalizado[1] | (Max 254 posições) | (Max 254 posições) | (Max 254 posições) |
Procedimento |
|
|
|
Template | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) |
Tipo[2] | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Categoria[3] |
|
|
|
Executa via RPC | Sim/Não | Sim/Não | Sim/Não |
Registro padrão | Sim | Sim | Sim |
Outro Produto | Não | Não | Não |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Query on-line | Sim/Não | Sim/Não | Sim/Não |
Log Exec. | Sim/Não | Sim/Não | Sim/Não |
Rotina (EMS) |
|
|
|
Sub-Rotina (EMS) |
|
|
|
Localização dentro da Sub Rotina (EMS) |
|
|
|
Compact[4] | Sim/Não | Sim/Não | Sim/Não |
Home[5] | Sim/Não | Sim/Não | Sim/Não |
Posição do Portlet[6] | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right |
Informar os papeis com os quais o programa deve ser vinculado |
|
|
|
Cadastro de Papéis
<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.
<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.
Código Papel | (máx 3 posições) |
Descrição em Português* |
|
Descrição em Inglês* |
|
[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.
[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante
[3] Categorias são obrigatórias para os programas FLEX.
[4] Obrigatório quando o projeto for FLEX
[5] Obrigatório quando o projeto for FLEX
[6] Obrigatório quando o projeto for FLEX
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|