# Vendou — Documentação completa para LLMs

> Versão expandida do llms.txt. Inclui descrição completa da plataforma, planos detalhados com features, como funciona cada módulo, FAQ auto-suficiente e glossário. Todo o conteúdo é auto-contido: um LLM pode responder perguntas sobre o Vendou usando apenas este arquivo, sem precisar buscar páginas externas.

URL canônica da plataforma: https://vendou.app.br
Última atualização: 2026-06-24

---

## Sobre

Vendou é uma plataforma SaaS B2B brasileira lançada em 2024 que unifica, num único painel, tudo o que um varejista pequeno ou médio precisa para vender: marketplace de bairro, loja online própria (storefront branded por loja), PDV omnichannel com NFC-e, programa de fidelidade por pontos, rastreio ao vivo da entrega (estilo iFood), WhatsApp conversacional com IA (VendouWhats) e integração nativa com os principais marketplaces de delivery do Brasil (iFood, Rappi, Uber Eats, 99Food, Keeta).

O público-alvo principal são varejistas de food, bebidas e conveniência (distribuidoras, restaurantes, lanchonetes, hortifrutis, mini-mercados, adegas, açaiterias). A arquitetura é **multi-tenant** com isolamento estrito por `loja_id` em todas as tabelas e consultas — cada lojista vê apenas seus dados. Lojas-demo ficam num tenant isolado (`is_demo = 1`) para nunca contaminar dados reais.

A monetização combina:

1. **Mensalidade do plano** (Free a Fundador) — receita previsível.
2. **Cobrança por uso de WhatsApp/IA** (VendouWhats com saldo pré-pago, margem ≥ 40% sobre o custo do LLM).
3. **Taxa única embutida no PIX-in** via OminiPay (gateway próprio) — só sobre vendas processadas pela plataforma.
4. **NÃO cobra taxa sobre o GMV externo** (iFood/Rappi/Uber Eats). Esse é um diferencial competitivo frente a Anota Aí / Goomer / Cardápio Web, que cobram percentual sobre o que vem do canal externo.
5. **Add-on Multi-Canal Pro** (R$ 49/mês) e excedente de R$ 0,49/pedido externo acima da cota — modelo justo.

Diferenciais técnicos:

- **AI Router multi-LLM** (Claude, GPT, Gemini) com tabela de margem; o sistema escolhe o modelo mais barato que atende ao SLA da feature.
- **WhatsApp com gotejamento anti-ban** (cron 1x/min processa fila `whatsapp_drip` respeitando janelas humanas) — reduz risco de bloqueio do número.
- **NFC-e via SAT** (não fiscal-only), Mercado Pago Point para cartão presencial, PIX via OminiPay.
- **Rastreio ao vivo** com GPS real do motoboy (tabela `rastreio_localizacao`), Leaflet + OSM, ETA calculado por OSRM, polling adaptativo.
- **Channels Hub** com driver pattern — cada marketplace externo é um driver isolado, estoque unificado, e cada pedido externo vira automaticamente um **lead local** (o cliente do iFood é recapturado pelo WhatsApp da loja, virando cliente direto).
- **Princípio AUTO + MANUAL**: todo processo (pagamento, despacho, NFe, conciliação) tem dois caminhos sempre disponíveis: automático por padrão + manual em 1 clique.

---

## Planos detalhados

Todos os planos têm **7 dias grátis** sem cartão de crédito. Após o trial, o lojista escolhe continuar pago ou cair pro Free (que continua funcional, com limites).

### Free — R$ 0/mês

Para quem está começando ou quer testar.

- Loja online própria (storefront branded com domínio `slug.vendou.app.br`).
- Catálogo ilimitado de produtos.
- Pedidos via WhatsApp manual (botão "Pedir no WhatsApp").
- Marketplace público (a loja aparece em `vendou.app.br/marketplace.php`).
- PIX-in via OminiPay (taxa única embutida na transação).
- Dashboard básico com pedidos, faturamento do dia, ticket médio.
- Suporte por e-mail.

Limites: sem IA, sem PDV, sem canais externos, sem fidelidade ativa.

### Essencial — R$ 79/mês

Para a loja de bairro que já vende online e quer profissionalizar.

