Novo Módulo - Correios Sigep3
Patch Notes - Correios Sigep3
Módulo pago. Este módulo está disponível apenas mediante contratação. Para adquiri-lo, entre em contato com nosso suporte.
Novo
Disponibilizamos o módulo Correios Sigep3, desenvolvido para integrar a loja Magento diretamente com a API REST dos Correios. Com ele, o lojista gerencia todo o ciclo de envio de pedidos pelo próprio painel administrativo: solicita etiquetas, agrupa envios em PLPs (Pré-Listas de Postagem), imprime documentos em diferentes formatos e notifica os clientes automaticamente com o código de rastreamento, sem precisar acessar nenhum sistema externo.
O que o módulo faz
- Integra a loja com a API REST dos Correios usando as credenciais do contrato, com autenticação e renovação automática de token
- Importa automaticamente os serviços disponíveis no contrato (PAC, SEDEX, SEDEX 10, CARTA REGISTRADA, entre outros) e os disponibiliza para seleção ao solicitar etiquetas
- Adiciona uma aba “Sigep3” em cada pedido do admin, onde o operador solicita etiquetas informando serviço, embalagem, peso, NF-e, Valor Declarado, AR e Mão Própria
- Exibe estimativa de preço e prazo de entrega em tempo real ao selecionar o serviço, consultando a API dos Correios com o CEP de destino do pedido
- Valida automaticamente o endereço do destinatário e os limites do serviço selecionado antes de solicitar a etiqueta
- Agrupa as etiquetas em PLPs abertas automaticamente, com opção de fechar a PLP parcialmente com itens selecionados
- Ao fechar a PLP, gera e valida o XML no formato exigido pelos Correios, cria os Envios no Magento e envia o e-mail de rastreamento aos clientes (conforme configuração)
- Imprime etiquetas e documentos em múltiplos formatos: rolo 10x15, 10x12, A4, AR, Declaração de Conteúdo, PLP, PLP Voucher e DANFE Simplificada
- Atualiza diariamente de forma automática o valor cobrado pelos Correios para cada item da PLP
- Permite bloquear a entrega de um objeto diretamente pelo admin, acionando a API dos Correios
Funcionamento
- O lojista configura as credenciais no módulo (Usuário API Rest, Código de acesso e Cartão Postagem)
- O módulo autentica na API, importa os serviços do contrato e preenche automaticamente CNPJ, Número da Diretoria, Token e Correios ID
- O operador acessa o pedido no admin e abre a aba “Sigep3”
- Seleciona o serviço desejado — o módulo consulta a API em tempo real e exibe preço e prazo estimados
- Preenche peso, embalagem, NF-e, Valor Declarado e os adicionais AR e MP, e clica em “Solicitar Etiqueta”
- O módulo valida o endereço do destinatário e os limites do serviço, chama a API dos Correios e grava a etiqueta vinculada à PLP aberta
- O operador acessa Vendas → Sigep3 → PLPs, seleciona os itens e fecha a PLP
- O módulo gera e valida o XML, marca a PLP como fechada, cria os Envios no Magento e envia os e-mails de rastreamento aos clientes
- O módulo consulta diariamente a API de forma automática e atualiza os valores cobrados por cada item da PLP
O token de autenticação é renovado automaticamente pelo módulo sempre que expira, garantindo que a integração permaneça ativa sem qualquer intervenção manual.
Onde fica
Configurações do módulo
Sistema → Configuração → Vendas → Configurações de Entrega → Integração Webservice Correios - Sigep V.4
e também
Vendas → Sigep3 → PLPs / Serviços
Configurações disponíveis
Configurações Gerais
| Campo | Descrição |
| Habilitar | Ativa ou desativa todo o funcionamento do módulo. Nenhuma funcionalidade opera enquanto estiver desligado. |
| Ambiente | Define se o módulo opera em Produção (API real dos Correios) ou Homologação (ambiente de testes, sem custo ou postagem real). |
| Selecionar Serviço automaticamente | Pré-seleciona o serviço de acordo com a transportadora configurada no pedido. |
| Valor declarado por padrão | Deixa o campo de Valor Declarado marcado e preenchido com o subtotal do pedido ao abrir o formulário de etiqueta. |
| Criar Envio Automaticamente | Cria o Envio do Magento automaticamente ao fechar a PLP, registrando o código da etiqueta como número de rastreamento. |
| Notificar cliente por email ao criar envio | Envia e-mail ao cliente com o código de rastreamento no momento em que o Envio é criado. |
| Status do pedido ao fechar a PLP | Define qual status o pedido recebe automaticamente ao fechar a PLP. |
| Imprimir Etiquetas com PLP Aberta | Permite imprimir etiquetas mesmo antes de fechar a PLP. |
| Desativar estimativa de preço e prazo | Quando ativo, o módulo não consulta preço e prazo da API ao abrir o formulário de etiqueta. |
Credenciais e Contrato
| Campo | Descrição |
| Usuário API Rest | Login de acesso à API REST dos Correios, obtido no portal Meu Correios. |
| Código de acesso da API Rest | Senha/código de acesso à API REST dos Correios. |
| Cartão Postagem | Número do cartão de postagem associado ao contrato com os Correios. |
| Atualizar Serviços | Botão que autentica na API, importa os serviços disponíveis no contrato e preenche automaticamente CNPJ, Número da Diretoria, Token e Correios ID. |
| Debug API Rest | Quando ativo, grava logs detalhados das chamadas à API para auxílio em diagnósticos. |
Embalagem e Impressão
| Campo | Descrição |
| Tipos de Caixa | Cadastro das embalagens disponíveis (nome, tipo, dimensões em centímetros). As embalagens cadastradas aparecem para seleção ao solicitar a etiqueta. |
| Logo para etiquetas | Imagem da empresa exibida nos documentos impressos. Deve ser quadrada, com fundo branco ou transparente, em JPEG ou PNG. |
| Danfe Simplificada | Quando ativo, habilita o formato de impressão “DANFE Simplificada” como opção na tela do pedido. |
Endereço do Destinatário
| Campo | Descrição |
| Mapeamento de endereço | Define em qual linha do endereço do Magento estão rua, número, complemento e bairro do destinatário, garantindo a extração correta dos dados para a API dos Correios. |
Principais vantagens
- Operação completa de postagem via Correios dentro do próprio admin do Magento, sem necessidade de sistemas externos
- Estimativa de preço e prazo em tempo real ao selecionar o serviço, com base no CEP de destino do pedido
- Agrupamento automático de etiquetas em PLPs para postagem em lote, com opção de fechamento parcial
- Criação automática de Envio e e-mail de rastreamento ao cliente ao fechar a PLP
- Renovação automática do token de autenticação da API dos Correios, sem intervenção manual
- Impressão em múltiplos formatos (rolo 10x15, 10x12, A4, AR, Declaração de Conteúdo, PLP, DANFE Simplificada)
- Validação completa de endereço e limites do serviço antes de solicitar a etiqueta, evitando erros na API
- Atualização automática diária dos valores cobrados pelos Correios, mantendo o controle financeiro atualizado
- Compatível com ambiente de Homologação para testes sem custo ou postagem real
Quer essa funcionalidade na sua loja?
Entre em contato com a equipe mageshop e saiba como adquirir o módulo Correios Sigep3.
Fale com a mageshop