Manual do Usuário — Tabela de Preços

Visão geral

A Tabela de Preços é o sistema comercial da SQ Química que centraliza o preço de venda de todos os produtos químicos importados, sempre recalculado a partir do custo real de importação (FOB, Imposto de Importação, despesas de porto e regime de ICMS). O sistema está no ar em tabela.sqsmart.tech.

Em vez de uma planilha atualizada à mão, o preço é calculado por uma fórmula única e auditável, e os dados fiscais chegam automaticamente da COMEX todos os dias. O time comercial consulta preços confiáveis; o administrador mantém cadastro, parâmetros e integrações.

Primeiro acesso

Abra tabela.sqsmart.tech no navegador. A tela de login oferece três ações: Entrar, Criar conta e Esqueci minha senha.

1. Criar conta: use seu e-mail corporativo @sqquimica.com e uma senha de no mínimo 6 caracteres. Só e-mails do domínio da empresa são aceitos.
2. Entrar: informe e-mail e senha cadastrados. Ao entrar, a conta começa sem acesso às telas até que um administrador defina seu papel.
3. Esqueci minha senha: gera um link de redefinição enviado ao seu e-mail.

Tema claro / escuro

No topo direito há o alternador ☀ Claro / ☾ Escuro. A escolha vale para toda a navegação e pode ser trocada a qualquer momento — inclusive neste manual, pelo botão no canto superior direito.

Papéis de acesso

O acesso é controlado por papel, definido pelo administrador. São três níveis:

O menu lateral se ajusta ao papel: o item Administração e o grupo Integrações só aparecem para o Admin.

Tabela de Preços

É a tela principal (ícone ▦). Mostra a grade de todos os produtos, uma linha por produto, com o preço recalculado ao vivo pela fórmula oficial. Cada faixa de preço deriva do preço mínimo.

Colunas da grade

Cores da Projeção Prévia

• Vermelho — projeção negativa (faltará produto).
• Laranja — projeção positiva, mas ≤ média de vendas de 3 meses (cobertura curta).
• Neutro — entre 100% e 130% da média mensal.
• Azul — ≥ 130% da média (folga), ou quando não há média de vendas.

A legenda dessas cores fica no rodapé da grade, e passar o mouse sobre a célula mostra o detalhe.

Filtros e busca

Na barra de ferramentas há busca por nome e filtros por ICMS, II, Porto e por cor da Projeção. Os valores dos filtros são carregados dinamicamente conforme os dados reais.

Editar OBS e preço manual Admin

O administrador pode digitar uma observação por produto (salva automaticamente) e fixar um preço mínimo manual quando um produto não deve seguir o cálculo. Preço manual aparece em amarelo na grade e no Excel.

A coluna OBS tem largura ampliada para caber mais texto, e ao passar o mouse sobre ela aparece uma dica com o conteúdo completo — útil quando a observação é maior que o espaço visível.

Trocar o segmento pela grade Admin novo — jul/26

Na coluna Segmento (visível só para o Admin), o seletor troca o segmento do produto sem abrir o cadastro — mesmo efeito de editar no cadastro. O preço recalcula na hora com o markup do novo segmento; as demais regras (II, ICMS, porto, faixas) não mudam e o preço mínimo manual continua valendo. O segmento é independente por tabela: um produto pode ter um segmento na Tabela de Preços (química) e outro na Tabela Cosméticos.

⬇ Baixar Excel

O botão ⬇ Baixar Excel na barra exporta todos os produtos com fórmulas vivas: custo → preço → faixas referenciam uma aba de Parâmetros, então dá para recalcular dentro do próprio Excel. O nome do arquivo traz a data, e os preços manuais saem destacados em amarelo.

Tabela Cosméticos novo — jul/26

Segunda tabela de preços, dedicada à linha de cosméticos, que convive lado a lado com a Tabela de Preços química. Abre pelo item 🧴 Tabela Cosméticos no menu lateral, logo abaixo de Tabela de Preços. A tela é idêntica à química — mesma grade, filtros, KPIs, cores da Projeção Prévia, memória de cálculo e botão ⬇ Baixar Excel (com arquivo próprio dos cosméticos) — e fica disponível também para o Vendedor, em modo consulta, com as mesmas colunas visíveis da tabela química (as colunas de custo, FOB e segmento seguem exclusivas do Admin). Só o Admin edita segmento e preço.

Produto único, preço por tabela

