MhSys OS

Manual Oficial de Operações & Gestão do ERP

Guia Completo de Navegação, Cadastros Globais, Vendas, Frente de Caixa (PDV), E-commerce & Delivery, Estoque, Produção Industrial (PCP/BOM), Financeiro, Vales & Créditos Fracionáveis & DRE, Fiscal (NF-e/NFC-e/NFS-e com Código IBGE Oficial, Central do Contador, Pré-Validador PVA, SPED Fiscal EFD ICMS/IPI e Pacote Mensal .zip), Contratos, Recursos Humanos (REP-P Portaria 671), Central de Ajuda & Inteligência Artificial Mhax.

Versão do Sistema: MhSys OS 2026.4 • Ambiente: Enterprise Cloud Multiempresa • Documento: Caderno Técnico & Operacional

MHSYS TECNOLOGIA & GESTÃO SAAS LTDA

Ecossistema ERP Enterprise • Todos os Direitos Reservados

Uso Exclusivo de Clientes e Usuários Autorizados
Manual Oficial ERP
Manual Gestão Pública

Visão Geral & Cockpit Executivo

Centro de comando unificado, telemetria em tempo real e indicadores operacionais do MhSys OS.

Caminho de Acesso: Menu Superior > Dashboard (Rota: /dashboard) ou Menu Principal > B.I. > Hub BI (Rota: /bi/dynamic)

O MhSys Enterprise OS foi projetado para transformar dados transacionais em decisões estratégicas imediatas. O Cockpit Executivo consolida os principais indicadores de desempenho (KPIs) operacionais, comerciais e financeiros em uma única tela de comando responsiva, alimentada por webhooks e telemetria contínua.

💡 Dica de Produtividade: Personalização de Cards Personalize os cartões de metas do Cockpit de acordo com o seu perfil de usuário. Gerentes de Vendas podem priorizar a velocidade de conversão do funil comercial, enquanto Diretores Financeiros podem visualizar previsões de liquidez de fluxo de caixa projetadas para 30, 60 e 90 dias.

Principais Cards de Telemetria Operacional

Indicador (KPI) Origem dos Dados Atualização Ação Recomendada
Faturamento em Aberto Contas a Receber (Vendas faturadas aguardando quitação bancária) Tempo Real Auditar conciliação de boletos híbridos e Pix cobrança
Gargalos de Estoque Itens em Ponto de Pedido (Estoque Atual ≤ Mínimo de Segurança) Imediata na Baixa Disparar cotação automática para fornecedores qualificados
Ordens de Produção (OP) Chão de fábrica, Kanban industrial e apontamentos de operadores Tempo Real Remanejar operadores ou turnos em caso de desvio no lead-time
Ticket Médio de Vendas Frente de Caixa (PDV), E-commerce Integrado e Força de Vendas Diária consolidada Ajustar campanhas promocionais, kits e combos de produtos

Estrutura de Navegação, Menus & Grades de Dados

Arquitetura de menus, personalizador de colunas por usuário e ações em massa com Bulk Floating Bar.

Caminho de Acesso: Grades de Listagem > Barra de Ferramentas Superior > Botão "Colunas" (disponível em todas as telas de dados, ex.: Menu Principal > Vendas > Vendas > Pedidos de Venda — /vendas/pedidos)

A interface do MhSys OS adota princípios de ergonomia visual corporativa. A barra lateral pode ser colapsada para maximizar a área de trabalho, e todas as grades de dados do sistema (Pedidos de Venda, Clientes, Produtos, Contas a Pagar e Receber) contam com controles dinâmicos de personalização individual por usuário.

Personalizador de Colunas da Grade (Grid Preferences)

Cada operador pode configurar quais colunas deseja visualizar na sua tela de trabalho através do botão Colunas (localizado no topo direito de cada listagem). As preferências são salvas de forma isolada por usuário, não afetando os demais colaboradores da organização:

1
Acesse o Botão "Colunas" Clique no botão Colunas na barra de ferramentas superior da grade (ex.: em /vendas/pedidos).
2
Selecione as Colunas Desejadas Marque ou desmarque as colunas opcionais (ex.: Vendedor, Canal de Origem, Previsão de Entrega, OP Vinculada). Colunas essenciais (como ID, Cliente, Status e Ações) são travadas por segurança para manter a integridade da navegação.
3
Salve as Preferências ou Restaure o Padrão Clique em Salvar Preferências. O sistema memoriza o layout instantaneamente no banco de dados. Caso deseje voltar à configuração recomendada de fábrica, utilize o botão Restaurar Padrão.

Barra Flutuante de Ações em Massa (Bulk Floating Bar)

Ao marcar um ou mais checkboxes na primeira coluna de qualquer tabela de dados, uma barra flutuante é projetada no rodapé da tela exibindo o total de itens selecionados e os comandos disponíveis em lote (como Alterar Status, Exportar Selecionados, Disparar Notificações ou Excluir em Massa). A barra possui um botão explícito de cancelamento [X] que desmarca todos os registros e recolhe o painel imediatamente.

💡 Dica de Produtividade: Seleção Rápida Clique no checkbox do cabeçalho da tabela para selecionar todos os registros visíveis da página corrente de uma só vez, ativando instantaneamente as operações em massa.

Comercial, CRM, Propostas & Pedidos de Venda

Funil de oportunidades, emissão de propostas com rastreamento WhatsApp e automação de Ordens de Produção (OP).

Caminho de Acesso: Menu Principal > Vendas > Vendas > Pedidos de Venda (Rota: /vendas/pedidos)

O módulo Comercial integra todo o ciclo de atração de leads, qualificação de clientes (B2B e B2C), emissão de orçamentos e conversão em pedidos de venda faturáveis. Conta com validação fiscal automática de clientes por CNPJ (Receita Federal) e busca de CEP (ViaCEP) com preenchimento transparente do Código IBGE de 7 dígitos.

Passo a Passo: Emissão de Pedido de Venda com Geração de OP Inteligente

1
Crie o Pedido e Vincule o Cliente Em Menu Principal > Vendas > Vendas > Pedidos de Venda (/vendas/pedidos), clique em + Novo Pedido. (Clientes e parceiros podem ser gerenciados previamente em Menu Principal > Cadastros > Pessoas > Clientes — /cadastros/clientes). Selecione o cliente cadastrado ou digite o CNPJ/CPF para autopreenchimento imediato de dados cadastrais e fiscais.
2
Lance os Produtos (Fabricação Própria vs. Revenda Pura) Adicione os itens ao pedido. O motor do MhSys analisa dinamicamente a ficha técnica (BOM - Bill of Materials) de cada produto adicionado. Itens que possuem matéria-prima/composição configurada são marcados automaticamente como produtos industriais elegíveis a fabricação.
3
Geração Cirúrgica de Ordem de Produção (OP) Ao clicar no botão Gerar OP na listagem de pedidos:
  • Pedido Misto (Revenda + Fabricação): O sistema gera a OP exclusivamente para os itens de fabricação própria, ignorando produtos simples de revenda;
  • Pedido 100% Revenda: O sistema mantém o botão desabilitado e bloqueia qualquer tentativa de abertura indevida de OP;
  • Idempotência: Caso a OP já tenha sido gerada, o sistema impede duplicações e abre o modal de consulta com o status em tempo real do chão de fábrica.
4
Faturamento e Emissão Fiscal Transparente Com a produção concluída (ou para itens pronta-entrega), clique em + Gerar NF-e. O sistema puxa automaticamente os tributos da UF de destino e o código IBGE oficial do município do cliente, sem necessidade de digitação manual de códigos SEFAZ.
⚠️ Ponto de Atenção: Pedidos Cancelados Pedidos com status Cancelado têm qualquer geração de OP ou faturamento fiscal permanentemente bloqueada por travas de domínio.

Frente de Caixa (PDV) & Emissão NFC-e

Operação ágil de checkout, suporte a periféricos seriais, Pix dinâmico e contingência offline NFC-e.

Caminho de Acesso: Menu Principal > Vendas > Vendas > Frente de Caixa (PDV) (Rota: /vendas/pdv)

O PDV MhSys é otimizado para alta velocidade em balcões comerciais. Suporta leitor de código de barras USB/Bluetooth, balanças seriais (protocolo Toledo e Filizola com pesagem automática), gaveta de dinheiro elétrica e impressoras térmicas ESC/POS (58mm e 80mm).

Atalhos Operacionais de Teclado no Caixa

Tecla de Atalho Função no Caixa Descrição & Comportamento
F2 Consulta Rápida de Estoque Abre a busca textual por nome de produto, SKU, saldo disponível e prateleira
F4 Finalizar Venda / Pagamento Abre a tela de formas de pagamento (Pix Dinâmico, Cartão Débito/Crédito, Dinheiro, Prazo)
F7 Sangria / Suprimento Registra retiradas de valores do caixa ou entrada de troco com justificativa obrigatória
F9 Cancelar Item Lançado Permite o estorno do último item lançado mediante senha de supervisor autorizado
F12 Fechamento de Caixa Emite o relatório Z de conferência cega e apuração de divergências de quebra de caixa

E-commerce, Catálogo Online & Delivery

Loja virtual nativa integrada ao ERP, catálogo flipbook folheável e rotas de entrega local.

Caminho de Acesso: Menu Principal > Vendas > Marketing > Central E-commerce (Rota: /comercial/ecommerce) & Configuração Landing Page (Rota: /configuracoes/landing-page)

Com o motor MhSys E-commerce Builder, cada empresa usuária dispõe de uma loja virtual nativa integrada diretamente com a retaguarda do ERP, sincronizando estoques, variações de grade (tamanho/cor), cupons promocionais e opções de frete (Correios, Melhor Envio e taxas fixas de entrega local).

💡 Dica de Produtividade: Catálogo Flipbook Interativo Gere catálogos digitais folheáveis em formato de revista digital com botões diretos de "Comprar pelo WhatsApp". O cliente navega visualmente pelos produtos e envia o carrinho montado diretamente para o operador do comercial.

Central de Trocas, Devoluções & SAC de Logística Reversa

Gestão completa de pós-venda, logística reversa com etiquetas automáticas, vistoria técnica, emissão de NF-e de devolução (Modelo 55) e compensação financeira.

Caminho de Acesso: Menu Principal > Vendas > Trocas & Devoluções (Rota direta: /comercial/devolucoes) & Área do Cliente no E-commerce (Rota: /conta/pedidos)

A Central de Trocas, Devoluções & SAC do MhSys OS unifica a jornada de pós-venda em uma esteira operacional auditável, garantindo conformidade irrestrita com o Art. 49 do Código de Defesa do Consumidor (Direito de Arrependimento em 7 dias), gestão de garantias por avaria/defeito e automação fiscal plena com a SEFAZ. O módulo conecta clientes finais, operadores de SAC, equipe de expedição/estoque e controladoria contábil.

Total
Visão Geral
Chamados registrados
🟡 Triagem
Novos / Análise
Aguardando parecer inicial
📦 Postagem
Aguardando Envio
Etiqueta/código liberado
🚚 Transporte
Em Trânsito
Retornando ao CD/Estoque
🔬 Vistoria
Conferência
Laudo físico dos itens
✅ Concluídos
Encerrados
Estorno / Cupom / Troca
Artigo 6.1

Canais de Abertura: Autoatendimento B2C & Abertura Manual pelo SAC

O sistema prevê dois pontos de entrada totalmente sincronizados para registro de trocas e devoluções, assegurando velocidade operacional e validação imediata de elegibilidade:

Autoatendimento B2C Área do Cliente no E-commerce

O próprio comprador inicia o processo em Minha Conta > Pedidos > Solicitar Devolução (/conta/pedidos/{uuid}/devolver).

  • Seleção Granular de Itens: O cliente escolhe quais produtos deseja devolver e informa a quantidade exata.
  • Motivo do Chamado: Categorização padronizada (Arrependimento CDC 7D, Defeito/Avaria, Tamanho Incompatível ou Produto Divergente).
  • Upload de Fotos/Evidências: Envio de fotos da embalagem e do produto, processadas com conversão inteligente WebP e governança de armazenamento.
  • Preferência de Resolução: Indicação da forma preferida de compensação (Estorno ou Cupom/Vale-Compras).
Atendimento Backoffice Abertura Manual pelo Operador do SAC

