PrestaShop

0. Co musisz mieć

• PrestaShop 1.7+ lub PrestaShop 8.x (sprawdź w stopce admina)
• Konto admin z dostępem do Advanced Parameters → Webservice
• HTTPS na sklepie (PS akceptuje HTTP ale na produkcji nie używać — klucz API leciałby plaintext)
• Co najmniej jeden aktywny carrier (przewoźnik) obsługujący Polskę
• Co najmniej jedna aktywna kategoria z produktami

U niektórych instalacji PS Webservice jest domyślnie wyłączony.

1. Zaloguj się do admina PS.
2. Menu: Configure → Advanced Parameters → Webservice.
3. Na dole strony: Configuration → przełącz „Enable PrestaShop's webservice" na YES.
4. Zapisz.

To najważniejszy krok — pominięcie któregoś zasobu = błąd 403 w trakcie syncu albo push-u zamówienia.

1. Advanced Parameters → Webservice, prawy górny róg: „Add new webservice key" (ikonka „+").
2. Key: kliknij „Generate" obok pola — PS wygeneruje losowy 32-znakowy klucz. Skopiuj go teraz — po zapisaniu nie pokaże się drugi raz.
3. Key description: BidBil integration
4. Status: Enabled.
5. Permissions: tabela z listą zasobów. Zaznacz dokładnie tak:

6. Kliknij Save na dole.

1. Wejdź na /profile/settings/integrations/new (konto firmowe wymagane).
2. Platforma: PrestaShop.
3. Nazwa: dowolna, np. Mój PrestaShop.
4. URL sklepu: pełen adres bez końcowego slasha i bez /api, np. https://mojsklep.pl (lub https://mojsklep.pl/sklep jeśli PS jest w subfolderze).
5. API key: wklej 32-znakowy klucz z kroku 2.
6. Domyślna stawka VAT: wpisz 23 (PL standard). Patrz krok 6 dla mieszanych stawek.
7. Pozostałe pola (carrier, VAT wysyłki) zostaw puste — wypełnij po teście jeśli zajdzie potrzeba.
8. Kliknij Utwórz, potem na liście Test połączenia. Zielone = OK.

1. Otwórz integrację (przycisk „Konfiguruj" na liście).
2. Sekcja „Mapowanie kategorii" → „Pobierz kategorie sklepu".
3. Lista pokaże kategorie PS z pełną ścieżką (np. Sprzęt bilardowy → Kije → Kije break).
4. Mapuj na BidBil. Pomiń = produkty z tej kategorii nie pójdą.
5. Zapisz.

PrestaShop nazywa atrybuty features (cechy). Definiujesz je w Catalog → Attributes & Features → Features.

1. Sekcja „Mapowanie atrybutów" → „Skanuj atrybuty produktów".
2. System pobierze próbkę i wyświetli features + sugestie dopasowania.
3. Sprawdź, popraw, zapisz.

Stawka VAT

PrestaShop zwraca ceny netto. BidBil przelicza na brutto mnożnikiem z pola default_vat_rate.

• Wszystko 23%: wpisz 23 (większość shopów PL)
• Książki, czasopisma (5%): wpisz 5
• Mieszane: wybierz dominującą stawkę. Resztę produktów skoryguj po imporcie.
• VAT na wysyłkę inny niż produkty? Wpisz default_vat_rate_shipping osobno (np. produkty 5, wysyłka 23 dla księgarni).

Kurier

BidBil domyślnie wybiera pierwszego aktywnego kuriera (pomija „darmową wysyłkę"). Jeśli chcesz wymusić konkretnego:

1. PS: Shipping → Carriers.
2. Znajdź carriera którego chcesz — w adresie URL zobaczysz id_carrier=N. Skopiuj N.
3. W BidBil credentials wpisz w polu default_carrier_id.

Niestandardowy stan „Anulowane"

Domyślny PS state ID dla „Cancelled" to 6. Jeśli masz custom workflow (np. „Wycofane przez klienta" z innym ID):

1. PS: Shop Parameters → Order Settings → Statuses.
2. Znajdź swój status „cancel" — w URL id_order_state=N.
3. W BidBil credentials: ps_cancelled_state_id = N.

1. Aktywuj w prawym górnym rogu strony integracji.
2. Pierwszy import w ciągu ≤15 minut.
3. Pierwsze produkty oczekują na akceptację admina BidBil. Po akceptacji pierwszej partii integracja staje się zaufana — kolejne idą od razu na żywo.
4. Push zamówień działa już od momentu aktywacji (od pierwszego zakupu na BidBil).
5. Mirror statusu (gdy oznaczysz w PS „Wysłane" → BidBil to zauważy w ≤5 min i powiadomi buyera).