@netoalmanca/advpl-sensei 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/agents/changelog-generator.md +63 -0
  2. package/agents/code-generator.md +215 -0
  3. package/agents/code-reviewer.md +145 -0
  4. package/agents/debugger.md +83 -0
  5. package/agents/doc-generator.md +67 -0
  6. package/agents/docs-reference.md +86 -0
  7. package/agents/migrator.md +84 -0
  8. package/agents/process-consultant.md +97 -0
  9. package/agents/refactorer.md +75 -0
  10. package/agents/sx-configurator.md +67 -0
  11. package/commands/changelog.md +66 -0
  12. package/commands/diagnose.md +67 -0
  13. package/commands/docs.md +81 -0
  14. package/commands/document.md +67 -0
  15. package/commands/explain.md +60 -0
  16. package/commands/generate.md +111 -0
  17. package/commands/migrate.md +81 -0
  18. package/commands/process.md +111 -0
  19. package/commands/refactor.md +65 -0
  20. package/commands/review.md +60 -0
  21. package/commands/sxgen.md +98 -0
  22. package/commands/test.md +103 -0
  23. package/dist/index.d.ts +2 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/index.js +143 -0
  26. package/dist/index.js.map +1 -0
  27. package/package.json +30 -0
  28. package/skills/advpl-code-generation/SKILL.md +163 -0
  29. package/skills/advpl-code-generation/patterns-fwformbrowse.md +485 -0
  30. package/skills/advpl-code-generation/patterns-jobs.md +519 -0
  31. package/skills/advpl-code-generation/patterns-mvc.md +765 -0
  32. package/skills/advpl-code-generation/patterns-pontos-entrada.md +708 -0
  33. package/skills/advpl-code-generation/patterns-rest.md +974 -0
  34. package/skills/advpl-code-generation/patterns-soap.md +639 -0
  35. package/skills/advpl-code-generation/patterns-treport.md +481 -0
  36. package/skills/advpl-code-generation/patterns-workflow.md +779 -0
  37. package/skills/advpl-code-generation/templates-classes.md +1096 -0
  38. package/skills/advpl-code-review/SKILL.md +72 -0
  39. package/skills/advpl-code-review/rules-best-practices.md +444 -0
  40. package/skills/advpl-code-review/rules-modernization.md +290 -0
  41. package/skills/advpl-code-review/rules-performance.md +333 -0
  42. package/skills/advpl-code-review/rules-security.md +302 -0
  43. package/skills/advpl-debugging/SKILL.md +265 -0
  44. package/skills/advpl-debugging/common-errors.md +1124 -0
  45. package/skills/advpl-debugging/performance-tips.md +768 -0
  46. package/skills/advpl-refactoring/SKILL.md +139 -0
  47. package/skills/advpl-to-tlpp-migration/SKILL.md +293 -0
  48. package/skills/advpl-to-tlpp-migration/migration-checklist.md +122 -0
  49. package/skills/advpl-to-tlpp-migration/migration-rules.md +265 -0
  50. package/skills/changelog-patterns/SKILL.md +99 -0
  51. package/skills/code-explanation/SKILL.md +66 -0
  52. package/skills/documentation-patterns/SKILL.md +172 -0
  53. package/skills/embedded-sql/SKILL.md +379 -0
  54. package/skills/probat-testing/SKILL.md +226 -0
  55. package/skills/probat-testing/patterns-unit-tests.md +614 -0
  56. package/skills/protheus-business/SKILL.md +92 -0
  57. package/skills/protheus-business/modulo-compras.md +780 -0
  58. package/skills/protheus-business/modulo-contabilidade.md +874 -0
  59. package/skills/protheus-business/modulo-estoque.md +876 -0
  60. package/skills/protheus-business/modulo-faturamento.md +800 -0
  61. package/skills/protheus-business/modulo-financeiro.md +1015 -0
  62. package/skills/protheus-business/modulo-fiscal.md +749 -0
  63. package/skills/protheus-business/modulo-manutencao.md +848 -0
  64. package/skills/protheus-business/modulo-pcp.md +743 -0
  65. package/skills/protheus-reference/SKILL.md +119 -0
  66. package/skills/protheus-reference/native-functions.md +7029 -0
  67. package/skills/protheus-reference/rest-api-reference.md +1758 -0
  68. package/skills/protheus-reference/restricted-functions.md +265 -0
  69. package/skills/protheus-reference/sx-dictionary.md +854 -0
  70. package/skills/sx-configuration/SKILL.md +184 -0