Pelo botão + Nova Devolução / Troca no topo da tela /comercial/devolucoes, o atendente abre chamados recebidos via WhatsApp, balcão ou telefone.

  • Busca com Autocomplete & Debounce: Pesquisa dinâmica de pedidos digitando o número (#1234), nome do cliente ou CPF/CNPJ.
  • Trava de Saldo Elegível: O sistema calcula a quantidade faturada original deduzindo solicitações anteriores ativas, impedindo devoluções duplicadas.
  • Subtotais em Tempo Real: Ao marcar itens e ajustar quantidades, o valor de reembolso é recalculado na hora.
Artigo 6.2

Logística Reversa & Emissão de Etiquetas de Postagem

A etapa de transporte reverso viabiliza a remessa do produto da casa do cliente até o centro de distribuição da sua empresa com rastreabilidade total:

1
Emissão Automática via Gateway Integrado (1 Clique)
Através da integração nativa com os gateways de frete homologados (Melhor Envio, Correios CWS, Jadlog Reverse, Frenet), o operador clica no botão Gerar Etiqueta na aba Postagem Reversa. O sistema aciona a API do parceiro logístico, gera a autorização de postagem reversa, armazena o código de rastreamento e disponibiliza o PDF da etiqueta com código de barras.
2
Autorização Manual de Postagem (e-Ticket Correios ou Coleta)
Caso sua empresa opere com contrato próprio de frete faturado, transportadora dedicada ou agendamento de coleta no local, o atendente insere o código de rastreio/autorização, define a data de validade para postagem e informa instruções personalizadas de acondicionamento ao cliente.
3
Pré-visualização e Impressão de Etiqueta (Térmica / A4)
O botão Imprimir Etiqueta Reversa abre a rota dedicada /comercial/devolucoes/etiqueta-preview?protocolo=DEV-..., renderizando o espelho oficial pronto para impressoras térmicas (100x150mm) ou folhas comuns A4 com instruções destacáveis de postagem para o consumidor.
Artigo 6.3

Canal de SAC & Linha do Tempo Auditável (Timeline)

Na aba Linha do Tempo & SAC do modal de gestão, todo o histórico do ticket fica registrado cronologicamente, garantindo transparência jurídica e continuidade de atendimento:

Trilha de Eventos Automatizados

Cada avanço do chamado gera um registro imutável com data, hora e usuário responsável:

  • Abertura da solicitação e anexação de fotos;
  • Aprovação do chamado e liberação de código de postagem;
  • Mudança de status para Em Trânsito e confirmação de entrega no CD;
  • Transmissão da NF-e de devolução autorizada pela SEFAZ;
  • Conclusão do reembolso ou geração de cupom de desconto.
Chat de Atendimento Bidirecional

O operador envia mensagens de esclarecimento diretamente pelo painel. O cliente recebe notificação e responde pela própria central de acompanhamento no e-commerce, mantendo todas as mensagens concentradas no chamado sem depender de conversas dispersas em e-mails ou aplicativos pessoais.

Artigo 6.4

Emissão de Nota Fiscal de Devolução (NF-e Entrada — Modelo 55)

Disponível em: Modal da Devolução > Aba Vistoria & Conclusão > Card Nota Fiscal de Devolução & Rota direta: /vendas/nfe

A NF-e de Devolução é o documento fiscal oficial que ampara legalmente o ingresso físico das mercadorias devolvidas no estoque da sua empresa, anulando os efeitos tributários e comerciais da nota de venda original. O motor fiscal do MhSys OS automatiza essa emissão seguindo rigorosamente o Manual de Orientação do Contribuinte (MOC SEFAZ 4.00):

Requisito Fiscal SEFAZ Como o MhSys OS Processa Impacto Prático na Sua Operação
Finalidade da Emissão
finNFe = 4
Configura o XML com finalidade oficial de devolução de mercadoria e tipo de documento como Entrada (tpNF = 0). Evita faturamento indevido e indica à SEFAZ que se trata do retorno de mercadoria previamente vendida.
Chave Referenciada
<NFref><refNFe>
O backend localiza automaticamente a NF-e de venda emitida para o pedido e preenche a chave de 44 dígitos. Permite também digitação manual com validação de dígito verificador Módulo 11. Atende à regra de validação obrigatória da SEFAZ (Rejeição 267), vinculando a nota de entrada exatamente à nota de saída original.
Inversão Inteligente de CFOPs
1.202 / 2.202 / 1.411
Converte automaticamente os CFOPs de saída para seus respectivos espelhos de entrada conforme a UF do destinatário e o regime tributário. Elimina erros de digitação contábil e divergências nas escriturações do SPED Fiscal e EFD-Contribuições.
Proporcionalidade Tributária
ICMS / PIS / COFINS / IPI
Recalcula as bases de cálculo e alíquotas proporcionalmente aos itens e quantidades devolvidas no chamado. Garante a recuperação exata dos créditos tributários para empresas do Lucro Real e Lucro Presumido, ou estorno de faturamento no Simples Nacional.

Matriz de Inversão Automática de CFOPs de Devolução

Natureza da Venda Original CFOP Venda (Saída) CFOP Devolução (Entrada no Estado) CFOP Devolução (Entrada Interestadual)
Venda de Produção Própria 5.101 / 6.101 1.201 2.201
Venda de Mercadoria Adquirida de Terceiros 5.102 / 6.102 1.202 2.202
Venda com Substituição Tributária (ICMS-ST) 5.405 / 6.403 1.411 2.411
1
Geração da Pré-Nota & Espelho DANFE de Conferência
Ao clicar em Gerar Pré-Nota / Espelho DANFE, o sistema calcula previamente o rascunho da NF-e e exibe um resumo com totais, chave referenciada e tributos para conferência visual do operador antes de qualquer envio.
2
Transmissão Direta com Certificado Digital A1
Com os dados conferidos, o clique em Transmitir NF-e de Devolução assina digitalmente o documento com o Certificado Digital da empresa (padrão ICP-Brasil A1) e transmite o lote à SEFAZ em tempo real.
3
Download Imediato de XML & Impressão DANFE
Assim que a SEFAZ autoriza o protocolo, a devolução recebe o selo oficial verde de NF-e Devolução Autorizada, liberando botões diretos para baixar o XML e imprimir o DANFE em PDF. O evento é registrado automaticamente na linha do tempo do SAC.
Artigo 6.5

Vistoria Física Granular, Movimentação de Estoque & Formas de Compensação

A etapa de encerramento garante controle rígido de perdas e satisfação comercial do cliente:

Vistoria Física & Reintegração de Estoque

Na tabela de conferência do chamado, o operador inspeciona a condição física de cada unidade recebida:

  • Item Aprovado para Revenda: O checkbox Reintegrar saldo das peças no estoque da loja adiciona as quantidades de volta ao saldo comercial do produto, gerando registro rastreável na tabela de movimentações de estoque.
  • Item Danificado / Sucata: Se o produto retornou avariado ou com lacre violado, o operador desmarca o retorno ao estoque, encaminhando o item para assistência ou descarte sem inflar o inventário contábil.
Modalidades de Compensação Financeira

O operador escolhe como o cliente será compensado:

  • Estorno no Meio de Origem (PIX / Cartão): Aciona a devolução do montante na conta do comprador ou solicitação de estorno no gateway de pagamento.
  • Converter crédito em Vale do Cliente (Fracionável — Financeiro): Emite automaticamente um Vale-Crédito nominal vinculado ao cliente com saldo auditável em Financeiro > Operações Diárias > Vales & Créditos, permitindo abatimento fracionado em diversas compras futuras.
  • Gerar Cupom Promocional (Uso Único): Gera um cupom promocional de uso único no valor da devolução para utilização pontual.
  • Troca de Produto (Item Despachado): Gera vínculo para despacho de novo SKU substituto ao cliente.
⚠️ Recusa Formal com Laudo Técnico
Caso o produto devolvido apresente indícios de mau uso, ausência de componentes originais ou tenha ultrapassado o prazo legal sem justificativa, o operador pode acionar a opção Recusa de Devolução. O sistema exige a digitação de uma justificativa formal fundamentada, registra o parecer na linha do tempo e notifica o consumidor com transparência jurídica.

Gestão de Afiliados, Campanhas & Comissões

Programa de parceiros, comissionamento automático de vendedores e rastreamento de links.

Caminho de Acesso: Menu Principal > Vendas > Marketing > Afiliados (Rota: /comercial/marketing/afiliados) & Campanhas (Rota: /marketing/campanhas)

Estruture equipes de representantes externos e parceiros comissionados. O sistema gera links exclusivos de indicação com cookies persistentes e cupons de desconto vinculados ao parceiro. A apuração de comissões ocorre automaticamente na liquidação financeira de cada pedido.

Gestão de Estoque, Compras & Entrada de Notas

Controle físico e financeiro (CMPM e PEPS), rastreabilidade por lote e importação automatizada de XML.

Caminho de Acesso: Menu Principal > Estoque > Lançamentos de estoque (Rota: /estoque/lancamentos) & Notas fiscais de entrada (Rota: /compras/notas-entrada)

O módulo de Estoque controla movimentações físicas e contábeis pelo método do Custo Médio Ponderado Móvel (CMPM) ou PEPS (Primeiro que Entra, Primeiro que Sai). Gerencia múltiplos almoxarifados, reservas de produção e saldo mínimo de segurança.

Passo a Passo: Importação de XML de Fornecedor (Entrada de Mercadorias)

1
Upload do Arquivo XML da NF-e Em Menu Principal > Estoque > Notas fiscais de entrada (/compras/notas-entrada), arraste o arquivo XML da NF-e emitida pelo fornecedor ou informe a chave de acesso de 44 dígitos para captura automática.
2
Mapeamento De-Para & Fatores de Conversão O sistema correlaciona o código do fornecedor com o seu código de produto interno. Se você adquire matéria-prima em caixas com 24 unidades e estoca em unidades individuais, defina o fator x24 para conversão imediata de quantidade e custo unitário.
3
Provisionamento Financeiro e Atualização de Custo Ao confirmar a nota, o Contas a Pagar é alimentado com as duplicatas e datas de vencimento exatas, e o custo do produto é recalculado conforme a regra de custeio definida.

Produção Industrial (PCP, BOM & Chão de Fábrica)

Ficha técnica de produtos, Dashboard Kanban em tempo real, roteiros operacionais e Bloco K.

Caminho de Acesso: Menu Principal > Estoque > Ordens de produção (Rota: /estoque/ordens-producao) ou no Cockpit: Menu Superior > Dashboard > Produção / PCP (Rota: /dashboard?layout=producao_pcp)

O motor de Planejamento e Controle da Produção (PCP) do MhSys OS coordena o chão de fábrica desde a estrutura de materiais (Bill of Materials - BOM) até a entrega do produto acabado. O Dashboard PCP em Tempo Real organiza as Ordens de Produção em colunas Kanban: Aguardando Início, Em Produção, Em Inspeção de Qualidade e Concluída.

Fluxo de Fabricação e Apontamento de Perdas Técnicas

1
Abertura da OP e Reserva de Matéria-Prima A OP pode ser gerada a partir de um Pedido de Venda ou aberta de forma avulsa para recomposição de estoque. O sistema reserva os insumos no almoxarifado de matérias-primas.
2
Apontamento no Terminal do Chão de Fábrica O operador seleciona a máquina/posto de trabalho e inicia o lote. Em caso de desvios (ex.: sobras de corte ou quebra mecânica), o apontamento de Perda Técnica é registrado para conformidade com o Bloco K do SPED Fiscal.
3
Encerramento da OP e Entrada no Estoque Acabado Ao concluir a inspeção de qualidade, o saldo do produto acabado é adicionado ao estoque disponível para expedição e o pedido de venda correspondente tem seu status atualizado para pronto para faturamento.
⚠️ Regra de Consumo Automático de Estoque Ao concluir uma OP, as matérias-primas são baixadas de forma atômica no banco de dados. Caso haja saldo insuficiente em algum insumo crítico, o sistema emite um alerta impeditivo para evitar estoques contábeis negativos.

Financeiro, Vales & Créditos Fracionáveis, Bolepix & DRE

Contas a Pagar/Receber, carteira fiduciária de créditos de clientes utilizáveis em partes, conciliação OFX e DRE por competência e caixa.

Caminho de Acesso: Menu Principal > Financeiro > Operações Diárias > Visão Geral (Rota: /financeiro), Vales & Créditos (Rota: /financeiro/vales) & Controladoria > DRE (Rota: /relatorios/dre)
Artigo 9.1

Controladoria Financeira, Boletos Híbridos (Bolepix) & DRE Gerencial

A controladoria do MhSys OS consolida toda a movimentação financeira da organização em tempo real, integrando Contas a Receber (/financeiro/receber), Contas a Pagar (/financeiro/pagar), conciliação bancária automatizada via arquivos .OFX e emissão de boletos híbridos com Pix dinâmico integrado (Bolepix) compensados instantaneamente.

No menu Menu Principal > Financeiro > Controladoria > DRE (/relatorios/dre), o Demonstrativo do Resultado do Exercício confronta a Receita Bruta Faturada com deduções fiscais, Custo das Mercadorias Vendidas (CMV), despesas operacionais fixas/variáveis e margem líquida de contribuição.

📊 Integração Contábil B2B via Nibo Para sincronizar Contas a Pagar, Contas a Receber, Baixas e Conciliação Bancária diretamente com a plataforma do seu escritório de contabilidade, consulte Central de Aplicativos > Nibo — Integração Contábil & Financeira B2B.
Artigo 9.2

Vales & Créditos de Clientes: Visão Geral & Conceito de Negócio

Caminho de Acesso: Menu Principal > Financeiro > Operações Diárias > Vales & Créditos (Rota direta: /financeiro/vales)

O submódulo Vales & Créditos de Clientes transforma créditos comerciais e financeiros em uma carteira de crédito digital com saldo auditável e utilização fracionada (em partes). Diferentemente de uma promoção pontual, o vale representa um saldo financeiro real pertencente ao cliente ou portador, podendo ser abatido ao longo de múltiplas compras até que seu saldo disponível chegue a R$ 0,00.

Vale-Presente (Gift Card)

Emissão de cartões-presente corporativos ou de varejo (ao portador ou nominais) para consumo livre em uma ou várias visitas à loja física ou virtual.

Crédito por Troca / Devolução

Conversão imediata de mercadorias devolvidas no pós-venda em saldo nominal ao cliente, fidelizando a recompra sem desembolso imediato de caixa.

Bonificação Comercial

Concessão de acordos comerciais, créditos de adiantamento B2B ou compensações de SLA com rastreabilidade contábil integral no setor financeiro.

Diferença Prática: Vale / Crédito Fracionável vs. Cupom de Desconto

Critério Operacional Cupom de Desconto (Vendas > Marketing > Cupons de Desconto) Vale & Crédito de Cliente (Financeiro > Operações Diárias > Vales & Créditos)
Natureza Contábil Desconto promocional de marketing (reduz margem comercial do pedido). Carteira de crédito fiduciário (Passivo) que quita total ou parcialmente o pagamento da compra.
Forma de Consumo Abatimento pontual único no pedido (percentual % ou valor fixo sem guardar troco). Utilização Fracionada (em partes): preserva o saldo remanescente ativo para as próximas compras até zerar.
Rastreabilidade Contagem simples de usos da campanha promocional. Extrato Auditável (Razão): histórico linha a linha de saldo anterior, valor abatido, saldo posterior, operador e pedido vinculado.
Governança de Emissão Gerenciado pela equipe Comercial / Marketing. Emissão e cancelamento restritos ao Financeiro / Administrador (ou conversão auditada de devolução).
Artigo 9.3

Permissões de Acesso & Segregação de Funções (Governança RBAC)

Como todo vale emitido representa um compromisso financeiro assumido pela empresa, o MhSys OS aplica segregação rigorosa entre quem autoriza/emite créditos e quem opera o caixa/vendas:

Perfil de Usuário Ações Permitidas no Sistema Travas de Segurança Aplicadas
Perfil Financeiro / Administrador Acessa Menu Principal > Financeiro > Operações Diárias > Vales & Créditos, emite novos vales (+ Novo Vale / Crédito), monitora os KPIs de passivo em aberto, consulta o extrato completo (Ver Extrato / Razão), realiza ajustes justificados de saldo/validade e cancela vales individualmente ou em lote. Gestão Financeira Completa
Operador de Vendas / Caixa (PDV) Consulta a validade/saldo e aplica códigos de vales válidos no campo Código de Vale / Crédito durante o fechamento de Pedidos de Venda e na Frente de Caixa (PDV), visualizando o abatimento em tempo real. Sem Emissão Manual
Bloqueado para criar, editar saldo ou cancelar vales no módulo Financeiro.
Artigo 9.4

Passo a Passo: Como Emitir e Gerenciar Vales no Módulo Financeiro

Ao acessar Menu Principal > Financeiro > Operações Diárias > Vales & Créditos (/financeiro/vales), o painel superior apresenta instantaneamente 4 indicadores executivos para controle da controladoria:

Indicador 1
Vales Ativos / Parciais
Quantidade total de vales aptos para uso imediato, detalhando quantos estão intactos e quantos já estão em uso parcial.
Indicador 2
Saldo Disponível (Passivo Aberto)
Soma exata em reais (R$) dos créditos ainda em mãos de clientes prontos para abatimento futuro.
Indicador 3
Total Já Resgatado
Montante financeiro acumulado que já retornou em vendas realizadas e total de vales 100% esgotados.
Indicador 4
Volume Total Emitido
Soma histórica de todos os créditos emitidos pela empresa e contagem total de registros auditados.

A) Emitindo um Novo Vale Manualmente

