Origem dos dados

O módulo lê a sua planilha de fluxo de caixa sem nunca modificá-la. Rode uma vez a importação; quando editar o Excel, clique em Atualizar para reler.

Ou enviar o arquivo (funciona também na nuvem)

Se o sistema estiver rodando na nuvem (VPS), ele não enxerga a sua pasta do OneDrive — aí você envia o arquivo por aqui. Nada é alterado no seu arquivo original.

🛍️ Conecte a Shopee para ver as vendas

A Shopee ainda não está conectada. Vá em ⚙️ Config. (no canal Shopee) para conectar sua loja e as vendas com margem líquida aparecem aqui, igual ao Mercado Livre.

❤️ Conecte a Shopee para ver a Saúde da Conta

Depois de conectar a Shopee em ⚙️ Config., aqui aparece a nota da loja, tempo de preparo, cancelamentos e todas as métricas de desempenho — como no Mercado Turbo.

1. Conectar a Shopee

Para o sistema ler suas vendas, a Shopee exige uma aplicação de desenvolvedor (grátis) na Shopee Open Platform — é diferente do Seller Centre onde você vende. Lá você cria um app e recebe um Partner ID e uma Partner Key. Cadastre como URL de redirect: http://localhost:3344/callback-shopee. (Posso te guiar nesse cadastro pelo navegador, é rápido.)

2. Custos e impostos

A Shopee usa os mesmos custos do Tiny ERP e os mesmos parâmetros (imposto, etc.) que você já configurou no Mercado Livre — o SKU do anúncio Shopee é casado com o código do produto no Tiny.

1. Conectar o Mercado Livre

Crie uma aplicação (grátis) em developers.mercadolivre.com.br → Suas integrações → Criar aplicação. Na URI de redirect cadastre: http://localhost:3344/callback (se não aceitar, use https://localhost/callback e ajuste abaixo). Marque as permissões read, write e offline_access.

2. Conectar o Tiny ERP (Olist)

No Tiny: Configurações → geral → Token API (API v2) → gere/copie o token e cole aqui. É dele que vêm os custos dos produtos (preço de custo), casados pelo SKU do anúncio = código do produto no Tiny.

3. Seus parâmetros de cálculo

Usados em todos os cálculos de margem líquida.

4. Segurança e testes

Modo teste: enquanto ligado, o botão "Ativar selecionados" apenas simula — nada é enviado ao Mercado Livre. Desligue só depois de validar os números. Toda ação (real ou simulada) fica registrada no histórico da aba Promoções.

Trocar a sua senha (desconecta suas sessões abertas):

5. 👥 Usuários da equipe

Cada colaborador tem seu próprio login. Administrador pode tudo; Colaborador vê vendas, produtos e promoções — e você concede permissões extras (ativar promoções, alterar configurações) nos interruptores abaixo, valendo na hora. Toda ação fica registrada no histórico com o nome de quem fez.

No catálogo, vários vendedores disputam o mesmo anúncio. Aqui você vê quem está ganhando, o preço necessário para ganhar e até onde dá para descer mantendo a margem mínima (configurável na ⚙️). O desconto é aplicado como promoção "desconto por porcentagem" — o preço original do anúncio não muda. Anúncios em campanha co-participada mostram 🎁 e a margem já soma o que o ML devolve por venda (reduções de tarifa da campanha não são somadas — a margem real pode ser um pouco maior).
A caixa de compra não é só preço: Full, frete grátis, entrega rápida e parcelamento (as "vantagens" ⚔️) pesam na decisão do ML. Um rival mais caro pode estar ganhando por essas vantagens — nesses casos o "preço p/ ganhar" é o que desbancaria as vantagens só no preço (pode parecer baixo demais); muitas vezes vale mais ativar a vantagem que falta (⚡) do que baixar o preço. O link 👥 vendedores mostra a lista ordenada por preço (não é a ordem da caixa de compra); o vencedor real aparece no botão Comprar do link 🛒 buy box.

Registro de todas as ativações e remoções feitas pelo sistema (inclusive simulações do modo teste).