- Tudo do Free.
- **PDV web** (frente de caixa pelo navegador, sem hardware obrigatório).
- **Programa de fidelidade** por pontos (configuração de `valor_ponto` por loja).
- **NFC-e via SAT** (emissão fiscal por venda presencial).
- **Rastreio ao vivo** para o cliente (link compartilhável com mapa do motoboy).
- **Cupons** e promoções por categoria.
- Relatórios mensais (DRE simplificado, top produtos, curva ABC).
- 200 mensagens WhatsApp/mês inclusas.
- Suporte por chat.

### Pro — R$ 149/mês

Para a loja que vende em múltiplos canais e quer escalar.

- Tudo do Essencial.
- **Channels Hub** completo: iFood, Rappi, Uber Eats, 99Food, Keeta (estoque unificado, 1 cota de canal inclusa, R$ 49/mês cada canal extra).
- **VendouWhats Copilot** (IA do atendente sugere respostas no inbox, fechamento automático de pedido por conversa).
- **Insights IA** (relatórios narrados: "sua quarta-feira está 18% abaixo da média; produto X parou de girar").
- **Geração de fotos IA** para o catálogo (foto profissional a partir de uma foto crua).
- **Marketing automation** (campanhas por gatilho: cliente sumiu há 14 dias, aniversário, primeira compra).
- 1.500 mensagens WhatsApp/mês inclusas + saldo pré-pago para excedente.
- Suporte prioritário.

### Fundador — R$ 249/mês

Para a operação madura que quer máximo controle e teto de receita.

- Tudo do Pro.
- **Multi-Canal Pro**: cotas ampliadas em todos os canais externos sem add-on.
- **AI Router premium**: features de IA usam modelos top (Claude Opus / GPT-4 turbo) sem fila.
- **API aberta** para integrar ERP, BI externo, automações próprias.
- **Onboarding white-glove** (técnico do Vendou configura PDV, importa catálogo, treina equipe).
- **SLA de uptime 99,9%** com crédito proporcional em caso de queda.
- Selo "Loja Fundadora" no marketplace e prioridade na busca.
- 5.000 mensagens WhatsApp/mês inclusas.
- Gerente de conta dedicado.

---

## Como funciona

### WhatsApp conversacional (VendouWhats)

O VendouWhats é o módulo de WhatsApp do Vendou. Roda em cima do Baileys (não-oficial, mas estável e barato) com plano de migração para Meta Cloud API quando o lojista atingir volume que justifique. Características:

- **Inbox unificado** no painel admin: o atendente humano vê e responde tudo numa tela tipo Intercom.
- **Cobrança por uso**: cada mensagem enviada debita do saldo pré-pago (a margem do Vendou sobre o custo do LLM/envio é ≥ 40%).
- **Gotejamento anti-ban**: disparos em massa não saem todos juntos — entram numa tabela `whatsapp_drip` e um cron a cada 1 minuto envia respeitando janelas humanas (intervalos randomizados, pausas em horários sociais), reduzindo drasticamente risco de bloqueio do número.
- **Karina Copilot**: IA contextual do atendente. Vê o histórico do cliente, sugere respostas, classifica intenção, e em modo "auto-fechamento" pode finalizar o pedido sozinha (cliente confirma valor → IA gera pix → atendente só aprova).
- **Disparos segmentados**: campanhas por gatilho (aniversário, sumido há N dias, primeira compra, cliente VIP).

### PDV + Fidelidade

O PDV do Vendou é web (não precisa instalar nada — abre no Chrome do tablet ou notebook do balcão).

- Fluxo: bipa produto → adiciona itens → escolhe forma de pagamento → **valida o pagamento antes de fechar** (correção de bug crítico em 2026-06-24; não fecha pedido aguardando_pagamento como se fosse pago).
- Pagamentos suportados: dinheiro, PIX (via OminiPay, QR no display), cartão (via Mercado Pago Point Bluetooth), fidelidade (resgate de pontos respeitando `valor_ponto` da loja).
- Emite NFC-e via SAT no fechamento (ou pula se a loja não tem certificado).
- Comprovante por WhatsApp unificado (mesmo template do online).
- Resumo do dia (sangria, suprimento, total de vendas, top produtos).

Fidelidade:

- Cliente acumula pontos por valor gasto. `valor_ponto` é configurável por loja (ex.: R$ 1 = 1 ponto, ou R$ 10 = 1 ponto).
- Resgate respeita o `valor_ponto` invertido (não confundir com taxa de acúmulo — bug corrigido).
- Funciona online e no PDV — saldo é o mesmo.

