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() |
<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento>.
<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.
Exemplo de Aplicação:
- Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
- Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades como a referência mínima para calcular o débito total do aluno.
- Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
- O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.
Tabelas Utilizadas
- SE2 – Cadastro de Contas a Pagar
- FI9 – Controle de Emissão de DARF>.
Seq | Ini | Tam | A XN | ZPB | Descrição |
|
|
|
|
| Registro para emissão de Boleto Bancário |
01 | 001 | 001 | A | Z | Código do registro = ‘2’ (dois) (1) |
02 | 002 | 003 | N | Z | Código do Banco (1) |
03 | 005 | 001 | N | Z | Digito do Banco (1) |
04 | 006 | 015 | A | Z | Nome do Banco (1) |
05 | 021 | 005 | N | Z | Primeiro campo da Linha Digitavel (1) |
06 | 026 | 005 | N | Z | Segundo campo da Linha Digitavel (1) |
07 | 031 | 005 | N | Z | Terceiro campo da Linha Digitavel (1) |
08 | 036 | 006 | N | Z | Quarto campo da Linha Digitavel (1) |
09 | 042 | 005 | N | Z | Quinto campo da Linha Digitavel (1) |
10 | 047 | 006 | N | Z | Sexto campo da Linha Digitavel (1) |
11 | 053 | 001 | N | Z | Sétimo campo da Linha Digitavel (1) |
12 | 054 | 014 | A | Z | Oitavo campo da Linha Digitavel (1) |
13 | 068 | 070 | A | Z | Texto do Local de Pagamento Exemplo: “Pagável em qualquer banco ate o vencimento” (1) |
14 | 138 | 070 | A | Z | Deixar em Branco |
15 | 208 | 008 | N | Z | Data do vencimento do boleto – AAAAMMDD ou Branco(caso queira a expressão “CONTRA APRESENTACAO“ |
16 | 216 | 001 | A | Z | Tipo de pessoa do cedente; Física (F) ou Jurídica( J ) |
17 | 217 | 001 | A | Z | Tipo do primeiro docto. do cedente: 1-CNPJ ou 2-CPF |
18 | 218 | 015 | N | Z | Documento do cedente: CPF completo – base + dígito. CNPJ completo – base + filial + dígito. Ajustado à direita e preenchido com zeros à esquerda Obs.: Caso não informado será atribuído o CNPJ+Filial da Instituição Informante. |
19 | 233 | 040 | A | Z | Nome do cedente do título. Obs.: Caso não informado será atribuído a Razão Social da Instituição Informante. |
20 | 273 | 025 | A | Z | Código e Digito da Agência + Código e Digito do cedente (1) |
21 | 298 | 008 | N | Z | Data do documento – AAAAMMDD (1) |
22 | 306 | 025 | A | Z | Número do documento (1) |
23 | 331 | 005 | A | Z | Sigla da espécie do documento – exemplo: NF, DP, etc. |
24 | 336 | 003 | A | Z | Código do aceite do título N ou S |
25 | 339 | 017 | A | Z | Para uso do banco |
26 | 356 | 003 | A | A | Deixar em branco |
27 | 359 | 008 | N | Z | Data do Processamento – AAAAMMDD Obs.: Caso não seja informada será atribuída a data de inclusão da anotação no boleto. |
28 | 367 | 025 | A | Z | Nosso número (1) |
29 | 392 | 005 | A | Z | Número da Carteira |
Opcional
Protótipo de Tela
<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.
Protótipo 01
Opcional
Fluxo do Processo
<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.
Tabelas Utilizadas
- FW8 – Cadastro de Contas a Pagar
Dicionário de Dados
Arquivo ou Código do Script: FW8 – Cabeçalho de lotes SERASA
Campo | FW8_TPFAC |
Tipo | Caractere |
Tamanho | 1 |
Opcional
Dicionário de Dados
Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/
Índice | Chave |
01 | <FI9_FILIAL+FI9_IDDARF+FI9_STATUS> |
02 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF> |
03 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO> |
Campo | <AAA_PERESP> |
Tipo | <N> |
Tamanho | <6> |
Valor Inicial | <Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. |
Mandatório | Sim ( ) Não ( x ) |
Descrição | <Referência Mínima para Cálculo> |
Título | <Ref.Calc.> |
Picture | <@E999.99> |
Help de Campo | <Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociaçã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
(Opcional)
Grupo de Perguntas
<Informações utilizadas na linha Protheus>.
Nome: FINSRF2
X1_ORDEM | 0111 | |
X1_PERGUNT | Emissão DeLote FAC Boleto | |
X1_TIPO | DC | |
X1_TAMANHO | 81 | |
X1_GSC | GC | |
X1_VAR01 | MV_PAR01PAR12 | |
X1_PRESEL | 2 | |
X1_DEF01 | Comum1=Sim | |
X1_ | CNT01'01/01/08'DEF02 | 2=Não |
X1_HELP | Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório | 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” |
(Opcional)
Consulta Padrão
<Informações utilizadas na linha Protheus>
Consulta: AMB
Descrição | Configurações de Planejamento |
Tipo | Consulta Padrão |
Tabela | “AMB” |
Índice | “Código” |
Campo | “Código”; ”Descrição” |
Retorno | AMBFW8->AMB>FW8_CODIGOLOTE |
(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. |
---|