Skip to main content
A Shopify é a principal plataforma de e-commerce do mundo. O BulkRoute tem um app embedded (iframe no admin Shopify) que importa pedidos e sincroniza tracking.

​
Como funciona

​
Instalando o app

​
1. Acessar a Shopify App Store

O app BulkRoute está disponível na Shopify App Store. Para instalar:
  1. Acesse a Shopify App Store e busque por “BulkRoute”
  2. Clique em Add app
  3. Selecione a loja onde deseja instalar
  4. Autorize os escopos solicitados

​
Escopos solicitados

​
2. Configurar o app

Após instalar, o app abre dentro do admin Shopify (iframe):
  1. Conectar ao BulkRoute: insira sua API Key (bk_live_...)
  2. Selecionar CD de origem: qual location da Shopify é o CD padrão
  3. Mapear carriers: qual carrier do BulkRoute despacha os pedidos
  4. Ativar sincronização: pedidos pagos passam a ser importados automaticamente

​
O que é sincronizado

​
Shopify → BulkRoute

  • Pedidos pagos (orders/paid webhook) → viram shipments
  • Dados do cliente (nome, e-mail, telefone, endereço)
  • Itens do pedido (SKU, título, quantidade, peso, dimensões)
  • CEP de origem (do location selecionado)

​
BulkRoute → Shopify

  • Fulfillment criado no pedido Shopify com o tracking code
  • Status de entrega atualizado quando o carrier entrega
  • O cliente final vê o tracking dentro do Shopify ou pelo link do BulkRoute

​
Carrier Service

O BulkRoute se registra como um Carrier Service na Shopify. Isso permite que:
  • O checkout da Shopify mostre o BulkRoute como opção de frete
  • O preço seja calculado em tempo real pelo orquestrador do BulkRoute
  • O prazo seja exibido conforme cada carrier

​
Webhooks

O app BulkRoute registra os seguintes webhooks na Shopify:

​
Custom App vs Public App

O BulkRoute começou como Custom App para os primeiros clientes e está sendo preparado para publicação como Public App na Shopify App Store.

​
Troubleshooting

​
Documentação técnica

Para detalhes técnicos sobre o app Shopify (Partner Dashboard, OAuth, deploy, nginx, PM2), veja docs/integrations/shopify.md no repositório do BulkRoute.