3D Touch · Apresentação
Onde estão as revendas que compram xTool no Brasil, o que cada uma comprou e como o mercado se distribui por região.
O Mapa de Revendas é o painel da 3D Touch que coloca cada revenda como um ponto no mapa do Brasil, no endereço real dela, com tudo o que ela comprou da 3D Touch em 2025 e 2026, produto a produto. Embaixo do mapa, um resumo mostra quanto cada região representa e quais são as maiores revendas.
Os dados vêm direto do sistema de gestão (ERP) da 3D Touch: só entra venda faturada, com nota fiscal. Não é estimativa nem cadastro — é o que foi realmente vendido. O acesso da xTool mostra exclusivamente os produtos xTool (máquinas, acessórios e consumíveis); o restante do portfólio da 3D Touch não aparece nesse login.
| Item | Detalhe |
|---|---|
| Endereço | mapa-revendas-production.up.railway.app — funciona em qualquer navegador, computador ou celular. Não precisa instalar nada. |
| Login | Usuário claudio e a senha entregue pessoalmente pelo Diego. É um acesso individual: não compartilhe. Pra trocar a senha, é só pedir. |
| O que esse acesso mostra | Só revendas e produtos xTool. Uma revenda que nunca comprou xTool não aparece no mapa desse login. |
| O que esse acesso não mostra | Impressoras 3D, filamentos e as demais linhas da 3D Touch. |
| Atualizar dados | O botão no canto superior direito busca as vendas mais recentes no sistema da 3D Touch. Leva alguns minutos; a tela avisa quando terminar e a data no cabeçalho muda. |
| Período dos dados | De 01/01/2025 até a data da última atualização, que aparece no cabeçalho do painel. |
As telas abaixo são reproduções do painel, com os números apontando o que olhar em cada uma. Nomes, cidades e valores são de exemplo. Quer só o significado de um campo? Vá direto ao dicionário de campos.
Acesso restrito — 3D Touch
claudio. É ele que define o que o painel mostra — com esse usuário, só xTool.Errar a senha 5 vezes bloqueia novas tentativas por 10 minutos. O botão Sair, no canto superior direito, encerra o acesso.
Assim que entra, o painel abre já recortado em xTool, com o mapa ajustado pra mostrar todas as revendas:
Como a xTool entrou no portfólio da 3D Touch recentemente, é normal a maioria dos pontos estar azul hoje: são revendas cuja primeira compra xTool foi em 2026.
Role a roda do mouse sobre o mapa pra aproximar. Revendas no mesmo endereço aparecem lado a lado quando você aproxima o zoom — de longe parecem um ponto só. Passar o mouse sobre um ponto mostra o nome e a cidade.
Clique em qualquer círculo. Abre a ficha da revenda, com o detalhe produto a produto:
| 3Produto | Un. 2025 | Un. 2026 | Total R$ |
|---|---|---|---|
| XTOOL F2 ULTRA | 0 | 1 | R$ 31.700 |
| XTOOL SAFETYPRO AP2 | 0 | 2 | R$ 12.300 |
| XTOOL S1 40W | 0 | 1 | R$ 9.850 |
| ANEXO ROTATIVO XTOOL | 0 | 3 | R$ 5.250 |
| XTOOL SELECTED TINTA… | 0 | 12 | R$ 3.300 |
Passe o mouse sobre um nome de produto cortado pra ver a descrição completa. A lista rola se tiver muitos itens.
SP) ou CNPJ. Filtra enquanto digita.Digitar uma sigla de estado é a forma mais rápida de responder "quanto a xTool vendeu em SP?": o resumo de baixo recalcula na hora só com aquele estado.
Abaixo do mapa, o painel consolida o que está visível (respeitando busca e filtros):
| 2Região | Revendas | 2025 | 2026 | Variação | Participação |
|---|---|---|---|---|---|
| Sudeste | 2 | R$ 0 | R$ 238.700 | novo | 73,7% |
| Sul | 4 | R$ 0 | R$ 85.300 | novo | 26,3% |
| # | 3Revenda | Cidade/UF | 2025 | 2026 | Variação | Última compra |
|---|---|---|---|---|---|---|
| 1 | REVENDA EXEMPLO LTDA | Campinas/SP | R$ 0 | R$ 197.700 | novo | 22/07/2026 |
| 2 | SEGUNDA REVENDA EXEMPLO | São Paulo/SP | R$ 0 | R$ 41.000 | novo | 22/07/2026 |
| 3 | REVENDA EXEMPLO DO VALE LTDA | Blumenau/SC | R$ 0 | R$ 39.200 | novo | 30/06/2026 |
Tudo aqui obedece à busca e aos filtros de cima: digitou PR, o resumo vira "Paraná"; escolheu Unidades, as colunas mostram unidades.
Dicionário de tudo o que aparece na tela, área por área. Onde diz "no período", é sempre de 01/01/2025 até a data da última atualização.
| Campo | O que é |
|---|---|
| Usuário | Seu nome de acesso (claudio). Não diferencia maiúsculas; espaços nas pontas são ignorados. |
| Senha | Sua senha individual. O ícone de olho mostra/esconde o que foi digitado. |
| Entrar | Valida usuário e senha. O acesso vale por 12 horas na mesma aba. |
| Campo | O que é |
|---|---|
| 01/01/2025 a DD/MM/AAAA | Período coberto pelos dados. A data final é a da última atualização — não é "hoje" automaticamente. |
| N revendas que compram xTool | Quantas revendas (CNPJs distintos) têm pelo menos uma nota fiscal com produto xTool no período. |
| Claudio (xTool) · xTool | Quem está logado e o recorte fixo do acesso. Tudo na tela obedece a esse recorte. |
| Atualizado em | Data e hora da última carga de dados a partir do sistema da 3D Touch. |
| Atualizar dados | Dispara uma carga nova (alguns minutos). O texto do botão vai mostrando a etapa; ao terminar, a tela recarrega e avisa quantas notas, itens e revendas foram lidos. |
| Sair | Encerra o acesso e volta pra tela de entrada. |
| Campo | O que é |
|---|---|
| Buscar revenda, cidade, UF ou CNPJ | Um campo só. Casa com parte do nome da revenda, parte do nome da cidade, a sigla exata do estado (SP, PR…) ou 3+ dígitos do CNPJ. Filtra o mapa e todo o resumo enquanto digita. |
| Sugestões (lista abaixo do campo) | Até 12 revendas que casam com a busca: nome, cidade/UF e o valor de 2026. Clicar dá zoom no ponto e abre a ficha. |
| Todas | Sem filtro de recorrência. |
| Recorrentes (11+) | Revendas com 11 ou mais compras (notas com xTool) no período. |
| Ocasionais (2–10) | Revendas com 2 a 10 compras no período. |
| Compra única | Revendas com exatamente 1 compra no período. |
| Faturamento | Métrica em reais (valor dos itens xTool nas notas de venda). Sem centavos. |
| Unidades | Métrica em quantidade de peças vendidas. Troca o que aparece nos círculos, cards e tabelas. |
| X de Y · "termo" ✕ | Aparece quando há busca ou recorrência ativa: X revendas visíveis de Y no total. O ✕ limpa os dois filtros. |
| Elemento | O que é |
|---|---|
| Círculo | Uma revenda, no endereço de cadastro (sede). Passar o mouse mostra "nome — cidade/UF"; clicar abre a ficha. |
| Tamanho do círculo | Proporcional ao volume total (2025 + 2026) na métrica escolhida. O maior da tela é o maior comprador do que está visível. |
| Cor azul | Revenda nova: tem compra em 2026 e nenhuma em 2025 até a mesma data. |
| Cor verde | Crescendo: 2026 está mais de 2% acima de 2025 no mesmo período. |
| Cor vermelha | Caindo: 2026 está mais de 2% abaixo de 2025 no mesmo período. |
| Cor cinza | Estável: variação entre −2% e +2%. |
| Círculos em anel | Revendas no mesmo endereço (mesmo CEP). De longe parecem um ponto; aproximando o zoom, cada uma vira um círculo clicável. |
| + / − | Zoom. A roda do mouse também funciona. Ao trocar filtro, o mapa reenquadra sozinho. |
| Campo | O que é |
|---|---|
| Nome | Razão social da revenda, como está no cadastro da 3D Touch. |
| Cidade/UF | Cidade e estado do endereço de cadastro. |
| CNPJ | Cadastro da empresa. Só empresas entram no mapa. |
| N compras | Quantas notas fiscais com produto xTool a revenda recebeu no período. Uma nota com 5 itens conta 1. |
| última em | Data da nota fiscal mais recente com produto xTool. |
| 2025 (ano todo) | Total em reais de xTool nas notas de 01/01 a 31/12/2025. |
| 2026 (até hoje) | Total em reais de xTool nas notas de 01/01/2026 até a data da última atualização. |
| vs. 2025 mesmo período | Variação percentual de 2026 contra 2025 só até a mesma data (ex.: 10/09). "novo" = não havia compra em 2025 nesse trecho. |
| Produto | Descrição do produto no cadastro da 3D Touch, cortada em 34 caracteres. Passe o mouse pra ver completa. Só produtos xTool; produto sem unidade nos dois anos não aparece. |
| Un. 2025 | Unidades desse produto vendidas à revenda em 2025 inteiro. |
| Un. 2026 | Unidades desse produto vendidas à revenda em 2026 até a última atualização. |
| Total R$ | Valor em reais desse produto nos dois anos somados. A lista vem ordenada por esta coluna. |
| Card | O que é |
|---|---|
| (Brasil — todas · xTool) ou (filtrado: N revendas · xTool) | Escopo do resumo: tudo, ou só o que a busca/recorrência deixou visível. |
| Revendas | Quantas revendas estão no escopo. |
| 2025 (ano todo) | Soma de 2025 inteiro, na métrica escolhida (R$ ou unidades). |
| 2026 (até hoje) | Soma de 2026 até a última atualização. |
| vs. 2025 mesmo período | Variação do total, comparando com 2025 até a mesma data. |
| Sem coordenada | Só aparece se alguma revenda ainda não foi localizada no mapa. Ela conta nos totais e nas tabelas, mas não tem círculo. |
| Coluna | O que é |
|---|---|
| Região | Norte, Nordeste, Centro-Oeste, Sudeste ou Sul, pelo estado da revenda. "Sem UF" = estado não identificado no cadastro. |
| Revendas | Quantas revendas do escopo estão nessa região. |
| 2025 | Total da região em 2025 inteiro. |
| 2026 | Total da região em 2026 até a última atualização. |
| Variação | 2026 contra 2025 até a mesma data, na região. |
| Participação | Fatia da região no total de 2026 do que está visível. As linhas somam 100%. |
| Coluna | O que é |
|---|---|
| # | Posição, do maior pro menor valor de 2026 na métrica escolhida. |
| Revenda | Razão social. Clicar na linha dá zoom no círculo e abre a ficha. |
| Cidade/UF | Endereço de cadastro. |
| 2025 / 2026 | Totais da revenda em cada ano, mesma regra dos cards. |
| Variação | 2026 contra 2025 até a mesma data. |
| Última compra | Data da nota mais recente com produto xTool. |
| Mensagem | Significa |
|---|---|
| Atualizando… (alguns minutos) e etapas no botão | A carga está em andamento. Pode continuar usando o mapa; ele recarrega sozinho no fim. |
| Atualizado: N notas, N itens, N revendas. | Carga concluída. Os números são do total lido, não só de xTool. |
| Ja tem uma atualizacao em andamento. | Outra pessoa disparou antes. Espere terminar. |
| Atualização em andamento… (ao abrir a página) | Uma carga já estava rodando quando você entrou; a tela acompanha e atualiza no fim. |
| nada no filtro | Nenhuma revenda atende à busca + recorrência escolhidas. |
| sem itens (na ficha) | A revenda não tem unidade de produto xTool nos dois anos. |
| Número | Como é obtido |
|---|---|
| 2025 (ano todo) | Soma de todas as notas fiscais de venda de 01/01 a 31/12/2025. |
| 2026 (até hoje) | Soma de 01/01/2026 até a data da última atualização (no cabeçalho). |
| vs. 2025 mesmo período | Compara 2026 com 2025 só até a mesma data. "novo" = não havia compra em 2025 pra comparar. |
| Compras | Número de notas fiscais emitidas pra revenda no período que contêm produto xTool. |
| Posição no mapa | Endereço de cadastro da revenda. Uma revenda que vende pela internet pro Brasil inteiro aparece onde ela está sediada, não onde o produto foi parar. |
| Quem entra | Só empresas (CNPJ). Venda direta a pessoa física não aparece. |
| O que aparece | O que fazer |
|---|---|
| Usuario ou senha invalidos. | Confira se o usuário está escrito claudio (minúsculo, sem espaço) e digite a senha de novo — o ícone de olho ajuda. Se persistir, peça ao Diego pra redefinir a senha. |
| Muitas tentativas. Tente em 10 minutos. | Senha errada 5 vezes seguidas. Espere os 10 minutos e tente de novo. |
| Sessao expirada. Recarregue a pagina. | O acesso dura 12 horas, ou até o servidor ser reiniciado. Recarregue e entre de novo. |
| nada no filtro nas tabelas | A combinação de busca + recorrência não achou nenhuma revenda. Clique no ✕ do filtro ativo ou volte a recorrência pra "Todas". |
| Card Sem coordenada | Revenda cujo endereço ainda não foi localizado no mapa. Ela continua nos totais, na busca e no Top 15 — só não tem ponto. A equipe da 3D Touch resolve na próxima atualização. |
| Data de atualização antiga no cabeçalho | Clique em Atualizar dados e aguarde alguns minutos. Se aparecer Ja tem uma atualizacao em andamento, alguém já disparou — é só esperar a tela recarregar. |