1
Abra a Janela de Emissão Na barra superior direita de Vales & Créditos, clique no botão azul + Novo Vale / Crédito para abrir o formulário compacto Emitir Novo Vale / Crédito.
2
Defina o Código Único e o Valor Inicial (R$) O campo Código Único do Vale * já sugere automaticamente um código exclusivo no padrão VALE-XXXXXX (você pode clicar em Gerar para sortear outro código ou digitar um identificador personalizado, como PRESENTE-NATAL-500). Em seguida, preencha o campo Valor do Crédito (R$) * com o saldo inicial concedido.
3
Escolha a Origem e o Tipo de Titularidade (Nominal vs. Ao Portador) Selecione a Origem / Natureza * (Emissão Manual (Financeiro), Crédito Comercial / Bonificação ou Crédito de Devolução / Troca) e configure o campo Cliente Titular (Opcional — Vazio = Ao Portador):
  • Vale Nominal (Exclusivo de um Cliente): Digite o nome ou CPF/CNPJ na busca inteligente para vincular o cliente (ou clique no botão [+] ao lado do campo para cadastrá-lo rapidamente sem fechar o modal). Apenas esse titular poderá utilizar o crédito;
  • Vale ao Portador (Livre): Deixe o campo de cliente em branco. O vale receberá a identificação Ao Portador e poderá ser utilizado por qualquer comprador na sua empresa (ideal para cartões-presente).
4
Informe Validade (Opcional), Motivo e Salve Preencha opcionalmente a Data de Validade (caso deixada em branco, o vale será emitido como Vitalício), registre o contexto em Descrição / Motivo de Emissão e clique em Salvar Vale. Na listagem, use o ícone de cópia ao lado do código para enviá-lo ao cliente com 1 clique.

B) Emissão Automática a partir de Devolução ou Troca de Venda

Quando um cliente devolve mercadorias em Menu Principal > Vendas > Vendas > Devoluções & SAC (/comercial/devolucoes), não é necessário abrir o Financeiro para digitar o crédito manualmente:

  1. Abra o protocolo da devolução e acesse a etapa de Vistoria & Conclusão;
  2. No seletor Forma de Compensação, escolha a opção 💳 Converter crédito em Vale do Cliente (Fracionável — Financeiro) e conclua a vistoria;
  3. O sistema emite instantaneamente um Vale Nominal vinculado ao cliente do pedido original, no valor exato dos itens aprovados, com natureza Devolução / Troca e rastreabilidade direta ao protocolo de origem.
Artigo 9.5

Ciclo de Vida & Tabela Oficial de Status do Vale

Cada vale transita automaticamente pelos status oficiais abaixo conforme os abatimentos, estornos ou prazos de vigência ocorrem, exibindo também uma barra visual na coluna Consumo & Progresso:

Status Oficial Significado Operacional Disponível no Checkout?
Ativo Vale recém-emitido (ou integralmente recomposto após estorno) com 100% do saldo inicial disponível para uso. Sim (Saldo Integral)
Parcial Vale que já teve parte do seu valor abatida em uma ou mais compras e ainda possui saldo remanescente maior que zero. Sim (Saldo Remanescente)
Esgotado Saldo disponível zerado (R$ 0,00) após utilização integral do crédito acumulado. Bloqueado (Saldo Zerado)
Expirado Ultrapassou a Data de Validade cadastrada antes do consumo total do saldo. Transição e bloqueio automáticos. Bloqueado por Vencimento
Cancelado Invalidado manualmente pelo setor Financeiro mediante justificativa obrigatória registrada na auditoria. Permanentemente Bloqueado
Artigo 9.6

Utilização Fracionada nos Checkouts (Vendas, PDV, E-commerce e AppStore)

A experiência de resgate é padronizada em todos os canais de venda do ecossistema — Pedidos de Venda (/vendas/pedidos), Frente de Caixa / PDV (/vendas/pdv), Checkout da Loja Virtual (E-commerce) e AppStore Digital:

1
Identifique o Cliente (Obrigatório para Vales Nominais) e Lance os Itens Selecione o cliente do pedido (ou informe o CPF/CNPJ no PDV / login no E-commerce) e adicione os produtos ou serviços normalmente ao carrinho.
2
Informe o Código e Clique em "Aplicar Vale" Localize o campo Código de Vale / Crédito, digite ou cole o código (ex.: VALE-XXXXXX) e clique no botão Aplicar Vale (ou pressione Enter).
3
Confira o Resumo Transparente e Conclua o Pagamento Líquido O painel de conferência exibe imediatamente quatro valores: Saldo do Vale, Abatido nesta compra, Saldo restante e Total líquido a pagar. Se o vale cobrir 100% da compra, o pedido é quitado sem exigir cobrança adicional; se houver diferença residual, escolha a forma de pagamento (Pix, Cartão, Dinheiro ou Boleto) apenas para o valor restante.

Exemplo Prático Ilustrado: Consumo de Vale em 2 Etapas

Acompanhe como o motor financeiro calcula os saldos quando um cliente recebe um vale de R$ 300,00 e realiza duas compras em datas distintas:

Emissão Inicial
Carteira Recebida pelo Cliente
Crédito Inicial:R$ 300,00
Total Utilizado:R$ 0,00
Saldo Disponível:R$ 300,00
Status do Vale:Ativo
1ª Compra · R$ 120,00
Compra Menor que o Saldo
Abatido no Vale:- R$ 120,00
Valor a Pagar no Caixa:R$ 0,00
Saldo Remanescente:R$ 180,00
Novo Status:Parcial
2ª Compra · R$ 250,00
Uso do Saldo Residual + Diferença
Abatido no Vale:- R$ 180,00
Cobrança Residual (Pix/Cartão):R$ 70,00
Saldo Remanescente:R$ 0,00
Novo Status:Esgotado
Artigo 9.7

Conciliação Financeira, Extrato Auditável (Ledger) & Estornos Automáticos

Impacto no Caixa e no Contas a Receber

Para preservar a exatidão contábil e evitar duplicidade de receita ou sobra artificial de gaveta, apenas o valor líquido residual após o abatimento do vale gera títulos em Contas a Receber ou entradas financeiras no Caixa / Pix / Cartão / Boleto. Na 1ª compra do exemplo acima (R$ 120,00 cobertos integralmente pelo vale), nenhum boleto em aberto é criado; já na 2ª compra (R$ 250,00 com R$ 180,00 em vale), o financeiro registra exatamente R$ 70,00 a receber.

Regra de Estorno Automático por Cancelamento

Caso um Pedido de Venda, cupom do PDV ou pedido do E-commerce que utilizou saldo de um vale seja cancelado, o sistema recompõe automaticamente o valor abatido no saldo disponível do vale, restaura seu status coerente (ex.: de Esgotado para Parcial, ou de Parcial para Ativo) e grava o evento de recomposição sem exigir lançamento manual.

Como Auditar a Linha do Tempo no Botão "Ver Extrato"

Na coluna Ações da listagem de Vales & Créditos, clique diretamente no botão fixo de extrato (ícone de diário) ou acesse o menu ⋮ > Ver Extrato / Razão. A janela Extrato Auditável do Vale apresenta os totalizadores no topo e cada evento cronológico imutável:

  • Crédito Inicial Emitido (+): valor de abertura do vale, data/hora e usuário emissor;
  • Utilização Parcial no Checkout (-): consumo que manteve saldo remanescente disponível;
  • Utilização Total (Vale Esgotado) (-): consumo que liquidou os últimos centavos do vale;
  • Estorno por Cancelamento de Pedido (+): devolução automática do saldo após cancelamento da venda vinculada;
  • Ajuste / Cancelamento Financeiro (±): intervenção administrativa justificada pelo setor financeiro.
