A small integration to provide information about delivery days for Postnord and Citymail in any swedish postal code as defined by Postnord and Citymail. The integration will create a sensor for each postal code, and also separate sensors for Postnord and/or Citymail as specified. The common sensor will show the next delivery date regardless of operator.
- Open HACS in Home Assistant
- Go to "Integrations"
- Click the "+" button
- Search for "Svensk Postutdelning"
- Install the integration
- Restart Home Assistant
- Download the latest release from GitHub
- Extract the
custom_components/swemailfolder to your Home Assistant'scustom_componentsdirectory - Restart Home Assistant
- Go to Settings → Devices & Services
- Click Add Integration
- Search for "Svensk Postutdelning"
- Follow the configuration steps.
I have tried to use machine translation to create a few useable translations. Please correct me if there are any major wrongs or you are missing some languages:
- 🇬🇧 English (en.json) - English
- 🇸🇪 Swedish (sv.json) - Svenska
- 🇮🇸 Icelandic (is.json) - Íslenska
- 🇩🇰 Danish (da.json) - Dansk
- 🇳🇴 Norwegian (no.json) - Norsk
- 🇫🇮 Finnish (fi.json) - Suomi
- 🇪🇸 Spanish (es.json) - Español
- 🇹🇷 Turkish (tr.json) - Türkçe
- 🇸🇦 Arabic (ar.json) - العربية
- 🇺🇦 Ukrainian (uk.json) - Українська
- 🇫🇷 French (fr.json) - Français
For each configured postal code a device is created with:
- Days until delivery sensor(s) – number of days until the next delivery (per provider, plus a combined sensor when several providers are enabled).
- Delivery today / tomorrow binary sensors –
onwhen mail is delivered that day. Great for automations. - Delivery calendar – upcoming delivery days as all-day calendar events (works with Home Assistant calendar triggers).
- Optional (opt-in via the integration options): a next delivery date sensor and a postal city sensor per provider.
Attributes on the days sensors include next_delivery, upcoming_delivery, postal_city and last_update.
When creating an automation, pick the "Mail Delivery" device and choose a trigger such as "Mail is delivered today" or "Mail is delivered tomorrow" — no templates required.
The integration fires the following events you can trigger on:
swemail_delivery_today– fired when the next delivery becomes today. Data:postal_code,provider,next_delivery.swemail_next_delivery_changed– fired when the next delivery date changes. Data:postal_code,provider,next_delivery,previous.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
See CHANGELOG.md for version history.