RichPear HOME DOCS Začít

Integrace RichPear Home

17TRACK

Integrace 17TRACK připojí účet 17track.net do RichPear Home a vytvoří senzory pro sledované zásilky. Hodí se pro přehled doručování, upozornění na změnu stavu a dashboard s aktuálními balíky.

Začít nastaveníZpět na audit
Doména
seventeentrack
Kategorie
Doručování
Komunikace
cloud-polling
Účet
17track.net
01

Připravte účet 17track.net

Před přidáním integrace se přihlaste na 17track.net a ověřte, že účet funguje a obsahuje zásilky, které chcete v RichPear Home sledovat.

Heslo k účtu musí mít nejvýše 16 znaků. Web 17track.net sice může dovolit delší heslo, ale API používané integrací takové heslo nepřijme.

Doporučení pro účet

  1. Použijte samostatný účet pro domácnost nebo servisní přístup, pokud nechcete napojovat osobní hlavní účet.
  2. Před nastavením ověřte přihlášení na webu 17track.net.
  3. Do účtu přidejte aspoň jednu testovací zásilku, jinak se po připojení nemusí objevit žádné praktické senzory.
  4. Po změně hesla integraci znovu nakonfigurujte nebo opravte přihlašovací údaje.
02

Vyberte integraci 17TRACK

V RichPear Home otevřete Nastavení → Zařízení a služby, klikněte na Přidat integraci a v seznamu vyberte 17TRACK.

Výběr 17TRACK v dialogu Přidat integraci.
03

Zadejte přihlašovací údaje

Do formuláře zadejte Uživatelské jméno a Heslo k účtu 17track.net. Po odeslání RichPear Home začne pravidelně načítat informace ze služby 17TRACK.

Pokud přihlášení selže a jste si jistí uživatelským jménem, zkontrolujte délku hesla. Heslo delší než 16 znaků je častá příčina neúspěšného připojení.

Konkrétní český formulář integrace 17TRACK: uživatelské jméno a heslo.
04

Zkontrolujte stavy zásilek

Integrace vytváří souhrnné senzory podle stavu zásilek a také jednotlivé senzory pro zásilky v účtu. Hodnota souhrnného senzoru je počet zásilek v daném stavu.

Stavy z 17TRACK API

  1. Nenalezeno.
  2. Na cestě.
  3. Vypršelo.
  4. Připraveno k vyzvednutí.
  5. Nedoručeno.
  6. Doručeno.
  7. Vráceno.
05

Přidejte přehled na dashboard

Pro jednoduchý přehled stačí na dashboard přidat entity vytvořené integrací. Pokud chcete vypsat konkrétní zásilky ve vybraném stavu, vytvořte šablonový senzor, který zavolá akci seventeentrack.get_packages.

Příklad šablonového senzoru

template:
  - trigger:
      - trigger: time_pattern
        hours: /1
      - trigger: homeassistant
        event: start
    action:
      - action: seventeentrack.get_packages
        data:
          config_entry_id: YOUR_CONFIG_ENTRY_ID
          package_state:
            - in_transit
        response_variable: result
    sensor:
      - name: "Zásilky na cestě"
        unique_id: packages_in_transit
        state: "{{ result.packages | count }}"
        attributes:
          packages: "{{ result.packages }}"
06

Použijte akce integrace

17TRACK přidává akce, které můžete použít v automatizacích nebo ve vývojářských nástrojích. Pro všechny je potřeba znát config_entry_id konkrétní 17TRACK položky.

config_entry_id získáte v detailu integrace 17TRACK přes nabídku se třemi tečkami a volbu pro zkopírování ID položky.

Dostupné akce

  1. seventeentrack.get_packages načte balíky podle vybraných stavů.
  2. seventeentrack.archive_package archivuje zásilku podle sledovacího čísla.
  3. seventeentrack.add_package přidá zásilku podle sledovacího čísla a názvu.
07

Ověřte výsledek a typické chyby

Po připojení účtu otevřete detail integrace a zkontrolujte, že vznikly senzory pro stavy zásilek. Pokud v účtu nejsou žádné zásilky, počet senzorů a jejich hodnoty mohou být omezené.

Při problémech nejdřív ověřte přihlášení na 17track.net, délku hesla, existenci zásilek v účtu a dostupnost internetu z RichPear Home.

Průvodce přidáním byl ověřen v českém RichPear Home na adrese https://rphome.sheri.cz. Vytvoření reálných entit vyžaduje platný 17track.net účet se zásilkami.
URL

Lokální adresa systému

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.