💡 Dica de Produtividade: Rastreamento Direto do Pedido em 1 Clique Em cada linha de utilização ou estorno dentro do modal Extrato Auditável do Vale, clique sobre o atalho do documento (ex.: VENDAS · Pedido #1042, PDV · Pedido #88 ou Devolução #19) para abrir imediatamente o pedido correspondente na mesma tela do Workspace.
Artigo 9.8

Perguntas Frequentes (FAQ Rápido — Vales & Créditos)

1. Posso usar um vale junto com um cupom de desconto na mesma compra?

Sim, por padrão o uso combinado é permitido. Primeiro o Cupom de Desconto aplica o abatimento promocional sobre o subtotal dos itens e, em seguida, o Vale / Crédito quita total ou parcialmente o valor líquido resultante. Caso a diretoria comercial deseje impedir o uso simultâneo na operação, basta ajustar a regra em Configurações > Parametrizações > Vendas (/configuracoes/parametrizacoes?tab=vendas&param=vendas_permitir_acumular_cupom_e_vale).

2. O que acontece se o vale vencer antes de o cliente gastar todo o saldo?

Assim que a Data de Validade cadastrada é ultrapassada, o sistema altera automaticamente o status do vale para Expirado e bloqueia qualquer nova tentativa de resgate nos checkouts, preservando intacto todo o histórico das compras anteriores no extrato. Se a gerência financeira autorizar a prorrogação do prazo, basta clicar em ⋮ > Editar / Ajustar Vale e definir uma nova data futura para reativar o saldo remanescente.

3. Um vale emitido por uma empresa do grupo pode ser utilizado em outra empresa cadastrada separadamente no sistema?

Não. Por governança contábil e isolamento corporativo estrito entre empresas no MhSys OS, cada organização mantém cadastro de clientes, carteira de vales, numeração de códigos e passivo financeiro 100% isolados e independentes. Um código emitido em uma empresa usuária não é reconhecido nem pode abater pedidos em outra organização distinta.

Fiscal & Código IBGE Oficial (7 Dígitos)

Emissão de NF-e, NFC-e, NFS-e Padrão Nacional, certificado digital A1 e autopreenchimento fiscal de cidades.

Caminho de Acesso: Menu Principal > Vendas > Vendas > Notas Fiscais de Saída (Rota: /vendas/nfe) & Serviços > Notas Fiscais de Serviço (NFSe) (Rota: /vendas/nfse) — (Gestão Central IBGE: Menu Principal > SaaS > Cidades — /saas/cadastros/cidades)

O motor fiscal do MhSys é homologado em conformidade com o Manual de Orientação do Contribuinte (MOC 4.00) da SEFAZ e o Padrão Nacional de NFS-e (Ambiente de Dados Nacional - ADN). Todo documento fiscal exige o código numérico oficial do município de 7 dígitos do IBGE nos campos XML (como cMun, cMunFG, cLocEmi e cLocPrestacao).

Sincronização em Lote de Códigos IBGE & Autopreenchimento Transparente

1
Sincronização Oficial em Lote na Retaguarda No painel de retaguarda em Menu Principal > SaaS > Cidades (/saas/cadastros/cidades), o botão Sincronizar Códigos IBGE (Lote) consulta a API oficial do IBGE (servicodados.ibge.gov.br) e atualiza os 5.571 municípios brasileiros em lotes protegidos de 100 registros.
2
Validação Geográfica de 7 Dígitos Ao cadastrar ou editar um município, o sistema valida obrigatoriamente se os 2 primeiros dígitos coincidem com o código estadual (ex.: 42 para Santa Catarina, 35 para São Paulo, 41 para Paraná).
3
Autopreenchimento Fiscal Transparente para a Empresa Usuária Durante a emissão de notas fiscais, o usuário não precisa memorizar ou preencher códigos IBGE: o backend resolve os códigos oficiais da empresa emitente e do cliente destinatário de forma 100% automatizada.
🔄 Emissão Integrada de NF-e de Devolução (Entrada — Modelo 55 / finNFe 4)
Para anulação fiscal de vendas e devolução de mercadorias ao estoque com inversão automática de CFOP (1.202 / 2.202 / 1.411) e amarração à chave original <refNFe>, consulte a seção detalhada em Trocas, Devoluções & SAC > Emissão de NF-e de Devolução.
Artigo 10.1

Central do Contador & Gerador SPED Fiscal (EFD ICMS/IPI)

Caminho de Acesso: Menu Principal > Vendas > Fiscal & Contábil > Central do Contador & SPED (Rota direta: /fiscal/sped)

A Central do Contador & SPED Fiscal consolida todo o fechamento tributário e contábil mensal da sua empresa em um único cockpit auditável. Posicionada estrategicamente dentro do menu Vendas (na subseção Fiscal & Contábil), a ferramenta atende tanto empresas do Simples Nacional quanto operações do Lucro Presumido, Lucro Real, Indústrias e Distribuidoras:

Todos os Planos Pacote Mensal do Contador (.zip)

Ideal para empresas do Simples Nacional e para o envio rápido de documentos ao escritório contábil. Reúne em 1 clique todos os XMLs autorizados de saída (NF-e e NFC-e), notas de serviços emitidas (NFS-e), notas de compra importadas (NF-e de entrada), notas canceladas e o Demonstrativo Consolidado de Apuração Fiscal.

Plano Max / SPED_FISCAL Gerador Oficial SPED Fiscal (.txt EFD ICMS/IPI)

Obrigatório para empresas do Lucro Presumido, Lucro Real, indústrias e contribuintes acima do sublimite estadual de ICMS. Gera o arquivo digital .txt nos estritos padrões do Programa Validador e Assinador (PVA) da Receita Federal, incluindo os Blocos 0, C, E, H (Inventário), K (Produção/PCP) e 9.

Artigo 10.2

Pré-Validador PVA & Passo a Passo do Fechamento Mensal

Antes de gerar o arquivo .txt da EFD ICMS/IPI, o motor de Pré-Validação PVA inspeciona automaticamente todos os cadastros e documentos fiscais da competência selecionada, evitando que o seu contador enfrente erros estruturais ao importar o arquivo no programa da Receita Federal:

1
Configure os Dados do Contabilista (Registro 0100) No card lateral direito de Menu Principal > Vendas > Fiscal & Contábil > Central do Contador & SPED (/fiscal/sped), informe o Nome do Contabilista, CPF (11 dígitos), inscrição CRC, CNPJ do Escritório (opcional), E-mail do Contador e Telefone, e clique em Salvar Contabilista (0100).
2
Selecione a Competência (MM/YYYY) e Clique em "Auditar Pré-PVA" No seletor de mês/ano do topo da tela, escolha a competência desejada e acione o botão Auditar Pré-PVA. O sistema verifica instantaneamente o cadastro do Emitente (0000/0005), clientes e fornecedores movimentados no mês (0150), unidades e produtos (0190/0200) e notas fiscais (C100/C170/C190).
3
Saneie Eventuais Pendências Bloqueantes com 1 Clique Caso algum produto faturado esteja sem NCM de 8 dígitos (Registro 0200) ou algum participante esteja sem Código IBGE de 7 dígitos (Registro 0150), o painel exibe o alerta vermelho com o botão direto de correção (ex.: Corrigir NCM do Produto ou Vincular Cidade IBGE). Após corrigir, clique novamente em Auditar Pré-PVA para confirmar o selo verde 100% Homologado PVA.
4
Defina o Perfil de Apresentação (A, B ou C) e os Blocos Opcionais (Bloco H e Bloco K) Selecione o Perfil EFD determinado pela UF da sua empresa (Perfil A, Perfil B ou Perfil C), a Finalidade (0 - Remessa Original ou 1 - Remessa Substituta) e marque os interruptores Incluir Bloco H (Inventário) (quando exigido o livro de inventário físico valorado) e Incluir Bloco K (PCP / OP) (para indústrias e controle de ordens de produção concluídas).
5
Gere o SPED Fiscal (.txt), Baixe o Pacote (.zip) ou Envie por E-mail ao Contador Clique em Gerar SPED Fiscal (.txt) para baixar o arquivo oficial da EFD ICMS/IPI, ou clique em Baixar Pacote do Contador (.zip) para obter o arquivo compactado completo. Na tabela de Histórico de Arquivos Gerados, clique no ícone de envelope (Enviar para o E-mail do Contador) para disparar o fechamento diretamente para a caixa de entrada da contabilidade.
Artigo 10.3

Estrutura Oficial dos Blocos EFD ICMS/IPI & Pastas do Pacote Mensal (.zip)

Confira na tabela abaixo a composição exata dos blocos gerados no arquivo .txt da EFD ICMS/IPI e a organização padronizada das pastas dentro do arquivo Pacote_Contador_{CNPJ}_{YYYYMM}.zip:

Bloco / Diretório Registros / Conteúdo Finalidade Contábil e Fiscal
Bloco 0 EFD .txt 0000, 0001, 0005, 0100, 0150, 0190, 0200, 0990 Identificação da empresa emitente, dados do Contabilista (0100), tabela deduplicada de clientes/fornecedores (0150), unidades (0190) e catálogo de produtos com NCM e CEST (0200).
Bloco C EFD .txt C001, C100, C170, C190, C990 Escrituração das NF-e (Mod. 55) de entrada e saída e NFC-e (Mod. 65), respeitando notas regulares (00) e canceladas (02), itens analíticos (C170) e consolidação por CST + CFOP + Alíquota de ICMS (C190).
Bloco E EFD .txt E001, E100, E110, E116, E990 Apuração mensal do ICMS próprio: confronta o total de débitos nas saídas com os créditos nas entradas de compras e gera a obrigação de recolhimento (E116).
Bloco H & Bloco K Opcional H005, H010 / K100, K200, K230 Bloco H: Registro do Inventário Físico valorado pelo custo unitário/médio. Bloco K: Controle da produção industrial (PCP) e estoque escriturado ao final do período.
Bloco 9 EFD .txt 9001, 9900, 9990, 9999 Controle matemático e encerramento do arquivo digital com totalização individual de cada registro e contagem total exata de linhas no registro |9999|.
Pastas 01 a 05 + Resumo Pacote .zip /01_NFe_Saida_Autorizadas
/02_NFCe_Saida_Autorizadas
/03_NFSe_Servicos_Emitidas
/04_NFe_Entrada_Compras
/05_Canceladas_e_Inutilizadas
Estrutura pronta para importação no sistema contábil, acompanhada do relatório executivo Resumo_Apuracao_Fiscal_{YYYYMM}.html e do arquivo SPED_EFD_ICMS_IPI_{YYYYMM}.txt.
💡 Dica de Produtividade: Fechamento Contábil até o 5º Dia Útil Adote a rotina de acessar a Central do Contador & SPED no 1º dia útil de cada mês, selecionar a competência do mês recém-encerrado, executar o Auditar Pré-PVA e enviar o Pacote Mensal (.zip) diretamente para o e-mail do seu contador. Isso elimina o envio manual de XMLs avulsos e antecipa a apuração de impostos.
⚠️ Ponto de Atenção: Conferência de Estoque Antes de Gerar o Bloco H e Bloco K Antes de marcar as opções Incluir Bloco H (Inventário) ou Incluir Bloco K (PCP / OP), certifique-se de que todas as notas fiscais de compra do período foram devidamente importadas em /compras/notas-entrada e que as Ordens de Produção concluídas no mês já foram finalizadas no painel de PCP.

Contratos, Recorrência & Governança de Faturamento

Gestão do ciclo de vida, faturamento recorrente automático, reajustes seguros e trilha de auditoria anti-erros.

Caminho de Acesso: Menu Principal > Vendas > Vendas > Contratos (Rota: /comercial/contratos)

O módulo de Contratos do MhSys OS é a espinha dorsal de empresas prestadoras de serviços, integradoras de software, empresas de monitoramento, consultorias e indústrias com faturamento periódico. Ele automatiza desde a abertura de Ordens de Serviço (OS) e emissão de notas fiscais (NFS-e/NF-e) até o lançamento e conciliação bancária no Contas a Receber, eliminando esquecimentos e cobranças manuais.

Artigo 11.1

Visão Geral & Ciclo de Vida do Contrato

No dia a dia da sua empresa, um contrato passa por diferentes fases. Compreender o status de cada contrato é fundamental para garantir que o faturamento e as automações aconteçam no momento correto:

Status O que significa na prática? Gera cobranças e notas?
Pendente Contrato recém-cadastrado, em fase de negociação, elaboração de minuta ou aguardando assinaturas das partes. Não gera
Ativo Contrato em plena vigência. O robô de faturamento acompanha o calendário e dispara automaticamente faturas, boletos, ordens de serviço e notas fiscais. Sim, automático
Suspenso Pausa temporária combinada com o cliente ou bloqueio automático por atraso prolongado no pagamento. Faturamento pausado
Finalizado O contrato atingiu a data final de vigência sem renovação. Mantém todo o histórico arquivado para consulta. Não gera
Cancelado Rescisão antecipada formalizada. Interrompe qualquer faturamento futuro e cancela parcelas pendentes. Não gera
💡 Dica de Produtividade Você pode habilitar a opção "Bloqueio Automático por Inadimplência". Se o cliente atrasar a mensalidade por mais de 5 dias (ou o número de dias que sua empresa definir), o sistema pode suspender acessos e serviços automaticamente, reativando assim que o pagamento for confirmado via Pix ou Boleto.
Artigo 11.2

Governança Anti-Erros: Por Que Contratos Ativos Exigem Edição Prudente?

Imagine o seguinte cenário que costuma causar graves prejuízos em sistemas sem controle:

O Perigo do "Salvar Sem Governança"

Sua empresa presta serviço para um cliente há 12 meses cobrando R$ 2.000,00 por mês. Já foram emitidas 12 notas fiscais na Prefeitura e os boletos foram todos quitados e contabilizados. Em novembro, as partes combinam um reajuste de valor para R$ 2.500,00 a partir do ano seguinte. Em um sistema comum sem blindagem, se o operador simplesmente digitar "2.500,00" e clicar em salvar, o sistema poderia recalcular as faturas do passado, gerando inconsistências no Contas a Receber, divergência contábil e erros em declarações fiscais!

Para evitar que qualquer operador cometa esse tipo de erro acidental, o MhSys OS implementa uma Muralha de Proteção Inteligente (Governança Contratual):

  • O Passado é Intocável: Qualquer fatura que já foi paga pelo cliente ou que já possui Nota Fiscal emitida (NFS-e/NF-e) fica 100% blindada e protegida. O sistema jamais altera valores retroativamente;
  • O Futuro é Ajustável com Segurança: O sistema pergunta exatamente a partir de qual mês o novo valor deve passar a valer (o "Marco de Competência");
  • Auditoria Transparente: Toda mudança fica documentada em uma linha do tempo permanente, com data, hora, usuário responsável e motivo da alteração.
Artigo 11.3

Os 3 Níveis de Segurança na Alteração de um Contrato

Para que o sistema seja extremamente seguro sem burocratizar o dia a dia, os dados do contrato foram divididos em 3 Níveis de Risco:

Nível 1 Operacional & Rotina

Ajustes do dia a dia que não mexem no valor da mensalidade nem no vencimento.

  • Ligar/desligar emissão de NFS-e ou OS;
  • Trocar forma de pagamento (Pix/Boleto);
  • Alterar conta bancária ou vendedor;
  • Atualizar observações ou e-mails de envio.
Edição Direta & Imediata
Nível 2 Financeiro & Ciclo

Alterações no bolso do cliente: reajustes de valor e prorrogações de vencimento.

  • Novo Valor da Parcela / Mensal (R$);
  • Novo Dia de Vencimento (ex: de 10 para 20);
  • Novo Dia de Geração antecipada de NFS-e.
Exige Janela de Governança
Nível 3 Jurídico & GovTech

Contratos com órgãos públicos (Lei 14.133/2021) ou alterações profundas de cláusulas.

  • Acréscimo ou supressão de objeto;
  • Prorrogação de prazo contratual formal;
  • Exigência legal de Termo Aditivo numerado;
  • Trava de reajuste limitada a 25% (Art. 125).
Exige Termo Aditivo Formal
💡 O que isso muda na sua rotina? Se você só precisa ligar um botão (como ativar a emissão automática de Nota Fiscal) ou trocar o vendedor responsável, você pode fazer isso em segundos e salvar na hora. O sistema só abrirá a janela de governança quando você mexer em dinheiro (valor da parcela) ou no dia do vencimento.
Artigo 11.4

Como Funciona o "Marco de Início" (Competência) e os Títulos Futuros?

Ao alterar o valor de uma mensalidade ou o dia de vencimento de um contrato ativo, o sistema exibe a janela de governança. Nela, você define dois pontos essenciais de forma clara:

Fluxo da Linha do Tempo: Aplicação da Nova Regra
Passado / Faturado
Meses Anteriores

Parcelas já pagas ou com NFS-e emitida.

100% Blindadas
Marco Selecionado
Mês/Ano de Início

Competência escolhida na janela (ex: 2027-01).

Início da Nova Regra
Futuro / Em Aberto
Meses Seguintes

Parcelas pendentes no Contas a Receber.

Recalculadas com Novo Valor
Entendendo o Interruptor: "Recalcular Títulos Futuros em Aberto"

Dentro da janela de confirmação existe uma opção ativada por padrão:

  • Marcado (Recomendado): O sistema busca todas as parcelas que ainda não foram pagas pelo cliente daquela competência em diante e atualiza o valor e a data de vencimento de forma automática. Você não precisa entrar no Contas a Receber para editar boleto por boleto.
  • Desmarcado: O sistema mantém os boletos que já foram gerados exatamente como estão e passa a aplicar o novo valor apenas nas próximas faturas que forem geradas no futuro.
⚠️ Regra de Segurança Inviolável Mesmo que o interruptor de recálculo esteja ativado, se uma parcela futura já tiver sido paga pelo cliente ou se já tiver uma Nota Fiscal transmitida, o MhSys nunca irá sobrescrever esse título. O respeito aos dados fiscais e bancários já consolidados é absoluto.
Artigo 11.5

Passo a Passo Prático: Como Reajustar o Valor de um Contrato Ativo

Siga o roteiro simples abaixo sempre que precisar alterar o valor ou a data de vencimento de uma assinatura ou contrato em andamento:

1
Localize e abra o contrato Acesse Menu Principal > Vendas > Vendas > Contratos. Na listagem, clique sobre a linha do contrato desejado para abrir o painel de detalhes.
2
Habilite a edição Se o contrato estiver no modo protegido de consulta, clique no botão azul "Habilitar Edição" no topo direito da janela. Em seguida, acesse a aba "Valores & Faturamento" e informe o novo valor mensal ou o novo dia de vencimento.
3
Clique em "Salvar Contrato" Ao clicar em salvar, o sistema reconhece que se trata de um contrato ativo e abre instantaneamente a janela "Governança & Compliance Contratual", mostrando em cores o valor anterior e o novo valor.
4
Defina a competência, escreva o motivo e confirme Selecione o mês/ano a partir do qual a nova cobrança terá validade (ex.: 2027-01), escreva uma breve justificativa (ex.: "Reajuste anual conforme índice IPCA acordado com o cliente") e clique no botão "Confirmar & Salvar Contrato". Pronto! O contrato está atualizado e o Contas a Receber futuro ajustado.
Artigo 11.6

Trilha de Auditoria & Histórico: Quem Mexeu, Quando e Por Quê?

Em qualquer empresa saudável, a transparência sobre alterações financeiras é indispensável. O MhSys grava de forma permanente e imutável cada alteração feita em um contrato.

Para consultar o histórico completo de um contrato:

  1. Abra o contrato desejado;
  2. No rodapé inferior da tela, clique no botão Auditoria & Histórico;
  3. Uma janela se abrirá com a Linha do Tempo Completa contendo:
    • Nome do Usuário: Quem fez a alteração no sistema;
    • Data e Horário: O segundo exato em que a ação ocorreu;
    • Motivo / Justificativa: A explicação digitada pelo operador no momento de salvar;
    • Comparativo Visual (Diff): Uma caixa em vermelho com o valor "Antes" e uma caixa em verde com o valor "Depois".

Recursos Humanos & Ponto Eletrônico (Portaria MTP 671/2021)

Gestão integrada de colaboradores, espelho de ponto REP-P, ASOs (NR-7), vagas e conformidade trabalhista.

Caminho de Acesso: Menu Principal > RH & Pessoas > GESTÃO DE PESSOAS & PONTO > Folha de Ponto (REP-P) (Rota: /rh/ponto) e Cockpit RH (Rota: /rh)
Artigo 22.1

Visão Geral & Cockpit Executivo de RH

O Cockpit Executivo de RH centraliza as métricas de Headcount Ativo, Indicador de Presença Hoje (REP-P), Folha Base Estimada, Turnover Anual e Pipeline de Recrutamento & Seleção, com diagnósticos proativos gerados pelo agente cognitivo Mhax People Analytics Advisor.

Artigo 22.2

Cadastro de Colaboradores, Admissão & Dossiê Digital

Prontuário funcional unificado (com segregação no cadastro de pessoas), vinculação obrigatória a Cargos/CBO, Departamentos e Centros de Custo contábeis. Suporta os regimes CLT, Estágio (Lei 11.788), Menor Aprendiz e Contratos PJ, com armazenamento criptografado no Dossiê Digital de documentos (CTPS Digital, CNH, RG, Título de Eleitor e comprovantes).

Artigo 22.3

Ponto Eletrônico Homologado (REP-P Portaria MTP nº 671/2021)

O módulo REP-P MhSys é homologado nos termos estritos da Portaria MTP nº 671/2021:

  • Terminal Quiosque (Fullscreen API): Ponto biométrico facial ou por PIN numérico para tablets e computadores na portaria da empresa;
  • Marcação Web & Mobile: Registro com geolocalização por GPS e foto para colaboradores em regime externo ou home-office;
  • Assinatura Digital Imutável: Cada marcação gera um registro assinado digitalmente com Hash SHA-256 inviolável;
  • Espelho de Ponto & Banco de Horas: Apuração mensal com compensação de horas, horas extras e anexação de atestados médicos;
  • Arquivo Fonte de Dados (AFD): Exportação oficial para auditores fiscais do Ministério do Trabalho e Emprego.
Artigo 22.4

Medicina Ocupacional & Segurança do Trabalho (NR-7 / PCMSO)

Controle rigoroso de Atestados de Saúde Ocupacional (ASOs): Admissional, Periódico, Retorno ao Trabalho, Mudança de Riscos Ocupacionais e Demissional. O sistema emite alertas automáticos com 30 dias de antecedência para os gestores antes do vencimento de qualquer exame periódico.

Artigo 22.5

Gestão de Vagas, R&S e Portal de Carreiras Externo

Abertura de requisições de contratação, portal de carreiras público para candidatura direta de profissionais e quadro Kanban de triagem de candidatos (Triagem > Entrevista > Teste Prático > Aprovado), em conformidade integral com as normas de privacidade e expurgo de dados da LGPD.

Artigo 22.6

Parametrizações Avançadas de RH, Férias CLT & Governança

Configuração de escalas de trabalho (5x2, 6x1, 12x36), tolerâncias de atraso (Art. 58 da CLT), regras de cálculo de adicional noturno e travas automáticas contra a ocorrência de dobra de férias prevista no Art. 137 da CLT.

Central de Aplicativos (Apps), Plugins & Integrações

Estação de trabalho multitarefa virtual (MhSys Workspace), ecossistema modular de plugins e conectores de alta performance com plataformas de mercado.

Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) (Rota direta: /ferramentas/desktop & /plugins/{slug})

