Guia
Sincronizar pedidos (criar e atualizar) com a API pública do Seu Rastreio
Para quem lidera a operação e quem implementa a integração.
O POST em `/api/public/pedidos` liga o código de rastreio e o estado do pedido ao time comercial, com externalId idempotente — ou seja, a mesma chave lógica de pedido da loja, atualizada de forma segura. A partir daí, rastreio, página de loja e webhooks passam a refletir o mesmo dado, com menos e-mail manual e menos planilhas paralelas.
Diretoria e operações ganham visão única do funil; engenharia implementa o corpo e os status conforme /api-docs/pedidos (exemplos em cURL, JavaScript e Python). Alinhe o mapeamento de status ao acordado com comercial, suporte e e-commerce.
Da integração ao acompanhamento
- Definir o mapeamento de campos. Inclua externalId, rastreio, status, cliente e endereço conforme /api-docs/pedidos.
- Implementar o POST. Content-Type application/json, Authorization Bearer, tratar 4xx/5xx conforme tabela de erros.
- Validar no painel e nos webhooks. Conferir pedido no Seu Rastreio, testar o endpoint de webhook e o fluxo de pós-venda com time de atendimento.
Idempotência: por que o externalId importa
Mantenha o mesmo `externalId` para o mesmo pedido no e-commerce, ERP ou marketplace. O Seu Rastreio atualiza a versão em vez de duplicar linha; mudança de rastreio (segunda nota) deve ser um POST explícito com o código novo, não múltiplos `externalId` com erro de digitação.
Dados, status e automação (webhooks)
Inclua código de rastreio, contato e endereço mínimo conforme a tabela da documentação, e o status alinhado ao dicionário de negócio (valores em inglês como "shipped" e "delivered" quando a documentação exigir). Quando o último evento de rastreio muda, os webhooks cadastrados (conforme /api-docs/webhooks) disparam, reduzindo consultas repetidas (polling) ao mínimo.
Perguntas frequentes
Dúvidas comuns de quem coloca a integração em produção.
- O Seu Rastreio vira o ERP principal?
- Ele é a camada de rastreio, pedidos e notificações conectada ao produto. O cálculo fiscal, estoque mestre e gestão de pedidos completa costumam ficar no seu sistema; a API sincroniza o que a logística e o atendimento precisam ver unificados no Seu Rastreio.
Próximo passo: documentação oficial
Parâmetros, tabelas de resposta, limites e exemplos em código — tudo na referência de API pública.
Atualizado em 23/04/2026