Manual de implantação · Revendas

Nova Ordem de Serviço

Da parametrização na casa do cliente até a emissão da NF-e das peças e da NFS-e dos serviços — incluindo a reforma tributária (IBS/CBS), já homologada em produção.

Versão do módulo · 24/07/2026 Público · membros que implantam e treinam Tempo de implantação · 40 a 60 min por cliente

Antes de começar

A atualização do banco é automática, mas precisa rodar até o fim antes de qualquer parametrização. Nenhum recurso novo funciona sem ela.

  1. Faça backup da base do cliente. Regra de ouro antes de qualquer atualização. Um gbak ou cópia do DADOS.FDB com o Firebird parado.
  2. Substitua o executável e abra o sistema. A rotina de atualização dispara sozinha quando o executável é mais recente que a última atualização registrada. Aparece a janela Atualização do Banco de Dados.
  3. Espere terminar e leia a última linha. O esperado é “Atualização concluída” sem erros. Se aparecer “concluída com N erro(s)”, clique em Ocultar/Exibir detalhes, copie o log e envie para o suporte — não continue a implantação.
  4. Confira o menu. Deve existir o menu OS com: Ordem de Serviço, Contratos de Recorrência, Agenda de Técnicos, NFS-e, Configurações e Relatórios.
Se der erro, a rotina tenta de novo

Desde 24/07/2026, quando a atualização termina com erro ela não marca a base como atualizada — ou seja, roda tudo novamente no próximo login. A migração é idempotente (pode rodar quantas vezes for preciso, sem duplicar nada).

O que a atualização cria sozinha

Além das tabelas do módulo, ela já deixa o cliente com um ponto de partida utilizável:

Tipo GERAL

Um tipo de O.S padrão, com os cinco status e as sete transições de fluxo. Serve para quem não quer configurar nada.

5 modelos por ramo

Assistência de Celulares, Informática e Notebooks, Oficina Mecânica, Eletrônicos/Eletrodomésticos e Refrigeração — cada um com campos e checklist próprios.

Tabelas fiscais

Classificação tributária oficial e a correlação NBS → indicador de operação (675 códigos) usadas pela reforma na NFS-e.

Modelos de WhatsApp

Mensagens prontas de orçamento, aprovação e conclusão, com marcadores como {CLIENTE} e {OS}.

Tipos de O.S — o coração da configuração

O Tipo define como a tela se comporta: o que se chama “equipamento” ou “veículo”, quais campos aparecem, qual o fluxo de status e se nasce como orçamento. É aqui que você adapta o sistema ao ramo do cliente.

Abra em OS › Configurações › Tipos de OS.

Escolha o ponto de partida

Na lista da esquerda já existem os modelos prontos. Nunca comece do zero se o ramo do cliente for parecido com um deles: selecione o modelo, ajuste rótulos e campos, e clique em Definir como padrão da empresa. Toda O.S nova nasce com o tipo padrão.

ConfiguraçãoPara que serve na prática
Objeto do serviçoNenhum, Equipamento, Veículo ou Imóvel. Define quais campos do objeto aparecem (série, marca, modelo; placa, km, ano).
RótulosTroca as palavras na tela: “Problema” pode virar “Reclamação do cliente”, “Laudo” virar “Diagnóstico”, “Objeto” virar “Veículo”.
Movimenta estoqueAo concluir a O.S, baixa do estoque as peças lançadas. Deixe ligado em quem vende peça.
Fatura NF-e / Fatura NFS-eLibera os botões de faturamento. Um cliente que só presta serviço pode desligar a NF-e, e vice-versa.
Nasce como orçamentoA O.S começa em ORÇAMENTO e só vira serviço depois de aprovada. Com validade em dias.
cIndOpSó para a reforma tributária. Deixe em “(automático)” — ver seção 6.

As quatro abas de baixo

Campos extras — campos que só existem naquele ramo (senha do aparelho, IMEI, nível de combustível, BTUs). Você define nome, rótulo, tipo (texto, número, data, lista de opções), se é obrigatório e a ordem. Eles aparecem na aba “Campos Extras” da O.S, em três colunas.

