Módulo Prestashop Frete Correios do Brasil API Online e Offline

Funcional em Versão Prestashop
1.7.x / 8.x / 9.x (Outras versões e dúvida clique aqui!)

Módulo de Frete Correios — Online e Offline (Nova API) para PrestaShop

Ofereça PAC, SEDEX, SEDEX 10, SEDEX 12, SEDEX Hoje, SEDEX a Cobrar e Mini Envios com os valores reais do seu contrato, direto no carrinho da loja.

Frete dos Correios com suas tabelas contratuais — sem intermediários

O módulo integra sua loja PrestaShop diretamente à API oficial dos Correios e cadastra cada serviço como uma transportadora nativa. O cálculo é feito no carrinho, com peso cubado, medidas, serviços adicionais e as regras de frete que você definir — e, se a API ficar indisponível, o módulo continua vendendo com as tabelas de preço e prazo offline gravadas na própria loja.

Principais Funcionalidades

24 serviços: PAC, SEDEX, SEDEX 10, SEDEX 12, SEDEX Hoje, SEDEX a Cobrar e Mini Envios, com e sem contrato.
Cálculo online pela API oficial, com token reaproveitado até o fim da validade.
Contingência offline: tabelas de preço e prazo por faixa de CEP e peso, atualizadas pelo admin.
Quatro modos por serviço: desativado, online, offline, ou offline apenas quando a API falhar.
Regras por serviço: nome exibido, prazo adicional, acréscimo ou desconto em R$ e em %.
Frete grátis por faixa de CEP com valor mínimo de pedido.
Bloqueio de faixas de CEP: o serviço é ocultado nas regiões sem atendimento.

Serviços adicionais: Aviso de Recebimento (AR), Mão Própria e Valor Declarado.
Simulador de frete na página do produto e no carrinho.
Posição do simulador configurável: 5 hooks de produto, com exibição automática quando o tema não possui o escolhido.
Prazos de entrega e alertas dos Correios exibidos no checkout.
Cache de cálculo configurável, com limpeza em um clique.
Medidas fixas para todos os produtos, quando a loja não usa medidas individuais.
Etiquetas de endereçamento com código de barras do CEP.

Novidades da versão 4.0

Configuração 100% remota pelo painel Loja5 — nada de editar arquivos na loja.
Painel resumo do módulo, com o status da integração, serviços ativos e atalhos.
Token da API reaproveitado até o fim da validade, eliminando solicitações duplicadas.
Simulador do produto reescrito sem jQuery, com posição configurável e funcionamento garantido nos temas novos.
Cache e tabelas offline com expiração corrigida — os valores passam a ser atualizados na hora certa.
Etiqueta com código de barras do CEP corrigida e endereço sem número repetido.
Aviso fixo no topo ao salvar qualquer tela, mesmo com a lista rolada.
Compatibilidade de PrestaShop 1.7.x a 9.x com um único pacote.

Requisitos

PrestaShop 1.7.x / 8.x / 9.x
PHP 7.1.x a 8.4.x
Contrato ativo com os Correios
Credenciais da nova API (login, senha, cartão de postagem, contrato e DR)
Produtos com peso e medidas em cm (ou medidas fixas configuradas)
Conexão cURL liberada na hospedagem

Informações Importantes

Contrato Correios: os serviços com contrato só funcionam com contrato ativo e liberado. Se ainda não possui, siga as instruções para se cadastrar e obter os dados de integração.
Limites dos Correios: até 30 kg por envio e 200 cm na soma das medidas. Acima disso o serviço não é exibido — veja os limites de pesos e medidas.
Etiquetas: as etiquetas do módulo são de endereçamento e não substituem a etiqueta oficial com código de rastreio. Para isso use o Módulo de Pré-Postagem (PPN).
Licença: única por loja/domínio, com ativação pelo serial de compra.
API atualizada: o módulo utiliza apenas a nova API dos Correios, sem Soap e sem intermediários.

Como funciona

