Ordem de Serviço¶

Movimentações > Ordem de Serviço

O que é¶

A Ordem de Serviço (OS) é o documento central para registro e controle de prestação de serviços ao cliente. Por meio dela, a empresa registra quais serviços serão executados, quais produtos serão utilizados ou vendidos junto ao serviço, e quem é o responsável pelo atendimento. Cada OS recebe um número sequencial automático e fica vinculada a um cliente, vendedor/atendente e filial.

A OS suporta tanto cenários de pura prestação de serviço (assistência técnica, manutenção, reparos) quanto cenários mistos em que o serviço é acompanhado de venda de peças e materiais. Ela também pode ser usada como orçamento, sendo convertida em OS efetiva após aprovação do cliente.

Após a execução do serviço, a OS pode ser faturada — gerando automaticamente Nota Fiscal de venda ou de serviço — e pode originar parcelas no financeiro (contas a receber). O ciclo completo vai de "em aberto" até "fechada com NF emitida", passando por status personalizáveis cadastrados no sistema.

Como acessar¶

No menu principal, clique em Movimentações → Ordem de Serviço.

Onde impacta o sistema¶

Estoque: saída de produtos incluídos na aba Produtos da OS (tabela OS_ITENS / campos OI_*). Entregas parciais de produtos são registradas separadamente.
Financeiro / Contas a Receber: ao faturar a OS, o sistema gera parcelas na tabela OS_PARC (OP_*). O módulo de Geração de Parcelas (uGeraParc) consulta diretamente as OSs abertas.
Nota Fiscal (Vendas): a aba Gerar Vendas unifica uma ou mais OSs e gera a NF via uVendas. O módulo uGeraNFSeq permite geração de NF em sequência.
Comissão de Vendedores: o campo de comissão da OS é referenciado pelo relatório uRelVendComiss e pelo cadastro de vendedores uVendedor.
Contratos de Manutenção: uGeraContratos gera cobranças de contratos a partir de OSs com flag de contrato ativo.
Equipamentos do Cliente: a aba Equipamentos alimenta o cadastro de equipamentos em atendimento (uVeicEquip, uEquipPrev).
Acompanhamento de OS: módulo uOSAcomp registra histórico de acompanhamento por técnico/funcionário.
Relatórios: uRelOSVend, uRelOSProd, uRelOSGraf, uRelOsClie, uRelAcompOS consomem os dados das OSs abertas e fechadas.
Conferência: uConferencia referencia OSs para conferência de itens entregues.
Condicional: uCondicional pode referenciar OSs em processos de condicional.
PDV: uEmissOS (PDV 2012) emite OS no ponto de venda.

Como abrir uma Ordem de Serviço¶

A abertura de uma OS é um processo multi-etapa. O Gravar do cabeçalho apenas registra a OS com seu número sequencial — os serviços, peças e demais informações devem ser incluídos nas abas correspondentes antes de considerar o documento completo.

Etapa 1 — Cabeçalho da OS¶

Clique em Novo (ou Alt+N). O sistema navega para a aba de cadastro e preenche automaticamente a data, hora, filial e usuário logado.
Informe o Cliente e pressione Tab. O sistema valida o cadastro, verifica inadimplência, limite de crédito e situação de bloqueio. Clientes inativos ou bloqueados para lançamento de OS não são aceitos.
Informe o Vendedor responsável pelo atendimento. Se o parâmetro "Usar vendedor do usuário" estiver ativo, o campo é preenchido automaticamente.
Selecione o Status inicial da OS (ex.: "Em Orçamento", "Em Aberto") conforme os status configurados na empresa.
Se aplicável, informe o Grupo, Transportador e Forma de Pagamento.
Defina a Previsão de Entrega (data e hora). Quando o parâmetro de previsão obrigatória estiver ativo, o campo é exigido para gravar.
Preencha observações na aba OS se necessário.
Clique em Gravar (ou Alt+G). O sistema gera o número sequencial da OS e a registra no banco. A partir daqui, os itens podem ser incluídos.