Status e Transições — o fluxo. Cada status tem um “funciona como” (o espelho) que diz ao sistema o que ele significa: orçamento, em aberto, concluída, cancelada ou faturada. As transições dizem quem pode virar o quê, se exige senha de supervisor e se movimenta estoque. Mexa aqui só quando o cliente pedir um fluxo diferente; o padrão dos modelos já cobre a maioria.

Checklist — modelos de conferência (ex.: “Tela sem trincos”, “Bateria testada”). Ao abrir uma O.S desse tipo, o checklist vem em branco para o técnico marcar.

Erro comum na implantação

Criar um tipo novo e esquecer de cadastrar os status e transições. Sem eles a O.S não muda de situação. Por isso: duplique um modelo pronto em vez de criar do zero — ele já vem com o fluxo completo.

Técnicos e comissão

A comissão do técnico é simples de configurar e costuma gerar dúvida: só serviço comissiona, e só quando há técnico na linha.

  1. Marque quem é técnico. Em Pessoas, no cadastro, marque Técnico. Só quem está marcado aparece nas listas de técnico da O.S e da agenda.
  2. Informe o percentual. No mesmo cadastro, o campo % Comissão do técnico. É percentual, não valor — 25 significa 25%.

Como o sistema calcula

Na conclusão da O.S, o sistema percorre apenas os itens da aba Serviços que tenham técnico informado na linha, aplica o percentual do cadastro daquele técnico e lança um título no Contas a Pagar (histórico “OSCOM”). Peças e materiais não comissionam. O técnico do agendamento e o da aba Técnicos servem para organização e apontamento de horas — não geram comissão sozinhos.

Enquanto a O.S está aberta, o painel de comissão prevista no rodapé da aba Serviços mostra quanto vai sair, para o cliente conferir antes de concluir.

Serviços e peças no cadastro de produtos

A diferença entre o que vira NFS-e e o que vira NF-e está aqui. Errar isso é a causa número um de problema no faturamento.

CampoServiçoPeça / material
Serviço (S/N)SimNão
Código LC 116Obrigatório (ex.: 01.01)
Alíquota ISSA do município do cliente
NCM / NBSNBS — obrigatório com a reformaNCM
CFOP, CST/CSOSNComo qualquer produto
Garantia (dias)Opcional; puxa automático para a O.S
O filtro por aba é automático

Na O.S, a aba Serviços só aceita produtos marcados como serviço; as abas Peças e Materiais só aceitam os demais. Se o cliente reclamar que “não acha o item na grade”, quase sempre é o campo Serviço marcado errado no cadastro.

NFS-e: credenciais e ambiente

Cada prefeitura tem seu provedor. O sistema descobre o provedor sozinho pelo código IBGE do município — o que você precisa é das credenciais que o cliente obtém na prefeitura.

Abra em OS › NFS-e › Config. NFS-e.

CampoO que preencher
Empresa / MunicípioSó confirmação — vem do cadastro da empresa.
ProvedorDeixe em AUTOMÁTICO. Só troque se o suporte orientar.
Usuário / SenhaCredenciais do web service, fornecidas pela prefeitura (não são as do portal do contribuinte, em geral).
Chave de acesso / Token
Frase secreta
Chave de autorização
Só alguns provedores usam. Preencha o que a prefeitura entregar; o resto fica vazio.
SérieSérie do RPS. Normalmente 1.
AmbienteHomologação para testar, Produção para valer. Ver o aviso abaixo.
cIndOpPadrão da empresa para a reforma — ver seção 6.

Use o botão F4 · Testar antes de sair: ele valida credenciais e comunicação com a prefeitura. E lembre: o certificado digital é o mesmo da NF-e, configurado em Configurações › Config. Fiscais — não se cadastra certificado aqui.

Atenção com a homologação

Em homologação, muitas prefeituras devolvem uma nota simulada completa — com número sequencial real e código verificador — mas a nota não existe de verdade. Por isso o sistema registra esse retorno como “TESTE OK”, nunca como autorizada. Se ele registrasse como autorizada, o cliente ficaria com uma nota fantasma e o item travado. Terminou os testes: mude para Produção e refaça o faturamento.

