Integração com os Correios - Rastreio de objetos postados nos Correios!

Salve comunidade Home Assistant, venho aqui trazer a minha primeira contribuição, a pouco tempo eu conheci o Home Assistant Brasil e através aqui do fórum eu consegui realizar várias configurações no meu HA.

nuvemcc

Olhando os posts do pessoal, me deparei com um sobre rastreio de objetos dos correios:

Rastreio de mercadorias pelo Correios

Eu achei bem interessante e resolvi então criar uma integração via HACS, eu não sou muito experiente com Python mas ficou bem funcional, fico aberto a sugestões ou contribuições no Git, segue documentação:

GIT - Home Assistant Correios

Rastreamento de objetos nos correios.

exemplo1

Vá no HACS e clique em Integrações!

Clique no menu e vá em Repositórios personalizados.

Preencha com o endereço do github do componente https://github.com/oridestomkiel/home-assistant-correios e selecione Integração. Clique em Adicionar.

Clique em Baixar.

3

Clique em Baixar esse repositório no HACS.

Clique em Baixar.

4

Reinicie o Home Assistant.

5

Com ele reiniciado, vá em Configurações, depois em Dispositivos e serviços.

Vá no canto direito embaixo e clique em “+ Adicionar Integração” e ache Rastreamento Correios.

Preencha com um nome e o código de rastreio.

2

Pronto!

fim

Estado e Atributos:

Estado:

  • Descrição do status atual do objeto

- EVENTOS SRO - CORREIOS

Lista eventos Correios

Atributos:

  • Descrição: Apelido dado ao objeto no arquivio de configuração
  • Código Objeto: Código identificador do objeto nos Correios
  • Data Prevista: Quando existente, exibe a previsão de entrega do objeto
  • Tipo Postal: Tipo de serviço referente ao pacote enviado.
  • Movimentações: Lista com todas as movimenrações do pacote, desde a postagem até a entrega.

Os eventos são todos listados nos Atributos e é atualizado a cada 5min assim como o Estado.

Em breve eu vou tentar atualizar o componente para que os códigos dos Correios possam ser parametrizáveis assim como algumas melhorias ou sugestões.

Um abraço a todos!

22 Likes

Parabéns pela iniciativa! :clap: :clap: :clap:

1 Like

Boa tarde, ótima ideia. Mas não estou conseguindo eu baixo o repositório, reinicio o HA mas a integração não aparece no Hacs.

Olá, veja se aparece algum erro no seu log ao iniciar:

http://…IP:PORTA…/config/logs

Realmente podem haver bugs já que não tenho como testar em muitos ambientes/versões.

Abs

Não tem nada, no log. Onde mais posso verificar.

Após adicionar o repositório:

https://github.com/oridestomkiel/home-assistant-correios

image

Aparece o HAC abaixo?

image

Eu realizei os testes somente na VM no Virtual Box e na minha instância do HA no Debian 11 e não tive esse problema :confused:

No info também tem a informação da instalação após reiniciado:

http://…IP:PORTA…/config/info

image

Se puder manda um arquivo com a configuração do seu HA para eu tentar simular:

image

Abs

Depois que você reinicia ela aparece no HACS.
Eu uso em uma VM tbm mas instalação direta para VM.

No meu naão aparece.

Otimo, fiz a instalacao e esta rastreando.
Acontece que encomendas internacionais nao estao sendo rastreadas.
Adicionei 8 rastreios e ele so esta rastreando 4 no momento.

Olá, eu tenho encomendas internacionais, e elas aparecem assim que chegam ao Brasil ou passam pala alfândega como exemplo abaixo:

Antes disso elas ficam com o status de “Não encontrado na base dos correios”

Abs

Parabéns pela integração.

Fiz algumas alterações para usar aqui pelo fluxo de configuração o que permite incluir e excluir os objetos que serão rastreados sem reiniciar o HA.
Criei um PR para compartilhar, avalie se é viável a mesclagem ao projeto.

Abraço.

1 Like

Caramba Douglas, tu é o cara! Valeu pela contribuição, já realizei o merge e vou atualizar a documentação e te add como colaborador!!!

Vamos que vamos!

Abs

1 Like

Tive alguns problemas, várias encomendas não apareceram os sensores!

Adicionei 9 números de rastreio já com a atualização + nova!

Deles só 3 apareceram os sensores:

Veja se tem logs de erros, também tive alguns problemas e criei um issue no repositório.

Não aparece nenhum erro na tela de logs do HA

Eu já identifiquei o problema e estou corrigindo:

image

Em alguns casos(china) não existe as chaves “cidade” e “uf”

1 Like

Uso um custom card para exibir todos os rastreios com base no filtro do fabricante do dispositivo (serviço neste caso). Usando assim ao adicionar ou remover o objeto à integração já aparece no card do lovelace automaticamente (vai funcionar apenas se você já estiver usando a versão que permite a inclusão dos objetos via interface):

image

O repositório do custom card para adicionar no HACS é: GitHub - thomasloven/lovelace-auto-entities: 🔹Automatically populate the entities-list of lovelace cards

Código que uso no card:

type: vertical-stack
cards:
  - show_name: true
    show_icon: false
    type: button
    tap_action:
      action: navigate
      navigation_path: /_my_redirect/config_flow_start?domain=correios
    name: Adiconar Rastreio
    hold_action:
      action: none
    show_state: false
  - type: custom:auto-entities
    card:
      type: entities
      title: Rastreio Correios
      state_color: false
    filter:
      include:
        - device_manufacturer: Correios
      exclude: []
    show_empty: false
    sort:
      method: last_changed
7 Likes

@oridestomkiel já pensou em por o componente dos Correios no HACS? Ter ele no HACS + gente vai ter acesso e usar!
Tem o link abaixo explicando como por.

1 Like

Top!!! para mim era uma das coisas que faltavam dentro do HA

Meu único receio é que uso uma API dos correios que não sei por quanto tempo irá funcionar, por não ser oficial, eles usam essa API no app deles e podem a qualquer momento retirar do ar ou colocar algum tipo de autenticação. Mas mesmo assim eu vou seguir a dica e publicar no HACS. Abs

1 Like