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.
- Faça backup da base do cliente. Regra de ouro antes de qualquer atualização.
Um
gbakou cópia doDADOS.FDBcom o Firebird parado. - 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.
- 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.
- 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.
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ção | Para que serve na prática |
|---|---|
| Objeto do serviço | Nenhum, Equipamento, Veículo ou Imóvel. Define quais campos do objeto aparecem (série, marca, modelo; placa, km, ano). |
| Rótulos | Troca as palavras na tela: “Problema” pode virar “Reclamação do cliente”, “Laudo” virar “Diagnóstico”, “Objeto” virar “Veículo”. |
| Movimenta estoque | Ao concluir a O.S, baixa do estoque as peças lançadas. Deixe ligado em quem vende peça. |
| Fatura NF-e / Fatura NFS-e | Libera os botões de faturamento. Um cliente que só presta serviço pode desligar a NF-e, e vice-versa. |
| Nasce como orçamento | A O.S começa em ORÇAMENTO e só vira serviço depois de aprovada. Com validade em dias. |
| cIndOp | Só 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.
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.
- 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.
- 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.
| Campo | Serviço | Peça / material |
|---|---|---|
| Serviço (S/N) | Sim | Não |
| Código LC 116 | Obrigatório (ex.: 01.01) | — |
| Alíquota ISS | A do município do cliente | — |
| NCM / NBS | NBS — obrigatório com a reforma | NCM |
| CFOP, CST/CSOSN | — | Como qualquer produto |
| Garantia (dias) | Opcional; puxa automático para a O.S | |
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.
| Campo | O que preencher |
|---|---|
| Empresa / Município | Só confirmação — vem do cadastro da empresa. |
| Provedor | Deixe em AUTOMÁTICO. Só troque se o suporte orientar. |
| Usuário / Senha | Credenciais 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érie | Série do RPS. Normalmente 1. |
| Ambiente | Homologação para testar, Produção para valer. Ver o aviso abaixo. |
| cIndOp | Padrã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.
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
- 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.
- 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.
- 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 cliente | O que configurar no cIndOp |
|---|---|
| Assistência técnica, conserto na bancada | Automático (resolve para 050101) |
| Atendimento no endereço do cliente | No Tipo de O.S: 050102 |
| Software, consultoria, serviço remoto | Automático (resolve para 100301) |
| Serviço sobre imóvel | No Tipo de O.S: 020201 |
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.
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.
- 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.
- 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.
- 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).
- Problema e laudo. O que o cliente relatou e, depois, o diagnóstico do técnico.
- 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.
- Abas de baixo. Checklist de entrada, campos extras do ramo, anexos (fotos do aparelho ao receber — evita discussão na entrega) e observações.
- 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
| Tecla | Ação |
|---|---|
| F2 | Gravar |
| F3 | Finalizar / concluir a O.S (ou aprovar, quando é orçamento) |
| F4 | Consultar produtos |
| F5 | Consultar/cadastrar pessoas |
| F6 / F7 | Inicia / conclui o serviço daquela linha |
| F8 | Faturar NF-e das peças e materiais |
| F9 | Receber (abre o recebimento) |
| F11 | Campo de código de barras |
| Ctrl+W | Enviar 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.
- 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”.
- Apontar horas (opcional). Na aba Técnicos, registra-se início e fim; as horas trabalhadas saem no formato hh:mm.
- Checklist de saída e fotos. Marque o checklist e anexe fotos do aparelho pronto.
- 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.
- Avisar o cliente. Ctrl+W com o modelo de conclusão (“está pronta para retirada”).
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.
- Com a O.S concluída, tecle F8 (ou F9 · Faturar na lista).
- 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.
- 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.
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.
- 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.
- 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.
- 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.
| Tecla | Na tela de NFS-e Emitidas |
|---|---|
| F4 | Cancelar a NFS-e (pede justificativa; respeita o prazo do município) |
| F5 | Atualizar a lista |
| F6 | Consultar na prefeitura e atualizar a situação |
| F7 | Abrir o link público da nota |
| F8 | Ver o XML |
| F9 | DANFSE em PDF (A4) |
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.
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.
- Monte a O.S modelo normalmente e anote o número dela.
- 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.
- 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.
Erros mais comuns e o que fazer
| Sintoma | Causa 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. |
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.