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

# Wtyczka kasy WooCommerce

> Pokaż aktualne stawki wysyłki i pozwól klientom wybrać punkt odbioru w koszyku WooCommerce.

Wtyczka **Zippendo for WooCommerce** dodaje do koszyka Twojego sklepu internetowego aktualne stawki wysyłki i wybór punktu odbioru. Jest opcjonalna: zamówienia trafiają do Zippendo także bez niej. Z wtyczką Twoi klienci widzą prawdziwe stawki przewoźników i wybierają punkt odbioru, zanim zapłacą.

* **Aktualne stawki wysyłki.** Stawki są obliczane w koszyku na podstawie reguł wysyłki ustawionych w Zippendo, z użyciem Twoich połączonych przewoźników.
* **Wybór punktu odbioru.** Gdy stawka dotyczy dostawy do punktu odbioru, klient wybiera pobliski punkt od razu w koszyku.
* **Działa z oboma rodzajami kasy.** Wtyczka obsługuje klasyczną kasę WooCommerce oraz nowszy, blokowy koszyk i kasę.

<Info>
  Aby obliczyć stawkę, wtyczka wysyła do Zippendo tylko adres dostawy i zawartość koszyka. Nigdy nie wysyła danych płatności ani danych konta klienta.
</Info>

## Wymagania

* [Połączony sklep internetowy WooCommerce](/docs/pl/order-channels/connecting-woocommerce) w Zippendo.
* **WooCommerce 8.0** lub nowszy, aktywny.
* **WordPress 6.5** lub nowszy.
* **PHP 8.1** lub nowszy.

## Zainstaluj wtyczkę

<Steps>
  <Step title="Pobierz wtyczkę">
    W Zippendo kliknij **Kanały sprzedaży**, otwórz swój sklep WooCommerce na karcie **Połączony**, a na karcie **Zamówienia i koszyk** znajdź kartę **Token kasy**. Kliknij **Pobierz wtyczkę**.
  </Step>

  <Step title="Wgraj ją do WordPressa">
    W panelu WordPress przejdź do **Plugins → Add New → Upload Plugin**, wybierz pobrany plik zip i kliknij **Install Now**.
  </Step>

  <Step title="Aktywuj">
    Gdy wgrywanie się zakończy, kliknij **Activate**.
  </Step>
</Steps>

<Note>
  Jeśli kliknięcie **Pobierz wtyczkę** nie rozpocznie pobierania, skontaktuj się z pomocą techniczną i poproś o plik wtyczki.
</Note>

## Połącz wtyczkę z Zippendo

<Steps>
  <Step title="Wygeneruj token kasy">
    Wróć do Zippendo i na tej samej karcie **Token kasy** kliknij **Wygeneruj token**. Od razu kliknij **Kopiuj**. Token zaczyna się od `zck_` i jest pokazywany tylko raz, bo Zippendo nie przechowuje czytelnej kopii.
  </Step>

  <Step title="Wklej go w WooCommerce">
    W WordPressie przejdź do **WooCommerce → Settings → Shipping → Zippendo**, wklej token w polu **Checkout API key** i zapisz.
  </Step>

  <Step title="Przetestuj połączenie">
    Kliknij **Testuj połączenie** na tym samym ekranie, aby sprawdzić, czy WooCommerce łączy się z Zippendo za pomocą tokena.
  </Step>
</Steps>

## Dodaj metodę dostawy

Sam token nie tworzy stawek. Musisz też dodać metodę dostawy **Zippendo** do „stref dostawy” WooCommerce, do których wysyłasz.

<Steps>
  <Step title="Otwórz strefę dostawy">
    Przejdź do **WooCommerce → Settings → Shipping** i otwórz strefę, w której chcesz oferować stawki Zippendo.
  </Step>

  <Step title="Dodaj metodę">
    Kliknij **Add shipping method**, wybierz **Zippendo** i potwierdź.
  </Step>

  <Step title="Powtórz dla innych stref">
    Dodaj metodę do każdej strefy, w której mają się pojawiać stawki Zippendo.
  </Step>
</Steps>

<Tip>
  Strefa bez metody Zippendo nigdy nie pokazuje stawek Zippendo w koszyku, nawet gdy wtyczka jest połączona. Dodaj ją do strefy dla każdego kraju lub regionu, do którego wysyłasz przez Zippendo.
</Tip>

## Jak punkty odbioru działają dla klientów

Gdy koszyk klienta pasuje do reguły wysyłki, w której produkt przewoźnika dostarcza do punktu odbioru, w koszyku pojawia się lista pobliskich punktów odbioru, zarówno w klasycznej, jak i blokowej kasie. Klient wybiera jeden z nich.

Po złożeniu zamówienia wybrany punkt odbioru:

* Jest widoczny przy zamówieniu w Twoim panelu WooCommerce.
* Pojawia się w potwierdzeniu zamówienia i w innych e-mailach dotyczących zamówienia.
* Trafia automatycznie do odpowiedniej przesyłki w Zippendo, więc nie musisz go wpisywać przy wysyłaniu zamówienia.

## Opcjonalna stawka zastępcza

Jeśli podczas wyceny koszyka klienta nie można połączyć się z Zippendo, żadna stawka Zippendo nie jest pokazywana, chyba że włączysz **Fallback rate**. Domyślnie jest wyłączone. Włącz to w **WooCommerce → Settings → Shipping → Zippendo** i ustaw **Fallback rate label** oraz **Fallback rate cost**. Klienci zobaczą wtedy tę stawkę zamiast stawek Zippendo i nadal będą mogli złożyć zamówienie.

## Zastąp lub unieważnij token

Jeśli zastąpisz lub unieważnisz token na karcie **Token kasy** w Zippendo, token zapisany we wtyczce natychmiast przestaje działać. Po zastąpieniu wklej nowy token w **WooCommerce → Settings → Shipping → Zippendo** i zapisz. Dopóki tego nie zrobisz, Twoja kasa nie pokazuje stawek Zippendo.

<Warning>
  Zastępuj lub unieważniaj token tylko wtedy, gdy możesz od razu zaktualizować wtyczkę. Dopóki nowy token nie zostanie zapisany w WooCommerce, klienci nie widzą stawek Zippendo (ani stawki zastępczej, jeśli ją włączono).
</Warning>

## Rozwiązywanie problemów

* **Brak stawek w koszyku.** Sprawdź, czy token jest zapisany i czy **Testuj połączenie** działa. Potem sprawdź, czy metoda dostawy **Zippendo** jest dodana do strefy obejmującej adres klienta.
* **Brak listy punktów odbioru w koszyku.** Pasująca reguła wysyłki musi używać produktu przewoźnika, który dostarcza do punktu odbioru, a nie produktu z dostawą do domu. Sprawdź, jakiego produktu używa reguła, w **Reguły wysyłki** w Zippendo.
* **Stawki wyglądają na nieaktualne.** Aby koszyk działał szybko, wtyczka zapamiętuje stawki na około 10 minut dla tego samego koszyka i adresu. Po tym czasie sama pobiera świeże stawki, albo od razu po zmianie koszyka lub adresu.


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