> ## 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 Royal Mail

> Połącz Royal Mail w sekcji Przewoźnicy za pomocą klucza API Click & Drop, opcjonalnego przewoźnika Click & Drop oraz ID klienta i sekretu klienta API Portal dla śledzenia i Local Collect.

**Royal Mail** wysyła z Zippendo paczki krajowe w Wielkiej Brytanii i międzynarodowe oraz Tracked Returns przez Twoje konto Click & Drop. Pola wspólne dla wszystkich przewoźników opisano w [Dane dostępowe przewoźników](/docs/pl/how-to/carrier-credentials).

<Info>
  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).
</Info>

<Warning>
  Royal Mail wydaje etykiety przez Click & Drop tylko klientom z kontem **Online Business Account (OBA)**. Przy osobistym koncie Click & Drop Royal Mail nie zwraca etykiety. Wtedy Zippendo nie tworzy przesyłki i ponownie usuwa zamówienie z Click & Drop. Jeśli to usunięcie się nie powiedzie, błąd podaje numer zamówienia Click & Drop, aby można je było usunąć samodzielnie.
</Warning>

## Zanim zaczniesz

Najpierw skonfiguruj w Click & Drop:

* Konto Royal Mail **Online Business Account** połączone z Click & Drop, z włączonymi usługami, których chcesz używać.
* **Settings → Label format** ustawione na **6 x 4** (termiczne). Zippendo zawsze tworzy etykiety w tym rozmiarze.
* **Trading name** w Click & Drop zapisaną dokładnie tak jak nazwa firmy w Twoim adresie nadawcy (lub w adresie zwrotnym). Royal Mail drukuje na etykiecie adres zwrotny tej trading name.
* Integrację **Click & Drop API**. W Click & Drop przejdź do **Settings → Integrations → Click & Drop API**, wybierz domyślną trading name i kliknij **Update**. Otwórz wiersz integracji, aby zobaczyć **authorisation key**. Każde konto Click & Drop ma tylko jedną taką integrację.