Um mesmo produto pode estar nas duas tabelas sem ser duplicado. É compartilhado entre elas: custo, FOB, II, NCM, códigos DBCORP, estoque, vendas e chegadas — tudo alimentado pelas mesmas integrações e pelo sync COMEX. É independente por tabela: o segmento (e, portanto, o markup e o preço) e o preço mínimo manual. Por isso o mesmo produto pode aparecer com preço diferente em cada tabela — ex.: um item ADITIVO na química pode ser ESPECIALIDADE nos cosméticos.

Trocar o segmento nos cosméticos Admin

Como na química, o Admin troca o segmento direto na grade pelo seletor da coluna Segmento. A mudança vale só para a Tabela Cosméticos — não altera o segmento nem o preço do mesmo produto na tabela química.

Quais produtos estão nos cosméticos

A carga inicial (jul/26) trouxe 59 produtos (hoje são 60, com inclusões posteriores): 22 novos no sistema (localizados no PO.CMX.001 com código DBCORP de compra) e 37 que já existiam na química. Todos passam a ser cobertos automaticamente pelo sync COMEX, integrações, backup e log de versões, sem cadastro em duplicidade.

Em quais tabelas o produto está

No Editar produto você define em quais tabelas (Química e/ou Cosméticos) o produto entra e com qual segmento em cada uma. Um produto fica sempre em pelo menos uma tabela.

Previsão Chegadas

Ícone ⛴, logo abaixo da Tabela. Mostra, por produto, as próximas chegadas em ordem cronológica — uma linha por produto com os pares Data + Kg de cada embarque. A data usada é a ETA FINAL (ou a ETA, quando não há final).

Datas que já passaram aparecem riscadas, para diferenciar o que ainda está por chegar. Há também exportação para Excel desta tela.

Cobertura & Desvios

Ícone ◔. Painel executivo que cruza a Projeção Prévia com a média de vendas de 3 meses para dizer, em meses, quanto tempo o estoque cobre a demanda. A cobertura é classificada em faixas:

A tela traz KPIs, insights automáticos, um donut de distribuição, o ranking dos 12 maiores capitais parados (estoque × custo de reposição) e tabelas de prioridade de compra e de ação comercial. Os gráficos usam Chart.js.

Carteira & Alertas

Ícone ⚑. Consolida a carteira de pedidos programados (dados da integração Programações) por representante — valor em US$, kg e número de pedidos — e dispara alertas de ruptura futura.

O alerta compara, na data de cada entrega, o saldo cumulativo (estoque + chegadas até a data − programações anteriores). Quando esse saldo fica negativo, há um conflito: um pedido está programado antes de haver produto para atendê-lo. A tabela de alertas mostra a próxima chegada de cada caso.

Inativação de Clientes novo — ago/26

Ícone ⏳. Mostra os grupos econômicos que pararam de comprar ou que estão a caminho disso, para o time agir antes de perder o cliente. Diferente das outras telas, o dado não nasce no app: é um espelho diário da planilha de inativos do Comercial (mantida pela Ana, no SharePoint em COMERCIAL/INATIVOS). O app lê essa planilha todos os dias às 6h20 e regrava a lista — ninguém precisa exportar, colar ou avisar.

A régua é de 365 dias sem comprar. A contagem não usa a data de hoje: usa a data da última nota fiscal que existe na base da planilha, mostrada no rodapé da tela. Isso evita que a lista "envelheça" sozinha num dia em que a planilha não foi alimentada.

Existe um quinto estágio na planilha, A INATIVAR (menos de 10 meses sem comprar), que não é exibido no app por decisão da Diretoria — ele inclui praticamente toda a carteira ativa e tiraria o foco do que é urgente. Ele continua na planilha e no banco; apenas não aparece na tela nem no Excel exportado.

Colunas da tela

O motivo da inativação

É o único campo que o app grava nesta tela: até 500 caracteres explicando por que o cliente parou de comprar — preço, concorrente, mudança de processo, empresa encerrada, o que for. Escreva e clique fora do campo; salva na hora.

Nas linhas de CRÍTICO, ALERTA e ATENÇÃO a célula mostra apenas —: enquanto o cliente não inativou de fato, não há motivo a declarar, e o campo ficaria virando bloco de anotação avulsa. Quem quiser anotar tratativas de um cliente em risco deve usar o CRM.

Quem vê

A aba está disponível para Admin e Vendedor, e todos veem a lista completa — não é filtrada por carteira. A intenção é justamente essa: um vendedor pode reconhecer um cliente da carteira do colega, e a coluna Representante deixa claro com quem falar. O gráfico de inativações por mês aparece só para o Admin.

