⚠️ Alertas Importantes
1. Para baixar ou obter atualizações de plugins, acesse sua conta → Downloads em www.loja5.com.br.
2. Para atualizações de módulos e plugins, o processo é o mesmo de instalação (guia abaixo). Lembre-se de fazer backup antes e, após atualizar os arquivos, reconfigurar todo o módulo novamente.
3. Os downloads ficam disponíveis por 6 meses em sua conta. Mantenha uma cópia de segurança em seu HD ou nuvem.
📋 Requisitos
- WooCommerce atualizado
- PHP >= 7.4 / 8.x (recomendado PHP 8.x)
- Ter Contrato Correios Válido (Obrigatorio)
- Este plugin não funciona com Marketplaces (Ex: Dokan, etc)
Para atualizar um plugin, siga as mesmas instruções — desinstale o plugin anterior e instale o novo. Faça sempre um backup completo antes!
Link do plugin em nossa loja:
https://www.loja5.com.br/plugin-woocommerce-integracao-correios-do-brasil-frete-e-logistica-p705c271c300.html
🚀 Instalação
Passo 1 — Baixar o Plugin
Acesse sua conta em nossa loja (clique aqui), vá em Downloads, baixe o arquivo do módulo e copie o seu serial de registro (mantenha-o salvo em seu HD ou nuvem). Após baixar, descompacte o arquivo loja5-woo-correios.zip.
Passo 2 — Enviar ao WordPress
A instalação pode ser feita de duas formas:
- Via painel WordPress (recomendado): Acesse Plugins → Adicionar Novo, clique no botão Enviar Plugin, selecione o arquivo loja5-woo-correios.zip (compactado), clique em Instalar Agora e aguarde.
- Via FTP: Acesse o servidor da sua loja via FTP, navegue até wp-content/plugins e envie a pasta loja5-woo-correios (descompactada) para dentro do diretório de plugins.
Passo 3 — Ativar o Plugin
Acesse Plugins → Plugins Instalados, localize Correios do Brasil — Loja5 na lista e clique em Ativar.
⚙️ Configuração Geral
Passo 4 — Ativar a Licença
Acesse WooCommerce → Configurações → aba Entrega e clique no link "Correios Online e Offline [Loja5]". Informe o serial (copiado no Passo 1) no campo de licença e clique em Salvar alterações.
Se após salvar não exibir a tela de configuração, clique aqui para solucionar.
🔧 Configuração Geral
Para obter os dados de acesso à nova API (É Obrigatorio ter Contrato Correios):
Como Testar Credenciais de Acesso à Nova API dos Correios →
Campos obrigatórios na API (Config Geral):
- Contrato (Usuário): CNPJ ou CPF cadastrado no Meus Correios
- CNPJ da Empresa: CNPJ do contrato
- Nº do Contrato: Número do contrato Correios
- DR do Contrato: Selecione a Correspondente a de seu contrato Correios.
- Cód. de Acesso: Código de 40 dígitos gerado no Meus Correios
- Cartão de Postagem: Número do cartão vinculado ao contrato (Sempre iniciado com 00)
- CEP de Origem: CEP de onde os produtos serão postados
Ao salvar os dados se os mesmos estiverem corretos vai exibir na tela a mensagem informativa juntamente com as APIs qual você tem acesso com ele! Recomendamos ativar o modo debug;
📦 Adicionando Métodos de Envio
Atenção: Só ative serviços com contrato se você possuir contrato Correios e credenciais válidas. Se não possui contrato, não informe dados de API e selecione apenas serviços sem contrato.
1 - Com os dados do plugin devidamente configurados e válidos acesse o menu Correios do Brasil > Métodos de Envio e clique no botão "Importar / Atualizar Serviços" para que o sistema busque os serviços e maque os quais vai ser usado para ativar.
2 - Depois de importado os serviços e ativado os quais vai usar clique sobre "Zonas de Envios" e adicione os métodos de acordo deseja usar.
Passo 5 — Adicionar os Métodos
Ainda na aba Entrega, clique em "Áreas de Entrega". Você pode usar as áreas já existentes ou criar novas (por padrão o WooCommerce vem com "Locais não cobertos por suas outras áreas de entrega"). Clique no botão "Adicionar método de entrega", selecione o método Correios desejado e clique em "Adicionar Método de Entrega".
Passo 6 — Configurar Cada Método
Após adicionar, clique no título de cada método para acessar suas configurações individuais:
- Título: Nome que aparecerá para o cliente (ex: "PAC", "SEDEX", "Frete Econômico")
- Prazo adicional: Dias extras a somar ao prazo dos Correios
- Valor adicional: Valor extra em R$ sobre o frete
- Exclusão de faixas de CEP: Restringir regiões de entrega
- Uso Offline: Ativar tabela offline como contingência
- CEP de Origem específico: Diferente do CEP padrão (apenas cálculo online)
Atenção: Edite cada método um a um, modifique o título conforme desejar e salve. O título padrão não será exibido corretamente na loja até que seja salvo.
Passo 7 — Testar na Loja
Após configurado, realize testes simulando um frete no carrinho/checkout. Lembre-se: os Correios usam como base de cálculo as medidas e peso dos produtos. Configure todos os produtos com peso e dimensões corretos no padrão Correios.
Consulte as regras de medidas e limites dos Correios →
Métodos de Envio Suportados (Online)
- PAC com contrato (vários códigos)
- SEDEX com contrato (vários códigos)
- SEDEX 10
- SEDEX 12
- SEDEX Hoje
- Mini Envios
Os serviços disponíveis dependem do seu contrato com os Correios. Use o botão "Importar Serviços do Contrato" no menu Correios do Brasil → Métodos de Envio para sincronizar os serviços liberados no seu contrato.
Métodos de Envio Suportados (Offline)
- PAC com ou sem contrato
- SEDEX com ou sem contrato
📊 Tabelas Offline (Frete Cacheado)
Recomendamos o uso de frete offline apenas como contingência para falhas do serviço online dos Correios. Os valores offline são estimativas baseadas em faixas de CEP para cada estado de destino.
Passo 1 — Acessar o Menu
No menu Correios do Brasil → Tabelas Offline, você verá os serviços disponíveis para cálculo offline. Clique em "Atualizar" para o serviço desejado. Este processo só funciona se os Correios estiverem online.
Passo 2 — Executar a Atualização
O sistema processará as cotações estado por estado. Mantenha a tela aberta até o fim do processo. Caso ocorra falha, você pode reiniciar quantas vezes forem necessárias — o sistema continuará de onde parou. Repita até que a quantidade de cotações criadas seja igual à de cotações possíveis.
Por padrão, a atualização pode ser feita a cada 30 dias. Recomendamos atualizar as tabelas mensalmente para manter os valores próximos da realidade.
Passo 3 — Configurar o Método
Após a tabela criada, acesse WooCommerce → Configurações → Entrega → Áreas de Entrega, edite o método Correios e configure o campo "Uso Offline". Recomendamos a opção "Ativado se Webservice Falhar" — assim o offline só será usado em contingência.
Passo 4 — Verificação
Quando um pedido for finalizado usando frete offline, ele será identificado com a tag "Offline".
🏷️ Pré-Postagem (Etiquetas, DC-e e DANFE)
A pré-postagem integrada permite gerar etiquetas de envio, Declaração de Conteúdo Eletrônica (DC-e) e DANFE Simplificada diretamente no painel do WooCommerce, usando a API REST dos Correios.
Ativar a Pré-Postagem
Acesse WooCommerce → Configurações → Entrega → Correios Online e Offline [Loja5] e marque a opção "Ativar Pré-Postagem" como Sim. Isso habilitará:
- Coluna "Correios" na lista de pedidos (WooCommerce → Pedidos)
- Botões de Gerar Etiqueta, Imprimir e Cancelar por pedido
- Metabox de pré-postagem nos detalhes do pedido
- Menu WooCommerce → Postagens Correios
Gerar Etiqueta
Na lista de pedidos (WooCommerce → Pedidos), localize o pedido e clique em "Gerar Etiqueta" na coluna Correios. O sistema se comunicará com a API dos Correios para:
- Criar a pré-postagem
- Obter o código de rastreio
- Gerar a etiqueta no formato configurado (Padrão, Linear ou A4)
Se houver erro, o botão mudará para "Tentar" — clique para reprocessar. Se a etiqueta foi cancelada, expirada ou estornada, o botão "Reemitir" aparecerá.
Impressão de Etiquetas
- Individual: Nos detalhes do pedido, clique em "Imprimir Etiqueta".
- Em Lote: No menu WooCommerce → Postagens Correios, selecione múltiplos pedidos e use a ação em lote "Imprimir Etiquetas".
DC-e (Declaração de Conteúdo Eletrônica)
A DC-e é gerada automaticamente junto com a etiqueta. Para imprimir:
- Individual: Clique no botão "DC-e" na coluna Correios da lista de pedidos ou na metabox do pedido.
- Em Lote: No menu Postagens Correios, selecione pedidos e use "Imprimir DC-e".
DANFE Simplificada
Requer NF-e cadastrada no pedido. A DANFE Simplificada é um documento auxiliar da nota fiscal para acompanhar a mercadoria. Para ativar:
- Na configuração do plugin, marque "Ativar DANFE Simplificada" como Sim.
- Na metabox do pedido, preencha a Chave NF-e (44 dígitos), Data de Emissão e Autorização (opcional).
- Clique em "DANFE Simplificada" para gerar o PDF.
Também é possível gerar DANFE em lote pelo menu Postagens Correios.
Modelos de Etiqueta Disponíveis
- Padrão (API Correios) — PADRAO
- Linear 100x150mm (API Correios) — LINEAR_100_150
- Linear 100x80mm (API Correios) — LINEAR_100_80
- Linear A4 (API Correios) — LINEAR_A4
Rastreamento Automático e Automatização
Após a postagem, o plugin consulta automaticamente a API de rastreio dos Correios (via cron) e atualiza:
- Status do pedido (Enviado → Entregue quando detectada a entrega)
- Último movimento de rastreio (exibido ao cliente na Minha Conta)
🔄 Logística Reversa (Devolução)
O plugin oferece suporte completo à logística reversa dos Correios, permitindo que o cliente faça a devolução de produtos com etiqueta gerada pelo sistema.
Fluxo de Devolução
- No menu WooCommerce → Postagens Correios, localize o pedido e clique em "Solicitar Devolução".
- O sistema gera uma etiqueta de logística reversa via API dos Correios.
- O status do pedido muda para "Aguardando Devolução".
- Um e-mail automático é enviado ao cliente com:
- Código de rastreio da devolução
- Prazo para postagem
- Instruções passo a passo (imprimir etiqueta, embalar, colar, postar)
- Link para a etiqueta de devolução e DC-e
- Na Minha Conta do cliente, um card de devolução é exibido com todas as informações e botões de ação.
🧾 Campos Customizados Brasileiros
O plugin adiciona campos de endereço no padrão brasileiro:
- CPF/CNPJ: Campo fiscal com máscara automática
- Tipo de Pessoa: Seletor entre Pessoa Física e Jurídica
- Número: Campo de número do endereço (separado da rua)
- Bairro: Campo de bairro
- RG/IE: Campo opcional para RG ou Inscrição Estadual
Ativar Campos Customizados
Na configuração do plugin (WooCommerce → Configurações → Entrega → Correios Online e Offline [Loja5]):
- Marque "Ativar Campos Customizados no Checkout" como Sim.
- Selecione o Tipo de Checkout: Clássico (Shortcode) ou Blocks.
- Escolha o Tipo de Campo Fiscal: CPF e CNPJ, Apenas CPF ou Apenas CNPJ.
- Opcionalmente, marque "Ativar Campo RG/IE" como Sim.
🔍 Auto-preenchimento por CEP
Ao ativar a opção "Autocompletar Endereço pelo CEP" na configuração do plugin, o endereço do cliente será preenchido automaticamente ao digitar o CEP no checkout (via API ViaCEP). Compatível tanto com o checkout clássico quanto com o Checkout Blocks.
📮 Painel de Postagens
O menu WooCommerce → Postagens Correios centraliza a gestão de postagens com:
- Ações em lote: Gerar etiquetas, imprimir, cancelar, solicitar devolução
- Filtros por status: Pré-postados, Postados, Cancelados, etc.
- DC-e em lote: Impressão da Declaração de Conteúdo para múltiplos pedidos
- DANFE em lote: Geração de DANFE Simplificada para múltiplos pedidos com NF-e
- Bloqueio de Entrega: Suspender a entrega de um pedido via SRO Interatividade
- Registro de Problemas: Anotar problemas de entrega no pedido
Bloqueio/Suspensão de Entrega
Caso precise suspender a entrega de um pedido (ex: suspeita de fraude), utilize o botão "Bloquear Entrega" no painel de postagens. O sistema se comunica com a API SRO Interatividade dos Correios para solicitar a suspensão.
📌 Status Customizados de Pedido
O plugin adiciona 6 novos status de pedido ao WooCommerce:
| Status | Descrição |
|---|---|
| Em Preparação | Pedido sendo separado/embalado |
| Enviado | Pedido postado nos Correios |
| Entregue | Entrega confirmada via rastreio |
| Em Devolução | Devolução em andamento |
| Aguardando Retirada | Disponível para retirada na agência |
| Aguardando Devolução | Cliente deve postar a devolução |
🔗 Integração NF-e com ERPs
O plugin disponibiliza uma função pública para que sistemas ERP e integrações externas salvem dados de NF-e nos pedidos:
loja5_correios_salvar_nfe( $order_id, $chave_nfe, $data_emissao, $autorizacao );Parâmetros:
-
$order_id— ID do pedido (int) -
$chave_nfe— Chave da NF-e com 44 dígitos (string) -
$data_emissao— Data de emissão no formato Y-m-d, d/m/Y ou timestamp (string|int) -
$autorizacao— Código de autorização/protocolo (string, opcional)
Retorno: array( 'sucesso' = true ) ou array( 'erro' = 'mensagem' )
🐛 Logs de Cálculo e Debug
Para ativar o log de cálculo de frete e diagnosticar problemas de integração:
- Acesse a configuração do plugin e ative a opção "Modo Debug" como Sim.
- Simule um frete no carrinho ou checkout da loja.
- Acesse WooCommerce → Status → Logs, selecione o log "correios-loja5" correspondente à data do teste.
O log exibirá detalhes do cálculo, requisições à API e possíveis erros.
📋 Obtendo Dados do Contrato Correios
Ainda não tem contrato?
Siga as instruções em: Como se cadastrar no portal dos Correios →
Já tem contrato?
Acesse os links abaixo para obter os dados de integração:
- Dados de contrato (Sigep): Obtendo os Dados de Integração Correios Sigep →
- Credenciais Nova API REST: Como Testar Credenciais de Acesso à Nova API dos Correios →
- Portal Meus Correios (CWS): https://cws.correios.com.br/dashboard/pesquisa/87
- Login Empresas Correios: https://empresas.correios.com.br/#/login
🛠️ Resolução de Problemas
-
Problema ao ativar o módulo?
Problema ou erro ao ativar um módulo → -
Arquivo de licenciamento removido?
Se a hospedagem removeu o arquivoclasses/lic5.php, veja: Como resolver → -
Trocar o domínio da licença?
Trocando de domínio em um módulo licenciado → -
Erro de permissão de escrita?
Aplique permissão de escrita (755 ou 775) ao diretóriowp-content/plugins/loja5-woo-correios/. -
Erro "Nenhum serviço disponível"?
Verifique se os serviços estão ativos no menu Correios do Brasil → Métodos de Envio. Use "Importar Serviços do Contrato" para sincronizar.
Gostou do nosso módulo? Acesse www.loja5.com.br e avalie! :)
Comentários
0 comentário
Artigo fechado para comentários.