> ## 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 PostNL > Połącz PostNL w sekcji Przewoźnicy za pomocą klucza API, kodu klienta i numeru klienta oraz opcjonalnego miejsca przekazania przesyłek i trybu testowego. **PostNL** wysyła paczki w Holandii i Belgii: pod drzwi, do punktów PostNL i automatów paczkowych, z oknami doręczenia i zwrotami. Wysyła też w całej UE i na świecie z deklaracjami celnymi. Pola wspólne dla wszystkich przewoźników opisuje [Dane dostępowe przewoźników](/docs/pl/how-to/carrier-credentials). W tym formularzu nie wybierasz adresu nadawcy. Dodaj swoje adresy w menu organizacji → **Zarządzaj** → **Adresy**. Adres nadawcy wybierasz przy każdej przesyłce lub w [regule wysyłki](/docs/pl/how-to/shipping-rule-fields). Każda przesyłka PostNL jest wysyłana z Twoim własnym kluczem API PostNL i danymi z Twojej umowy. ## Zanim zaczniesz * Umowa biznesowa z PostNL (PostNL Pakketten) z włączonymi produktami, z których chcesz korzystać. * **Klucz API** PostNL z [Mijn PostNL](https://mijn.postnl.nl/). PostNL daje Ci jeden klucz do systemu testowego i drugi do prawdziwych przesyłek. Klucz testowy działa tylko przy włączonym **Tryb testowy**. * Twój **Kod klienta** PostNL (od 1 do 6 znaków, na przykład `DEVC`) i **Numer klienta** (do 8 cyfr). Oba znajdziesz w umowie z PostNL i w Mijn PostNL. * Opcjonalnie: 6-cyfrowy kod **Miejsce przekazania przesyłek**, jeśli dostałeś go od PostNL. PostNL możesz połączyć więcej niż raz, na przykład osobne połączenie dla każdej umowy. Nadaj każdemu własną **Nazwa przewoźnika**. **Więcej informacji** na karcie otwiera stronę PostNL dla klientów biznesowych. ## Połącz PostNL Kliknij w menu bocznym **Przewoźnicy**, a potem otwórz kartę **Wszyscy przewoźnicy**. Na karcie **PostNL** kliknij **Połącz**. Otworzy się okno **Połącz przewoźnika**. Wpisz **Nazwa przewoźnika**, swój **Klucz API**, **Kod klienta** i **Numer klienta**. **Miejsce przekazania przesyłek** i **Tryb testowy** 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 w formularzu | 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 **PostNL**. | | **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 każda marka mogła z niego korzystać. | | **Klucz API** | Tak | Twój klucz z Mijn PostNL. Formularz podaje: „Twój klucz API PostNL z Mijn PostNL (klucze testowe działają tylko w trybie testowym).” | | **Kod klienta** | Tak | Formularz podaje: „Kod klienta w PostNL Pakketten (1–6 znaków, np. DEVC).” | | **Numer klienta** | Tak | Formularz podaje: „Numer klienta w PostNL Pakketten (do 8 cyfr).” | | **Miejsce przekazania przesyłek** | Nie | Dokładnie 6 cyfr. Formularz podaje: „6-cyfrowy kod miejsca przekazania przesyłek PostNL z Twojej umowy, jeśli go masz.” | | **Tryb testowy** | Nie | Pole wyboru, domyślnie wyłączone. Formularz podaje: „Używaj systemu testowego PostNL z testowym kluczem API. Przy prawdziwych przesyłkach zostaw wyłączone.” | **Połącz** nic nie robi, dopóki **Nazwa przewoźnika**, **Klucz API**, **Kod klienta** i **Numer klienta** nie mają wartości. Jeśli **Kod klienta** ma więcej niż 6 znaków, **Numer klienta** ma więcej niż 8 albo **Miejsce przekazania przesyłek** nie ma dokładnie 6 znaków, zobaczysz „Nie udało się połączyć przewoźnika. Spróbuj ponownie.” **Tryb testowy** wysyła Twoje przesyłki do systemu testowego PostNL, więc nie powstają prawdziwe przesyłki. Gdy jest włączony, użyj testowego klucza API, a gdy wyłączony, klucza produkcyjnego. 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 przy każdej przesyłce lub w regule wysyłki, nie w tym formularzu. Zobacz [Produkty i usługi przewoźnika](/docs/pl/how-to/carrier-products-and-services). Opis każdego produktu zawiera jego kod produktu PostNL, więc możesz porównać go z umową. Wysyłać możesz tylko produktami, które PostNL włączył dla Ciebie. Pozostałe produkty są odrzucane przy wysyłaniu z komunikatem „Przewoźnik PostNL nie mógł utworzyć przesyłki.” Grupy produktów: * W obrębie Holandii (nadawca w Holandii): **Przesyłka standardowa**, doręczenie tylko na wskazany adres, podpis przy doręczeniu, dodatkowe ubezpieczenie, weryfikacja wieku, paczki do skrzynki na listy oraz produkty **Odbiór**. * Z Holandii do Belgii, w obrębie Belgii i z Belgii do Holandii, każda trasa z własnymi produktami. * **Parcel EU**, dla konsumentów (2C) i firm (2B), w wersjach Track & Trace, Insured i Insured Plus. * **Parcel Non EU** i międzynarodowe produkty pocztowe (takie jak **Packet Track & Trace**) dla reszty świata. Mają deklarację celną tworzoną z pozycji zamówienia. * **Zwroty**: zwrot na numer odpowiedzi dla firm lub na adres domowy, zwroty w Belgii i do Belgii oraz **Easy Return Service** z zagranicy. ### Okna doręczenia i dodatkowe opcje Produkty w obrębie Holandii oferują te usługi dodatkowe: **Doręczenie wieczorne (17:30–22:00)**, **Doręczenie dziś (przekaż przesyłkę do 11:00)** i **Gwarantowane doręczenie do 10:00**, **12:00** lub **17:00**. Gdy włączysz jedną z nich, uzupełnij też **Data doręczenia** w sekcji **Dodatkowe dane dla przewoźnika**. Niektóre produkty wymagają dodatkowych danych przy przesyłce: * Produkty z dodatkowym ubezpieczeniem wymagają **Kwota ubezpieczenia (EUR)**, do 5000. * Produkty z weryfikacją wieku wymagają **Data urodzenia odbiorcy**. * Paczki do skrzynki na listy wymagają **Data doręczenia**. * **Format etykiety** pozwala wybrać **PDF** (domyślnie) lub **ZPL (drukarki termiczne)** dla drukarki etykiet Zebra. ### Punkty PostNL (punkty odbioru) Produkty, których nazwy zaczynają się od **Odbiór**, dostarczają do punktu PostNL, takiego jak sklep lub automat paczkowy. Punkty są dostępne dla adresów w Holandii i Belgii. Wybierz punkt przy przesyłce przed wysłaniem. Zobacz [Wybierz punkt odbioru](/docs/pl/how-to/pick-a-service-point) i [Punkty odbioru](/docs/pl/how-to/drop-point-and-service-points). ### Kilka paczek w jednej przesyłce W jednej przesyłce możesz wysłać do czterech paczek. Paczki do skrzynki na listy to zawsze jedna paczka na przesyłkę. W obrębie Holandii PostNL traktuje paczki jako jedną przesyłkę z etykietą dla każdej paczki. Na innych trasach każda paczka staje się osobną przesyłką PostNL. ### Odbiory przez kuriera, śledzenie i cło * PostNL nie jest dostępny w sekcji **Odbiory przez kuriera**. Odbiory przez kuriera organizuje się w ramach umowy z PostNL. * Zippendo pobiera aktualizacje śledzenia z PostNL co godzinę. Nie trzeba niczego konfigurować. Zobacz [Webhooki śledzenia przewoźników](/docs/pl/how-to/tracking-webhooks). * Dla przesyłek spoza UE PostNL zwraca razem z etykietą deklaracje celne (CN23/CP71) i fakturę handlową, więc Zippendo nie dodaje własnych. Zobacz [Cło i dokumenty](/docs/pl/how-to/customs-and-documents). ## 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**: **Klucz API**, **Kod klienta**, **Numer klienta**, **Miejsce przekazania przesyłek** i **Tryb testowy**. 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. ## Typowe problemy | Co widzisz | Co zrobić | | - | - | | „Nie udało się połączyć przewoźnika. Spróbuj ponownie.” | Sprawdź wymagane pola i opisane wyżej długości, a potem 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 | Klucz API jest błędny albo nie pasuje do ustawienia **Tryb testowy** (klucz testowy przy wyłączonym **Tryb testowy** lub odwrotnie). Popraw go w **Edytuj przewoźnika**. | | „Przewoźnik PostNL nie mógł utworzyć przesyłki.” lub własny komunikat błędu PostNL | PostNL odrzucił przesyłkę, na przykład dlatego, że produkt nie jest w Twojej umowie albo adres jest błędny. Popraw to, co wskazuje komunikat, 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 wymaganych danych, takich jak **Kwota ubezpieczenia (EUR)**, **Data doręczenia** lub **Data urodzenia odbiorcy**. Uzupełnij je w sekcji **Dodatkowe dane dla przewoźnika**. | | „Ten produkt dostarcza do punktu odbioru. Przed wysłaniem wybierz punkt odbioru.” | Wybierz punkt PostNL przy przesyłce. | | „Wybrany produkt przewoźnika nie obsługuje wysyłki między tymi krajami. Wybierz inny produkt.” | Wybierz produkt dla tej trasy, na przykład produkt **Parcel EU** dla innego kraju UE. | ## 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 i usługi przewoźnika](/docs/pl/how-to/carrier-products-and-services) * [Wybierz punkt odbioru](/docs/pl/how-to/pick-a-service-point) * [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.