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:
- Acesse Integrações no menu lateral
- Selecione a plataforma desejada
- Autorize a conexão (OAuth ou credenciais)
- Mapeie os carriers (qual carrier do BulkRoute corresponde a qual carrier do ERP)
- Ative a sincronização automática
- Configure o intervalo de sync (padrão: a cada 30 minutos)
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
- DLQ (Dead Letter Queue) para registros que falharam 3+ vezes
Worker de sincronização
A sincronização roda em background via BullMQ:
- Cada integração tem seu próprio worker
- Concorrência configurável (padrão: 2 jobs simultâneos)
- Retry exponencial em caso de falha (HTTP 429, timeout, etc.)
- Não bloqueia o painel — você continua trabalhando enquanto sincroniza