O Gravar do cabeçalho abre a OS com seu número. Os serviços e peças devem ser incluídos nas etapas seguintes antes de finalizar o atendimento.

Etapa 2 — Serviços¶

Para cada serviço a ser prestado:

Clique na aba Serviços.
Clique em Novo (ou Alt+N).
Informe o Serviço (pesquise com F3), a Quantidade e o Valor Unitário.
Se a empresa exigir, informe o Colaborador responsável pela execução.
Informe o CFOP do serviço (obrigatório para faturamento posterior).
Clique em Gravar (ou Alt+G).
Repita para cada serviço adicional.

Etapa 3 — Produtos / Peças (se houver)¶

Para cada peça ou produto a ser utilizado:

Clique na aba Produtos.
Clique em Novo (ou Alt+N).
Informe o Produto (pesquise com F3), a Tabela de Preço, a Quantidade e o Valor Unitário.
Se a empresa exigir, informe o Colaborador responsável pelo item.
Clique em Gravar (ou Alt+G).
Repita para cada produto adicional.

Etapa 4 — Equipamentos (quando aplicável)¶

Se o atendimento envolver um equipamento do cliente:

Clique na aba Equipamentos.
Clique em Novo e informe o código do equipamento, número de série, marca, modelo e dados de garantia.
Clique em Gravar.

Etapa 5 — Atualização de status conforme andamento¶

Durante a execução do serviço, atualize o Status da OS para refletir o estágio atual (ex.: Orçamento → Em Andamento → Concluída). Cada alteração de status é registrada automaticamente com data e hora.

Use a aba Histórico para registrar observações e acompanhamentos ao longo do processo.

Para faturar a OS (gerar Nota Fiscal), acesse a aba Gerar Vendas, selecione as OSs desejadas e clique em Gerar Venda. Somente OSs com status que permitam faturamento serão listadas.

Campos desta tela¶

Aba: OS (dados gerais)¶

Campo	O que é	Observações
Código	Número sequencial da OS	OS.OS_CODIGO. Gerado automaticamente via gerador `GEN_OS` no momento da gravação.
Data	Data de abertura da OS	OS.OS_DATA. Preenchida automaticamente com a data atual ao criar nova OS. Obrigatório.
Hora	Hora de abertura	OS.OS_HORA. Preenchida automaticamente.
Cliente	Código do cliente atendido	OS.OS_CLIENTE. Obrigatório. Valida cadastro, situação de crédito e bloqueios.
Nome do Cliente	Nome exibido do cliente	OS.OS_NOMECLI. Preenchido automaticamente ao selecionar o cliente.
Vendedor	Responsável pelo atendimento/venda	OS.OS_VENDEDOR. Obrigatório. Pode ser preenchido automaticamente pelo vendedor do usuário logado ou pelo vendedor padrão do cliente.
Grupo	Grupo de clientes ao qual pertence a OS	OS.OS_GRUPO. Opcional.
Transportador	Empresa de transporte vinculada	OS.OS_TRANSP. Opcional.
Forma de Pagamento	Como o serviço/produto será pago	OS.OS_FPGTO. Opcional na abertura.
Previsão de Entrega	Data e hora previstas para conclusão/entrega	OS.OS_PREVENTR / OS.OS_PREVHORA. Pode ser obrigatório conforme parâmetro do módulo. A data final da previsão não pode ser anterior à data inicial.
Previsão Final	Data e hora finais da previsão (intervalo)	OS.OS_PREVENTRFIM / OS.OS_PREVHORAFIM.
Status	Situação atual da OS (ex.: em aberto, em andamento, concluída)	OS.OS_STATUS. Lista de status configuráveis no cadastro de status. Ao alterar, o sistema registra data e hora da mudança automaticamente (OS.OS_DTSTATUS / OS.OS_HRSTATUS).
Financeiro	Situação financeira da OS	OS.OS_FINANCEIRO. Valores: aprovado, reprovado, análise, aguardando.
Orçamento	Indica se a OS é um orçamento	OS.OS_ORCAMENTO. `'S'` = orçamento / `'N'` = OS efetiva.
OS Externa	Referência a número de OS em sistema externo	OS.OS_OSEXTERNA. Opcional.
Emitir	Flag de controle de emissão	OS.OS_EMITIR.
Romaneio	Número do romaneio vinculado	OS.OS_ROMANEIO. Opcional.
Obs. da NF	Observação que será impressa na Nota Fiscal	OS.OS_OBSNF.
Observação	Observação geral da OS	OS.OS_OBS. Texto livre. Pode ser preenchido automaticamente com observação padrão configurada nos parâmetros.
Observação Padrão	Texto padrão selecionável para a observação	OS.OS_OBSPADRAO. Selecionado via pesquisa (F3).
Contrato de Manutenção	Indica se a OS está vinculada a contrato	OS.OS_CONTRATO. `'S'` = com contrato.
Conserto Realizado	Indica se o conserto foi concluído	OS.OS_CONSERTADO.
Data do Conserto	Data em que o conserto foi realizado	OS.OS_DTCONSERTO.
Tipo de Atendimento	Classificação do tipo de atendimento prestado	OS.OS_TIPOATEND.
Pedido de Transferência	Indica que a OS é uma transferência/troca	OS.OS_TRANSFER. `'S'` = sim / `'N'` = não.
OS de Venda Futura	Sinaliza venda futura	OS.OS_VENDAFUTURA. `'S'` = sim / `'N'` = não.
Desconsiderar no Estoque	Não calcula a OS no saldo de estoque	OS.OS_NCALCESTQ.
Não calcular ST	Ignora cálculo de Substituição Tributária	OS.OS_NAOCALCST.
Operação Interna	Marca a OS como operação interna (não aparece para cliente)	OS.OS_VENDAINTERNA.
Consumidor Final	Indica venda a consumidor final	OS.OS_CONSUMIDOR. Preenchido automaticamente conforme ramo da filial (Varejo/PrestServ = `'S'`).
Loja	Filial responsável pela OS	OS.OS_FILIAL. Obrigatório. Preenchido automaticamente com a filial do usuário.
Usuário	Usuário que criou/editou a OS	OS.OS_USUARIO. Preenchido automaticamente.
Frete	Valor do frete	OS.OS_VLFRETE.
Conta Frete	Responsável pelo frete (destinatário, remetente etc.)	OS.OS_CTAFRETE. Preenchido automaticamente pelo padrão do cliente ou parâmetro da filial.
Seguro	Valor do seguro	OS.OS_VLSEGURO.
Despesas Acessórias	Valor de despesas acessórias	OS.OS_VLDESPACES.
End. Entrega	Endereço de entrega do cliente	OS.OS_ENDENTREGA. Selecionado entre os endereços cadastrados do cliente.
Comissão (%)	Percentual de comissão do vendedor	OS.OS_PERCCOMISS.
Local Prest. Serv.	Cidade e UF onde o serviço é prestado	OS.OS_CIDADEPREST / OS.OS_UFPREST. Relevante para NFS-e.
Crédito Ativo	Crédito disponível do cliente (informativo)	Exibido ao selecionar o cliente.
Limite de Crédito	Limite de crédito do cliente (informativo)	Exibido ao selecionar o cliente.

* = campo obrigatório

Aba: Equipamentos¶

Campo	O que é	Observações
Código	Código do tipo de equipamento	OE.OE_CODEQUIP. Obrigatório. Pesquisa via F3.
Número	Número de série ou patrimônio do equipamento	OE.OE_NRO.
Descrição	Descrição do equipamento	OE.OE_DESCR.
Marca	Marca do equipamento	OE.OE_MARCA.
Modelo	Modelo do equipamento	OE.OE_MODELO.
Cor	Cor do equipamento	OE.OE_COR.
Garantia	Tipo de garantia aplicável	OE.OE_TIPOGARANTIA / OE.OE_GARANTIA.
Data de Garantia	Data de vencimento da garantia	OE.OE_DTGARANTIA.
Fornecedor	Fornecedor do equipamento	OE.OE_FORNEC.
NF	Número da NF de compra do equipamento	OE.OE_NF.

