Requisitos:
- Prestashop 1.6.x.x ou 1.7.x.x
- Ter o Ioncube loads Ativado na Hospedagem
- Módulo de Frete Correios já instalado na loja
- Ter contrato Correios e credenciais de Acesso SIGEP
- PHP >= 5.6 e <= 7.4.x
Link do Módulo em nossa loja:
https://www.loja5.com.br/modulo-de-integracao-correios-sigep-pro-para-prestashop-p713c269c282.html
O SIGEP Web é um sistema com o propósito de preparar e gerenciar as postagens de Clientes dos Correios. Seus principais atributos técnicos são: facilidade e rapidez na preparação das postagens e gestão das informações sobre objetos postados.
Guia da Integração Sigep
http://www.corporativo.correios.com.br/encomendas/sigepweb/doc/Manual_de_Implementacao_do_Web_Service_SIGEP_WEB.pdf
Manual Sigep Web
http://www.corporativo.correios.com.br/encomendas/sigepweb/doc/Manual_do_Usuario_SigepWeb.pdf
Suporte Sigep Web:
Dúvidas, informações e suporte na utilização do SIGEP Web, ligar para 3003-0888. Atendimento de segunda-feira à sexta-feira, das 08:00 h às 18:00 h.
Instalando o Módulo em sua Loja
1 - Usando um programa de FTP enviar a pasta do modulo "sigeppro5" para o diretório "modules" de sua loja Prestashop ou zipe a pasta "sigeppro5" e envie o arquivo zipado "sigeppro5.zip" via instalador automático via admin de sua Prestashop (instalando via admin).
2 - Acesse a administração de sua loja no menu "módulos > módulos e serviços" clique em "frete ou frete e logística", localize o módulo "Sigep Correios Pro - 1.0" e clique em instalar.
Ps: Caso não mostra o módulo reveja o passo um e verifique se enviou a pasta correta para o local correto e em lembre-se de em caso de erro verificar o Ioncube loads se o mesmo esta ativado e atualizado.
3 - Após instalado, acesse a configuração do mesmo e o ative com o serial de registro obtido no momento da compra do módulo em questão (sua conta em nossa loja > downloads) e caso tenha algum problema na ativação acesse estas instruções.
4 - Pronto, após ativado o mesmo corretamente o configure de acordo deseja usar.
Configurando o Módulo Sigep em Sua Loja
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.
Geral
Aba Geral: 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 plps) e o formato da etiqueta qual deseja imprimir se 1/1 ou 4/1.
Contrato Sigep
Aba Contrato Sigep, nesta aba é a mais importante da configuração, na mesma deverá informar os dados de contrato e integração Sigep devidamente fornecido por os Correios, estes dados devem ser configurados de forma valida e correta e para o ambiente correto, somente configura o módulo no ambiente homologação caso esteja usando os dados de homologação (descritos abaixo), caso não 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.
Dados de Homologação Sigep:
Remetente
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.
Destinatário
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 plugin Sigep, o use de medidas fixas somente ative caso use esta funcionalidade no seu módulo de Frete Correios na loja.
Gatilhos e Crons
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 plps.
a - Primeiramente deverá selecionar os status que deseja criar os pacotes de forma automática em sua loja, se vir a desejar poderá alocar de formar automática (criar objetos de rastreamento correios) a pedidos criados/atualizados na loja, para isso basta apenas ativar a opção 'Auto Criar Objetos' e selecionar o status de pagamento que desejar realizar este processo (geralmente pagos e aprovados), para que esta automação funcione deverá na hospedagem de sua loja configurar o agendamento de tarefas (CRON) para a URL exibida em 'Cron Alocar Objetos', somente com esta URL configurada este processo é automatizado, caso desejar fazer a alocação de etiquetas via 'Correios Sigep > Envios Pendentes' (de forma manual) em sua loja deixe a opção desativada e não precisa configurar a URL de Cron em sua hospedagem.
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 para "Cron Status PLPs" e "Cron Status Objetos", este fazer o processamento pós envio de seus pedidos junto aos Correios e atualização em sua loja, se preferi poderá configurar um Status para que quando um pedido for postado nos Correios ou entregue o pedido em sua loja seja atualizado automaticamente para de acordo o selecionar.
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/
Serviços Correios
Aba Serviços, para testar se seus dados configurados de integração sigep vem etapa de consultar os serviços no seu cartão de Postagem correios Sigep, caso seja a configuração inicial vai exibir um link qual ao clicar vai consultar automaticamente os serviços Correios liberados ao seu contrato sigep, 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 Parâmetros avançados > 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, 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.
Mapear Transportadoras
Agora que já configurou corretamente todo os dados e configurações de seu módulo sigep e atualizou a lista dos serviços Correios de seu contrato sigep com sucesso agora precisa mapear as transportadoras em sua loja, este procedimento serve para atrelar os métodos de entrega cada um a seu respectivo serviço Correios sigep que deseja usar, fique atento a esta parte pois ela é muito importante para o funcionamento Correto do módulo em sua loja, após feito toda a atrelação as transportadoras e serviços salve a configurações, lembre-se que sempre que reinstalar, adicionar novos meios de entrega este procedimento precisa ser refeito para o bom funcionamento do módulo na loja.
Sequencia de Uso Básica
1 - Criar envios ou usar envios já criados na loja (Menu: Envios Pendentes)
2 - Alocar rastreio de envios a ser postados junto aos Correios (Menu: Envios Pendentes)
3 - Fechar PLP para envios já alocados a ser postados junto aos Correios (Menu: Envios Pendentes)
4 - Imprimir Etiquetas e Lista PLP dos envios a ser postados junto aos Correios (Menu: PLPs e Etiquetas)
5 - Etiquetar Pacotes com a etiquetas PLPs Impressas
6 - Postar os Pacotes na Agencia dos Correios de sua Preferencia
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, o mesmo vai exibir uma nova tab como a abaixo onde basta agora seguir as instruções que vai exibir na mesma. (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 Sigep > Envios Pendentes que vai lista o pedido e todos outros envios pendentes de sua loja qual poderá fazer a alocação de etiquetas (criar) e fechamento de plps para os envios que desejar (somente aloque etiquetas e feche plps 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.
Criando Envios Avulso
No nosso plugin Sigep poderá criar pacotes de envios avulsos ou atrelados a pedido em sua loja, para isso em Correios Sigep > Envios Pendentes clique no botão 'Criar 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 Dados no envio.
Alocando (Criando) Etiquetas para Envios Pendentes
Antes do fechamento de uma PLP o envio já deverá ter seu cód. de rastreamento devidamente alocado, para este procedimento (caso não use o processo de alocação automática) acesse o menu Correios Sigep > Envios Pendentes que vai exibir todos os pedidos pedentes de postagem e de alocação de etiquetas para os pedidos que ainda estão sem a etiqueta de postagem e desejar alocar a mesma para envio basta apenas que selecione estes pedidos e depois clique no botão 'Criar Objetos' e aguardo o processo, ao finalizar o mesmo vai atualizar automaticamente a página e os pedidos alocados com sucesso vai passar a exibir o cód. de rastreamento Correios, em caso de erro será exibindo uma mensagem com o motivo do erro.
Removendo Cod. de Rastreio de Envios Pendentes
Caso por algum motivo precise gerar um novo cod. de rastreamento a um pedido principalmente por algum problema de fechamento de PLP basta apenas em Envios Pendentes clicar no X que vai exibir ao lado do cod. de rastreamento, feito isso o mesmo esta livre a alocar um novo.
Fechando uma PLP de Postagem Correios
Em Envios Pendentes para fechamento de uma PLP de postagem correios primeiramente todos os pedidos qual deseja realizar a postagem já deverá ter seu cod. de rastreamento devidamente atrelados (criados), caso ainda não tenha faça realizando processo de alocação de etiquetas, se sim basta apenas que selecione os envios que deseja realizar a postagem (selecione somente os envios que deseja fazer a postagem na data em questão), após selecionado clique em 'Fechar PLP', 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 PLPs Fechadas na Loja
Para consultar e imprimir a PLP de postagem, etiquetas, ar entre outras consultar acesse o menu Correios Sigep > PLPs e Etiquetas 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 PLP de postagem (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.
Em todas PLPs vai ter os menus de consulta de XML, Impressão de etiquetas e Impressão da PLP.
Pronto, agora com os pedidos de envios devidamente criados em sua loja, os objetos de rastreamentos alocados, plp fechada, etiquetas e plp impressa e pacotes devidamente etiquetados basta apenas que seja feito a postagem na agencia dos Correios de sua preferencia, lembre-se sempre de enviar seu cartão de postagem e a lista PLP impressa dos objetos que vai fazer a postagem e lembre-se que ao fechar um PLP a mesma poderá ter quandos pacotes desejar e poderá gerar mais de um PLP por dia, fica de acordo o uso do cliente.
Opções Extras
No módulo ainda tem o menu Objetos Entregues qual poderá consultar todos os envios já atualizado como entregue ao cliente, Objetos bloqueados qual vai mostra a lista de objetos que foi solicitado o bloqueio da entrega e o menu Paramentos avançados > Logs que poderá consultar logs de processamentos e dados de debug quando ativado.
Bloqueado Objetos e Cancelamento de Entregas
No módulo Sigep 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.
Principais Erros Sigep
A autenticacao de XXX falhou
A autenticação no servidor do Correios não será aceta quando as credenciais fornecidas não
for as mesmas cadastradas pelo Correios.
Informações necessárias para autenticação:
Número do cartão de postagem
Código administrativo
Usuário
Senha
Número do contrato
Causas possíveis:
- O usuário informado não corresponde ao cadastrado no sistema do Correios.
- A senha utilizada não é a mesma cadastrada no Sigep Web.
Persistindo a negação da utilização do serviço as informações deverão ser repassadas ao seu
representante do Correios, confirmadas e testadas pelo TI do Correios.
A PLP não será fechada, os objetos estão vinculados em outra PLP
Conforme descrito na tela do sistema, existem objetos que já estão vinculadas a outra PLP. A
causa pode ser etiqueta utilizada por outro cliente do Correios ou etiqueta com validade
vencida.
Solução:
1) Acesse o pedido correspondente ao objeto citado na mensagem
2) Clique em "remover da PLP"
3) Clique em "alocar nova etiqueta"
Um novo número de objeto será gerado e será vinculado a PLP a ser gerada. Não esqueça de
imprimir a nova etiqueta com o novo número do objeto.
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.