Filtros e Excel

Há busca por nome do grupo (ignora acento e maiúscula) e filtros por situação e por representante; o botão Limpar filtros devolve a lista inteira e o contador ao lado mostra quantos grupos estão em tela. O ⬇ Baixar Excel exporta duas abas — Inativos, com todas as colunas mais o motivo, e Recuperações.

Recuperações

No fim da tela, o card verde lista os grupos que ficaram inativos e voltaram a comprar, com a data da compra que retomou, a compra anterior e quantos dias ficaram parados. É a contraprova do trabalho de reativação.

Qualidade do Cadastro

Ícone ✓. É a home do sistema. Reúne os KPIs de saúde do cadastro e aponta o que precisa de atenção. Entre os indicadores estão o preço mínimo mediano e o card 🔴 Em ruptura (produtos com cobertura < 1 mês) que, ao ser clicado, leva direto para Cobertura & Desvios.

A tela mostra a cobertura do cadastro: produto sem FOB não tem preço calculado — o KPI vermelho prioriza quem tem venda nos últimos 3 meses; os demais ficam em acompanhamento. Preço manual aparece como condição comercial, apenas para comparação com a fórmula. Uma linha no rodapé mostra quando cada integração foi atualizada pela última vez.

Produtos

Ícone ⬡, grupo CADASTRO. Cadastro completo do produto: nome comercial, segmento, regime fiscal, NCM, II, IPI, despesa de porto, FOB e preço manual quando aplicável. É aqui que se inclui, edita ou inativa um produto.

Busca — o campo Buscar aceita o nome comercial ou qualquer código DBCORP do produto (padrão ou filho): digitar "515" encontra o INHIBITOR IN515; "AD1211" encontra o DEA AP434 (25%). novo — jul/26

Adicional de FOB específico do produto novo — ago/26

O adicional de FOB é o valor em US$/kg somado ao FOB antes do cálculo do custo (frete, seguro e outros). Normalmente ele é um parâmetro geral — o mesmo para todos os produtos importados, definido na tela Markups & Parâmetros.

Quando um produto tem condição de compra própria, o formulário de edição permite gravar uma exceção no campo Adicional de FOB (US$/kg), logo abaixo do FOB: preenchido, ele substitui o valor geral apenas naquele produto; deixado vazio, o produto volta a seguir o padrão geral.

Custo médio de estoque — produtos sem FOB novo — jul/26

Produtos industrializados internamente (segmento INDUSTRIALIZAÇÃO) não têm FOB de importação. Para eles, o formulário de edição ganhou dois campos:

• Custo médio estoque (R$/kg) — o "Val. Custo Médio" mais recente do produto no extrato de custo médio do DBCorp, em reais. Individual por produto.
• Câmbio USD/BRL — parâmetro único do sistema: alterado em qualquer produto, vale para todos os que usam custo de estoque e recalcula os preços na hora.

Códigos DBCORP

Ícone ⬢. Cada produto tem um ou mais códigos do ERP DBCORP (indireto, embalagem/direto, amostra). Um código é marcado como default e é por ele que o sistema lê os dados fiscais e casa as integrações (vendas, estoque, chegadas, programações) que chegam por código DBCORP.

Embalagens

Ícone ▣. Cadastro das embalagens associadas aos produtos, usado nas regras comerciais e de custo. Manutenção pontual pelo administrador.

Markups & Faixas

Ícone ⚙, grupo PARÂMETROS. Define os multiplicadores que transformam custo em preço e o preço mínimo nas faixas comerciais. A tela tem dois blocos: Markups por segmento e Faixas comerciais e adicional FOB.

Markups por segmento novo — jul/26

Cada segmento tem o seu próprio markup — o multiplicador que leva o custo sem imposto ao preço final (preço final = custo sem imposto × markup do segmento). Hoje são 14 segmentos: ADITIVO, ADITIVO 1 a 8 (faixas de calibração fina do comercial, cada uma com seu markup), SUB-COMMODITIES 1 e 2, COMMODITIES, ESPECIALIDADE e INDUSTRIALIZAÇÃO — este último reúne os produtos industrializados internamente, cujo preço parte do custo médio de estoque em vez do FOB (veja "Como o preço é calculado").

• Editar um markup — altere o número do segmento e clique em Salvar e recalcular: todos os produtos daquele segmento recalculam na hora.
• + Novo segmento — pergunta o nome e o markup inicial; o segmento novo aparece imediatamente no filtro da Tabela, na tela Produtos e no cadastro/edição de produto.
• × excluir (ao lado do nome) — só é permitido se nenhum produto estiver no segmento; caso contrário, reclassifique os produtos antes.

