Pular para o conteúdo
Documentação API Reference FAQ Changelog Status
Envios Magento 2 Adobe Commerce

Sigep — Integração com os Correios

PDF

Aprenda a conectar sua loja Magento 2 aos Correios para cotar frete, gerar etiquetas e gerenciar a postagem dos seus pedidos com a pré-lista de postagem (PLP).

O Otávio Augusto Moraes 25/06/2026 Atualizado 27/06/2026 10 min de leitura

Passo a Passo por Escrito

1. Acesse as configurações do módulo

No painel administrativo, vá em Lojas → Configurações. No menu à esquerda, dentro do grupo Vendas, clique em Sigep.

A tela é dividida em grupos: Configurações Gerais, Dados do remetente, Configurações avançadas, Configurações de ajuste no endereço e autocompletar com CEP e Autenticação Correios API Rest.

Resultado esperado: A tela de configuração do módulo Sigep será exibida com todos os grupos de campos disponíveis para preenchimento.


2. Informe as credenciais dos Correios

Abra o grupo Autenticação Correios API Rest e preencha:

  • Usuário — o usuário do seu contrato na API dos Correios.
  • Código de acesso — o código de acesso (senha) gerado no portal dos Correios.

Em seguida, abra o grupo Configurações Gerais e preencha:

  • Cartão de postagem — o número do seu cartão de postagem dos Correios.

Sem o Usuário, o Código de acesso e o Cartão de postagem válidos, o módulo não consegue se conectar aos Correios e nenhuma função (cotação, etiqueta, postagem) vai funcionar. Esses dados são obtidos com os Correios, junto ao seu contrato.

Os campos Número do contrato, CNPJ, Diretoria, Token e Validade do token são preenchidos automaticamente pelo sistema após a primeira conexão bem-sucedida. Você não precisa digitá-los.

Resultado esperado: Os campos de usuário, código de acesso e cartão de postagem ficam preenchidos, prontos para serem validados ao salvar.


3. Defina as opções gerais de envio

Ainda no grupo Configurações Gerais, ajuste:

  • Ambiente de produção? — selecione Sim para operar com os Correios de verdade. Use Não apenas em testes de homologação.
  • Método de envio — selecione o método de frete dos Correios usado na sua loja.
  • Medida de peso — escolha como o peso dos seus produtos está cadastrado: Gramas (ex.: 20 = 20 gramas) ou Quilos (ex.: 0.020 = 20 gramas).
  • Auto selecionar serviço? — quando Sim, o sistema escolhe o serviço dos Correios automaticamente sempre que possível.
  • Usar valor declarado? — quando Sim, o valor da mercadoria é declarado por padrão nas postagens.
  • Auto criar envio? — quando Sim, o envio do pedido é criado automaticamente ao fechar a PLP.
  • Notificar cliente? — quando Sim, o cliente recebe o e-mail de envio quando a postagem é criada.
  • Status do pedido — status que o pedido recebe após o envio ser criado.

Se você deixar Auto criar envio? como Não, aparece o campo Status intermediário do pedido. Ele define o status que o pedido recebe ao fechar a PLP sem ainda criar o envio. Preencha-o nesse caso.

Resultado esperado: As opções gerais de envio refletem a forma como sua loja trabalha com os Correios.


4. Preencha os dados do remetente

Abra o grupo Dados do remetente e preencha o endereço de quem envia (sua loja): Nome, Rua, Número, Complemento, Bairro, CEP, Cidade e UF.

No grupo Configurações Gerais, complete também: Razão social, Telefone e Email.

No campo Logo da loja (em Dados do remetente), envie a logomarca que aparece nas etiquetas.

A logo deve ser quadrada e ter fundo branco ou transparente, nos formatos jpeg ou png, para sair corretamente impressa nas etiquetas.

Resultado esperado: Os dados do remetente ficam completos e serão usados como endereço de origem nas etiquetas e postagens.


5. Cadastre as embalagens

No grupo Configurações Gerais, localize o campo Embalagens e cadastre os tipos de embalagem que sua loja usa (pacote/caixa, envelope, rolo/cilindro).

Use estas referências de medida (altura x largura x comprimento x diâmetro, em centímetros):

  • Pacote / Caixa: mínimo 2 x 11 x 16 x 0 e máximo 100 x 100 x 100 x 0.
  • Envelope: 0 x 0 x 0 x 0.
  • Rolo / Cilindro: mínimo 0 x 0 x 18 x 5 e máximo 0 x 0 x 100 x 91.

As embalagens cadastradas ficam disponíveis na hora de gerar a etiqueta de cada pedido, e são usadas para calcular o frete junto aos Correios.

Resultado esperado: Pelo menos uma embalagem dentro dos limites aceitos pelos Correios fica cadastrada.


6. Salve e sincronize os serviços dos Correios

Clique em Salvar configuração no topo da tela.

Ao salvar, o módulo se conecta aos Correios, valida suas credenciais e sincroniza automaticamente a lista de serviços disponíveis no seu contrato (PAC, SEDEX e outros).

A sincronização de serviços acontece ao salvar a configuração. Se você alterou as credenciais, salve novamente para que a lista de serviços seja atualizada.

Resultado esperado: Uma mensagem de "A configuração foi salva" e de "Serviços atualizados com sucesso!" é exibida no topo da tela.


7. Habilite os serviços que sua loja usa

No menu lateral, vá em Vendas → Sigep → Serviços.

