Pular para conteúdo

Manual da Contabilidade — Telvora (time de teste)

Tela do Telvora ERP — Manual da Contabilidade — Telvora (time de teste)

Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.

Módulo: Contabilidade
Menu: Operações → Contabilidade
Ambiente sugerido: https://telvora.core3.com.br/
Público: Contador | Gestor | QA / Teste
Status: Publicado
Atualizado: 2026-09-10
Refs técnicas: ADR-023 · ADR-024 · ADR-025 · 01-ARQUITETURA/68-motor-contabilidade.md · 69-contabilidade-oficial-telecom.md

1. O que este módulo faz

Transforma fatos do negócio (Financeiro, Folha via Contas a Pagar, Estoque/CPE, NFCom) em lançamentos de partidas dobradas (débito = crédito), com origem rastreável.

O operador não redigita a mesma operação no diário: opera no módulo de origem; a Contabilidade gera o lote automaticamente.

2. Ideia central (obrigatório entender no teste)

Módulo operacional → evento idempotente → regra → lote (Diário) + linhas → saldos / SPED
Regra Significado no teste
Motor único Só o motor cria partidas; Controllers não “lançam na mão”
D = C Lote nunca posta se débito ≠ crédito
Idempotência O mesmo fato não gera dois lotes
Estorno Novo lote inverso — nunca apaga lote POSTED
Receita telecom Vem do CRE (Financeiro → Receber), não da NFCom
Impostos NFCom NFCom autorizada gera só impostos (FISCAL_NFCOM_TAXES)

CPA = Contas a Pagar → menu Financeiro → Pagar
CRE = Contas a Receber → menu Financeiro → Receber
Lançamentos automáticos aparecem em Contabilidade → aba Diário.

3. Quem pode usar (permissões típicas)

  • accounting.account.* — plano de contas
  • accounting.event.read / create — eventos
  • accounting.rule.read / update — regras
  • accounting.period.read / close / reopen — períodos
  • accounting.batch.read — diário / estorno
  • accounting.report.read — relatórios, saúde, SPED
  • accounting.entry.create — lançamento manual / tarifas / conciliação

4. Pré-requisitos antes de testar

  1. Empresa/filial selecionadas no workspace.
  2. Plano de contas com contas analíticas (seed / template).
  3. Regras do motor carregadas (seed contábil / “Carregar template” quando disponível).
  4. Período da competência aberto (o motor pode abrir na primeira postagem).
  5. Para telecom: CRE + NFCom alinhados à matriz ADR-024 (receita no CRE).

5. Mapa das abas (Contabilidade)

Aba O que testar
Plano de contas CRUD, template, contas sintéticas vs analíticas
Lançamentos Manual (débito e crédito + valor; conta bancária/caixa opcional) → abre detalhe do lote; Estornar atualiza status REVERSED no Diário
Eventos Status: PROCESSED, PENDING_CLASSIFICATION, FAILED
Regras Eventos AP/AR, impostos NFCom, CPE, banco, etc.
Períodos Checklist → Fechar → Reabrir
Diário Grade + filtro + detalhes; Estornar só POSTED que não é estorno
Relatórios Balancete (e exports CSV se habilitados)
Depreciação Rodar competência AAAA-MM
Oficial / SPED Saúde, conciliações, exportar ECD/EFD/ECF/FUST

Telas irmãs: Centros de custo, Orçamento por centro de custo.

6. Roteiro de teste sugerido (ordem)

A. Estrutura

  1. Contabilidade → Plano de contas → Carregar template (se permitido).
  2. Contabilidade → Regras → confira eventos AP_*, AR_*, FISCAL_NFCOM_TAXES, CPE_*, BANK_*.
  3. Centros de custo: criar um analítico e vincular filiais se necessário.

B. Ciclo financeiro → contábil

  1. Financeiro → Pagar: criar título com conta de despesa + CC → conferir evento AP_OBLIGATION_CREATED e lote no Diário.
  2. Baixar o título (com juros/desconto se a tela permitir) → eventos de pagamento / juros / desconto.
  3. Financeiro → Receber: criar CRE → AR_INVOICE_ISSUED.
  4. Receber CRE → AR_PAYMENT_RECEIVED (+ juros/desconto se houver).
  5. Cancelar / baixa por perda (quando a tela permitir write_off) → AR_CANCELLED / AR_WRITE_OFF.

C. Telecom (sem tripla contagem)

  1. Gerar CRE de assinante (receita).
  2. Autorizar NFCom do mesmo ciclo → deve gerar só impostos, não outra receita.
  3. No Diário: um conjunto de partidas de receita (CRE) + partidas de impostos (NFCom).
  4. Falha esperada se errado: dois lotes de receita para o mesmo faturamento.

D. Estoque / CPE (se houver operação)

  1. Entrada de estoque / comodato CPE → eventos STOCK_* / CPE_COMODATO_*.
  2. Depreciação: aba Depreciação → competência → processar.

E. Folha → CPA → contábil

  1. Fechar folha no RH (gera CPA).
  2. Conferir que a contabilidade veio pelos eventos AP do CPA (sem lançamento paralelo “de folha”).

F. Fechamento

  1. Aba Eventos: zerar PENDING_CLASSIFICATION e FAILED.
  2. Aba Períodos → Checklist (itens verdes).
  3. Fechar — deve bloquear se houver pendência.
  4. Tentar lançar na competência fechada — deve falhar / evento FAILED.
  5. Reabrir (com permissão) e confirmar auditoria.

G. Oficial / SPED

  1. Aba Oficial / SPED.
  2. Filtros: filial, data início, data fim.
  3. Em cada card, escolher código do layout no dropdown.
  4. Exportar ECD, EFD-Contribuições, ECF, FUST/FUNTTEL → deve baixar .txt.
  5. Histórico → Baixar novamente.
  6. Observação: arquivos são de homologação (validar no PVA antes de produção).

H. Lançamento manual

  1. Contabilidade → Lançamentos.
  2. (Opcional) escolha conta bancária/caixa — se tiver conta analítica, pré-preenche o Débito.
  3. Informe Débito (conta a debitar), Crédito (conta a creditar), valor e descrição.
  4. Registrar — o detalhe do lote abre abaixo; status no Diário fica POSTED.
  5. Para corrigir: Estornar (na lista ou no Diário) — status vira REVERSED (nunca edite POSTED).

7. Matriz de eventos (referência rápida)

Fato Evento típico Partida resumida
Emitir CPA AP_OBLIGATION_CREATED D Despesa / C Fornecedores
Pagar CPA AP_PAYMENT_POSTED D Fornecedores / C Banco
Juros no pagamento AP_INTEREST_EXPENSE D Despesa financeira / C Fornecedores
Desconto obtido AP_DISCOUNT_OBTAINED D Fornecedores / C Receita financeira
Emitir CRE AR_INVOICE_ISSUED D Clientes / C Receita
Receber CRE AR_PAYMENT_RECEIVED D Banco / C Clientes
Juros/multa recebidos AR_INTEREST_INCOME D Clientes / C Receita financeira
Desconto concedido AR_DISCOUNT_GRANTED D Despesa/desconto / C Clientes
Cancelar CRE AR_CANCELLED Estorno
Perda CRE AR_WRITE_OFF D Perdas / C Clientes
NFCom autorizada FISCAL_NFCOM_TAXES D Despesa tributária / C Impostos a recolher
NFCom cancelada / original substituída FISCAL_NFCOM_CANCELLED Estorno do batch de impostos
Comodato CPE saída CPE_COMODATO_OUT D CPE comodato / C Estoque
Tarifa bancária BANK_FEE D Despesa / C Banco

8. Regras importantes

  • Débito sempre = crédito.
  • Sem conta resolvida → PENDING_CLASSIFICATION (não inventa conta).
  • Folha só via CPA.
  • Orçamento (quando ativo) valida no CPA antes do evento.
  • Mudança de regra não reprocessa histórico sozinha — correção por estorno.
  • SPED/ECF/FUST desta versão: leiaute mínimo para homologação.

9. Erros / avisos comuns

Situação O que fazer
PENDING_CLASSIFICATION Conta no documento ou ajuste a regra
Checklist falhou ao fechar Leia os itens; corrija eventos/folha/conciliação
Período fechado Reabra ou use competência aberta
Evento “duplicado” Já processado — ache o lote pela idempotência
Conta 0 / ChartAccount 0 Selecione débito e crédito (ambos obrigatórios)
Estorno em loop Só lotes POSTED originais; lotes de estorno não podem ser estornados de novo
Duas receitas no mesmo faturamento Confirme ADR-024: CRE = receita; NFCom = impostos
SPED rejeitado no PVA Esperado em leiaute mínimo — reportar e não enviar à RFB
FUST sem base Regime da empresa precisa ser Lucro Real

10. Artigos relacionados (wiki)

11. Fora deste manual (ainda não exigir no teste como “pronto produção”)

  • Validação PVA oficial com layout SPED completo
  • EFD-ICMS/IPI · SPED Simples Nacional
  • Matching automático completo de extrato bancário

Arquivo para envio ao time: este Markdown em
CORE3-ERP-DOCUMENTACAO-CURSOR/23-WIKI/contabilidade/07-manual-contabilidade.md

Referências