Antes da primeira emissão, confira no cadastro da empresa

  • Inscrição Municipal preenchida (é o cadastro econômico na prefeitura).
  • Regime tributário correto — Simples Nacional muda a tributação enviada.
  • Código IBGE do município — é o que seleciona o provedor.
  • Se o cliente tiver regime especial ou for incentivador cultural, marque; alguns municípios exigem.

Reforma tributária (IBS/CBS) na NFS-e

Já está pronto e homologado em produção. O que o cliente precisa fazer é pouco — e o sistema resolve o resto sozinho, com as tabelas oficiais.

Como ligar

A reforma tem uma única chave: Ativar Reforma, no cadastro da empresa (a mesma que já vale para NF-e e NFC-e). Ligou, a NFS-e passa a enviar o grupo de IBS/CBS.

O que precisa estar preenchido

  1. NBS em todo serviço. É o único preenchimento obrigatório: o campo NCM/NBS no cadastro do serviço. Sem ele a prefeitura rejeita (erro 00366) e o sistema avisa antes de enviar, dizendo qual serviço está sem código.
  2. Classificação tributária: não precisa mexer. O sistema resolve na hora da emissão pelo mesmo motor da NF-e, usando a tabela oficial. Só preencha manualmente se o contador do cliente indicar um código específico.
  3. Indicador de operação (cIndOp): deixe automático. O sistema descobre pelo NBS do serviço, usando a correlação oficial (675 códigos). Só configure se o ramo tiver regra própria.
Situação do clienteO que configurar no cIndOp
Assistência técnica, conserto na bancadaAutomático (resolve para 050101)
Atendimento no endereço do clienteNo Tipo de O.S: 050102
Software, consultoria, serviço remotoAutomático (resolve para 100301)
Serviço sobre imóvelNo Tipo de O.S: 020201
Quem calcula o IBS e a CBS

O sistema envia a classificação (situação tributária, classificação e indicador de operação) e a prefeitura calcula e devolve os valores. Isso é o previsto na nota técnica e foi comprovado em produção: nota autorizada voltou com IBS e CBS calculados sobre a base já deduzida do ISS. Ou seja, o cliente não digita alíquota de IBS/CBS em lugar nenhum.

Simples Nacional

Empresa do Simples sem classificação própria não envia o grupo de IBS/CBS — é o que a nota técnica determina neste primeiro momento. Mas o NBS continua obrigatório.

Abrindo uma O.S

Fluxo do balcão, na ordem em que o atendente preenche. A tabulação segue essa mesma ordem — dá para preencher tudo com Enter ou Tab, sem mouse.

Abra em OS › Ordem de Serviço e tecle F2.

  1. Cliente. Digite parte do nome ou o CPF/CNPJ. Se não existir, F5 abre o cadastro de pessoas sem sair da O.S. Ao escolher, telefone e endereço vêm junto.
  2. Agendamento (opcional). No topo: técnico responsável, data e hora. Serve para a Agenda de Técnicos e avisa se houver choque de horário do mesmo técnico.
  3. Objeto do serviço. Painel da direita: descrição, marca, modelo, número de série — os rótulos mudam conforme o Tipo (em oficina, vira placa/km/ano).
  4. Problema e laudo. O que o cliente relatou e, depois, o diagnóstico do técnico.
  5. Itens. Três abas: Serviços (mão de obra — vira NFS-e), Peças e Materiais (vira NF-e). Digite o código, use a lupa, ou bipe o código de barras no campo F11. Informe o técnico na linha do serviço para gerar comissão. Ctrl+Del exclui o item da linha.
  6. Abas de baixo. Checklist de entrada, campos extras do ramo, anexos (fotos do aparelho ao receber — evita discussão na entrega) e observações.
  7. Grave com F2. A O.S ganha número. Se o tipo nasce como orçamento, ela fica como ORÇAMENTO; senão, EM ABERTO.

Atalhos da tela da O.S

TeclaAção
F2Gravar
F3Finalizar / concluir a O.S (ou aprovar, quando é orçamento)
F4Consultar produtos
F5Consultar/cadastrar pessoas
F6 / F7Inicia / conclui o serviço daquela linha
F8Faturar NF-e das peças e materiais
F9Receber (abre o recebimento)
F11Campo de código de barras
Ctrl+WEnviar mensagem ao cliente pelo WhatsApp