O **MhSys OS** disponibiliza uma arquitetura moderna de **estação de trabalho multitarefa em nuvem (Cloud Desktop Workspace)**. Projetada para operadores e gestores que precisam alternar instantaneamente entre atendimento, faturamento, conciliação e logística, a plataforma incorpora um **Gerenciador de Janelas Flutuantes (Window Manager)** com dock de aplicativos, barra de status unificada e uma central de plugins modulares ativados sob demanda.

Artigo 23.1

Arquitetura de Aplicativos, Isolamento Sandbox & Janelas Multitarefa

A arquitetura de aplicativos do MhSys OS foi concebida sob o princípio de Isolamento Modular Zero-Interference. Cada aplicativo opera de maneira independente, protegendo o núcleo do ERP contra falhas de serviços externos:

Gerenciador de Janelas Flutuantes

Permite abrir, minimizar, maximizar, redimensionar e sobrepor múltiplos módulos e conectores simultaneamente em uma única tela.

  • Zero Perda de Contexto: Alterne entre pedidos de venda, emissão de frete e conciliação contábil sem recarregar a página (F5).
  • Dock Dinâmico de Aplicativos: Fixe atalhos de apps favoritos na barra de inicialização rápida com ícones contextuais e badges de notificação.
  • Suporte Bimodal Completo: Interface adaptativa que respeita automaticamente o Modo Claro (Light Mode) e Modo Escuro (Dark Mode) do usuário.
Sandboxing & Governança SecOps

Cada plugin reside em diretório autocontido (/plugins/{slug}/) com camada de isolamento estrito:

  • Isolamento por Empresa: Chaves de API, credenciais e parâmetros ficam restritos à organização ativa, com criptografia AES-256 de dados em repouso.
  • Comunicação Exclusiva via REST: O intercâmbio de dados com as tabelas do ERP é realizado por contratos e rotas homologadas de API.
  • Workers e Cron Jobs em Background: Tarefas periódicas de sincronização rodam em segundo plano sem onerar o carregamento de telas operacionais.

Categorias de Aplicativos Homologados no Ecossistema

Categoria Finalidade Operacional no ERP Principais Aplicativos Disponíveis
Financeiro, Crédito & Fiscal Análise de risco B2B/B2C, conciliação contábil, cofre de XMLs e liquidação de títulos. Radar Crédito, Nibo Connect, Portal do Contador, Gateways Bancários
Marketing, Mídia & IA Criação de criativos de catálogo com IA, fluxos de agência e métricas de tráfego. Mhax Social Studio, Agência Flow, Canva Connect, Google Analytics
Comércio Exterior & Custos Simulação de Landed Cost, nacionalização de mercadorias e cascata aduaneira. Simulador de Importação
Logística, Frota & Last-Mile Torre de entregas urbanas, telemetria de veículos, médias de km/L e fretes multicanal. Torre Last-Mile, Gestor de Frotas Pro, Melhor Envio, Correios CWS, Braspress, Jadlog, Jamef, FedEx
Vendas, Inteligência & CPQ Configurador paramétrico CPQ, monitoramento de preços da concorrência e consignação. Orçamentista CPQ, Monitor Preços IA, Condi Controle
Pessoas, Clima & Educação Termômetro NPS pós-venda, ouvidoria anônima LGPD e universidade corporativa com IA. Termômetro NPS & Clima, Univ. Corporativa IA
Segurança & Propriedade Vigilância autônoma de marcas registradas no INPI e monitoramento de colidências. Marca Monitor (Radar Autônomo INPI), Autenticação MFA em 2 Fatores
Como Assinar na AppStore MHSYS

Acesse Menu Principal > Ferramentas > Central de Aplicativos (@Apps) ou clique no ícone da AppStore no Dock unificado. Localize o aplicativo desejado, revise as permissões e clique em Contratar / Ativar.

A assinatura é processada em lote na fatura mensal da empresa usuária, com ativação imediata das tabelas, rotas e permissões de segurança RBAC.

Operação Autônoma no Workspace OS

Cada aplicativo roda como um processo independente em janela multitarefa do Workspace Desktop. É possível minimizar, maximizar, ajustar tamanhos e alternar entre telas sem interromper lançamentos em andamento.

Para abrir qualquer app contratado, utilize a rota direta /plugins/{slug}/dashboard ou o atalho autônomo na barra de tarefas do sistema operacional em nuvem.

Artigo 23.2

