Integracja
Integracja Empik z Magento 2: atrybut cost i stany MSI w progach cen
Jeśli Twój sklep działa na Magento 2 albo Adobe Commerce, oGrosika pobiera z niego koszt, EAN i stany produktów i pilnuje na tej podstawie progów cen ofert na Empiku.
Co pobieramy z Magento?
Z Magento 2 pobieramy SKU, kod EAN, koszt i stan produktów prostych. Koszt to standardowy atrybut cost, czyli cena zakupu. Kod EAN czytamy z atrybutu o kodzie, który wskażesz w ustawieniach integracji, bo każdy sklep nazywa go inaczej.
| Dane w Magento | Do czego służą? |
|---|---|
| SKU i atrybut EAN | Połączenie produktu z ofertą na Empiku |
| Atrybut cost | Cena zakupu, z której liczy się próg ceny minimalnej |
| Stany ze źródeł MSI | Ochrona przed sprzedażą towaru, którego nie ma |
Jeśli używasz wielu źródeł magazynowych (MSI), sumujemy ilości ze wszystkich źródeł produktu. Produkty konfigurowalne nie mają własnego stanu, dlatego łączymy z Empikiem ich produkty proste.
Jak dać dostęp?
Dostęp dajesz przez integrację w panelu administracyjnym Magento (System, sekcja Integracje). Integracja dostaje token, którym oGrosika czyta dane.
- Dodaj integrację. Utwórz nową integrację i nazwij ją, np. „oGrosika, tylko odczyt”.
- Zawęź zasoby. W zakładce dostępu do API wybierz własny zakres i zaznacz tylko katalog produktów oraz magazyn (odczyt).
- Aktywuj integrację. Po aktywacji Magento pokaże token dostępu.
- Wklej adres i token w oGrosika. W panelu oGrosika otwórz Integracje, wybierz Magento, wpisz adres sklepu, token i kod atrybutu EAN, a potem kliknij „Testuj”.
Jak łączymy produkty z ofertami na Empiku?
Produkt ze sklepu łączymy z ofertą na Empiku najpierw po SKU, czyli po kodzie oferty (shop_sku). Wielkość liter nie ma znaczenia, więc ABC-12 i abc-12 to ten sam produkt. Gdy SKU się nie zgadza albo go brakuje, próbujemy po kodzie EAN.
Po każdym pobraniu panel pokazuje, ile ofert udało się dopasować, ile z nich ma cenę zakupu, a ile stan. Oferty bez dopasowania trafiają na osobną listę, którą możesz przejrzeć i poprawić kody w Magento albo w ofertach na Empiku.
Do czego służą koszt i stan?
Cena zakupu trafia do ceny zakupu oferty w oGrosika. Z niej, razem z marżą i kosztami stałymi z Reguł, automat liczy próg ceny minimalnej, poniżej którego oferta nie zejdzie. Dokładny wzór z prowizją, VAT i dostawą pokazujemy we wpisie jak policzyć cenę minimalną na Empiku, a pojedynczą ofertę sprawdzisz w kalkulatorze Empik.
Stan chroni przed sprzedażą towaru, którego nie masz. Oferty aktywne na Empiku przy zerowym stanie widać w filtrze „bez towaru”, a automatyczna akceptacja zamówień sprawdza stan przed przyjęciem zamówienia. Jeśli koszt albo stan bierzesz z innego źródła, możesz wyłączyć jedno z nich w ustawieniach integracji.
Czego nie robimy?
Integracja wyłącznie czyta dane. oGrosika niczego nie zapisuje w Magento: nie zmienia cen, stanów, opisów ani zamówień. Ceny na Empiku zmienia tylko automat cenowy, i to w granicach progów, które ustawisz. Dane dostępowe zapisujemy zaszyfrowane, a w każdej chwili możesz odłączyć integrację w panelu albo unieważnić dostęp po swojej stronie. Więcej o tym, jak chronimy dane, piszemy na stronie bezpieczeństwo.
Typowe problemy
- Pusty atrybut cost. Bez kosztu próg ustawisz importem z pliku CSV albo z innego źródła kosztów.
- Brak stanów. Gdy sklep nie używa MSI, czytamy stan zapisany przy produkcie. Jeśli i tego brak, wyłącz branie stanu z tej integracji.
- Błąd 401. Najczęściej integracja nie jest aktywna albo nie ma dostępu do katalogu lub magazynu.
Pytania
Czy działa z Adobe Commerce?
Tak. Korzystamy ze standardowego REST API Magento 2, które ma też Adobe Commerce.
Skąd bierzecie cenę zakupu?
Z atrybutu cost, który Magento ma w standardzie. Jeśli koszt trzymasz w innym atrybucie, podaj jego kod w ustawieniach.
Jak liczycie stan przy kilku magazynach?
Sumujemy ilości ze wszystkich źródeł magazynowych MSI przypisanych do produktu.
Czy token pozwala coś zmienić?
Tylko jeśli dasz mu takie uprawnienia. Zalecamy zakres tylko do odczytu katalogu i magazynu, a sama integracja i tak niczego nie zapisuje.