Configuração: com a licença ativa, sincronize os dados do contrato no painel remoto e rode o Teste de Integração.
Serviços: em Serviços Cadastrados, ative os serviços desejados e defina as regras de cada um.
Contingência (opcional): em Tabelas Offline, atualize as tabelas dos serviços que devem funcionar sem a API.
Regiões (opcional): em Faixas de CEPs, cadastre as faixas usadas no cálculo offline e nos fretes grátis.
Venda: o cliente vê o frete no carrinho e pode simular na página do produto.
Expedição: em Imprimir Etiquetas, selecione os pedidos e imprima as etiquetas de endereçamento.

Licenciamento

Módulo registrado e licenciado, com licença única por loja/domínio. A ativação é feita informando o serial recebido na compra.

Instalação e Configuração

A instalação é simples e rápida. Acesse o guia de instalação detalhado

Changelog
Changelog	4.0.0 - 21/10/2026 - configuração 100% remota: as configurações do módulo passam a ser definidas no painel Loja5 (config.loja5.cloud), substituindo a configuração local - removido o arquivo de licenciamento local (include/licenciamento.php) e seus auxiliares - removida a verificação de atualização que consultava o servidor a cada abertura do painel - compatibilidade com PrestaShop 1.7.x, 8.x e 9.x - adicionado o "Teste de Integração" na configuração para validar credenciais e endpoints de preço e prazo - corrigida a preservação do token da API: reaproveitado até o fim da validade, com lock entre processos, renovação automática e nova tentativa quando a API recusa o token - corrigido o cache do cálculo, que nunca expirava (comparação de datas invertida) e crescia sem limite - corrigida a data da última atualização das tabelas offline, que nunca era considerada vencida (comparação de datas invertida) - o tempo de cache igual a zero agora desativa o cache - corrigida a verificação de "todos os serviços com erro" no cálculo online - removido o campo "API de Cálculo" da configuração: só existe uma API dos Correios, então a escolha deixou de ser necessária e o código antigo do webservice foi eliminado - corrigida a ordem da sincronização: a versão da configuração só é gravada depois que os valores foram aplicados na loja, e um painel aberto recupera automaticamente a configuração que não chegou a ser aplicada - novo visual do módulo no admin: layout em cartões, tabelas com busca e ordenação, avisos, barras de progresso e janelas modais próprias, sem depender de Bootstrap 3, jQuery de terceiros ou CDN - nova aba principal com o resumo do módulo: licença, teste de integração, serviços ativos, faixas de CEP, cotações e atalhos - simuladores de frete do produto e do carrinho refeitos sem jQuery, com máscara de CEP, mensagens de erro claras e layout próprio - adicionada a posição "Informações adicionais do produto" para o simulador, que funciona nos temas novos (PrestaShop 1.7 em diante); a coluna lateral deixou de ser o padrão - corrigida a exibição do simulador na página do produto: o módulo passou a registrar todos os hooks de produto (ações, informações adicionais, rodapé e colunas) e, quando a posição escolhida não existe no tema, o simulador aparece automaticamente no bloco de informações adicionais, sempre uma única vez por página - corrigida a formatação do valor no simulador (milhar com ponto e centavos com vírgula) e a exibição do prazo, que vinha com entidades HTML - o JavaScript do simulador passou a ser protegido com {literal}, evitando que o Smarty consuma trechos como \d{3} - ao salvar qualquer tela do módulo (serviços, faixas e tabelas) a página volta ao topo com o aviso de sucesso fixo, que continua visível mesmo com a lista rolada - no painel de configuração, salvar e sincronizar leva a página ao topo e exibe o resultado acima do painel, pois o conteúdo do iframe é de outro domínio e não pode ser rolado - etiquetas de postagem e janelas de rastreio com layout de impressão revisado, sem Bootstrap via CDN - na etiqueta, o número do endereço não é mais repetido quando já vem no logradouro, o bairro passou a ser exibido e a linha do remetente não deixa separadores soltos quando algum dado não está preenchido - tela de configuração refeita no mesmo padrão do módulo de Pré-Postagem (painel de licença, status da sincronização recolhível e teste de integração) - corrigidos problemas de segurança: verificação TLS habilitada em todas as chamadas, escape e validação de parâmetros nas consultas SQL (inclusive nas telas de serviços, faixas e tabelas do admin) e remoção de eval - o simulador de frete deixou de devolver no JSON o endereço e o carrinho temporários usados no cálculo - código de barras das etiquetas reimplementado como controller do módulo, pois o acesso direto a arquivos PHP dentro de /modules é bloqueado nas versões novas do PrestaShop - corrigida a imagem do código de barras do CEP nas etiquetas: a URL do controller era montada por concatenação sobre a URL amigável do módulo (que não tem "?"), resultando em erro 404 e na imagem quebrada; a URL passou a ser montada com os parâmetros corretos, respeitando https quando a loja usa SSL - removidos arquivos não utilizados (ajax_produto.php, ajax_carrinho.php e templates antigos de configuração) - adicionada a aba principal do menu, que apontava para um controller inexistente - removido o Bootstrap 3 carregado via CDN nas telas de faixas e serviços, que conflitava com o admin do PrestaShop 1.7 ou superior - mapeamento dos campos do destinatário (número e complemento) no formato tabela.campo, incluindo tabelas de módulos de checkout - listas de Diretoria Regional (DR) dos Correios na configuração - removido o uso das variáveis globais $cookie e $smarty - melhoria no tratamento de erros e nos logs da API dos Correios 3.3 - melhorias de funcionamento 3.0 - atualizado para a nova API dos Correios e PrestaShop 8.x 2.0 - adicionado cálculo offline com tabelas de preço e prazo 1.0 - lançamento inicial

