O JMDG Gestão centraliza a operação da oficina e do socorro automotivo em uma única interface. O sistema registra chamados, baixa peças do estoque, calcula valores, acompanha o caixa, gera relatórios, agenda compromissos, cria comprovantes em PDF, auxilia no contato via WhatsApp e possui integração opcional para NFS-e.
Importante sobre a versão atual
A documentação desta wiki foi preparada com base no código da versão 1.8.7. Nela, o botão + Nova peça abre sempre um formulário limpo; itens de estoque podem ser excluídos; e os modais de Nova peça, Editar item e Movimentar não fecham ao clicar fora ou apertar Esc.
Fluxo principal em uma frase
1Registrar atendimento
→
2Adicionar peças
→
3Salvar valores
→
4Financeiro automático
→
5Relatórios
Módulos disponíveis
Módulo
Função principal
Uso típico
Visão geral
Indicadores operacionais e financeiros
Acompanhar o mês e identificar alertas
Chamados
OS, cliente, veículo, serviço, peças e pagamento
Registrar e acompanhar atendimento
Agenda
Compromissos, retornos e atendimentos sincronizados
Organizar o dia e a semana
Estoque
Peças, preços, saldo, mínimo e histórico
Controle de inventário e custo
Financeiro
Faturamento, caixa, despesas e lucro
Fechamento financeiro
Relatórios
Análise por período, cliente, produto e serviço
Gestão e conferência
Usuários
Contas e perfis de acesso
Controle de permissões
Configurações
Empresa, WhatsApp, NFS-e, retenções e segurança
Administração técnica
Atualizações
Upgrade por ZIP e rollback
Manutenção da plataforma
Primeiros passos
Uma sequência segura para colocar a operação em funcionamento sem bagunçar estoque, financeiro ou permissões.
1
Confira os dados da empresa
Entre em Configurações e valide nome da empresa, CNPJ, inscrição municipal, telefone, WhatsApp, e-mail, site, endereço e cidade padrão.
2
Cadastre os usuários
Crie contas individuais. Evite compartilhar o mesmo login. Escolha o perfil de acordo com o trabalho de cada pessoa.
3
Cadastre as peças principais
No Estoque, informe SKU, nome, categoria, unidade, fornecedor, localização, estoque inicial, mínimo, custo e preço de venda.
4
Faça um atendimento de teste
Registre uma OS de teste com mão de obra, deslocamento e uma peça. Confira se o estoque baixa e se o Financeiro recebe os valores esperados.
5
Teste o PDF e o WhatsApp
Abra o chamado salvo, gere o comprovante e use as mensagens rápidas. Configure a chave Pix e o link de avaliação antes de usar cobrança e pós-venda.
6
Crie o primeiro backup
Antes de começar a trabalhar com dados reais, gere um backup local em Configurações.
Antes de ativar NFS-e em produção
Faça os testes em Homologação e valide com a contabilidade o item da lista de serviço, código tributário, alíquota, regime e tratamento das peças.
Checklist do primeiro dia
Rotina recomendada
Uma sugestão de uso diário para manter os dados da operação confiáveis.
Início do expediente
Abra o Dashboard e veja atendimentos em aberto, pagamentos pendentes, agenda futura e estoque baixo.
Confira a Agenda do dia e os compromissos sincronizados.
Abra o Estoque quando houver alertas críticos ou itens abaixo do mínimo.
Durante o dia
Registre cada atendimento concluído assim que possível.
Use peças pelo seletor do estoque; evite digitar manualmente no campo de observações quando a peça existe cadastrada.
Atualize chamados vindos do formulário público conforme o deslocamento e a execução avançarem.
Use anexos para fotos de painel, peça defeituosa, serviço e comprovantes.
Fechamento
Confirme se atendimentos pagos estão com Status = Finalizado e Pagamento = Pago.
Confira o Financeiro do mês e lance despesas que não vieram de chamados.
Use Relatórios para validar faturamento, custo em peças, recebimentos e lucro.
Crie um backup manual antes de mudanças importantes ou atualizações.
Atalhos e dicas de uso
Ctrl + KAbre a busca desta Wiki.
Busca dos ChamadosEncontra protocolo, cliente, CPF/CNPJ, e-mail, placa, veículo, telefone e endereço.
Ao vivoAs páginas principais atualizam automaticamente em segundo plano.
MobileA plataforma prioriza atalhos para Início, Chamados, Agenda e Menu.
Atualização automática
As páginas principais possuem sincronização automática, normalmente em ciclos de cerca de 20 segundos. A atualização é pausada quando você está digitando ou quando um modal está aberto, reduzindo o risco de perder o que está sendo preenchido.
Dica para o celular
No uso mobile, prefira a visualização Agenda dentro do calendário. Para um novo atendimento, o botão rápido “+” permite chegar ao cadastro com menos toques.
Evite abas antigas esquecidas
Se várias pessoas trabalham simultaneamente, feche telas antigas que não estão mais sendo usadas. Isso reduz confusão visual e facilita enxergar a versão mais recente dos dados.
Dashboard / Visão geral
O painel principal combina operação, financeiro, agenda e estoque no mesmo lugar.
Filtro por mês
Use o seletor de mês para revisar um período anterior ou voltar ao mês atual. Os cartões se recalculam com base no período escolhido.
Indicadores principais
Atendimentos do mêsQuantidade + finalizados + pagos
Valor recebidoChamados pagos + receitas manuais
Lucro líquidoRecebido − custo das peças − despesas
Faturamento brutoMão de obra + peças + deslocamento
Custo em peçasCusto real das peças utilizadas
Estoque baixoItens no mínimo ou abaixo dele
O que mais aparece no painel
Ticket médio do período.
Chamados em aberto e pagamentos pendentes.
Agenda futura e compromissos próximos.
Produtos/peças vendidos, descontos e receitas/despesas manuais.
Serviços mais solicitados, principais clientes e produtos mais usados.
Atendimentos recentes e valores a receber.
Como usar para gestão
Se o faturamento estiver alto, mas o lucro baixo, compare custo em peças, descontos e despesas. O Dashboard separa esses componentes para mostrar onde a margem está sendo consumida.
Chamados e Ordens de Serviço
É o centro da operação. Cada chamado concentra cliente, veículo, serviço, localização, peças, valores, pagamento, anexos, WhatsApp e histórico.
Registrar um atendimento concluído
O botão + Novo chamado foi pensado como registro rápido de um serviço já executado. Novos registros criados internamente entram automaticamente como Finalizado e Pago. Depois, você pode abrir o chamado e corrigir informações se necessário.
A tela completa libera diagnóstico, serviços realizados, origem, cidade, quilometragem, responsável, valores, forma de pagamento, anexos, histórico, NFS-e, mensagens de WhatsApp e produtos usados.
Status do atendimento
Novo→A caminho→No local→Em atendimento→Aguardando peça→FinalizadoCancelado pode ser usado quando o atendimento não deve seguir.
Status de pagamento
Pendente, Parcial ou Pago. As formas disponíveis são Pix, Dinheiro, Cartão débito, Cartão crédito, Transferência e Outro.
Cálculo do atendimento
Valor final = Mão de obra + Produtos/Peças + Deslocamento − Desconto
O campo de produtos é calculado pelo estoque. O lucro direto do atendimento considera o valor final menos o custo real das peças utilizadas.
Peças no chamado
Ao usar + Usar peça do estoque, a quantidade é retirada imediatamente do saldo e o preço de venda é somado ao atendimento. O preço pode ser ajustado para aquela OS. Use Estornar para remover a peça do chamado e devolvê-la ao estoque.
Exclusão de chamado
Administrador e Gestor podem excluir definitivamente um chamado. As peças vinculadas são devolvidas ao estoque e o atendimento deixa de participar dos cálculos financeiros.
NFS-e já autorizada
Quando existe NFS-e de produção autorizada, o sistema bloqueia alterações em dados usados no documento fiscal para evitar divergência entre a OS e a nota.
Formulário público de solicitação
O arquivo public/request.php permite que um cliente abra uma solicitação sem entrar no painel administrativo.
O que o cliente informa
Nome e telefone/WhatsApp.
Placa e veículo.
Tipo de socorro.
Bairro e endereço/localização.
Descrição do problema.
Como a solicitação entra no sistema
SiteCliente envia
→
NovoStatus
→
UrgentePrioridade
→
PendentePagamento
A origem é marcada como Site. Depois do envio, o cliente recebe um protocolo e pode ser direcionado ao WhatsApp da JMDG.
Diferença para o cadastro interno
O cadastro manual pelo painel representa um serviço já realizado e nasce Finalizado + Pago. O formulário público representa uma solicitação nova e entra Novo + Pendente.
Agenda operacional
Calendário para compromissos, retornos, orçamentos, cobranças e chamados sincronizados.
Visualizações
Você pode alternar entre Mês, Semana e Agenda. No celular, a visualização em lista é a mais compacta.
Tipos de compromisso
Atendimento, Socorro agendado, Retorno, Orçamento, Cobrança, Lembrete e Outro.
Status
Agendado, Confirmado, Em andamento, Concluído e Cancelado.
Criar um compromisso
Clique em + Novo compromisso ou em um dia do calendário.
Preencha título, tipo, status, início e, se necessário, término.
Adicione endereço e observações.
Salve.
Sincronizar calendário
O sistema gera um link privado de assinatura. Ele pode ser usado no iPhone/iCloud, Google Calendar/Android e Outlook. Também existe download manual em formato .ICS.
O link da agenda é privado
Quem tiver esse endereço consegue visualizar os compromissos. Não publique o link. Os calendários externos recebem a agenda em modo somente leitura.
Google Calendar
A assinatura por URL precisa ser adicionada pelo navegador no computador: Outros calendários → Do URL. Depois ela aparece no aplicativo da mesma conta.
iPhone / iCloud
Use o link webcal:// disponibilizado na janela de sincronização e escolha a conta desejada quando solicitado.
Outlook
Use Adicionar calendário → Assinar da Web e informe o link privado.
Estoque
Controle de peças e produtos integrado aos atendimentos e ao cálculo de lucro.
Cadastro de peça / produto
Código / SKU
Nome
Categoria
Unidade
Fornecedor
Localização
Estoque inicial
Estoque mínimo
Preço de custo
Preço de venda
Observações
Ativo / inativo
Comportamento da versão 1.8.7
+ Nova peça sempre abre um cadastro vazio, inclusive depois de editar outro item. Os modais de Nova peça, Editar item e Movimentar só fecham pelo X; clicar fora ou apertar Esc não descarta o formulário.
Alertas
A página exibe quantidade de itens ativos, valor total armazenado em custo, itens com estoque baixo e itens zerados. Os cartões de alerta funcionam como filtros.
Movimentação manual
Tipo
O que informar
Efeito
Entrada
Quantidade recebida
Soma ao saldo atual
Saída
Quantidade retirada
Subtrai do saldo; não permite saldo negativo
Ajuste
Novo saldo correto
Substitui o saldo pelo valor informado
Histórico
Cada movimentação registra data, item, tipo, quantidade, OS relacionada, responsável e observação. Saídas feitas por uma OS e estornos também aparecem.
Excluir item
Se o item nunca foi usado em chamados, ele pode ser apagado permanentemente junto com o histórico manual próprio. Se já estiver ligado a um chamado, ele é removido do estoque operacional e fica inativo, preservando o histórico necessário.
Integração com OS
Quando uma peça é usada num chamado, o sistema salva quantidade, custo unitário, preço de venda e total. Isso permite calcular a margem real mesmo que o preço do cadastro seja alterado futuramente.
Boa prática
Use códigos/SKUs padronizados e preencha localização física como “Prateleira A2”. Isso acelera a busca e reduz erro na retirada.
WhatsApp e comprovante PDF
Depois que um chamado é salvo, a plataforma monta mensagens prontas com os dados do atendimento.
Mensagens rápidas disponíveis
Comprovante PDF.
Resumo do atendimento.
Localização registrada.
Cobrança com valor e chave Pix.
Agradecimento e pedido de avaliação.
PDF do atendimento
O comprovante reúne cliente, veículo, peças, valores e pagamento. O link pode ser aberto no navegador e compartilhado no WhatsApp.
PDF de atendimento não é nota fiscal
O comprovante da OS não substitui NF-e ou NFS-e oficial. A emissão fiscal válida é tratada pelo módulo de NFS-e quando a integração estiver configurada.
O que configurar antes
Em Configurações, informe o WhatsApp da empresa, chave Pix e o link de avaliação do Google. Esses dados alimentam as mensagens automáticas.
Financeiro
O módulo separa faturamento gerado, caixa recebido, custo de peças e lançamentos manuais.
Faturamento dos chamados
É a soma de mão de obra + produtos/peças + deslocamento, antes dos descontos.
Valor final dos chamados
É o faturamento bruto menos os descontos concedidos.
Lucro previsto
Lucro previsto = Valor final dos chamados − Custo das peças
É um indicador do resultado direto dos atendimentos; ainda não desconta outras despesas gerais da empresa.
Caixa realizado
Considera atendimentos Finalizados + Pagos, soma outras receitas manuais pagas e desconta custo das peças desses atendimentos e outras despesas pagas.
Lucro líquido realizado = Recebido + Outras receitas − Custo das peças pagas − Outras despesas
Lançamentos manuais
Use + Lançamento para receitas ou despesas que não vêm de uma OS, como combustível, aluguel, ferramenta ou outras entradas.
Campos
Tipo, categoria, descrição, valor, forma de pagamento, status (Pendente/Pago), vencimento e observações.
Não duplique faturamento
Valores dos chamados já entram automaticamente no Financeiro. Não crie uma receita manual para o mesmo atendimento, senão o caixa ficará duplicado.
Relatórios 360º
Visão detalhada da operação e do resultado financeiro com filtros por período.
Filtros disponíveis
Data inicial e final.
Busca por cliente, telefone, documento, e-mail, placa, veículo, protocolo, endereço, bairro, problema, produto ou SKU.
Tipo de serviço.
Status do chamado.
Status do pagamento.
Produto específico.
Indicadores
Atendimentos encontrados, finalizados/cancelados, faturamento bruto, mão de obra, produtos vendidos, deslocamento, custo em peças, lucro e ticket médio.
Análises disponíveis
Atendimentos detalhadosValores, custo, desconto, lucro e pagamento por OS.
ClientesQuantidade de atendimentos, veículos, faturamento, custo e lucro.
ProdutosQuantidade utilizada, venda, custo, margem e estoque atual.
ServiçosDesempenho por tipo de serviço.
Movimento por diaResumo diário de mão de obra, peças, deslocamento, valor final e lucro.
Financeiro manualReceitas e despesas do período.
Exportar
Use Imprimir para uma versão em papel/PDF pelo navegador ou Exportar CSV para abrir os dados no Excel/LibreOffice. O arquivo CSV usa separador “;” e inclui produtos usados por atendimento.
Usuários e permissões
Cada pessoa deve utilizar sua própria conta. O perfil define quais módulos ficam disponíveis.
Não acessa Usuários, Configurações nem Atualizações
Atendimento
Dashboard, Chamados, Agenda, Relatórios, Estoque
Sem Financeiro e áreas administrativas
Técnico
Dashboard, Chamados, Agenda, Estoque
Sem Financeiro, Relatórios e administração
Financeiro
Dashboard, Financeiro, Relatórios
Sem Chamados operacionais e administração
Gestor x Administrador
Dentro dos módulos de negócio, o Gestor possui poderes operacionais equivalentes ao Administrador, inclusive editar/excluir chamados e gerenciar o estoque. A separação existe para proteger Usuários, Configurações e Atualizações.
Gerenciar contas
O Administrador pode pesquisar, filtrar, criar, editar, redefinir senha, trocar perfil, ativar/inativar e excluir usuários.
Proteções contra acidente
O usuário conectado não pode excluir a própria conta. O sistema também impede a exclusão/inativação acidental do último administrador ativo.
NFS-e
A emissão/consulta de NFS-e pode ser feita pelos perfis Administrador, Gestor e Financeiro, desde que a integração esteja habilitada.
Solução de problemas
+ Nova peça não abre
Confirme se a instalação está realmente na versão 1.8.7 e atualize a página com Ctrl + F5. A 1.8.7 moveu a abertura desse formulário para o JavaScript principal para funcionar também após navegação dinâmica.
Ao clicar em Nova peça aparecem dados do item anterior
Esse comportamento foi corrigido nas versões 1.8.5/1.8.7. O cadastro novo deve abrir vazio. Se ocorrer, limpe o cache do navegador e verifique se assets/app.js foi atualizado junto com os arquivos PHP.
O modal de estoque abre sozinho
A correção 1.8.6 remove os parâmetros de edição/movimentação da URL assim que o modal abre. Se ele reabrir após atualização automática, confira se todos os arquivos da versão foram aplicados e limpe o cache.
Não consigo excluir uma peça
Usuários permitidos para gerenciar estoque são Administrador, Gestor e Atendimento. Se a peça já foi usada em OS, ela não é destruída: fica inativa para preservar histórico.
O Financeiro parece duplicado
Não crie receita manual para um atendimento que já existe como chamado. As OS alimentam o Financeiro automaticamente.
O valor recebido não bate com o faturamento bruto
Faturamento bruto é o valor gerado antes de descontos. Valor recebido considera apenas caixa efetivamente pago, após descontos, somado a outras receitas pagas.
Agenda não atualiza imediatamente no Google/Outlook
Calendários externos decidem o intervalo de atualização da assinatura. A JMDG publica o feed, mas o provedor pode levar algum tempo para buscar a versão nova.
NFS-e não emite
Verifique se a integração está habilitada, o atendimento está Finalizado, o token é válido e os dados fiscais obrigatórios foram preenchidos. Faça testes em Homologação.
Atualização falhou
O atualizador registra o evento e tenta rollback automático. No painel, confira Histórico e, se necessário, use Restaurar último backup.
Erro ao salvar chamado
Consulte storage/logs/errors.log. As versões atuais também tentam reparar automaticamente diferenças antigas de schema e retornam uma mensagem mais legível no formulário.
Boas práticas
Uma conta por pessoaMelhora auditoria e evita ações sem identificação.
SKU consistentePadronize códigos de peças para reduzir duplicidade.
Custo real atualizadoPreço de custo correto deixa a margem e o lucro confiáveis.
Use estoque na OSEvite lançar peças só como texto quando elas existem cadastradas.
Feche pagamento corretamenteFinalizado + Pago é essencial para o caixa realizado.
Backup externoMantenha ao menos uma cópia fora do servidor principal.
Padrão recomendado de cadastro de peça
SKU: BAT-60A-MOURA Nome: Bateria 60Ah Moura Categoria: Bateria Unidade: un Localização: Prateleira B1 Estoque mínimo: 2 Custo: valor pago pela JMDG Venda: valor cobrado do cliente
Padrão recomendado para diagnóstico
Escreva o problema detectado de forma objetiva e separada do que foi efetivamente executado. Isso melhora histórico, PDF e conferência futura.
Glossário
OS / Chamado
Registro completo de um atendimento.
SKU
Código interno usado para identificar uma peça ou produto.
Faturamento bruto
Mão de obra + venda de produtos + deslocamento, antes dos descontos.
Valor final
Faturamento bruto menos desconto.
Custo das peças
Quanto a JMDG efetivamente pagou pelos produtos utilizados.
Lucro previsto
Valor final do atendimento menos custo das peças.
Caixa realizado
Valores que efetivamente foram pagos, acrescidos de outras receitas e descontados custos/despesas.
Ticket médio
Valor médio dos atendimentos considerados no período.
Estorno
Remoção de uma peça de uma OS com devolução ao estoque.
Homologação
Ambiente de teste da integração fiscal.
Rollback
Restauração da versão anterior da plataforma após uma atualização.
Mudanças recentes
1.8.7
Correção do botão Nova peça
O cadastro abre corretamente mesmo quando a tela Estoque foi carregada pela navegação dinâmica. A abertura foi centralizada no JavaScript principal.
1.8.6
Correção de abertura automática do estoque
Editar/Movimentar deixa de reabrir sozinho após atualização automática; parâmetros temporários são removidos da URL.
1.8.5
Revisão de estoque e proteção dos formulários
Nova peça limpa, exclusão de itens, preservação de histórico e modais que só fecham pelo X.
1.8.4
Gestor com controle operacional completo
Gestor passa a ter as mesmas permissões do Administrador nos módulos de negócio, sem acesso às áreas administrativas sensíveis.
1.4.1
Produtos já na abertura do chamado
Busca e inclusão de várias peças no cadastro rápido com baixa automática do estoque.
1.3.x
Sincronização e estabilidade
Atualização automática, navegação dinâmica, melhorias mobile e correções de gravação/SQLite.
1.2.x
Agenda e chamados simplificados
Agenda completa e dados de cliente/veículo incorporados diretamente ao chamado.