Como instalar o Correios Sigep em sua loja Woocommerce?

Requisitos:
- Woocommerce >= 3.x.x
- Ter o Ioncube loads Ativado na Hospedagem
- PHP >= 5.4 e <= 7.2
- Algum Plugin de Entrega com Serviços Correios já instalado na loja 
- Contrato SIGEP junto aos Correios

O que é SIGEP?
SIGEP Web - Gerenciador de Postagens dos Correios. 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 os 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 ou diretamente no admin de seu Wordpress, para instalação por FTP primeiramente acesse o servidor de sua loja via FTP, ao acessar acesse o diretório "wp-contents/plugins" e envie a pasta de seu módulo "loja5-woo-sigep" para  dentro do diretório de plugins de seu wordpress e aguarde a conclusão do Upload dos arquivos, para instalação via painel administrativo acesse o admin de seu wordpress depois Plugins > Adicionar Novo, na barra vai ter o botão "Enviar Plugin", clique e selecione o arquivo zipado de seu plugin "loja5-woo-sigep.zip" (descompacte antes o download feito em nossa loja e zipe somente a pasta do plugin), clique em instalar e aguarde o procedimento.

3 - Depois de instalado por um dos métodos acima verifique se seu plugin já esta instalado e ativo, acesse o menu Plugins > Plugins instalados e veja se o mesmo vai exibir na lista e se já esta ativado e no menu principal de seu admin wordpress vai exibir um novo menu de nome Correios Sigep, caso não exiba verifique se fez os passos anteriores corretamente e caso exiba e não esteja ativo clique em ativar.

4 - Após ativado acesse o menu Correios Sigep > Configurar, inicialmente deverá ativar a licença de seu plugin, caso ao acessar caso exiba apenas o campo pedido o serial apenas informe o mesmo e clique em salvar alterações (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 o seu plugin da forma que deseja usar em sua loja, cada campo vai ter instruções do tipo de informação e para qual uso será a mesma, siga atentamente estas instruções e os configure de forma correta e com dados válidos.

Lembre-se de ao modificar uma informação clicar em 'Salvar alterações' antes de sair ou acessar uma nova aba.

Aba Geral: Configurações gerais de uso na loja, nesta tela vai exibir o serial de detalhes da licença ativada na loja e opções de uso geral como ativar ou não o plugin na loja, modo debug (recomendado a usar quando instalado em modo de homologação ou caso tenha problemas de integração em qualquer um dos ambientes), quantidade de registros a exibir por página e o formado das etiquetas se vai querer imprimir de uma em uma ou 4 por página.

Aba Contrato Correios: 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 Correiosou 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 (mapear os campos customizados) 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 (recomendamos sempre usar este plugin) 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.

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 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 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 um ou mais determinado status sempre que o mesmo for criado ou atualizado em sua loja, para isso basta apenas selecionar o(s) 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 (criar)', somente com esta URL configurada este processo é automatizado, caso desejar fazer a alocação de etiquetas via 'Correios Sigep > Envios Pendentes' em sua loja não selecione nenhum status e não precisa configurar a URL de Cron em sua hospedagem.
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 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.
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 Correios: Esta etapa serve para consultar os serviços no seu cartão de Postagem Correios Sigep, para configuração inicial clique no link que vai exibir para consultar seus serviços de envio Correios que vai esta relacionado ao contrato Correios devidamente configurado na aba 'Contrato Correios', estes dados devem ser válidos de acordo o ambiente configurado (homologação ou produção), 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 Woocommerce > Status > Logs, selecione o log correspondente ao Sigep e a data corrente que vai exibir detalhes e o possível motivo do problema, agora se carregou a lista de serviços corretamente está tudo certo, lembrando que sempre que trocar os credenciais do plugin de homologação para produção este processo precisa ser refeito para carregar sempre os serviços de acordo o ambiente.

Aba Mapear Métodos de Envios da Loja: Nesta aba serve para realizar o mapeamento dos serviços de entrega que sua loja já possui aos serviços sigep, geralmente basta apenas atrelar os serviços com os códigos de envio Correios corretamente, este processo serve para identificar qual o serviço de entrega o cliente escolheu de forma correta no pedido em sua loja, vai exibir o método de entrega em sua loja onde basta apenas selecionar o serviço Correios correspondente ao mesmo, ao realizar o procedimento salve as configurações.

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 

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.

1a

2a

Após corrigir os dados clique em 'Atualizar Dados'.

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 '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 'criar envio avulso' o envio.

Alocando Etiquetas para Envios Pendentes (criando objetos de envios)

Antes do fechamento de uma PLP o envio já deverá ter seu cód. de rastreamento devidamente alocado (criado), para este procedimento (caso não use o processo de alocação automática detalhados na aba gatilhos e crons) 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 '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, 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.

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 :)