• Integra sua loja aos Correios: você gera a etiqueta de postagem de cada pedido direto no painel, sem digitar nada no site dos Correios.
• As etiquetas ficam agrupadas em uma PLP (a sua lista de postagem do dia); ao fechá-la, a loja pode criar o envio com código de rastreio e avisar o cliente por e-mail.
• Você imprime os rótulos em vários formatos (10x12, 10x15, A4), além de AR, Declaração de Conteúdo e DANFE.
• Disponível para lojas Magento 1.

#Passo a Passo por Escrito

#1. Acesse as configurações da integração

No painel administrativo, vá em Sistema → Configuração → Vendas → Configurações de Entrega → Integração Webservice Correios - Sigep V.4.

#2. Habilite a integração

No campo Habilitar, selecione Sim.

Em seguida, escolha o Ambiente: use Produção para gerar etiquetas reais da sua conta. Homologação/Testes serve apenas para testes com dados fictícios dos Correios.

#3. Informe suas credenciais dos Correios

Estes são os dados que conectam a loja à sua conta nos Correios. Preencha:

1. Usuário API Rest — o usuário de acesso à API dos Correios (Meu Correios).
2. Código de acesso da API Rest — o código/senha de acesso à API.
3. Cartão Postagem: — o número do seu cartão de postagem (somente números).

#4. Preencha os dados do remetente

Estes dados aparecem como remetente na etiqueta. Preencha:

1. Razão Social: e Remetente/Nome fantasia: — a identificação da sua loja.
2. Rua:, Numero:, Complemento:, Bairro:, CEP:, Cidade: e UF: — o endereço de origem das postagens.
3. Telefone: e E-mail: — contato do remetente.

#5. Cadastre suas embalagens

No campo Tipos de Caixa:, clique em Adicionar Caixa e cadastre cada embalagem que você usa, informando Nome, Tipo (Caixa, Envelope ou Rolo) e as medidas em centímetros (Altura, Largura, Comprimento, Diâmetro).

Exemplo de caixa pequena: 1 x 10 x 15, diâmetro 0.

#6. Ajuste as opções de operação

Configure como a integração deve se comportar no dia a dia:

1. Selecionar Serviço automáticamente — se Sim, ao abrir o pedido a loja já sugere o serviço equivalente ao frete que o cliente escolheu.
2. Valor declarado por padrão? — se Sim, o valor declarado já vem preenchido com o valor do pedido.
3. Medida de Peso? — informe se o peso dos seus produtos está em Gramas ou em Quilos.
4. Imprimir Etiquetas com PLP Aberta — se Sim, você pode imprimir os rótulos antes de fechar a lista de postagem.
5. Imprimir etiqueta imediatamente após gerar — abre a impressão automaticamente ao gerar a etiqueta (escolha o formato: 10x15, 10x12 ou A4).
6. Danfe Simplificada — se Sim, habilita os botões de impressão da DANFE junto da etiqueta.

#7. Defina o que acontece ao fechar a lista de postagem (PLP)

Ainda nas configurações, defina:

1. Criar Envio Automaticamente? — se Sim, ao fechar a PLP a loja cria o envio de cada pedido com o código de rastreio.
2. Notificar cliente por email ao criar envio? — se Sim, o cliente recebe um e-mail avisando que o pedido foi enviado.
3. Status do pedido ao fechar a PLP — escolha para qual status os pedidos devem ir quando você fechar a lista (por exemplo, Enviado).
4. Método de envio do Correios — selecione a transportadora usada no rastreio do pedido.

#8. Salve e atualize os serviços

Clique em Salvar Config no topo da tela. Ao salvar, a loja se conecta aos Correios, valida suas credenciais e baixa a lista de serviços do seu contrato.

Se quiser atualizar a lista de serviços a qualquer momento, use o botão Atualizar Serviços (na própria tela de configuração ou em Vendas → Sigep3 → Serviços).

#9. Ative os serviços que você usa

Vá em Vendas → Sigep3 → Serviços. Deixe ativos apenas os serviços que você realmente utiliza (por exemplo, PAC e SEDEX). Você pode ativar/desativar individualmente ou em massa.

#10. Gere a etiqueta de um pedido

Abra um pedido em Vendas → Pedidos e vá até a aba Sigep3. Confira/ajuste NF-e, Peso (g), Valor Declarado, marque AR ou MP se necessário, escolha o Serviço e a Embalagem e clique em Solicitar Etiqueta.

#11. Imprima e feche a lista de postagem (PLP)

Vá em Vendas → Sigep3 → PLP's e abra a PLP em uso. Imprima os rótulos (10x12, 10x15, A4), a Declaração de Conteúdo, o AR e a própria PLP conforme precisar. Quando terminar o lote do dia, use a opção de fechar a PLP.

#Validação e Testes

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

Teste 1 — As credenciais estão válidas

Ação: nas configurações, clique em Salvar Config (ou em Atualizar Serviços) e observe a mensagem no topo da tela.

Teste 2 — Geração de etiqueta

Ação: abra um pedido real, vá à aba Sigep3, escolha serviço e embalagem, confira o peso e clique em Solicitar Etiqueta.

Teste 3 — Impressão e fechamento da PLP

Ação: em Vendas → Sigep3 → PLP's, abra a PLP, imprima um rótulo e feche a PLP.

Se não funcionar, verifique:

• Os campos Usuário API Rest, Código de acesso da API Rest e Cartão Postagem estão corretos.
• O campo Habilitar está em Sim e o Ambiente está em Produção.
• O serviço escolhido está ativo em Vendas → Sigep3 → Serviços.
• O peso, o valor declarado e o endereço de entrega do pedido estão preenchidos corretamente.
• O cache da loja foi atualizado após salvar as configurações.

#Observações Importantes

• Não calcula o frete da loja: este módulo serve para gerar etiquetas e postar pedidos, não para cotar frete na vitrine. Ele não exibe preço/prazo na página do produto, no carrinho nem no checkout. A cotação existe apenas no painel, na hora de gerar a etiqueta, para você escolher o serviço. O frete cobrado do cliente continua vindo do método de envio que você configura à parte na loja.
• Credenciais são obrigatórias: sem Usuário, Código de acesso e Cartão de Postagem válidos, a loja não gera nenhuma etiqueta. Os dados de contrato (CNPJ, Contrato, Diretoria) são preenchidos sozinhos ao salvar.
• Uma lista de postagem por vez: as etiquetas que você gera entram sempre na PLP aberta atual. Ao fechá-la, uma nova é criada quando você gerar a próxima etiqueta.
• Impressão depende do estado da PLP: por padrão, os rótulos só imprimem com a PLP fechada. Para imprimir antes, ligue Imprimir Etiquetas com PLP Aberta.
• Carta registrada tem limite de peso: o serviço de carta registrada não aceita objetos acima de 1 kg (1000 g).
• Serviço "Indisponível" no pedido: significa que aquele serviço não atende o CEP de destino ou não retornou preço/prazo — escolha outro serviço.
• Peso em gramas ou quilos: confira o campo Medida de Peso? de acordo com o cadastro dos seus produtos, para não gerar etiqueta com peso errado.
• Valor Cobrado: o custo real da postagem é atualizado automaticamente após o objeto ser postado nos Correios (depende da rotina automática da loja).

#Referências e Relacionados

• Como atualizar o cache da loja: toda alteração nas configurações da integração só aparece depois de atualizar o cache. Aprenda a atualizar o cache da sua loja
• Gerenciamento de pedidos: a etiqueta é gerada dentro do pedido e o fechamento da PLP muda o status — entender o fluxo de pedidos ajuda a operar a integração.
• Rotina automática (cron) da loja: a atualização do valor cobrado das postagens depende da rotina automática da loja estar ativa.
• Emissão de NF-e: a etiqueta usa o número da NF-e do pedido; entender a emissão fiscal complementa o processo de postagem.

• O módulo Sigep conecta sua loja Magento 2 diretamente aos Correios, usando a API oficial dos Correios.
• Permite cotar frete, gerar etiquetas de postagem, declaração de conteúdo e aviso de recebimento, além de criar o envio do pedido automaticamente.
• Organiza as postagens em PLPs (Pré-Lista de Postagem): você agrupa vários pedidos, fecha a lista e imprime tudo de uma vez.
• Funciona no Magento 2 (versões 2.3.x e 2.4.x) e exige que o servidor tenha o Ioncube Loader instalado.

#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.

#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.

#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.

#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.

#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.

#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).

#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).

#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.

#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.

Teste 2 — Serviços sincronizados

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

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.

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.

#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.
• 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.