Changelog

Changelog

4.0.0 - 21/10/2026
- configuração 100% remota: as configurações do módulo passam a ser definidas no painel Loja5 (config.loja5.cloud), substituindo a configuração local
- removido o arquivo de licenciamento local (include/licenciamento.php) e seus auxiliares
- removida a verificação de atualização que consultava o servidor a cada abertura do painel
- compatibilidade com PrestaShop 1.7.x, 8.x e 9.x
- adicionado o "Teste de Integração" na configuração para validar credenciais e endpoints de preço e prazo
- corrigida a preservação do token da API: reaproveitado até o fim da validade, com lock entre processos, renovação automática e nova tentativa quando a API recusa o token
- corrigido o cache do cálculo, que nunca expirava (comparação de datas invertida) e crescia sem limite
- corrigida a data da última atualização das tabelas offline, que nunca era considerada vencida (comparação de datas invertida)
- o tempo de cache igual a zero agora desativa o cache
- corrigida a verificação de "todos os serviços com erro" no cálculo online
- removido o campo "API de Cálculo" da configuração: só existe uma API dos Correios, então a escolha deixou de ser necessária e o código antigo do webservice foi eliminado
- corrigida a ordem da sincronização: a versão da configuração só é gravada depois que os valores foram aplicados na loja, e um painel aberto recupera automaticamente a configuração que não chegou a ser aplicada
- novo visual do módulo no admin: layout em cartões, tabelas com busca e ordenação, avisos, barras de progresso e janelas modais próprias, sem depender de Bootstrap 3, jQuery de terceiros ou CDN
- nova aba principal com o resumo do módulo: licença, teste de integração, serviços ativos, faixas de CEP, cotações e atalhos
- simuladores de frete do produto e do carrinho refeitos sem jQuery, com máscara de CEP, mensagens de erro claras e layout próprio
- adicionada a posição "Informações adicionais do produto" para o simulador, que funciona nos temas novos (PrestaShop 1.7 em diante); a coluna lateral deixou de ser o padrão
- corrigida a exibição do simulador na página do produto: o módulo passou a registrar todos os hooks de produto (ações, informações adicionais, rodapé e colunas) e, quando a posição escolhida não existe no tema, o simulador aparece automaticamente no bloco de informações adicionais, sempre uma única vez por página
- corrigida a formatação do valor no simulador (milhar com ponto e centavos com vírgula) e a exibição do prazo, que vinha com entidades HTML
- o JavaScript do simulador passou a ser protegido com {literal}, evitando que o Smarty consuma trechos como \d{3}
- ao salvar qualquer tela do módulo (serviços, faixas e tabelas) a página volta ao topo com o aviso de sucesso fixo, que continua visível mesmo com a lista rolada
- no painel de configuração, salvar e sincronizar leva a página ao topo e exibe o resultado acima do painel, pois o conteúdo do iframe é de outro domínio e não pode ser rolado
- etiquetas de postagem e janelas de rastreio com layout de impressão revisado, sem Bootstrap via CDN
- na etiqueta, o número do endereço não é mais repetido quando já vem no logradouro, o bairro passou a ser exibido e a linha do remetente não deixa separadores soltos quando algum dado não está preenchido
- tela de configuração refeita no mesmo padrão do módulo de Pré-Postagem (painel de licença, status da sincronização recolhível e teste de integração)
- corrigidos problemas de segurança: verificação TLS habilitada em todas as chamadas, escape e validação de parâmetros nas consultas SQL (inclusive nas telas de serviços, faixas e tabelas do admin) e remoção de eval
- o simulador de frete deixou de devolver no JSON o endereço e o carrinho temporários usados no cálculo
- código de barras das etiquetas reimplementado como controller do módulo, pois o acesso direto a arquivos PHP dentro de /modules é bloqueado nas versões novas do PrestaShop
- corrigida a imagem do código de barras do CEP nas etiquetas: a URL do controller era montada por concatenação sobre a URL amigável do módulo (que não tem "?"), resultando em erro 404 e na imagem quebrada; a URL passou a ser montada com os parâmetros corretos, respeitando https quando a loja usa SSL
- removidos arquivos não utilizados (ajax_produto.php, ajax_carrinho.php e templates antigos de configuração)
- adicionada a aba principal do menu, que apontava para um controller inexistente
- removido o Bootstrap 3 carregado via CDN nas telas de faixas e serviços, que conflitava com o admin do PrestaShop 1.7 ou superior
- mapeamento dos campos do destinatário (número e complemento) no formato tabela.campo, incluindo tabelas de módulos de checkout
- listas de Diretoria Regional (DR) dos Correios na configuração
- removido o uso das variáveis globais $cookie e $smarty
- melhoria no tratamento de erros e nos logs da API dos Correios

