Manual de compras — Pré-Moldados
Esta é a documentação da candidata isolada. A produção só recebe estes recursos depois de integração, validação e aprovação próprias. Todos os exemplos abaixo são sintéticos.
Índice por tela e botão
- Abrir Comprar materiais
- Escolher o modo
- Dados comuns e datas
- Adicionar item e Remover item
- Condição de pagamento
- Conferência
- Anexar cupom ou nota
- Gerar prévia e Confirmar registro
- Fechar e preservar e Descartar preparação
- Conferir confirmação pendente
- Reenviar somente o documento
- Consultar compras e documentos
- Pagamentos e quitação
- Corrigir um registro
- Limites
Abrir Comprar materiais
Caminho: Pré-Moldados → Produção e compras → Fabricação → Comprar materiais (premoldados-operacoes.html). O botão abre uma janela com os dados comuns primeiro, os itens abaixo e a conferência/anexo no fim. Um único item é suficiente. Não há mais um segundo formulário PM para cadastrar “compra agrupada”. A área Compras agrupadas continua existindo para consulta e agrupamento explícito de registros anteriores; não cria outra nota automaticamente.
Escolher o modo
| Modo do registro | Estoque | Financeiro | Uso |
|---|---|---|---|
| Compra normal | Entradas de matéria-prima conforme as regras operacionais existentes | Saldo e valores já pagos das linhas existentes | Compra operacional corrente; continua sujeita à abertura operacional da fábrica |
| Compra antiga a pagar | Zero; não registra produção, custo de obra ou abertura | Cria ou adota UMA obrigação canônica W10, com pagamento separado | Detalhar uma compra antiga que ainda tem saldo a reconhecer |
| Somente documento histórico | Zero; referência de preço do catálogo preservada | Zero obrigação e zero pagamento | Guardar os detalhes e o documento, sem declarar dívida ou quitação |
“Histórico” não quer dizer “pago”. Não use o modo normal para uma compra antiga se a intenção é apenas reconhecer a dívida.
A compra antiga exige o fluxo de Contas anteriores na fase de coleta. Este formulário não inicializa nem muda a fase. Se a coleta não estiver ativa, a prévia é recusada com orientação para conferir o Financeiro da fábrica. Pagamentos de obrigações existentes seguem as permissões e fases W10.
Dados comuns e datas
| Campo | Como preencher e o que faz |
|---|---|
| Modo do registro | Seleciona os efeitos descritos acima |
| Data da compra | Dia em que a compra ocorreu. Obrigatório; não é o vencimento nem a data da baixa |
| Hora | Hora da compra, opcional. Nos modos históricos, informe apenas se conhecida; a sugestão automática de horário atual é retirada |
| Fornecedor / credor | Escolha um fornecedor identificado e único no cadastro. A candidata não cria um fornecedor por texto livre |
| Número da nota / cupom / pedido (opcional) | Deixe vazio se não existir; nenhum número será inventado. Quando informado, ajuda a localizar a compra e impede repetir a mesma referência para o mesmo credor no modo antigo |
| Vencimento | Dia previsto para pagar. Pode ficar sem informação quando desconhecido. Inaplicável no modo somente documento |
| Motorista, placa e observação | Informações comuns opcionais conservadas com o documento e itens |
| Motivo do registro histórico | Obrigatório nos dois modos históricos; explica o registro |
| Saldo a reconhecer | Somente compra antiga. Valor efetivamente reconhecido como dívida; positivo e até o total documental |
| Explicação se saldo difere do total | Obrigatória quando o saldo reconhecido é menor que a nota. Não cria pagamento para compensar a diferença |
| Obrigação existente a adotar | Opcional no modo antigo. Permite selecionar uma fonte operacional elegível; exige confirmação explícita de que é a mesma obrigação |
Exemplo sintético: compra em 02/09/2026 às 13:45, vencimento em 20/10/2026, pagamento em 23/10/2026. Cada data mantém seu significado. Alterar o vencimento não muda a compra. A baixa posterior não reescreve nenhuma dessas informações.
Na adoção, o original permanece preservado e a projeção financeira da fonte adotada é substituída pela obrigação canônica. Um documento histórico não pode ser usado como fonte de dívida. Fontes com pagamentos ou inconsistências são recusadas para revisão. A candidata oferece uma fonte por vez neste seletor; a revisão de múltiplas fontes continua no fluxo W10 existente.
Adicionar item e Remover item
Cada linha tem Matéria-prima / material, Quantidade, Unidade, Preço unitário (R$) e Total do item (R$). O material vem do catálogo e a unidade é exibida sem edição livre. Para outra unidade, revise o cadastro e sua identidade pelo fluxo apropriado; não altere a unidade histórica para forçar um registro.
Adicionar item inclui somente outra linha e leva o foco ao novo material. Fornecedor, data, hora, referência e vencimento continuam únicos. Remover item retira uma linha adicional do rascunho. A primeira linha permanece. Os controles de item ficam alinhados no desktop; no celular, os campos seguem em duas colunas e o botão de remoção mantém área de toque de pelo menos 44 pixels. Não há exclusão de registro já confirmado por estes botões.
Quantidade e preço aceitam até duas casas decimais neste editor. O total de cada linha é arredondado para centavos e depois somado. Preços históricos precisam ser informados: sugestões automáticas de preço/fornecedor do modo normal são retiradas ao mudar para histórico, salvo quando o usuário as editou explicitamente.
Exemplo sintético: 2 sacos × R$30,00 + 1 m³ × R$20,00 = R$80,00. O cabeçalho é preenchido uma vez.
Condicao de pagamento
Somente no modo normal, Valor já pago conserva o significado operacional atual. A distribuição entre itens é proporcional em centavos e aparece na prévia comum. O total pago não pode exceder a compra.
As formas e parcelas existentes continuam opcionais. Parcelas são previsões, não novas contas ou pagamentos. A agenda integral é guardada no grupo da compra. Quando os centavos permitem, também é representada por linha; quando uma linha muito pequena não comporta a divisão em parcelas positivas, seu detalhe indica previsão comum do grupo. O cronograma comum permanece consultável, sem inventar frações de centavo ou duplicar o financeiro. Escolher PIX, cartão ou parcelas não registra pagamento por si só.
Nos modos históricos, valor já pago e condição operacional não são enviados. Compra antiga usa o saldo reconhecido e o pagamento canônico separado.
Conferencia
Total calculado soma os totais dos itens. Valor da nota / cupom é o total informado do documento. Diferença mostra valor da nota menos total calculado. A confirmação exige diferença zero, verificada também pelo servidor.
Se a nota for R$79,00 e os itens somarem R$80,00, corrija a composição antes de continuar. Não há regra nova de desconto/frete para absorver diferenças automaticamente. A diferença entre total documental e saldo a reconhecer é outra conferência: exige explicação e não gera baixa histórica fictícia.
Anexar cupom ou nota
Na seção Documento original (opcional), escolha o tipo e use Anexar cupom ou nota. A ausência de arquivo não impede o registro. Tipos: NF-e/DANFE, cupom/nota, pedido, comprovante de saída ou documento de compra.
Formatos: PDF, JPEG ou PNG, até 10 MiB. Extensão, MIME e assinatura são verificados; imagens têm limites de dimensão. Isso não equivale a antivírus ou validação fiscal. Os arquivos usam o armazenamento privado já existente e download autenticado; não são enviados para outro provedor.
Um anexo não cria/adota/paga uma obrigação. Depois de confirmar sem arquivo, também é possível usar Anexar documento original no detalhe da consulta ou Anexar ou reenviar original na área de grupos.
Gerar previa e Confirmar registro
Gerar prévia confere campos, totais, arquivo selecionado e estado da sincronização. Para compra antiga, a prévia é validada pelo servidor W10. A tela mostra fornecedor, compra, referência, quantidade de itens, total documental, saldo reconhecido quando aplicável, vencimento, arquivo e efeitos do modo.
Confirmar registro é a ação separada que grava. A compra antiga confirma grupo, linhas documentais, obrigação, auditoria e recibo em uma transação. Uma mudança de campos ou de base exige nova prévia. Durante o envio, os campos financeiros ficam bloqueados para impedir novo envio e edição sobre resposta pendente.
Fechar e preservar e Descartar preparacao
Fechar e preservar, clicar fora da janela e Escape fecham a janela mantendo o rascunho e o File selecionado na mesma página. Reabra Comprar materiais para continuar.
Descartar preparação pede confirmação quando há rascunho e limpa somente a preparação desta compra se não houver envio, revisão ou resultado pendente. Não apaga compra já confirmada nem rascunhos de outras telas. O guard continua recusando descarte durante incerteza. Fechar a aba, recarregar ou encerrar o navegador não é uma forma de guardar o File; pode ser necessário selecioná-lo novamente.
Conferir confirmacao pendente
Se o servidor confirmou mas a resposta se perdeu, o formulário fica travado para novo registro. Use Conferir confirmação pendente. Na compra antiga, a ação consulta o recibo e o estado por GET, valida identidade/operação/hash e reconstrói o modelo. Não envia outra dívida.
Após recarga da página, o journal W10 continua sendo usado. Enquanto o recibo não puder ser validado, preserve a preparação e não limpe storage nem repita POST. Rascunhos de outras operações ou divergências locais continuam exigindo revisão pelo fluxo existente. Em compra normal/documento pelo writer genérico, a reconciliação inicial usa o CloudSync existente; incertezas remanescentes conservam o bloqueio e a revisão da sincronização.
Reenviar somente o documento
Se o registro foi confirmado e o upload falhou, a tela informa Registro confirmado. O anexo está pendente. Use Reenviar somente o documento. Na mesma página, o arquivo é preservado; depois de recarregar, selecione novamente o original. Nome/hash da intenção original são conferidos. Não confirme outra compra para resolver falha do anexo.
O detalhe da consulta também permite reenviar o original pendente. O armazenamento deduplica pelo grupo/finalidade/hash. Upload repetido não cria outra obrigação e não substitui silenciosamente o arquivo anterior.
Consultar compras e documentos
Na mesma página Produção e compras, abaixo das áreas operacionais, está Consultar compras e documentos. A busca cobre fornecedor, material, unidade/tipo, referência e observações. Há filtros separados para Data da compra de/até, Vencimento de/até e situação Todas / Em aberto / Quitadas.
Clique na linha para abrir os itens, datas, obrigação canônica, pagamentos e documentos. Os links de documento fazem download autenticado. Anterior, números e Próxima ficam no rodapé; são 20 registros por página. Os totais consideram todo o filtro, não só a página. Quando há conta antiga sem total documental, a soma é identificada como Total documental conhecido e a ausência é informada.
Grupos antigos, compras sem grupo e obrigações W10 v1 permanecem consultáveis. Entradas anteriores sem documento mostram Não informado, sem criar material, data, preço ou grupo falso. Adoção parcial de um grupo conserva o saldo das linhas não adotadas; a parte adotada aponta para a obrigação responsável e não entra duas vezes na soma financeira.
Pagamentos e quitacao
Caminho: Financeiro da fábrica → Contas anteriores → Registrar pagamento. É o comando W10 existente, com prévia e confirmação. A data da baixa é informada no pagamento e pode ser diferente da compra e do vencimento.
No detalhe da compra há Abrir pagamentos no Financeiro da fábrica. Na lista financeira, obrigações v2 oferecem Itens e documentos para voltar à consulta da compra. Uma dívida quitada permanece no histórico com seus itens e documentos; nenhuma entrada de estoque é criada na quitação.
Se não houver número, não invente um. A prevenção de repetição usa também ID de operação, recibo, revisão e vínculos de origem/adoção. Reabrir ou conferir uma confirmação não cria outra obrigação. Um novo registro sem número com outro ID pode representar uma compra diferente; confira fornecedor, datas, itens e documentos antes de confirmar.
Corrigir um registro
Antes de confirmar, edite o rascunho e gere outra prévia. Depois de confirmar, esta entrega não oferece edição silenciosa de nota, agenda comum ou obrigação anterior. Não recadastre a mesma dívida como correção.
Para erro operacional de compra normal, use a retificação existente somente quando seu contrato e vínculos forem aplicáveis. Documento/obrigação histórica v2 é imutável: correção posterior exige um evento/vínculo auditado em fluxo próprio, ainda não implementado por esta candidata. Pagamentos seguem os comandos W10; este formulário não estorna pagamentos. A correção real da Constrular não faz parte desta entrega.
Limites
Esta candidata não abre a fábrica, não importa notas automaticamente, não calcula impostos/frete/desconto, não prova quitação histórica e não reconcilia fornecedores por semelhança. Usa catálogo/fornecedor identificado e confirmação humana.
Os testes usam somente dados e sessões sintéticos. Já houve validação transacional em PostgreSQL real descartável. O relatório de entrega registra a identidade exata e os resultados de navegador, múltiplas instâncias e build. O login OAuth real e o ambiente de produção exigem aceite próprio; não são simulados como se tivessem sido validados.
Evidência transacional complementar: PostgreSQL real isolado — 10/10 PASS. O adendo identifica o ensaio anterior; o relatório atual identifica cada nova validação.