Home - elisei/correios-cws GitHub Wiki

Módulo Correios CWS para Magento

Bem-vindo à documentação oficial do módulo Correios CWS para Magento 2.4+. Este módulo oferece integração completa com os serviços dos Correios do Brasil, permitindo cálculo de fretes, impressão de etiquetas e gerenciamento de PPN (antiga PLP) diretamente da sua loja Magento.

Índice Geral

  1. Introdução
  2. Requisitos do Sistema
  3. Instalação
  4. Configuração
  5. Gerenciamento de Etiquetas
  6. Frete Grátis
  7. Dúvidas Comuns e Solução de Problemas
  8. Suporte

Introdução

O módulo Correios CWS para Magento 2 oferece uma solução completa para integração com os serviços dos Correios do Brasil. Desenvolvido pela O2TI, este módulo utiliza a nova API CWS (também conhecida como PPN) dos Correios, permitindo o cálculo preciso de fretes, geração de etiquetas de envio e gestão de PPN (antiga PLP atual Pré-Postagem Nacional).

Requisitos do Sistema

  • Magento 2.4.x ou superior
  • PHP 7.4 ou superior
  • Extensão SOAP do PHP habilitada
  • Contrato ativo com os Correios (para utilização em produção)

Descrição dos Serviços

O módulo Correios CWS oferece os seguintes serviços principais:

Cálculo de Frete

Permite a integração completa com a API dos Correios para cálculo de fretes em tempo real durante o checkout. Os principais recursos incluem:

  • Múltiplos Serviços: Suporte a todos os serviços contratuais dos Correios (SEDEX, PAC, SEDEX 10, etc.)
  • Cálculo Preciso: Considera peso, dimensões e valor declarado para cálculos precisos
  • Prazo de Entrega: Exibe o prazo estimado de entrega para cada opção
  • Serviços Adicionais: Suporte para Aviso de Recebimento (AR), Mão Própria e Valor Declarado
  • Modo Fallback: Tabela de contingência para quando a API dos Correios estiver indisponível

Gerenciamento de PPN (antiga PLP)

Permite a criação e gestão de PPN (antiga PLP atual Pré-Postagem Nacional) diretamente do painel administrativo do Magento:

  • Criação de PPN (antiga PLP): Interface intuitiva para criação e gerenciamento de PPN (antiga PLP)
  • Gestão de Pedidos: Adicione múltiplos pedidos a uma única PPN (antiga PLP)
  • Integração com Correios: Envio automático da PPN (antiga PLP) para os servidores dos Correios
  • Rastreamento Automático: Associação automática de códigos de rastreamento aos pedidos
  • Documentação: Geração de relatórios e documentos necessários para postagem

Impressão de Etiquetas

Simplifica o processo de expedição com recursos avançados de impressão de etiquetas:

  • Etiquetas Padrão Correios: Geração de etiquetas no formato oficial dos Correios
  • Impressão em Lote: Imprima múltiplas etiquetas de uma só vez
  • Declaração de Conteúdo: Geração automática de declaração de conteúdo
  • Opções de Formato: Suporte a diversos formatos de impressão (PDF, PNG)
  • Múltiplos Layouts: Opções de layout para diversos tipos de impressoras

Regras de Frete Grátis

Permite a criação de promoções de frete grátis com diversas opções de configuração:

  • Por Valor de Pedido: Configure frete grátis para pedidos acima de determinado valor
  • Por Região: Limite o frete grátis a determinadas regiões/CEPs
  • Por SKU: Ofereça frete grátis para produtos específicos
  • Combinação de Regras: Flexibilidade para combinar diferentes condições

Benefícios Principais

  • Integração Completa: Todos os serviços necessários em um único módulo
  • Fácil Configuração: Interface intuitiva para configuração e gerenciamento
  • Precisão nos Cálculos: Cálculos precisos de frete conforme especificações dos Correios
  • Automação de Processos: Automatiza a geração de documentação e etiquetas
  • Compatibilidade: Desenvolvido especificamente para Magento 2.4+
  • Suporte para Contrato: Compatível com contratos de diferentes modalidades dos Correios
  • Modo de Contingência: Garantia de funcionamento mesmo quando a API dos Correios estiver fora do ar

Links Rápidos

Suporte

Para obter suporte ou relatar problemas, entre em contato com a equipe da O2TI: