O que você vai conseguir em 20 minutos
Sua IA de sempre vai poder ler e operar sua loja: produtos e fotos, preços por tabela, categorias, clientes, pedidos e carrinhos abandonados. Você pede no seu idioma («suba 8% a tabela Atacado B em Limpeza e me mostre a tabela antes») e a IA fala com a loja pela API. Você não precisa entender nada do que acontece por trás: o prompt do passo 3 explica tudo à IA.
Passo 1: ative a API e copie sua chave
- Entre no seu painel de administração com um usuário administrador e vá em Configuração → ERP.
- Em Integrações API, escolha o cartão API Token e ative o serviço. A API está incluída em todos os planos.
- Em Configuração de API Token aparece a sua chave. Clique em Copiar token (ou Baixar arquivo de token). Ali mesmo você tem o link Ver documentação da API e o botão Regenerar token caso um dia precise trocá-la.
- Anote também o endereço da sua loja, o que seus clientes veem (por exemplo
https://minhaloja.com).
Passo 2: abra uma IA que trabalhe no seu computador
O chat comum do navegador não basta: você precisa da versão da sua IA que consegue trabalhar no seu computador, porque é ela que lê a documentação, guarda a sua chave e chama a loja. Qualquer uma destas serve:
| Sua IA | O que abrir |
|---|---|
| Claude | O app do Claude para computador, aba Code. Escolha uma pasta nova (por exemplo «Minha loja») quando ele pedir. O Claude Code no terminal também serve. |
| ChatGPT | O app do ChatGPT para computador, seção Codex (incluída nos planos pagos). Escolha uma pasta nova. |
| Gemini | Gemini CLI no terminal, dentro de uma pasta nova. |
| Copilot · Cursor | Visual Studio Code com o Copilot em modo agente, ou Cursor, com uma pasta nova aberta. |
Passo 3: cole este prompt e preencha dois dados
Copie inteiro, substitua [ENDEREÇO DA SUA LOJA] e [SUA CHAVE] pelos dados do passo 1, e envie. O resto a IA faz sozinha: lê a documentação completa da API, guarda a chave, testa a conexão e conta o que pode fazer.
Quero que você opere minha loja atacadista da VendasxAtacado por meio da API dela, seguindo estes passos em ordem.
1. LER A DOCUMENTAÇÃO COMPLETA.
Abra https://admin.ventasxmayor.com/api-console (a página inicial explica a autenticação e lista todos os endpoints; cada endpoint tem a própria página com parâmetros, corpo e exemplo: abra todas). Se algo não ficar claro, complemente com https://vendasxatacado.com.br/central-de-ajuda/integ-api. Recursos disponíveis: produtos, imagens, preços por tabela, categorias, tabelas de preços, clientes, pedidos e carrinhos.
2. GUARDAR MEUS DADOS DE ACESSO.
Endereço da minha loja: [ENDEREÇO DA SUA LOJA]
Chave da API: [SUA CHAVE]
Guarde-os em um arquivo .env dentro desta pasta (VXM_URL e VXM_TOKEN) e use a chave sempre no cabeçalho "Authorization: Bearer". Não a mostre, não a repita no chat e não a envie a lugar nenhum. Os endpoints ficam sob /api/v1/ no endereço da loja.
3. TESTAR A CONEXÃO.
Faça uma leitura simples (por exemplo, os últimos 3 produtos). Se responder 401, me diga que a chave foi copiada errado. Se responder 403, me diga que a API ainda não está ativa no meu painel (Configuração → ERP). Quando funcionar, deixe em um arquivo NOTAS.md um resumo da API e anote ali a data em que você leu a documentação.
4. ME CONTAR O QUE VOCÊ PODE FAZER.
Explique em linguagem simples, sem termos técnicos, quais tarefas você pode fazer na minha loja, e peça a primeira.
5. REGRAS PERMANENTES.
- Antes de criar, modificar ou excluir qualquer coisa, me mostre exatamente o que vai mudar e espere minha confirmação.
- Em mudanças em massa, primeiro uma tabela com o antes e o depois e quantos registros afeta.
- Respeite os limites da API: traga os dados por páginas e, se for freado, espere e tente de novo; se um recurso mudou enquanto você o editava, releia antes de insistir.
- Ao terminar cada tarefa, resuma o que mudou, quantos registros e o que ficou pendente.
- A API ganha endpoints e campos novos com frequência. Ao começar a trabalhar, se passaram mais de 7 dias desde a data anotada em NOTAS.md, releia a documentação completa, atualize o NOTAS.md com a nova data e me conte quais novidades encontrou. Faça o mesmo sem esperar os 7 dias se eu pedir algo que não está nas suas notas ou se a API responder com um campo ou um erro que você não conhece.
- Fale sempre comigo em linguagem simples. Para testar: seus primeiros pedidos à IA
Comece pelas consultas (não mudam nada) e passe às mudanças quando vir que ela entende a sua loja:
- «Liste os pedidos de hoje com cliente, total e status, e marque os que não têm pagamento.»
- «Quais produtos da categoria Limpeza estão sem estoque?»
- «Compare os preços da tabela Atacado A e da B para os 50 produtos mais vendidos.»
- «Suba 8% a tabela Atacado B em Limpeza. Antes me mostre a tabela e espere meu OK.»
- «Cadastre os produtos desta planilha com as fotos. Os que já existem, atualize.»
- «Lance o pedido de sempre da Distribuidora Norte: 20 caixas do RM-204 e 10 do RM-310. Mostre o total antes de confirmar.»
- «Estes 12 clientes têm dívida vencida. Bloqueie-os e anote o motivo em cada ficha.»
Se algo falhar
- A IA diz que a chave não é válida (401). Foi copiada incompleta ou com um espaço a mais. Volte a Configuração → ERP → API Token, clique em Copiar token e passe de novo: «Esta é a chave correta, atualize».
- A IA diz que a API não está ativa (403). Falta ativar o serviço no seu painel (Configuração → ERP → API Token). Ative e peça para tentar de novo.
- A IA não consegue abrir a documentação. Peça para usar o artigo da central de ajuda (o link está no prompt) ou copie o texto do console e cole para ela.
- A IA pede permissão para instalar ou executar algo. É normal: é assim que ela trabalha na sua pasta. O que ela nunca deveria fazer é mostrar a chave na tela.
- Uma mudança não foi aplicada e a IA fala de um «conflito» (409). Alguém editou a mesma coisa no painel ao mesmo tempo. Peça para reler e tentar de novo.
Outras vias, para quando quiser mais
A via acima basta para a grande maioria. Estas são mais técnicas, e a boa notícia é que você não precisa montá-las: basta pedir à IA que você já conectou.
- Usar a loja pelo app de chat (Claude, ChatGPT, Gemini, Copilot Studio). Precisa de um conector MCP, o padrão que esses apps usam para ferramentas externas; a VendasxAtacado ainda não publica um oficial. Peça à sua IA: «Monte um servidor MCP que exponha como ferramentas os endpoints da API que você já conhece, com a chave guardada dentro, e me diga como adicioná-lo ao meu app». Depois você cola nas configurações de conectores do app (Claude: Personalizar → Conectores; ChatGPT: Apps e conectores → Modo desenvolvedor; Gemini: Apps conectados).
- Um assistente para toda a equipe (um GPT personalizado no ChatGPT ou um agente no Microsoft 365 Copilot). Precisa de uma descrição da API no formato OpenAPI. Peça à sua IA: «Gere o esquema OpenAPI da API e me explique como carregá-lo como ação com autenticação Bearer».
- Tarefas que rodam sozinhas (n8n, Make, Zapier, Power Automate, ou um programa próprio). A automação consulta a loja de tempos em tempos e uma IA resume ou decide. Peça à sua IA: «Deixe um script que toda segunda às 8 monte o resumo semanal de pedidos e me mande pelo WhatsApp». A API não envia avisos sozinha: a automação pergunta.
