Documentos, cabeçalhos e itens de linha
Como um documento transacional é elaborado, por que seus totais sempre coincidem com seus itens e quando os itens param de mudar.
Todo documento transacional abre em uma página de detalhes: um resumo no cabeçalho acima, grades de itens de linha abaixo, acessível pela ação "Detalhes" na lista. O cabeçalho pode ser editado diretamente nessa página — que é onde você está quando acabou de ler o documento e identificou o problema.
As linhas formam uma grade, não uma mancha.
Os itens são inseridos em uma grade: selecione o item ou a conta contábil em um menu suspenso, digite a quantidade e observe o total acumulado. Documentos cujo cabeçalho e linhas são preenchidos juntos — como diários, requisições, ordens de compra, faturas de fornecedores e oportunidades — mantêm essa mesma grade dentro do formulário de criação, de modo que o documento é criado em uma única etapa, em vez de ser criado vazio e preenchido posteriormente.
| Módulo | Documento | Quais são as linhas? |
|---|---|---|
| Contabilidade | Revistas | Linhas lançadas: conta, débito, crédito. Imutáveis. |
| Contabilidade | Faturas de AP e AR | Linhas de custo com item, conta contábil e imposto. |
| CRM | Oportunidades | Linhas de produtos, que se tornam a fatura de contas a receber em caso de venda concluída. |
| CRM | Ordens de serviço de campo | Tarefas com mão de obra e técnicos, além de peças retiradas do estoque. |
| Cadeia de mantimentos | Requisições e ordens de compra | Itens que mostram as quantidades recebidas e pendentes. |
| Cadeia de mantimentos | Recibos | Quantidades recebidas por local e lote. Imutável. |
| HRMS | Processamento da folha de pagamento | Um recibo de pagamento por funcionário: bruto, impostos, deduções e líquido. |
| Fabricação | Ordens de produção | Lista de materiais (BOM) com componentes explodidos e operações de roteamento. |
| Fabricação | Inspeções de qualidade | Características medidas em comparação com seus limites de especificação. |
| EHR | Encontros | Linhas de cobrança faturáveis. |
| Ciclo de vida do estudante | Faturamento por período | Custos de inscrição, deduzidos do auxílio recebido. |
Duas regras aplicadas na API, não apenas na tela.
- Os totais do cabeçalho são derivados. Adicionar, alterar ou excluir uma linha recalcula o subtotal, o imposto e o total do cabeçalho na mesma transação do banco de dados. O cabeçalho nunca pode divergir das suas linhas, independentemente do caminho percorrido pela alteração.
- As linhas ficam congeladas com o documento. Assim que uma fatura é lançada, um pedido de compra é recebido, uma ordem de serviço é concluída ou um atendimento é faturado, suas linhas se tornam somente leitura — esses estados já geraram lançamentos contábeis e movimentações de estoque. Elas também ficam congeladas com o fechamento do período fiscal, pelo mesmo motivo.
A grade indica qual das duas opções é a correta, em vez de permitir que você digite e depois falhe ao salvar. "Publicado" e "o período está fechado" são problemas diferentes com respostas diferentes, e receber a resposta errada pode custar uma tarde inteira.