> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnilinker.pl/llms.txt
> Use this file to discover all available pages before exploring further.

# Konta kurierów

> Połącz swoje konta InPost, DPD i Apaczka, aby tworzyć przesyłki i etykiety prosto z zamówienia.

Konto kuriera łączy Omnilinkera z Twoim kontem u przewoźnika. Omnilinker używa go do tworzenia przesyłek, pobierania
etykiet i sprawdzania statusów śledzenia. Zanim utworzysz przesyłkę z zamówienia, potrzebujesz co najmniej jednego
konta kuriera; zobacz [Przesyłki, etykiety i śledzenie](/pl/shipping/shipments).

Możesz podłączyć kilka kont tego samego przewoźnika, na przykład dwie organizacje InPost. Każde konto danego
przewoźnika musi mieć własną nazwę.

## Zanim zaczniesz

* **Moduł Przesyłki jest włączony.** Poszukaj pozycji **Przesyłki** w menu głównym. Jeśli jej nie ma, moduł jest
  wyłączony dla Twojej organizacji (funkcja **Włącz moduł Przesyłki**). Poproś Omnilinkera o jego włączenie; zobacz
  [Moduły i ich dostępność](/pl/administration/features).
* **Masz uprawnienia.** Aby zobaczyć stronę, potrzebujesz uprawnienia **Konta kurierów**. Aby dodawać, edytować,
  testować i usuwać konta oraz zapisać token InPost Geowidget, potrzebujesz uprawnienia **Zarządzanie kontami
  kurierów**. Zobacz [Uprawnienia](#uprawnienia).
* **Masz dane dostępowe do API przewoźnika.** Znajdziesz je w sekcji
  [Dane dostępowe przewoźników](#dane-dostępowe-przewoźników).

## Obsługiwani przewoźnicy

| Przewoźnik  | Połączenie przez           | Środowiska                       | Anulowanie z Omnilinkera              | Śledzenie           | Formaty etykiet |
| ----------- | -------------------------- | -------------------------------- | ------------------------------------- | ------------------- | --------------- |
| **InPost**  | ShipX (bezpośrednio)       | Produkcja lub środowisko testowe | Tak                                   | Tak                 | PDF i ZPL       |
| **DPD**     | DPD Web Services           | Tylko produkcja                  | Nie                                   | Jeszcze niedostępne | PDF i ZPL       |
| **Apaczka** | Apaczka API v2 (agregator) | Tylko produkcja                  | Tak, ale bez gwarancji zwrotu kosztów | Tak                 | PDF             |

Apaczka jest agregatorem: jedno konto Apaczka daje Ci usługi przewoźników dostępnych na Twoim koncie Apaczka.

Omnilinker zapisuje każdą etykietę jako PDF. Kopia ZPL, jeśli przewoźnik ją udostępnia, służy do drukarek etykiet
termicznych na stanowisku; zobacz [Drukuj etykiety](/pl/shipping/shipments#drukuj-etykiety).

Furgonetka jest wymieniona na stronie jako dostępna wkrótce. Nie jest jeszcze dostępna i nie pojawia się na liście
dostawców.

## Dodaj konto kuriera

<Steps>
  <Step title="Otwórz stronę kont kurierów">
    Otwórz **Przesyłki** > **Konta kurierów**.
  </Step>

  <Step title="Rozpocznij dodawanie konta">
    Kliknij **Dodaj konto kuriera**. Jeśli nie masz jeszcze żadnego konta, strona pokazuje **Połącz pierwsze konto
    kuriera** z kafelkiem dla każdego przewoźnika; wtedy kliknij kafelek przewoźnika.
  </Step>

  <Step title="Nazwij konto i wybierz przewoźnika">
    * **Nazwa**: nazwa, którą rozpozna Twój zespół, na przykład „InPost — sklep główny”. Pole wymagane, do 128 znaków,
      inne niż nazwy Twoich pozostałych kont tego samego przewoźnika.
    * **Dostawca**: wybierz **InPost**, **DPD** lub **Apaczka**. Po zapisaniu konta nie możesz zmienić dostawcy.
  </Step>

  <Step title="Wybierz środowisko">
    Dla InPost wybierz w sekcji **Środowisko** opcję **Produkcja** (domyślna) lub **Środowisko testowe**. Wybierz
    **Środowisko testowe** tylko wtedy, gdy masz dane dostępowe do środowiska testowego InPost: dane produkcyjne w nim
    nie działają.

    Dla DPD i Apaczka zamiast wyboru zobaczysz **Tylko produkcja.** W Apaczce każda utworzona przesyłka to realna
    opłata.
  </Step>

  <Step title="Wpisz dane uwierzytelniające">
    Wypełnij pola w sekcji **Dane uwierzytelniające**. Różnią się one w zależności od przewoźnika; zobacz
    [Dane dostępowe przewoźników](#dane-dostępowe-przewoźników). Pola oznaczone `*` są wymagane.
  </Step>

  <Step title="Zapisz i przetestuj">
    Kliknij **Zapisz i testuj**, aby zapisać konto i od razu sprawdzić połączenie, lub **Zapisz**, aby tylko je
    zapisać.
  </Step>
</Steps>

Omnilinker przechowuje dane uwierzytelniające w formie zaszyfrowanej. Po zapisaniu nigdy ich już nie pokazuje; kolumna
**Dane** mówi tylko **Skonfigurowane** lub **Brak**.

Pod formularzem sekcja **Możliwości dostawcy** pokazuje, co przewoźnik obsługuje w Omnilinkerze: **Anulowanie**,
**Wybór punktu**, **Wycena usług**, **Środowisko testowe** i **Agregator**. Możliwość oznaczona ✕ nie jest dostępna
u tego przewoźnika.

## Dane dostępowe przewoźników

<Tabs>
  <Tab title="InPost">
    | Pole                          | Co wpisać                                                                                           |
    | ----------------------------- | --------------------------------------------------------------------------------------------------- |
    | **Token dostępu**             | Token organizacji API ShipX. Formularz kieruje Cię do **Ustawienia → API** w panelu InPost Manager. |
    | **Identyfikator organizacji** | Identyfikator Twojej organizacji InPost.                                                            |

    Udany test pokazuje komunikat „Połączono z InPost ShipX jako organizacja „…”.” z nazwą Twojej organizacji.

    Jeśli korzystasz z Paczkomatów InPost, dodaj też token Geowidget; zobacz [Ustawienia InPost](#ustawienia-inpost).
  </Tab>

  <Tab title="DPD">
    | Pole                           | Co wpisać                                                                                                                                |
    | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
    | **Adres URL API**              | Adres API DPD dla Twojej umowy. DPD go nie publikuje: poproś opiekuna DPD o tę wartość.                                                  |
    | **Login**                      | Twój login do API DPD.                                                                                                                   |
    | **Hasło**                      | Twoje hasło do API DPD.                                                                                                                  |
    | **FID**                        | Twój główny identyfikator finansowy (FID) DPD, nadany w umowie z DPD.                                                                    |
    | **FID płatnika (opcjonalnie)** | FID, na który DPD rozlicza Twoje przesyłki, jeśli jest inny niż Twój własny FID. Gdy zostawisz pole puste, Omnilinker użyje Twojego FID. |

    Konta DPD zawsze działają jako **Produkcja**. To, czy łączą się z testowym, czy produkcyjnym systemem DPD, zależy
    wyłącznie od **Adresu URL API** otrzymanego od DPD.

    Udany test pokazuje komunikat „Połączono z DPD.”.
  </Tab>

  <Tab title="Apaczka">
    | Pole                        | Co wpisać                                                                                                   |
    | --------------------------- | ----------------------------------------------------------------------------------------------------------- |
    | **Identyfikator aplikacji** | Identyfikator Twojej aplikacji API w Apaczka.pl.                                                            |
    | **Sekret aplikacji**        | Sekret tej samej aplikacji. Formularz kieruje Cię do sekcji API w panelu Apaczka.pl (**Ustawienia → API**). |

    Apaczka nie ma środowiska testowego, więc każda przesyłka utworzona przez nią to realna opłata. Sam test połączenia
    nie tworzy przesyłki.

    Udany test pokazuje komunikat „Połączono z Apaczka.pl.”.
  </Tab>
</Tabs>

### Adres nadawcy i odbiór przesyłek

Formularz konta kuriera nie ma adresu nadawcy, domyślnej usługi ani ustawień odbioru przesyłek.

* **InPost**: Omnilinker nie wysyła adresu nadawcy; przesyłka powstaje w Twojej organizacji InPost.
* **DPD i Apaczka** wymagają adresu nadawcy, a w Omnilinkerze nie możesz go jeszcze wpisać.

<Warning>
  Dopóki nie można ustawić adresu nadawcy, utworzenie przesyłki DPD lub Apaczka kończy się błędem „Szkic przesyłki jest
  nieprawidłowy.”. Możesz jednak dodać konto i przetestować połączenie.
</Warning>

Omnilinker nie zamawia odbioru przesyłek przez kuriera. Zamów odbiór w panelu przewoźnika albo nadaj paczki
samodzielnie. Przesyłki Apaczka są zamawiane z typem odbioru `SELF`.

## Przetestuj połączenie

Kliknij **Testuj** w wierszu konta lub **Zapisz i testuj** w formularzu. W trakcie testu wiersz pokazuje
**Testowanie…**.

Wynik pojawia się w pasku pod wierszem, **Połączenie działa** lub **Test nieudany**, razem z komunikatem przewoźnika.
Pasek znika sam po 15 sekundach albo po kliknięciu ×.

Kolumna **Stan połączenia** przechowuje wynik ostatniego testu i czas jego wykonania:

| Stan                | Znaczenie                                                      |
| ------------------- | -------------------------------------------------------------- |
| **Nie testowano**   | Na tym koncie nie wykonano jeszcze żadnego testu.              |
| **Połączono**       | Ostatni test się powiódł.                                      |
| **Błąd połączenia** | Ostatni test się nie powiódł. Wiersz pokazuje komunikat błędu. |

**Kondycja połączeń** nad tabelą zlicza Twoje konta jako połączone, wymagające uwagi lub nietestowane.

Test uruchamia się tylko wtedy, gdy go klikniesz. Omnilinker nie testuje kont automatycznie według harmonogramu.

## Edytuj konto

<Steps>
  <Step title="Otwórz formularz">
    Kliknij ikonę ołówka (**Edytuj**) w wierszu konta. Formularz ma tytuł \*\*Edytuj konto — \*\* z nazwą konta.
  </Step>

  <Step title="Zmień nazwę lub środowisko">
    Możesz zmienić **Nazwę**, a dla InPost także **Środowisko**. Pole **Dostawca** jest zablokowane.
  </Step>

  <Step title="W razie potrzeby wymień dane uwierzytelniające">
    Zapisane dane są ukryte. Aby je wymienić, kliknij **Zmień dane uwierzytelniające** i wypełnij **wszystkie wymagane
    pola**: nowe wartości zastępują cały zapisany zestaw. Jeśli zostawisz puste wymagane pole, Omnilinker zachowa
    obecne dane. Kliknij **Anuluj zmianę danych**, aby wrócić.
  </Step>

  <Step title="Zapisz">
    Kliknij **Zapisz** lub **Zapisz i testuj**.
  </Step>
</Steps>

## Usuń konto

<Steps>
  <Step title="Rozpocznij usuwanie">
    Kliknij ikonę kosza (**Usuń**) w wierszu konta. Otworzy się okno **Usunąć konto kuriera?**.
  </Step>

  <Step title="Potwierdź">
    Zaznacz **Rozumiem konsekwencje** i kliknij **Usuń konto**.
  </Step>
</Steps>

Po usunięciu konta:

* Jego przesyłki i ich historia śledzenia zostają w Omnilinkerze.
* Nie możesz tworzyć na nim nowych przesyłek.
* Omnilinker przestaje sprawdzać statusy śledzenia jego przesyłek i nie możesz ich już anulować z Omnilinkera.

Nie możesz wyłączyć konta bez jego usuwania. Aby znów z niego korzystać, dodaj je ponownie z tymi samymi danymi.

## Ustawienia InPost

Gdy masz co najmniej jedno konto InPost, pod tabelą kont pojawia się sekcja **Ustawienia InPost**. Zawiera **Token
InPost Geowidget**, który włącza mapę wyboru paczkomatu przy tworzeniu przesyłki do Paczkomatu InPost.

* Token jest opcjonalny. Bez niego wpisujesz kod paczkomatu ręcznie w formularzu przesyłki.
* To publiczny token strony dla InPost Geowidget, a nie Twój token dostępu ShipX. Pole podpowiada, że znajdziesz go
  w panelu InPost Manager.
* Jeden token obowiązuje w całej Twojej organizacji, nawet jeśli masz podłączonych kilka organizacji InPost.

Aby go zapisać, wklej token w pole **Token InPost Geowidget** i kliknij **Zapisz**. Potrzebujesz uprawnienia
**Zarządzanie kontami kurierów**.

## Uprawnienia

| Czynność                                                                    | Uprawnienie                                      |
| --------------------------------------------------------------------------- | ------------------------------------------------ |
| Wyświetlanie strony **Konta kurierów** i listy kont                         | **Przesyłki** > **Konta kurierów**               |
| Dodawanie, edycja, testowanie i usuwanie kont; zapisywanie tokenu Geowidget | **Przesyłki** > **Zarządzanie kontami kurierów** |

Uprawnienia do przesyłek znajdziesz na stronie
[Przesyłki, etykiety i śledzenie](/pl/shipping/shipments#uprawnienia). Jak nadawać uprawnienia, opisuje
[Lista uprawnień](/pl/administration/permissions).

<CardGroup cols={1}>
  <Card title="Utwórz przesyłkę" icon="truck" href="/pl/shipping/shipments">
    Utwórz przesyłkę z zamówienia, wydrukuj etykietę i śledź przesyłkę.
  </Card>
</CardGroup>