3.3
- melhorias de funcionamento

3.0
- atualizado para a nova API dos Correios e PrestaShop 8.x

2.0
- adicionado cálculo offline com tabelas de preço e prazo

1.0
- lançamento inicial

Changelog
Changelog	4.0.0 - 21/10/2026 - configuração 100% remota: as configurações do módulo passam a ser definidas no painel Loja5 (config.loja5.cloud), substituindo a configuração local - removido o arquivo de licenciamento local (include/licenciamento.php) e seus auxiliares - removida a verificação de atualização que consultava o servidor a cada abertura do painel - compatibilidade com PrestaShop 1.7.x, 8.x e 9.x - adicionado o "Teste de Integração" na configuração para validar credenciais e endpoints de preço e prazo - corrigida a preservação do token da API: reaproveitado até o fim da validade, com lock entre processos, renovação automática e nova tentativa quando a API recusa o token - corrigido o cache do cálculo, que nunca expirava (comparação de datas invertida) e crescia sem limite - corrigida a data da última atualização das tabelas offline, que nunca era considerada vencida (comparação de datas invertida) - o tempo de cache igual a zero agora desativa o cache - corrigida a verificação de "todos os serviços com erro" no cálculo online - removido o campo "API de Cálculo" da configuração: só existe uma API dos Correios, então a escolha deixou de ser necessária e o código antigo do webservice foi eliminado - corrigida a ordem da sincronização: a versão da configuração só é gravada depois que os valores foram aplicados na loja, e um painel aberto recupera automaticamente a configuração que não chegou a ser aplicada - novo visual do módulo no admin: layout em cartões, tabelas com busca e ordenação, avisos, barras de progresso e janelas modais próprias, sem depender de Bootstrap 3, jQuery de terceiros ou CDN - nova aba principal com o resumo do módulo: licença, teste de integração, serviços ativos, faixas de CEP, cotações e atalhos - simuladores de frete do produto e do carrinho refeitos sem jQuery, com máscara de CEP, mensagens de erro claras e layout próprio - adicionada a posição "Informações adicionais do produto" para o simulador, que funciona nos temas novos (PrestaShop 1.7 em diante); a coluna lateral deixou de ser o padrão - corrigida a exibição do simulador na página do produto: o módulo passou a registrar todos os hooks de produto (ações, informações adicionais, rodapé e colunas) e, quando a posição escolhida não existe no tema, o simulador aparece automaticamente no bloco de informações adicionais, sempre uma única vez por página - corrigida a formatação do valor no simulador (milhar com ponto e centavos com vírgula) e a exibição do prazo, que vinha com entidades HTML - o JavaScript do simulador passou a ser protegido com {literal}, evitando que o Smarty consuma trechos como \d{3} - ao salvar qualquer tela do módulo (serviços, faixas e tabelas) a página volta ao topo com o aviso de sucesso fixo, que continua visível mesmo com a lista rolada - no painel de configuração, salvar e sincronizar leva a página ao topo e exibe o resultado acima do painel, pois o conteúdo do iframe é de outro domínio e não pode ser rolado - etiquetas de postagem e janelas de rastreio com layout de impressão revisado, sem Bootstrap via CDN - na etiqueta, o número do endereço não é mais repetido quando já vem no logradouro, o bairro passou a ser exibido e a linha do remetente não deixa separadores soltos quando algum dado não está preenchido - tela de configuração refeita no mesmo padrão do módulo de Pré-Postagem (painel de licença, status da sincronização recolhível e teste de integração) - corrigidos problemas de segurança: verificação TLS habilitada em todas as chamadas, escape e validação de parâmetros nas consultas SQL (inclusive nas telas de serviços, faixas e tabelas do admin) e remoção de eval - o simulador de frete deixou de devolver no JSON o endereço e o carrinho temporários usados no cálculo - código de barras das etiquetas reimplementado como controller do módulo, pois o acesso direto a arquivos PHP dentro de /modules é bloqueado nas versões novas do PrestaShop - corrigida a imagem do código de barras do CEP nas etiquetas: a URL do controller era montada por concatenação sobre a URL amigável do módulo (que não tem "?"), resultando em erro 404 e na imagem quebrada; a URL passou a ser montada com os parâmetros corretos, respeitando https quando a loja usa SSL - removidos arquivos não utilizados (ajax_produto.php, ajax_carrinho.php e templates antigos de configuração) - adicionada a aba principal do menu, que apontava para um controller inexistente - removido o Bootstrap 3 carregado via CDN nas telas de faixas e serviços, que conflitava com o admin do PrestaShop 1.7 ou superior - mapeamento dos campos do destinatário (número e complemento) no formato tabela.campo, incluindo tabelas de módulos de checkout - listas de Diretoria Regional (DR) dos Correios na configuração - removido o uso das variáveis globais $cookie e $smarty - melhoria no tratamento de erros e nos logs da API dos Correios 3.3 - melhorias de funcionamento 3.0 - atualizado para a nova API dos Correios e PrestaShop 8.x 2.0 - adicionado cálculo offline com tabelas de preço e prazo 1.0 - lançamento inicial