A lista mostra todos os serviços trazidos do seu contrato com os Correios. Selecione os serviços que deseja usar e, no menu de Ações, escolha Habilitar (ou Desabilitar para os que não usa).

Apenas os serviços habilitados ficam disponíveis para cotação de frete e geração de etiquetas. Por isso, deixe ativos só os serviços que sua loja realmente oferece.

Resultado esperado: Os serviços usados pela sua loja aparecem como habilitados na listagem de serviços.


8. Gere etiquetas e feche a postagem (PLP)

Para postar pedidos, você cria uma PLP (Pré-Lista de Postagem) e adiciona os pedidos a ela. O fluxo no dia a dia é:

  1. A partir da listagem de pedidos (ou em Vendas → Sigep → PLPs), selecione os pedidos e solicite a etiqueta. Confira o serviço, a embalagem e o valor declarado de cada pedido.
  2. Acompanhe a PLP em Vendas → Sigep → PLPs, abrindo a PLP em aberto.
  3. Clique em Fechar PLP para enviar a lista aos Correios e gerar as etiquetas.
  4. Imprima as etiquetas (formato A4 ou 10x15), a declaração de conteúdo e o aviso de recebimento, quando aplicável.

Os Correios aceitam, por padrão, até 50 itens por fechamento de PLP. Se a sua lista for maior, use o fechamento parcial (selecione parte dos itens) para enviar em blocos.

Resultado esperado: A PLP é fechada, as etiquetas são geradas e ficam disponíveis para impressão; conforme a sua configuração, o envio do pedido é criado e o cliente é notificado.


Validação e Testes

Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.

Teste 1 — Conexão com os Correios

Ação: Preencha o usuário, o código de acesso e o cartão de postagem (passo 2) e clique em Salvar configuração. Em seguida, recarregue a tela de configuração e abra os grupos Configurações Gerais e Autenticação Correios API Rest.

Resultado esperado: Os campos Número do contrato, CNPJ, Diretoria, Token e Validade do token aparecem preenchidos automaticamente, confirmando que a loja se conectou aos Correios.


Teste 2 — Serviços sincronizados

Ação: Acesse Vendas → Sigep → Serviços.

Resultado esperado: A listagem mostra os serviços do seu contrato com os Correios (por exemplo, PAC e SEDEX), prontos para serem habilitados.


Teste 3 — Geração de etiqueta de um pedido

Ação: Selecione um pedido pago e com endereço completo, solicite a etiqueta, abra a PLP em Vendas → Sigep → PLPs e clique em Fechar PLP. Depois, imprima a etiqueta.

Resultado esperado: A etiqueta é gerada com o código de rastreio dos Correios e fica disponível para impressão no formato escolhido.


Se não funcionar, verifique:

  • Se o usuário, o código de acesso e o cartão de postagem estão corretos e correspondem ao seu contrato com os Correios.
  • Se o campo Ambiente de produção? está como Sim (em testes de verdade).
  • Se há pelo menos um serviço habilitado em Vendas → Sigep → Serviços.
  • Se o endereço do cliente está completo, com CEP válido e CPF/CNPJ preenchido no cadastro ou no endereço de entrega.
  • Se há ao menos uma embalagem cadastrada dentro dos limites aceitos pelos Correios.

Pronto! Dessa forma realizamos a configuração do Sigep — Integração com os Correios em sua loja virtual Magento 2.


Observações Importantes

  • CPF/CNPJ do cliente é obrigatório para postar. Os Correios exigem o CPF ou CNPJ do destinatário. Ele deve constar no cadastro do cliente ou no endereço de entrega do pedido.
  • Endereço com 4 linhas. O endereço da loja deve estar configurado com 4 linhas (rua, número, complemento e bairro). Isso é definido em Lojas → Configurações → Clientes → Configurações de cliente → Opções de nome e endereço → Número de linhas do endereço.
  • Melhorias de endereço e CEP (opcional). No grupo Configurações de ajuste no endereço e autocompletar com CEP você pode ativar a máscara e validação de CPF/CNPJ, o preenchimento automático do endereço pelo CEP e tornar o CPF/CNPJ obrigatório no checkout. Essas opções alteram os formulários de endereço da loja — ative apenas se desejar esse comportamento.
  • Cálculo de frete na página do produto (opcional). Ainda nesse grupo, a opção Calcular frete na página do produto? exibe uma calculadora de frete diretamente na ficha do produto.
  • Configuração por loja (multi contrato). Se você tem mais de um contrato dos Correios para lojas diferentes, é possível ativar o uso de múltiplos contratos nas configurações avançadas. Sem isso, a configuração vale para toda a instalação.
  • Notas fiscais. O módulo pode anexar a nota fiscal à etiqueta e integrar-se a emissores de NFe (como Webmania e TryERP) para impressão e download das notas, conforme as opções avançadas.

Referências e Relacionados

  • Configuração de cache da loja: após salvar as configurações do módulo, pode ser necessário limpar o cache para que as alterações apareçam na loja.
  • Gerenciamento de pedidos e postagens: depois de gerar a etiqueta, o pedido segue para o fluxo de envio (postagem) — esta doc cobre os próximos passos no gerenciamento de pedidos.
  • Cadastro de produtos (peso e dimensões): a cotação de frete e a geração de etiqueta dependem do peso e das dimensões dos produtos cadastrados corretamente.
  • Configuração de e-mails transacionais (SMTP): garante que o cliente receba o e-mail de notificação de envio quando a postagem é criada.

Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br

Copiar para usar com IA

Este artigo foi útil?

Obrigado pelo seu feedback!