Orçamento e aprovação

Para quem trabalha com aprovação do cliente antes de executar. Se o cliente não usa orçamento, desligue no Tipo de O.S e pule esta seção.

Com o tipo configurado para nascer como orçamento, a O.S entra como ORÇAMENTO com uma validade em dias. Nesse estado ela não baixa estoque, não recebe e não fatura — é só uma proposta.

  • Enviar ao cliente: Ctrl+W usa o modelo de WhatsApp de orçamento, com valor e validade preenchidos.
  • Aprovar: F3 na O.S. Ela vira EM ABERTO, registra data, hora e quem aprovou na linha do tempo, e o serviço pode começar.
  • Reprovar: pelo botão F4 · Cancelar na lista, informando o motivo.

Execução e conclusão

O acompanhamento acontece por linha de serviço e por status — e tudo fica registrado na linha do tempo da O.S.

  1. Iniciar o serviço da linha. Na aba Serviços, com a linha selecionada, F6 marca o início. Ao terminar, F7 marca a conclusão e a data aparece na coluna “Concluído em”.
  2. Apontar horas (opcional). Na aba Técnicos, registra-se início e fim; as horas trabalhadas saem no formato hh:mm.
  3. Checklist de saída e fotos. Marque o checklist e anexe fotos do aparelho pronto.
  4. Concluir a O.S. F3. Aqui o sistema faz três coisas de uma vez: muda para CONCLUÍDA, baixa o estoque das peças (se o tipo movimenta estoque) e lança a comissão dos técnicos no Contas a Pagar.
  5. Avisar o cliente. Ctrl+W com o modelo de conclusão (“está pronta para retirada”).
Reabertura

Reabrir uma O.S concluída exige senha de supervisor e estorna a baixa de estoque e a comissão. É de propósito: evita que a movimentação seja contada duas vezes.

Acompanhamento no dia a dia

Na lista (OS › Ordem de Serviço), os cartões coloridos no topo mostram quantas O.S estão em cada situação e funcionam como filtro rápido. As abas fazem o mesmo, e F8 abre a visão Kanban, onde a O.S se arrasta de coluna em coluna.

NF-e das peças e materiais

Sai da O.S concluída e vai para a tela de NF-e como rascunho, para conferência antes de transmitir.

  1. Com a O.S concluída, tecle F8 (ou F9 · Faturar na lista).
  2. O sistema gera a NF-e em aberto apenas com peças e materiais, com os impostos do cadastro de cada produto e o vínculo com a O.S registrado.
  3. Confira e transmita na tela de NF-e de sempre. O estoque não é baixado de novo — já saiu na conclusão da O.S.
Divisão de responsabilidade

Peça é mercadoria: NF-e, com ICMS. Serviço é ISS: NFS-e, na prefeitura. Uma O.S com os dois gera dois documentos, e é assim que deve ser.

NFS-e dos serviços

O faturamento consolida os serviços da O.S e envia para a prefeitura. Depois disso, tudo se acompanha pela tela de NFS-e Emitidas.

  1. Fature. Na O.S concluída, use o faturamento de serviços. O sistema agrupa os serviços, resolve a classificação fiscal e envia.
  2. Acompanhe. OS › NFS-e › NFS-e Emitidas mostra cada nota com situação colorida: AUTORIZADA, CANCELADA, ERRO ou PENDENTE, com o motivo do erro na última coluna. No rodapé, os totais de autorizadas e canceladas do período.
  3. Entregue ao cliente. F9 · DANFSE gera o documento em A4 (com QR Code e código de barras); o botão direito no grid imprime a via de 80 mm na impressora térmica. F7 abre o link da prefeitura e F8 mostra o XML.
TeclaNa tela de NFS-e Emitidas
F4Cancelar a NFS-e (pede justificativa; respeita o prazo do município)
F5Atualizar a lista
F6Consultar na prefeitura e atualizar a situação
F7Abrir o link público da nota
F8Ver o XML
F9DANFSE em PDF (A4)
Dica de conferência

Se a nota ficou como ERRO, a coluna Motivo / Erro traz a mensagem exata da prefeitura. Corrija o cadastro apontado, e refature a O.S — o item volta a ficar disponível.