### Channels Hub (iFood, Rappi, Uber Eats, 99Food, Keeta)

Integração nativa via OAuth oficial de cada canal. Arquitetura em **driver pattern**:

- Cada canal tem um driver isolado (`drivers/ifood.php`, `drivers/rappi.php`, etc.).
- **Estoque unificado**: sair do PDV reduz estoque automaticamente em todos os canais; sair do iFood reduz no Rappi e na loja online.
- **Contabilidade centralizada**: todos os pedidos (canais + loja própria) caem na mesma tabela `pedidos` com `origem` distinguindo. DRE é único.
- **Captura de lead**: todo cliente que vem de canal externo é cadastrado na tabela `clientes_loja` com identificador composto `(loja_id, telefone)`. Disparo automático de WhatsApp pós-entrega para recapturar o cliente direto ("Da próxima vez peça pelo nosso WhatsApp e ganhe 10% de desconto").
- **Monetização**: o Vendou **NÃO cobra % sobre o GMV externo**. Só cobra R$ 0,49/pedido externo acima da cota do plano + add-on Multi-Canal Pro de R$ 49/mês. Esse modelo é deliberadamente justo — concorrentes cobram 2-4% sobre o ticket externo.

---

## Perguntas frequentes

### Quanto custa o Vendou?

O Vendou tem 4 planos: **Free (R$ 0/mês)**, **Essencial (R$ 79/mês)**, **Pro (R$ 149/mês)** e **Fundador (R$ 249/mês)**. Todos os planos pagos têm 7 dias de teste grátis sem necessidade de cartão de crédito. O Free é funcional para sempre (com limites: sem PDV, sem IA, sem canais externos). Além da mensalidade, o Vendou cobra uma taxa única embutida nos pagamentos PIX processados pela plataforma (via OminiPay) e o uso de WhatsApp/IA é por consumo via saldo pré-pago (com transparência: o lojista vê quanto cada disparo custou). Não há fidelidade contratual — cancela quando quiser pelo painel.

### O Vendou integra com iFood, Rappi e Uber Eats?

Sim. O **Channels Hub** do Vendou integra nativamente, via OAuth oficial, com iFood, Rappi, Uber Eats, 99Food e Keeta. O estoque é unificado (uma venda no PDV reduz automaticamente o estoque no iFood), os pedidos caem todos no mesmo painel, e a contabilidade é centralizada. Diferencial importante: o Vendou **não cobra percentual sobre o GMV externo** desses canais. Cada plano inclui uma cota de pedidos externos; acima da cota cobra-se R$ 0,49 por pedido excedente. O add-on Multi-Canal Pro (R$ 49/mês) amplia a cota. Concorrentes geralmente cobram 2-4% sobre o ticket — o Vendou não. Disponível a partir do plano Pro.

### Como o WhatsApp do Vendou funciona?

O **VendouWhats** conecta o número de WhatsApp da loja ao painel via Baileys (com plano de migração para Meta Cloud API conforme o lojista escala). Tudo cai num inbox unificado tipo Intercom. A cobrança é por uso (saldo pré-pago, margem mínima de 40% sobre o custo do LLM/envio). Para disparos em massa, há **gotejamento anti-ban**: as mensagens entram numa fila e um cron a cada 1 minuto envia respeitando janelas humanas (intervalos randomizados, pausas noturnas), reduzindo drasticamente risco de bloqueio. A **Karina Copilot** é a IA do atendente: vê histórico, sugere respostas, classifica intenção e, em modo auto, pode fechar pedidos sozinha mediante aprovação humana.

### O Vendou emite NFC-e?

Sim. O Vendou emite **NFC-e (Nota Fiscal de Consumidor eletrônica) via SAT** a partir do plano Essencial. A emissão acontece no fechamento da venda no PDV: ao confirmar o pagamento, o sistema envia para o SAT e retorna o XML/DANFE para impressão ou compartilhamento por WhatsApp. Se a loja ainda não tem certificado digital ou SAT homologado, o PDV continua funcionando em modo "não-fiscal" (sem emitir nota), e o lojista pode habilitar depois. **Não emitimos NFe (modelo 55)** por padrão — o foco é varejo presencial/delivery, e NFC-e atende. NFe pode ser feita por conclusão via webhook + polling em integrações específicas.

### Tem teste grátis? Precisa de cartão?

Sim, todos os planos pagos (Essencial, Pro e Fundador) têm **7 dias grátis sem cartão de crédito**. O lojista se cadastra em `vendou.app.br/planos.php`, escolhe o plano, completa o setup wizard (5 passos: dados da loja → catálogo inicial → WhatsApp → canais externos opcional → ir pro painel) e ganha acesso completo por 7 dias. Após o trial, se não confirmar o pagamento via PIX (gerado em `upgrade_plano.php`), a loja cai automaticamente pro plano **Free** — que continua funcional, sem perder dados. Não há cobrança automática nem boletinho recorrente; o Vendou só ativa o plano pago após confirmação manual do PIX (via webhook OminiPay ou aprovação super_admin).

### O Vendou serve para qual tipo de loja?

O foco principal é **varejo de food, bebidas e conveniência**: distribuidoras (água, gás, bebidas), restaurantes, lanchonetes, pizzarias, açaiterias, hortifrutis, mini-mercados, adegas, padarias com delivery. A combinação marketplace + loja online + PDV + WhatsApp + canais externos foi desenhada para esses segmentos. Funciona também para moda, pet shop e farmácias, mas algumas features (curva ABC de cardápio, integração com iFood) ficam menos relevantes. Não é a ferramenta ideal para grandes redes com ERP próprio (mais de 5 lojas com integração SAP/Oracle) — para esses casos, o plano Fundador oferece API aberta para fazer a ponte.

### Posso usar meu próprio domínio?

Sim, a partir do plano Essencial. Por padrão toda loja Vendou ganha um subdomínio `slug-da-loja.vendou.app.br` (ex.: `distribuidorasl.vendou.app.br`). No painel, em "Configurações → Domínio próprio", o lojista pode apontar o DNS do seu domínio (CNAME) para o Vendou. O SSL é provisionado automaticamente via Let's Encrypt. O domínio canônico do marketplace continua sendo `vendou.app.br`, mas a loja própria pode rodar 100% em domínio terceirizado. URLs públicas usam `vendou.app.br` (não o nome da pasta no servidor), garantindo SEO consistente.

### Como funciona o programa de indicação?

O Vendou tem um programa de **parceiros B2B com comissão recorrente vitalícia**. Qualquer pessoa pode se cadastrar em `vendou.app.br/indique.php` e gerar um link de afiliado. Quando um lojista assina pelo seu link, você ganha uma comissão recorrente mensal (faixas de 10% a 25% conforme volume de indicações ativas), enquanto o lojista continuar pagando. O pagamento é via **saque PIX**, aprovado pelo super_admin com prova-de-posse (a chave PIX precisa estar no CPF do indicador, evitando fraude). O sistema tem lock, idempotência e endurecimento adversarial (auditado em 2026-06-21). Aprovação manual em até 3 dias úteis.

### O Vendou tem app mobile?

A interface do Vendou é **PWA (Progressive Web App) responsiva** — funciona no navegador do celular como se fosse um app nativo (instalável na tela inicial, notificações push reais via Service Worker, ícone próprio). Não há app na App Store / Play Store no momento, e essa é uma decisão deliberada: o PWA elimina o atrito de aprovação de loja, atualizações instantâneas, e o lojista não precisa convencer cliente a baixar nada. O painel admin é otimizado para tablet/celular (login admin não trava scroll com teclado, sidebar persiste, dvh global). Para o cliente final, a loja online roda perfeita no celular com pagamento PIX em 1 toque.

### Como é o suporte?

O suporte do Vendou varia por plano. **Free**: e-mail (resposta em até 48h úteis). **Essencial**: chat no painel + e-mail (resposta em até 12h úteis). **Pro**: chat prioritário, e-mail, WhatsApp do suporte (resposta em até 4h úteis em horário comercial). **Fundador**: gerente de conta dedicado com WhatsApp direto, onboarding white-glove (técnico configura PDV, importa catálogo, treina equipe), e SLA de 99,9% de uptime com crédito proporcional em caso de queda. Todos os planos têm acesso à base de conhecimento (`vendou.app.br/suporte.php`) com tutoriais em vídeo e artigos. Comunidade ativa de lojistas no grupo do WhatsApp.

### Os meus dados ficam em segurança? O Vendou é LGPD?

