Como podemos ajudar?

Como gerar venda de um atendimento

Depois que uma Ordem de Serviço (OS) é aberta com um serviço (e, opcionalmente, equipamentos vendidos ao cliente), é possível transformar esse atendimento em uma venda — um documento financeiro (VendaRecebimento) que gera o débito e a cobrança do cliente. Esse fluxo é acessado diretamente de dentro da própria OS.

Pré-requisitos

• Permissão financeiro-vendarecebimento > adicionar — sem ela o botão "Gerar venda" nem aparece na OS;
• A OS precisa ter pelo menos um serviço vinculado (item de serviço) ou algum equipamento de venda/comodato lançado; caso contrário o sistema recusa com "Nenhum serviço ou equipamento definido na Ordem de Serviço!";
• O(s) serviço(s) vinculados à OS precisam ter um Produto Pessoa Física configurado no cadastro do Serviço (ver artigo "Como fixar o valor de um serviço") — sem isso, a tela recusa com "Nenhum serviço da Ordem de Serviço possui produtos para gerar uma venda!" (essa exigência não se aplica se a OS já tiver equipamentos de venda lançados);
• O Tipo de Venda que será usado precisa ter uma Conta vinculada no cadastro (Financeiro > Tipos de Venda), senão a confirmação falha com "O tipo de venda não possui uma conta atrelada!";
• Se a forma de pagamento escolhida for do tipo "Débito em conta", a OS precisa estar vinculada a um contrato — sem contrato, o sistema recusa com "A geração de débito em conta só é permitida quando a venda está atrelada a um contrato."

Passo a passo

1. Abra a OS já concluída (ou em andamento) em Suporte > Ordens de Serviço > Editar.
2. Na caixa de ações da OS, clique no botão Gerar venda (ícone de cifrão).
3. O sistema abre o popup "Adicionar venda", na etapa de produtos. Um aviso informa que essa venda não movimenta o estoque. É exibida uma tabela com:
   • cada serviço da OS, já com o produto vinculado na categoria, a quantidade e o valor do item de serviço (o mesmo valor definido/ajustado na OS, com base no valor padrão do serviço);
   • cada equipamento vendido ou em comodato lançado na OS, com produto, quantidade e valor unitário.
4. Marque (checkbox) quais itens realmente entram nessa venda — é possível gerar a venda só de parte dos itens da OS.
5. Clique em Próximo. O sistema valida os produtos marcados e avança para a etapa de pagamento.
6. Na etapa de pagamento, preencha:
   • Tipo de venda — se o serviço da OS já tiver um Tipo de Venda configurado com Forma de pagamento padrão, os campos abaixo já vêm pré-preenchidos;
   • Forma de pagamento (carteira/modelo de cobrança);
   • Natureza de operação (vem pré-selecionada com a natureza de operação padrão do cliente);
   • Valor total — calculado automaticamente pela soma dos itens marcados, na moeda da carteira escolhida (campo somente leitura);
   • Data do documento;
   • Parcelas — quantidade de parcelas (padrão 1); ao alterar, a tabela de vencimentos/valores por parcela é recalculada automaticamente;
   • Observações (texto livre, opcional);
   • Gerar cobranças — só aparece se a configuração "Gerar débito sem cobrança" estiver habilitada; permite criar o débito sem já emitir a cobrança (boleto/Pix).
7. Confira a tabela de parcelas (vencimento e valor de cada uma). A soma das parcelas precisa bater exatamente com o valor total exibido, senão o sistema recusa com "A soma dos valores das parcelas não é igual ao valor total da venda."
8. Clique em Finalizar venda.

O que acontece ao finalizar (conexão com o financeiro)

1. É criado um documento de venda (VendaRecebimento) vinculado ao ID da OS, com a descrição preenchida automaticamente ("Referente a OS de Protocolo ..." + lista dos serviços);
2. Para cada item marcado é gravado um VendaProduto;
3. Para cada parcela é gerado um débito (DebitoDetalhe) do cliente;
4. Se a opção "Gerar cobranças" estiver ativa (ou a configuração nem existir), o sistema gera a cobrança de cada débito (boleto/Pix conforme a carteira escolhida) automaticamente;
5. Se o Tipo de Venda usado estiver configurado para emitir Nota Fiscal automaticamente na criação, o sistema tenta gerar a nota fiscal na hora — se falhar, a venda continua criada normalmente e um aviso extra é exibido ("Não foi possível gerar as notas!");
6. O sistema exibe a mensagem "Venda finalizada com sucesso." e redireciona para a tela de detalhe da venda (Financeiro > Vendas e Recebimentos).

Depois de gerada, é possível voltar à OS a qualquer momento e clicar em Ver vendas para abrir a listagem de vendas filtrada por aquela Ordem de Serviço.

Erros comuns

Mensagem / situação	Causa
"Nenhum serviço ou equipamento definido na Ordem de Serviço!"	A OS não tem item de serviço nem equipamento lançado — não há o que vender.
"Nenhum serviço da Ordem de Serviço possui produtos para gerar uma venda!"	O(s) serviço(s) vinculados à OS não têm "Produto Pessoa Física" cadastrado na categoria.
"O tipo de venda não possui uma conta atrelada!"	O Tipo de Venda selecionado está sem Conta configurada no cadastro financeiro.
"A geração de débito em conta só é permitida quando a venda está atrelada a um contrato."	Escolhida uma forma de pagamento do tipo débito em conta numa OS sem contrato vinculado.
"Não é possível gerar uma venda com parcela vencida!"	Data de vencimento de uma parcela informada no passado.
"O vencimento não pode ser menor que o da parcela anterior!"	Parcelas fora de ordem cronológica.
"A soma dos valores das parcelas não é igual ao valor total da venda."	Ajuste manual nos valores das parcelas sem recalcular o total corretamente.