Primeiros passos — Integração ERP / backend

Primeiros passos — Integração ERP / backend

Este guia é para quem vai sincronizar dados entre Wake Commerce e sistemas externos: ERP, OMS, WMS ou qualquer plataforma de gestão.


O que você vai precisar

  • Acesso ao painel administrativo da loja para gerar o token
  • Uma ferramenta para testar requisições HTTP (ex: Postman, Insomnia)
  • Servidor ou serviço capaz de receber requisições HTTPS (para Webhooks)

Passo 1 — Gerar o token da API Pública

Toda requisição à API Pública precisa de autenticação via token. O token é gerado no painel administrativo e vinculado a um responsável técnico.


Passo 2 — Fazer a primeira requisição

Com o token em mãos, teste a conexão consultando a listagem de produtos. Isso confirma que a autenticação está correta antes de avançar.

GET /api/catalog/products
Authorization: Bearer {seu_token}

Passo 3 — Entender paginação e limites

A API Pública usa paginação em todas as listagens e tem limites de requisições por minuto. Ignorar isso causa erros em sincronizações em massa.


Passo 4 — Configurar Webhooks

Em vez de consultar a API periodicamente para saber se algo mudou, configure Webhooks para receber notificações em tempo real quando pedidos, produtos ou usuários forem alterados.


Passo 5 — Mapear os fluxos da sua integração

Com autenticação e Webhooks funcionando, mapeie os fluxos que sua integração precisa cobrir. Os mais comuns são:

FluxoRecursos da API
Sincronizar catálogo do ERP para WakeProduto → Inserir / Atualizar produto
Receber pedidos no ERPPedido → Consultando listagem de pedidos + Webhook de Pedido
Atualizar status de pedidoPedido → Atualizando a situação de um pedido
Controlar estoqueProduto → Atualizando o estoque de vários produtos

Próximos tópicos recomendados