Skip to main content
O BulkRoute importa pedidos de ERPs e marketplaces e os transforma em shipments automaticamente. Quando o tracking é atualizado no BulkRoute, ele sincroniza de volta para a plataforma de origem.

Como funciona

Integrações disponíveis

O que é sincronizado

Do ERP/Marketplace → BulkRoute

  • Pedidos pagos → viram shipments no BulkRoute
  • Dados do destinatário (nome, CPF/CNPJ, endereço, telefone)
  • Itens do pedido (SKU, descrição, peso, dimensões, valor)
  • CEP de origem (se diferente do CD padrão)

Do BulkRoute → ERP/Marketplace

  • Tracking code enviado de volta ao pedido
  • Status de entrega sincronizado quando muda
O BulkRoute importa pedidos como envios. Não sincroniza catálogo de produtos nem estoque. Para sincronizar catálogo, use a API do seu ERP diretamente.

Configuração geral

Para todas as integrações:
  1. Acesse Integrações no menu lateral
  2. Selecione a plataforma desejada
  3. Autorize a conexão (OAuth ou credenciais, dependendo da plataforma)
  4. Mapeie os carriers (qual carrier do BulkRoute corresponde a qual carrier do ERP)
  5. Dispare a sincronização manualmente quando quiser importar pedidos
A sincronização é manual — não há cron automático. Para importar pedidos, clique em Sincronizar Agora na integração desejada. O job entra na fila BullMQ e processa em background. Você pode acompanhar o progresso em Sync History.A Shopify envia webhooks que podem disparar sync automático de pedidos (se registrados manualmente no admin da Shopify), mas as demais integrações (Bling, Tiny, Omie, Mercado Livre) exigem disparo manual.

Logs de sincronização

Cada sincronização gera um log visível no painel:
  • Registros processados / sucesso / erro
  • Detalhe do erro (ex: “CEP inválido no pedido #123”)
  • Retry manual disponível para registros com erro

Worker de sincronização

A sincronização roda em background via BullMQ:
  • Cada integração tem seu próprio worker
  • Concorrência: 2 jobs simultâneos
  • Retry exponencial em caso de falha (HTTP 429, timeout, etc.) — 3 tentativas, backoff de 10s
  • Não bloqueia o painel — você continua trabalhando enquanto sincroniza