Motor de contabilidade¶
Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.
Módulo: Contabilidade
Menu: Operações → Contabilidade
Público: Contador | Gestor | Administrador
Status: Publicado
Atualizado: 2026-09-09
Refs técnicas: ADR-023 ·01-ARQUITETURA/68-motor-contabilidade.md
O que faz¶
Converte automaticamente fatos do Financeiro (e, nas próximas fatias, Folha, Estoque, Patrimônio e Fiscal) em lançamentos de partidas dobradas, com origem rastreável. O operador não redigita a mesma operação na contabilidade.
Quem pode usar¶
accounting.event.read/createaccounting.rule.read/updateaccounting.period.read/close/reopenaccounting.batch.readaccounting.report.readaccounting.entry.create(lançamento manual)
Pré-requisitos¶
- Plano de contas com contas analíticas (Fornecedores, Clientes, Bancos, Despesas, Receitas).
- Centros de custo quando a regra exigir.
- Período contábil aberto para a competência (o sistema pode abrir automaticamente na primeira postagem).
Passo a passo¶
- Cadastre/ajuste o plano de contas e regras (evento → contas débito/crédito).
- Opere normalmente o Contas a pagar / receber (criar, baixar, cancelar).
- Em Contabilidade → Eventos, confira o status (
PROCESSED,PENDING_CLASSIFICATION,FAILED). - Em Diário (lotes), veja as partidas geradas; use Estornar se precisar corrigir (nunca apague).
- Em Períodos, feche o mês quando a checklist estiver limpa.
- Em Relatórios, consulte balancete, razão, DRE e balanço simplificados.
Regras importantes¶
- Débito sempre igual a crédito.
- Mesmo evento não contabiliza duas vezes (
idempotency_key). - Folha gera títulos no CPA; a contabilidade segue o título, não um segundo lançamento paralelo.
- Período fechado bloqueia novos lançamentos até reabertura autorizada.
- NFCom autorizada emite evento
FISCAL_NFCOM_AUTHORIZED(ficaPENDING_CLASSIFICATIONaté haver regra dedicada — não bloqueia a SEFAZ). - Patrimônio: use Depreciação com competência AAAA-MM (idempotente por ativo/mês).
Erros / avisos comuns¶
| Mensagem / situação | O que fazer |
|---|---|
| PENDING_CLASSIFICATION | Falta conta na regra ou no documento — complete a classificação |
| Período fechado | Reabra o período (com permissão) ou lance na competência aberta |
| Contas débito/crédito iguais | Ajuste a regra |
