APIs REST do Ecossistema Precode

Precode, allPost, SellerPay, HelpyGo e Portal do Seller publicam APIs REST independentes. Todas usam HTTPS e JSON, mas cada produto possui URL, autenticação, recursos e limites próprios.

Mapa das APIs

Escolha o produto responsável pelo domínio que sua integração precisa operar:

  • Precode: produtos da loja, pedidos de marketplace e ERP, fulfillment, SAC, financeiro, compras e logística.
  • allPost: cotação, pedidos de envio e reversa, PLP, transportadoras, rastreio, produtos e fila de eventos.
  • SellerPay: pedidos, ciclos de repasse, análise de comissões e fila de eventos.
  • HelpyGo: pedidos, agentes de atendimento e fila de eventos do SAC.
  • Portal do Seller: produtos, pedidos, clientes, carrinho, frete, cupons, pagamentos, SAC, webhooks e recursos da loja virtual.

URLs base e autenticação

Precode          https://www.replicade.com.br/api/v1/     Basic Auth
allPost          https://www.allpost.com.br/api/v1/      Bearer Token
SellerPay        https://www.sellerpay.com.br/api/v1/    Bearer Token
HelpyGo          https://www.helpygo.com.br/api/v1/      Bearer Token
Portal do Seller https://api.portaldoseller.com.br/v2/   Basic Auth + grand_type

Na API Precode legada, produção e homologação usam a mesma URL; a chave de autenticação define o ambiente e os acessos liberados. Consulte o guia de autenticação antes da primeira chamada.

Operações HTTP

Os contratos publicados utilizam os métodos abaixo, conforme o endpoint:

  • GET — recuperar ou listar recursos.
  • POST — criar recursos ou registrar operações.
  • PUT — atualizar recursos; no HelpyGo, PUT /pedidoNovo/ cria ou atualiza um pedido.
  • DELETE — remover recursos ou confirmar o consumo de eventos em fila.

Chamadas confirmadas

Exemplo de consulta à filial no allPost:

curl "https://www.allpost.com.br/api/v1/filial" \
  -H "Authorization: Bearer SEU_TOKEN_API" \
  -H "Content-Type: application/json"

Exemplo de listagem de produtos no Portal do Seller:

curl "https://api.portaldoseller.com.br/v2/products?page=1&size=20" \
  -u "SEU_TOKEN_DA_CHAVE:" \
  -H "grand_type: integrate"

Paginação e formatos

Não há um formato de paginação único para todo o ecossistema. O Portal do Seller usa page e size; HelpyGo documenta paginação nos endpoints de lista; allPost e SellerPay definem parâmetros e respostas em cada endpoint. Datas do allPost e SellerPay seguem YYYY-mm-dd HH:ii:ss, enquanto o HelpyGo publica datas em ISO 8601.

Limites e respostas HTTP

Os limites são definidos por método e endpoint, não por uma cota global. allPost e SellerPay contabilizam limites por minuto; o HelpyGo informa a cota em cada endpoint e pode devolver Retry-After com 429 Too Many Requests.

  • 200 — operação concluída com sucesso.
  • 400 — dados ou parâmetros inválidos.
  • 401 — credencial ausente, inválida ou revogada.
  • 403 — credencial sem permissão para o recurso.
  • 404 — endpoint ou recurso não encontrado.
  • 429 — limite excedido nas APIs modernas.
  • 5xx — falha ou indisponibilidade temporária do serviço.

A API Precode legada possui uma tabela própria: nela, limite excedido é reportado como 407, falta de parâmetros como 408 e indisponibilidade temporária como 405.

Documentação oficial

Próximos passos

Confira os exemplos por produto e os contratos de webhook antes de implementar.