Skip to main content
O BulkRoute utiliza a API moderna dos Correios (CWS / REST) com autenticação baseada em cartão de postagem corporativo.

​
Credenciais Necessárias

  1. Usuário do Portal Meu Correios (geralmente o e-mail ou CNPJ).
  2. Código de Acesso da API (gerado no portal CWS).
  3. Cartão de Postagem (número com 10 dígitos).
  4. Número do Contrato.

​
Como obter

  1. Acesse o Portal Meu Correios
  2. Vá em Serviços > API Correios
  3. Solicite o acesso à API CWS para seu contrato
  4. Gere o código de acesso e anote o cartão de postagem
  5. Tenha em mãos o número do seu contrato (encontrado no documento contratual)

​
Configuração no BulkRoute

  1. No painel BulkRoute, selecione Transportadoras > Correios.
  2. Preencha os campos com suas credenciais CWS.
  3. Ative os serviços desejados:
  1. Clique em Testar Conexão para validar se o cartão de postagem está ativo e com saldo/limite liberado.
  2. Salve as configurações.

​
Cubagem nos Correios

Os Correios usam fator de cubagem 6000 (cm³ → kg), diferente das transportadoras rodoviárias (fator 300):
O BulkRoute calcula automaticamente e compara com o peso real — a cobrança é pelo maior.

​
Exemplo

Pacote 40×30×30 cm, 2 kg real:
  • Peso cubado: (40 × 30 × 30) ÷ 6000 = 6 kg
  • Correios cobra por 6 kg (peso cubado)
Pacote 20×15×10 cm, 3 kg real:
  • Peso cubado: (20 × 15 × 10) ÷ 6000 = 0,5 kg
  • Correios cobra por 3 kg (peso real)

​
Limites dos Correios

O BulkRoute valida automaticamente esses limites nas cotações. Se um item exceder o limite, o Correios é descartado da cotação e o log explica o motivo.

​
Etiquetas

Os Correios fornecem etiqueta própria via API. O BulkRoute gera automaticamente no formato:
  • PDF A4 (4 etiquetas por folha — padrão SARA)
  • ZPL 100×150mm (impressora térmica — formato compatível com SARA)
A etiqueta inclui:
  • Código de rastreio (SSCC)
  • Código de barras 128
  • QR Code de validação
  • Dados do remetente e destinatário
  • Serviço contratado (SEDEX/PAC/Mini)

​
Rastreamento

O BulkRoute rastreia via a API CWS de rastreio:
  • Polling a cada 15 minutos (os Correios não enviam webhook)
  • Eventos normalizados para o padrão BulkRoute
  • Status DELIVERED confirmado via evento “Entrega Efetuada”

​
Eventos comuns dos Correios

​
Troubleshooting