Cadastro de Pedido de Compra
Módulo: Compras Caminho na aplicação: Menu > Compras > Pedidos de Compra > "Novo pedido" ou ícone Editar em um pedido existente Última atualização: 20/04/2026
Para que serve
Registra um pedido de compra para um fornecedor, com itens, condições de pagamento e previsão de entrega. Serve como base para recebimento de mercadorias e geração de contas a pagar.
Quem pode usar
Usuários com acesso ao módulo Compras.
Como usar (passo a passo)
Criação
- Na Lista de Pedidos de Compra, clique em Novo pedido.
- Preencha os dados gerais: fornecedor, filial, data de emissão e, opcionalmente, previsão de entrega, frete e outras despesas.
- Na seção Itens, clique em Adicionar item, selecione o produto e informe quantidade, valor unitário e eventuais desconto/acréscimo.
- Na seção Pagamentos, clique em Adicionar parcela e informe número da parcela, data de vencimento, valor e forma de pagamento.
- Verifique os totalizadores (subtotal, total e total de pagamentos). O total de pagamentos é exibido em vermelho se divergir do total do pedido.
- Clique em Salvar. O sistema redireciona para a tela de edição com o número gerado (
PC<numero>).
Edição (situação Rascunho)
- Clique no ícone Editar (lápis) na linha do pedido na listagem.
- Altere os campos desejados.
- Para editar um item, clique no ícone Editar (lápis) na linha do item.
- Para remover um item ou parcela, clique no ícone de lixeira na respectiva linha.
- Clique em Salvar para gravar as alterações. Os dados são recarregados da API.
Confirmação
- Com o pedido em rascunho salvo, clique em Confirmar.
- Confirme a mensagem de alerta. Após confirmado, itens e pagamentos não podem mais ser editados.
- O pedido passa para a situação "Confirmado".
Recebimento
Com o pedido confirmado (ou parcialmente recebido), clique em Novo recebimento para abrir o Cadastro de Recebimento vinculado a este pedido.
Gerar contas a pagar
Com o pedido confirmado, clique em Gerar contas a pagar para criar automaticamente as contas a pagar conforme as parcelas cadastradas.
Cancelamento
- Clique em Cancelar (disponível para pedidos que não estão cancelados nem totalmente recebidos).
- Informe o motivo obrigatório e confirme.
- O pedido passa para a situação "Cancelado" e exibe alerta com o motivo.
Remoção
Disponível apenas para pedidos em rascunho. Clique em Remover e confirme. O pedido é excluído permanentemente e o usuário é redirecionado para a listagem.
Campos da tela
Seção: Fornecedor e dados gerais
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Fornecedor | Sim | Selecione o fornecedor na lista | Campo de busca por nome ou documento |
| Filial | Sim | Selecione a filial que realizará a compra | Bloqueado após criação |
| Data emissão | Sim | Data de emissão do pedido (DD/MM/AAAA) | Padrão: data atual |
| Previsão entrega | Não | Data prevista para chegada dos produtos (DD/MM/AAAA) | — |
| Frete (R$) | Não | Valor do frete em R$ | Padrão: R$ 0,00 |
| Outras despesas (R$) | Não | Outras despesas acessórias em R$ | Padrão: R$ 0,00 |
| Observações | Não | Texto livre com observações gerais | Máximo de 1.000 caracteres |
Seção: Itens (modal de inclusão/edição)
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Produto | Sim | Selecione o produto na lista | Busca por nome ou SKU |
| Quantidade | Sim | Quantidade a comprar | Até 4 casas decimais |
| Valor unitário | Sim | Preço de compra unitário em R$ | Até 4 casas decimais |
| Desconto | Não | Valor de desconto em R$ | — |
| Acréscimo | Não | Valor de acréscimo em R$ | — |
| Observações | Não | Observação específica do item | Máximo de 500 caracteres |
Colunas da tabela de itens
| Coluna | Descrição |
|---|---|
| Produto | Nome do produto |
| Un. | Unidade transacionada (escolhida por linha entre as unidades do produto com ativo_compra = Sim). O sistema grava unidade_id, fator_estoque_snapshot e fator_preco_snapshot no item |
| Qtd. | Quantidade pedida na unidade transacionada |
| Valor un. | Valor unitário em R$ |
| Desc. | Desconto em R$ (exibe - se zerado) |
| Acres. | Acréscimo em R$ (exibe - se zerado) |
| Qtd. recebida | Quantidade já recebida em recebimentos confirmados |
| Total | Valor total do item: (qtd × valor_unit) - desconto + acréscimo |
Seção: Pagamentos (modal de inclusão/edição)
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Número parcela | Sim | Número sequencial da parcela | Sugerido automaticamente |
| Valor | Sim | Valor da parcela em R$ | Sugerido com o saldo restante a cobrir |
| Data vencimento | Sim | Data de vencimento (DD/MM/AAAA) | Sugerida em intervalos de 30 dias |
| Forma | Não | Selecione a forma de pagamento | — |
Colunas da tabela de pagamentos
| Coluna | Descrição |
|---|---|
| Parcela | Número da parcela |
| Vencimento | Data de vencimento no formato DD/MM/AAAA |
| Forma | Forma de pagamento selecionada |
| Valor | Valor da parcela em R$ |
Totalizadores
| Totalizador | Descrição |
|---|---|
| Subtotal | Soma dos totais de todos os itens |
| Total | Subtotal + frete + outras despesas |
| Total pagamentos | Soma dos valores das parcelas (vermelho se divergir do Total) |
Validações e regras
- A filial não pode ser alterada após a criação do pedido.
- Ao confirmar o pedido, itens e pagamentos ficam bloqueados para edição.
- Não é possível salvar um pedido sem pelo menos um item.
- O valor total dos pagamentos não precisa ser exatamente igual ao total do pedido para salvar, mas a divergência é indicada em vermelho.
- O cancelamento exige motivo (máximo de 255 caracteres).
- Pedidos totalmente recebidos não podem ser cancelados.
- Pedidos em situação "Rascunho" podem ser removidos permanentemente; pedidos confirmados ou além precisam ser cancelados antes.
- O botão "Gerar contas a pagar" fica disponível apenas para pedidos confirmados, parcialmente recebidos ou recebidos.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Obrigatorio" | Campo obrigatório não preenchido | Preencha o campo indicado |
| "Adicione ao menos um item" | Tentativa de salvar sem itens | Adicione ao menos um item antes de salvar |
| "Produto nao encontrado" | Produto selecionado não localizado internamente | Recarregue a página e tente novamente |
| "Informe o motivo" | Tentativa de cancelar sem preencher o motivo | Informe o motivo no campo exibido |
| "Erro ao carregar pedido de compra" | Falha ao buscar os dados do pedido | Verifique a conexão e recarregue |
| "Pedido de compra atualizado" | Sucesso na atualização | — |
| "Pedido de compra criado" | Sucesso na criação | — |
| "Pedido confirmado" | Sucesso na confirmação | — |
| "Pedido cancelado" | Sucesso no cancelamento | — |
| "Pedido removido" | Sucesso na remoção | — |
| — | Regra de negócio no backend | ⚠️ CONFIRMAR |
| — | Contas já geradas anteriormente | ⚠️ CONFIRMAR |
Integrações e dependências
- Lista de Pedidos de Compra — tela de origem.
- Cadastro de Recebimento — criado a partir do botão "Novo recebimento" presente nesta tela.
- Fornecedores — cadastro necessário antes de criar um pedido.
- Produtos — cadastro necessário para adicionar itens.
- Filiais — necessário para identificar a unidade compradora.
- Formas de Pagamento — usadas nas parcelas (opcional).
- Contas a Pagar — geradas pelo botão "Gerar contas a pagar" com base nas parcelas cadastradas.
Dúvidas frequentes
Posso alterar a filial depois de salvar? Não. A filial é bloqueada após a criação do pedido.
O total de pagamentos precisa ser igual ao total do pedido? Não é obrigatório para salvar, mas a diferença é destacada em vermelho como alerta.
Como faço para criar um recebimento a partir do pedido? Confirme o pedido e clique no botão "Novo recebimento" que aparece na barra de ações.
Posso cancelar um pedido já recebido? Não. Pedidos com situação "Recebido" não podem ser cancelados.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |