Instalado e Configurando o Módulo Sigep Correios em sua loja Opencart?

Requisitos:
- Opencart 2.0.x a 2.2.x / 2.3.x / 3.x
- Módulo de Frete Correios já instalado na loja
- Ter o Ioncube loads >= 6.x Ativado na Hospedagem
- Ter contrato Correios e credenciais de Acesso SIGEP
- PHP >= 5.6 e <= 7.2

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.

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 "Integração Correios Sigep [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.
Ao fazer este procedimento no menu lateral de sua loja Opencart vai exibir um novo menu de nome Sigep Correios, 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 plps).

Aba Contrato Correios, 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, fora os dados de contrato Correios nesta página poderá escolher o formato da etiqueta, escolha a forma que deseja imprimir as mesmas.

Dados de Homologação Sigep:

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 plugin Sigep, o use de medidas fixas somente ative caso use esta funcionalidade no seu módulo de Frete Correios na loja.

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 quais meios de entrega (geralmente correios) e 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 - após selecionado os meios de entrega e status que deseja criar os pacotes 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 Alocar Etiquetas' e abaixo 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 'Comando Cron Alocar Etiquetas', somente com esta URL configurada este processo é automatizado, caso desejar fazer a alocação de etiquetas via 'Pedidos de Envios Pendentes' em sua loja deixe a opção desativada e não precisa configurar a URL de Cron.

c - 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 envios entregues e cron sara, este fazer o processamento pós envio de seus pedidos junto aos Correios.

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/

Aba Serviços, por fim para finalizar a configuração e testar se seus dados configurados de integração sigep vem etapa de consultar os serviços no seu cartão de Postagem correios Sigep, para isso clique no botão 'Consultar Cliente & Atualizar', 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 Sigep Correios > 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 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 Sigep 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 Sigep, caso contrato todo pedido feito em sua loja deverá em Pendidos Pendentes Sigep editar o envio e selecionar manualmente um método de entrega que esteja em seu contrato Correios Sigep, 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 - 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 Fechadas)
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 e no canto Superior Direto clique no Botão 'Criar Pacote Sigep' (somente crie novos pacotes a pedidos que ainda não possui ou em necessidades especificas de uso)

Pronto, feito este procedimento acesse o menu Sigep Correios > Envios Pendentes que vai lista o pedido e todos outros envios pendentes de sua loja qual poderá fazer a alocação de etiquetas 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 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.

Alocando 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 Sigep Correios > 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 'Alocar Rastreios' 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, 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 PLPs Fechadas 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 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 :)