> ## 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 Instabox (starsze API)

> Połącz wycofywanego przewoźnika Instabox (starsze API) za pomocą Client ID, Client secret i numeru klienta oraz dowiedz się, dlaczego nowe konfiguracje powinny używać Instabox.

**Instabox (starsze API)** to starszy sposób połączenia z Instabox. Na karcie **Wszyscy przewoźnicy** ma oznaczenie **Wycofywany**. Najedź na plakietkę, aby przeczytać: „Samodzielne API Instabox jest wycofywane. Przejdź na integrację Instabox opartą na Instabee.”

Używaj go tylko wtedy, gdy nadal masz dane dostępowe do starszego systemu Instabox (Client ID i secret). Przy nowej konfiguracji użyj zamiast tego [Połącz Instabox](/docs/pl/how-to/connect-instabox). Pola wspólne dla wszystkich przewoźników opisuje [Dane dostępowe przewoźników](/docs/pl/how-to/carrier-credentials).

<Warning>
  Istniejące połączenia nadal działają: nadal możesz połączyć tego przewoźnika i wysyłać przez niego przesyłki. Nowe konfiguracje powinny używać **Instabox**.
</Warning>

<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>

## Zanim zaczniesz

Potrzebujesz trzech danych od Instabox dla starszego systemu:

* swojego **Client ID**
* swojego **Client secret**
* swojego **Numer klienta**, czyli prefiksu, który Instabox dodaje do numerów Twoich paczek (na przykład `PA02`)

To nie to samo co pojedynczy **Klucz API** używany w [Połącz Instabox](/docs/pl/how-to/connect-instabox). **Więcej informacji** na karcie otwiera [instabee.com](https://instabee.com).

## Połącz Instabox (starsze API)

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

  <Step title="Znajdź właściwą kartę">
    Znajdź kartę o nazwie **Instabox (starsze API)** z żółtą plakietką **Wycofywany**. To inna karta niż **Instabox**. Kliknij **Połącz**.
  </Step>

  <Step title="Wypełnij formularz">
    Otworzy się okno **Połącz przewoźnika**. Wpisz **Nazwa przewoźnika**, a potem **Client ID**, **Client secret** i **Numer klienta**. **Tryb testowy** znajduje się w sekcji **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>

<Frame caption="Karta Instabox (starsze API) z plakietką Wycofywany">
  <img src="https://mintcdn.com/zippendo/qBOnRITEqBIUwzW-/images/pl/how-to/connect-instabox-legacy/01-all-carriers-card-light.png?fit=max&auto=format&n=qBOnRITEqBIUwzW-&q=85&s=9fc24f0d0f46bae543ff650aa4849ed5" alt="Karta Wszyscy przewoźnicy z kartą Instabox (starsze API) oznaczoną jako Wycofywany, z przyciskami Połącz i Więcej informacji" className="block dark:hidden" width="2880" height="1800" data-path="images/pl/how-to/connect-instabox-legacy/01-all-carriers-card-light.png" />

  <img src="https://mintcdn.com/zippendo/qBOnRITEqBIUwzW-/images/pl/how-to/connect-instabox-legacy/01-all-carriers-card-dark.png?fit=max&auto=format&n=qBOnRITEqBIUwzW-&q=85&s=86aa105a7e8973999dbbf153085bc19a" alt="Karta Wszyscy przewoźnicy z kartą Instabox (starsze API) oznaczoną jako Wycofywany, z przyciskami Połącz i Więcej informacji" className="hidden dark:block" width="2880" height="1800" data-path="images/pl/how-to/connect-instabox-legacy/01-all-carriers-card-dark.png" />
</Frame>

<Frame caption="Wpisz Client ID, Client secret i Numer klienta">
  <img src="https://mintcdn.com/zippendo/qBOnRITEqBIUwzW-/images/pl/how-to/connect-instabox-legacy/02-connect-modal-light.png?fit=max&auto=format&n=qBOnRITEqBIUwzW-&q=85&s=b919d005375475e6858127d5ed25a231" alt="Okno Połącz przewoźnika dla Instabox (starsze API) z polami Client ID, Client secret i Numer klienta" className="block dark:hidden" width="2880" height="2800" data-path="images/pl/how-to/connect-instabox-legacy/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/qBOnRITEqBIUwzW-/images/pl/how-to/connect-instabox-legacy/02-connect-modal-dark.png?fit=max&auto=format&n=qBOnRITEqBIUwzW-&q=85&s=891b1940e8f2468bba6f130034f00752" alt="Okno Połącz przewoźnika dla Instabox (starsze API) z polami Client ID, Client secret i Numer klienta" className="hidden dark:block" width="2880" height="2800" data-path="images/pl/how-to/connect-instabox-legacy/02-connect-modal-dark.png" />
</Frame>

<Frame caption="Tryb testowy znajduje się w sekcji Pola opcjonalne">
  <img src="https://mintcdn.com/zippendo/qBOnRITEqBIUwzW-/images/pl/how-to/connect-instabox-legacy/03-optional-fields-light.png?fit=max&auto=format&n=qBOnRITEqBIUwzW-&q=85&s=21de23b9c5bb2377d51905ec3769ba6f" alt="Formularz Instabox (starsze API) przewinięty do sekcji Pola opcjonalne z polem wyboru Tryb testowy" className="block dark:hidden" width="2880" height="2800" data-path="images/pl/how-to/connect-instabox-legacy/03-optional-fields-light.png" />

  <img src="https://mintcdn.com/zippendo/qBOnRITEqBIUwzW-/images/pl/how-to/connect-instabox-legacy/03-optional-fields-dark.png?fit=max&auto=format&n=qBOnRITEqBIUwzW-&q=85&s=c34315e290967d247f021c54ec140772" alt="Formularz Instabox (starsze API) przewinięty do sekcji Pola opcjonalne z polem wyboru Tryb testowy" className="hidden dark:block" width="2880" height="2800" data-path="images/pl/how-to/connect-instabox-legacy/03-optional-fields-dark.png" />
</Frame>

## 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 **Instabox (starsze API)**. |
| **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ć. |
| **Client ID** | Tak | Twój identyfikator klienta od Instabox. Formularz podaje: „Twój identyfikator klienta OAuth w Instabox”. |
| **Client secret** | Tak | Secret przypisany do Twojego Client ID. Jest ukryty podczas wpisywania. Formularz podaje: „Twój tajny klucz klienta OAuth w Instabox”. |
| **Numer klienta** | Tak | Formularz podaje: „Twój numer klienta Instabox, używany jako prefiks ID paczki (np. PA02)”. |
| **Tryb testowy** | Nie | Pole wyboru, domyślnie wyłączone. Formularz podaje: „Używaj środowiska testowego Instabox”. |

**Połącz** nic nie robi, dopóki **Nazwa przewoźnika**, **Client ID**, **Client secret** i **Numer klienta** nie mają wartości.

### Test czy produkcja

W tym starszym połączeniu Instabox rozróżnia swój system testowy i prawdziwe przesyłki na podstawie wpisanych danych dostępowych, a nie pola wyboru **Tryb testowy**. Testowe dane dostępowe od Instabox tworzą przesyłki testowe. Produkcyjne dane dostępowe tworzą prawdziwe przesyłki, nawet przy włączonym **Tryb testowy**. Aby wszystko wypróbować, poproś Instabox o testowe dane dostępowe i włącz **Tryb testowy**, gdy z nich korzystasz. Zobacz [Tryb testowy](/docs/pl/how-to/sandbox-mode).

## Po połączeniu

Przewoźnik pojawia się w **Moi przewoźnicy** z oznaczeniem **Połączony**. Gdy wybierasz go w przesyłce, widać też plakietkę **Wycofywany**. 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).

