Quero ser uma integradora de transporte
Caso tenha interesse de se tornar uma integradora deverá entrar em contato com o Magalu, após ter implementado toda esta documentação abaixo.
Etapa criação conta ID Magalu e Configuração Organização CNPJ
Nesta etapa, você deverá criar uma Conta ID Magalu, caso ainda não tenha uma.
Acesse o site https://id.magalu.com/ e realize o cadastro, informando seu e-mail e CPF (pessoa física) na primeira etapa.
Após o login no ID Magalu, será necessário criar sua organização, caso ela ainda não exista. Para isso:
- Acesse o menu Avançado;
- Clique em Organizações;
- Selecione Criar nova organização;
- Preencha os dados solicitados.
Etapa criação ClientID da integradora
Basta seguir o processo de solicitação de criação de aplicação.
Implementar Url de callback do consentimento
Toda vez que uma transportadora escolher utilizar a sua integradora, após a transportadora fazer o consentimento no ID Magalu acontecerá um redirect para uma url de callback na qual sua integradora receberá o code do fluxo de OAuth2 que deverá ser trocado pelo access token e armazenar este com segurança em sua base para cada transportadora, e fazer assim a troca de token quando o mesmo expirar. Para trocar o code pelo access token utilizar esta api aqui autenticação e autorização.
A forma de identificar a transportadora será pegando o sub dentro do token JWT, este será um tenant GENPUB.uuid, deverá verificar se existe na base da integradora ou fazer o onboarding dela na sua base. Caso precise do CNPJ da transportadora deverá fazer um GET na rota whoami utilizando o token da transportadora.
Receber remessas da transportadora que lhe deu consentimento
A integradora deverá fazer a assinatura do webhook e também a consulta da remessa utilizando o token da transportadora, seguindo a documentação aqui.
Enviar eventos de Tracking da remessa
A integradora deverá enviar o tracking das remessas utilizando o token da transportadora, seguindo a documentação aqui.