> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Połącz Posti
> Połącz Posti w Zippendo za pomocą pól Identyfikator klienta, Tajny klucz klienta i Numer umowy logistycznej oraz opcjonalnych Nazwa użytkownika Tracking API i Hasło Tracking API.
**Posti** wysyła paczki z Finlandii: do automatów paczkowych i punktów odbioru Posti, z doręczeniem do domu, jako Express na następny dzień, małe paczki pod drzwi, zwroty od klientów oraz paczki Priority i EMS na cały świat. Pola wspólne dla wszystkich przewoźników opisano w [Dane dostępowe przewoźników](/docs/pl/how-to/carrier-credentials).
W tym formularzu nie wybierasz adresu nadawcy. Swoje adresy dodajesz w menu organizacji → **Zarządzaj** → **Adresy**. Adres nadawcy wybierasz w każdej przesyłce albo w [regule wysyłki](/docs/pl/how-to/shipping-rule-fields). Posti wysyła z adresu w Finlandii lub na Wyspach Alandzkich, a zwroty dostarcza na adres w Finlandii.
## Zanim zaczniesz
* Konto klienta biznesowego Posti z **numerem umowy logistycznej**, zwykle sześciocyfrowym.
* Użytkownik w [OmaPosti Pro](https://pro.posti.fi/) z rolą **API Manager**, aby zalogować się do [Posti Developer Portal](https://developer.posti.com/). Jeśli nie masz tej roli, poproś głównego użytkownika OmaPosti Pro w Twojej organizacji, aby otworzył **Users management → Users**, kliknął **Edit** przy Twoim użytkowniku i zaznaczył **API Manager** w sekcji **Other services**.
* Konto aplikacji w Developer Portal, aby uzyskać **Identyfikator klienta** i **Tajny klucz klienta**. Kroki opisano poniżej.
* Opcjonalnie, do śledzenia przesyłek: konto usługi **Tracking API** od obsługi klienta Posti. Możesz wysyłać przesyłki bez niego.
Posti możesz połączyć więcej niż raz, na przykład jedno połączenie na każdą umowę logistyczną. Nadaj każdemu własną **Nazwa przewoźnika**. **Więcej informacji** na karcie otwiera stronę Posti o usługach dla e-commerce.
## Uzyskaj dane dostępowe Posti
Otwórz [developer.posti.com](https://developer.posti.com/) i zaloguj się swoim użytkownikiem OmaPosti Pro.
Otwórz **Configure application accounts → Application account list** i kliknij **Add new application account user**. Włącz **Enabled** i nadaj mu nazwę, na przykład `Zippendo`.
Wybierz **shippingapi** i **2026-04**. Bez **2026-04** możesz wysyłać przesyłki, ale wyszukiwarka punktów odbioru i zwroty bez etykiety nie działają.
Dodaj numer umowy logistycznej, który wpiszesz w Zippendo, a potem kliknij **Save**.
Portal pokazuje je tylko raz. Skopiuj oba. Jeśli zgubisz tajny klucz, utwórz w portalu nowe dane dostępowe i zaktualizuj przewoźnika w Zippendo.
Do śledzenia przesyłek poproś obsługę klienta Posti o konto usługi **Tracking API** dla Twojej umowy. Posti prześle Ci nazwę użytkownika i hasło.
## Połącz Posti
W menu bocznym kliknij **Przewoźnicy**, a potem otwórz kartę **Wszyscy przewoźnicy**.
Na karcie **Posti** kliknij **Połącz**.
Otworzy się okno **Połącz przewoźnika**. **Nazwa przewoźnika** jest już uzupełniona jako „Posti”. Wpisz **Identyfikator klienta**, **Tajny klucz klienta** i **Numer umowy logistycznej**. **Nazwa użytkownika Tracking API** i **Hasło Tracking API** znajdują się w sekcji **Pola opcjonalne**.
Kliknij **Połącz**. Zobaczysz „Połączono przewoźnika”, a przewoźnik pojawi się na karcie **Moi przewoźnicy**.
## Pola formularza
**Tajny klucz klienta** i **Hasło Tracking API** ukrywają wpisywany tekst.
| Pole | Wymagane | Co wpisać |
| - | - | - |
| **Nazwa przewoźnika** | Tak | Nazwa, którą widzisz w **Moi przewoźnicy** i przy wyborze przewoźnika w przesyłce. Na początku to **Posti**. |
| **Marka** | Nie | Widoczne tylko wtedy, gdy Twoja organizacja ma [marki](/docs/pl/how-to/create-a-brand). Formularz podaje: „Tylko ta marka może korzystać z tego przewoźnika.” Zostaw puste, aby mogła z niego korzystać każda marka. |
| **Identyfikator klienta** | Tak | Formularz podaje: „Z Developer Portal Posti (developer.posti.com): identyfikator klienta (Client ID) użytkownika konta aplikacji, którego dodajesz dla Zippendo. Wybierz obie role API: shippingapi i 2026-04.” |
| **Tajny klucz klienta** | Tak | Formularz podaje: „Tajny klucz klienta (Client secret), który Developer Portal pokazuje tylko raz, razem z identyfikatorem klienta (Client ID).” |
| **Numer umowy logistycznej** | Tak | Tylko cyfry. Formularz podaje: „Twój numer umowy logistycznej Posti, zwykle sześć cyfr zaczynających się od 6. Dodaj go do tego samego użytkownika konta aplikacji w Developer Portal, w przeciwnym razie Posti odrzuci Twoje przesyłki.” |
| **Nazwa użytkownika Tracking API** | Nie | Wypełnij oba pola śledzenia albo żadne. Formularz podaje: „Nazwa użytkownika Tracking API, którą obsługa klienta Posti przekazuje Ci dla Twojej umowy. Potrzebna tylko do śledzenia przesyłek.” |
| **Hasło Tracking API** | Nie | Formularz podaje: „Hasło, które Posti wysyła razem z nazwą użytkownika Tracking API. Po pięciu nieudanych próbach logowania Posti blokuje konto na godzinę.” |
**Połącz** nie działa, dopóki **Nazwa przewoźnika**, **Identyfikator klienta**, **Tajny klucz klienta** i **Numer umowy logistycznej** nie mają wartości.
## Przetestuj połączenie
Posti nie ma systemu testowego, więc nie ma pola wyboru **Tryb testowy**. Każda wysłana przesyłka to prawdziwa przesyłka Posti w ramach Twojej umowy logistycznej. Posti informuje, że przesyłka nie jest fakturowana, jeśli nie zostanie fizycznie wysłana, więc testowa etykieta, której nigdy nie przekażesz, nic nie kosztuje.
Aby przetestować połączenie, wyślij jedną przesyłkę na własny adres i sprawdź jej etykietę. Posti powiadamia odbiorcę, więc w testowej przesyłce podaj własny adres e-mail i numer telefonu. Zippendo nie może anulować przesyłki Posti, więc jeśli trzeba ją anulować, skontaktuj się z Posti. Zobacz [Tryb testowy](/docs/pl/how-to/sandbox-mode).
## Po połączeniu
Przewoźnik pojawia się w **Moi przewoźnicy** z oznaczeniem **Połączony**. Produkt wybierasz w każdej przesyłce albo w regule wysyłki, a nie w tym formularzu. Zobacz [Produkty przewoźników i usługi dodatkowe](/docs/pl/how-to/carrier-products-and-services). Produkt, którego nie ma w Twojej umowie z Posti, zostaje odrzucony przy wysyłce z powodem podanym przez Posti.
| Produkt | Dokąd doręcza | Maks. waga |
| - | - | - |
| **Postal Parcel (Postipaketti)** | Automat paczkowy lub punkt odbioru Posti w Finlandii, na Wyspach Alandzkich, w Estonii, na Łotwie lub Litwie. | 25 kg |
| **Home Parcel (Kotipaketti)** | Pod drzwi odbiorcy, w terminie uzgodnionym z nim przez Posti. Finlandia, Wyspy Alandzkie i kraje bałtyckie. | 25 kg, 35 kg jako paczka ponadgabarytowa |
| **Express Parcel (Express-paketti)** | Doręczenie następnego dnia za podpisem. Finlandia, Wyspy Alandzkie i kraje bałtyckie. | 25 kg, 35 kg jako paczka ponadgabarytowa |
| **Small Parcel to Door (Pikkupaketti ovelle)** | Do skrzynki na listy lub pod drzwi odbiorcy w Finlandii i na Wyspach Alandzkich, do 38 x 38 x 28 cm. | 4 kg |
| **Return (Palautus)** (przesyłka zwrotna) | Twój klient nadaje paczkę w dowolnym punkcie odbioru lub automacie paczkowym Posti, na Twój adres w Finlandii. | 25 kg, 35 kg jako paczka ponadgabarytowa |
| **Priority Parcel** | Ponad 200 krajów, pod drzwi lub do punktu odbioru, zależnie od kraju. | 25 kg, 30 kg jako paczka ponadgabarytowa |
| **EMS** | Ponad 200 krajów, pod drzwi za podpisem. | 25 kg, 30 kg jako paczka ponadgabarytowa |
Każdy produkt poza **Return (Palautus)** wymaga numeru telefonu odbiorcy na potrzeby powiadomień Posti. **Home Parcel (Kotipaketti)** i **Express Parcel (Express-paketti)** mogą obejmować kilka paczek w jednej przesyłce. Pozostałe produkty przyjmują jedną paczkę na przesyłkę.
### Usługi dodatkowe i dodatkowe dane
Każdy produkt ma dwie opcje w sekcji **Dodatkowe dane dla przewoźnika**:
* **Format etykiety**: PDF (domyślnie) lub ZPL dla drukarek termicznych.
* **Instrukcje doręczenia**: do 120 znaków drukowanych na etykiecie, na przykład kod do drzwi.
Etykiety mają rozmiar 10 x 15 cm. Produkty międzynarodowe, które nie mają etykiety w tym rozmiarze, drukują się na stronie A5.
Usługi dodatkowe wybierasz w przesyłce albo w regule wysyłki. Każdy produkt pokazuje usługi, które Posti dla niego oferuje: **Powiadomienie o przybyciu SMS-em lub e-mailem**, **Powiadomienie przed doręczeniem**, **Delikatna zawartość**, **Paczka ponadgabarytowa**, **Bez zewnętrznego automatu paczkowego**, **Doręczenie w sobotę**, **Wydanie osobiście (kontrola tożsamości)**, **Przesyłka polecona (wydanie za podpisem)**, **Doręczenie bez podpisu**, **Termin doręczenia uzgadniany telefonicznie**, **Telefon przed doręczeniem**, **Transport bez paliw kopalnych (przypisany udział)** oraz, tylko przy **Return (Palautus)**, **Zwrot bez etykiety (kod nadania)**. Wybierz **Paczka ponadgabarytowa** dla paczki powyżej 25 kg lub większej niż standardowy rozmiar produktu.
### Punkty odbioru Postipaketti
**Postal Parcel (Postipaketti)** doręcza do punktu odbioru. Przed wysłaniem wybierz punkt odbioru w sekcji **Punkt odbioru** przesyłki. Wyszukiwarka wymaga roli **2026-04** na Twoim koncie aplikacji. Zobacz [Wybierz punkt odbioru](/docs/pl/how-to/pick-a-service-point) i [Punkty odbioru](/docs/pl/how-to/drop-point-and-service-points).
### Zwroty
**Return (Palautus)** dostarcza paczkę od Twojego klienta na Twój adres. Nie wymaga punktu odbioru, a Twoja umowa z Posti musi obejmować zwroty od klientów.
Przy **Zwrot bez etykiety (kod nadania)** Twój klient zapisuje kod na paczce zamiast drukować etykietę. Przesyłka pokazuje kod jako **Kod zamiast etykiety** w sekcji **Informacje o śledzeniu**. Wyślij go klientowi. Jeśli Posti utworzy zwrot bez kodu, przesyłka pokaże ostrzeżenie. Wyślij wtedy klientowi etykietę.
### Cło
Przesyłki do kraju spoza UE oraz na Wyspy Alandzkie lub z nich, na Wyspy Kanaryjskie, do Ceuty lub Melilli zawierają dane celne z pozycji zamówienia: opis, numer taryfowy (kod HS), ilość, wartość i kraj pochodzenia. Posti zwraca deklarację celną i fakturę handlową razem z etykietą, a pojawiają się one wśród dokumentów przesyłki.
Swój numer EORI dodaj w [Ustawienia organizacji](/docs/pl/how-to/organization-settings). Jeśli odbiorca ma numer EORI, wpisz go w polu **Numer EORI odbiorcy** przy odbiorcy. Zobacz [Cło i dokumenty](/docs/pl/how-to/customs-and-documents).
### Odbiory przez kuriera i śledzenie przesyłek
* Posti nie jest dostępny w sekcji **Odbiory przez kuriera**. Odbiory umawiaj bezpośrednio z Posti. W przesyłce Posti nie możesz ustawić okna odbioru. Przewoźników, którzy są tam dostępni, opisuje [Zaplanuj odbiór](/docs/pl/how-to/schedule-a-pickup).
* Gdy pola **Nazwa użytkownika Tracking API** i **Hasło Tracking API** są wypełnione, Zippendo pobiera aktualizacje śledzenia z Posti mniej więcej co godzinę. Bez nich nie pojawiają się żadne zdarzenia śledzenia. Każda przesyłka nadal ma numer przesyłki i **Link do śledzenia** do posti.fi. Jeśli login do śledzenia jest nieprawidłowy, popraw go w **Edytuj przewoźnika** i kliknij **Zapisz**. Zobacz [Webhooki śledzenia przewoźników](/docs/pl/how-to/tracking-webhooks).
## Zmień lub usuń połączenie
Aby je zmienić, otwórz **Przewoźnicy** → **Moi przewoźnicy** i kliknij **Edytuj przewoźnika** na karcie. Strona **Edytuj przewoźnika** ma dwie sekcje:
* **Ogólne**: **Nazwa przewoźnika** oraz **Marka**, jeśli Twoja organizacja ma marki.
* **Ustawienia przewoźnika**: **Identyfikator klienta**, **Tajny klucz klienta**, **Numer umowy logistycznej**, **Nazwa użytkownika Tracking API** i **Hasło Tracking API**.
Kliknij **Zapisz**. Zobaczysz „Zaktualizowano przewoźnika”.
Aby je usunąć, kliknij **Usuń** na tej samej stronie, wpisz nazwę przewoźnika wielkimi literami i kliknij **Usuń**. Reguły wysyłki używające tego przewoźnika są usuwane razem z nim. Przesyłki, które już wysłałeś, zachowują swoje etykiety i numery przesyłek.
## Częste problemy
| Co widzisz | Co zrobić |
| - | - |
| „Nie udało się połączyć przewoźnika. Spróbuj ponownie.” | Sprawdź wymagane pola i spróbuj ponownie. |
| „Osiągnięto limit Twojego planu. Zmień plan albo usuń coś, czego już nie używasz.” | Osiągnięto limit przewoźników w Twoim planie. Zobacz [Rozliczenia i zużycie](/docs/pl/how-to/billing-and-usage). |
| „Przewoźnik odrzucił Twoje dane logowania. Zaktualizuj dane dostępowe w sekcji „Przewoźnicy”.” przy wysyłaniu | **Identyfikator klienta** lub **Tajny klucz klienta** jest nieprawidłowy albo konto aplikacji nie ma obu ról API. Popraw to w Developer Portal lub w **Edytuj przewoźnika**. |
| „Ustawienia przewoźnika są niekompletne lub nieprawidłowe. Sprawdź je w sekcji „Przewoźnicy”.” | **Numer umowy logistycznej** zawiera coś innego niż cyfry. Popraw to w **Edytuj przewoźnika**. |
| „Przewoźnik Posti nie mógł utworzyć przesyłki.” | Posti odrzucił przesyłkę, na przykład dlatego, że numer umowy logistycznej nie jest przypisany do konta aplikacji. Przesyłka pokazuje powód podany przez Posti. Popraw to i wyślij ponownie. |
| „Brakuje niektórych opcji tego produktu przewoźnika albo są one nieprawidłowe. Sprawdź usługi dodatkowe i opcje przesyłki, a potem spróbuj ponownie.” | Brakuje numeru telefonu odbiorcy, przesyłka ma za dużo paczek dla tego produktu, paczka jest za ciężka lub za duża albo Posti nie oferuje tam wybranej usługi. Przesyłka pokazuje, co jest nie tak. |
| „Ten produkt dostarcza do punktu odbioru. Przed wysłaniem wybierz punkt odbioru.” | Wybierz w przesyłce punkt odbioru dla **Postal Parcel (Postipaketti)**. |
| „Wybrany produkt przewoźnika nie obsługuje wysyłki między tymi krajami. Wybierz inny produkt.” | Wybierz produkt Posti, który obejmuje kraj odbiorcy. |
| „Deklaracja celna jest niekompletna. Każda pozycja musi mieć opis, ilość i zadeklarowaną wartość większą od zera.” | W pozycji zamówienia brakuje opisu, numeru taryfowego, ilości lub wartości. Uzupełnij ją i wyślij ponownie. |
| „Przewoźnik przyjął przesyłkę, ale nie przekazał etykiety ani kodu QR, a Zippendo nie może ponownie o nie poprosić. Poproś o nie przewoźnika i nie wysyłaj przesyłki ponownie.” | Skontaktuj się z Posti w sprawie etykiety. Nie wysyłaj przesyłki ponownie. |
| „Połączenie z przewoźnikiem zostało przerwane, zanim odpowiedział. Zippendo nie ma potwierdzenia, że przesyłka została utworzona, więc zanim wyślesz ją ponownie, sprawdź to u przewoźnika.” | Zanim wyślesz przesyłkę ponownie, sprawdź w Posti, czy istnieje. |
| Nie pojawiają się żadne zdarzenia śledzenia | Sprawdź, czy oba pola śledzenia są wypełnione i poprawne. |
| „Nie możemy teraz połączyć się z przewoźnikami. Spróbuj ponownie za chwilę.” lub „Przewoźnik odrzucił tę operację. Sprawdź podany przez niego powód, popraw dane i spróbuj ponownie.” | Odczekaj chwilę i wyślij ponownie albo popraw to, co wskazuje powód podany przez Posti. |
Więcej pomocy: [Błędy uwierzytelniania przewoźnika](/docs/pl/knowledge-base/carrier-authentication-failures).
## Powiązane
* [Połącz przewoźnika lub integrację](/docs/pl/how-to/connect-index)
* [Dane dostępowe przewoźników](/docs/pl/how-to/carrier-credentials)
* [Tryb testowy](/docs/pl/how-to/sandbox-mode)
* [Produkty przewoźników i usługi dodatkowe](/docs/pl/how-to/carrier-products-and-services)
* [Wybierz punkt odbioru](/docs/pl/how-to/pick-a-service-point)
* [Cło i dokumenty](/docs/pl/how-to/customs-and-documents)
* [Zgłoś integrację przewoźnika](/docs/pl/how-to/request-carrier-integration)
* [Przewoźnicy](/docs/pl/tutorials/carriers)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.