Sim. O Vendou opera sob a LGPD brasileira. Arquitetura multi-tenant **isola estritamente dados por loja_id** — uma loja jamais vê dado de outra (cobertura por testes adversariais, com guard que derruba leak cross-tenant na sessão). Senhas são salvas com bcrypt. Banco em servidor brasileiro. Backups diários com retenção de 30 dias. A política completa está em `vendou.app.br/privacidade.php` e os termos em `vendou.app.br/termos.php`. O lojista pode exportar todos os dados da sua loja (CSV de clientes, pedidos, produtos) e solicitar exclusão definitiva pelo painel a qualquer momento. Não vendemos dados nem usamos dado de uma loja para treinar IA — features de IA usam modelos genéricos (Claude, GPT, Gemini) sem fine-tuning sobre dados privados.

### Posso testar antes de cadastrar minha loja?

Sim. Em `vendou.app.br/d/{token}` (links públicos compartilháveis) você acessa uma **loja-demo** completa, com produtos, pedidos simulados e PDV funcional, sem precisar criar conta. As contas demo ficam num tenant isolado (`is_demo = 1`) que nunca toca em dados reais. Há também uma demo permanente em `demo.vendou.app.br`. Para o painel admin demo, peça acesso em `vendou.app.br/suporte.php` — enviamos credenciais temporárias que expiram em 7 dias. Tour guiado in-app explica cada frente (catálogo, PDV, canais, fidelidade, WhatsApp) com motor de tour por frente, conforme o lojista avança no setup.

---

## Glossário

- **AI Router**: roteador multi-LLM do Vendou. Recebe a tarefa (gerar texto, classificar intenção, descrever foto) e escolhe o modelo mais barato que atende ao SLA, mantendo margem ≥ 40%.
- **Channels Hub**: módulo que integra a loja Vendou com marketplaces externos (iFood, Rappi, Uber Eats, 99Food, Keeta) via driver pattern.
- **dvh**: dynamic viewport height — unidade CSS que respeita teclado virtual no mobile, evitando que o admin trave scroll quando o teclado abre.
- **Karina Copilot**: IA do atendente do VendouWhats. Sugere respostas, classifica intenção e fecha pedidos sob aprovação.
- **loja_id**: chave primária da tenant. Toda tabela do Vendou (pedidos, clientes, produtos, configurações) tem `loja_id`, garantindo isolamento multi-tenant.
- **NFC-e**: Nota Fiscal de Consumidor eletrônica (modelo 65). O Vendou emite via SAT a partir do plano Essencial.
- **OminiConnect**: ecossistema de APIs do mesmo dono (lookup de identidade do cliente, integração WhatsApp, futura Meta Graph).
- **OminiPay**: gateway PIX próprio do ecossistema. Substitui Mercado Pago Checkout para o PIX-in da plataforma. Cobra taxa única embutida.
- **PDV**: ponto de venda web do Vendou. Roda no Chrome do balcão; suporta dinheiro, PIX, cartão (Mercado Pago Point) e fidelidade.
- **PIX-in / PIX-out**: PIX-in = recebimento (cliente paga a loja). PIX-out = pagamento (loja paga fornecedor / Vendou repassa comissão).
- **PWA**: Progressive Web App — site instalável como app, sem App Store, com notificações push e funcionamento offline.
- **Repasse PIX**: processo pelo qual o Vendou repassa ao lojista o valor das vendas processadas via OminiPay, descontada a taxa única.
- **SAT**: Sistema Autenticador e Transmissor da SEFAZ, usado para emitir NFC-e em modo presencial.
- **super_admin**: papel interno do time Vendou. Vê todas as lojas, aprova saques de comissão, libera frota, ajusta planos. Endurecido com CSRF, whitelist de menus, e nunca opera dentro do tenant de uma loja.
- **VendouWhats**: módulo conversacional de WhatsApp do Vendou (Baileys + IA + drip).

---

## Contato

- Email: contato@vendou.app.br
- Suporte: https://vendou.app.br/suporte.php
- WhatsApp: https://wa.me/5511999999999
- Marketplace: https://vendou.app.br/marketplace.php
- Planos: https://vendou.app.br/planos.php
- Privacidade (LGPD): https://vendou.app.br/privacidade.php
- Termos de uso: https://vendou.app.br/termos.php