Atenção:
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 seu módulo novamente.
3 - Para ter acesso a nova api de rastreamento, calculo de frete e ppn acesse https://loja5.zendesk.com/hc/pt-br/articles/10409646188813-Como-Testar-Credenciais-de-Acesso-a-Nova-API-dos-Correios-
Link do Módulo na Loja
https://www.loja5.com.br/modulo-de-integracao-correios-sigep-pro-para-opencart-p710c265c279.html
Requisitos:
- Opencart 2.0.x a 2.2.x / 2.3.x / 3.x
- Módulo de Frete Correios já instalado na loja e funcionando, caso não tenha acesse https://www.loja5.com.br/modulo-de-frete-nova-api-correios-online-e-offline-para-opencart-p667c265c279.html
- Ter contrato Correios (com acesso a nova api correios)
- PHP >= 5.6 / 7.x / 8.x
Atenção 1: Caso ainda não tenha contrato com os Correios siga as instruções de https://loja5.zendesk.com/hc/pt-br/articles/19172421924493 e veja como se cadastrar no portal dos Correios para obter seu contrato e posteriormente os dados de integração.
Atenção 2: O funcionamento é igual da versão anterior (Sigep) na mesma lógica de funcionamento e bem simples.
Atenção 3: No PPN não precisa mais imprimir a lista de itens PLP.
Manual Correios PPN
https://www.correios.com.br/ppn/arquivos/faq-ppn.pdf
Suporte Correios:
Dúvidas, informações e suporte Correios, ligar para 3003-0888. Atendimento de segunda-feira à sexta-feira, das 08:00 h às 18:00 h.
Como instalar:
1 - Primeiro, acesse sua conta em nossa loja (clique aqui) depois em Downloads baixe o arquivo de seu módulo e copie o seu serial de registro (mantenha o mesmo a salvo em seu HD ou cloud, só guardamos downloads de clientes por 6 meses), após baixado descompacte o arquivo do módulo.
2 - A instalação poderá ser feita por FTP (como usar o FTP), para instalação por FTP primeiramente acesse o servidor de sua loja via FTP, ao acessar acesse o diretório principal de sua Opencart (o qual fica as pastas de admin, catalog. etc) e envie todo conteúdo qual esta dentro da pasta de seu módulo "UPLOAD" (não é a pasta upload e sim o conteúdo da mesma) para dentro do diretório principal de sua Opencart e aguarde a conclusão do Upload dos arquivos até a conclusão.
3 - Depois de enviados os arquivos por FTP acesse o Admin de sua loja Opencart e no menu Extensões > Módulos e localize o módulo "Correios Pré-Postagem [Loja5]" e o instale.
4 - Após o módulo devidamente instalado acesse o menu Extensões > Modificações e no canto superior direito clique em no ícone para Recarregar as modificações na loja.
Atenção: Se sua loja for opencart 3.x limpar o cache de templates (página inicial do admin, canto superior direito).
Ao fazer este procedimento no menu lateral de sua loja Opencart vai exibir um novo menu de nome Correios Pré-Postagem, acesse o mesmo e depois Configurações.
5 - Após instalado acesse as configurações do mesmo onde inicialmente deverá ativar a licença do módulo em sua loja, ao acessar caso exiba o campo pedido o serial apenas informe o mesmo e clique em salvar (copie o serial em sua conta em nossa loja no menu Downloads), ao salvar caso não exiba a tela de configuração clique aqui, caso ative corretamente agora é só configurar da forma qual deseja usar em sua loja.
Configuração Inicial do Módulo:
Após o módulo devidamente instalado em sua loja agora o mesmo precisa ser configurado com os dados e métodos que deseja usar em sua loja, abaixo de cada campo vai ter um descritivo de qual informação deverá ser informada em cada respectivo campo, lembre-se de configurar o módulo por completo e com dados de forma valida e correta, principalmente caso já esteja configurado em ambiente real de produção.
Aba Configurações: Nesta aba vai exibir detalhes básicos do módulo com o Serial e Status de licenciamento do mesmo junto a Loja5.com.br, o Status do módulo em sua loja se deseja ativar ou não o mesmo, o modo Debug (para a configuração inicial recomendamos ativar, posterior quando tudo ok desative) que é usado para testes e detecção de problemas e a quantidade de registros que deseja exibir por página (envios e listas de plps).
Aba Contrato Correios, nesta aba é a mais importante da configuração, na mesma deverá informar os dados de contrato e integração PPN devidamente obtido em seu contrado e dados de integração Correios ( https://loja5.zendesk.com/hc/pt-br/articles/10409646188813-Como-Testar-Credenciais-de-Acesso-a-Nova-API-dos-Correios ), estes dados devem ser configurados de forma valida e correta e para o ambiente correto, o ambiente sempre será o de produção, todos os dados são obrigatórios portanto nenhum campo poderá ficar vazio, caso não saiba quais dados configurar entre em contato com o seu Gerente Comercial Correios ou pessoa responsável por seu contrato junto a eles, fora os dados de contrato Correios nesta página poderá escolher o formato da etiqueta, escolha a forma que deseja imprimir as mesmas.
Aba Remetente, nesta aba configure os dados da pessoa ou empresa que vai enviar os produtos aos clientes em sua loja, informe os mesmo por completo e de forma correta pois qualquer problema de entrega o pacote será retornado ao endereço informado.
Aba Destinatário, nesta aba configure dados customizados do cliente em sua loja como a origem do campo número, complemento e cpf/cnpj customizado de sua loja, geralmente estes campos não são nativos onde usa-se campos customizados para salvar os mesmo, selecione-os caso sua loja venha possuir tais campos, em Opcionais deverá selecionar os serviços extras iguais ativou no seu módulo de frete Correios em sua loja ou seja os que foram ativados lá deverá ser ativado no módulo o use de medidas fixas somente ative caso use esta funcionalidade no seu módulo de Frete Correios na loja.
Aba Serviços, por fim para finalizar a configuração e testar se seus dados configurados de integração Correios vem etapa de consultar os serviços no seu cartão de Postagem Correios, para isso clique no botão 'Atualizar Serviços', este processo busca todos os serviços de envio atrelados ao seu contrato Correios, se tudo OK o mesmo vai automaticamente recarregar a tela e exibir os serviços de envio qual poderá usar para entregas junto os Correios, em caso de problema o mesmo vai exibir uma mensagem de erro, neste caso revise suas credenciais e veja se todos seus dados de contrato estão corretos, caso não tenha ativado ainda ative o modo Debug para salvar logs de dados de requisição, este logs podem ser consultados posterior no menu Correios Pré-Postagem > Logs, visualizar os últimos logs que vai mostra detalhes e o possível motivo do problema, agora se carregou a lista de serviços corretamente está tudo certo, agora é só testar, lembrando que em alguns casos o Correios exige um processo de homologação, caso eles solicitem basta seguir os procedimentos por eles indicados para realizar o processo.
ATENÇÃO AO CRON DE STATUS DE PLP:
Caso o cron de status PLP não esteja atualizado as PLPs e Envios para enviado deverá modificar o seu comando cron e adicionar o paramentro &viarastreio=true para que o mesmo consiga consultar quando os objetos são postados junto aos Correios.
Ex: curl -S https://www.sualoja.com.br/index.php?route=extension/module/prepostagem5/cron_sara&viarastreio=true
Aba Gatilhos e Crons, esta aba é a segunda mais importante da configuração, ele é responsável por a automação e processamento automático de informações como a criação de pacotes de envios, atualização de envios e pré-postagens plps.
A - Primeiramente deverá selecionar quais status de pagamentos (geralmente pagos e aprovados) a loja vai automaticamente criar pacotes de envio na loja, esta configuração é obrigatória caso contrario este processo deverá ser feito de forma manual a todo pedido que deseje realizar a postagem junto aos Correios.
B - Agora para finalizar esta parte da configuração ainda no agendador de tarefas de sua hospedagem por obrigatório deverá configurar os 2 comandos de cron que ainda vai exibir na tela de configuração, um para cron envios entregues e outro cron sara, estes faz o processamento pós envio de seus pedidos junto aos Correios como atualização das PLPs em sua loja e dos envios para Enviados e Entregues, alem de forma extra poderá configurar para quando um pedido for postado junto aos Correios seu cliente receber um e-mail informado e também atualizar os Status do pedido na loja para Pedidos em Preparação, Enviados ou Entregues, para isso basta apenas configurar o Status de acordo detalhado nas instruções da tela.
C - Caso for usar o serviço de envio reverso configure o serviço padrão a ser usado (selecione apenas serviços do tipo reverso e configure o cron junto a sua hospedagem.
Caso não saiba como configurar o cron acesse https://loja5.zendesk.com/hc/pt-br/articles/360018241291-Criando-uma-Cronjob-no-cPanel-Tarefas-Cron- e caso sua hospedagem não tenha cron gratuito use https://cron-job.org/en/
Atenção a Configuração do Módulo de Frete Correios usado na Loja
1 - Atenção que este detalhe é muito importante, no módulo de frete Correios usado em sua loja os mesmos serviços de entrega oferecidos no mesmo deverá esta dentre a lista do serviços liberados em seu contrato Correios, cada serviço de entrega tipo PAC, Sedex tem um Cod. de Serviço, no seu módulo Correios de Frete na loja os serviços qual ativou lá deverá ter os mesmos Cod. de Serviços liberados no contrato Correios, caso contrato todo pedido feito em sua loja deverá em Pendidos Pendentes editar o envio e selecionar manualmente um método de entrega que esteja em seu contrato Correios, dependendo do módulo de frete usado em sua loja poderá informar o cod. de serviço correios ou selecionar os corretos.
2 - Outro detalhe importante é que para que o sistema salve o pacote de envio já com o método de entrega escolhido por seu cliente de forma automática o módulo de frete qual usa deverá salvar em sua loja o cod. do serviço de entrega usado, geralmente a maioria dos módulos Correios já faz isso, mas temos de lembrar este detalhe, geralmente é salvo na tabela do pedido na loja: nome_do_modulo.servico_id_correios (Ex: correios.04162, este deverá ser o formato exato a ser salvo no banco de dados).
Sequencia de Uso Básica
1 - Criar envios ou usar envios já criados na loja (Menu: Envios Pendentes)
2 - Fechar PLP (realizar a pré-postagem) para envios pendentes a ser postados junto aos Correios (Menu: Envios Pendentes)
3 - Imprimir Etiquetas, Declaração de Contéudo, Cancelar Objeto, etc dos envios a ser postados junto aos Correios (Menu: PLPs Fechadas)
4 - Etiquetar Pacotes com a etiquetas Etiquetas Impressas
5 - Postar os Pacotes na Agencia dos Correios de sua Preferência
Criando um Pacote de Envio para um Pedido na Loja
Atenção: Só realize este procedimento de forma manual em alguma ocasião especifica a algum pedido em questão que o mesmo não tenha sido gerado de forma automática, sempre aguarde o processamento do Cron para automatização do processo caso o tenha configurado.
1 - Acesse o pedido em sua loja que deseja criar o Pacote de Envio, acesse o menu pedidos de sua loja e no canto Superior Direto clique no Botão 'Criar Envios Correios' (somente crie novos pacotes a pedidos que ainda não possui ou em necessidades especificas de uso)
Pronto, feito este procedimento acesse o menu Correios Pré-Postagens > Envios Pendentes que vai lista o pedido e todos outros envios pendentes de sua loja qual poderá fazer a solicitação de pré-postagem para os envios que desejar (somente feche plps (pré-postagem) dos envios para pedidos já pagos e que será feito a postagem junto aos correios na data em questão).
Editando Pacotes de Envios com Algum Problema
Quando um pedido de envio é criado na loja e o mesmo tem algum problema como por exemplo alguma informação de endereço vazia ou invalida ou até mesmo o serviço de entrega correios não atrelado ao mesmo para editar é mesmo simples, o mesmo vai exibir o botão NOK (editar), clique em editar e confira e complete as informações necessárias para envio de forma valida e correta, se necessário consulta seu cliente caso seja alguma informação que não existe no cadastro de sua loja.
Atenção: Na nova api PPN agora é obrigatorio informar a NFe ou informar os itens para declaração de conteúdo!
Criando Envios Avulso
No nosso módulo poderá criar pacotes de envios avulsos ou atrelados a pedido em sua loja, para isso em Envios Pendentes clique no botão 'Adicionar Envio Avulso' qual vai abrir uma tela, informe na mesma os dados de entrega de seu cliente como endereço, nome, etc e os dados do pacote a ser postado junto aos Correios como medidas e peso, caso o mesmo seja atrelado algum pedido ou nfe de sua loja poderá informar estes dados na tela, depois apenas selecione o meio de entrega qual deseja realizar o envio, ao selecionar automaticamente o mesmo vai simular os custos de envio, após tudo ok basta Salvar envio avulso o envio.
Atenção: Na nova api PPN agora é obrigatorio informar a NFe ou informar os itens para declaração de conteúdo!
Fechando uma PLP (Criar a Pré-Postagem) para envio Correios
Em Envios Pendentes para fechamento de uma pré postagem correios primeiramente todos os pedidos qual deseja realizar a postagem (selecione somente os envios que deseja fazer a postagem na data em questão), após selecionado clique em 'Pré-Postagem', se tudo ok a tela será automaticamente carregada e em caso de algum problema vai exibir o alerta com o motivo do mesmo.
Quando um pedido pendente é fechado em uma PLP ele automaticamente vai sair da lista de Envios Pendentes e passa a ser acessado agora via Envios Finalizados, nesta lista vai ter todos os pedidos já atrelados a uma PLP em sua loja.
Na lista vai exibir detalhes do pedido/envio, serviços extras atrelado ao mesmo, valor total do pedido, objeto de rastremento, numero da plp atrelada, se já foi postado, entregue e se o objeto foi bloqueado junto aos Correios.
Consultado e Imprimindo Etiquetas de Postagem, Declaração de Conteúdo, ARs, Etc
Para consultar e imprimir a PLP de postagem, etiquetas, ar entre outras consultar acesse o menu Pre-Postagens (PLPs) qual vai exibir todas as PLPs já geradas em sua loja via o módulo, basta apenas realizar os procedimentos de despachados padrão que é a impressão das etiquetas para colagem junto aos pacotes de envio e da pré postagem (plp) (levar a agencia dos correios), caso a PLP ainda não tenha sido postada junto aos Correios e por algum motivo deseja cancelar o envio de algum objeto que contem na mesma basta apenas clicar em X do objeto que deseja remover do envio no momento em questão, este processo só poderá ser feito em PLPs e objetos ainda não postados.
Pronto, agora com os pedidos de envios devidamente criados em sua loja, os objetos de rastreamentos alocados, plp fechada, etiquetas impressa e pacotes devidamente etiquetados basta apenas que seja feito a postagem na agencia dos Correios de sua preferencia, e lembre-se que ao fechar um PLP a mesma poderá ter 1000 pacotes desejar e poderá gerar mais de um PLP por dia, fica de acordo o uso do cliente.
Criando Postagens Reversas Junto aos Correios (Autorização de Postagem)
Autorização de postagens são usadas para devolução de produtos por parte do comprador (cliente) a loja, pedidos de postagem reversa poderá ser feito diretamente via loja por o administrador (contando que seja um serviço já liberado junto aos correios para o contrato da loja), de forma fácil e simples o dono da loja poderá fazer estas solicitações via os passos abaixo.
Acesse o menu Envios Entregue, busque pode o objeto/pedido qual deseja criar a autorização de postagem reversa junto aos Correios e clique em Postagem Reversa e aguarde.
Ou poderá criar autorização de postagens reversas avulso (sem ter relação a qualquer pedido na loja) acessando o menu Postagem Reversa e clicando no botão abaixo.
Se tudo OK vai ser criado um pedido de autorização de postagem reversa, com isso seu cliente poderá comparecer a uma agência dos Correios com o objeto de devolução devidamente embalado e com todas as informações necessárias, lá será solicitado o cod. de autorização qual o cliente deverá informar para iniciar o procedimento de postagem reversa, todas as solicitações de autorização de postagem podem ser consultadas e canceladas (caso não tenha sido usada) via menu Postagem Reversa no admin de sua loja.
1 - Não esquecer de configurar o cron de postagem reversa qual é exibido na configuração do plugin, aba Gatilhos e Crons, caso contrario não vai ocorrer a automação das funcionalidades em sua loja.
2 - Caso a mesma seja atrelado a algum pedido, para o cliente nos detalhes do pedido da conta do mesmo será exibido a opção de imprimir a etiqueta de postagem.
Bloqueado Objetos e Cancelamento de Entregas
No plugin de pré-postagem existe a opção de solicitar um bloqueio de um objeto que já foi feito a postagem junto aos Correios e ainda não entregue, se por algum motivo deseja fazer este procedimento basta apenas acessar o menu Envios Finalizados, selecionar o objeto e clicar em Bloquear, lembre-se que ao fazer um bloqueio de um objeto este procedimento jamais poderá ser desfeito e o objeto será retornado ao remetente.
Problema ao ativar um módulo?
https://loja5.zendesk.com/hc/pt-br/articles/360001980232-Problema-ou-erro-ao-ativar-um-m%C3%B3dulo-
Trocar o dominio da licença?
https://loja5.zendesk.com/hc/pt-br/articles/360002245071-Trocando-de-dom%C3%ADnio-em-um-m%C3%B3dulo-licenciado
Gostou de nosso módulo? Acesse nossa loja https://www.loja5.com.br e avalie o mesmo :)
Comentários
0 comentário
Artigo fechado para comentários.