| Produkt | Typ przesyłki | Dostarcza do punktu odbioru? |
| - | - | - |
| **Doręczenie do automatu paczkowego** | Wychodząca | Tak, do automatu paczkowego Instabox |
| **Doręczenie do domu** | Wychodząca | Nie |
| **Zwrot przez automat paczkowy** | Przychodząca (zwrot) | Nie. Klient zostawia paczkę w dowolnym automacie Instabox. Włącz usługę **Zwrot bez etykiety**, jeśli klient nie ma drukować etykiety. |

Produkty są zwykle używane w obrębie Szwecji, Norwegii, Danii, Finlandii i Holandii oraz między tymi krajami, od 0,1 do 20 kg. W regule wysyłki możesz wybrać inne kraje. Instabox przyjmuje lub odrzuca przesyłkę, gdy ją wysyłasz.

* **Doręczenie do automatu paczkowego** wymaga punktu odbioru (tutaj automatu paczkowego) przed wysyłką. Zobacz [Wybierz punkt odbioru](/docs/pl/how-to/pick-a-service-point).
* Instabox sam wysyła aktualizacje śledzenia do Zippendo. Nie trzeba niczego konfigurować. Zobacz [Webhooki śledzenia przewoźników](/docs/pl/how-to/tracking-webhooks).
* Instabox nie tworzy dokumentów celnych. Jeśli w regule wysyłki włączono **Generuj fakturę proforma** lub **Generuj fakturę handlową**, dokument tworzy Zippendo. Zobacz [Cło i dokumenty](/docs/pl/how-to/customs-and-documents).
* Ten przewoźnik nie jest dostępny w sekcji **Odbiory przez kuriera**.

## 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**: **Client ID**, **Client secret**, **Numer klienta** 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.

Gdy przechodzisz na nowe połączenie, najpierw połącz **Instabox**, zaktualizuj reguły wysyłki, aby go używały, a dopiero potem usuń to stare połączenie.

## Typowe problemy

| Co widzisz | Co zrobić |
| - | - |
| „Nie udało się połączyć przewoźnika. Spróbuj ponownie.” | Sprawdź, czy wszystkie wymagane pola są wypełnione, 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 | Sprawdź **Client ID** i **Client secret** w **Edytuj przewoźnika**. Aktualny **Klucz API** Instabox tu nie działa. Do tego klucza użyj [Połącz Instabox](/docs/pl/how-to/connect-instabox). |
| „Ten produkt dostarcza do punktu odbioru. Przed wysłaniem wybierz punkt odbioru.” | Wybierz automat paczkowy dla **Doręczenie do automatu paczkowego**. Zobacz [Wybierz punkt odbioru](/docs/pl/how-to/pick-a-service-point). |
| „Przewoźnik odrzucił tę operację. Sprawdź podany przez niego powód, popraw dane i spróbuj ponownie.” z powodem „Instabox … is not available for …” przy wysyłaniu | Instabox nie oferuje tego produktu dla tego kraju i kodu pocztowego. Sprawdź adres albo wybierz inny produkt. |

## Powiązane

* [Połącz Instabox](/docs/pl/how-to/connect-instabox)
* [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)
* [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.