05 ‐ Dúvidas Comuns - elisei/correios-cws GitHub Wiki

O módulo, embora tenha referências do SigepWeb já não faz mais uso dessa API e sim a PPN ou CWS, uma nova API disponível pelos Corrreios.

Por hora apenas Magento ou Adobe Commerce maior ou igual 2.4.

O módulo só irá iniciar a gestão de entrega caso o pedido esteja no status "complete", conforme definido em https://github.com/elisei/sigep-web-carrier/blob/main/etc/di.xml#L35

Nosso módulo trabalha com o cálculo para a sua embalagem de envio mais o peso real dos produtos comprados. Por tanto verifique sua embalagem cadastrada no módulo.

Caso ache interessante personalize com caixas de maiores/menores dimensões.

Você pode instalar o módulo de três maneiras diferentes:

composer require o2ti/sigep-web-carrier
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:enable
bin/magento cache:flush

bin/magento module:enable O2TI_SigepWebCarrier
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:enable
bin/magento cache:flush

Para verificar se o módulo foi instalado corretamente:

1. Acesse o painel administrativo do Magento
2. Navegue para Vendas > Correios CWS > Gerenciamento de PPN (antiga PLP)
3. Se você conseguir visualizar a página de gerenciamento, o módulo está instalado corretamente

Alternativamente, você pode verificar via linha de comando:

bin/magento module:status O2TI_SigepWebCarrier

O tempo pode variar dependendo da quantidade de pedidos e da resposta dos servidores dos Correios. Geralmente, em condições normais, o processo completo leva de 5 a 15 minutos.

Verifique os logs de erro do módulo, remova o pedido da PPN (antiga PLP) atual e tente adicionar a uma nova PPN (antiga PLP).

Sim, é possível.

As etiquetas geradas ficam armazenadas no sistema e podem ser impressas posteriormente, mas é recomendável que a postagem seja feita dentro do prazo acordado com os Correios para evitar inconsistências de data.

Sim, o módulo cria automaticamente a entrega (shipment) no Magento, atualizando o status do pedido conforme a configuração do seu sistema.

• Verifique se está usando o token correto (não a senha de acesso web)
• Confirme se o ambiente selecionado corresponde às credenciais fornecidas

• Clique em "Atualizar Serviços" para buscar os serviços disponíveis
• Verifique se os serviços estão ativos em seu contrato com os Correios

• Verifique se os produtos possuem peso e dimensões cadastrados corretamente
• Confirme se o CEP de origem está configurado nas configurações da loja
• Ative o modo debug para analisar os logs de erro

• Verifique se todos os dados do remetente estão preenchidos corretamente
• Confirme se o status do pedido está entre os permitidos para geração de etiquetas

O modo de contingência (Fallback) é utilizado quando a API dos Correios está indisponível. Ele permite que sua loja continue calculando fretes mesmo quando o serviço dos Correios estiver fora do ar, utilizando uma tabela de preços local.

Na seção "Configuração de Métodos", clique no botão "Atualizar Serviços" para buscar e atualizar os serviços disponíveis pela API dos Correios. Recomendamos executar esta ação periodicamente para manter os serviços atualizados.

Apenas pedidos que estejam nos status configurados em "Status Permitidos para Criar Etiquetas" na seção Configurações de PPN (antiga PLP) serão exibidos nesta lista. Se um pedido não aparece, verifique se ele está em um dos status permitidos.

Você pode imprimir etiquetas em lote através de:

1. Acesse Vendas > Pedidos (ou Vendas > Postagens)
2. Selecione os pedidos para os quais deseja imprimir etiquetas
3. No menu suspenso de ações em massa, selecione "Imprimir Etiquetas de Envio"
4. Clique em "Enviar" para gerar as etiquetas

Não, o sistema processará o envio automaticamente através do cron. Não é necessário realizar nenhuma ação adicional. O tempo de processamento pode variar dependendo da configuração do seu cron e do número de pedidos na PPN (antiga PLP).

• Valor Declarado: Quando ativado, o valor do seguro será adicionado automaticamente (recomendado para produtos de maior valor)
• Mão Própria: Adiciona o serviço de entrega em mãos ao destinatário
• Aviso de Recebimento: Adiciona confirmação de entrega assinada pelo destinatário

Verifique e corrija o CEP do destinatário. Os Correios possuem uma validação rigorosa de endereços, e é importante que os dados estejam corretos para evitar falhas na geração de etiquetas.

Divida o pedido em mais pacotes ou escolha outro serviço que suporte pesos maiores. Cada modalidade de envio dos Correios possui um limite de peso específico.

Ajuste a embalagem ou escolha outro serviço. As dimensões dos pacotes devem estar dentro dos limites aceitos pelos Correios para o serviço escolhido.

Verifique quais serviços estão disponíveis no seu contrato com os Correios. Nem todos os contratos incluem todos os serviços disponíveis.

Complete todos os dados do remetente nas configurações do módulo. Todos os campos marcados como obrigatórios precisam ser preenchidos para a geração correta das etiquetas.

Os dados de altura, largura e comprimento são obtidos da CAIXA que cadastrada, ou seja o objeto que você posta é calculado pela caixa que você irá utilizar. Já o calculo da caixa é baseado no Peso do produto.

Você pode personalizar a seleção da caixa que será enviado o produto para tanto faça um plugin para as funções findPackageByWeight() de https://github.com/elisei/correios-cws/blob/a959d7efd2a07a23da542991793c5df1f6891777/Model/Carrier.php#L736 https://github.com/elisei/correios-cws/blob/a959d7efd2a07a23da542991793c5df1f6891777/Model/Plp/SigepWebDataFormatter.php#L205