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 do IDcorreios ( Necessários para gerar o TokenLogistica) você pode gerar o token abaixo. Não armazenamos o usuário IDCorreios, Code de acesso 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:Codigo de acesso.

- 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://empresas.correios.com.br/#/login

1.1 - Após acessar selecione a opção "Cartões de Postagem" e clique na impressora você será direcionado para uma outra página.

1.2 - Na página que abriu colete o Código Administrativo e o Nº do Cartão Fácil.

1.3 - Agora retorne na opção de "Cartões de Postagem" e clique na lista que vai abrir um popup com os serviços.

1.4 - Nessa lista de serviço precisa coletar os ID's somente o que você for utilizar, caso não queira algum Reverso é só deixar o campo em branco.

PS: Necessário pelo menos 1 Reverso preenchido para gerar a logística reversa.

2 - Gerando o Token de acesso ao Rastreio e logística reversa.

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 para coletar a informação do "Código de acesso" basta colocar a senha e clicar no botão Regerar Código.

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 utilizando o IDCorreios e o Código de acesso gerado:

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

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

4º - TokenLogistica (Emitido com usário e senha do IdCorreios criados no 2º 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 1º passo).

6º - Código de serviço: ( Adiquirido no 1º 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 30º são necessárias para guardar informações no ticket e transportar  informações para o APP na Logística Reversa.

PS: Para o funcionamento básico do aplicativo, nem todos os campos são obrigatórios.
No entanto, para que todas as funcionalidades operem corretamente, é necessário criar e preencher os campos 20 (Texto), 29 (Texto) e 30 (Data) com seus respectivos IDs.

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: