REST plano e previsível
Endpoints com verbos HTTP claros, JSON nos dois sentidos, datas ISO e códigos de erro consistentes. O que seu backend espera de uma API séria.
Novo · API aberta
Sua loja conversa com tudo o mais.
Uma API REST de verdade conecta seu portal atacadista com seu ERP, seu CRM, sua ferramenta de BI ou aquele app sob medida que você mandou fazer. Pedidos, estoque, clientes e SKUs viajam nos dois sentidos com um token Bearer — e um console deixa você testar cada endpoint sem abrir o Postman.
Para o negócio que já tem sistemas
Seu portal não é uma ilha
Você já tem um ERP que fatura, um CRM que acompanha seus vendedores e talvez um painel de BI onde vê tudo. A loja atacadista precisa conversar com eles, não viver à parte. A API aberta dá à sua equipe técnica uma porta REST padrão para ler e escrever o que importa — sem exportações manuais nem planilhas que se atropelam.
O console de API
Teste cada endpoint sem abrir o Postman
Dentro do painel, em Configuração → ERP, há um console que executa chamadas reais contra os endpoints de integração. Sua equipe cola o token, preenche os parâmetros, aperta Enviar e vê a resposta com o código HTTP colorido e o JSON formatado. Sem cURL, sem ferramentas externas.
- Chamadas reais, não simuladas: o console bate nos seus endpoints de verdade. Teste com um negócio de teste antes de conectar o ERP de produção.
- Resumo de início: URL base, fluxo de autenticação, formato de datas e códigos de erro, com os passos sugeridos para começar.
- Status HTTP à vista: verde para 2xx, vermelho para 4xx/5xx, e o corpo JSON formatado e copiável.
- cURL pronto para copiar: cada endpoint traz seu exemplo de cURL — a forma mais rápida de levar a integração para um script ou um job agendado.
Sincronização em duas vias
O ERP lê pedidos e escreve estoque. Sem planilhas.
O padrão de sempre: seu sistema baixa os pedidos novos, os fatura e os marca como sincronizados; depois empurra o estoque e os preços de volta para a loja. Cada peça é um endpoint claro, e o ciclo se mantém sozinho enquanto seu job roda.
- Baixa por data de corte: peça só os pedidos novos desde a última execução. Sem trazer tudo toda vez.
- Feche o ciclo: ao marcar um pedido como sincronizado, ele sai dos pendentes — a lista não cresce ao infinito.
- Estoque de alta frequência: o endpoint de estoque aguenta execuções seguidas, com limites por tamanho de lote para que nada seja rejeitado.
- Preços e conta corrente: atualize a lista de preços atribuída e o saldo de cada cliente atacadista a partir do seu ERP.
Autenticação
Um token Bearer, e pronto
Cada chamada viaja com um token Bearer que identifica seu negócio. Você o gera nas configurações, envia no header Authorization e o console o guarda no navegador para você não precisar colá-lo em cada teste. Simples para começar, seguro para produção.
- Um header e nada mais:
Authorization: Bearer …em cada request. Sem OAuth de três passos nem assinaturas complicadas. - Gire quando quiser: se suspeitar que um token vazou, gere um novo e o antigo para de funcionar.
- Limite por token: cada token tem seu próprio limite de frequência, para uma integração não atropelar as outras.
- Só para admins: o console e os tokens vivem no painel de administração, não na loja pública.
Os endpoints
Tudo o que sua integração precisa tocar
POST
register
Registra um comprador atacadista ou um vendedor a partir de um sistema externo — replique o cadastro que você já faz no seu ERP.
GET
pending-orders
Lista os pedidos pendentes de sincronizar a partir de uma data de corte, para o ERP baixá-los e processá-los localmente.
POST
order-synced
Marca um pedido como já sincronizado no ERP, com um identificador externo e o tipo de comprovante opcionais.
POST
stock-update
Envia atualizações de estoque do ERP: um lote de SKUs com sua quantidade disponível. O de uso mais frequente.
POST
customers
Atualiza dados de compradores: saldo de conta corrente, lista de preços atribuída e condições especiais.
GET
skus
Baixa os códigos SKU da plataforma para conciliá-los com os do seu ERP.
POST
update-skus
Envia um lote de SKUs com seus preços e dados associados do ERP para a loja.
POST
orders
Cria um pedido em nome de um cliente existente — com seus preços, descontos e impostos calculados pelo mesmo motor da loja.
Feita para sua equipe técnica
Uma API que não briga com você
Token Bearer
Um token por negócio, no header de cada chamada. Gire quando quiser e cada um leva seu próprio limite de frequência.
Lotes em JSON
Estoque, SKUs e clientes vão em lotes: um array JSON com a estrutura esperada e o exemplo de cada endpoint como modelo.
cURL em cada endpoint
No rodapé de cada endpoint há um cURL pronto para copiar — a forma mais rápida de levar a integração para um script ou um cron.
Sandbox antes da produção
Teste com dados reais em um negócio de teste e valide a estrutura dos lotes antes de plugar o ERP de produção.
Pedidos com o motor real
Criar um pedido pela API passa pelo mesmo motor de preços, descontos e impostos da loja. Sem preços inventados por request.
O ciclo não trava
Marque cada pedido como sincronizado e ele sai dos pendentes. A lista fica curta, sem duplicados acumulando.
Documentada por dentro
O próprio console é a referência viva: resumo, parâmetros e resposta de cada endpoint, sempre em dia com o que a API faz de verdade.
Conecte o que você já tem
Plugue seu portal atacadista no resto da sua operação
Dê à sua equipe técnica a API e o console para conectar seu ERP, seu CRM ou seu app sob medida — e pare de mover dados à mão.