Manual de instalação/ Configuração - Integra correios

Manual de instalação do correios APP 

 

Requisitos mínimos para o uso do aplicativo:

• Ter o contrato dos correios para adquirir o cartão fácil.

 

• Ter acessos do correio abaixo:

- Usuário e senha de rastreio (SRO WEB - Web Service) 
- Usuário e senha do IDcorreios ( Necessários para gerar o TokenLogistica) você pode gerar o token abaixo. Não armazenamos o usuário IDCorreios, Senha e nem Token, você também pode gerar o token com a sua equipe de TI solicite para gerar no modelo Base64 dessa forma IdCorreios:Senha .

- Código Administrativo do contrato do correios.
- Código de serviço da logística reversa (EX: 04170,04677) que é fornecido pela ECT. 
- Número do cartão de postagem.

 

 

Vamos começar pelas solicitações que você deve fazer aos correios caso ainda não tenha:

1 - Primeiro precisamos gerar o Cartão Fácil dos correios, fazer um contrato com os correios. (Caso já tenha o login e senha pule para a etapa 2)

 

Para criar o usuário e senha de acesso ao sistema dos correios acesse o link https://apps.correios.com.br/correiosfacil/ 

 

1.1 - Após finalizar o cadastro faça o login: (O Correios vai pedir para você assinar um contrato com ele assim que efetuar o login que levará em até 3 dias úteis a avaliação dos correios)

 

 

1.2 - Após a conclusão da avaliação dos correios você vai ter o cartão correio liberado após efetuar o login, conforme imagem abaixo e guarde o nº do seu cartão que é utilizado no APP.

 

 

 

2 . Entrar em contato com o suporte comercial ECT pelo site do correios ou pelo chat que abre na hora que entra no site e solicite o login e senha do rastreio via web service (SRO WEB)  e o código de serviço da logística reversa juntamente com a liberação do componente.

 

 

2.1 Entrar no site dos correios >  Desça ate o final fale conosco > Clique em "Suporte ao cliente com contrato"

2.2  Clique em suporte "Clique aqui se deseja registrar solicitações sobre sistemas comerciais"

2.3  Selecionar campos abaixo e preencher as informações 

2.4 - O Correio vai encaminhar o usuário e senha do acesso SRO WEB, vamos utilizar ele nas configurações do APP.

 

3 - Assim que finaliza o contrato conseguimos acessar o sistema para adquirir o Usuário e senha da logistica reversa e o código de serviço.

Acesse o site https://cws.correios.com.br e entre o com o usuário e Senha do IDCorreios no menu do lado esquerdo acesse Gestão de Acesso a API's e defina a senha de acesso a essa API, conforme imagem abaixo.

 

 

Caso em API's Restritas você não tenha a Logística Reversa (250) será necessário entrar em contato com os correios para liberarem o acesso a esse WebService.

 

Gere o token abaixo:

3.1 - Agora acesso o link de Sistemas do correios > Clique em Sistema de faturamente efetue o login com o usuário e senha que cadastraram no 1º passo > Clique em Contrato > Pesquisar > E Clique no ação que vai aparecer conforme imagens abaixo.

 

 

3.2 - Nas informações abaixo copie o "Código ADM" e  um dos códigos do Serviço de Reversa que deseja utilizar no APP dentro do Zendesk, no momento só podemos cadastrar um código para o serviço.

 

 

4 - Configurações do APP na instalação:

Informações necessárias em mãos:

1º - Token JVB (Adiquirido clicando aqui)

2º - Usuário Rastreio (Adquirido no 2º passo)

3º - SenhaRastreio (Adquirido no 2º passo)

4º - TokenLogistica (Emitido com usário e senha do IdCorreios criados no 3º Passo pode gerar o token no botão no começo do tutorial ou pedir para a TI gerar com Base64)

5º - Código Administrativo ( Adiquirido no 3º passo)

6º - Código de serviço: ( Adiquirido no 3º passo, apenas preencher os serviços que vão utilizar)

7º - Cartão Fácil: (Adquirido no 1º passo)

Configurações do nº 8 ao 19º são informações da empresa para a Logística Reversa.

Configurações do 20º ao 29º são necessárias para guardar informações no ticket e transportar informações para o APP na Logítica Reversa.

(Necessário criar os campos conforme imagem baixo como campo "TEXTO")

 

Com esses campos criados é possível enviar as informações para o APP ou Preencher os campos de acordo com o APP.

Segue imagem de exemplo: