# Gapli Order Sync

> Moduł WordPress/WooCommerce GAPLI (`gapli-order-sync`) · kategoria: Zamówienia i dostawa · aktualna wersja 1.4.2 · WordPress 6.0+ · WooCommerce 10.0+ · PHP 8.0+  
> Wersja HTML: https://gapli.com/docs/order-sync

Wysyła nowe zamówienia WooCommerce do GAPLI do realizacji i pobiera z GAPLI zmiany statusów oraz numery przesyłek.

## Gdzie go znajdziesz

Gapli → 🔄 Sync Zamówień (bez Full Dropshipping: WooCommerce → 🔄 Sync Zamówień).

## Pierwsze uruchomienie

1. Upewnij się, że sklep jest połączony z GAPLI (Gapli → Status Połączenia).
2. Włącz moduł. Domyślnie włączone są: „Moduł aktywny”, „Push (WC → Gapli)” i „Pull (Gapli → WC)”.
3. „Interwał synchronizacji” — domyślnie 5 minut; do wyboru 2, 5, 10, 15 lub 30 minut.
4. Po pierwszym zamówieniu sprawdź na karcie zamówienia notatkę „✅ … (Gapli ID: …)” — oznacza, że zamówienie dotarło do GAPLI.

## Co dzieje się automatycznie

- Każde nowe zamówienie trafia do kolejki i jest wysyłane do GAPLI w kolejnym cyklu. Nieudana wysyłka jest ponawiana do 5 razy.
- Dodaje do zamówienia notatki z numerami przesyłek.
- Zmienia status zamówienia według GAPLI: w realizacji → „W trakcie realizacji”, wysłane/doręczone → „Zrealizowane”, anulowane → „Anulowane”. Statusu nigdy nie cofa.
- Przyciski „Push teraz” i „Pull teraz” uruchamiają synchronizację od razu.

## Wymagania i powiązane moduły

- WooCommerce — bez wymaganej wersji moduł nie da się włączyć.
- Gapli Status Połączenia — moduł korzysta z tokenu zapisanego przy podłączeniu sklepu do panelu GAPLI.

## Gdy coś nie działa

- **„❌ Brak tokenu weryfikacyjnego — skonfiguruj wtyczkę Gapli Status Połączenia najpierw”** — Połącz sklep z panelem GAPLI na ekranie Gapli → Status Połączenia.
- **W logach: „przekroczono max prób (5)”** — Zamówienie nie będzie już ponawiane automatycznie. Usuń przyczynę błędu podaną w logu i kliknij „Push teraz” albo zgłoś zamówienie do obsługi GAPLI.
- **Statusy i numery przesyłek pojawiają się z dużym opóźnieniem** — WordPress uruchamia zadania tylko przy odwiedzinach sklepu. Ustaw u hostingu systemowy cron wywołujący wp-cron.php co kilka minut.