Opcjonalnie, dla śledzenia w Zippendo i dla Local Collect: aplikacja w [Royal Mail API Developer Portal](https://developer.royalmail.net/) (**My Apps → Create new app**). Poproś opiekuna konta Royal Mail o włączenie produktów **Tracking** i **Local Collect** na Twoim koncie. Zwykle trwa to krócej niż tydzień, a oba produkty są bezpłatne.

Royal Mail możesz połączyć więcej niż raz. Nadaj każdemu połączeniu własną **Nazwa przewoźnika**. **Więcej informacji** na karcie otwiera stronę Click & Drop Royal Mail.

## Połącz Royal Mail

<Steps>
  <Step title="Otwórz Wszyscy przewoźnicy">
    W panelu bocznym kliknij **Przewoźnicy**, a potem otwórz kartę **Wszyscy przewoźnicy**.
  </Step>

  <Step title="Znajdź Royal Mail">
    Na karcie **Royal Mail** kliknij **Połącz**.
  </Step>

  <Step title="Wypełnij formularz">
    Otworzy się okno **Połącz przewoźnika**. Wpisz **Nazwa przewoźnika** i **Klucz API**. **Przewoźnik w Click & Drop**, **Identyfikator klienta w API Portal** i **Tajny klucz klienta w API Portal** znajdują się w **Pola opcjonalne**.
  </Step>

  <Step title="Połącz przewoźnika">
    Kliknij **Połącz**. Zobaczysz „Połączono przewoźnika”, a przewoźnik pojawi się na karcie **Moi przewoźnicy**.
  </Step>
</Steps>

## Pola formularza

| Pole | Wymagane | Co wpisać |
| - | - | - |
| **Nazwa przewoźnika** | Tak | Nazwa widoczna w **Moi przewoźnicy** i przy wyborze przewoźnika w przesyłce. Zaczyna się jako **Royal Mail**. |
| **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 | Authorisation key z Click & Drop. Formularz podaje: „Klucz autoryzacyjny API Click & Drop (Settings → Integrations → Click & Drop API). Etykiety przez API wymagają konta Online Business Account (OBA).” Jeśli usuniesz i ponownie utworzysz integrację w Click & Drop, dostaniesz nowy klucz. Zaktualizuj go tutaj. |
| **Przewoźnik w Click & Drop** | Nie | Formularz podaje: „Tylko jeśli Twoje konto Click & Drop ma więcej niż jednego przewoźnika (numer OBA + miejsce nadania): nazwa przewoźnika z Settings → Shipping Carriers.” Zostaw puste, jeśli Twoje konto ma jednego. |
| **Identyfikator klienta w API Portal** | Nie | Z Twojej aplikacji w portalu dla deweloperów (**My Apps** → Twoja aplikacja). Formularz podaje: „ID klienta Twojej aplikacji na developer.royalmail.net (My Apps). Włącza śledzenie Royal Mail i wyszukiwarkę lokalizacji Local Collect. Najpierw poproś opiekuna konta Royal Mail o włączenie produktów Tracking i Local Collect na Twoim koncie.” Jedna aplikacja obsługuje oba produkty. |
| **Tajny klucz klienta w API Portal** | Nie | Z tej samej aplikacji. Portal pokazuje go raz, gdy tworzysz aplikację; jeśli go zgubisz, zresetuj go w portalu. Formularz podaje: „Sekret klienta tej samej aplikacji w portalu dla deweloperów. Wymagany do śledzenia; Local Collect działa samym ID klienta.” |

**Połącz** nic nie robi, dopóki **Nazwa przewoźnika** i **Klucz API** nie mają wartości.

Royal Mail nie ma opcji **Tryb testowy**, ponieważ Click & Drop nie ma systemu testowego. Każda utworzona etykieta jest prawdziwą etykietą na Twoim koncie. 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, a nie w tym formularzu. Zobacz [Produkty i usługi dodatkowe przewoźników](/docs/pl/how-to/carrier-products-and-services).

| Temat | Jak to działa z Royal Mail |
| - | - |
| Produkty | Royal Mail 24 i 48, Tracked 24 i 48 (także wersje High Volume, Letterboxable i Age Verification), Special Delivery, 1st i 2nd Class, Signed For, International Standard, Tracked, Signed i Economy On Account oraz International Business Parcels and Mail. |
| Dokąd dostarczają | Produkty krajowe dostarczają do Wielkiej Brytanii, Irlandii Północnej, Jersey, Guernsey i Wyspy Man. Przesyłki do Jersey, Guernsey i Wyspy Man mają deklarację celną. Produkty międzynarodowe dostarczają wszędzie indziej. |
| Zwroty | **Royal Mail Tracked Returns 24** i **Royal Mail Tracked Returns 48**. Royal Mail wystawia etykietę PDF i kod QR. Klient może pokazać kod QR na poczcie lub w punkcie odbioru zamiast drukować etykietę. |
| Dokumenty celne | Royal Mail drukuje CN22 lub CN23 razem z etykietą, gdy przesyłka tego wymaga. Zippendo nie dodaje własnej deklaracji celnej ani faktury handlowej. |
| Format paczki | Zippendo ustala format Royal Mail (list, duży list, mała paczka, średnia paczka lub paczka) na podstawie rozmiaru i wagi paczki. Aby wybrać go samodzielnie, ustaw **Format paczki** w przesyłce lub w regule wysyłki. |
| Punkty odbioru | Royal Mail nazywa je lokalizacjami **Local Collect**: urzędy pocztowe, Customer Service Points Royal Mail, sklepy i automaty w pobliżu kodu pocztowego dostawy, tylko w Wielkiej Brytanii. Zobacz **Local Collect** poniżej. |
| Śledzenie | Gdy **Identyfikator klienta w API Portal** i **Tajny klucz klienta w API Portal** są wypełnione, a Tracking jest włączony na Twoim koncie, Zippendo pobiera aktualizacje śledzenia z Royal Mail co godzinę. Bez nich oś czasu śledzenia pozostaje pusta, ale każda przesyłka nadal ma numer przesyłki i link do śledzenia na royalmail.com. Zobacz [Webhooki śledzenia przewoźników](/docs/pl/how-to/tracking-webhooks). |
| Odbiory przez kuriera | Niedostępne w **Odbiory przez kuriera**. Zorganizuj odbiory w Click & Drop lub bezpośrednio z Royal Mail. |
| Manifesty | Zippendo nie tworzy manifestów zamówień. Utwórz je w Click & Drop jak zwykle. Royal Mail rozlicza etykiety OBA przy tworzeniu manifestu. |

### Local Collect

Każdy śledzony produkt krajowy występuje też jako produkt **… — Local Collect**, na przykład **Royal Mail Tracked 24 — Local Collect**. Dostarcza do lokalizacji Local Collect zamiast pod drzwi. Gdy wybierzesz jeden z tych produktów, wybierz lokalizację w przesyłce przed wysłaniem. Reguła wysyłki może też przypisać metodę dostawy z punktem odbioru z Twojego sklepu internetowego do jednego z tych produktów. Etykieta jest zaadresowana do lokalizacji, z imieniem i nazwiskiem odbiorcy.

Local Collect wymaga wypełnionego pola **Identyfikator klienta w API Portal** i włączonego Local Collect na Twoim koncie. Zobacz [Wybierz punkt odbioru](/docs/pl/how-to/pick-a-service-point) i [Punkty odbioru](/docs/pl/how-to/drop-point-and-service-points).

### Usługi dodatkowe i dodatkowe opcje

Włącz te usługi dla przesyłki lub w regule wysyłki:

| Usługa | Co robi |
| - | - |
| **Podpis przy doręczeniu** | Royal Mail prosi odbiorcę o podpis. Niedostępne w Special Delivery ani Signed For, które zawsze zawierają podpis. |
| **Local Collect (odbiór w placówce Post Office)** | Dostarcza do urzędu pocztowego, gdzie odbiorca odbiera przesyłkę. Tylko produkty krajowe. Użyj tego, gdy zamówienie ma już adres urzędu pocztowego. Jeśli odbiorca ma wybrać lokalizację, użyj zamiast tego produktu **… — Local Collect**. |
| **Powiadomienie e-mail**, **Powiadomienie SMS** | Royal Mail wysyła odbiorcy e-mail lub SMS. |
| **Drukuj etykietę Tracked Returns razem z etykietą przesyłki wychodzącej** | Drukuje etykietę Tracked Returns razem z etykietą wychodzącą. W Click & Drop usługa Tracked Returns musi być skonfigurowana dla usługi wychodzącej. |

Te dodatkowe opcje znajdują się w **Dodatkowe dane dla przewoźnika** w przesyłce. W regule wysyłki pojawiają się pod **Usługi dodatkowe**:

| Opcja | Do czego służy |
| - | - |
| **Format paczki** | Wybierz format Royal Mail samodzielnie zamiast automatycznego. |
| **Instrukcje specjalne** | Zapisywane w zamówieniu Click & Drop. |
| **Bezpieczne miejsce** | Gdzie zostawić przesyłkę. Tylko Wielka Brytania. |
| **Ochrona od szkód następczych** | Dodatkowe odszkodowanie w GBP, od 0 do 10000. Tylko Wielka Brytania. |
| **Odbiorca jest firmą** | Potrzebne, gdy firma wysyła do Irlandii Północnej. Ustawiane automatycznie, gdy odbiorca ma numer VAT lub EORI. |
| **Pobrany koszt wysyłki**, **Kategoria deklaracji celnej**, **Wymaga licencji eksportowej** | Dane celne dla przesyłek międzynarodowych. |

### Dane celne

* Przesyłki, które wymagają deklaracji celnej, potrzebują opisu, ceny jednostkowej i waluty przy każdej pozycji zamówienia. Każda pozycja powinna mieć też kod HS i kraj pochodzenia. Zippendo pokazuje błąd, zanim cokolwiek zostanie wysłane do Royal Mail.
* Numer IOSS Twojej organizacji lub marki jest dodawany automatycznie w przesyłkach do UE. Twoje własne numery VAT i EORI pochodzą z Twojej trading name w Click & Drop. Numer VAT lub EORI odbiorcy będącego firmą pochodzi z danych odbiorcy w zamówieniu.

## 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**, **Przewoźnik w Click & Drop**, **Identyfikator klienta w API Portal** i **Tajny klucz klienta w API Portal**.

Kliknij **Zapisz**. Zobaczysz „Zaktualizowano przewoźnika”.

Aby go 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łano, zachowują etykiety i numery przesyłek, a zamówienia, które już są w Click & Drop, tam zostają.

## Częste problemy

| Co widzisz | Co zrobić |
| - | - |
| „Nie udało się połączyć przewoźnika. Spróbuj ponownie.” | Sprawdź, czy **Nazwa przewoźnika** i **Klucz API** są wypełnione, 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».” | **Klucz API** jest błędny albo został zastąpiony w Click & Drop. Zobaczysz to także, gdy **Identyfikator klienta w API Portal** lub **Tajny klucz klienta w API Portal** jest błędny albo gdy Tracking lub Local Collect nie jest włączony na Twoim koncie Royal Mail. |
| „Ustawienia przewoźnika są niekompletne lub nieprawidłowe. Sprawdź je w sekcji «Przewoźnicy».” podczas wyszukiwania lokalizacji Local Collect | Wypełnij pole **Identyfikator klienta w API Portal** w **Edytuj przewoźnika**. |
| Komunikat, że produkt Local Collect wymaga wybranego urzędu pocztowego lub Customer Service Point | Wybierz lokalizację w przesyłce przed wysłaniem. |
| Komunikat, że nie znaleziono lokalizacji Local Collect w promieniu 20 mil | Wybierz lokalizację w pobliżu kodu pocztowego dostawy. |
| „Ustawienia przewoźnika są niekompletne lub nieprawidłowe. Sprawdź je w sekcji «Przewoźnicy».”, a po nim „Royal Mail returned no label…” | Twoje konto nie jest kontem Online Business Account albo usługa nie jest na nim włączona. Zippendo usunęło zamówienie z Click & Drop. Jeśli się to nie udało, komunikat podaje numer zamówienia do samodzielnego usunięcia. Zmień konto lub włącz usługę w Click & Drop i wyślij ponownie. |
| „Wybrany produkt przewoźnika nie obsługuje wysyłki między tymi krajami. Wybierz inny produkt.” | Wybrano produkt krajowy dla adresu spoza Wielkiej Brytanii albo produkt międzynarodowy dla adresu w Wielkiej Brytanii. Wybierz drugi rodzaj. |
| „Przewoźnik Royal Mail nie mógł utworzyć przesyłki.” lub własny tekst błędu Royal Mail | Click & Drop odrzucił zamówienie. Popraw pole wskazane w komunikacie, na przykład adres, i wyślij ponownie. |
| „Przewoźnik wystawił etykietę, ale nie przygotował jednego z dokumentów towarzyszących. Zanim przekażesz paczkę, sprawdź dokumenty przesyłki.” | Przesyłka została utworzona, ale brakuje formularza celnego lub etykiety zwrotnej. Zanim przekażesz paczkę, sprawdź dokumenty przesyłki. |
| „Deklaracja celna jest niekompletna. Każda pozycja musi mieć opis, ilość i zadeklarowaną wartość większą od zera.” | Uzupełnij pozycje zamówienia i wyślij ponownie. Nic nie zostało wysłane do Royal Mail. |

## 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 dodatkowe przewoźników](/docs/pl/how-to/carrier-products-and-services)
* [Webhooki śledzenia przewoźników](/docs/pl/how-to/tracking-webhooks)
* [Przewoźnicy](/docs/pl/tutorials/carriers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.