polish_shipment_tracking

KO | EN

gitlite — search

#python #react #typescript #golang #machine-learning #rust #docker #macos #java #awesome #cli #pytorch #mcp #ios

polish_shipment_tracking

(★ 17)

Integracja dla Home Assistant do śledzenia przesyłek u popularnych przewoźników w Polsce.

polish_shipment_tracking 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Polish Shipment Tracking

English version: [README_EN.md](README_EN.md)

![Shipment Tracking card](https://raw.githubusercontent.com/stirante/polish_shipment_tracking/main/images/screenshot.png)

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://raw.githubusercontent.com/stirante/polish_shipment_tracking/main/LICENSE)

Integracja dla Home Assistant do śledzenia przesyłek u popularnych przewoźników w Polsce. Tworzy encje sensor dla aktywnych przesyłek oraz zawiera kartę Lovelace z listą przesyłek.

## Funkcje

- Obsługa wielu przewoźników w jednej integracji (Config Flow)
- Encje sensor dla aktywnych przesyłek
- Normalizacja statusów na wspólny zestaw stanów
- Automatyczne wykrywanie nowych przesyłek oraz sprzątanie starych encji
- Wbudowana karta Lovelace:
  - serwowana przez integrację
  - automatyczna rejestracja zasobu w dashboardach w trybie storage

> [!TIP]
> Możesz dodać wiele kont / numerów dla tego samego przewoźnika (np. dla dwóch osób).

## Wspierani przewoźnicy

- InPost
- DHL
- DPD
- Pocztex
- GLS

> [!WARNING]
> Integracja korzysta z nieoficjalnych API aplikacji/serwisów przewoźników. Te API mogą ulec zmianie bez uprzedzenia.

> [!CAUTION]
> Nie ponoszę odpowiedzialności za ewentualne blokady lub ograniczenia konta przez przewoźnika.

## Wymagania

- Home Assistant: 2024.6 lub nowszy
- (Opcjonalnie) HACS: 1.30 lub nowszy

## Instalacja

### Instalacja przez HACS (zalecane)

1. Otwórz HACS -> Integrations.
2. Dodaj repo jako Custom repository:
   - Repository: https://github.com/stirante/polish_shipment_tracking
   - Category: Integration
3. Zainstaluj integrację.
4. Zrestartuj Home Assistant.

### Instalacja ręczna

1. Skopiuj katalog `custom_components/polish_shipment_tracking` do:
   `<config>/custom_components/polish_shipment_tracking`
2. Zrestartuj Home Assistant.

## Konfiguracja

1. Ustawienia -> Urządzenia i usługi -> Dodaj integrację
2. Wyszukaj "Polish Shipment Tracking"
3. Wybierz przewoźnika i uzupełnij wymagane dane logowania
4. Zapisz

Po pierwszym odświeżeniu powinny pojawić się encje `sensor` dla przesyłek.

## Encje

Integracja tworzy encję `sensor` dla każdej aktywnej (niedostarczonej) przesyłki.

- unique_id: `<courier>_<shipment_id>`
- stan sensora: status znormalizowany (np. in_transport)
- atrybuty: zależnie od przewoźnika, przykładowo:
  - numer przesyłki
  - status surowy
  - historia zdarzeń
  - daty zdarzeń
  - informacje o punkcie odbioru

## Zdarzenia (custom events)

Integracja publikuje zdarzenia na magistrali `hass.bus`:

- `polish_shipment_tracking_new_shipment` - nowa przesyłka
- `polish_shipment_tracking_shipment_status_changed` - przesyłka zmieniła stan

Przykładowy payload:

```json
{
  "courier": "inpost",
  "shipment_id": "1234567890",
  "entity_id": "sensor.inpost_paczka_1234567890",
  "status_raw": "in_transit",
  "status_key": "in_transport"
}
```

Dla `polish_shipment_tracking_shipment_status_changed` dodatkowo występują pola:

- `old_status_raw`
- `old_status_key`
- `new_status_raw`
- `new_status_key`

## Statusy (normalizacja)

Różne nazwy statusów przewoźników są mapowane do wspólnego zestawu. Przykładowo:
- created
- in_transport
- waiting_for_pickup
- delivered
- exception
- cancelled
- returned
- unknown

> [!NOTE]
> Mapowanie statusów nie jest jeszcze kompletne; PR-y z nowymi mapowaniami są mile widziane.

Dokładne mapowania są w kodzie integracji (sensor.py).

## Karta Lovelace

Integracja zawiera kartę Lovelace (JavaScript module) i automatycznie dodaje ją jako zasób w dashboardach.

## Debugowanie

Możesz włączyć debug logi dla integracji:

```yaml
logger:
  default: info
  logs:
    custom_components.polish_shipment_tracking: debug
```

## Znane problemy

* Zmiany po stronie przewoźników (API, autoryzacja, limity) mogą powodować błędy logowania lub pobierania przesyłek.

## Zgłoszenia błędów i wsparcie

* Issues: [https://github.com/stirante/polish_shipment_tracking/issues](https://github.com/stirante/polish_shipment_tracking/issues)
* Pull requests: mile widziane

W zgłoszeniu błędu dołącz:

* wersję Home Assistant
* logi (z włączonym debug dla integracji)
* wybranego przewoźnika
* opis kroków odtworzenia

## Licencja

GNU General Public License v3.0. Zobacz plik LICENSE.

polish_shipment_tracking

polish_shipment_tracking 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

polish_shipment_tracking

polish_shipment_tracking 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README