Faixas comerciais e adicional FOB

• Adicional FOB (US$) — valor somado ao FOB antes do cálculo do custo (hoje 0,35). Vale para todos os produtos importados, salvo os que tenham um adicional específico no próprio cadastro. atualizado — ago/26
• Volume Regular — % sobre o preço mínimo (hoje 3%).
• Baixo Volume — % sobre o Volume Regular (hoje 8%).
• 3D e Fracionados — % sobre o Baixo Volume (hoje 10%).

As faixas são em cascata: cada uma acresce sobre a anterior, não sobre o preço mínimo. Alterar qualquer parâmetro aqui recalcula todos os preços da grade instantaneamente, porque a Tabela lê o cálculo ao vivo. Se outro administrador salvou a mesma tela um instante antes, o sistema avisa o conflito e recarrega os valores — refaça a alteração sobre os dados atuais.

Regime Fiscal

Ícone ⚖. Cadastro das alíquotas de ICMS (ex.: 4%, 7%, 12%) que compõem o coeficiente de imposto do custo. Cada produto aponta para um regime; o sync COMEX mapeia a coluna de ICMS da COMEX para o regime correto.

Memórias de Cálculo

Ícone ƒ. Mostra, passo a passo, como o preço de cada produto foi montado, servindo de auditoria da fórmula. A explicação cobre as duas origens de custo: produtos importados partem do FOB; produtos sem FOB partem do Custo Médio de Estoque (R$ ÷ câmbio) — do Custo Final em diante o cálculo é igual. O seletor da memória interativa lista produtos das duas tabelas (Química e Cosméticos), cada um com o segmento e o markup da respectiva tabela. Útil para explicar a formação de preço ao comercial ou à diretoria.

Calculadora de Preços

Ícone 🧮, na seção Parâmetros do menu. Simulador para avaliar rapidamente uma compra ou um preço de mercado usando exatamente a mesma fórmula da Tabela de Preços — com os parâmetros vivos do sistema (markups por segmento, regimes fiscais, adicional FOB, acréscimos das faixas e câmbio). Nenhuma simulação é gravada: a tela é um rascunho de cálculo, sem nenhum efeito sobre produtos ou preços cadastrados.

São três calculadoras independentes, uma abaixo da outra. Todas mostram a memória de cálculo passo a passo e têm botões 📋 Copiar resumo (texto pronto para colar em e-mail ou WhatsApp) e ⬇ Baixar Excel (planilha com os valores em formato numérico: 2 casas decimais em valores e markup, percentuais com 2 casas).

① Custo → Preço (Calculadora Base)

Quando usar: você recebeu uma cotação de FOB de um fornecedor — ou tem o custo médio em R$ de um produto industrializado — e quer saber o preço mínimo de venda e as faixas comerciais que a fórmula geraria. Escolha a origem do custo (FOB importado ou Custo Médio de Estoque), o II (atalhos de 0% a 20% ou valor livre), a despesa de porto (8% carga geral ou 15% classe 3), o regime ICMS e o markup (por segmento, usando o valor vigente da tabela, ou livre). O resultado traz o preço mínimo, o Net e as 4 faixas em cascata.

② Preço de mercado → Custo máximo (Cálculo Reverso)

Quando usar: você sabe o preço que o mercado aceita pagar e quer decidir se vale a pena comprar. A calculadora percorre a fórmula de trás para frente e mostra o FOB máximo (ou custo médio máximo em R$) que ainda entrega a margem escolhida — com veredicto claro: cotação do fornecedor abaixo do custo máximo, a compra fecha a conta; acima, não atinge a margem. Informe também a que faixa o preço observado corresponde (Preço Mínimo, Volume Regular, Baixo Volume ou 3D e Fracionados) e se ele é cheio (com impostos) ou Net (sem impostos) — no caso Net, a conversão usa o fator net do regime.

③ Markup Implícito

Quando usar: você tem o custo e o preço de mercado, e quer saber qual markup esse par gera. Se o markup implícito ficar acima do markup do segmento, o negócio rende mais que o padrão da tabela; abaixo, rende menos. Além do veredicto contra o segmento de referência escolhido, uma tabela mostra de uma vez em quais segmentos o negócio "caberia".

Integrações — como funcionam

