@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,874 @@
1
+ # Modulo de Contabilidade (CTB)
2
+
3
+ ## Visao Geral
4
+
5
+ O modulo de Contabilidade Gerencial (SIGACTB) do TOTVS Protheus e responsavel pelo controle e registro de todos os lancamentos contabeis da empresa. Ele centraliza a escrituracao contabil, gerando informacoes gerenciais e legais para a tomada de decisao e cumprimento das obrigacoes acessorias (SPED Contabil/ECD, ECF, LALUR). Integra-se com praticamente todos os modulos do Protheus, recebendo lancamentos automaticos (online ou offline) gerados a partir das operacoes de compras, faturamento, financeiro, estoque, fiscal, ativo fixo e folha de pagamento.
6
+
7
+ **Prefixo do modulo:** CTB
8
+ **Sigla do ambiente:** SIGACTB
9
+ **Prefixo das rotinas:** CTBA0xx (cadastros), CTBA1xx (processamentos), CTBA2xx (apuracoes), CTBR0xx (relatorios)
10
+
11
+ ### Ciclo principal da contabilidade
12
+
13
+ ```
14
+ Calendario Contabil → Plano de Contas → Lancamento Padrao → Lancamentos Contabeis (automaticos/manuais) → Conciliacao → Balancete → Apuracao de Resultado → DRE/Balanco → Fechamento Contabil
15
+ ```
16
+
17
+ O modulo suporta contabilizacao online (lancamentos gerados automaticamente no momento da operacao) e offline (lancamentos gerados em lote sob demanda do usuario). A configuracao e feita por meio dos Lancamentos Padronizados (CT5), que definem as regras de debito, credito e valores para cada tipo de operacao.
18
+
19
+ ---
20
+
21
+ ## Tabelas Principais
22
+
23
+ ### CT1 - Plano de Contas
24
+
25
+ Cadastro mestre das contas contabeis da empresa. Define a estrutura hierarquica do plano de contas com contas sinteticas (totalizadoras) e analiticas (que recebem lancamentos).
26
+
27
+ | Campo | Tipo | Tam | Descricao |
28
+ |-------|------|-----|-----------|
29
+ | CT1_FILIAL | C | 2 | Filial |
30
+ | CT1_CONTA | C | 20 | Codigo da conta contabil |
31
+ | CT1_DESC01 | C | 40 | Descricao da conta (moeda 1) |
32
+ | CT1_CLASSE | C | 1 | Classe: 1=Sintetica, 2=Analitica |
33
+ | CT1_NORMAL | C | 1 | Natureza normal: 1=Devedora, 2=Credora |
34
+ | CT1_RES | C | 10 | Codigo reduzido |
35
+ | CT1_BLOQ | C | 1 | Bloqueio: 1=Bloqueada, 2=Ativa |
36
+ | CT1_DTBLIN | D | 8 | Data inicio bloqueio |
37
+ | CT1_DTBLFI | D | 8 | Data fim bloqueio |
38
+ | CT1_CTASUP | C | 20 | Conta superior (hierarquia) |
39
+ | CT1_HP | C | 3 | Historico padrao vinculado |
40
+ | CT1_ACITEM | C | 1 | Aceita item contabil: 1=Sim, 2=Nao |
41
+ | CT1_ACCUST | C | 1 | Aceita centro de custo: 1=Sim, 2=Nao |
42
+ | CT1_ACCLVL | C | 1 | Aceita classe de valor: 1=Sim, 2=Nao |
43
+ | CT1_CCOBRG | C | 1 | Centro de custo obrigatorio: 1=Sim, 2=Nao |
44
+ | CT1_ITOBRG | C | 1 | Item contabil obrigatorio: 1=Sim, 2=Nao |
45
+ | CT1_CLOBRG | C | 1 | Classe de valor obrigatoria: 1=Sim, 2=Nao |
46
+ | CT1_DTEXIS | D | 8 | Data inicio existencia |
47
+ | CT1_DTEXSF | D | 8 | Data fim existencia |
48
+ | CT1_CTALP | C | 20 | Conta de lucros/perdas (apuracao) |
49
+ | CT1_CTAPON | C | 20 | Conta ponte lucros/perdas |
50
+ | CT1_NATCTA | C | 2 | Natureza da conta (regulamentar) |
51
+ | CT1_NTSPED | C | 2 | Natureza da conta SPED |
52
+ | CT1_SPEDST | C | 1 | Indicador sintetica SPED |
53
+ | CT1_LALUR | C | 1 | Tipo conta LALUR (0-5) |
54
+ | CT1_TPLALU | C | 2 | Classificacao LALUR |
55
+ | CT1_CTLALU | C | 20 | Conta LALUR vinculada |
56
+ | CT1_RATEIO | C | 6 | Codigo de rateio |
57
+ | CT1_ESTOUR | C | 1 | Conta estourada/invertida: 1=Sim, 2=Nao |
58
+ | CT1_BOOK | C | 20 | Configuracao de livros |
59
+ | CT1_GRUPO | C | 8 | Grupo contabil |
60
+ | CT1_AGLSLD | C | 1 | Aglutina saldos: 1=Sim, 2=Nao |
61
+ | CT1_CC | C | 9 | Centro de custo padrao |
62
+ | CT1_CTAVM | C | 20 | Conta de variacao monetaria |
63
+ | CT1_CTARED | C | 20 | Conta redutora de variacao |
64
+ | CT1_MOEDVM | C | 2 | Moeda forte para variacao |
65
+
66
+ **Indices principais:**
67
+ - Ordem 1: `CT1_FILIAL + CT1_CONTA`
68
+ - Ordem 2: `CT1_FILIAL + CT1_RES`
69
+
70
+ ---
71
+
72
+ ### CT2 - Lancamentos Contabeis
73
+
74
+ Tabela central do modulo, armazena todos os lancamentos contabeis da empresa. Cada registro representa uma linha de lancamento (debito ou credito). Os lancamentos podem ser gerados manualmente (CTBA102) ou automaticamente pela integracao com outros modulos (via Lancamento Padrao - CT5).
75
+
76
+ | Campo | Tipo | Tam | Descricao |
77
+ |-------|------|-----|-----------|
78
+ | CT2_FILIAL | C | 2 | Filial |
79
+ | CT2_DATA | D | 8 | Data do lancamento |
80
+ | CT2_LOTE | C | 6 | Numero do lote |
81
+ | CT2_SBLOTE | C | 3 | Sub-lote |
82
+ | CT2_DOC | C | 6 | Numero do documento |
83
+ | CT2_LINHA | C | 3 | Linha do lancamento |
84
+ | CT2_DC | C | 1 | Tipo: 1=Debito, 2=Credito, 3=Partida dobrada |
85
+ | CT2_DEBITO | C | 20 | Conta de debito |
86
+ | CT2_CREDIT | C | 20 | Conta de credito |
87
+ | CT2_VALOR | N | 14,2 | Valor do lancamento (moeda 1) |
88
+ | CT2_VALR02 | N | 14,2 | Valor na moeda 2 |
89
+ | CT2_VALR03 | N | 14,2 | Valor na moeda 3 |
90
+ | CT2_VALR04 | N | 14,2 | Valor na moeda 4 |
91
+ | CT2_VALR05 | N | 14,2 | Valor na moeda 5 |
92
+ | CT2_HP | C | 3 | Historico padrao |
93
+ | CT2_HIST | C | 40 | Historico do lancamento |
94
+ | CT2_CCD | C | 9 | Centro de custo debito |
95
+ | CT2_CCC | C | 9 | Centro de custo credito |
96
+ | CT2_ITEMD | C | 9 | Item contabil debito |
97
+ | CT2_ITEMC | C | 9 | Item contabil credito |
98
+ | CT2_CLVLDB | C | 9 | Classe de valor debito |
99
+ | CT2_CLVLCR | C | 9 | Classe de valor credito |
100
+ | CT2_MOEDLC | C | 2 | Moeda do lancamento (padrao "01") |
101
+ | CT2_TPSALD | C | 1 | Tipo de saldo |
102
+ | CT2_LP | C | 3 | Codigo do lancamento padrao origem |
103
+ | CT2_MANUAL | C | 1 | Lancamento manual (S/N) |
104
+ | CT2_ORIGEM | C | 100 | Origem do lancamento |
105
+ | CT2_ROTINA | C | 10 | Rotina geradora |
106
+ | CT2_EMPORI | C | 2 | Empresa de origem |
107
+ | CT2_FILORI | C | 2 | Filial de origem |
108
+ | CT2_INTERC | C | 1 | Indicador intercompany |
109
+ | CT2_AGLUT | C | 1 | Lancamento aglutinado |
110
+ | CT2_SEQUEN | C | 10 | Vinculo com CTK (prova contabil) |
111
+ | CT2_SEQLAN | C | 3 | Sequencia do lancamento |
112
+ | CT2_SEQHIS | C | 3 | Sequencia do historico |
113
+ | CT2_DTVENC | D | 8 | Data de vencimento |
114
+ | CT2_DTLP | D | 8 | Data apuracao lucros/perdas |
115
+ | CT2_CODCLI | C | 6 | Codigo do cliente |
116
+ | CT2_CODFOR | C | 6 | Codigo do fornecedor |
117
+ | CT2_CODPAR | C | 6 | Codigo do participante |
118
+ | CT2_CONFST | C | 1 | Status de verificacao |
119
+ | CT2_USRCNF | C | 15 | Usuario que verificou |
120
+ | CT2_DTCONF | D | 8 | Data da verificacao |
121
+ | CT2_ESTCAN | C | 1 | Indicador de estorno/cancelamento |
122
+ | CT2_IDCONC | C | 23 | Identificador de conciliacao |
123
+ | CT2_INCONS | C | 1 | Indicador de inconsistencia contabil |
124
+ | CT2_PROCES | C | 32 | Codigo do processo contabil |
125
+ | CT2_SEQIDX | C | 5 | Sequencia da chave unica |
126
+
127
+ **Indices principais:**
128
+ - Ordem 1: `CT2_FILIAL + DTOS(CT2_DATA) + CT2_LOTE + CT2_SBLOTE + CT2_DOC + CT2_LINHA + CT2_MOEDLC`
129
+ - Ordem 2: `CT2_FILIAL + CT2_DEBITO + DTOS(CT2_DATA)`
130
+ - Ordem 3: `CT2_FILIAL + CT2_CREDIT + DTOS(CT2_DATA)`
131
+
132
+ ---
133
+
134
+ ### CT5 - Lancamento Padrao
135
+
136
+ Define as regras de contabilizacao automatica utilizadas por todos os modulos do Protheus. Cada lancamento padrao (LP) possui uma ou mais sequencias (linhas) que determinam conta de debito, credito, valor e historico atraves de expressoes ADVPL que referenciam campos das tabelas de origem.
137
+
138
+ | Campo | Tipo | Tam | Descricao |
139
+ |-------|------|-----|-----------|
140
+ | CT5_FILIAL | C | 2 | Filial |
141
+ | CT5_LANPAD | C | 3 | Codigo do lancamento padrao |
142
+ | CT5_SEQUEN | C | 3 | Sequencia (linha do LP) |
143
+ | CT5_DESC | C | 40 | Descricao do lancamento padrao |
144
+ | CT5_STATUS | C | 1 | Status: Ativo/Inativo |
145
+ | CT5_DC | C | 1 | Tipo: Debito/Credito/Partida dobrada/Historico |
146
+ | CT5_DEBITO | C | 200 | Conta de debito (expressao ADVPL) |
147
+ | CT5_CREDIT | C | 200 | Conta de credito (expressao ADVPL) |
148
+ | CT5_VLR01 | C | 200 | Valor na moeda 1 (expressao ADVPL) |
149
+ | CT5_VLR02 | C | 200 | Valor na moeda 2 |
150
+ | CT5_VLR03 | C | 200 | Valor na moeda 3 |
151
+ | CT5_VLR04 | C | 200 | Valor na moeda 4 |
152
+ | CT5_VLR05 | C | 200 | Valor na moeda 5 |
153
+ | CT5_HIST | C | 200 | Historico (expressao ADVPL) |
154
+ | CT5_HAGLUT | C | 200 | Historico de aglutinacao |
155
+ | CT5_CCD | C | 200 | Centro de custo debito (expressao) |
156
+ | CT5_CCC | C | 200 | Centro de custo credito (expressao) |
157
+ | CT5_ITEMD | C | 200 | Item contabil debito (expressao) |
158
+ | CT5_ITEMC | C | 200 | Item contabil credito (expressao) |
159
+ | CT5_CLVLDB | C | 200 | Classe de valor debito (expressao) |
160
+ | CT5_CLVLCR | C | 200 | Classe de valor credito (expressao) |
161
+ | CT5_MOEDLC | C | 2 | Moeda do lancamento |
162
+ | CT5_SBLOTE | C | 3 | Sub-lote |
163
+ | CT5_TPSALD | C | 1 | Tipo de saldo |
164
+ | CT5_ORIGEM | C | 100 | Identificador da origem |
165
+ | CT5_TABORI | C | 100 | Nome da tabela de origem |
166
+ | CT5_RECORI | C | 100 | Funcao para record da tabela origem |
167
+ | CT5_ROTRAS | C | 60 | Rotina de visualizacao do rastreamento |
168
+ | CT5_INTERC | C | 1 | Lancamento intercompany |
169
+ | CT5_MOEDAS | C | 5 | Indicador de moedas utilizadas |
170
+ | CT5_DTVENC | C | 200 | Data de vencimento (expressao) |
171
+ | CT5_DIACTB | C | 50 | Codigo do diario contabil |
172
+ | CT5_OBS | M | 255 | Observacoes |
173
+
174
+ **Indices principais:**
175
+ - Ordem 1: `CT5_FILIAL + CT5_LANPAD + CT5_SEQUEN`
176
+
177
+ ---
178
+
179
+ ### CTT - Centro de Custo
180
+
181
+ Cadastro dos centros de custo da empresa. Os centros de custo sao entidades contabeis que permitem classificar receitas e despesas por departamento, area ou projeto. Podem ser sinteticos (totalizadores) ou analiticos (recebem lancamentos).
182
+
183
+ | Campo | Tipo | Tam | Descricao |
184
+ |-------|------|-----|-----------|
185
+ | CTT_FILIAL | C | 2 | Filial |
186
+ | CTT_CUSTO | C | 9 | Codigo do centro de custo |
187
+ | CTT_DESC01 | C | 40 | Descricao (moeda 1) |
188
+ | CTT_CLASSE | C | 1 | Classe: 1=Sintetica, 2=Analitica |
189
+ | CTT_NORMAL | C | 1 | Classificacao: 1=Despesa, 2=Receita |
190
+ | CTT_BLOQ | C | 1 | Bloqueio: 1=Bloqueado, 2=Ativo |
191
+ | CTT_DTBLIN | D | 8 | Data inicio bloqueio |
192
+ | CTT_DTBLFI | D | 8 | Data fim bloqueio |
193
+ | CTT_DTEXIS | D | 8 | Data inicio existencia |
194
+ | CTT_DTEXSF | D | 8 | Data fim existencia |
195
+ | CTT_CCSUP | C | 9 | Centro de custo superior (hierarquia) |
196
+ | CTT_CCLP | C | 9 | Centro de custo de apuracao lucros/perdas |
197
+ | CTT_CCPON | C | 9 | Centro de custo ponte para resultado |
198
+ | CTT_RES | C | 10 | Codigo reduzido |
199
+ | CTT_BOOK | C | 20 | Configuracao de livros |
200
+ | CTT_STATUS | C | 1 | Status: Ativo/Inativo |
201
+ | CTT_ACITEM | C | 1 | Aceita item contabil |
202
+ | CTT_ACCLVL | C | 1 | Aceita classe de valor |
203
+ | CTT_ITOBRG | C | 1 | Item contabil obrigatorio |
204
+ | CTT_CLOBRG | C | 1 | Classe de valor obrigatoria |
205
+ | CTT_CCVM | C | 9 | Centro de custo variacao monetaria |
206
+ | CTT_CCRED | C | 9 | Centro de custo redutor |
207
+ | CTT_LOCAL | C | 2 | Codigo do armazem |
208
+ | CTT_FILMAT | C | 2 | Filial do responsavel |
209
+ | CTT_MAT | C | 6 | Matricula do responsavel |
210
+
211
+ **Indices principais:**
212
+ - Ordem 1: `CTT_FILIAL + CTT_CUSTO`
213
+ - Ordem 2: `CTT_FILIAL + CTT_RES`
214
+
215
+ ---
216
+
217
+ ### CTH - Classe de Valor
218
+
219
+ Cadastro das classes de valor, que representam uma classificacao adicional para os lancamentos contabeis alem da conta contabil e centro de custo. Permitem analisar receitas e despesas sob diferentes perspectivas gerenciais.
220
+
221
+ | Campo | Tipo | Tam | Descricao |
222
+ |-------|------|-----|-----------|
223
+ | CTH_FILIAL | C | 2 | Filial |
224
+ | CTH_CLVL | C | 9 | Codigo da classe de valor |
225
+ | CTH_DESC01 | C | 40 | Descricao (moeda 1) |
226
+ | CTH_CLASSE | C | 1 | Classe: 1=Sintetica, 2=Analitica |
227
+ | CTH_NORMAL | C | 1 | Classificacao: 0=Nenhuma, 1=Despesa, 2=Receita |
228
+ | CTH_BLOQ | C | 1 | Bloqueio: 1=Bloqueada, 2=Ativa |
229
+ | CTH_DTBLIN | D | 8 | Data inicio bloqueio |
230
+ | CTH_DTBLFI | D | 8 | Data fim bloqueio |
231
+ | CTH_DTEXIS | D | 8 | Data inicio existencia |
232
+ | CTH_DTEXSF | D | 8 | Data fim existencia |
233
+ | CTH_CLSUP | C | 9 | Classe de valor superior (hierarquia) |
234
+ | CTH_CLVLLP | C | 9 | Classe de valor apuracao resultado |
235
+ | CTH_CLPON | C | 9 | Classe de valor ponte lucros/perdas |
236
+ | CTH_RES | C | 10 | Codigo reduzido |
237
+ | CTH_BOOK | C | 20 | Configuracao de livros |
238
+ | CTH_CLVM | C | 9 | Classe de valor variacao monetaria |
239
+ | CTH_CLRED | C | 9 | Classe de valor redutora |
240
+
241
+ **Indices principais:**
242
+ - Ordem 1: `CTH_FILIAL + CTH_CLVL`
243
+ - Ordem 2: `CTH_FILIAL + CTH_RES`
244
+
245
+ ---
246
+
247
+ ### CT8 - Historico Padrao
248
+
249
+ Cadastro dos historicos padrao que podem ser vinculados aos lancamentos contabeis para padronizar a descricao textual dos lancamentos.
250
+
251
+ | Campo | Tipo | Tam | Descricao |
252
+ |-------|------|-----|-----------|
253
+ | CT8_FILIAL | C | 2 | Filial |
254
+ | CT8_HIST | C | 3 | Codigo do historico padrao |
255
+ | CT8_DESC | C | 48 | Descricao do historico |
256
+ | CT8_IDENT | C | 1 | Identificador do registro |
257
+ | CT8_SEQUEN | C | 6 | Sequencia do historico inteligente |
258
+
259
+ **Indices principais:**
260
+ - Ordem 1: `CT8_FILIAL + CT8_HIST + CT8_SEQUEN`
261
+
262
+ ---
263
+
264
+ ### CTG - Calendario Contabil
265
+
266
+ Define os periodos contabeis do exercicio fiscal. Controla a abertura, fechamento e bloqueio de periodos para lancamentos.
267
+
268
+ | Campo | Tipo | Tam | Descricao |
269
+ |-------|------|-----|-----------|
270
+ | CTG_FILIAL | C | 2 | Filial |
271
+ | CTG_CALEND | C | 3 | Codigo do calendario |
272
+ | CTG_PERIOD | C | 2 | Periodo (01 a 12) |
273
+ | CTG_DTINI | D | 8 | Data inicio do periodo |
274
+ | CTG_DTFIM | D | 8 | Data fim do periodo |
275
+ | CTG_STATUS | C | 1 | Status: Aberto/Fechado/Bloqueado |
276
+ | CTG_DESC | C | 40 | Descricao do calendario |
277
+
278
+ ---
279
+
280
+ ### CV1 - Itens do Orcamento Contabil
281
+
282
+ Armazena os valores orcados por conta contabil, centro de custo e periodo, permitindo a comparacao entre orcado e realizado nos relatorios contabeis.
283
+
284
+ | Campo | Tipo | Tam | Descricao |
285
+ |-------|------|-----|-----------|
286
+ | CV1_FILIAL | C | 2 | Filial |
287
+ | CV1_ORCMTO | C | 3 | Codigo do orcamento |
288
+ | CV1_CALEND | C | 3 | Calendario contabil |
289
+ | CV1_MOEDA | C | 2 | Moeda |
290
+ | CV1_REVISA | C | 3 | Revisao do orcamento |
291
+ | CV1_SEQUEN | C | 3 | Sequencia |
292
+ | CV1_PERIOD | C | 2 | Periodo |
293
+
294
+ **Indices principais:**
295
+ - Ordem 1: `CV1_FILIAL + CV1_ORCMTO + CV1_CALEND + CV1_MOEDA + CV1_REVISA + CV1_SEQUEN + CV1_PERIOD`
296
+
297
+ ---
298
+
299
+ ### CTK - Prova Contabil (Arquivo Comprovante)
300
+
301
+ Armazena os dados complementares dos lancamentos contabeis para fins de rastreabilidade. Vinculada a CT2 pelo campo CT2_SEQUEN.
302
+
303
+ | Campo | Tipo | Tam | Descricao |
304
+ |-------|------|-----|-----------|
305
+ | CTK_FILIAL | C | 2 | Filial |
306
+ | CTK_SEQ | C | 10 | Sequencia (vinculo com CT2_SEQUEN) |
307
+ | CTK_DATA | D | 8 | Data do lancamento |
308
+ | CTK_LOTE | C | 6 | Numero do lote |
309
+ | CTK_SBLOTE | C | 3 | Sub-lote |
310
+ | CTK_DOC | C | 6 | Documento |
311
+ | CTK_TPSALD | C | 1 | Tipo de saldo |
312
+
313
+ ---
314
+
315
+ ### CV3 - Rastreamento Contabil
316
+
317
+ Permite rastrear a origem dos lancamentos contabeis, identificando qual registro e modulo gerou cada lancamento na CT2.
318
+
319
+ | Campo | Tipo | Tam | Descricao |
320
+ |-------|------|-----|-----------|
321
+ | CV3_FILIAL | C | 2 | Filial |
322
+ | CV3_TABORI | C | 3 | Tabela de origem (ex: SD1, SE2) |
323
+ | CV3_RECORI | C | 10 | RecNo do registro de origem |
324
+ | CV3_SEQCTK | C | 10 | Sequencia do comprovante (CTK) |
325
+ | CV3_DATA | D | 8 | Data do lancamento |
326
+
327
+ ---
328
+
329
+ ## Rotinas Principais
330
+
331
+ ### CTBA010 - Calendario Contabil
332
+
333
+ **O que faz:** Define os periodos contabeis do exercicio fiscal. Permite incluir, alterar e excluir calendarios, bem como abrir, fechar e bloquear periodos. Inclui funcionalidade de "Bloqueio por Processo" que permite bloquear movimentacoes de outros modulos durante o fechamento contabil.
334
+
335
+ **Tabelas envolvidas:**
336
+ - CTG (escrita) - Calendario Contabil
337
+ - CTE (escrita) - Moeda x Calendario
338
+ - CQD (escrita) - Bloqueio do Calendario Contabil
339
+
340
+ **Parametros relevantes:**
341
+ | Parametro | Descricao |
342
+ |-----------|-----------|
343
+ | MV_CTBPOFF | Habilita bloqueio por processo |
344
+
345
+ ---
346
+
347
+ ### CTBA020 - Plano de Contas (Conta Contabil)
348
+
349
+ **O que faz:** Cadastro e manutencao do plano de contas da empresa. Permite incluir, alterar, excluir, bloquear e visualizar contas contabeis. As contas podem ser sinteticas (totalizadoras) ou analiticas (recebem lancamentos). Suporta importacao de contas via arquivo TXT (acelerador MILE) e integracao via rotina automatica.
350
+
351
+ **Tabelas envolvidas:**
352
+ - CT1 (escrita) - Plano de Contas
353
+ - CVD (escrita) - Detalhe do Plano de Contas
354
+ - CVN (escrita) - Natureza do Plano de Contas
355
+
356
+ **Parametros relevantes:**
357
+ | Parametro | Descricao |
358
+ |-----------|-----------|
359
+ | MV_MASCARA | Mascara contabil (formato da conta, ex: "??.???.??.???") |
360
+ | MV_CTASUP | Geracao automatica da conta superior |
361
+
362
+ **Pontos de entrada:**
363
+ | Ponto de Entrada | Descricao |
364
+ |------------------|-----------|
365
+ | CTA020TOK | Validacao customizada na confirmacao do cadastro de conta |
366
+ | CT020ADEL | Verificacao de integridade referencial antes da exclusao |
367
+ | CT020GRE | Execucao apos exclusao da conta contabil |
368
+
369
+ ---
370
+
371
+ ### CTBA030 - Centro de Custo
372
+
373
+ **O que faz:** Cadastro e manutencao dos centros de custo. Permite inclusao, alteracao, exclusao e visualizacao. Centros de custo podem ser sinteticos (totalizadores) ou analiticos (recebem lancamentos). Suporta visualizacao em arvore hierarquica e integracao via EAI.
374
+
375
+ **Tabelas envolvidas:**
376
+ - CTT (escrita) - Centro de Custo
377
+ - CT1 (leitura) - Plano de Contas (validacao)
378
+
379
+ **Parametros relevantes:**
380
+ | Parametro | Descricao |
381
+ |-----------|-----------|
382
+ | MV_CCSUP | Geracao automatica do centro de custo superior |
383
+
384
+ **Pontos de entrada:**
385
+ | Ponto de Entrada | Descricao |
386
+ |------------------|-----------|
387
+ | CT030ADEL | Verifica integridade referencial do CC antes da exclusao |
388
+ | CT030GRE | Executado apos exclusao do centro de custo |
389
+ | CTA030TOK | Validacao customizada na confirmacao do cadastro |
390
+ | CTB030VLD | Valida confirmacao na inclusao e alteracao |
391
+ | CT030BUT | Customiza botoes na rotina de cadastro |
392
+
393
+ ---
394
+
395
+ ### CTBA060 - Classe de Valor
396
+
397
+ **O que faz:** Cadastro e manutencao das classes de valor. Entidade contabil complementar que permite classificar lancamentos sob perspectivas gerenciais adicionais. Suporta integracao via mensagem unica (EAI).
398
+
399
+ **Tabelas envolvidas:**
400
+ - CTH (escrita) - Classe de Valor
401
+
402
+ ---
403
+
404
+ ### CTBA080 - Lancamento Padrao
405
+
406
+ **O que faz:** Cadastro e manutencao dos lancamentos padronizados (LP). Os LPs sao o elo entre os diversos modulos do Protheus e a Contabilidade Gerencial, definindo regras automaticas de contabilizacao. Cada LP contem expressoes ADVPL que determinam contas de debito, credito, valores e historicos a partir dos dados da tabela de origem.
407
+
408
+ **Tabelas envolvidas:**
409
+ - CT5 (escrita) - Lancamento Padrao
410
+ - CT1 (leitura) - Plano de Contas (validacao das contas)
411
+
412
+ **Fontes relacionados:**
413
+ | Fonte | Descricao |
414
+ |-------|-----------|
415
+ | CTBA080a | Disponibiliza o LP para o modulo de origem (funcao ChkCVA) |
416
+ | CTBA086 | Visualizacao em arvore do LP |
417
+ | CTBXCTB | Determina a tabela de origem do lancamento (funcao RetRecnoLP) |
418
+ | CTBA090 | Cadastro de relacionamento para rastreamento |
419
+
420
+ **Tipos de contabilizacao:**
421
+ | Tipo | Descricao |
422
+ |------|-----------|
423
+ | Online | Lancamentos gerados automaticamente no momento da operacao |
424
+ | Offline | Lancamentos gerados em lote quando o usuario solicita via menu Miscelanea > Contabilizacao Off-Line |
425
+
426
+ ---
427
+
428
+ ### CTBA102 - Lancamentos Contabeis Manuais
429
+
430
+ **O que faz:** Permite incluir, alterar, excluir, copiar e estornar lancamentos contabeis manuais. Cada lancamento e composto por data, lote, sub-lote, documento e linhas de debito/credito. Tambem utilizado como rotina automatica para inclusao de lancamentos via codigo ADVPL.
431
+
432
+ **Tabelas envolvidas:**
433
+ - CT2 (escrita) - Lancamentos Contabeis
434
+ - CTK (escrita) - Prova Contabil
435
+ - CV3 (escrita) - Rastreamento Contabil
436
+ - CT1 (leitura) - Plano de Contas (validacao)
437
+ - CTT (leitura) - Centro de Custo (validacao)
438
+ - CTH (leitura) - Classe de Valor (validacao)
439
+ - CTG (leitura) - Calendario Contabil (validacao de periodo)
440
+
441
+ **Parametros relevantes:**
442
+ | Parametro | Descricao |
443
+ |-----------|-----------|
444
+ | MV_ALTLCTO | Permite alteracao de linhas no lancamento (S/N) |
445
+ | MV_LOTECON | Geracao de numero de lote: T=Tabela 09, U=Ultimo+1 |
446
+
447
+ **Pontos de entrada:**
448
+ | Ponto de Entrada | Descricao |
449
+ |------------------|-----------|
450
+ | CT102VLENT | Validacao das entidades contabeis no momento da gravacao |
451
+ | Ct102Carr | Manipulacao da leitura do TMP na CTBA102 |
452
+ | CT102MNU | Customiza menu da rotina |
453
+ | CT102INC | Executado na inclusao de lancamentos |
454
+
455
+ ---
456
+
457
+ ### CTBA105 - Contabilizacao Online (Integracao Contabil)
458
+
459
+ **O que faz:** Rotina de integracao contabil utilizada por todos os modulos do Protheus para gerar lancamentos contabeis online. Processa os Lancamentos Padrao (CT5) associados a operacao e gera os registros na CT2. Utilizada internamente pelas rotinas de outros modulos (Financeiro, Compras, Faturamento, Estoque, etc.).
460
+
461
+ **Tabelas envolvidas:**
462
+ - CT2 (escrita) - Lancamentos Contabeis
463
+ - CTK (escrita) - Prova Contabil
464
+ - CV3 (escrita) - Rastreamento Contabil
465
+ - CT5 (leitura) - Lancamento Padrao
466
+ - CT1 (leitura) - Plano de Contas
467
+
468
+ **Parametros relevantes:**
469
+ | Parametro | Descricao |
470
+ |-----------|-----------|
471
+ | MV_CT105MS | Exibe mensagem na integracao contabil (S/N) |
472
+
473
+ **Pontos de entrada:**
474
+ | Ponto de Entrada | Descricao |
475
+ |------------------|-----------|
476
+ | CT105VLENT | Validacao das entidades contabeis na gravacao |
477
+ | GRVCT3 | Manipulacao apos gravacao (performance) |
478
+ | GRVCT4 | Manipulacao apos gravacao (performance) |
479
+ | GRVCT7 | Manipulacao apos gravacao (performance) |
480
+ | GRVCTI | Manipulacao apos gravacao (performance) |
481
+
482
+ ---
483
+
484
+ ### CTBA211 - Apuracao de Resultado
485
+
486
+ **O que faz:** Realiza o levantamento e cruzamento dos valores de receitas e despesas em um determinado periodo para obter o resultado contabil (lucro ou prejuizo). Transfere os saldos das contas de resultado para a conta de Lucros/Perdas (CT1_CTALP) mediante lancamentos automaticos de encerramento. A rotina CTBA210 foi descontinuada em favor da CTBA211.
487
+
488
+ **Tabelas envolvidas:**
489
+ - CT2 (escrita) - Lancamentos Contabeis (lancamentos de apuracao)
490
+ - CT1 (leitura) - Plano de Contas (identifica contas de resultado)
491
+ - CTT (leitura) - Centro de Custo (apuracao por CC)
492
+ - CTH (leitura) - Classe de Valor (apuracao por CLVL)
493
+ - CQ0/CQ1 (leitura) - Saldos Contabeis
494
+
495
+ **Parametros relevantes:**
496
+ | Parametro | Descricao |
497
+ |-----------|-----------|
498
+
499
+ ---
500
+
501
+ ### CTBR040 - Balancete
502
+
503
+ **O que faz:** Emite o relatorio de balancete contabil (Modelo 1), exibindo os saldos das contas contabeis em um determinado periodo. Apresenta saldo anterior, movimentacao a debito e credito, e saldo atual. Permite exportacao para Excel e impressao com margens customizaveis.
504
+
505
+ **Tabelas envolvidas:**
506
+ - CQ0/CQ1 (leitura) - Saldos Contabeis
507
+ - CT1 (leitura) - Plano de Contas
508
+ - CT2 (leitura) - Lancamentos Contabeis
509
+
510
+ **Parametros relevantes:**
511
+ | Parametro | Descricao |
512
+ |-----------|-----------|
513
+ | MV_TPVALOR | Formato de numeros no relatorio |
514
+ | MV_CTBPOFF | Customizacao de relatorios contabeis |
515
+
516
+ ---
517
+
518
+ ### CTBR400 - Razao Contabil
519
+
520
+ **O que faz:** Emite o relatorio de razao contabil, que apresenta todos os lancamentos de uma determinada conta contabil em um periodo, com saldo acumulado. E um dos relatorios oficiais exigidos pela legislacao brasileira.
521
+
522
+ **Tabelas envolvidas:**
523
+ - CT2 (leitura) - Lancamentos Contabeis
524
+ - CT1 (leitura) - Plano de Contas
525
+ - CTT (leitura) - Centro de Custo
526
+
527
+ ---
528
+
529
+ ### CTBR110 - Diario Contabil
530
+
531
+ **O que faz:** Emite o relatorio do diario contabil, que apresenta todos os lancamentos em ordem cronologica. E um dos relatorios oficiais exigidos pela legislacao brasileira, junto com o Razao e o Balancete.
532
+
533
+ **Tabelas envolvidas:**
534
+ - CT2 (leitura) - Lancamentos Contabeis
535
+ - CT1 (leitura) - Plano de Contas
536
+
537
+ ---
538
+
539
+ ### CTBA940 - Conciliador Backoffice
540
+
541
+ **O que faz:** Plataforma unificada de conciliacao contabil e financeira. Permite confrontar os lancamentos contabeis (CT2) com os registros dos modulos de origem (Financeiro, Compras, Faturamento, Estoque), identificando divergencias. Suporta conciliacao bancaria manual e automatica.
542
+
543
+ **Tabelas envolvidas:**
544
+ - CT2 (leitura) - Lancamentos Contabeis
545
+ - SE2 (leitura) - Titulos a Pagar
546
+ - SE1 (leitura) - Titulos a Receber
547
+ - SD1 (leitura) - Itens NF Entrada
548
+ - SD2 (leitura) - Itens NF Saida
549
+
550
+ ---
551
+
552
+ ### CTBA960 - Fechamento Contabil
553
+
554
+ **O que faz:** Controla o processo de fechamento contabil do periodo. Permite monitorar o status dos lancamentos de todos os modulos integrados, definir responsaveis por modulo/tabela, enviar notificacoes por e-mail em caso de atraso, e bloquear calendarios e processos contabeis do periodo selecionado ao final do fechamento.
555
+
556
+ **Tabelas envolvidas:**
557
+ - CTG (escrita) - Calendario Contabil (bloqueio do periodo)
558
+ - CQD (escrita) - Bloqueio do Calendario
559
+ - CT2 (leitura) - Lancamentos Contabeis (verificacao de completude)
560
+
561
+ ---
562
+
563
+ ### CTBS001 - SPED Contabil (ECD)
564
+
565
+ **O que faz:** Gera o arquivo da Escrituracao Contabil Digital (ECD) para entrega ao SPED. Requer calendario contabil com 12 periodos (ou periodos especiais), plano de contas referencial e contas com natureza SPED preenchida.
566
+
567
+ **Tabelas envolvidas:**
568
+ - CT1 (leitura) - Plano de Contas
569
+ - CT2 (leitura) - Lancamentos Contabeis
570
+ - CTG (leitura) - Calendario Contabil
571
+ - CTT (leitura) - Centro de Custo
572
+
573
+ ---
574
+
575
+ ## Processos de Negocio
576
+
577
+ ### Fluxo Completo da Contabilidade
578
+
579
+ ```
580
+ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
581
+ │ 1. Calendario │────>│ 2. Plano de │────>│ 3. Entidades │
582
+ │ Contabil │ │ Contas │ │ Contabeis │
583
+ │ CTBA010 / CTG │ │ CTBA020 / CT1 │ │ CTT, CTH, CTD │
584
+ └─────────────────┘ └─────────────────┘ └────────┬────────┘
585
+
586
+ ┌─────────────────┐ ┌─────────────────┐ ┌────────v────────┐
587
+ │ 6. Balancete │<────│ 5. Conciliacao │<────│ 4. Lancamentos │
588
+ │ e Razao │ │ │ │ Contabeis │
589
+ │ CTBR040/CTBR400 │ │ CTBA940 │ │ CTBA102/CTBA105 │
590
+ └────────┬────────┘ └─────────────────┘ └─────────────────┘
591
+
592
+ ┌────────v────────┐ ┌─────────────────┐ ┌─────────────────┐
593
+ │ 7. Apuracao de │────>│ 8. DRE / Balanco│────>│ 9. Fechamento │
594
+ │ Resultado │ │ Patrimonial │ │ e SPED (ECD) │
595
+ │ CTBA211 │ │ CTBR040 │ │ CTBA960/CTBS001 │
596
+ └─────────────────┘ └─────────────────┘ └─────────────────┘
597
+ ```
598
+
599
+ #### Passo 1: Calendario Contabil (CTBA010)
600
+
601
+ | Aspecto | Detalhe |
602
+ |---------|---------|
603
+ | **Rotina** | CTBA010 |
604
+ | **Tabelas** | CTG (escrita), CTE (escrita) |
605
+ | **O que acontece** | Definicao dos periodos contabeis do exercicio fiscal (normalmente 12 periodos mensais). O calendario controla quais periodos estao abertos para lancamentos. Deve ser criado antes de qualquer operacao contabil. |
606
+ | **Resultado** | Calendario com periodos definidos (datas inicio/fim) e status inicial "Aberto" |
607
+
608
+ #### Passo 2: Plano de Contas (CTBA020)
609
+
610
+ | Aspecto | Detalhe |
611
+ |---------|---------|
612
+ | **Rotina** | CTBA020 |
613
+ | **Tabelas** | CT1 (escrita), CVD (escrita), CVN (escrita) |
614
+ | **O que acontece** | Cadastro da estrutura hierarquica de contas contabeis. Contas sinteticas agrupam contas analiticas. Cada conta analitica deve ter definida sua natureza (devedora/credora), se aceita centro de custo, item contabil e classe de valor, e a conta de lucros/perdas para apuracao de resultado. |
615
+ | **Resultado** | Plano de contas estruturado com contas sinteticas e analiticas |
616
+
617
+ #### Passo 3: Entidades Contabeis (CTBA030, CTBA060)
618
+
619
+ | Aspecto | Detalhe |
620
+ |---------|---------|
621
+ | **Rotinas** | CTBA030 (Centro de Custo), CTBA060 (Classe de Valor) |
622
+ | **Tabelas** | CTT (escrita), CTH (escrita) |
623
+ | **O que acontece** | Cadastro das entidades complementares: centros de custo por departamento/area e classes de valor para classificacao gerencial. Ambas podem ser sinteticas ou analiticas. |
624
+ | **Resultado** | Entidades contabeis disponiveis para uso nos lancamentos |
625
+
626
+ #### Passo 4: Lancamentos Contabeis (CTBA102 / CTBA105)
627
+
628
+ | Aspecto | Detalhe |
629
+ |---------|---------|
630
+ | **Rotinas** | CTBA102 (manual), CTBA105 (integracao online), Contabilizacao Off-Line (lote) |
631
+ | **Tabelas** | CT2 (escrita), CTK (escrita), CV3 (escrita) |
632
+ | **O que acontece** | Os lancamentos sao gerados de duas formas: (a) manualmente pelo usuario via CTBA102, informando data, contas, valores e historico; (b) automaticamente pela integracao com outros modulos (Compras, Financeiro, Faturamento, Estoque, Fiscal) via Lancamento Padrao (CT5). O sistema valida periodo aberto no calendario, contas existentes e desbloqueadas, e entidades obrigatorias. |
633
+ | **Resultado** | Registros na CT2 com debitos e creditos balanceados |
634
+
635
+ #### Passo 5: Conciliacao (CTBA940)
636
+
637
+ | Aspecto | Detalhe |
638
+ |---------|---------|
639
+ | **Rotina** | CTBA940 |
640
+ | **Tabelas** | CT2 (leitura), tabelas de origem dos modulos (leitura) |
641
+ | **O que acontece** | Confronto entre os lancamentos contabeis e os registros de origem para identificar inconsistencias. Verifica se todos os documentos foram contabilizados e se os valores conferem. |
642
+ | **Resultado** | Relatorio de divergencias e status de conciliacao |
643
+
644
+ #### Passo 6: Balancete e Razao (CTBR040 / CTBR400)
645
+
646
+ | Aspecto | Detalhe |
647
+ |---------|---------|
648
+ | **Rotinas** | CTBR040 (Balancete), CTBR400 (Razao), CTBR110 (Diario) |
649
+ | **Tabelas** | CT2 (leitura), CQ0/CQ1 (leitura), CT1 (leitura) |
650
+ | **O que acontece** | Emissao dos relatorios contabeis oficiais. O Balancete apresenta saldos por conta. O Razao detalha os lancamentos de cada conta. O Diario lista todos os lancamentos cronologicamente. |
651
+ | **Resultado** | Relatorios contabeis para analise e cumprimento legal |
652
+
653
+ #### Passo 7: Apuracao de Resultado (CTBA211)
654
+
655
+ | Aspecto | Detalhe |
656
+ |---------|---------|
657
+ | **Rotina** | CTBA211 |
658
+ | **Tabelas** | CT2 (escrita), CT1 (leitura), CQ0/CQ1 (leitura) |
659
+ | **O que acontece** | Levantamento dos saldos das contas de receita e despesa, gerando lancamentos de encerramento que transferem esses saldos para a conta de Lucros e Perdas (CT1_CTALP). As contas ponte (CT1_CTAPON) sao utilizadas como intermediarias. Pode ser executada por conta, centro de custo e classe de valor. |
660
+ | **Resultado** | Contas de resultado zeradas; lucro ou prejuizo apurado na conta de L/P |
661
+
662
+ #### Passo 8: DRE e Balanco Patrimonial
663
+
664
+ | Aspecto | Detalhe |
665
+ |---------|---------|
666
+ | **Rotinas** | CTBR040 (Balancete apos apuracao), relatorios customizados |
667
+ | **O que acontece** | Apos a apuracao de resultado, o Balancete reflete o Balanco Patrimonial (contas patrimoniais) e a DRE pode ser gerada com base nos lancamentos de apuracao. |
668
+ | **Resultado** | Demonstracoes contabeis completas do exercicio |
669
+
670
+ #### Passo 9: Fechamento Contabil e SPED (CTBA960 / CTBS001)
671
+
672
+ | Aspecto | Detalhe |
673
+ |---------|---------|
674
+ | **Rotinas** | CTBA960 (Fechamento), CTBS001 (ECD/SPED) |
675
+ | **Tabelas** | CTG (escrita - bloqueio), CT2 (leitura), CT1 (leitura) |
676
+ | **O que acontece** | Apos verificacao de completude, o periodo e fechado/bloqueado no calendario contabil, impedindo novos lancamentos. O arquivo da ECD (SPED Contabil) e gerado para entrega a Receita Federal. |
677
+ | **Resultado** | Periodo fechado; arquivo ECD gerado |
678
+
679
+ ---
680
+
681
+ ## Regras de Negocio
682
+
683
+ ### Campos obrigatorios por rotina
684
+
685
+ **Plano de Contas (CTBA020 - CT1):**
686
+ - CT1_CONTA (Codigo da conta)
687
+ - CT1_DESC01 (Descricao)
688
+ - CT1_CLASSE (Sintetica/Analitica)
689
+ - CT1_NORMAL (Natureza: Devedora/Credora)
690
+
691
+ **Centro de Custo (CTBA030 - CTT):**
692
+ - CTT_CUSTO (Codigo do centro de custo)
693
+ - CTT_DESC01 (Descricao)
694
+ - CTT_CLASSE (Sintetica/Analitica)
695
+
696
+ **Lancamento Contabil Manual (CTBA102 - CT2):**
697
+ - CT2_DATA (Data do lancamento)
698
+ - CT2_LOTE (Lote)
699
+ - CT2_SBLOTE (Sub-lote)
700
+ - CT2_DOC (Documento)
701
+ - CT2_DC (Tipo: Debito/Credito/Partida dobrada)
702
+ - CT2_DEBITO ou CT2_CREDIT (Conta contabil)
703
+ - CT2_VALOR (Valor)
704
+ - CT2_HIST (Historico)
705
+
706
+ ### Validacoes principais
707
+
708
+ | Validacao | Descricao |
709
+ |-----------|-----------|
710
+ | Periodo contabil | O lancamento so e aceito se a data estiver dentro de um periodo aberto no calendario contabil (CTG_STATUS = "Aberto") |
711
+ | Conta existente | A conta de debito/credito deve existir na CT1 e nao estar bloqueada (CT1_BLOQ <> "1") |
712
+ | Conta analitica | Somente contas analiticas (CT1_CLASSE = "2") podem receber lancamentos |
713
+ | Centro de custo | Se a conta exige CC (CT1_CCOBRG = "1"), o campo CT2_CCD/CT2_CCC e obrigatorio e deve existir na CTT |
714
+ | Classe de valor | Se a conta exige CLVL (CT1_CLOBRG = "1"), o campo CT2_CLVLDB/CT2_CLVLCR e obrigatorio e deve existir na CTH |
715
+ | Item contabil | Se a conta exige item (CT1_ITOBRG = "1"), o campo CT2_ITEMD/CT2_ITEMC e obrigatorio |
716
+ | Equilibrio | Em lancamento de partida dobrada, o total de debitos deve ser igual ao total de creditos |
717
+ | Mascara contabil | O codigo da conta deve respeitar a mascara definida em MV_MASCARA |
718
+ | Data existencia | A data do lancamento deve estar dentro do periodo de existencia da conta (CT1_DTEXIS a CT1_DTEXSF) |
719
+ | Entidade bloqueada | Centro de custo bloqueado (CTT_BLOQ = "1") ou classe de valor bloqueada (CTH_BLOQ = "1") nao aceita lancamentos |
720
+ | Conta invertida | Se CT1_ESTOUR = "1", a conta aceita saldo invertido (devedora com saldo credor ou vice-versa) |
721
+
722
+ ### Gatilhos SX7 relevantes
723
+
724
+ | Campo origem | Campo destino | Regra | Tabela lookup |
725
+ |-------------|---------------|-------|---------------|
726
+ | CT2_DEBITO | CT2_DCD | Digito verificador modulo 11 | - |
727
+ | CT2_CREDIT | CT2_DCC | Digito verificador modulo 11 | - |
728
+ | CT2_HP | CT2_HIST | CT8->CT8_DESC (historico padrao) | CT8 |
729
+ | CT1_CONTA | CT1_CTASUP | Conta superior pela mascara | - |
730
+ | CT1_CONTA | CT1_DC | Digito verificador modulo 11 | - |
731
+
732
+ ### Pontos de entrada mais utilizados no modulo
733
+
734
+ | Ponto de Entrada | Rotina | Descricao |
735
+ |------------------|--------|-----------|
736
+ | CT102VLENT | CTBA102/CTBA105 | Valida entidades contabeis na gravacao do lancamento |
737
+ | Ct102Carr | CTBA102 | Manipula leitura do temporario na rotina de lancamento |
738
+ | CT102MNU | CTBA102 | Customiza menu da rotina de lancamentos manuais |
739
+ | CT105VLENT | CTBA105 | Valida entidades na integracao contabil online |
740
+ | GRVCT3 | CTBA102/CTBA105 | Manipula gravacao para aumento de performance |
741
+ | GRVCT4 | CTBA102/CTBA105 | Manipula gravacao para aumento de performance |
742
+ | GRVCT7 | CTBA102/CTBA105 | Manipula gravacao para aumento de performance |
743
+ | GRVCTI | CTBA102/CTBA105 | Manipula gravacao para aumento de performance |
744
+ | CTA020TOK | CTBA020 | Validacao customizada no cadastro de conta contabil |
745
+ | CT020ADEL | CTBA020 | Verifica integridade referencial antes de excluir conta |
746
+ | CT030ADEL | CTBA030 | Verifica integridade referencial antes de excluir CC |
747
+ | CTA030TOK | CTBA030 | Validacao customizada no cadastro de centro de custo |
748
+ | CTB030VLD | CTBA030 | Valida confirmacao na inclusao e alteracao de CC |
749
+ | CT030BUT | CTBA030 | Customiza botoes no cadastro de centro de custo |
750
+
751
+ ---
752
+
753
+ ## Integracoes
754
+
755
+ ### Compras → Contabilidade
756
+
757
+ | Aspecto | Detalhe |
758
+ |---------|---------|
759
+ | **Quando** | Na classificacao do Documento de Entrada (MATA103) |
760
+ | **O que acontece** | Gera lancamentos contabeis na CT2, debitando contas de estoque/despesa e creditando contas de fornecedores/impostos, conforme Lancamento Padrao (CT5) configurado na TES |
761
+ | **Lancamentos Padrao** | LPs configurados na TES do documento de entrada |
762
+ | **Tabelas afetadas** | CT2, CTK, CV3 |
763
+
764
+ ### Faturamento → Contabilidade
765
+
766
+ | Aspecto | Detalhe |
767
+ |---------|---------|
768
+ | **Quando** | Na emissao da Nota Fiscal de Saida (MATA461/MATA462) |
769
+ | **O que acontece** | Gera lancamentos contabeis para reconhecimento de receita, custo da mercadoria vendida (CMV), impostos sobre vendas e contas a receber, conforme LPs configurados na TES de saida |
770
+ | **Lancamentos Padrao** | LPs do faturamento (ex: LP 500 series) |
771
+ | **Tabelas afetadas** | CT2, CTK, CV3 |
772
+
773
+ ### Financeiro → Contabilidade
774
+
775
+ | Aspecto | Detalhe |
776
+ |---------|---------|
777
+ | **Quando** | Na baixa de titulos a pagar (FINA080) e a receber (FINA070), bordero, compensacao, e demais movimentacoes financeiras |
778
+ | **O que acontece** | Gera lancamentos de baixa contabil (debita banco/caixa, credita contas a receber; ou debita contas a pagar, credita banco/caixa). Movimentacoes como juros, multas, descontos e variacao cambial geram lancamentos complementares |
779
+ | **Lancamentos Padrao** | LPs do financeiro (ex: LP 530, 531, 532, 540, 550 series) |
780
+ | **Tabelas afetadas** | CT2, CTK, CV3 |
781
+
782
+ ### Estoque → Contabilidade
783
+
784
+ | Aspecto | Detalhe |
785
+ |---------|---------|
786
+ | **Quando** | No calculo do custo medio (MATA330/MATA331), transferencias entre armazens, requisicoes e devolucoes |
787
+ | **O que acontece** | Gera lancamentos de movimentacao de estoque, ajuste de custo medio e transferencias entre contas de estoque |
788
+ | **Lancamentos Padrao** | LPs do estoque |
789
+ | **Tabelas afetadas** | CT2, CTK, CV3 |
790
+
791
+ ### Fiscal → Contabilidade
792
+
793
+ | Aspecto | Detalhe |
794
+ |---------|---------|
795
+ | **Quando** | Na apuracao de impostos (ICMS, IPI, PIS, COFINS) e geracao de obrigacoes acessorias |
796
+ | **O que acontece** | Gera lancamentos de apuracao fiscal, transferindo saldos de impostos a recuperar/recolher para contas especificas |
797
+ | **Lancamentos Padrao** | LPs do modulo fiscal |
798
+ | **Tabelas afetadas** | CT2, CTK, CV3 |
799
+
800
+ ### Ativo Fixo → Contabilidade
801
+
802
+ | Aspecto | Detalhe |
803
+ |---------|---------|
804
+ | **Quando** | No calculo da depreciacao mensal (ATFA012) e baixa de ativos |
805
+ | **O que acontece** | Gera lancamentos de depreciacao (debita despesa de depreciacao, credita depreciacao acumulada) e de baixa de ativos (zerando valor contabil) |
806
+ | **Tabelas afetadas** | CT2, CTK, CV3 |
807
+
808
+ ### Folha de Pagamento → Contabilidade
809
+
810
+ | Aspecto | Detalhe |
811
+ |---------|---------|
812
+ | **Quando** | Na contabilizacao da folha (GPEM620/GPEA620) |
813
+ | **O que acontece** | Gera lancamentos de salarios, encargos sociais (INSS, FGTS), provisoes de ferias e 13o salario por centro de custo |
814
+ | **Tabelas afetadas** | CT2, CTK, CV3 |
815
+
816
+ ### Resumo das integracoes na Contabilidade
817
+
818
+ ```
819
+ SIGACTB - Contabilidade Gerencial
820
+ CT2 / CTK / CV3
821
+ ^
822
+
823
+ ┌──────────┬──────────┬───┴───┬──────────┬──────────┐
824
+ │ │ │ │ │ │
825
+ ┌─────v────┐┌───v────┐┌───v────┐┌─v────────┐┌v────────┐┌v──────────┐
826
+ │ Compras ││Fatura- ││Finan- ││ Estoque ││ Fiscal ││Ativo Fixo │
827
+ │ SIGACOM ││mento ││ceiro ││ SIGAEST ││ SIGAFIS ││ SIGAATF │
828
+ │ SD1/SF1 ││SIGAFAT ││SIGAFIN ││ SD3/SB9 ││ SFT/SF3 ││ SN1/SN3 │
829
+ └──────────┘│SD2/SF2 ││SE1/SE2 │└──────────┘└─────────┘└───────────┘
830
+ └────────┘│SE5 │
831
+ └────────┘
832
+ ^
833
+
834
+ ┌─────v──────┐
835
+ │Folha Pgto │
836
+ │ SIGAGPE │
837
+ │ SRC/SRD │
838
+ └────────────┘
839
+ ```
840
+
841
+ ---
842
+
843
+ ## Cadastros Auxiliares
844
+
845
+ | Rotina | Descricao | Tabela |
846
+ |--------|-----------|--------|
847
+ | CTBA010 | Calendario Contabil | CTG |
848
+ | CTBA020 | Plano de Contas | CT1 |
849
+ | CTBA030 | Centro de Custo | CTT |
850
+ | CTBA040 | Item Contabil | CTD |
851
+ | CTBA060 | Classe de Valor | CTH |
852
+ | CTBA070 | Historico Padrao | CT8 |
853
+ | CTBA080 | Lancamento Padrao | CT5 |
854
+ | CTBA090 | Relacionamento LP (rastreamento) | CV3 |
855
+ | CTBA130 | Configuracao Contabil | - |
856
+ | CTBA140 | Moeda Contabil | CTO |
857
+ | CTBA180 | Cadastro de Entidades (CC/CLVL/Item) | CTT/CTH/CTD |
858
+ | CTBA200 | Moeda x Calendario | CTE |
859
+
860
+ ---
861
+
862
+ ## Parametros Globais do Modulo (MV_*)
863
+
864
+ | Parametro | Tipo | Descricao |
865
+ |-----------|------|-----------|
866
+ | MV_MASCARA | C | Mascara contabil (formato da conta, ex: "??.???.??.???") |
867
+ | MV_MCONTAB | C | Ambiente contabil: CTB=SIGACTB, CON=SIGACON (obsoleto) |
868
+ | MV_CTASUP | C | Geracao automatica da conta superior |
869
+ | MV_LOTECON | C | Geracao de lote: T=Tabela 09, U=Ultimo+1 |
870
+ | MV_ALTLCTO | C | Permite alteracao de lancamentos (S/N) |
871
+ | MV_CT105MS | C | Exibe mensagem na integracao contabil (S/N) |
872
+ | MV_CTBPOFF | C | Habilita bloqueio por processo |
873
+ | MV_CCSUP | C | Geracao automatica do CC superior |
874
+ | MV_TPVALOR | C | Formato de valores nos relatorios contabeis |