guilhermechapiewski / correios-api

API Ruby e REST para obter informações de encomendas/Sedex dos Correios.

correios-api

correios-api é uma API de webservices REST e Ruby para rastrear encomendas dos Correios.

Esta API faz requests e parse no HTML do site dos correios para fornecer informações
sobre encomendas.

Para mais informações acesse o site do projeto.

Usando a API Rest

Se você acessar o endereço:

http://localhost:4567/encomenda/ES446391025BR

Você receberá um XML com os dados da encomenda “ES446391025BR”:

<? xml encoding="UTF-8" version="1.0" ?>
<encomenda numero="ES446391025BR">
  <status data="2009-01-27T16:35:00+00:00">
    <local>ACF FENIX - ITAPECERICA DA SERRA/SP</local>
    <situacao>Postado</situacao>
    <detalhes></detalhes>
  </status>
  <status data="2009-01-27T18:51:00+00:00">
    <local>ACF FENIX - ITAPECERICA DA SERRA/SP</local>
    <situacao>Encaminhado</situacao>
    <detalhes>Em trânsito para CTE JAGUARE - SAO PAULO/SP</detalhes>
  </status>
  <status data="2009-01-28T03:36:00+00:00">
    <local>CTE JAGUARE - SAO PAULO/SP</local>
    <situacao>Encaminhado</situacao>
    <detalhes>Encaminhado para CTE SAUDE - SAO PAULO/SP</detalhes>
  </status>
  <status data="2009-01-28T06:40:00+00:00">
    <local>CTE SAUDE - SAO PAULO/SP</local>
    <situacao>Encaminhado</situacao>
    <detalhes>Encaminhado para CEE MOEMA - SAO PAULO/SP</detalhes>
  </status>
  <status data="2009-01-28T14:17:00+00:00">
    <local>CEE MOEMA - SAO PAULO/SP</local>
    <situacao>Saiu para entrega</situacao>
    <detalhes></detalhes>
  </status>
  <status data="2009-01-28T17:49:00+00:00">
    <local>CEE MOEMA - SAO PAULO/SP</local>
    <situacao>Entregue</situacao>
    <detalhes></detalhes>
  </status>
</encomenda>

Usando a API Ruby

require "rubygems"
require "correios"
encomenda = Correios.encomenda("ES446391025BR")
puts encomenda.numero
encomenda.status.each do |status|
  puts status.data
  puts status.local
  puts status.situacao
  puts status.detalhes
end

Outra forma de uso útil:

encomenda = Correios.encomenda("ES446391025BR")
puts encomenda.ultimo_status_disponivel.to_s

Números de rastreamento para teste

Outros números de encomenda para teste:

• RO811226537BR
• EC834786906BR
• SO376590583BR
• EC884014459BR
• EC726225124BR

correios-api's Issues

Dúvidas (2018)

Este código esta funcionando em PHP 5, 5.6, 7.0, 7.1 ou até mesmo em 7.2 ?
São muitas dúvidas e nada pessoal... (Já deixo claro)
Este código esta nas normativas novas dos correios (2017) e que pelo visto já existe novas normativas em (2018)...
Bom, este não é o único que visualizamos que aparentemente esta tudo correto.
Mas, tenho que ser este USUÁRIO questionador, já que estamos enfrentando tantos problemas seja eles em PHP, AJAX ou qualquer impulso anterior á 2017.
E assim vem as dúvidas...

Gostaria de saber se podemos implementar este código em outras ferramentas e até mesmo em outas plataformas...

Espero que tenhamos uma resposta satisfatória e um UPGRADE.

Error on ruby 1.9.1

ArgumentError: invalid byte sequence in UTF-8
from /usr/lib/ruby/gems/1.9.1/gems/guilhermechapiewski-correios-api-0.1.2/lib/correios.rb:31:in block in parse_tr' from /usr/lib/ruby/gems/1.9.1/gems/guilhermechapiewski-correios-api-0.1.2/lib/correios.rb:29:ineach'
from /usr/lib/ruby/gems/1.9.1/gems/guilhermechapiewski-correios-api-0.1.2/lib/correios.rb:29:in parse_tr' from /usr/lib/ruby/gems/1.9.1/gems/guilhermechapiewski-correios-api-0.1.2/lib/correios.rb:18:inblock in encomenda'
from /usr/lib/ruby/gems/1.9.1/gems/guilhermechapiewski-correios-api-0.1.2/lib/correios.rb:16:in each' from /usr/lib/ruby/gems/1.9.1/gems/guilhermechapiewski-correios-api-0.1.2/lib/correios.rb:16:inencomenda'