Integracja Pigu → PrestaShop (as_pigu)

Przewodnik dla użytkownika: konfiguracja, import zamówień i efekty w zamówieniu PrestaShop. Bez technikaliów i nazw funkcji – tylko to, co należy wypełnić i jak używać.

1) Konfiguracja połączenia

Dostęp do API

• Base API URL – adres API Pigu dla kanału (np. pigu.lt / 220.lv / kaup24.ee / hobbyhall.fi). Wpisz adres z Pigu.
• Token – aktualny token dostępu do API. Jeśli poniżej podasz login i hasło, system może go automatycznie odświeżać.
• Login / Hasło – dane do automatycznego pozyskania/odświeżenia tokenu (z panelu Pigu).
• Seller ID – identyfikator sprzedawcy nadany przez Pigu.

Sklep i dostawa

• Docelowy sklep (Shop ID) – w multistore wybierz sklep, do którego mają trafiać zamówienia (ID sklepu w PS).
• Tryb dostawy – bezpośrednio (direct) lub przez pośrednika (intermediary).
• Adres pośrednika (wymagany przy trybie „przez pośrednika”) – imię, nazwisko, ulica, miasto, kod, telefon, kraj (realne dane miejsca dostaw).

Mapowanie przewoźnika

• Przewoźnik (standard) – ID przewoźnika w PrestaShop dla zamówień standardowych.
• Przewoźnik (pobranie) – ID przewoźnika dla zamówień za pobraniem (opcjonalnie). Gdy puste, użyty będzie przewoźnik domyślny PS.

Mapowanie płatności

• Etykieta metody – standard (np. „Pigu Payment Standard”).
• Etykieta metody – pobranie (np. „Pigu Payment Pobranie”).

Mapowanie statusów (stan początkowy)

• Stan początkowy – wymuś domyślny stan po imporcie (opcjonalnie).
• Stany szczegółowe (opcjonalnie): „Otwarte”, „Pobranie (COD)”, „FBP – LT”, „FBP – inne kraje”, „FBP – VAT 0%”. Wpisz ID istniejących statusów PS.

Produkty i dopasowanie

• Tryb dopasowania produktu – ean13, reference lub both (zalecane, gdy w PS masz zarówno EAN, jak i SKU).
• Twórz brakujące produkty – zaznacz, aby automatycznie tworzyć produkt, gdy nie znaleziono dopasowania.
• FBP włączony – zaznacz, jeśli sprzedajesz w modelu FBP (wpływa na wybór stanu początkowego).

2) Ekran „Zamówienia Pigu” (orders)

Filtry i pobieranie

• Wybierz połączenie, zakres dat utworzenia w Pigu i ewentualnie status.
• Kliknij Pobierz zamówienia. Zobaczysz tabelę z:
  • ID (external) – identyfikator zamówienia z Pigu,
  • Status, Data utworzenia, Klient (e-mail), Suma,
  • Zaimportowane (ID zam.) – numer zamówienia w PS (jeśli istnieje),
  • Akcje – przycisk Importuj (jeśli jeszcze nieimportowane).

Import pojedynczego zamówienia

• Kliknij Importuj przy wybranym dokumencie.
• Po sukcesie przycisk zmieni się w link do zamówienia w PrestaShop z jego ID.
• Jeśli zamówienie było wcześniej importowane, od razu zobaczysz link z ID – bez przycisku Importuj.

3) Co pojawia się wewnątrz zamówienia w PrestaShop

Dane ogólne

• Status początkowy – zgodny z mapowaniem (standard/COD/FBP) lub bezpieczny domyślny, gdy nie ustawiono mapowania.
• Metoda płatności – etykieta z konfiguracji („Pigu Payment …”).
• Moduł płatności – zgodnie z konfiguracją (np. ps_checkpayment / ps_cashondelivery).
• Przewoźnik – przeniesiony z koszyka do zamówienia i rekordu dostawy.
• Kwoty – sumy produktów i dostawy zgodne z danymi z Pigu.

Pozycje

• Produkty z ilościami; ceny jednostkowe netto/brutto i sumy linii pochodzą z Pigu (priorytet: net po rabacie → net → przeliczenie VAT; brutto z Pigu, gdy dostępne).

Dostawa

• Wpis przewoźnika (Order Carrier) z przeniesionymi kosztami dostawy (brutto i netto – dla netto stosujemy bezpieczny fallback, jeśli brak stawek).

Płatności

• Płatność zapisana na łączną kwotę zamówienia z metodą zgodną z konfiguracją.

Notatki i wiadomości

• Notatka wewnętrzna zawierająca m.in. ID Pigu (pomaga w identyfikacji).
• Wiadomość prywatna z taką samą treścią – do użytku obsługi.

Powiązanie z Pigu

• System zapisuje powiązanie Pigu → PrestaShop, aby lista zamówień od razu oznaczała pozycje jako Zaimportowane (z ID w PS).

Adresy

• Jeśli Pigu nie zwróci ulicy, system uzupełnia wymagalne pola bezpiecznym wpisem (np. „N/A”, wraz z miastem i kodem) tak, by zamówienie mogło zostać zapisane. Zalecane: sprawdź i ewentualnie popraw adres przed wysyłką.

4) Szybki start (checklista)

1. Upewnij się, że waluta EUR jest aktywna i ma dodatni kurs.
2. Uzupełnij Base API URL, Token (opcjonalnie login/hasło do auto-odświeżania).
3. Wybierz Docelowy sklep, Tryb dostawy oraz ewentualny Adres pośrednika.
4. Ustaw mapowanie przewoźnika (ID w PS; osobno dla standard/COD).
5. Ustaw mapowanie płatności (moduł + etykieta; osobno dla standard/COD).
6. Wybierz tryb dopasowania produktów (EAN/REF/Both) i zdecyduj o automatycznym tworzeniu produktów.
7. Opcjonalnie uzupełnij mapowanie statusów (stan startowy, warianty dla COD/FBP).
8. Przejdź do ekranu Zamówienia Pigu, wybierz połączenie i zakres dat, kliknij Pobierz.
9. Importuj pojedyncze zamówienia – po imporcie zobaczysz link do zamówienia w PS zamiast przycisku.

5) Najczęstsze pytania

Brak adresu ulicy w Pigu

System wypełni wymagane pola placeholderami (np. „N/A”, miasto i kod), by zamówienie dało się zapisać. Przed wysyłką warto ręcznie zweryfikować adres.

Status po imporcie jest inny niż oczekiwany

Uzupełnij mapowanie statusów (osobno dla standard/COD/FBP) lub ustaw ogólny „Stan początkowy”.

Przewoźnik nie przenosi się do zamówienia

Wprowadź ID przewoźnika w konfiguracji połączenia. Gdy brak, używany jest przewoźnik domyślny PS.

To samo zamówienie pojawia się wielokrotnie na liście

Lista zależy od zakresu dat, ale import ma ochronę przed duplikatem i pokaże link do istniejącego zamówienia zamiast tworzyć nowe.

Ceny w pozycjach różnią się od oczekiwanych

Stosowane są ceny z Pigu (najpierw net po rabacie, potem net, następnie przeliczenie VAT; brutto z Pigu, jeśli dostępne). W razie rozbieżności sprawdź kompletność VAT i kwot w danych z marketplace.

Błąd „Brak waluty EUR / kurs 0”

Włącz walutę EUR i ustaw kurs > 0 w PrestaShop.