Changelog

Changelog

4.0.0 - 21/10/2026 - configuração 100% remota: as configurações do módulo passam a ser definidas no painel Loja5 (config.loja5.cloud), substituindo a configuração local - removido o arquivo de licenciamento local (include/licenciamento.php) e seus auxiliares - removida a verificação de atualização que consultava o servidor a cada abertura do painel - compatibilidade com PrestaShop 1.7.x, 8.x e 9.x - adicionado o "Teste de Integração" na configuração para validar credenciais e endpoints de preço e prazo - corrigida a preservação do token da API: reaproveitado até o fim da validade, com lock entre processos, renovação automática e nova tentativa quando a API recusa o token - corrigido o cache do cálculo, que nunca expirava (comparação de datas invertida) e crescia sem limite - corrigida a data da última atualização das tabelas offline, que nunca era considerada vencida (comparação de datas invertida) - o tempo de cache igual a zero agora desativa o cache - corrigida a verificação de "todos os serviços com erro" no cálculo online - removido o campo "API de Cálculo" da configuração: só existe uma API dos Correios, então a escolha deixou de ser necessária e o código antigo do webservice foi eliminado - corrigida a ordem da sincronização: a versão da configuração só é gravada depois que os valores foram aplicados na loja, e um painel aberto recupera automaticamente a configuração que não chegou a ser aplicada - novo visual do módulo no admin: layout em cartões, tabelas com busca e ordenação, avisos, barras de progresso e janelas modais próprias, sem depender de Bootstrap 3, jQuery de terceiros ou CDN - nova aba principal com o resumo do módulo: licença, teste de integração, serviços ativos, faixas de CEP, cotações e atalhos - simuladores de frete do produto e do carrinho refeitos sem jQuery, com máscara de CEP, mensagens de erro claras e layout próprio - adicionada a posição "Informações adicionais do produto" para o simulador, que funciona nos temas novos (PrestaShop 1.7 em diante); a coluna lateral deixou de ser o padrão - corrigida a exibição do simulador na página do produto: o módulo passou a registrar todos os hooks de produto (ações, informações adicionais, rodapé e colunas) e, quando a posição escolhida não existe no tema, o simulador aparece automaticamente no bloco de informações adicionais, sempre uma única vez por página - corrigida a formatação do valor no simulador (milhar com ponto e centavos com vírgula) e a exibição do prazo, que vinha com entidades HTML - o JavaScript do simulador passou a ser protegido com {literal}, evitando que o Smarty consuma trechos como \d{3} - ao salvar qualquer tela do módulo (serviços, faixas e tabelas) a página volta ao topo com o aviso de sucesso fixo, que continua visível mesmo com a lista rolada - no painel de configuração, salvar e sincronizar leva a página ao topo e exibe o resultado acima do painel, pois o conteúdo do iframe é de outro domínio e não pode ser rolado - etiquetas de postagem e janelas de rastreio com layout de impressão revisado, sem Bootstrap via CDN - na etiqueta, o número do endereço não é mais repetido quando já vem no logradouro, o bairro passou a ser exibido e a linha do remetente não deixa separadores soltos quando algum dado não está preenchido - tela de configuração refeita no mesmo padrão do módulo de Pré-Postagem (painel de licença, status da sincronização recolhível e teste de integração) - corrigidos problemas de segurança: verificação TLS habilitada em todas as chamadas, escape e validação de parâmetros nas consultas SQL (inclusive nas telas de serviços, faixas e tabelas do admin) e remoção de eval - o simulador de frete deixou de devolver no JSON o endereço e o carrinho temporários usados no cálculo - código de barras das etiquetas reimplementado como controller do módulo, pois o acesso direto a arquivos PHP dentro de /modules é bloqueado nas versões novas do PrestaShop - corrigida a imagem do código de barras do CEP nas etiquetas: a URL do controller era montada por concatenação sobre a URL amigável do módulo (que não tem "?"), resultando em erro 404 e na imagem quebrada; a URL passou a ser montada com os parâmetros corretos, respeitando https quando a loja usa SSL - removidos arquivos não utilizados (ajax_produto.php, ajax_carrinho.php e templates antigos de configuração) - adicionada a aba principal do menu, que apontava para um controller inexistente - removido o Bootstrap 3 carregado via CDN nas telas de faixas e serviços, que conflitava com o admin do PrestaShop 1.7 ou superior - mapeamento dos campos do destinatário (número e complemento) no formato tabela.campo, incluindo tabelas de módulos de checkout - listas de Diretoria Regional (DR) dos Correios na configuração - removido o uso das variáveis globais $cookie e $smarty - melhoria no tratamento de erros e nos logs da API dos Correios 3.3 - melhorias de funcionamento 3.0 - atualizado para a nova API dos Correios e PrestaShop 8.x 2.0 - adicionado cálculo offline com tabelas de preço e prazo 1.0 - lançamento inicial