Aba: Produtos¶

Campo	O que é	Observações
Produto	Código do produto a ser utilizado/vendido	OI.OI_PRODUTO. Obrigatório. Pesquisa via F3.
Tabela de Preço	Tabela de preços a ser aplicada	OI.OI_TBLPRECO.
Quantidade	Quantidade do produto	OI.OI_QUANTIDADE. Obrigatório.
Vlr. Unitário	Valor unitário do produto	OI.OI_VLUNITARIO. Obrigatório.
% Desc.	Percentual de desconto no item	OI.OI_PERCDESC.
Vlr. Desconto	Valor do desconto calculado	OI.OI_VLDESC.
Referência	Código de referência do produto	PRODUTOS.PR_REFERENCIA. Somente leitura.
Ref. Fabricante	Referência do fabricante	PRODUTOS.PR_REFERENCIA1. Somente leitura.
Und.	Unidade de medida do produto	PRODUTOS.PR_UNIDADE. Somente leitura.
Colaborador	Funcionário responsável pelo item	OI.OI_FUNCIONARIO. Pode ser obrigatório conforme parâmetro do módulo.
Saldo	Quantidade ainda não faturada/entregue	OI.OI_SALDOQT. Calculado pelo sistema.

Aba: Serviços¶

Campo	O que é	Observações
Serviço	Código do serviço a ser prestado	OV.OV_SERVICO. Pesquisa via F3.
Quantidade	Quantidade de unidades do serviço	OV.OV_QTSERV.
Vlr. Unitário	Valor unitário do serviço	OV.OV_VLUNIT.
Tabela de Preço	Tabela de preços para o serviço	OV.OV_TBLPRECO.
Desconto	Percentual e valor de desconto no serviço	OV.OV_PERCDESC / OV.OV_VLDESC.
CFOP	Código Fiscal de Operações e Prestações	OV.OV_CFOP. Obrigatório para faturamento. Pesquisa via F3.
Dedução	Valor de dedução da base de cálculo do ISS	OV.OV_DEDUCAO.
Retenção INSS	Valor de INSS retido no serviço	OV.OV_VLINSS. Calculado automaticamente conforme tributação.
Colaborador	Funcionário que executou o serviço	OV.OV_FUNCIONARIO. Pode ser obrigatório conforme parâmetro.
Data / Início / Fim	Data e horas de início e término do serviço	OV.OV_DATA / OV.OV_HORAI / OV.OV_HORAF. Controle de tempo do serviço.

Aba: Outros (descontos e pagamentos)¶

Campo	O que é	Observações
Frete	Valor de frete global da OS	OS.OS_VLFRETE. Pode ser rateado pelos itens com o botão Aplicar.
Desp. Acessórias	Despesas acessórias globais	OS.OS_VLDESPACES.
Seguro	Valor de seguro global	OS.OS_VLSEGURO.
Desconto Total	Percentual e valor de desconto global	Aplicável sobre produtos, serviços ou ambos.
Pagamento Negociado	Parcelamento acordado com o cliente	Parcelas registradas em OS_PARC (OP_*).

Aba: Histórico¶

Campo	O que é	Observações
Data	Data do registro de histórico	OH.OH_DATA. Obrigatório.
Hora	Hora do registro	OH.OH_HORA. Obrigatório.
Histórico	Descrição do andamento registrado	OH.OH_HISTORICO. Obrigatório. Texto livre.
Usuário	Usuário que registrou	OH.OH_USUARIO.
Status	Status da OS no momento do registro	OH.OH_STATUS.

Aba: Imagens¶

Permite anexar imagens relacionadas à OS (fotos do equipamento, do defeito etc.). Cada imagem possui uma descrição e é armazenada no banco de dados.

Aba: Gerar Vendas¶

Tela para unificação e faturamento de OSs. Permite selecionar uma ou mais OSs de um cliente e gerar a Nota Fiscal correspondente. Possui filtros por cliente, código de OS e grupo. Opção de acumular produtos por valor unitário.

Regras e comportamentos do sistema¶

Criação de nova OS¶

Ao clicar em Novo, o sistema define automaticamente: data atual, hora, usuário logado, filial, status inicial 0, financeiro padrão 3, OS não orçamento ('N'), não transferência ('N'), não venda futura ('N'), não impressa ('N'), não calcula ST ('N').
Se o parâmetro "Usar vendedor do usuário" estiver ativo (USA_VEND_USUARIO = 'S'), o vendedor é preenchido automaticamente com o vendedor vinculado ao usuário logado.
Se houver cliente padrão configurado no parâmetro especial (PEDD_CLIENTE_PADRAO), ele é preenchido automaticamente.
A conta de frete é definida pela ordem: cadastro do cliente → parâmetro especial da filial → padrão "Destinatário".

Validações ao selecionar o cliente¶

O sistema rejeita clientes inativos com a mensagem: "Cliente INATIVO. Verifique!"
Clientes com flag de bloqueio de lançamento de OS não são aceitos: "Não é permitido lançamento para este cliente!"
Clientes bloqueados (situação 3) exigem senha de desbloqueio (nível 7) se o parâmetro BLOQ_CLIE = 'S'.
Clientes inadimplentes exibem alerta e, se o parâmetro BLOQ_CLIDEVE = 'S' e o cliente não permitir inadimplência, exigem senha de desbloqueio (nível 8).
Clientes monitorados (situação 2) exibem alerta sem bloquear o fluxo.
Se configurado, o sistema valida o limite de crédito ao selecionar o cliente e bloqueia caso o valor da OS exceda o limite.

Validações ao gravar¶

Campos obrigatórios em branco impedem a gravação (validação padrão VerificaCamposEmBranco).
Se o parâmetro exigir previsão de entrega, a gravação falha com: "Previsão de entrega não informada. Verifique!"
A data final da previsão não pode ser anterior à data inicial: "Data Final da Previsão de Entrega não pode ser menor do que a Data Inicial".
Se o parâmetro OS_KMOBRIGATORIO = 'S' e VEIC_PEDD = 'S', a kilometragem do veículo é obrigatória: "Obrigatório o preenchimento da Kilometragem do Veículo".
Ao gravar produto, se o parâmetro de colaborador obrigatório em produtos estiver ativo e o campo estiver vazio: "Colaborador Obrigatório. Verifique!"
Ao gravar serviço, se o parâmetro de colaborador obrigatório em serviços estiver ativo e o campo estiver vazio: "Colaborador Obrigatório. Verifique!"
Na gravação de saída parcial, a quantidade não pode ser maior que o saldo nem menor/igual a zero: "A quantidade informada é inválida. Verifique!"
Se a OS possui link de pagamento vinculado, a exclusão exige confirmação adicional: "Esta OS possui pagamento com Link. Deseja excluir a OS mesmo assim?"

Retenção de INSS nos serviços¶

O sistema acumula o total de INSS (OV_VLINSS) de todos os serviços da OS.
O INSS retido é deduzido do total da OS quando o valor acumulado for ≥ R$ 10,00 e uma das condições for atendida:
O CFOP do serviço tem CF_RETERCONTR = 'S' (reter contribuições), ou
O cliente não é imune a impostos de serviço (CL_IMUNEIMPSERV ≠ 'S') e há ISS calculado (OV_VLISS > 0).
Abaixo de R$10,00, o INSS não é deduzido do total.

Status e financeiro¶

Ao alterar o Status, o sistema registra automaticamente a data e hora da mudança nos campos internos de data/hora do status.
O campo Financeiro não pode ficar em branco; se apagado, o sistema restaura o valor anterior ou define o padrão 4.

Orçamento¶

Se o parâmetro "Atualizar data ao tirar orçamento" estiver ativo e a OS for convertida de orçamento para OS efetiva (campo OS_ORCAMENTO alterado de 'S' para 'N'), o sistema atualiza as datas das parcelas em OS_PARC proporcionalmente à nova data.