Plugin Nibo — Integração Contábil & Financeira B2B

Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos > Nibo (Janela Desktop: /plugins/nibo) & APIs REST: /api/plugins/nibo/*

O aplicativo Nibo — Integração Contábil & Financeira B2B conecta de forma nativa a tesouraria, faturamento e contas do MhSys OS diretamente ao ecossistema contábil do Nibo, utilizado por milhares de escritórios de contabilidade e empresas em todo o território nacional.

A integração elimina por completo o retrabalho de digitação manual de notas fiscais, exportação periódica de extratos bancários e planilhas de conciliação financeira. O conector opera com idempotência fiduciária, sincronizando Contas a Pagar, Contas a Receber, Baixas (com juros, multa e descontos comerciais), Estornos, Categorias Contábeis e Stakeholders (Clientes e Fornecedores).

Sincronizados
Sucesso 100%
Títulos integrados no Nibo
Fila / Retry
Pendentes
Reenvio automático via Cron
Com Erro
Diagnóstico
Alerta cadastral com retry
Mapeamento
De/Para Ativo
Contas bancárias e categorias

1. Configuração, Credenciais da API & Blindagem SecOps

Na aba Configuração & Credenciais, o operador parametrizará a comunicação com a API REST oficial do Nibo:

1
Token da API Nibo (api_token) & Mascaramento Seguro
Chave de autenticação gerada no painel administrativo do Nibo da sua empresa. Por rigorosa diretriz de segurança SecOps, o token é criptografado em repouso no banco de dados e apresentado mascarado por padrão no formulário, contando com botão de alternância de visibilidade [👁️] para conferência apenas por usuários com permissão financeira.
2
Token de Usuário Opcional (user_api_token)
Suporte para integrações multi-escritório em que o contador exige a identificação do operador responsável pela remessa dos lançamentos contábeis.
3
Ambiente da API: Produção vs. Sandbox
Permite alternar entre o endpoint de Produção (api.nibo.com.br/empresas/v1) e o ambiente de Sandbox / Homologação (sandbox.api.nibo.com.br) para realização de testes e validação de rotinas com o contador sem afetar a escrita fiscal oficial.
4
Data de Corte Inicial Fiduciária (data_corte_inicio)
Trava cronológica obrigatória que estabelece o marco inicial de sincronização. Qualquer título com vencimento anterior a esta data é automaticamente classificado como Ignorado, prevenindo a alteração acidental de períodos fiscais já fechados pelo escritório contábil.
5
Teste Instantâneo de Conexão (Handshake Validation)
O botão Testar Conexão executa uma validação em tempo real contra a API do Nibo, verificando a validade do token, status da empresa e permissões de leitura/escrita antes de salvar a configuração.

2. Mapeamento De/Para: Contas Bancárias & Categorias Contábeis

Na aba Mapeamento De/Para, o sistema garante a perfeita consonância entre as contas financeiras do ERP e o plano de contas da contabilidade:

De/Para de Contas Bancárias & Caixas

Obrigatório para que as baixas e liquidações sejam conciliadas na conta bancária correta no Nibo:

  • O operador clica em Recarregar do Nibo para listar todas as contas bancárias e caixas ativos cadastrados no Nibo.
  • Para cada conta bancária do ERP (ex.: Bradesco Conta Corrente, Itaú, Caixa Interno), seleciona-se a conta equivalente no Nibo.
  • Garante que as conciliações de extratos bancários efetuadas no ERP espelhem fielmente o saldo do Nibo.
De/Para de Plano de Contas / Categorias

Vincula as categorias de Receitas e Despesas do ERP ao plano contábil do Nibo:

  • Filtro dinâmico por natureza contábil (Receitas vs. Despesas) e campo de busca rápida.
  • Associação precisa de categorias (ex.: Venda de Mercadorias ➔ Receita Operacional Bruta; Fretes Pagos ➔ Despesas com Logística).
  • Títulos sem categoria mapeada permanecem retidos com status de alerta, evitando poluição contábil com categorias genéricas.

3. Sincronização em Lote, Idempotência & Automação Cron (15 Minutos)

O conector opera em dois modos complementares de sincronização:

1
Sincronização Periódica Automática em Background (NiboSyncJob)
Com o switch ativo, o worker do sistema executa a cada 15 minutos via cron job do servidor, identificando automaticamente novos títulos lançados, baixas realizadas e alterações de valores ocorridos no período, transmitindo tudo em segundo plano sem exigir ação manual.
2
Exportação e Conciliação em Lote Sob Demanda
Na aba Sincronização em Lote, o operador pode forçar o reenvio de um período específico definindo o intervalo de vencimento (Data Início a Data Fim) e o escopo (Todos, Apenas Contas a Pagar ou Apenas Contas a Receber).
3
Garantia Estrita de Idempotência Fiduciária (POST com Fallback para PUT)
Cada título do ERP recebe uma chave de referência exclusiva (MHSYS-CP-{id} para despesas e MHSYS-CR-{id} para receitas, com sufixo /1..N para títulos parcelados). Se um título já foi enviado anteriormente, o motor realiza atualização (PUT) em vez de criar um duplicado, garantindo total integridade mesmo após quedas de conexão ou reenvios em lote.
4
Sincronização de Baixas com Juros, Multa e Descontos
Ao liquidar um título no ERP, o NiboSyncService envia o valor pago líquido discriminando encargos financeiros e descontos obtidos. Caso a baixa seja estornada no ERP, o conector aciona automaticamente o endpoint de estorno (DELETE da baixa) no Nibo.
5
Stakeholders Automáticos (Clientes & Fornecedores) com Filtro OData
O conector valida a obrigatoriedade de CPF ou CNPJ válido do sacado/cedente e consulta a API do Nibo via filtro OData antes da criação. Se o parceiro já existe no Nibo, seu identificador é reutilizado imediatamente, impedindo a duplicação do cadastro de clientes e fornecedores.

4. Auditoria Forense, Histórico de Logs & Reprocessamento Manual

Na aba Logs & Reprocessamento, a equipe financeira e a contabilidade dispõem de visibilidade total sobre cada transação comunicada entre os sistemas:

Rastreabilidade Ponta a Ponta

A tabela de logs registra data/hora, tipo de entidade (conta_pagar, conta_receber, baixa_pagar, baixa_receber, stakeholder), ID do ERP, UUID gerado no Nibo, status operacional e código HTTP retornado pela API.

  • Resiliência a Timeouts (HTTP 504): Em caso de oscilações na rede ou lentidão da API Nibo, o título permanece como pendente e é colocado na fila de retentativa automática (backoff).
  • Reprocessamento Manual em 1 Clique: Permite reenviar imediatamente qualquer título que tenha retornado erro cadastral após a correção do dado no ERP.
Inspeção Forense JSON (Modal Uniforme)

Ao clicar na linha do log, abre-se uma janela modal em tamanho canônico padronizado (modal-lg) projetando o Payload JSON enviado pelo MhSys ERP confrontado diretamente com a Resposta JSON retornada pelo Nibo, viabilizando diagnósticos técnicos ágeis e assertivos com o suporte do Nibo ou da contabilidade.

💡 Dica de Governança Contábil
Mantenha o switch de sincronização automática ativado e defina a Data de Corte Inicial no primeiro dia do mês de implantação. Assim, sua contabilidade recebe os lançamentos em tempo real sem qualquer risco de sobrescrever competências contábeis fechadas de meses anteriores.
Artigo 23.3

Radar Crédito & Dossiê CNPJ — Análise de Risco, Score & Limite Automatizado

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Radar Crédito & CNPJ (Rota direta: /plugins/radar_credito/dashboard)

O aplicativo Radar Crédito & Dossiê CNPJ é o motor autônomo de inteligência e governança de risco de crédito B2B e B2C do MhSys OS. Operando diretamente em janela multitarefa do Workspace OS sem poluir as rotinas do cadastro comercial, o aplicativo integra consultas públicas automatizadas (Receita Federal, BrasilAPI e birôs parceiros homologados via RadarCreditoBureauClient), Quadro de Sócios e Administradores (QSA), capital social, histórico de alterações contratuais e pendências fiscais, cruzando esses dados externos com o histórico interno de pontualidade de pagamentos e compras acumulado pelo cliente no ERP.

A partir dessa correlação entre dados cadastrais oficiais e comportamento financeiro real, o motor calcula um Score Paramétrico de 0 a 1000 pontos, detecta riscos societários cruzados, emite parecer analítico fundamentado por Inteligência Artificial e calcula o teto sugerido de vendas a prazo, viabilizando a atualização do cadastro com 1 clique e a emissão do Laudo Pericial de Crédito em PDF executivo.

Score 0 a 1000
Score Preditivo
Faixas de risco calibradas
Receita & Birôs
Dossiê Societário
QSA e grupo econômico
Histórico Interno
ERP Core Match
Pontualidade em títulos
Laudo Pericial
PDF Auditável
Armazenamento oficial

Ciclo de Análise de Risco & Concessão de Crédito

1
Consulta Cadastral Unificada & Varredura Societária Forense (QSA)
Ao informar o CPF ou CNPJ no campo de busca com autocomplete, o aplicativo aciona os conectores homologados, preenchendo Razão Social, CNAE principal/secundários, Situação Cadastral na Receita Federal, Endereço Fiscal, Capital Social e o Quadro de Sócios e Administradores (QSA) com alerta de eventuais apontamentos societários em empresas do mesmo grupo econômico.
2
Auditoria de Comportamento Financeiro & Carteira Interna de Recebíveis
O motor audita automaticamente as movimentações prévias do cliente no ERP: volume financeiro faturado, maior valor de compra, média de dias de atraso na liquidação de boletos, títulos em aberto no Contas a Receber e eventuais protestos ou renegociações registradas na tesouraria.
3
Cálculo do Score Paramétrico (0–1000) & Parecer Cognitivo de Crédito por IA
O algoritmo consolida os pesos cadastrais e comportamentais na escala de 0 a 1000 pontos (Excelente: 800–1000; Bom: 600–799; Moderado: 400–599; Alto Risco: 0–399). O assistente cognitivo emite um parecer técnico recomendando o valor teto de compras a prazo e condições comerciais compatíveis com o risco de crédito do cliente.
4
Aplicação do Limite em 1 Clique & Emissão do Laudo PDF Pericial
O operador clica no botão Aplicar Limite no Cadastro para atualizar imediatamente o campo pessoas.limite_credito no cadastro do cliente sem sair do aplicativo. Simultaneamente, o sistema gera o Laudo Pericial de Crédito em PDF executivo, com hash criptográfico de autenticidade para comprovação em auditorias financeiras e comitês de crédito.
💡 Governança de Storage & Governança de Tokens IA
O Laudo Pericial de Crédito em PDF é processado e arquivado via ArmazenamentoService com isolamento no diretório seguro da organização, debitando de forma transparente a cota de storage contratada. A formulação do parecer analítico por inteligência artificial é controlada pelo parâmetro ia_agente_radar_credito_ativo em Configurações > Parametrizações > Governança de I.A., permitindo à empresa usuária pausar o parecer cognitivo a qualquer momento para economia de tokens sem interferir no cálculo paramétrico do Score.
Artigo 23.4

Mhax Social & Vitrine Studio IA v2.0 — Estúdio Criativo, Carrosséis AIDA & Campanhas

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Mhax Social Studio (Rota direta: /plugins/mhax_social_studio/dashboard)

O Mhax Social & Vitrine Studio IA v2.0 Enterprise é a suíte de criação publicitária e marketing automatizado de catálogo do MhSys OS. Projetado para atuar como uma agência de marketing digital interna no Workspace OS, o aplicativo conecta-se diretamente ao estoque e cadastro de produtos do ERP para gerar peças promocionais de alta conversão, testes de copywriting A/B, roteiros para vídeos curtos e calendários editoriais completos para redes sociais com poucos cliques.

A versão v2.0 incorpora o inovador **Brand Kit Persistente da Organização** (com paleta de 3 cores corporativas e 5 templates visuais pré-calibrados), suporte a **Carrosséis Sequenciais de 5 Lâminas AIDA** (Atenção, Interesse, Desejo, Ação e Fechamento), formato **Vitrine Relâmpago 2x2** (grade promocional com 4 produtos simultâneos), gerador de **Prompts de Vídeo IA** para ferramentas cinematográficas (Sora, Veo, Kling, Runway) e **Calendário Editorial com Disparo Direto via WhatsApp Business Gateway**.

Multiformatos v2
Carrossel AIDA & 2x2
Feed, Stories e Vitrine
Brand Kit Ativo
5 Templates Visuais
Cores, logo e enquadramento
Copywriting A/B
Variações A & B
Emocional vs. Direta/Urgência
Calendário & Zap
Disparo Direto
WhatsApp Business Gateway

Fluxo de Produção Criativa de Marketing v2.0

1
Parametrização do Brand Kit & Seleção de Produtos no Catálogo
Na aba Brand Kit, a empresa usuária define sua paleta de 3 cores institucionais, o estilo visual padrão (Minimalista Clean, Varejo Oferta, Elegante Premium, Dark Tech ou Editorial), slogan, @instagram e posicionamento do logotipo. Ao criar a arte, seleciona o produto individual ou conjunto de até 4 produtos para a Vitrine Relâmpago.
2
Escolha do Formato Criativo & Composição de Carrossel AIDA
O operador escolhe o canal de distribuição: Feed Quadrado (1:1), Stories / Reels (9:16), Status do WhatsApp, Vitrine Relâmpago (2x2) ou Carrossel Sequencial AIDA (5 lâminas). O motor aplica automaticamente os selos promocionais configurados (ex.: "Frete Grátis", "Lançamento", "Oferta Limitada").
3
Geração de Copywriting A/B & Prompts de Vídeo (Sora/Veo/Runway)
A inteligência artificial gera simultaneamente duas variações de copywriting (Variação A focada em benefícios e conexão emocional; Variação B focada em escassez, preço e chamada imediata de compra). Em paralelo, formula um prompt cinematográfico em inglês com roteiro segundo a segundo para geração de vídeos em ferramentas de IA.
4
Exportação Otimizada WebP, Calendário Editorial & Disparo WhatsApp
Com os criativos prontos, as imagens são renderizadas em alta resolução e convertidas em .webp no ArmazenamentoService. O operador pode fazer download imediato ou agendar a publicação no Calendário Editorial, com disparo automático para grupos ou contatos de clientes via WhatsApp Business Gateway.
💡 Governança de Mídias WebP & Franquia de IA
Todas as peças gráficas são geradas e catalogadas sob a custódia do ArmazenamentoService no escopo produtos da empresa usuária, garantindo arquivos compactados em WebP sem consumo desnecessário de disco. O consumo de tokens dos modelos generativos de texto e imagem é debitado no ledger mensal e conta com trava de segurança em Configurações > Parametrizações > Governança de I.A. via switch ia_agente_mhax_social_studio_ativo.
Artigo 23.5

Simulador de Custo de Importação & Câmbio — Landed Cost & Cascata Tributária

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Landed Cost Importação (Rota direta: /plugins/importacao_landed_cost/dashboard)

O Simulador de Custo de Importação & Câmbio (Landed Cost) é a estação técnica de comércio exterior do MhSys OS. Desenvolvido para empresas usuárias que importam matérias-primas, equipamentos ou produtos acabados, o aplicativo permite calcular o **Custo Real Nacionalizado (Landed Cost)** antes mesmo do fechamento de câmbio ou do embarque da mercadoria no porto de origem.

O simulador executa a complexa cascata tributária aduaneira brasileira (VA $\rightarrow$ II $\rightarrow$ IPI $\rightarrow$ PIS-Importação $\rightarrow$ COFINS-Importação $\rightarrow$ ICMS com cálculo por dentro), suporta múltiplos Incoterms (FOB, CIF, EXW, CFR) e distribui os custos internacionais (frete marítimo/aéreo, seguro de carga, AFRMM - 8%, taxas portuárias e honorários de despachante) proporcionalmente entre os itens pelo valor ou peso líquido. A versão recente adiciona o **Copiloto Aduaneiro Mhax IA** para análise de incentivos fiscais estaduais e exportação de Dossiê Executivo em PDF e planilha analítica Excel (.xlsx).

Câmbio & Moedas
USD, EUR, CNY
Conversão PTAX e trava
Cascata Tributária
ICMS Por Dentro
II, IPI, PIS, COFINS
Copiloto IA
Otimização Fiscal
Benefícios por UF desembaraço
Dossiê & Excel
Landed Cost Unit.
Exportação PDF e XLSX

Roteiro de Simulação Aduaneira Passo a Passo

1
Parametrização da Operação, Moeda & Incoterm
O operador seleciona o Incoterm negociado com o fornecedor estrangeiro (FOB, CIF, EXW ou CFR), a moeda de faturamento (Dólar Americano USD, Euro EUR ou Renminbi Chinês CNY) e a taxa de câmbio projetada para a data de registro da Declaração de Importação (DI/DUIMP).
2
Lançamento dos Itens & Rateio de Despesas Internacionais
Inclusão dos produtos com código NCM, quantidade e preço unitário internacional (com suporte a itens do catálogo ou insumos inéditos com cálculo de margem líquida sem necessidade de pré-cadastro). São lançadas as despesas globais: frete internacional, seguro, taxas de terminal portuário, capatazia, honorários aduaneiros e taxa AFRMM (8%).
3
Cálculo Automático da Cascata Tributária & Orientação do Copiloto IA
O simulador calcula o Valor Aduaneiro (VA), o Imposto de Importação (II), o IPI, o PIS/COFINS-Importação e o ICMS por dentro, majorando a base tributária estadual com exatidão conforme a alíquota da UF de desembaraço aduaneiro. O Copiloto Mhax IA avalia regimes aduaneiros especiais e benefícios estaduais de ICMS para otimização de margem.
4
Emissão do Dossiê Executivo (PDF/XLSX) & Atualização no ERP
O sistema projeta o Custo Unitário Final em Reais (R$), o fator multiplicador aduaneiro (mark-up de importação) e gera a exportação analítica em PDF A4 e planilha Excel (.xlsx). Com 1 clique, atualiza o custo de reposição nos cadastros de estoque do ERP e arquiva a Proforma Invoice e packing list.
💡 Governança Fiduciária, Armazenamento & Tokens IA
Faturas comerciais (Commercial Invoice), conhecimentos de transporte marítimo/aéreo (Bill of Lading / AWB), extratos de DI/DUIMP e comprovantes são arquivados no ArmazenamentoService com isolamento por organização. As orientações aduaneiras do Copiloto IA são governadas pelo parâmetro ia_agente_importacao_landed_cost_ativo em Configurações > Parametrizações > Governança de I.A., garantindo total controle orçamentário sobre o consumo de tokens.
Artigo 23.6

Torre de Controle & Entregas Last-Mile — Roteirização, Comprovante Mobile & WhatsApp

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Torre de Entregas Last-Mile (Rota direta: /plugins/torre_entregas_lastmile/dashboard)

A Torre de Controle & Entregas Last-Mile é o centro operacional de logística urbana e expedição própria do MhSys OS. Desenvolvida para lojistas, distribuidores e fábricas que realizam entregas com frota própria, veículos utilitários ou motoboys terceirizados, a ferramenta elimina planilhas manuais e canhotos de papel perdidos, conectando o faturamento do ERP diretamente à mão do motorista na rua.

O aplicativo lê de forma desacoplada os pedidos de venda faturados, monta romaneios otimizados por região geográfica com auxílio do **Copiloto Logístico Mhax IA**, gera o **Manifesto de Carga A4 Oficial** para fiscalização e impressão de balcão, disponibiliza rotas instantâneas para Waze / Google Maps e oferece um **Link Mobile Tokenizado sem Login** para o entregador colher a assinatura na tela por Canvas touch, fotografar o comprovante em WebP, gerenciar **Cobranças na Entrega (COD - Cash on Delivery)** com conferência de caixa e disparar notificações com timeline de rastreio em tempo real para o cliente via WhatsApp.

Romaneios A4
Manifesto Oficial
Agrupamento por zona/CEP
Link Tokenizado
Zero App Store
Acesso mobile sem login
Acerto COD
Cobrança na Entrega
Dinheiro, Pix e maquininha
Rastreio Público
Timeline WhatsApp
Aviso com comprovante

Ciclo de Expedição, Entrega de Última Milha & Acerto de Contas

1
Montagem do Romaneio de Carga, Otimização de Paradas & Manifesto A4
Na central de expedição, o operador seleciona os pedidos faturados do dia e os vincula a um motorista ou veículo. O Copiloto Logístico Mhax IA sugere o agrupamento de paradas por bairro/CEP e identifica endereços incompletos antes da saída do veículo. É emitido o Manifesto de Carga A4 com código de barras para fiscalização rodoviária e conferência física dos volumes.
2
Despacho do Link Mobile com Acesso Direto para o Entregador
Ao liberar o romaneio, o sistema gera um link web protegido por token criptográfico temporário enviado diretamente ao smartphone do motorista via WhatsApp ou QR Code no painel de expedição, permitindo operação instantânea no navegador sem download de aplicativo ou login com senha.
3
Navegação GPS, Assinatura na Tela & Recebimento COD (Cobrança no Destino)
O motorista aciona a rota no Waze ou Google Maps com 1 toque. No destino, se o pedido exigir pagamento na entrega (COD), o entregador registra o recebimento (dinheiro, Pix ou cartão). Em seguida, colhe a assinatura digital do recebedor na tela touch (Canvas HTML5) e fotografa o canhoto ou o pacote entregue.
4
Baixa Imediata no ERP, Acerto de Caixa do Motorista & Notificação ao Cliente
O envio do comprovante sincroniza com o ERP, mudando o status da entrega para Entregue com geolocalização e data/hora. O sistema alimenta o módulo de conferência de caixa (acerto de valores COD arrecadados pelo motorista) e dispara notificação automática no WhatsApp do cliente com link do comprovante digital.
💡 Governança de Comprovantes via ArmazenamentoService & Copiloto IA
As assinaturas colhidas em tela e as fotos dos comprovantes são submetidas ao ArmazenamentoService, onde são sanitizadas, compactadas e gravadas no formato otimizado .webp no diretório restrito da organização. As análises de otimização de rotas e alertas de endereço do Copiloto IA são governadas pelo switch ia_agente_torre_entregas_ativo em Configurações > Parametrizações > Governança de I.A., garantindo que o módulo de entrega continue 100% operacional mesmo com IA desligada.
Artigo 23.7

Pesquisa de Clima, NPS & Ouvidoria Anônima — Escuta Ativa & Governança ESG

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Termômetro NPS & Ouvidoria (Rota direta: /plugins/termometro_nps_clima/dashboard)

O aplicativo Pesquisa de Clima, NPS & Ouvidoria Anônima é a solução integrada de escuta ativa e governança corporativa do MhSys OS. Desenvolvido para atender pilares fundamentais de gestão de qualidade e compliance ESG, o aplicativo atua em duas frentes estratégicas complementares: **Experiência do Cliente (NPS)** e **Gestão de Pessoas (Clima Organizacional e Ouvidoria Anônima)**.

Para o cliente externo, monitora a satisfação no pós-venda e pós-serviço com disparo automático via WhatsApp e QR Codes em balcões. Internamente, oferece aos colaboradores um canal seguro de pesquisa de clima e ouvidoria anônima sob o protocolo **Zero-Trace LGPD** (com rate-limit anti-spam e blindagem Anti-IDOR), acompanhado de classificação cognitiva de sentimentos por inteligência artificial com Nuvem de Termos e Matriz de Sentimento.

NPS (-100 a +100)
Termômetro Cliente
Promotores e neutros
Alerta Reativo
Detratores (0–6)
Resgate imediato SAC
Ouvidoria LGPD
Zero-Trace Real
Anti-Spam & Anti-IDOR
Sentimento IA
Nuvem de Termos
Tendências e plano de ação

Operação de NPS, Clima Organizacional & Ouvidoria

1
Disparo Automático de NPS no Pós-Venda ou Conclusão de OS
Assim que uma venda é faturada ou uma Ordem de Serviço é entregue, o sistema dispara a pesquisa com pergunta padrão ("Em uma escala de 0 a 10, o quanto você recomendaria nossa empresa para um amigo ou colega?") via WhatsApp ou e-mail, registrando a resposta de forma imediata.
2
Painel de Retenção & Resgate de Clientes Detratores
Notas de 0 a 6 disparam alertas visuais imediatos no painel de SAC com notificação no dock, viabilizando o contato da gerência para reversão da insatisfação antes de eventuais cancelamentos ou reclamações em órgãos de defesa do consumidor.
3
Pesquisas de Clima Interno & Canal de Ouvidoria Segura
A equipe interna responde a questionários periódicos anônimos para avaliar liderança, infraestrutura e ambiente de trabalho. Para denúncias sensíveis, a ouvidoria gera um protocolo criptográfico anônimo para acompanhamento com proteção anti-spam por IP sem gravar dados de identificação pessoal.
4
Classificação de Sentimentos, Nuvem de Termos & Relatório Executivo por IA
O motor cognitivo categoriza automaticamente os comentários abertos em sentimentos (Positivo, Neutro ou Negativo), projeta a Nuvem de Termos com as palavras mais citadas e elabora um relatório executivo com recomendações práticas para a liderança.
💡 Blindagem LGPD Zero-Trace, Anti-IDOR & Governança de Tokens IA
O canal de ouvidoria foi projetado sob o princípio de Privacy by Design: o banco de dados não armazena endereço IP, agente de navegação (User-Agent) ou credencial de usuário na submissão de relatos anônimos, com rigorosa validação Anti-IDOR de isolamento entre organizações. A análise semântica de sentimento consome tokens de IA auditados no ledger da organização e pode ser gerenciada em Configurações > Parametrizações > Governança de I.A. via chave ia_agente_termometro_nps_ativo.
Artigo 23.8

Orçamentista CPQ Pro — Configurador Paramétrico & Propostas Interativas

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Orçamentista CPQ Pro (Rota direta: /plugins/orcamentista_cpq_pro/dashboard)

O Orçamentista CPQ Pro é a plataforma de orçamentação técnica paramétrica (Configure, Price, Quote - CPQ) desenvolvida para indústrias de transformação, marcenarias, fábricas de esquadrias, serralherias, gráficas e prestadores de serviços técnicos sob medida. O aplicativo substitui planilhas de cálculo manuais e propostas estáticas em papel por uma experiência visual moderna e colaborativa.

O motor do CPQ interpreta variáveis dimensionais (largura, altura, profundidade, m², m³) através de um interpretador de fórmulas seguro (sem uso de eval()), consulta custos reais de insumos e matérias-primas no estoque do ERP e gera um **Link Web Interativo** para o cliente final, que pode visualizar fotos/renders, selecionar opcionais e assinar o aceite da proposta com apenas 1 clique, convertendo o orçamento automaticamente em Pedido de Venda ou Ordem de Serviço.

Fórmulas Seguras
Cálculo Paramétrico
Zero eval(), 100% isolado
Custos do Core
Estoque em Tempo Real
Insumos e matéria-prima
Link Web Interativo
Opcionais Ativos
Cliente personaliza online
1-Click Approve
Gera Pedido / OS
Reserva insumos no ERP

Ciclo de Configuração, Proposta & Fechamento

1
Configuração Técnica & Alimentação das Medidas do Projeto
O vendedor insere os parâmetros do item sob medida (comprimento, largura, espessura, acabamento e ferragens). As fórmulas de engenharia calculam automaticamente o consumo de insumos, horas de mão de obra e perdas industriais, buscando os preços de custo diretamente no estoque.
2
Composição de Opcionais & Margem Comercial
São adicionados itens complementares opcionais (ex.: iluminação em LED, amortecedores especiais, garantia estendida, pintura premium), cada um com seu valor unitário e descrição visual.
3
Compartilhamento da Proposta Web Interativa com o Cliente
O sistema gera um link web moderno e responsivo enviado pelo WhatsApp. Ao abrir no celular ou computador, o cliente final navega pelos renders do projeto, ativa ou desativa opcionais com recálculo automático do valor total e confere os prazos e condições de pagamento.
4
Aceite Online com 1 Clique & Conversão em Pedido de Venda ou OS
Ao clicar em Aprovar Orçamento, o aceite com assinatura eletrônica e carimbo de IP/horário é gravado com validade jurídica. O MhSys OS cria de forma atômica o Pedido de Venda ou a Ordem de Serviço com a Lista de Materiais (BOM), reservando os insumos no almoxarifado.
💡 Governança de Renders, Plantas & Blindagem de Fórmulas Matemáticas
Croquis, renders 3D, projetos em PDF e especificações técnicas são armazenados com controle de cota via ArmazenamentoService. O analisador léxico de fórmulas matemáticas opera em ambiente estritamente seguro, sem executar funções dinâmicas do sistema operacional e prevenindo vulnerabilidades de injeção de código.
Artigo 23.9

Gestor de Frotas, Combustível & Manutenção Preventiva — Cockpit Operacional

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Gestor de Frotas Pro (Rota direta: /plugins/gestor_frotas_pro/dashboard)

O Gestor de Frotas, Combustível & Manutenção Preventiva é o aplicativo corporativo de telemetria e controle de ativos automotivos do MhSys OS. Desenvolvido para empresas usuárias que possuem veículos de transporte, caminhões, utilitários leves ou frotas de representantes comerciais, o aplicativo proporciona controle rigoroso sobre os custos de rodagem e saúde mecânica dos veículos.

A ferramenta consolida o cadastro detalhado de cada veículo (placa, Renavam, motorista e odômetro atual), calcula automaticamente as médias reais de rendimento de combustível (km/L e R$/km), detecta anomalias de consumo, aciona um semáforo de alertas preventivos por quilometragem e tempo e gera lançamentos diretos no Contas a Pagar do módulo Financeiro do ERP.

Combustível
Média Real km/L
Custo real por km rodado
Semáforo Alertas
Manutenção Prev.
Por quilômetro e data
CRLV & Apólices
Cofre Digital
Documentos e seguros
Contas a Pagar
Integração Core
Títulos gerados por placa

Rotina Operacional de Gestão Veicular & Manutenção

1
Inventário dos Veículos & Planos de Manutenção Preventiva
Cadastro dos veículos da frota com placa, número do Renavam, chassi, motorista habitual e quilometragem de partida. São definidos os planos de revisão preventiva (ex.: troca de óleo/filtros a cada 10.000 km ou 6 meses; rodízio de pneus a cada 15.000 km; revisão de freios a cada 20.000 km).
2
Registro Rápido de Abastecimentos com Validação de Odômetro
Ao abastecer, o motorista ou operador lança o posto, quantidade de litros, tipo de combustível e odômetro atual. O motor valida a consistência do KM, apura a média real em km/L e sinaliza variações de consumo anômalas (ex.: desvios superiores a 20% da média histórica).
3
Monitoramento Preventivo pelo Semáforo de Cores
O gestor visualiza no cockpit o semáforo de cada veículo: Verde (manutenções em dia), Amarelo (alerta de proximidade - menos de 1.000 km ou 15 dias para a revisão) e Vermelho (manutenção vencida), agendando a parada com antecedência e evitando quebras graves.
4
Lançamento Automático no Financeiro & Apuração de Custo por KM
Os abastecimentos e ordens de serviço mecânicas geram títulos integrados no Contas a Pagar do ERP, devidamente classificados por placa, fornecedor e centro de custo, permitindo apurar com exatidão o Custo Total de Propriedade (TCO) de cada veículo.
💡 Arquivo Seguro de Documentos & Auditoria via ArmazenamentoService
CRLV digital, laudos de vistoria, fotos de cupons fiscais e apólices de seguro são armazenados com isolamento através do ArmazenamentoService. O cruzamento financeiro garante que todo centavo gasto com combustível ou oficinas seja atribuído à placa correspondente no plano de contas, permitindo auditorias financeiras e controle de frota sem retrabalho.
Artigo 23.10

Monitor de Concorrência & Inteligência de Preços Web IA — Estratégia Competitiva

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Monitor de Preços IA (Rota direta: /plugins/monitor_precos_ia/dashboard)

O Monitor de Concorrência & Inteligência de Preços Web IA é o agente sentinela de mercado do MhSys OS. Desenvolvido para empresas usuárias do varejo físico, atacado e comércio eletrônico que precisam monitorar oscilações de preços praticados por concorrentes em lojas virtuais públicas e marketplaces, o aplicativo automatiza o trabalho de pesquisa manual de preços sem colocar em risco a infraestrutura da organização.

O coletor web é 100% blindado contra ataques SSRF (Server-Side Request Forgery), armazena a curva histórica de preços da concorrência e aciona um motor de recomendação por Inteligência Artificial que calcula a precificação ótima para o catálogo da loja, sempre respeitando rigorosamente o custo de reposição, tributação e a margem de lucro mínima cadastrada no ERP.

Blindagem Anti-SSRF
Zero Rede Interna
Bloqueio de IPs privados
Curva Histórica
Histórico de Preços
Monitoramento contínuo
Recomendação IA
Margem Protegida
Custo mínimo assegurado
1-Click Update
Aplica no Catálogo
Sincroniza PDV e loja

Ciclo de Monitoramento de Preços & Reprecificação

1
Mapeamento de Itens & Cadastro de URLs Públicas Concorrentes
O operador vincula o item do catálogo do ERP aos links públicos dos sites ou marketplaces de concorrentes a serem monitorados, definindo a frequência da varredura e a margem de lucro mínima admitida para o produto.
2
Coleta Segura com Blindagem Anti-SSRF em Sandbox
O robô coleta periodicamente o preço à vista e a prazo exibido nas páginas monitoradas. Todas as requisições passam por validação estrita de rede: qualquer URL apontando para endereços IP privados (RFC 1918), instâncias de nuvem ou portas internas é abortada sumariamente antes da abertura de conexão.
3
Análise Competitiva de Mercado & Recomendação por IA
O motor cognitivo compara os preços coletados com o preço de venda atual e o custo de compra do ERP. Se o concorrente baixar o preço, a IA calcula se sua loja pode cobrir a oferta mantendo a margem de lucro ou se recomenda preservar o preço para resguardar a rentabilidade.
4
Aplicação do Reajuste no Catálogo Geral com 1 Clique
Na listagem de sugestões, o gestor pode aprovar as alterações individualmente ou em lote com o botão Aplicar no Catálogo. O preço de venda é imediatamente atualizado na tabela do ERP, sincronizando em tempo real com o PDV, e-commerce e ordens de venda.
💡 Governança SecOps Anti-SSRF & Tokens de IA
O coletor opera sob sandboxing estrito com bloqueio absoluto de loopback e redes internas locais. A inteligência de precificação é auditada no livro-razão de tokens da organização e conta com trava individual em Configurações > Parametrizações > Governança de I.A. via parâmetro ia_agente_monitor_precos_ativo.
Artigo 23.11

Portal do Contador & Fechamento Fiscal — Cofre Digital de XMLs & Auditoria

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Portal do Contador (Rota direta: /plugins/portal_contador_cofre/dashboard)

O Portal do Contador & Fechamento Fiscal é o cofre digital autônomo de autoatendimento contábil do MhSys OS. Desenvolvido para eliminar as cobranças mensais do escritório de contabilidade e mitigar riscos de multas por entrega intempestiva de documentos fiscais, o aplicativo automatiza o fechamento fiscal por competência mensal (MM/AAAA).

A ferramenta reúne e valida todos os documentos emitidos (NF-e modelo 55, NFC-e modelo 65, NFS-e Nacional) e XMLs de entrada com verificação de saltos de numeração fiscal. Em seguida, gera um pacote compactado oficial (.ZIP) e cria um **Link Externo com Cofre Seguro (Token + Senha/OTP)** onde o contador faz o download independente dos arquivos sem ocupar uma licença de usuário do sistema.

Consolidação
NF-e, NFC-e, NFS-e
Competência MM/AAAA
Checklist Fiscal
Zero Saltos SEFAZ
Detecção de quebra de série
Token + OTP
Cofre Externo
Zero consumo de licença
Trilha Forense
Auditoria de Log
IP, data e hora de download

Rotina de Fechamento Fiscal Mensal & Liberação do Cofre

1
Seleção da Competência & Diagnóstico Pré-Fechamento
O operador escolhe o mês fiscal a ser fechado (ex.: 10/2026). O motor executa uma auditoria preventiva em busca de notas pendentes de autorização na SEFAZ, documentos em contingência não transmitidos ou saltos de numeração de notas fiscais.
2
Geração do Pacote Compactado ZIP Oficial
Com o checklist aprovado, o sistema compacta todos os arquivos XML válidos em subpastas organizadas (NFe_Autorizadas, NFCe_Emitidas, NFSe_Servicos e XMLs_Entrada), gerando um arquivo compactado único acompanhado do resumo de faturamento contábil.
3
Liberação do Link Externo Protegido por Token e OTP
O operador gera o link do Cofre Fiscal e o envia ao contador por WhatsApp ou e-mail. Para acessar os arquivos, o contador clica no link, informa a senha de segurança e valida o código de uso único (OTP) enviado aos contatos cadastrados da contabilidade.
4
Download Autônomo & Registro da Trilha de Auditoria
O escritório contábil realiza o download do pacote oficial diretamente para o seu software de escrita fiscal. O MhSys OS registra carimbo de data, horário exato, endereço IP e confirmação de entrega do pacote fiscal, garantindo conformidade probatória.
💡 Governança de Storage & Segurança Fiduciária no Cofre
Os pacotes mensais são compactados e armazenados com controle de versão via ArmazenamentoService. O acesso externo do contador opera sob link tokenizado seguro com validade configurável, sem conceder acesso administrativo ao banco de dados do ERP e sem computar no limite de usuários contratados do plano.
Artigo 23.12

Treinamento & Onboarding de Equipe com IA — Universidade Corporativa & Quizzes

AppStore Avulso • Workspace OS
Caminho de Acesso: Menu Principal > Ferramentas > Central de Aplicativos (@Apps) > Universidade Corporativa IA (Rota direta: /plugins/universidade_corporativa_ia/dashboard)

A Universidade Corporativa IA é a plataforma interna de treinamento contínuo, onboarding de novos colaboradores e nivelamento operacional do MhSys OS. Desenvolvida para resolver o desafio crônico de capacitação e retenção de procedimentos operacionais nas empresas usuárias, o aplicativo transforma documentos densos (POPs, manuais de atendimento e normas internas) em trilhas de aprendizagem interativas com quizzes e certificação digital.

Apoiado por modelos de inteligência artificial, o gestor faz o upload dos manuais em PDF, e o assistente cognitivo estrutura automaticamente o material em módulos de leitura acessíveis, formula questionários de múltipla escolha com gabarito pedagógico comentado, monitora o progresso dos colaboradores e emite certificados oficiais de conclusão com autenticação digital.

Ingestão POPs
Manuais & PDFs
Upload seguro de normas
Quizzes com IA
Testes Interativos
Gabarito com explicação
Painel RH
Métricas de Equipe
Progresso e taxa de acerto
Certificação PDF
Selo Criptográfico
Validação via QR Code

Fluxo de Capacitação, Avaliação & Certificação

1
Upload do Material Técnico & Documentos de Procedimento
O gestor faz o upload de Procedimentos Operacionais Padrão (POPs), manuais de produtos ou regras de conduta interna em formato PDF através do formulário oficial de ingestão documental.
2
Estruturação Didática de Módulos & Elaboração de Quizzes com IA
A inteligência artificial processa o documento, sintetiza o conteúdo em tópicos objetivos de leitura rápida e gera automaticamente perguntas avaliativas de múltipla escolha com gabarito fundamentado no texto original.
3
Execução da Trilha pelo Colaborador no Workspace OS
O colaborador acessa a Universidade Corporativa em janela multitarefa do Workspace, lê os módulos da trilha e responde ao quiz de fixação, recebendo feedback imediato sobre seus acertos e orientações para revisão de pontos divergentes.
4
Auditoria de Conclusão pelo RH & Emissão do Certificado Oficial
Ao atingir a nota mínima de aprovação estabelecida pela empresa, o colaborador emite instantaneamente seu Certificado de Conclusão em PDF com código hash e QR Code de verificação, enquanto o painel do RH consolida os índices de capacitação e retenção da organização.
💡 Governança de Arquivos PDF & Tokens de IA
Todos os manuais, apostilas e certificados emitidos são armazenados de forma segura sob o motor ArmazenamentoService no escopo da empresa usuária. O processamento didático e a formulação de quizzes por IA consomem tokens mensais auditados no razão do plano, contando com chave mestre de governança em Configurações > Parametrizações > Governança de I.A. através do parâmetro ia_agente_universidade_corporativa_ativo.

Central de Ajuda, Suporte Técnico & Níveis de SLA

Atendimento consultivo, triagem inteligente de tickets por IA e acompanhamento em tempo real.

Caminho de Acesso: Menu Superior > Central de Suporte & Ajuda (Rota: /suporte)

A Central de Ajuda MhSys garante transparência e agilidade na resolução de solicitações de suporte através de triagem autônoma por inteligência artificial com 4 categorias de priorização:

Categoria do Chamado Prazo Máximo de Resolução (SLA) Triagem & Mecanismo de Ação
Dúvida / Orientação SLA 24 Horas Triagem e resposta imediata com artigos e tutoriais da base de conhecimento da IA
Sugestão de Melhoria Evolução Contínua Análise pela equipe de produto para incorporação nos próximos ciclos de release
Problema Parcial SLA 6 Horas Inconsistência pontual sem parada operacional; atendimento com prioridade técnica intermediária
Bloqueio / Crítico (P1/P2) SLA 1 a 4 Horas Setor parado ou impedimento de emissão fiscal; intervenção emergencial de engenharia

Assistente IA Mhax & Especialistas de Domínio Contextual

Co-piloto cognitivo multimodal com adaptação dinâmica de personas especializadas e sentinela de autocura.

Caminho de Acesso: Workspace OS > Mascote Mhax Flutuante (canto inferior direito) ou Menu Superior > Ícone Mhax Copilot (Atalho global: F8)

O Mhax é o assistente virtual de inteligência artificial nativo do MhSys Enterprise OS. Desenvolvido para atuar como um verdadeiro copiloto operacional e consultor de negócios no dia a dia da sua empresa, o Mhax possui a capacidade exclusiva de adaptação contextual automática: ele identifica a tela em que você está trabalhando e assume instantaneamente o modo e a persona do especialista mais qualificado para a sua demanda.

Como Funciona a Adaptação Contextual do Mhax

Você não precisa se preocupar em configurar parâmetros complexos ou trocar manualmente de ferramenta. O Mhax atua de forma transparente em duas modalidades complementares:

1. Reconhecimento Automático por Tela / Rota

Ao abrir o chat em uma tela de Notas Fiscais, o Mhax já inicia pronto para conferir tributações e resolver rejeições. Em telas de Importação, ele ativa o modo de migração de planilhas. Tudo de forma automática e integrada ao fluxo de trabalho.

2. Acionamento por Comandos Rápidos (/comando)

Você pode digitar comandos diretos com barra no campo de digitação (ex.: /checklist-fiscal, /iniciar-onboarding, /mapear-layout) ou simplesmente clicar nos Chips de Ações Sugeridas exibidos abaixo das respostas.

Modos de Especialistas Disponíveis para Usuários e Empresas

Os clientes e operadores do MhSys OS contam com os seguintes perfis especializados diretamente integrados ao Mhax:

Modo do Especialista Comandos Chave Escopo de Atendimento Exemplo de Pergunta
Mhax • Suporte & Implantação
Atendimento Base
/iniciar-onboarding
/implantar-estoque-pcp
/configurar-financeiro
Acolhimento, configuração de dados cadastrais, estruturação de contas e jornadas de implantação em 5 passos. "Como configuro minha conta bancária e categorias financeiras para começar a lançar?"
Mhax • Especialista Fiscal & SPED
Tributário & SEFAZ
/checklist-fiscal
/diagnosticar-rejeicao
/fechamento-sped
/auditar-pva
Emissão de NF-e (mod. 55), NFC-e (mod. 65), NFS-e Nacional, Central do Contador & SPED Fiscal (/fiscal/sped), Pré-Validador PVA, Bloco H/K, Pacote Mensal (.zip), CFOP, NCM e CRT. "Como faço a auditoria Pré-PVA e envio o pacote mensal de XMLs e SPED para o meu contador?"
Mhax • Engenheiro de Dados & Migração
Importação & ETL
/mapear-layout
/auditar-planilha
/plano-migracao
Estruturação de arquivos CSV/Excel para importação de clientes, fornecedores, produtos e saldos sem conflito de dados. "Quais são as colunas obrigatórias para importar minha planilha de produtos do sistema antigo?"
Mhax • Consultor de Manuais & Menus
Documentação Oficial
/ajuda
Navegação guiada
Localização imediata de telas, explicação de botões, permissões de usuários e procedimentos do Manual Oficial do ERP. "Onde fica a tela de conferência de espelho de ponto dos colaboradores?"

Sentinela de Autocura (Self-Healing Engine SRE v3)

Além de atuar como co-piloto de atendimento, o Mhax opera nos bastidores como um sentinela de autocura e resiliência. O motor de telemetria monitora a estabilidade das operações do sistema e, caso ocorra alguma inconsistência momentânea em rotinas críticas, executa protocolos preventivos para restabelecer a integridade operacional com zero intervenção manual.

💡 Governança de Tokens & Privacidade de Dados da Empresa
O uso do assistente Mhax consome a franquia mensal de tokens de inteligência artificial incluída no plano de assinatura da sua empresa. Você pode acompanhar o saldo em tempo real no cabeçalho da gaveta do Mhax ou no menu Configurações > Parametrizações > Inteligência Artificial. Todas as interações ocorrem sob estrito isolamento corporativo entre empresas: os dados cadastrais e financeiros da sua empresa permanecem 100% seguros e nunca são compartilhados ou utilizados para treinamento de modelos de terceiros.
Acesso Restrito

Manual Oficial MhSys ERP

Informe seus dados comerciais para liberar o manual completo por 24 horas gratuitas ou digite sua credencial recebida no WhatsApp.