O grupo INTEGRAÇÕES reúne cinco atualizações por upload (Excel ou CSV, marcadas com o selo EXT). Todas seguem o mesmo fluxo em três passos:

1. Selecionar o arquivo Excel exportado do DBCORP.
2. Conferir a prévia — o sistema simula o resultado (quantos produtos, total em kg, quantos códigos reconhecidos e ignorados) sem gravar nada.
3. Confirmar e gravar — só então os dados entram e a grade é recarregada.

Abaixo do botão de seleção de arquivo, cada tela mostra em vermelho a data e a hora do último upload daquela integração — atualizada automaticamente a cada gravação.

O casamento é sempre pelo código DBCORP, somando todos os códigos-filhos de cada produto. Vendas, Estoque, Chegadas e Programações trabalham como foto: o upload substitui o valor daquela coluna (produtos ausentes no arquivo são zerados), exceto o FOB e o Custo Médio, que são incrementais.

Vendas 3 meses

Grava o total de kg vendidos nos últimos 3 meses por produto; a média mensal é esse total ÷ 3. Fonte: relatório sintético do DBCORP por cliente/item.

Arquivo esperado

• Coluna A — Item (código DBCORP).
• Coluna L — Quantidade líquida em kg (faturado − devoluções).
• Linhas de "Cliente:" e cabeçalhos são ignoradas; o mesmo código é somado entre clientes.

Amostras e produtos fora da tabela (cosméticos, etc.) são ignorados na prévia — o número de "ignorados" é normal.

Estoque

Atualiza o saldo atual em kg por produto. Fonte: relatório de saldo do DBCORP.

Arquivo esperado

• Coluna A — código DBCORP.
• Coluna G — saldo em kg.

Some por produto e arredonda sem casas decimais. Produtos ausentes no arquivo ficam com saldo zero (foto completa).

Chegadas / FOB

Um único upload grava duas coisas com comportamentos diferentes:

• Chegada (kg) — soma por produto, foto (zera ausentes). Alimenta a coluna Chegada e a tela Previsão Chegadas.
• FOB (US$/kg) — média ponderada por kg dos embarques com FOB > 0. É incremental: produto sem FOB novo mantém o atual.

Arquivo esperado (follow-up de importação)

• Coluna I — CÓD. SQ (código DBCORP).
• Coluna P — quantidade em kg.
• Coluna R — preço FOB · Coluna Q — moeda (US$).
• Datas de chegada: coluna AD (ETA FINAL) ou, na falta, AC (ETA).

Programações

Grava os pedidos programados por produto (kg) e alimenta a tela Carteira & Alertas com cliente, representante, datas e valores. Importa somente os itens com status PENDENTE.

Arquivo esperado

• Aba Itens.
• Coluna C — Status (filtra "Pendente").
• Coluna G — Cód. Item (código DBCORP).
• Coluna J — Qtde em kg.

Some por produto, arredonda sem casas e trata como foto. A grade mostra o total em "Program.".

Custo Médio — Integração Admin novo — jul/26

Atualiza o custo médio dos produtos industrializados a partir do CSV "Movimentação de Estoque Valorizada" do DBCorp. O sistema casa cada item pelo código (preferência ao INDIRETO) e usa o último "Custo Méd." maior que zero de cada item.

Incremental: quando o arquivo traz um custo (> 0), o produto é atualizado (ou incluído, se ainda não tinha); se o custo estiver zerado ou o produto não vier no arquivo, o valor atual é mantido — a integração nunca zera ninguém.

O custo médio só afeta o preço de produtos sem FOB — de qualquer segmento; na prática, principalmente os industrializados (preço = custo médio ÷ câmbio ÷ coeficiente × markup). Produtos com FOB são ignorados pela integração (nunca recebem custo médio) e seguem pelo cálculo de importação. A prévia mostra o que será atualizado/incluído/mantido e o preço mínimo calculado antes de gravar.

Como o preço é calculado

Todos os preços saem da mesma fórmula, aplicada ao vivo pelo sistema. O Imposto de Importação usado é o II com redução (real, com corte da TEC e ex-tarifário), decisão da diretoria comercial.

O markup e os percentuais das faixas vêm da tela Markups & Faixas — o markup é o do segmento do produto. Em resumo: o FOB e a despesa de porto afetam o custo (e portanto o preço); o II e o ICMS ajustam custo e imposto; o IPI é apenas exibido, não entra no preço. Estoque, vendas, chegadas e programações não mudam o preço — servem para giro, cobertura e alertas.

Produtos sem FOB — custo médio de estoque novo — jul/26

Para produtos sem FOB de importação — tipicamente os industrializados internamente (segmento INDUSTRIALIZAÇÃO, ex.: INHIBITOR IN515, INHIBITOR IN535, ETERCURE 6148J-75 e DEA AP434 25%), mas a regra vale para qualquer segmento — o custo não vem do FOB e sim do custo médio de estoque do DBCorp, em R$/kg:

Não entram adicional de FOB, II nem despesa de porto (impostos de importação) — o custo médio do DBCorp já é o custo de produção em R$. Já os impostos de venda (ICMS + PIS + COFINS) são aplicados normalmente, via coeficiente do regime, igual aos demais produtos. Na Tabela, esses produtos exibem o selo CE na coluna FOB; a Memória de Cálculo mostra o passo a passo próprio deles; e a tela Qualidade do Cadastro não os conta como pendência "sem FOB".

Atualização automática (COMEX)

Todos os dias às 6h, o sistema lê a planilha oficial da COMEX (PO.CMX.001, no SharePoint) e alinha automaticamente cinco campos fiscais de cada produto:

IINCMIPIDespesa de PortoICMS (regime)

O casamento é pelo código DBCORP default de cada produto. Só as diferenças são aplicadas, tudo fica registrado em log de auditoria, e um e-mail é enviado aos responsáveis (comercial e COMEX) com o resumo do que mudou. Como II, porto e ICMS entram no custo, o preço se ajusta sozinho quando a COMEX muda um desses valores.

Descoberta automática de códigos novo — jul/26

Além dos campos fiscais, o sync cadastra sozinho os códigos-irmãos de cada produto: se existir na planilha da COMEX um código com a mesma descrição de nota fiscal ou o mesmo agrupamento de estoque de um código já registrado (por exemplo, uma embalagem nova), ele entra automaticamente como código não-padrão, com o tipo (INDIRETO/EMBALAGEM) derivado do grupo de compra. Amostras nunca entram; um código que já pertence a outro produto nunca é alterado; e um código que casar com mais de um produto vira conflito — não é cadastrado e aparece no e-mail para decisão manual.

Administração

Item Administração (⚙) no rodapé do menu, visível apenas para administradores. Abre uma janela organizada em cinco áreas, cada uma num botão no topo: Usuários, Trocar minha senha, Log de versões, Sync COMEX e Backup.

👥 Usuários — papéis de acesso

Lista todas as contas e permite definir o papel de cada uma:

• Admin — acesso total, edição.
• Vendedor — consulta às telas de negócio (inclui Previsão de Chegadas e Cobertura & Desvios).
• Sem acesso — bloqueado (padrão de conta nova).

É aqui que se libera uma conta recém-criada. Sem essa promoção, o novo usuário não vê nenhuma tela.

🔑 Trocar minha senha

O administrador altera a senha da própria conta: digita a nova senha (mínimo 6 caracteres), confirma e salva. Passa a valer imediatamente.

📝 Log de versões

Histórico das mudanças dos campos que afetam custo e tributação — ICMS, II, FOB, NCM, IPI (e Despesa de Porto). Cada linha traz a data, a origem (Sync COMEX automático ou Upload de Chegadas/FOB), o produto, o campo e o valor de → para. Funciona como trilha de auditoria: dá para saber exatamente o que mudou, quando e de onde veio.

🔄 Sync COMEX novo — jul/26

Roda a sincronização com o PO.CMX.001 sob demanda, sem esperar o horário das 6h. O fluxo é em duas etapas: Rodar prévia agora mostra tudo o que mudaria (II, NCM, IPI, Desp. Porto, ICMS e códigos novos) sem aplicar nada; o botão ✅ Confirmar aplicação grava as mudanças e dispara o e-mail de resumo. Conflitos de código aparecem destacados na prévia.

💾 Backup

Mostra quando foi o último backup e o histórico das execuções, com o botão Rodar backup agora para gerar uma cópia sob demanda. Detalhes na seção Backup diário.

Backup diário (SharePoint)

Todo dia às 7h, o sistema gera automaticamente um backup completo e o guarda no SharePoint, na pasta do projeto em …/Tabela de Preços Comercial/_Backups/<data-hora>. Cada backup contém:

• banco_precos.json — cópia completa do banco (todos os dados de produtos, códigos, parâmetros, regimes, integrações e logs) mais a estrutura (DDL) para reconstruir tudo.
• index.html — o front publicado naquele momento.
• LEIA-ME.txt — instruções de restauração.