OS com contrato de manutenção¶

Ao gravar equipamento em uma OS com contrato (OS_CONTRATO = 'S'), o sistema verifica se o equipamento possui contrato cadastrado para o cliente: "Equipamento sem contrato!"

OS fechada (com NF)¶

OSs com status 1 (fechada — NF gerada) bloqueiam inclusão e exclusão de equipamentos e produtos: "OS já gerou Nota Fiscal. Impossível Incluir/Excluir Produtos."
Não é possível excluir informações de um DAV-OS que já teve saídas parciais: "Não é possível excluir informações de um DAV que já teve saídas parciais!"

Exclusão¶

Na tela de consulta (listagem), a exclusão não é permitida: "Não foi possível excluir. Acesse o registro para realizar a exclusão!"
Exclusão de produto em OS efetiva (não orçamento) pode exigir senha de desbloqueio (nível 4).
Exclusão de produto em orçamento exige permissão de módulo 309.

Geração de NF¶

A aba Gerar Vendas permite selecionar OSs por cliente, código ou grupo e unificá-las para geração de uma única NF.
Opção de acumular produtos por valor unitário ao unificar.
Também é possível gerar NF em sequência pelo menu de opções (Gerar NF em Sequência).

Grade de consulta (listagem de OSs)¶

A coluna Placa / Modelo exibe OS_PLACA + ' / ' + OS_MODELO (campo calculado PLACAMODELO). Quando o modelo está em branco, exibe apenas a placa.

Impressão e outros recursos¶

A OS pode ser enviada por e-mail (F11) ou por WhatsApp diretamente pelo menu de opções.
Senha de impressão pode ser gerada pela opção Imprimir Senha (F9).
É possível clonar a OS como orçamento pelo menu de opções.
Geração de preventivas de manutenção e cobranças de contratos disponíveis pelo menu de opções.
Marcação OS Impressa (OS_IMPRESSO = 'S') pode bloquear alterações conforme permissão de módulo 176.

Dúvidas frequentes¶

Por que não consigo selecionar o cliente? O cliente pode estar inativo, bloqueado para lançamento de OS, inadimplente sem permissão de exceção, ou o usuário pode não ter senha de desbloqueio. Verifique a situação do cliente no cadastro de clientes e consulte o supervisor para liberação.

Por que não consigo gravar a OS? Verifique se todos os campos obrigatórios estão preenchidos (Data, Cliente, Vendedor, Loja). Se a empresa exige previsão de entrega, preencha a data e hora de previsão. Verifique também se a kilometragem do veículo é obrigatória no seu parâmetro.

Como transformar um orçamento em OS? Abra o orçamento, altere o campo Orçamento de "Sim" para "Não" e grave. O sistema pode atualizar as datas de parcelamento automaticamente conforme parâmetro.

Como faturar uma OS (gerar Nota Fiscal)? Acesse a aba Gerar Vendas, informe o cliente, clique em Consultar, selecione as OSs desejadas e clique em Gerar Venda. OSs já faturadas (status fechada) não aparecem na lista.

Por que o colaborador é obrigatório? A empresa configurou o parâmetro que exige informar o colaborador responsável ao incluir produtos ou serviços na OS. Informe o funcionário no campo Colaborador antes de gravar.

Como registrar o acompanhamento/andamento de uma OS? Use a aba Histórico para registrar as etapas do atendimento com data, hora e descrição. Cada registro fica vinculado ao usuário logado.

Como enviar a OS para o cliente? Use o menu de opções (botão de menu na tela) e escolha Enviar OS por Email (F11) ou Enviar OS por WhatsApp.

O sistema não deixa excluir um produto da OS. Por quê? Se a OS já foi impressa, é necessária permissão especial (módulo 176). Se a OS for efetiva (não orçamento), pode ser necessária senha de desbloqueio de nível 4. Se já gerou NF (status fechada), a exclusão é bloqueada completamente.