Quer um resumo simples e prático? Visite a página oficial do SDK :)
Este SDK foi criada para facilitar a sua vida quando precisar fazer integração com o serviço de Rastreios de Objetos dos Correios \o/
O SDK é totalmente Free e Open Source! Como você deve ter notado, usamos o GitHub, então sinta-se à vontade para fazer alterações necessárias e abrir um Pull Request pra gente :)
O SDK não tem alguma funcionalidade que você deseja? Não se preocupe, basta criar uma issue explicando o que você gostaria e implementaremos pra você :)
Veja como é simples usar o SDK para Rastrear um objeto nos correios em 2 passos:
1 - Com as suas credenciais em mãos, instancie o seguinte objeto:
CorreiosCredentials credentials = new CorreiosCredentials("username", "password");2 - Em seguida basta invocar o método para retornar os Eventos do objeto desejado:
CorreiosRastreioClientApi correiosApi = new CorreiosRastreioClientApi(credentials);
PacoteTracker pacoteTracker = correiosApi.buscaPacoteTrackerUsando("codigo_do_seu_objeto").emPortugues().comTodosOsEventos().build();O código do seu objeto deve ser algo parecido com DU500853238BR.
O código completo fica como o a seguir:
@Test
public void deveriaRetornarOsEventosAPartirDeUmTrackingCode() throws Exception {
CorreiosCredentials credentials = new CorreiosCredentials("058457", "yhe8sa11");
CorreiosRastreioClientApi correiosApi = new CorreiosRastreioClientApi(credentials);
PacoteTracker pacoteTracker = correiosApi.buscaPacoteTrackerUsandoOCodigo("DU500853237BR").emPortugues().comTodosOsEventos().getPacoteTracker();
System.out.println(pacoteTracker);
}Note que usamos uma Interface Fluent que já indica pra você quais métodos devem ser invocados e nem deixa você errar! E o resto fazemos internamente pra você! Que demais né? \o/
Também é possível buscar mais de um Objeto através de uma lista de Códigos, como é mostrado a seguir:
@Test
public void deveriaRetornarOsEventosAPartirDeUmaListaDeTrackingCodes() throws Exception {
CorreiosCredentials credentials = new CorreiosCredentials("username", "password");
CorreiosRastreioClientApi correiosApi = new CorreiosRastreioClientApi(credentials);
List<String> trackingCodes = new ArrayList<>();
trackingCodes.add("DU500853237BR");
trackingCodes.add("DU496842125BR");
List<PacoteTracker> listaDeEventos = correiosApi.buscaPacoteTrackerPelaListaDeTrackings(trackingCodes).emPortugues().comTodosOsEventos().getListaDePacotesTracker();
System.out.println(listaDeEventos);
}Note que agora temos uma lista de PacoteTracker, que por sua vez é o objeto que contém todas as informações que você precisa! Awesome! \o/
Os Correios enviam diversas informações relacionadas ao objeto que está sendo pesquisado.
O objeto PacoteTracker é responsável por guardar essas informações, dê uma olhadinha na documentação na Wiki ;)
Autor: Alexandre Gama (@alexandregama)
Está tendo algum problema no uso do SDK? Basta abrir uma issue indicando os passos do seu problema e responderemos o mais breve possível