O Supabase mantém backup automático por 7 dias; a cópia no SharePoint é persistente, pensada para reabilitar o sistema em caso de perda. Além do backup automático das 7h, o administrador pode rodar um backup a qualquer momento pelo botão Rodar backup agora na aba Backup da Administração.

Novidades — jul/ago 2026

• Motivo da inativação só para quem inativou (17/08) — o campo de texto livre passou a aparecer apenas nas linhas com situação INATIVOU; nas de CRÍTICO, ALERTA e ATENÇÃO a célula mostra "—". A regra vale também no banco, não só na tela.
• Nova aba: Inativação de Clientes (17/08) — espelho diário (6h20) da planilha de inativos do Comercial, por grupo econômico, com os estágios INATIVOU / CRÍTICO / ALERTA / ATENÇÃO, faturamento e representante, campo de motivo da inativação, card de recuperações e export Excel. Disponível para Admin e Vendedor, com a lista completa para todos. Veja a seção Inativação de Clientes.
• Auditoria de estresse — correções (23/07) — dupla auditoria externa recalculou 100% da tabela com zero divergências. Ajustes aplicados: produto sem FOB e sem custo médio fica sem preço (antes recebia um resíduo indevido); preço mínimo manual não aceita mais zero ou negativo; exportação Excel restrita ao Admin e com as colunas Origem Custo, Custo Médio e Câmbio (fórmula correta também para origem ESTOQUE); Cobertura & Desvios deixou de exibir custos ao Vendedor; o CSV real de Custo Médio do DBCorp agora é reconhecido; o custo médio vale para qualquer produto sem FOB (não só INDUSTRIALIZAÇÃO); "Último upload" só é carimbado quando o arquivo tem itens reconhecidos.
• Data do último upload nas Integrações (23/07) — abaixo do botão de arquivo, cada integração mostra em vermelho quando foi atualizada pela última vez; a marca atualiza sozinha a cada gravação.
• Memórias de Cálculo com custo médio e Cosméticos (23/07) — a tela passa a explicar as duas origens de custo (FOB e Custo Médio de Estoque) e o seletor interativo agora lista produtos das duas tabelas (Química e Cosméticos).
• Integração de Custo Médio (22/07) — nova tela em Integrações para atualizar o custo médio dos produtos sem FOB (principalmente industrializados) pelo CSV "Movimentação de Estoque Valorizada" do DBCorp; incremental (atualiza/inclui com custo > 0, mantém se zero/ausente, nunca zera), casa por código (preferência INDIRETO). Alimenta o cálculo dos produtos sem FOB (principalmente INDUSTRIALIZAÇÃO). Veja Custo Médio.
• Tabela Cosméticos liberada ao Vendedor (23/07) — a aba 🧴 Tabela Cosméticos fica disponível também para o Vendedor, em modo consulta, com as mesmas colunas visíveis da tabela química (custo, FOB e segmento seguem exclusivos do Admin).
• Edição de segmento pela grade (22/07) — o Admin troca o segmento de um produto direto na coluna Segmento da grade, tanto na Tabela de Preços quanto na Tabela Cosméticos, sem abrir o cadastro. O preço recalcula na hora e o segmento é independente em cada tabela.
• Tabela Cosméticos (20/07) — nova tabela de preços dedicada à linha de cosméticos (🧴 no menu), com 59 produtos na carga inicial (hoje 60). O mesmo produto pode estar nas duas tabelas com segmento e preço independentes, compartilhando custo, FOB, códigos e integrações. Veja Tabela Cosméticos.
• Segmento oculto para o Vendedor (17/07) — a coluna Segmento e o card de segmentação passam a ser exclusivos do Admin; o Vendedor não vê mais a segmentação.
• Calculadora de Preços (16/07) — nova tela na seção Parâmetros (somente admin) com três simuladores que usam a fórmula oficial e os parâmetros vivos da tabela: Custo → Preço, Cálculo Reverso (preço de mercado → FOB/custo máximo de compra, com veredicto de viabilidade) e Markup Implícito (compara a margem do negócio com todos os segmentos). Seletor de preço cheio/Net, memória de cálculo passo a passo, copiar resumo e exportação em Excel. Nada é gravado. Veja Calculadora de Preços.
• Segmento INDUSTRIALIZAÇÃO + custo médio de estoque (13/07) — produtos industrializados internamente (IN515, IN535, ETERCURE 6148J-75 e DEA AP434 25%) passam a ter preço calculado pelo custo médio do DBCorp em R$ ÷ câmbio USD/BRL, sem FOB. Campos novos no Editar produto; selo CE na coluna FOB da Tabela.
• ADITIVO 8 (13/07) — novo segmento de calibração; TEOF reclassificado para ele.
• Busca por código na tela Produtos (13/07) — o campo Buscar aceita nome ou qualquer código DBCORP. Corrigido também o cabeçalho fixo que encobria a primeira linha das tabelas de cabeçalho simples.
• Markups por segmento — cada segmento tem markup próprio; foram criados os segmentos ADITIVO 1 a 7 (para calibração fina do comercial) e o admin cria/exclui segmentos direto em Markups & Faixas.
• Sync COMEX completo e sob demanda — a prévia e o e-mail mostram II, NCM, IPI, Despesa de Porto, ICMS e códigos novos; o admin roda quando quiser em Administração → Sync COMEX (prévia + confirmar).
• Descoberta automática de códigos — cadastrou o produto com o código principal, o sync completa a família (embalagens e indireto) no dia seguinte e a mantém completa dali em diante.
• Código DBCORP obrigatório no cadastro de produto novo (vira o código padrão). No Editar, o campo fica liberado quando o produto ainda não tem código.
• Lista de ignorados — código excluído na tela Códigos DBCORP não é recadastrado pelo sync; recadastrar manualmente reativa.
• Vendedor passou a ver também ICMS, IPI e OBS (16 colunas).
• Preço mínimo manual — azul quando maior ou igual ao calculado; âmbar quando abaixo, com aviso automático sobre comissão na OBS.
• 📖 Manual no sistema — este manual está no menu, para todos os usuários, sempre na versão mais recente publicada.

Perguntas frequentes

Criei minha conta e não vejo nada. Por quê?

Contas novas nascem "sem acesso". Peça a um administrador para liberar seu papel em Administração → Usuários.

Um cliente que parou de comprar não aparece na Inativação de Clientes. Por quê?

Três motivos possíveis. (1) Ele ainda está com menos de 10 meses sem comprar — é "A INATIVAR" na planilha, e essa faixa não é exibida no app. (2) A planilha do Comercial ainda não foi alimentada com as notas mais recentes: confira no rodapé da tela a data de referência da base. (3) O grupo econômico dele pode estar cadastrado com outro nome no DBCorp — nesse caso é ajuste no cadastro, não no app.

Sou vendedor — vejo Previsão de Chegadas e Cobertura & Desvios?

Sim. Essas telas (além de Tabela Cosméticos, Carteira & Alertas e Inativação de Clientes) ficam disponíveis para o Vendedor em modo consulta. Qualidade do Cadastro é exclusiva do Admin.

Mudei o FOB de um produto e o preço mudou sozinho. É esperado?

Sim. O FOB entra na fórmula de custo, então o preço mínimo recalcula na hora — e a mudança fica registrada no Log de versões.

Onde vejo o que mudou de ICMS, II, FOB, NCM ou IPI?

Em Administração → Log de versões, com data, origem (Sync COMEX ou upload), produto e valor de → para.

O backup é automático?

Sim, todo dia às 7h para o SharePoint. O admin também pode rodar sob demanda em Administração → Backup.

Por que aparecem códigos "ignorados" na prévia de uma integração?

São amostras ou produtos fora da tabela (cosméticos, etc.). É normal e não é erro.

O IPI está em branco — está errado?

Não. IPI vazio significa IPI zero legítimo. Só é preenchido quando a COMEX traz IPI > 0.

Posso editar preço ou parâmetros como Vendedor?

Não. O Vendedor consulta; edição de preço, OBS, cadastro, parâmetros, integrações, senha de terceiros e backup é do Admin.

Mudei um produto de segmento — o que muda no preço?

Só o markup. O produto passa a usar o markup do novo segmento e o preço recalcula na hora; as demais regras (II, ICMS, porto, faixas) continuam iguais. Preço mínimo manual não é afetado — continua valendo o manual. O Admin pode trocar o segmento direto na grade (coluna Segmento), sem abrir o cadastro — o efeito é o mesmo.

Qual a diferença entre a Tabela de Preços e a Tabela Cosméticos?

São duas tabelas de preço sobre o mesmo cadastro de produtos. Custo, FOB, códigos e integrações são compartilhados; o segmento (markup/preço) e o preço mínimo manual são independentes em cada tabela, então um produto pode ter preços diferentes nas duas. Veja Tabela Cosméticos.