Konfiguracja API dostawcy dropshippingowego obejmuje uzyskanie danych dostępowych, podłączenie endpointów w sklepie, mapowanie produktów i kategorii oraz ustawienie cyklicznej synchronizacji. W odróżnieniu od prostego importu XML, API może obsługiwać także wysyłanie zamówień do hurtowni.
Co przygotować przed konfiguracją API?
Zanim zainstalujesz moduł integracyjny, poproś dostawcę o komplet danych technicznych. Konkretne nazwy pól i sposób autoryzacji zależą od jego dokumentacji, dlatego nie należy zgadywać adresów ani parametrów żądań.
Przygotuj następujące informacje:
- Token lub API Key – dane uwierzytelniające, które pozwalają systemowi sklepu korzystać z API.
- Adres endpointu – URL punktu, z którym sklep komunikuje się w celu pobierania produktów, cen, stanów lub wysyłania zamówień.
- Dokumentację techniczną – opis metod, parametrów, formatów odpowiedzi, na przykład JSON, oraz kodów błędów.
- Mapowanie pól – informację, które dane odpowiadają w sklepie za SKU, EAN, nazwę, cenę, stan magazynowy, zdjęcia i atrybuty.
Klucza API nie przesyłaj e-mailem bez zabezpieczenia, nie umieszczaj go w publicznym kodzie strony i nie udostępniaj osobom, które nie uczestniczą w integracji. Jeśli dostawca oferuje środowisko testowe, rozpocznij konfigurację właśnie tam.
Jak skonfigurować API w panelu sklepu?
Układ menu różni się między platformami, na przykład WooCommerce, Shoperem czy Shopify, ale kolejność prac zwykle pozostaje podobna. Potrzebujesz modułu dostawcy, dedykowanej wtyczki albo pośredniego systemu integracyjnego.
- Aktywuj moduł lub wtyczkę API – zainstaluj rozwiązanie zgodne z używaną platformą i wersją sklepu. Sprawdź, czy obsługuje zarówno import oferty, jak i przekazywanie zamówień.
- Wprowadź dane autoryzacyjne – wpisz token lub API Key, adres endpointu oraz ewentualne dodatkowe parametry wymagane przez dostawcę. Użyj funkcji testu połączenia, jeśli jest dostępna.
- Ustaw zakres synchronizacji – zdecyduj, czy sklep ma pobierać produkty, opisy, zdjęcia, ceny, stany, statusy zamówień i numery przesyłek. Nie włączaj automatycznego nadpisywania treści, jeśli wcześniej przygotowałeś własne opisy.
- Skonfiguruj zadania CRON – CRON uruchamia synchronizację według ustalonego harmonogramu, bez ręcznego wywoływania procesu. Częstotliwość ustaw zgodnie z możliwościami platformy i limitami API dostawcy.
- Wykonaj mapowanie kategorii i atrybutów – połącz kategorie hurtowni z kategoriami sklepu oraz dopasuj pola, takie jak kolor, rozmiar, marka, SKU i EAN. Zdecyduj też, jak system ma przeliczać ceny i zaokrąglać wartości.
- Włącz przekazywanie zamówień – dopiero po sprawdzeniu importu produktów aktywuj wysyłanie opłaconych zamówień do dostawcy. Ustal, jak system obsługuje anulowania, braki magazynowe i ponowne wysłanie żądania.
Mapowanie decyduje o tym, czy dane z hurtowni będą użyteczne. Błędnie przypisana kategoria może umieścić produkt w niewłaściwym miejscu, a złe mapowanie ceny lub stanu może doprowadzić do sprzedaży produktu po nieaktualnej cenie albo mimo braku towaru.
XML czy API – czym różnią się te metody?
Plik XML jest źródłem danych, które sklep cyklicznie pobiera i przetwarza. API zapewnia komunikację z konkretnymi funkcjami systemu dostawcy. Nie każde API działa w czasie rzeczywistym, dlatego rzeczywistą częstotliwość aktualizacji zawsze określa dokumentacja i harmonogram synchronizacji.
| Cecha | Plik XML | API |
|---|---|---|
| Częstotliwość aktualizacji | Zależna od pobierania pliku i harmonogramu importu | Zależna od metod API, limitów oraz ustawień synchronizacji |
| Kierunkowość | Najczęściej pobieranie oferty, cen i stanów | Możliwe pobieranie danych oraz wysyłanie zamówień i statusów |
| Złożoność konfiguracji | Zwykle mniejsza | Większa, bo wymaga autoryzacji, endpointów i mapowania metod |
| Stabilność | Zależna od dostępności pliku i poprawności jego struktury | Zależna od działania usługi, limitów zapytań i obsługi błędów |
XML może wystarczyć do jednorazowego lub cyklicznego pobierania oferty. API lepiej pasuje do procesu, w którym sklep ma automatycznie przekazywać zamówienia, odbierać statusy realizacji i aktualizować dane w kilku kierunkach.
Jak sprawdzić, czy integracja działa?
Po pierwszym imporcie nie włączaj od razu pełnej automatyzacji. Przejdź przez proces na kilku produktach, a jeśli to możliwe, wykonaj zamówienie testowe w środowisku testowym. Sprawdź poniższe elementy:
- Czy produkt otrzymał właściwą kategorię, SKU, EAN, cenę i atrybuty.
- Czy zmiana stanu u dostawcy pojawia się w sklepie po uruchomieniu synchronizacji.
- Czy cena i reguły marży są obliczane zgodnie z konfiguracją.
- Czy testowe zamówienie trafia do dostawcy tylko raz i ma prawidłowy status.
- Czy sklep odbiera numer przesyłki oraz aktualizuje status realizacji.
- Czy logi pokazują poprawne wykonanie zadań CRON bez przerw i błędów.
Znaczenie podstawowych kodów HTTP pomaga zawęzić przyczynę problemu:
- 401 zwykle wskazuje na brak autoryzacji, nieważny token albo błędne dane logowania.
- 403 oznacza odmowę dostępu, na przykład brak uprawnień do wybranej metody API lub zablokowany adres IP.
- 500 sygnalizuje błąd po stronie serwera. Sprawdź logi, ponów żądanie później i skontaktuj się ze wsparciem dostawcy, jeśli problem się utrzymuje.
Po udanym teście ustaw synchronizację produkcyjną, monitoruj logi i ogranicz dostęp do kluczy API. Samo połączenie nie gwarantuje poprawnych danych. O jakości integracji decydują także mapowanie, obsługa błędów i regularna kontrola stanów magazynowych.
