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ć.
Spis treści
1. Konfiguracja połączenia
Dostęp do API
Base API URL
Adres API Pigu dla wybranego kanału, np. pigu.lt, 220.lv, kaup24.ee lub hobbyhall.fi.
Wpisz dokładny adres API otrzymany z Pigu.
Token
Aktualny token dostępu do API.
Jeżeli poniżej podasz login i hasło, system może automatycznie odświeżać token.
Login / Hasło
Dane logowania używane do automatycznego pozyskania lub odświeżenia tokenu.
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.
Podajesz ID sklepu w PrestaShop.
Tryb dostawy
Do wyboru:
- bezpośrednio (
direct) - przez pośrednika (
intermediary)
Adres pośrednika
Wymagany przy trybie przez pośrednika.
Uzupełnij realne dane miejsca dostawy: imię, nazwisko, ulica, miasto, kod, telefon, kraj.
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.
Jeżeli pole jest puste, użyty zostanie przewoźnik domyślny PrestaShop.
Mapowanie płatności
Etykieta metody – standard
Przykład: Pigu Payment Standard.
Etykieta metody – pobranie
Przykład: Pigu Payment Pobranie.
Mapowanie statusów
Stan początkowy
Opcjonalnie wymuś domyślny stan po imporcie.
Stany szczegółowe
Opcjonalnie możesz ustawić osobne statusy dla wariantów:
- Otwarte
- Pobranie (COD)
- FBP – LT
- FBP – inne kraje
- FBP – VAT 0%
Wpisz ID istniejących statusów PrestaShop.
Produkty i dopasowanie
Tryb dopasowania produktu
Do wyboru:
ean13referenceboth
Zalecane: both, jeśli w PrestaShop używasz zarówno EAN, jak i SKU.
Twórz brakujące produkty
Zaznacz tę opcję, jeśli chcesz automatycznie tworzyć produkt, gdy nie znaleziono dopasowania.
FBP włączony
Zaznacz, jeżeli sprzedajesz w modelu FBP.
Wpływa to na wybór stanu początkowego zamówienia.
Waluta EUR w PrestaShop musi istnieć, być aktywna i mieć dodatni kurs. W przeciwnym razie import nie powiedzie się.
2. Ekran „Zamówienia Pigu”
Filtry i pobieranie
- Wybierz połączenie, zakres dat utworzenia w Pigu i ewentualnie status.
- Kliknij Pobierz zamówienia.
- ID (external) – identyfikator zamówienia z Pigu,
- Status,
- Data utworzenia,
- Klient (e-mail),
- Suma,
- Zaimportowane (ID zam.) – numer zamówienia w PrestaShop, jeśli już istnieje,
- Akcje – przycisk Importuj, jeśli zamówienie nie zostało jeszcze zaimportowane.
Import pojedynczego zamówienia
- Kliknij Importuj przy wybranym dokumencie.
- Po sukcesie przycisk zmieni się w link do zamówienia w PrestaShop wraz z jego ID.
- Jeżeli zamówienie było wcześniej importowane, od razu zobaczysz link z ID zamiast przycisku importu.
Weryfikacja „czy już zaimportowano” opiera się o identyfikator Pigu i połączenie, a nie o daty. Dzięki temu system nie gubi wcześniej zaimportowanych zamówień.
3. Co pojawia się wewnątrz zamówienia w PrestaShop
Dane ogólne
Status początkowy
Zgodny z mapowaniem standard / COD / FBP albo bezpieczny domyślny, gdy mapowanie nie zostało ustawione.
Metoda płatności
Etykieta zgodna z konfiguracją, np. Pigu Payment ….
Moduł płatności
Zgodny z konfiguracją, np. ps_checkpayment lub 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 są importowane wraz z ilościami. Ceny jednostkowe netto, brutto i sumy pozycji pochodzą z Pigu.
Priorytet wyliczeń jest następujący: net po rabacie → net → przeliczenie VAT, a brutto pobierane jest z Pigu, jeśli jest dostępne.
Dostawa
W zamówieniu tworzony jest wpis przewoźnika (Order Carrier) z przeniesionymi kosztami dostawy brutto i netto.
Płatności
Płatność zapisywana jest na łączną kwotę zamówienia z metodą zgodną z konfiguracją.
Notatki i wiadomości
- Notatka wewnętrzna zawierająca m.in. ID Pigu.
- 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ń mogła od razu oznaczać pozycje jako Zaimportowane wraz z ID zamówienia w PS.
Adresy
Jeżeli Pigu nie zwróci ulicy, system uzupełnia wymagane pola bezpiecznym wpisem, np. N/A, wraz z miastem i kodem, tak aby zamówienie mogło zostać zapisane.
Zalecane: przed wysyłką sprawdź i ewentualnie popraw adres ręcznie.
4. Szybki start
- Upewnij się, że waluta EUR jest aktywna i ma dodatni kurs.
- Uzupełnij Base API URL, Token oraz opcjonalnie login/hasło do automatycznego odświeżania.
- Wybierz Docelowy sklep, Tryb dostawy oraz – jeśli potrzeba – Adres pośrednika.
- Ustaw mapowanie przewoźnika osobno dla standardu i pobrania.
- Ustaw mapowanie płatności – moduł i etykietę – osobno dla standardu i pobrania.
- Wybierz tryb dopasowania produktów i zdecyduj, czy system ma automatycznie tworzyć brakujące produkty.
- Opcjonalnie uzupełnij mapowanie statusów.
- Przejdź do ekranu Zamówienia Pigu, wybierz połączenie i zakres dat, a następnie kliknij Pobierz.
- Importuj pojedyncze zamówienia – po imporcie zobaczysz link do zamówienia w PrestaShop zamiast przycisku.
5. Najczęstsze pytania
Brak adresu ulicy w Pigu
System wypełni wymagane pola placeholderami, np. N/A, aby 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 standardu, COD i 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 mapowania, używany jest przewoźnik domyślny PrestaShop.
To samo zamówienie pojawia się wielokrotnie na liście
Lista zależy od zakresu dat, ale import ma ochronę przed duplikatami i pokaże link do istniejącego zamówienia zamiast tworzyć nowe.
Ceny w pozycjach różnią się od oczekiwanych
System korzysta z cen z Pigu, według kolejności: net po rabacie, net, przeliczenie VAT, a brutto z Pigu – jeśli jest dostępne.
Błąd „Brak waluty EUR / kurs 0”
Włącz walutę EUR i ustaw kurs większy niż 0 w PrestaShop.