@@ -0,0 +1,1015 @@
1
+ # Modulo Financeiro (FIN)
2
+
3
+ ## Visao Geral
4
+
5
+ O modulo Financeiro (SIGAFIN) do TOTVS Protheus gerencia todo o ciclo financeiro da empresa, abrangendo contas a pagar, contas a receber, movimentacoes bancarias, borderos, CNAB, compensacoes e conciliacao bancaria. Ele controla os titulos que representam obrigacoes de pagamento e direitos de recebimento, integrando-se diretamente com os modulos de Compras, Faturamento, Fiscal e Contabilidade.
6
+
7
+ **Prefixo do modulo:** FIN
8
+ **Sigla do ambiente:** SIGAFIN
9
+ **Prefixo das rotinas:** FINAx0x (ex: FINA010, FINA040, FINA050, FINA060, FINA070, FINA080, FINA090, FINA100, FINA110, FINA200, FINA240, FINA330, FINA340, FINA450)
10
+
11
+ ### Ciclo principal financeiro
12
+
13
+ ```
14
+ Inclusao de Titulo → Aprovacao → Bordero/CNAB → Baixa → Compensacao → Conciliacao Bancaria
15
+ ```
16
+
17
+ O modulo permite tanto a inclusao manual de titulos quanto a geracao automatica a partir de documentos de entrada (Compras) e notas de saida (Faturamento). Os titulos passam por processos de agrupamento (bordero), comunicacao bancaria (CNAB), baixa (manual ou automatica), compensacao e conciliacao.
18
+
19
+ ---
20
+
21
+ ## Tabelas Principais
22
+
23
+ ### SE1 - Titulos a Receber
24
+
25
+ Armazena os titulos que representam receitas da empresa: duplicatas, cheques, notas promissorias, adiantamentos, entre outros. Cada registro representa um titulo ou parcela a receber de um cliente.
26
+
27
+ | Campo | Tipo | Tam | Descricao |
28
+ |-------|------|-----|-----------|
29
+ | E1_FILIAL | C | 2 | Filial |
30
+ | E1_PREFIXO | C | 3 | Prefixo do titulo |
31
+ | E1_NUM | C | 9 | Numero do titulo |
32
+ | E1_PARCELA | C | 2 | Parcela do titulo |
33
+ | E1_TIPO | C | 3 | Tipo do titulo (NF, DP, CH, NCC, RA, etc.) |
34
+ | E1_CLIENTE | C | 6 | Codigo do cliente |
35
+ | E1_LOJA | C | 2 | Loja do cliente |
36
+ | E1_NOMCLI | C | 20 | Nome reduzido do cliente |
37
+ | E1_NATUREZ | C | 10 | Natureza financeira |
38
+ | E1_EMISSAO | D | 8 | Data de emissao |
39
+ | E1_VENCTO | D | 8 | Data de vencimento |
40
+ | E1_VENCREA | D | 8 | Data de vencimento real |
41
+ | E1_VALOR | N | 16,2 | Valor do titulo |
42
+ | E1_SALDO | N | 16,2 | Saldo em aberto |
43
+ | E1_DESCONT | N | 16,2 | Valor do desconto |
44
+ | E1_JUROS | N | 16,2 | Valor de juros |
45
+ | E1_MULTA | N | 16,2 | Valor de multa |
46
+ | E1_CORREC | N | 16,2 | Valor de correcao monetaria |
47
+ | E1_HIST | C | 40 | Historico do titulo |
48
+ | E1_PORTADO | C | 3 | Codigo do banco portador |
49
+ | E1_AGEDEP | C | 5 | Agencia depositaria |
50
+ | E1_CONTA | C | 10 | Conta corrente |
51
+ | E1_NUMBCO | C | 15 | Numero bancario do documento |
52
+ | E1_SITUACA | C | 1 | Situacao do titulo |
53
+ | E1_MOEDA | N | 2 | Moeda do titulo |
54
+ | E1_BAIXA | D | 8 | Data da baixa |
55
+ | E1_IRRF | N | 14,2 | Valor IRRF |
56
+ | E1_ISS | N | 14,2 | Valor ISS |
57
+ | E1_INSS | N | 14,2 | Valor INSS |
58
+ | E1_CSLL | N | 14,2 | Valor CSLL |
59
+ | E1_COFINS | N | 14,2 | Valor COFINS |
60
+ | E1_PIS | N | 14,2 | Valor PIS |
61
+ | E1_VEND1 | C | 6 | Codigo do vendedor 1 |
62
+ | E1_COMIS1 | N | 6,2 | Percentual de comissao 1 |
63
+ | E1_NUMBOR | C | 6 | Numero do bordero |
64
+
65
+ **Indices principais:**
66
+ - Ordem 1: `E1_FILIAL + E1_PREFIXO + E1_NUM + E1_PARCELA + E1_TIPO`
67
+ - Ordem 2: `E1_FILIAL + E1_CLIENTE + E1_LOJA + E1_PREFIXO + E1_NUM`
68
+ - Ordem 3: `E1_FILIAL + E1_EMISSAO + E1_PREFIXO + E1_NUM`
69
+ - Ordem 4: `E1_FILIAL + E1_VENCTO + E1_PREFIXO + E1_NUM`
70
+
71
+ ---
72
+
73
+ ### SE2 - Titulos a Pagar
74
+
75
+ Armazena os titulos que representam obrigacoes de pagamento da empresa: duplicatas de fornecedores, impostos, alugueis, salarios, emprestimos, entre outros. Pode ser gerado manualmente ou automaticamente via documento de entrada (Compras).
76
+
77
+ | Campo | Tipo | Tam | Descricao |
78
+ |-------|------|-----|-----------|
79
+ | E2_FILIAL | C | 2 | Filial |
80
+ | E2_PREFIXO | C | 3 | Prefixo do titulo |
81
+ | E2_NUM | C | 9 | Numero do titulo |
82
+ | E2_PARCELA | C | 2 | Parcela do titulo |
83
+ | E2_TIPO | C | 3 | Tipo do titulo (NF, DP, TX, PA, etc.) |
84
+ | E2_FORNECE | C | 6 | Codigo do fornecedor |
85
+ | E2_LOJA | C | 2 | Loja do fornecedor |
86
+ | E2_NOMFOR | C | 20 | Nome reduzido do fornecedor |
87
+ | E2_NATUREZ | C | 10 | Natureza financeira |
88
+ | E2_EMISSAO | D | 8 | Data de emissao |
89
+ | E2_VENCTO | D | 8 | Data de vencimento |
90
+ | E2_VENCREA | D | 8 | Data de vencimento real |
91
+ | E2_VALOR | N | 16,2 | Valor do titulo |
92
+ | E2_SALDO | N | 16,2 | Saldo em aberto |
93
+ | E2_DESCONT | N | 16,2 | Valor do desconto |
94
+ | E2_JUROS | N | 16,2 | Valor de juros |
95
+ | E2_MULTA | N | 16,2 | Valor de multa |
96
+ | E2_HIST | C | 40 | Historico do titulo |
97
+ | E2_PORTADO | C | 3 | Codigo do banco portador |
98
+ | E2_NUMBOR | C | 6 | Numero do bordero |
99
+ | E2_SITUACA | C | 1 | Situacao do titulo |
100
+ | E2_MOEDA | N | 2 | Moeda do titulo |
101
+ | E2_IRRF | N | 14,2 | Valor IRRF |
102
+ | E2_ISS | N | 14,2 | Valor ISS |
103
+ | E2_INSS | N | 14,2 | Valor INSS |
104
+ | E2_CSLL | N | 14,2 | Valor CSLL |
105
+ | E2_COFINS | N | 14,2 | Valor COFINS |
106
+ | E2_PIS | N | 14,2 | Valor PIS |
107
+ | E2_RATEIO | C | 1 | Rateio por centro de custo (S/N) |
108
+ | E2_CC | C | 9 | Centro de custo |
109
+ | E2_CONTA | C | 20 | Conta contabil |
110
+
111
+ **Indices principais:**
112
+ - Ordem 1: `E2_FILIAL + E2_PREFIXO + E2_NUM + E2_PARCELA + E2_TIPO + E2_FORNECE + E2_LOJA`
113
+ - Ordem 2: `E2_FILIAL + E2_FORNECE + E2_LOJA + E2_PREFIXO + E2_NUM`
114
+ - Ordem 3: `E2_FILIAL + E2_EMISSAO + E2_PREFIXO + E2_NUM`
115
+ - Ordem 4: `E2_FILIAL + E2_VENCTO + E2_PREFIXO + E2_NUM`
116
+
117
+ ---
118
+
119
+ ### SE5 - Movimentacao Bancaria
120
+
121
+ Registra todas as movimentacoes bancarias do sistema: baixas de titulos, transferencias entre contas, depositos, saques, pagamentos e recebimentos. E a tabela central de rastreamento financeiro.
122
+
123
+ | Campo | Tipo | Tam | Descricao |
124
+ |-------|------|-----|-----------|
125
+ | E5_FILIAL | C | 2 | Filial |
126
+ | E5_DATA | D | 8 | Data da movimentacao |
127
+ | E5_BANCO | C | 3 | Codigo do banco |
128
+ | E5_AGENCIA | C | 5 | Agencia bancaria |
129
+ | E5_CONTA | C | 10 | Conta corrente |
130
+ | E5_PREFIXO | C | 3 | Prefixo do titulo |
131
+ | E5_NUMERO | C | 9 | Numero do titulo |
132
+ | E5_PARCELA | C | 2 | Parcela do titulo |
133
+ | E5_TIPO | C | 3 | Tipo do titulo |
134
+ | E5_TIPODOC | C | 2 | Tipo da movimentacao (controle interno) |
135
+ | E5_NATUREZ | C | 10 | Natureza financeira |
136
+ | E5_VALOR | N | 16,2 | Valor da movimentacao |
137
+ | E5_RECPAG | C | 1 | Recebimento (R) ou Pagamento (P) |
138
+ | E5_CLIFOR | C | 6 | Codigo do cliente/fornecedor |
139
+ | E5_LOJA | C | 2 | Loja do cliente/fornecedor |
140
+ | E5_HISTOR | C | 40 | Historico do movimento |
141
+ | E5_MOTBX | C | 3 | Motivo da baixa |
142
+ | E5_SITUACA | C | 1 | Situacao (vazio=ativo, E=estorno) |
143
+ | E5_DTDISPO | D | 8 | Data de disponibilizacao |
144
+ | E5_MOEDA | C | 2 | Numerario/moeda |
145
+ | E5_NUMCHEQ | C | 15 | Numero do cheque |
146
+ | E5_DOCUMEN | C | 50 | Numero do documento |
147
+ | E5_VLJUROS | N | 16,2 | Valor de juros |
148
+ | E5_VLMULTA | N | 16,2 | Valor de multa |
149
+ | E5_VLCORRE | N | 16,2 | Valor de correcao monetaria |
150
+ | E5_VLDESCO | N | 16,2 | Valor do desconto |
151
+ | E5_VLACRES | N | 16,2 | Valor do acrescimo |
152
+ | E5_VLDECRE | N | 16,2 | Valor do decrescimo |
153
+ | E5_RECONC | C | 1 | Documento reconciliado (S/N) |
154
+ | E5_LA | C | 2 | Identificador de lancamento/deposito |
155
+ | E5_LOTE | C | 4 | Lote da baixa |
156
+ | E5_SEQ | C | 2 | Sequencia da baixa |
157
+ | E5_DEBITO | C | 20 | Conta contabil debito |
158
+ | E5_CREDITO | C | 20 | Conta contabil credito |
159
+ | E5_ORIGEM | C | 8 | Origem do movimento bancario |
160
+
161
+ **Indices principais:**
162
+ - Ordem 1: `E5_FILIAL + E5_DATA + E5_BANCO + E5_AGENCIA + E5_CONTA`
163
+ - Ordem 2: `E5_FILIAL + E5_NUMERO + E5_PREFIXO + E5_PARCELA + E5_TIPO`
164
+ - Ordem 3: `E5_FILIAL + E5_BANCO + E5_AGENCIA + E5_CONTA + E5_DATA`
165
+
166
+ **Nota sobre reestruturacao:** A tabela SE5 foi reestruturada na familia de tabelas FKx (FK5, FKA, FKD, etc.) para normalizacao e melhoria de performance. Dependendo da versao do Protheus, as movimentacoes podem estar distribuidas entre SE5 e as tabelas FKx.
167
+
168
+ ---
169
+
170
+ ### SA6 - Bancos
171
+
172
+ Cadastro mestre de bancos (contas correntes da empresa), utilizado em todo o ciclo financeiro para identificar as contas de origem/destino de movimentacoes.
173
+
174
+ | Campo | Tipo | Tam | Descricao |
175
+ |-------|------|-----|-----------|
176
+ | A6_FILIAL | C | 2 | Filial |
177
+ | A6_COD | C | 3 | Codigo do banco |
178
+ | A6_AGENCIA | C | 5 | Agencia |
179
+ | A6_NUMCON | C | 10 | Numero da conta corrente |
180
+ | A6_NOME | C | 30 | Nome do banco |
181
+ | A6_NREDUZ | C | 20 | Nome reduzido |
182
+ | A6_DVCTA | C | 1 | Digito verificador da conta |
183
+ | A6_DVAGE | C | 1 | Digito verificador da agencia |
184
+ | A6_MOEDA | N | 2 | Moeda da conta |
185
+ | A6_BCOOFI | C | 3 | Codigo oficial do banco (FEBRABAN) |
186
+ | A6_TIPOCTA | C | 1 | Tipo de conta (C=Corrente, P=Poupanca, I=Investimento) |
187
+
188
+ **Indices principais:**
189
+ - Ordem 1: `A6_FILIAL + A6_COD + A6_AGENCIA + A6_NUMCON`
190
+ - Ordem 2: `A6_FILIAL + A6_NOME`
191
+
192
+ ---
193
+
194
+ ### SE8 - Saldos Bancarios
195
+
196
+ Armazena os saldos diarios de cada conta bancaria. Atualizada automaticamente pelas movimentacoes registradas na SE5.
197
+
198
+ | Campo | Tipo | Tam | Descricao |
199
+ |-------|------|-----|-----------|
200
+ | E8_FILIAL | C | 2 | Filial |
201
+ | E8_BANCO | C | 3 | Codigo do banco |
202
+ | E8_AGENCIA | C | 5 | Agencia |
203
+ | E8_CONTA | C | 10 | Conta corrente |
204
+ | E8_DATA | D | 8 | Data do saldo |
205
+ | E8_MOEDA | N | 2 | Moeda |
206
+ | E8_SAINI | N | 16,2 | Saldo inicial do dia |
207
+ | E8_SAIFIM | N | 16,2 | Saldo final do dia |
208
+ | E8_ENTRADA | N | 16,2 | Total de entradas no dia |
209
+ | E8_SAIDA | N | 16,2 | Total de saidas no dia |
210
+
211
+ **Indices principais:**
212
+ - Ordem 1: `E8_FILIAL + E8_BANCO + E8_AGENCIA + E8_CONTA + E8_DATA + E8_MOEDA`
213
+
214
+ ---
215
+
216
+ ### SEA - Titulos em Bordero (Controle de Bordero)
217
+
218
+ Registra os titulos enviados ao banco via bordero, mantendo o historico de transferencias, situacoes de cobranca e comunicacao bancaria.
219
+
220
+ | Campo | Tipo | Tam | Descricao |
221
+ |-------|------|-----|-----------|
222
+ | EA_FILIAL | C | 2 | Filial |
223
+ | EA_PREFIXO | C | 3 | Prefixo do titulo |
224
+ | EA_NUM | C | 9 | Numero do titulo |
225
+ | EA_PARCELA | C | 2 | Parcela do titulo |
226
+ | EA_TIPO | C | 3 | Tipo do titulo |
227
+ | EA_PORTADO | C | 3 | Codigo do banco portador |
228
+ | EA_AGEDEP | C | 5 | Agencia depositaria |
229
+ | EA_NUMBOR | C | 6 | Numero do bordero |
230
+ | EA_DATABOR | D | 8 | Data do bordero |
231
+ | EA_CART | C | 1 | Carteira de cobranca |
232
+ | EA_FORNECE | C | 6 | Codigo do fornecedor |
233
+ | EA_LOJA | C | 2 | Loja do fornecedor |
234
+ | EA_NUMCON | C | 10 | Conta corrente |
235
+ | EA_SITUACA | C | 1 | Situacao do bordero |
236
+ | EA_SALDO | N | 16,2 | Saldo do titulo |
237
+ | EA_OCORR | C | 2 | Ocorrencia CNAB |
238
+ | EA_TRANSF | C | 1 | Status de transferencia |
239
+ | EA_MODELO | C | 2 | Modelo do bordero |
240
+ | EA_TIPOPAG | C | 2 | Tipo de pagamento |
241
+
242
+ **Indices principais:**
243
+ - Ordem 1: `EA_FILIAL + EA_PREFIXO + EA_NUM + EA_PARCELA + EA_TIPO`
244
+ - Ordem 2: `EA_FILIAL + EA_NUMBOR + EA_PREFIXO + EA_NUM`
245
+
246
+ ---
247
+
248
+ ### SED - Naturezas Financeiras
249
+
250
+ Cadastro de naturezas financeiras que classificam as operacoes a pagar e a receber, controlando tambem o calculo de retencoes tributarias.
251
+
252
+ | Campo | Tipo | Tam | Descricao |
253
+ |-------|------|-----|-----------|
254
+ | ED_FILIAL | C | 2 | Filial |
255
+ | ED_CODIGO | C | 10 | Codigo da natureza |
256
+ | ED_DESCRIC | C | 30 | Descricao da natureza |
257
+ | ED_TIPO | C | 1 | Tipo: S=Sintetica, A=Analitica |
258
+ | ED_CLASSE | C | 1 | Classe: R=Receita, D=Despesa |
259
+ | ED_CALCIRF | C | 1 | Calcula IRRF (S/N) |
260
+ | ED_CALCINR | C | 1 | Calcula INSS retido (S/N) |
261
+ | ED_CALCISS | C | 1 | Calcula ISS retido (S/N) |
262
+ | ED_CALCCSL | C | 1 | Calcula CSLL retida (S/N) |
263
+ | ED_CALCCOF | C | 1 | Calcula COFINS retida (S/N) |
264
+ | ED_CALCPIS | C | 1 | Calcula PIS retido (S/N) |
265
+
266
+ **Indices principais:**
267
+ - Ordem 1: `ED_FILIAL + ED_CODIGO`
268
+ - Ordem 2: `ED_FILIAL + ED_DESCRIC`
269
+
270
+ ---
271
+
272
+ ### FI9 - Controle CNAB
273
+
274
+ Armazena as informacoes de controle dos arquivos CNAB (remessa e retorno), vinculando titulos aos arquivos gerados e processados.
275
+
276
+ | Campo | Tipo | Tam | Descricao |
277
+ |-------|------|-----|-----------|
278
+ | FI9_FILIAL | C | 2 | Filial |
279
+ | FI9_BANCO | C | 3 | Codigo do banco |
280
+ | FI9_AGENCI | C | 5 | Agencia |
281
+ | FI9_CONTA | C | 10 | Conta corrente |
282
+ | FI9_LAYOUT | C | 6 | Layout CNAB |
283
+ | FI9_TIPO | C | 1 | Tipo: R=Remessa, T=Retorno |
284
+ | FI9_DTGER | D | 8 | Data de geracao |
285
+ | FI9_ARQCNB | C | 50 | Nome do arquivo CNAB |
286
+ | FI9_STATUS | C | 1 | Status do processamento |
287
+
288
+ ---
289
+
290
+ ### FK2 - Faturas
291
+
292
+ Armazena os cabecalhos de faturas que agrupam titulos a pagar ou a receber para cobranca ou pagamento consolidado.
293
+
294
+ | Campo | Tipo | Tam | Descricao |
295
+ |-------|------|-----|-----------|
296
+ | FK2_FILIAL | C | 2 | Filial |
297
+ | FK2_IDFATU | C | 9 | Identificador da fatura |
298
+ | FK2_PREFAT | C | 3 | Prefixo da fatura |
299
+ | FK2_TIPO | C | 1 | Tipo: R=Receber, P=Pagar |
300
+ | FK2_CLIFOR | C | 6 | Cliente/fornecedor |
301
+ | FK2_LOJA | C | 2 | Loja |
302
+ | FK2_VALOR | N | 16,2 | Valor total da fatura |
303
+ | FK2_EMISSA | D | 8 | Data de emissao |
304
+ | FK2_VENCTO | D | 8 | Data de vencimento |
305
+
306
+ ---
307
+
308
+ ## Rotinas Principais
309
+
310
+ ### FINA010 - Naturezas Financeiras
311
+
312
+ **O que faz:** Cadastro e manutencao das naturezas financeiras na tabela SED. As naturezas funcionam como classificadores das operacoes financeiras (a pagar ou a receber) e sao responsaveis por definir o calculo de retencoes tributarias (IRRF, PIS, COFINS, CSLL, ISS, INSS). Devem ser agrupadas por tipo de operacao (receita ou despesa) para facilitar filtros em consultas e relatorios.
313
+
314
+ **Tabelas envolvidas:**
315
+ - SED (escrita) - Naturezas Financeiras
316
+ - SX5 (leitura) - Tabelas Genericas
317
+
318
+ **Parametros relevantes:**
319
+ | Parametro | Descricao |
320
+ |-----------|-----------|
321
+ | MV_MASCNAT | Mascara do codigo da natureza do titulo financeiro |
322
+
323
+ **Pontos de entrada:**
324
+ | Ponto de Entrada | Descricao |
325
+ |------------------|-----------|
326
+ | FA010INC | Validacoes customizadas na inclusao de natureza |
327
+
328
+ ---
329
+
330
+ ### FINA040 - Contas a Receber
331
+
332
+ **O que faz:** Permite incluir, alterar, excluir e visualizar titulos a receber (SE1). Controla todos os documentos que geram receita para a empresa: duplicatas, cheques, notas promissorias, adiantamentos de clientes, entre outros. A inclusao pode ser manual (digitacao individual) ou automatica (a partir de notas de saida do Faturamento).
333
+
334
+ **Tabelas envolvidas:**
335
+ - SE1 (escrita) - Titulos a Receber
336
+ - SE5 (escrita) - Movimentacao Bancaria (na baixa)
337
+ - SA1 (leitura) - Cadastro de Clientes
338
+ - SED (leitura) - Naturezas Financeiras
339
+ - SE4 (leitura) - Condicoes de Pagamento
340
+ - SA6 (leitura) - Bancos
341
+
342
+ **Parametros relevantes:**
343
+ | Parametro | Descricao |
344
+ |-----------|-----------|
345
+ | MV_1DUP | Numero inicial da primeira duplicata |
346
+
347
+ **Pontos de entrada:**
348
+ | Ponto de Entrada | Descricao |
349
+ |------------------|-----------|
350
+ | FA040INC | Validacoes customizadas na inclusao do titulo a receber |
351
+ | M040SE1 | Gravacao auxiliar de registros na SE1 (pos-gravacao) |
352
+ | F040VLDEX | Validacao na exclusao do titulo a receber |
353
+ | FA040GRV | Manipula dados antes da gravacao do titulo |
354
+ | FA040TRB | Customiza toolbar da rotina |
355
+
356
+ ---
357
+
358
+ ### FINA050 - Contas a Pagar
359
+
360
+ **O que faz:** Permite incluir, alterar, excluir e visualizar titulos a pagar (SE2). Controla os compromissos de pagamento da empresa: duplicatas de fornecedores, impostos, alugueis, salarios, emprestimos, insumos de producao, entre outros. A inclusao pode ser manual ou automatica (via documento de entrada do modulo Compras/Estoque).
361
+
362
+ **Tabelas envolvidas:**
363
+ - SE2 (escrita) - Titulos a Pagar
364
+ - SE5 (escrita) - Movimentacao Bancaria (na baixa)
365
+ - SA2 (leitura) - Cadastro de Fornecedores
366
+ - SED (leitura) - Naturezas Financeiras
367
+ - SE4 (leitura) - Condicoes de Pagamento
368
+ - SA6 (leitura) - Bancos
369
+
370
+ **Parametros relevantes:**
371
+
372
+ > Nenhum parametro MV_* confirmado no TDN para esta rotina especifica. Os parametros de impostos e retencoes sao configurados na natureza financeira (SED).
373
+
374
+ **Pontos de entrada:**
375
+ | Ponto de Entrada | Descricao |
376
+ |------------------|-----------|
377
+ | F050BROW | Pre-validacao de dados no browse do Contas a Pagar |
378
+ | F050PERGUNT | Altera configuracao de perguntas na rotina automatica |
379
+ | F050MCP | Adiciona campos na alteracao do Contas a Pagar |
380
+ | FA050GRV | Manipula dados antes da gravacao do titulo |
381
+ | F050VLDEX | Validacao na exclusao do titulo a pagar |
382
+
383
+ ---
384
+
385
+ ### FINA060 - Transferencias / Bordero de Recebimento
386
+
387
+ **O que faz:** Permite transferir titulos a receber para carteiras de cobranca (simples, descontada, caucionada, vinculada). Realiza transferencias manuais (titulo a titulo) ou via bordero (multiplos titulos de uma vez). O bordero pode ser utilizado para gerar arquivos de remessa CNAB para envio ao banco. Calcula IOF em transferencias para situacao de cobranca descontada.
388
+
389
+ **Tabelas envolvidas:**
390
+ - SE1 (leitura/escrita) - Titulos a Receber (atualiza situacao/portador)
391
+ - SEA (escrita) - Titulos em Bordero
392
+ - SE5 (escrita) - Movimentacao Bancaria
393
+ - SA6 (leitura) - Bancos
394
+
395
+ **Parametros relevantes:**
396
+ | Parametro | Descricao |
397
+ |-----------|-----------|
398
+ | MV_NUMBORR | Numeracao sequencial do bordero a receber |
399
+
400
+ **Pontos de entrada:**
401
+ | Ponto de Entrada | Descricao |
402
+ |------------------|-----------|
403
+ | F060FILSE1 | Filtro customizado na selecao de titulos para bordero |
404
+ | F060BORDE | Manipula dados do bordero antes da gravacao |
405
+ | F060IMPTIT | Impostos na transferencia de titulo |
406
+
407
+ ---
408
+
409
+ ### FINA070 - Baixas a Receber (Manual)
410
+
411
+ **O que faz:** Registra o recebimento individual de titulos a receber. Permite informar o valor efetivamente recebido, acrescimos (juros, multa, correcao) e descontos. O valor recebido, parcial ou total, nunca pode ser maior que o saldo liquido do titulo. Gera movimentacao na SE5 e atualiza saldo na SE1.
412
+
413
+ **Tabelas envolvidas:**
414
+ - SE1 (leitura/escrita) - Titulos a Receber (atualiza E1_SALDO, E1_BAIXA)
415
+ - SE5 (escrita) - Movimentacao Bancaria
416
+ - SA6 (leitura) - Bancos
417
+ - FKD (escrita) - Valores Acessorios (se aplicavel)
418
+
419
+ **Parametros relevantes:**
420
+
421
+ > Nenhum parametro MV_* confirmado no TDN para esta rotina especifica. Os parametros de juros, multa e desconto sao configurados via MV_JURTIPO, MV_TXPER e na natureza financeira.
422
+
423
+ **Pontos de entrada:**
424
+ | Ponto de Entrada | Descricao |
425
+ |------------------|-----------|
426
+ | F070VDATA | Validacao de dados da baixa a receber |
427
+ | F070INCSE5 | Manipula dados da SE5 gerada pela baixa |
428
+ | F070BXCR | Pos-gravacao da baixa a receber |
429
+ | F070ACRE | Altera valor de acrescimo/decrescimo na baixa |
430
+
431
+ ---
432
+
433
+ ### FINA080 - Baixas a Pagar (Manual)
434
+
435
+ **O que faz:** Registra o pagamento individual de titulos a pagar. Permite definir o motivo da baixa (tabela de motivos previamente cadastrada), que pode gerar movimentacao bancaria ou emitir cheque. Para titulos em bordero, somente a baixa total e permitida na FINA080.
436
+
437
+ **Tabelas envolvidas:**
438
+ - SE2 (leitura/escrita) - Titulos a Pagar (atualiza E2_SALDO)
439
+ - SE5 (escrita) - Movimentacao Bancaria
440
+ - SA6 (leitura) - Bancos
441
+ - FKD (escrita) - Valores Acessorios (se aplicavel)
442
+
443
+ **Parametros relevantes:**
444
+
445
+ > Nenhum parametro MV_* confirmado no TDN para esta rotina especifica. Os parametros de juros, multa e desconto sao configurados via MV_JURTIPO, MV_TXPER e na natureza financeira.
446
+
447
+ **Pontos de entrada:**
448
+ | Ponto de Entrada | Descricao |
449
+ |------------------|-----------|
450
+ | F080ACRE | Altera valor de acrescimo/decrescimo na baixa a pagar |
451
+ | F080VDATA | Validacao de dados da baixa a pagar |
452
+ | F080INCSE5 | Manipula dados da SE5 gerada pela baixa |
453
+ | F080BXCP | Pos-gravacao da baixa a pagar |
454
+
455
+ ---
456
+
457
+ ### FINA090 - Baixas a Pagar (Automatica)
458
+
459
+ **O que faz:** Executa a baixa automatica de multiplos titulos a pagar simultaneamente. Seleciona titulos por faixa de fornecedor, natureza, vencimento, prefixo, entre outros filtros. A partir de abril/2022, as rotinas FINA090 e FINA091 foram unificadas na FINA090 (a FINA091, que era multi-filial, foi descontinuada).
460
+
461
+ **Tabelas envolvidas:**
462
+ - SE2 (leitura/escrita) - Titulos a Pagar
463
+ - SE5 (escrita) - Movimentacao Bancaria
464
+ - SA6 (leitura) - Bancos
465
+
466
+ **Parametros relevantes:**
467
+
468
+ > Nenhum parametro MV_* confirmado no TDN para esta rotina especifica.
469
+
470
+ ---
471
+
472
+ ### FINA100 - Movimentos Bancarios
473
+
474
+ **O que faz:** Permite realizar transferencias entre contas bancarias, alimentando o saldo na SE8 e registrando a movimentacao na SE5. Caracteristica principal: nao gera receitas ou despesas para a empresa, controlando apenas entradas e saidas de valores entre contas. Ao cancelar um movimento, gera registro na SE5 com E5_SITUACA = 'E' (estorno).
475
+
476
+ **Tabelas envolvidas:**
477
+ - SE5 (escrita) - Movimentacao Bancaria
478
+ - SE8 (escrita) - Saldos Bancarios
479
+ - SA6 (leitura) - Bancos
480
+
481
+ **Parametros relevantes:**
482
+
483
+ > Nenhum parametro MV_* confirmado no TDN para esta rotina especifica. O numero do documento bancario e armazenado no campo E1_NUMBCO/E5_NUMBCO, nao em um parametro MV_.
484
+
485
+ **Pontos de entrada:**
486
+ | Ponto de Entrada | Descricao |
487
+ |------------------|-----------|
488
+ | F100FILBCO | Filtro de bancos disponiveis na movimentacao |
489
+ | F100HIST | Manipula historico do movimento bancario |
490
+ | F110SE5 | Manipulacao de titulos processados na SE5 |
491
+
492
+ ---
493
+
494
+ ### FINA110 - Baixa Automatica de Titulos a Receber
495
+
496
+ **O que faz:** Executa a baixa automatica de multiplos titulos a receber simultaneamente. Similar a FINA090 para o lado de recebimentos. Processa titulos por faixa de cliente, vencimento, prefixo, entre outros criterios.
497
+
498
+ **Tabelas envolvidas:**
499
+ - SE1 (leitura/escrita) - Titulos a Receber
500
+ - SE5 (escrita) - Movimentacao Bancaria
501
+ - SA6 (leitura) - Bancos
502
+
503
+ **Parametros relevantes:**
504
+
505
+ > Nenhum parametro MV_* confirmado no TDN para esta rotina especifica.
506
+
507
+ ---
508
+
509
+ ### FINA200 - Retorno de Cobrancas (CNAB Receber)
510
+
511
+ **O que faz:** Processa os arquivos de retorno CNAB enviados pelo banco para contas a receber. Realiza a baixa automatica dos titulos conforme as ocorrencias informadas no arquivo (confirmacao de pagamento, rejeicao, protesto, etc.). Cada ocorrencia do banco deve estar vinculada a uma ocorrencia do sistema (cadastrada via FINA140).
512
+
513
+ **Tabelas envolvidas:**
514
+ - SE1 (leitura/escrita) - Titulos a Receber (atualiza situacao/baixa)
515
+ - SE5 (escrita) - Movimentacao Bancaria
516
+ - SEA (leitura/escrita) - Titulos em Bordero
517
+ - FI9 (escrita) - Controle CNAB
518
+ - SA6 (leitura) - Bancos
519
+
520
+ **Parametros relevantes:**
521
+
522
+ > Nenhum parametro MV_* confirmado no TDN para esta rotina especifica. A configuracao de layout CNAB e feita nas tabelas EE*/SEE.
523
+
524
+ **Pontos de entrada:**
525
+ | Ponto de Entrada | Descricao |
526
+ |------------------|-----------|
527
+ | F200FILCNAB | Filtro de arquivos CNAB para processamento |
528
+ | FA200RET | Manipula dados do retorno antes da baixa |
529
+ | NGFPOSE1 | Posiciona SE1 para baixa do titulo no retorno |
530
+
531
+ ---
532
+
533
+ ### FINA240 - Bordero de Pagamentos
534
+
535
+ **O que faz:** Agrupa titulos a pagar em borderos para envio ao banco com instrucoes sobre a forma de pagamento. O bordero pode ser impresso ou gerado em arquivo TXT (mesmo mecanismo do CNAB). Apos a geracao do bordero de pagamento, os titulos sao automaticamente baixados. Inclui opcoes de cancelamento de bordero.
536
+
537
+ **Tabelas envolvidas:**
538
+ - SE2 (leitura/escrita) - Titulos a Pagar
539
+ - SEA (escrita) - Titulos em Bordero
540
+ - SE5 (escrita) - Movimentacao Bancaria
541
+ - SA6 (leitura) - Bancos
542
+
543
+ **Parametros relevantes:**
544
+ | Parametro | Descricao |
545
+ |-----------|-----------|
546
+ | MV_NUMBORP | Numeracao sequencial do bordero a pagar |
547
+
548
+ **Pontos de entrada:**
549
+ | Ponto de Entrada | Descricao |
550
+ |------------------|-----------|
551
+ | F240MARK | Altera MarkBrowse do bordero de pagamentos |
552
+ | F240PCB | Validacao do cancelamento de bordero |
553
+ | F240SE2 | Manipula titulos antes da inclusao no bordero |
554
+
555
+ ---
556
+
557
+ ### FINA241 - Bordero de Impostos
558
+
559
+ **O que faz:** Variacao do bordero de pagamentos que agrupa titulos a pagar com retencao de impostos (IRRF, PIS, COFINS, CSLL, ISS, INSS). Realiza as deducoes tributarias no momento do pagamento e gera o arquivo de remessa CNAB incluindo os valores liquidos.
560
+
561
+ **Tabelas envolvidas:**
562
+ - SE2 (leitura/escrita) - Titulos a Pagar
563
+ - SEA (escrita) - Titulos em Bordero
564
+ - SE5 (escrita) - Movimentacao Bancaria
565
+
566
+ **Pontos de entrada:**
567
+ | Ponto de Entrada | Descricao |
568
+ |------------------|-----------|
569
+ | F241MARK | Altera MarkBrowse do bordero de impostos |
570
+ | F241IRAN | Customizacao na conclusao do bordero com impostos |
571
+
572
+ ---
573
+
574
+ ### FINA290 - Faturas a Pagar
575
+
576
+ **O que faz:** Agrupa titulos a pagar em uma unica fatura para pagamento consolidado. Permite a selecao de titulos do mesmo fornecedor para composicao de uma fatura unificada.
577
+
578
+ **Tabelas envolvidas:**
579
+ - SE2 (leitura/escrita) - Titulos a Pagar
580
+ - FK2 (escrita) - Faturas
581
+
582
+ ---
583
+
584
+ ### FINA330 - Compensacao Contas a Receber
585
+
586
+ **O que faz:** Permite compensar titulos a receber entre si. Seleciona um titulo de referencia (normalmente tipo NF) e compensa com outros titulos do mesmo cliente (adiantamentos, notas de credito, etc.). Suporta compensacao com titulos em moeda estrangeira, realizando a conversao pela taxa contratada.
587
+
588
+ **Tabelas envolvidas:**
589
+ - SE1 (leitura/escrita) - Titulos a Receber
590
+ - SE5 (escrita) - Movimentacao Bancaria
591
+
592
+ **Pontos de entrada:**
593
+ | Ponto de Entrada | Descricao |
594
+ |------------------|-----------|
595
+ | F330COMP | Manipula dados da compensacao a receber |
596
+
597
+ ---
598
+
599
+ ### FINA340 - Compensacao Contas a Pagar
600
+
601
+ **O que faz:** Permite compensar titulos a pagar entre si. Funciona de forma similar a FINA330, porem para o lado das obrigacoes. Aceita apenas juros, multa e descontos registrados junto com o titulo (sem vinculo com valores acessorios). Permite tambem o estorno da compensacao.
602
+
603
+ **Tabelas envolvidas:**
604
+ - SE2 (leitura/escrita) - Titulos a Pagar
605
+ - SE5 (escrita) - Movimentacao Bancaria
606
+
607
+ **Pontos de entrada:**
608
+ | Ponto de Entrada | Descricao |
609
+ |------------------|-----------|
610
+ | F340COMP | Manipula dados da compensacao a pagar |
611
+
612
+ ---
613
+
614
+ ### FINA430 - Retorno CNAB a Pagar
615
+
616
+ **O que faz:** Processa os arquivos de retorno CNAB enviados pelo banco para contas a pagar. Confirma ou rejeita pagamentos conforme ocorrencias do arquivo de retorno, de acordo com o layout configurado no CNAB a Pagar (CFGX043).
617
+
618
+ **Tabelas envolvidas:**
619
+ - SE2 (leitura/escrita) - Titulos a Pagar
620
+ - SE5 (escrita) - Movimentacao Bancaria
621
+ - SEA (leitura/escrita) - Titulos em Bordero
622
+ - SA6 (leitura) - Bancos
623
+
624
+ **Pontos de entrada:**
625
+ | Ponto de Entrada | Descricao |
626
+ |------------------|-----------|
627
+ | FA430SE2 | Posiciona tabela SE2 para baixa no retorno CNAB a pagar |
628
+
629
+ ---
630
+
631
+ ### FINA450 - Compensacao entre Carteiras
632
+
633
+ **O que faz:** Permite compensar titulos a pagar com titulos a receber do mesmo cliente/fornecedor. Requer um titulo a pagar e um titulo a receber disponiveis para compensacao. Zera (total ou parcialmente) os saldos de ambos os titulos de forma cruzada.
634
+
635
+ **Tabelas envolvidas:**
636
+ - SE1 (leitura/escrita) - Titulos a Receber
637
+ - SE2 (leitura/escrita) - Titulos a Pagar
638
+ - SE5 (escrita) - Movimentacao Bancaria
639
+
640
+ **Pontos de entrada:**
641
+ | Ponto de Entrada | Descricao |
642
+ |------------------|-----------|
643
+ | F450GRAVA | Manipulacao dos arquivos temporarios SE1/SE2 na compensacao |
644
+ | F450OWN1 | Filtro da tabela SE2 na compensacao entre carteiras |
645
+
646
+ ---
647
+
648
+ ### FINA473 - Conciliacao Bancaria Automatica
649
+
650
+ **O que faz:** Realiza a conciliacao automatica entre os movimentos registrados no sistema (SE5) e o extrato bancario importado. Compara valores, datas e identificadores para conciliar os registros automaticamente. Complementa a conciliacao manual (FINA380).
651
+
652
+ **Tabelas envolvidas:**
653
+ - SE5 (leitura/escrita) - Movimentacao Bancaria (marca E5_RECONC)
654
+ - SIG (leitura) - Extrato Bancario Importado
655
+ - SA6 (leitura) - Bancos
656
+
657
+ ---
658
+
659
+ ### FINA210 - Recalculo de Saldos Bancarios
660
+
661
+ **O que faz:** Reprocessa os saldos bancarios na SE8 com base nas movimentacoes registradas na SE5. Utilizada para corrigir eventuais inconsistencias entre movimentacoes e saldos.
662
+
663
+ **Tabelas envolvidas:**
664
+ - SE5 (leitura) - Movimentacao Bancaria
665
+ - SE8 (escrita) - Saldos Bancarios
666
+ - SA6 (leitura) - Bancos
667
+
668
+ ---
669
+
670
+ ### FINA750 - Funcoes Contas a Pagar
671
+
672
+ **O que faz:** Painel centralizado de funcoes para contas a pagar. Oferece acesso rapido as principais operacoes: inclusao de titulos, bordero, baixa automatica, CNAB, compensacao e consultas. Funciona como ponto de entrada unificado para as rotinas de pagamento.
673
+
674
+ **Tabelas envolvidas:**
675
+ - SE2 (leitura) - Titulos a Pagar
676
+ - SA6 (leitura) - Bancos
677
+
678
+ **Pontos de entrada:**
679
+ | Ponto de Entrada | Descricao |
680
+ |------------------|-----------|
681
+ | F750BROW | Manipula opcoes do menu da rotina |
682
+
683
+ ---
684
+
685
+ ## Processos de Negocio
686
+
687
+ ### Fluxo Completo de Contas a Pagar
688
+
689
+ ```
690
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
691
+ │ 1. Inclusao │────>│ 2. Aprovacao │────>│ 3. Bordero de │
692
+ │ Titulo a Pagar │ │ (opcional) │ │ Pagamento │
693
+ │ FINA050 / SE2 │ │ Alcadas │ │ FINA240 / SEA │
694
+ └─────────────────┘ └─────────────────┘ └────────┬────────┘
695
+
696
+ ┌─────────────────┐ ┌─────────────────┐ ┌────────v────────┐
697
+ │ 6. Conciliacao │<────│ 5. Retorno │<────│ 4. CNAB │
698
+ │ Bancaria │ │ CNAB │ │ Remessa │
699
+ │ FINA473/FINA380 │ │ FINA430 │ │ CFGX043 │
700
+ └─────────────────┘ └─────────────────┘ └─────────────────┘
701
+ ```
702
+
703
+ #### Passo 1: Inclusao do Titulo a Pagar (FINA050 ou automatico)
704
+
705
+ | Aspecto | Detalhe |
706
+ |---------|---------|
707
+ | **Rotina** | FINA050 (manual) ou MATA103 (automatico via documento de entrada) |
708
+ | **Tabelas** | SE2 (escrita), SED (leitura), SA2 (leitura) |
709
+ | **O que acontece** | Titulo e incluido com fornecedor, valor, vencimento, natureza financeira e condicao de pagamento. Se originado do Compras, o titulo e gerado automaticamente na classificacao do documento de entrada, desdobrado conforme condicao de pagamento (SE4). |
710
+ | **Resultado** | Registro(s) na SE2 com saldo em aberto |
711
+
712
+ #### Passo 2: Aprovacao (opcional)
713
+
714
+ | Aspecto | Detalhe |
715
+ |---------|---------|
716
+ | **Rotina** | Alcadas/aprovacao configuradas por parametro |
717
+ | **O que acontece** | Se controle de alcada estiver ativo, titulos acima de determinados valores podem exigir aprovacao antes de seguir para pagamento. |
718
+ | **Resultado** | Titulo liberado para pagamento |
719
+
720
+ #### Passo 3: Bordero de Pagamento (FINA240)
721
+
722
+ | Aspecto | Detalhe |
723
+ |---------|---------|
724
+ | **Rotina** | FINA240 |
725
+ | **Tabelas** | SE2 (leitura), SEA (escrita), SE5 (escrita) |
726
+ | **O que acontece** | Titulos sao agrupados em bordero por banco/agencia/conta. O bordero pode ser impresso ou gerar arquivo TXT para envio ao banco. Os titulos sao marcados com numero do bordero (E2_NUMBOR). |
727
+ | **Resultado** | Bordero gerado, titulos vinculados na SEA, baixa automatica dos titulos |
728
+
729
+ #### Passo 4: Remessa CNAB (CFGX043)
730
+
731
+ | Aspecto | Detalhe |
732
+ |---------|---------|
733
+ | **Rotina** | Configurador CNAB a Pagar (CFGX043) |
734
+ | **Tabelas** | SEA (leitura), FI9 (escrita) |
735
+ | **O que acontece** | Arquivo de remessa (.txt) e gerado conforme layout CNAB configurado (240 ou 400 posicoes). Enviado ao banco com instrucoes de pagamento (tipo, data, valor, favorecido). |
736
+ | **Resultado** | Arquivo CNAB gerado e registrado para controle |
737
+
738
+ #### Passo 5: Retorno CNAB (FINA430)
739
+
740
+ | Aspecto | Detalhe |
741
+ |---------|---------|
742
+ | **Rotina** | FINA430 |
743
+ | **Tabelas** | SE2 (escrita), SE5 (escrita), SEA (escrita) |
744
+ | **O que acontece** | Arquivo de retorno do banco e processado. Ocorrencias confirmam ou rejeitam pagamentos. Titulos confirmados tem a baixa efetivada; rejeitados retornam ao status anterior. |
745
+ | **Resultado** | Titulos baixados ou devolvidos conforme retorno bancario |
746
+
747
+ #### Passo 6: Conciliacao Bancaria (FINA473/FINA380)
748
+
749
+ | Aspecto | Detalhe |
750
+ |---------|---------|
751
+ | **Rotina** | FINA473 (automatica) / FINA380 (manual) |
752
+ | **Tabelas** | SE5 (escrita - marca E5_RECONC), SIG (leitura) |
753
+ | **O que acontece** | Movimentos do sistema (SE5) sao confrontados com o extrato bancario importado (SIG). Movimentos conciliados sao marcados como reconciliados. Divergencias sao sinalizadas para tratamento manual. |
754
+ | **Resultado** | Movimentacoes conciliadas entre sistema e banco |
755
+
756
+ ### Fluxo Completo de Contas a Receber
757
+
758
+ ```
759
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
760
+ │ 1. Inclusao │────>│ 2. Bordero de │────>│ 3. CNAB │
761
+ │ Titulo a Receber│ │ Recebimento │ │ Remessa │
762
+ │ FINA040 / SE1 │ │ FINA060 / SEA │ │ (cobranca) │
763
+ └─────────────────┘ └─────────────────┘ └────────┬────────┘
764
+
765
+ ┌─────────────────┐ ┌─────────────────┐ ┌────────v────────┐
766
+ │ 5. Conciliacao │<────│ 4. Retorno │<────│ Envio ao │
767
+ │ Bancaria │ │ CNAB │ │ Banco │
768
+ │ FINA473/FINA380 │ │ FINA200 │ │ │
769
+ └─────────────────┘ └─────────────────┘ └─────────────────┘
770
+ ```
771
+
772
+ #### Passo 1: Inclusao do Titulo a Receber (FINA040 ou automatico)
773
+
774
+ | Aspecto | Detalhe |
775
+ |---------|---------|
776
+ | **Rotina** | FINA040 (manual) ou MATA461/MATA468 (automatico via faturamento) |
777
+ | **Tabelas** | SE1 (escrita), SED (leitura), SA1 (leitura) |
778
+ | **O que acontece** | Titulo e incluido com cliente, valor, vencimento e natureza. Se originado do Faturamento, e gerado automaticamente ao emitir nota fiscal de saida, desdobrado conforme condicao de pagamento. |
779
+ | **Resultado** | Registro(s) na SE1 com saldo em aberto |
780
+
781
+ #### Passo 2: Bordero de Recebimento / Transferencia (FINA060)
782
+
783
+ | Aspecto | Detalhe |
784
+ |---------|---------|
785
+ | **Rotina** | FINA060 |
786
+ | **Tabelas** | SE1 (escrita), SEA (escrita) |
787
+ | **O que acontece** | Titulos sao transferidos para carteira de cobranca (simples, descontada, caucionada). Podem ser agrupados em bordero para envio ao banco. |
788
+ | **Resultado** | Titulos vinculados na SEA com situacao de cobranca definida |
789
+
790
+ #### Passo 3: Remessa CNAB (cobranca)
791
+
792
+ | Aspecto | Detalhe |
793
+ |---------|---------|
794
+ | **O que acontece** | Arquivo de remessa CNAB de cobranca e gerado com instrucoes ao banco (cobrar, protestar, alterar vencimento, etc.). |
795
+ | **Resultado** | Arquivo CNAB enviado ao banco para cobranca |
796
+
797
+ #### Passo 4: Retorno CNAB (FINA200)
798
+
799
+ | Aspecto | Detalhe |
800
+ |---------|---------|
801
+ | **Rotina** | FINA200 |
802
+ | **Tabelas** | SE1 (escrita), SE5 (escrita), SEA (escrita) |
803
+ | **O que acontece** | Arquivo de retorno do banco e processado. Ocorrencias indicam: confirmacao de pagamento, rejeicao, protesto, alteracao de vencimento. Titulos pagos sao baixados automaticamente. |
804
+ | **Resultado** | Titulos baixados ou com instrucoes processadas |
805
+
806
+ ### Fluxo de Baixa Manual
807
+
808
+ ```
809
+ Titulo em aberto (SE1/SE2) → Baixa Manual (FINA070/FINA080) → Movimentacao Bancaria (SE5) → Saldo Bancario (SE8)
810
+ ```
811
+
812
+ ### Fluxo de Compensacao
813
+
814
+ ```
815
+ Titulo a Receber (SE1) + Titulo a Pagar (SE2) → Compensacao entre Carteiras (FINA450) → Abatimento mutuo de saldos
816
+ ```
817
+
818
+ ---
819
+
820
+ ## Regras de Negocio
821
+
822
+ ### Campos obrigatorios por rotina
823
+
824
+ **Contas a Receber (FINA040 - SE1):**
825
+ - E1_PREFIXO (Prefixo do titulo)
826
+ - E1_NUM (Numero do titulo)
827
+ - E1_TIPO (Tipo do titulo)
828
+ - E1_CLIENTE + E1_LOJA (Cliente)
829
+ - E1_NATUREZ (Natureza financeira)
830
+ - E1_EMISSAO (Data de emissao)
831
+ - E1_VENCTO (Data de vencimento)
832
+ - E1_VALOR (Valor do titulo)
833
+
834
+ **Contas a Pagar (FINA050 - SE2):**
835
+ - E2_PREFIXO (Prefixo do titulo)
836
+ - E2_NUM (Numero do titulo)
837
+ - E2_TIPO (Tipo do titulo)
838
+ - E2_FORNECE + E2_LOJA (Fornecedor)
839
+ - E2_NATUREZ (Natureza financeira)
840
+ - E2_EMISSAO (Data de emissao)
841
+ - E2_VENCTO (Data de vencimento)
842
+ - E2_VALOR (Valor do titulo)
843
+
844
+ **Baixa Manual a Pagar (FINA080 - SE5):**
845
+ - Banco/Agencia/Conta de pagamento
846
+ - Data da baixa
847
+ - Valor da baixa
848
+ - Motivo da baixa
849
+
850
+ **Baixa Manual a Receber (FINA070 - SE5):**
851
+ - Banco/Agencia/Conta de recebimento
852
+ - Data da baixa
853
+ - Valor recebido
854
+ - Motivo da baixa
855
+
856
+ ### Validacoes principais
857
+
858
+ | Validacao | Descricao |
859
+ |-----------|-----------|
860
+ | Saldo do titulo | O valor da baixa (parcial ou total) nunca pode ultrapassar o saldo em aberto do titulo (E1_SALDO ou E2_SALDO) |
861
+ | Titulo em bordero | Titulos vinculados a bordero somente podem ser baixados totalmente na FINA080; baixa parcial nao e permitida |
862
+ | Duplicidade de titulo | Verifica duplicidade de numero de titulo por cliente/fornecedor (chave unica: FILIAL + PREFIXO + NUM + PARCELA + TIPO + CLIFOR + LOJA) |
863
+ | Data da baixa | Data da baixa nao pode ser anterior a data de emissao do titulo (exceto se parametro permitir) |
864
+ | Natureza obrigatoria | Todo titulo deve ter natureza financeira valida cadastrada na SED |
865
+ | Retencoes tributarias | Se a natureza configurar calculo de retencoes (IRRF, PIS, COFINS, CSLL, ISS, INSS), os valores sao calculados automaticamente e deduzidos do titulo |
866
+ | Motivo de baixa | Na baixa manual, e obrigatorio informar motivo de baixa previamente cadastrado na tabela de motivos |
867
+ | Fornecedor/Cliente valido | Fornecedor (SE2→SA2) ou cliente (SE1→SA1) deve existir e nao estar bloqueado |
868
+ | Estorno de baixa | Ao estornar uma baixa, e gerado registro na SE5 com E5_SITUACA = 'E' (estorno), recompondo o saldo do titulo |
869
+
870
+ ### Gatilhos SX7 relevantes
871
+
872
+ | Campo origem | Campo destino | Regra | Tabela lookup |
873
+ |-------------|---------------|-------|---------------|
874
+ | E1_CLIENTE | E1_NOMCLI | SA1->A1_NREDUZ | SA1 |
875
+ | E1_NATUREZ | (retencoes) | SED->ED_CALCIRF, ED_CALCPIS, etc. | SED |
876
+ | E2_FORNECE | E2_NOMFOR | SA2->A2_NREDUZ | SA2 |
877
+ | E2_NATUREZ | (retencoes) | SED->ED_CALCIRF, ED_CALCPIS, etc. | SED |
878
+ | E1_VENCTO | E1_VENCREA | Calcula vencimento real (dias uteis) | - |
879
+ | E2_VENCTO | E2_VENCREA | Calcula vencimento real (dias uteis) | - |
880
+
881
+ ### Tipos de titulo mais comuns
882
+
883
+ | Tipo | Descricao | Carteira |
884
+ |------|-----------|----------|
885
+ | NF | Nota Fiscal / Duplicata | CP e CR |
886
+ | DP | Duplicata | CP e CR |
887
+ | CH | Cheque | CR |
888
+ | NCC | Nota de Credito ao Cliente | CR (credito) |
889
+ | RA | Recebimento Antecipado (adiantamento) | CR |
890
+ | PA | Pagamento Antecipado (adiantamento) | CP |
891
+ | TX | Impostos/Taxas | CP |
892
+ | PR | Provisao | CP |
893
+ | AB | Abatimento | CP e CR |
894
+ | NC | Nota de Credito ao Fornecedor | CP (credito) |
895
+
896
+ ### Pontos de entrada mais utilizados no modulo
897
+
898
+ | Ponto de Entrada | Rotina | Descricao |
899
+ |------------------|--------|-----------|
900
+ | FA040INC | FINA040 | Validacao customizada na inclusao do titulo a receber |
901
+ | M040SE1 | FINA040 | Pos-gravacao do titulo a receber |
902
+ | F050BROW | FINA050 | Pre-validacao no browse do contas a pagar |
903
+ | FA050GRV | FINA050 | Manipula dados antes da gravacao do titulo a pagar |
904
+ | F070VDATA | FINA070 | Validacao de dados da baixa a receber |
905
+ | F070INCSE5 | FINA070 | Manipula SE5 gerada pela baixa a receber |
906
+ | F080ACRE | FINA080 | Altera acrescimo/decrescimo na baixa a pagar |
907
+ | F080INCSE5 | FINA080 | Manipula SE5 gerada pela baixa a pagar |
908
+ | F060BORDE | FINA060 | Manipula dados do bordero de recebimento |
909
+ | F240MARK | FINA240 | Altera MarkBrowse do bordero de pagamento |
910
+ | F240PCB | FINA240 | Validacao do cancelamento de bordero |
911
+ | F241IRAN | FINA241 | Customizacao no bordero de impostos |
912
+ | FA200RET | FINA200 | Manipula dados do retorno CNAB a receber |
913
+ | FA430SE2 | FINA430 | Posiciona SE2 no retorno CNAB a pagar |
914
+ | F450GRAVA | FINA450 | Manipula SE1/SE2 na compensacao entre carteiras |
915
+ | FINALEG | Varias | Manipula legendas de cores no browse financeiro |
916
+
917
+ ---
918
+
919
+ ## Integracoes
920
+
921
+ ### Financeiro <-> Compras
922
+
923
+ | Aspecto | Detalhe |
924
+ |---------|---------|
925
+ | **Quando** | Na classificacao do Documento de Entrada (MATA103) |
926
+ | **O que acontece** | O modulo de Compras gera automaticamente titulos a pagar (SE2) ao classificar um documento de entrada. Os titulos sao desdobrados conforme a condicao de pagamento (SE4). O prefixo e numero do titulo sao baseados no numero da NF. A natureza financeira e determinada pela TES. |
927
+ | **Tabelas afetadas** | SE2 (Titulos a Pagar gerados automaticamente) |
928
+ | **Observacao** | O titulo fica disponivel no SIGAFIN para bordero, pagamento e baixa. Alteracoes no titulo via FINA050 nao retroagem ao documento de entrada |
929
+
930
+ ### Financeiro <-> Faturamento
931
+
932
+ | Aspecto | Detalhe |
933
+ |---------|---------|
934
+ | **Quando** | Na emissao da Nota Fiscal de Saida (MATA461/MATA468) |
935
+ | **O que acontece** | O modulo de Faturamento gera automaticamente titulos a receber (SE1) ao emitir nota fiscal de saida. Os titulos sao desdobrados conforme a condicao de pagamento (SE4). O prefixo, numero e tipo do titulo sao baseados nos dados da NF de saida. |
936
+ | **Tabelas afetadas** | SE1 (Titulos a Receber gerados automaticamente) |
937
+ | **Observacao** | Comissoes de vendedores (E1_VEND1..5 / E1_COMIS1..5) sao herdadas do pedido de venda ou configuracao do cadastro de clientes |
938
+
939
+ ### Financeiro -> Contabilidade
940
+
941
+ | Aspecto | Detalhe |
942
+ |---------|---------|
943
+ | **Quando** | Na inclusao de titulos (SE1/SE2), na baixa (FINA070/FINA080/FINA090/FINA110), na movimentacao bancaria (FINA100) e na compensacao |
944
+ | **O que acontece** | Gera lancamentos contabeis na CT2 conforme Lancamento Padrao (CT5) configurado. Na inclusao: debita contas de clientes/fornecedores e credita contas de receita/despesa. Na baixa: debita/credita contas de banco e abate o titulo. |
945
+ | **Tabelas afetadas** | CT2 (Lancamentos Contabeis) |
946
+ | **Parametro** | A contabilizacao e controlada pelo Lancamento Padrao (CT5) e pela flag MV_CTBFLAG |
947
+ | **Observacao** | A contabilizacao pode ser online (no momento da operacao) ou offline (via rotina CTBAFIN em lote) |
948
+
949
+ ### Financeiro -> Fiscal (Retencoes)
950
+
951
+ | Aspecto | Detalhe |
952
+ |---------|---------|
953
+ | **Quando** | Na inclusao e/ou baixa de titulos a pagar e a receber |
954
+ | **O que acontece** | Com base na natureza financeira (SED), o sistema calcula automaticamente as retencoes tributarias: IRRF, PIS, COFINS, CSLL, ISS e INSS. Os valores sao deduzidos do titulo e podem gerar titulos de imposto separados (tipo TX). As retencoes sao consideradas nas obrigacoes acessorias (EFD-REINF, DIRF, etc.). |
955
+ | **Tabelas afetadas** | SE2 (titulos de imposto gerados), SFT (escrituracao fiscal quando aplicavel) |
956
+ | **Observacao** | A configuracao de retencoes e feita na natureza financeira (SED) e nos parametros MV_ALIQIRF, MV_VLRETIR, MV_VRETPIS, MV_VRETCOF, MV_VRETCSL |
957
+
958
+ ### Resumo das integracoes do Financeiro
959
+
960
+ ```
961
+ Compras (MATA103) Faturamento (MATA461/468)
962
+ │ │
963
+ Gera SE2 Gera SE1
964
+ │ │
965
+ v v
966
+ ┌──────────────────────────────────────────────┐
967
+ │ FINANCEIRO (SIGAFIN) │
968
+ │ │
969
+ │ SE2 (Pagar) ◄──────────► SE1 (Receber) │
970
+ │ │ │ │
971
+ │ └──── SE5 (Mov.Bancaria) ┘ │
972
+ │ │ │
973
+ │ SE8 (Saldos) │
974
+ └───────────────┬──────────────┬───────────────┘
975
+ │ │
976
+ Gera CT2 Gera retencoes
977
+ │ │
978
+ v v
979
+ Contabilidade Fiscal
980
+ (CT2) (SFT / EFD)
981
+ ```
982
+
983
+ ---
984
+
985
+ ## Cadastros Auxiliares
986
+
987
+ | Rotina | Descricao | Tabela |
988
+ |--------|-----------|--------|
989
+ | FINA010 | Naturezas Financeiras | SED |
990
+ | FINA020 | Bancos | SA6 |
991
+ | FINA030 | Moedas | CTO |
992
+ | FINA140 | Ocorrencias CNAB | FI2 |
993
+ | CFGX043 | Configurador CNAB a Pagar | SX1/Tabelas CNAB |
994
+ | CFGX042 | Configurador CNAB a Receber | SX1/Tabelas CNAB |
995
+ | FINA986 | Complemento do Titulo (Pagar/Receber) | FKD |
996
+ | FINA250 | Rastreamento de Titulos | SE1/SE2/SE5 |
997
+ | FINA210 | Recalculo de Saldos Bancarios | SE8/SE5 |
998
+ | FINA380 | Conciliacao Bancaria Manual | SE5/SIG |
999
+ | FINA473 | Conciliacao Bancaria Automatica | SE5/SIG |
1000
+ | FINA710 | Novo Gestor Financeiro | F75/F76/SE1/SE2 |
1001
+
1002
+ ---
1003
+
1004
+ ## Parametros Globais do Modulo (MV_*)
1005
+
1006
+ | Parametro | Tipo | Descricao |
1007
+ |-----------|------|-----------|
1008
+ | MV_1DUP | C | Numero inicial da primeira duplicata |
1009
+ | MV_ALIQIRF | N | Aliquota padrao de IRRF |
1010
+ | MV_MASCNAT | C | Mascara do codigo da natureza do titulo financeiro (tipo C, padrao "19") |
1011
+ | MV_VLRETIR | N | Valor minimo para retencao de IRRF (padrao 10.00) |
1012
+ | MV_NUMBORP | C | Numeracao sequencial de borderos a pagar |
1013
+ | MV_NUMBORR | C | Numeracao sequencial de borderos a receber |
1014
+
1015
+ > **Nota:** Esta tabela contem apenas parametros confirmados no TDN e nos fontes do Protheus. Existem centenas de outros parametros MV_* utilizados pelo modulo Financeiro (impostos, retencoes, contabilizacao, integracao, etc.) que podem ser consultados diretamente na tabela SX6 do ambiente Protheus.