/api/v1 Produtos e imagens
Criar, editar e excluir produtos por código, com variantes e categorias. Subir e remover fotos.
GET · POST productsPUT · DELETE products/{code}POST products/{code}/images AGENTES DE IA · API ABERTA
ChatGPT, Claude ou Gemini no comando da sua loja atacadista
Conecte seu assistente de IA à API e peça, no seu idioma, o que hoje você faz à mão no painel: cadastrar produtos, subir uma lista de preços, revisar os pedidos do dia, bloquear um inadimplente. Tudo o que a API permite, sua IA faz por você.
Funciona com qualquer IA que fale REST ou MCP · Token Bearer · 20 minutos para a primeira conexão Como funciona
Sua IA já sabe falar com uma API. Só faltavam as chaves.
A API aberta da loja expõe o mesmo que você vê no painel. Um agente de IA lê essa referência como um manual, transforma seu pedido nas chamadas corretas e mostra o resultado. Você entra com a voz; a IA, com as mãos.
1
Você pede no seu idioma
«Suba 8% a lista Atacado B em Limpeza e me mostre a tabela antes.» Sem planilhas, sem menus, sem exportar nada.
2
A IA chama a API
Ela lê os 142 produtos da categoria, monta a tabela «antes → depois», espera o seu OK e grava os preços novos por lista e variante.
3
A loja muda na hora
Seus clientes já veem o preço novo. A IA deixa o resumo: o que mudou, quantos registros, o que ficou pendente.
Não confundir com o Vendedor IA, que atende seus clientes dentro da loja, nem com o assistente de suporte do painel. Isto é a sua própria IA, a que você já usa todo dia, operando o negócio de fora pela API.
Tudo o que a API permite
O que sua IA pode gerenciar na loja
Cada cartão é um recurso da API. Abaixo, um exemplo do que você pediria à IA.
Preços por lista
Ler e gravar o preço de cada produto e variante em cada lista de atacado, sem mexer nas outras.
GET · PUT products/{code}/pricesGET · POST price-listsPedidos
Listar e ler cada pedido com itens, totais, pagamento e envio. Anular e deixar notas internas. Os pedidos nascem no carrinho: a IA não os inventa.
GET ordersGET · PUT orders/{id}Clientes
Cadastrar compradores, editar dados e situação fiscal, atribuir lista e bloquear. Não são excluídos: o histórico fica.
GET · POST customersGET · PUT customers/{id}Categorias
Criar, renomear, aninhar, ordenar e ocultar categorias. A árvore do catálogo, organizada por uma IA que a entende.
GET · POST categoriesPUT · DELETE categories/{id}Relatórios e rotinas
Cruzar pedidos, clientes e catálogo para montar o relatório que hoje você faz à mão, e deixá-lo rodando sozinho toda semana.
GET orders · customers · productsReferência completa de endpoints, parâmetros e limites na página da API e na central de ajuda.
Com qualquer IA
A IA que você já usa, pela via que for mais cômoda
Todas chegam à mesma API. A única coisa que muda é a tomada.
Um agente com terminal
Roda no seu computador e chama a API direto. Você deixa o token em uma variável, passa a referência e pede. Sem programar nada.
- Claude Code
- Codex CLI
- Gemini CLI
- GitHub Copilot
- Cursor
- Windsurf
Um conector MCP
Para operar pelo Claude, ChatGPT, Gemini ou Copilot: uma ponte MCP expõe os endpoints como ferramentas. A própria IA escreve em minutos a partir da referência.
- Claude
- ChatGPT
- Gemini
- Copilot Studio
- Le Chat
- VS Code
Um GPT ou agente com ações
Um «Operador da loja» que qualquer pessoa da equipe usa pelo ChatGPT ou Microsoft 365 Copilot, com um esquema OpenAPI e o token como autenticação.
- GPT personalizado
- Copilot Studio
- Microsoft 365 Copilot
Automações e SDK
Para o que precisa rodar sozinho: um gatilho, um nó HTTP para a API e um nó de IA que resume ou decide. Ou o SDK do provedor que preferir, modelos abertos incluídos.
- n8n
- Make
- Zapier
- Power Automate
- Anthropic · OpenAI · Google · Mistral
- Llama · DeepSeek · Qwen
Um dia com a IA na loja
O que antes era uma hora de painel, agora é uma frase
Que pedidos entraram ontem à noite, de quem e por quanto? Marque os que não têm pagamento.
A IA lista os pedidos, cruza o status de pagamento e devolve a tabela com totais por cliente.
GET ordersGET customers/{id}Chegou a lista nova do fornecedor. Atualize custos e suba 6% a lista Atacado A nesses 80 códigos.
A IA lê a planilha, monta a tabela antes → depois, espera o seu OK e grava os preços.
GET products/{code}PUT products/{code}/pricesCadastre os 300 produtos novos da planilha, com fotos. Se o código existir, atualize.
A IA separa novos de existentes, diz quantos de cada e cadastra em lotes respeitando o limite da API.
POST productsPOST products/{code}/imagesEstes 12 clientes têm dívida vencida. Bloqueie e deixe o motivo e a data na ficha.
A IA encontra cada cliente pelo e-mail, confirma a lista com você e bloqueia um por um.
GET customersPUT customers/{id}O pedido 8842 retiram na quinta e o 8843 vai com o frete de sempre. Deixe anotado.
A IA grava as notas internas em cada pedido, assinadas com quem pediu.
PUT orders/{id}Resumo semanal: pedidos por cliente, ticket médio, produtos sem estoque e clientes que não compraram em 60 dias.
A automação consulta a API, a IA redige o relatório e ele chega pelo WhatsApp antes de você abrir o painel.
GET ordersGET productsGET customers Como gerenciar
Com as chaves da loja, mas com regras claras
Uma IA conectada à API tem o mesmo poder que um administrador. Seis regras a transformam no funcionário mais caprichoso que você já teve.
- Leitura primeiroNa primeira semana, só consultas e relatórios. As escritas, quando confiar em como ela entende sua loja.
- Confirmação antes de escreverToda mudança é anunciada e espera o seu OK. Em lotes grandes, tabela prévia com o antes e o depois.
- O token não viaja pelo chatEle vive em uma variável de ambiente, na ponte MCP ou na configuração do GPT. É a chave mestra do negócio.
- Respeite os limites120 chamadas por minuto, páginas de 100, corpos de até 5 MB. A IA pagina, espera e tenta de novo sozinha.
- O que a API não deixa, não acontecePedidos não são criados pela API e clientes não são excluídos: dois limites de desenho que contêm qualquer erro.
- Encerre com resumoO que mudou, quantos registros, o que ficou pendente. Nos pedidos, as notas internas deixam o rastro.
O que você precisa
Três coisas, e a primeira conexão sai em 20 minutos
A IA você escolhe. O resto está no painel ou nós ativamos para você.
- A API ativa na sua conta. É um serviço adicional; hoje está disponível para negócios da Argentina e nós o ativamos pelo suporte. Se você está em outro país, fale conosco.
- Um token Bearer, gerado em Configuração → ERP → API Token. Aparece uma única vez e você guarda como uma senha mestra.
- A IA que você já usa: Claude, ChatGPT, Gemini, Copilot, Cursor ou uma automação. O guia tem o passo a passo de cada uma.
Perguntas frequentes
O que todo mundo pergunta antes de conectar sua IA
Com qual IA funciona?+
Com qualquer uma que consiga chamar uma API REST ou conectar-se a um servidor MCP: Claude e Claude Code, ChatGPT e Codex, Gemini e Gemini CLI, Microsoft Copilot e GitHub Copilot, Grok, Mistral, DeepSeek, modelos abertos como Llama ou Qwen, editores como Cursor e plataformas como n8n, Make ou Zapier. A API fala JSON sobre HTTPS com um token Bearer, o formato que todas entendem.
Preciso saber programar?+
Não. Com um agente com terminal (Claude Code, Codex, Gemini CLI, Copilot) basta dar o token como variável de ambiente e o link da referência. Se uma via precisar de código, como a ponte MCP ou o esquema OpenAPI, a própria IA escreve.
O que ela pode e não pode fazer?+
Pode tudo o que a API permite: produtos e imagens, preços por lista, categorias, listas de preços, clientes (cadastro, edição, bloqueio) e pedidos (leitura, anulação, notas internas). Não cria pedidos, porque nascem no carrinho ou no painel onde preços e descontos são calculados, e não exclui clientes: bloqueia.
É seguro dar acesso à loja?+
Tão seguro quanto você for com o token: ele vive fora do chat, em uma variável de ambiente ou no conector, e a IA trabalha com regras (leitura primeiro, confirmação antes de escrever, resumo ao encerrar). Cada token tem seu limite de frequência, pedidos não são criados pela API e clientes não são excluídos. Se achar que o token vazou, o suporte gera um novo.
Existe um conector MCP oficial?+
Ainda não. Hoje o caminho é a API REST: os agentes com terminal a usam direto, e para os apps de chat levanta-se uma ponte MCP que a própria IA escreve em minutos a partir da referência. O guia explica como.
Quanto custa?+
A API é um serviço adicional do seu plano VendasxAtacado; a IA você paga ao provedor como já faz. Não há cobrança por chamada nem por volume da API: o limite é de frequência, 120 chamadas por minuto por token.
Comece hoje
Entregue as chaves da sua loja à IA que você já usa
Ativamos a API, revisamos sua primeira conexão e deixamos as regras prontas para a sua equipe.