Recebimento

O recebimento da O.S usa as mesmas formas de pagamento do PDV, com as mesmas rotinas — inclusive PIX com QR Code e TEF na maquininha.

Na O.S, tecle F9. Abre o mini-fechamento: informe quanto entra em cada forma de pagamento; o rodapé mostra pendente, informado, restante e troco. É possível dividir em várias formas (ex.: parte em dinheiro, parte no cartão).

Dinheiro e cartão

Entram no caixa do operador, cada um com seu tipo — o fechamento separa espécie do resto.

PIX

Se o cliente tem PSP configurado, gera o QR Code dinâmico e confirma o pagamento automaticamente. Sem PSP, usa o QR estático da chave.

TEF (maquininha)

Chama a mesma rotina do PDV, com escolha de parcelamento, e grava NSU, bandeira e autorização no pagamento.

Crédito do cliente

Consome saldo de crédito (de devoluções) direto no recebimento.

A prazo

Gera as parcelas no Contas a Receber, com vencimento e intervalo configuráveis.

Caixa aberto é obrigatório

O recebimento exige o caixa do operador aberto — mesma regra do PDV, para o dinheiro cair na gaveta certa. Se estiver fechado, o sistema oferece abrir na hora (F10). Sem isso, o valor não entraria no fechamento e a conferência do dia não bateria.

Contratos de recorrência e agenda

Contratos (manutenção mensal, contrato fixo)

Em OS › Contratos de Recorrência. A ideia: você cria uma O.S modelo completa (cliente, equipamento, serviço, valor, técnico) e o contrato a clona periodicamente.

  1. Monte a O.S modelo normalmente e anote o número dela.
  2. Crie o contrato com F2: descrição, número da O.S modelo, a cada quantos dias e a data da próxima geração.
  3. Gere com F6: o sistema cria as O.S dos contratos vencidos, já abertas. Cada uma tem vida própria — é faturada e recebida separadamente.

São copiados cliente, itens, valores, técnicos e campos extras. Não são copiados número, datas, situação nem vínculo fiscal. O checklist vem novo, em branco.

Agenda de técnicos

Em OS › Agenda de Técnicos: mostra os agendamentos do período com semáforo — vermelho para atrasado, laranja para hoje e cinza para o que já foi concluído. Filtra por técnico, tem atalhos de Hoje/Semana/Mês e um resumo com quantidade de atrasados e o valor do período. Duplo clique abre a O.S; F4 imprime a agenda para levar a campo.

Roteiro de homologação na casa do cliente

Faça este ciclo completo antes de liberar o módulo. Leva cerca de 20 minutos e pega qualquer parametrização faltando.

0 de 18

Erros mais comuns e o que fazer

SintomaCausa e solução
Erro 00366
NBS obrigatória
O serviço está sem o código NBS. Preencha o campo NCM/NBS no cadastro do serviço e refature. O sistema avisa antes de enviar, dizendo qual serviço está sem código.
Erro 00368
vínculo não existe
A combinação de lista de serviço, NBS, indicador de operação e classificação não é válida na tabela oficial. Quase sempre o NBS não corresponde ao serviço prestado — reveja o NBS. Se estiver certo, ajuste o cIndOp no Tipo de O.S.
Nota “autorizada” que não existe Foi emissão em homologação. Verifique o ambiente na Config. NFS-e; o correto é aparecer TESTE OK.
“Informe o técnico” ao iniciar serviço É proposital: sem técnico na linha não há responsável nem comissão. Informe na coluna Técnico da aba Serviços.
Recebimento não abre Caixa do operador fechado. Abra pelo próprio diálogo (F10).
Produto não aparece na aba Campo Serviço marcado errado no cadastro: serviço só entra na aba Serviços; peça, nas outras.
O.S não muda de situação Tipo criado do zero, sem status e transições. Use um modelo pronto como base.
Comissão não saiu Confira três coisas: pessoa marcada como técnico, percentual preenchido e técnico informado na linha do serviço.
Ao abrir chamado no suporte

Mande sempre: print da tela com o erro, número da O.S, o que estava sendo feito e, em caso de NFS-e, o município do cliente. Para erro de nota, o XML (F8) resolve na primeira resposta.