Testar Comunicação com a API dos Correios
Caminho:
Logística > TMS > Cadastro > Transportadoras
Objetivo
Desenvolver recurso para realizar teste de conexão com API do Correios. Atualmente não há como testar a conexão com a API dos correios via e-Millennium, deste modo, o usuário não consegue validar se a conexão foi realizada corretamente.
Para tornar possível o teste de conexão com os Correios, foi criado um link de comando no cadastro de Transportadoras, que retornará mensagens de erro ou sucesso, quando for acionado pelo operador do sistema.
Pré-Requisitos
Instalar o módulo millenium!gf_correios_api.minst. Para informações sobre como fazer a instalação de módulos no e-Millennium acesse o Manual de instalação de módulos no e-Millennium.
Parâmetros
Em Logística > TMS > Transportadoras, na guia Correios API, devem ser preenchidas as credenciais de acesso e os dados referentes ao contrato de serviços, firmado com a empresa:
- Usuário API
- Senha API
- Ambiente API
- Cartão Postagem
- Número Contrato
- CNPJ do Cliente
- Serviço de Consultas
Entradas
Como funciona a validação?
- Primeiramente são validados o Usuário, a Senha e o Cartão Postagem informados para acessar a API;
- Após o acesso, são devolvidas informações dizendo quais serviços/funcionalidades da API dos Correios aquele Cartão Postagem pode utilizar:
- Na sequência, será checado se os serviços essenciais estão disponíveis para o Cartão Postagem informado.
Lista dos Serviços Essenciais:
- 36 - Pré-Postagem (PPN)
- 41 - CEP
- 35 - Prazo
- 34 - Preço
- 566 - Meu Contrato
- 392 - AR Eletrônico
- 87 – Rastro
| |
Neste exemplo, podemos ver que não é retornado serviço 392 - AR Eletrônico, que a mensagem que é retornada para usuário.
![](/download/attachments/505656636/worddav7507e40bdbcbb0f236850bd7cd1fb7a5.png?version=1&modificationDate=1721680481761&api=v2)
Após o preenchimento das credenciais de acessos e dos dados contratuais, acione o botão de validação de conexão com a API.
![](/download/attachments/505656636/worddav89f117317ca8bb9f42ad2548330a2954.png?version=1&modificationDate=1721680481603&api=v2)
Validações e Saídas
Todas as informações validadas com os correios serão retornadas em forma de mensagem para o operador do sistema.
1.Conexão realizada com sucesso, retornando os serviços contratados, conforme os dados informados. Botão de teste ficará em verde.
![](/download/attachments/505656636/worddav51d6c10f4f7e50474c046963e251c2fd.png?version=1&modificationDate=1721680481465&api=v2)
2.Conexão não realizada porque ocorreu erro de credenciais de acesso. O botão de teste ficará em vermelho.
![](/download/attachments/505656636/worddav5c3af8b270117d7046777dd4fff4e8c7.png?version=1&modificationDate=1721680481337&api=v2)
3.Conexão realizada com sucesso, porém acusa que algum serviço não está contratado. O botão de teste ficará em amarelo.