Integracja z Empik Marketplace

AtomStore integruje się z Empik Marketplace, otwierając sklepom internetowym dostęp do jednego z najpopularniejszych marketplace’ów w Polsce. Integracja pozwala sprawniej zarządzać produktami, cenami, stanami magazynowymi i zamówieniami, bez konieczności ręcznego obsługiwania kilku systemów. Z artykułu dowiesz się, jak połączyć sklep na platformie AtomStore z Empik Marketplace, a także poznasz przykład importu zamówień oraz niezbędne mapowania.

---

Ogólne możliwości integracji

Integracja AtomStore x Empik umożliwia działania w zakresie:

• Eksportu ofert;
• Eksportu cen ofert;
• Eksportu stanów magazynowych ofert;
• Eksportu produktów;
• Importu zamówień;
• Eksportu statusów zamówień.

Procesy są uruchamiane w zależności od potrzeb Twojego sklepu.

---

Skąd pobrać dane dostępowe niezbędne do konfiguracji?

1. Zaloguj się do panelu Empik marketplace.

2. Następnie kliknij ikonkę z Twoimi danymi, a następnie wybierz: Ustawienia osobiste .

3. W ustawieniach osobistych wybierz: Klucz API , a następnie: Skopiuj klucz API .

4. Klucz API niezbędny będzie w konfiguracji ustawień modułu w panelu AtomStore.

---

Konfiguracja ustawień w panelu

1. Przejdź do Ustawienia Konfiguracja sklepu API i integracje FK/ERP Empik marketplace .

2. Rozwiń ustawienia i skonfiguruj:

• URL – w tym miejscu należy wskazać adres do API Empika. Adres do środowiska produkcyjnego to: https://marketplace.empik.com/, z kolei do testowego – https://stg1.marketplace.empik.com/;
• Klucz API – klucz pobierany ze środowiska Empik (informacja skąd pobrać klucz znajduje się w sekcji dot. Pobierania danych do konfiguracji); 
• Statusy potwierdzenia zamówienia – statusy wybrane w tym ustawieniu będą odpowiedzialne za przesyłanie do empiku statusu, że zamówienie jest potwierdzone; 
• Statusy anulowania zamówienia – statusy wybrane w tym ustawieniu będą odpowiedzialne za przesyłanie do empiku statusu, że zamówienie jest anulowane;
• Statusy wysylki zamówienia – statusy wybrane w tym ustawieniu będą odpowiedzialne za przesyłanie do empiku statusu, że zamówienie jest wysłane;  
• Ostatni import zamówień – data ostatniego importu zamówień (jest ona podstawiana automatycznie);
• Listy dynamiczne do eksportu ofert – w ustawieniu należy wskazać te listy dynamiczne, w których są produkty do eksportu ofert;
• Mapowanie dodatkowych pól zamówienia EmpikPlace do pól zamówienia w Atomie – w tym miejscu należy umieścić dodatkowe mapowania w stylu: nip:payment_address.nip (mapowanie za pomocą którego pobierany jest numer NIP);  
• Ostatni eksport statusów zamówień – data ostatniego eksportu statusów (podstawiana automatycznie);
• Identyfikacja produktu EAN – w tym miejscu należy wskazać, czy EAN jest w kodzie produktu czy w atrybucie;
• Atrybut produktu – EAN – jeśli w opcji powyżej wybrany zostanie atrybut, to w tym ustawieniu należy wskazać w jakim atrybucie jest EAN;
• Export produktów – klucz producenta w empikplace – tutaj wprowadź domyślny klucz producenta jaki ma być przesyłany do Empiku, używany w przypadku gdy chcesz przesyłać producentów zgodnie z polem Producent na produkcie (konieczne odpowiednie mapowanie z producentem po stronie EMPIK);
• Ostatni eksport cen – data ostatniego eksportu cen (podstawiana automatycznie);
• Identyfikacja produktu SKU – wskaż w ustawieniu czy SKU produktu jest zapisane w kodzie produkty czy w atrybucie;
• Atrybut produktu – Sku – jak ustawieniu identyfikacji wybrany został: Atrybut to w tym ustawieniu należy wskazać w jakim atrybucie znajduje się kod SKU;
• Ostatni eksport stanów – data ostatniego eksportu stanu (podstawiana automatycznie);
• Wysyłaj informacje o stanach produktów w oparciu o Stan dostępny – jeśli zaznaczysz: Nie – wysyłany będzie stan magazynowy do Empiku, z kolei w opcji: Tak – przesyłany jest stan magazynowy, odejmując rezerwację na produkty;
• Wysyłaj ceny promocyjne – ustawienie odpowiedzialne za to czy wysyłane będą ceny promocyjne, czy też nie;
• Listy dynamiczne do eksportu produktów – w ustawieniu należy wskazać te listy dynamiczne, w których są produkty do eksportu produktów;
• Ostatni eksport produktów – data ostatniego eksportu produktów (podstawiana automatycznie);
• Ostatni eksport ofert – data ostatniego eksportu ofert (podstawiana automatycznie);
• Cennik do eksportu cen ofert – w ustawieniu należy wskazać cennik, z którego ceny mają być przesyłane do Empiku;
• Domyślny stan produktu – eksport ofert – w tym ustawieniu należy określić, jaki domyślnie wysyłany jest stan oferty do wszystkich ofert – 11 – to jest stan oferty: NOWY .

---

Proces importu zamówień

1. W panelu Empiku istnieje przykładowe zamówienie, które jest nowe i posiada status: Przyjęcie w toku . 

2. Zamówienie zostało zaimportowane do panelu AtomStore:

Otrzymując jednocześnie status zgodny z mapowaniem:

3. Zamówienie na tym etapie posiadać będzie niekompletne dane. Wynika to z tego, że dopiero po jego potwierdzeniu zostaną one zwrócone. 

4. Kolejnym krokiem jest zmiana statusu na zgodny z ustawieniem: Statusy potwierdzenia zamówienia . W tym przypadku jest to status: W trakcie realizacji .

5. Po uruchomieniu skryptu do eksportu statusów, status zostanie zmieniony w panelu Empik.

6. Następnie, po ponownym imporcie zamówienia, dane w zamówieniu zostały uzupełnione. 

7. Po wygenerowaniu listu przewozowego, numer przesyłki jest przekazywany do Empiku:

8. Aby numer przesyłki ustawiany był poprawnie, konieczne jest skonfigurowanie przewoźników po stronie Empiku. W tym celu w panelu przejdź do: Ustawienia Konfiguracja wysyłki Dodaj przewoźnika . Na poniższym zrzucie możesz zobaczyć przykład skonfigurowanego kuriera DPD.

9. Następnie, dla tego przewoźnika musisz dodać odpowiednie mapowanie w panelu AtomStore. 

Tworząc nowe mapowanie kuriera ustaw:

• Obiekt wewnętrzny – wybrana forma dostawy w AtomStore;
• ID zewnętrzne – nazwa formy dostawy, jaka jest widoczna w Empiku na zamówieniu. Na przykładzie omawianego zamówienia, widoczną formą dostawy jest DPD PIckup, co widać w polu: Sposób ;
• Nazwa zewnętrzna – kod przewoźnika z panelu Empik. Na przykładzie zamówienia, będzie to: dpd .

10. Jeśli w ustawieniu: Status wysyłki zamówienia w konfiguracji ustawień modułu wybierzesz: Wysłany :

W takiej sytuacji do empiku podczas eksportu statusów trafi status: Wysłano .

---

Mapowania parametrów – niezbędne do eksportu produktów

1. Istotnym jest, aby przed eksportem produktów utworzyć odpowiednie mapowania w panelu AtomStore.

Mapowanie stawki VAT

1. Przejdź do: Ustawienia Mapowanie obiektów . Mapując stawkę VAT należy podać:

• Obiekt wewnętrzny – to stawka, która skonfigurowana została w AtomStore, np. 23%;
• ID zewnętrzne – pobierane jest z zakładki: Mapowania katalogu po stronie Empiku. W tym celu przejdź do: Ustawienia Mapowania katalogu , a następnie kliknij: Konfiguracja platformy .

Następnie, wybierz oznaczoną na czerwono: Stawka VAT . Z prawej strony wyświetlone zostaną szczegóły. Obok stawki = 23% w nawiasie znajduje się jej ID = 7.

Tak skonfigurowane mapowanie widoczne będzie w panelu AtomStore:

Mapowanie producentów

1. W ustawieniu: Export produktów – klucz producenta w empikplace (na etapie konfiguracji ustawień) należy wprowadzić klucz dla producenta. Zazwyczaj jest to: 600 . 

2. Klucz = 600 odpowiada ID z panelu Empik. Znajdziesz go po przejściu do: Ustawienia Mapowanie katalogu Rozwinięcie wybranego atrybutu Producent Szczegóły atrybutu .

3. ID może mieć różne wartości, zależnie od kategorii. W takiej sytuacji należy skorzystać z mapowania atrybutu i w atrybucie dodać odpowiednie mapowania.

4. Jak zrobić mapowanie producenta? Przejdź w panelu AtomStore do: Ustawienia Mapowanie obiektów . Jak w poprzednich mapowaniach – obiektem wewnętrznym jest nazwa producenta. Z kolei ID zewnętrzne to wartość, która znajduje się w szczegółach przy producencie.

Tak skonfigurowane mapowanie w panelu wygląda następująco:

Mapowanie kategorii

1. Aby zmapować kategorię, należy znaleźć odpowiedni kod kategorii w panelu Empiku. Przejdź do: Mapowanie obiektów Kategoria Podkategorie Szczegóły .

2. Taki kod należy zmapować w panelu AtomStore jako ID zewnętrzne. Z kolei obiektem wewnętrznym jest ścieżka do określonej kategorii. Mapowanie zatem będzie prezentować się w następujący sposób.

Mapowanie atrybutu

1. Do zmapowania atrybutu potrzebne będzie ID zewnętrzne, czyli Kod po stronie Empiku. 

2. Następnie, mapując obiekt pamiętaj o ustawieniu obiektu wewnętrznego, czyli Atrybutu po stronie AtomStore. Mapowanie będzie wyglądać następująco.

Mapowanie wartości atrybutów

1. ID zewnętrzne do mapowania odpowiadać będzie wartości pobieranej z zaznaczonego miejsca w panelu Empiku:

2. Następnie, mapowanie po stronie AtomStore wygląda w następujący sposób:

Obiektem wewnętrznym jest odpowiednia wartość atrybutu (obok znajduje się właściwy atrybut z którego mapowana jest wartość).

Mapowanie form dostawy

1. Dla przewoźnika musisz dodać odpowiednie mapowanie w panelu AtomStore. 

Tworząc nowe mapowanie kuriera ustaw:

• Obiekt wewnętrzny – wybrana forma dostawy w AtomStore;
• ID zewnętrzne – nazwa formy dostawy, jaka jest widoczna w Empiku na zamówieniu. Na przykład formą dostawy jest DPD PIckup, co widać będzie w polu: Sposób ;
• Nazwa zewnętrzna – kod przewoźnika z panelu Empik. Na przykładzie zamówienia z formą dostawy DPD Pickup, będzie to: dpd .

Mapowanie form płatności

1. W przypadku mapowań form płatności jako ID zewnętrzne należy podać nazwę widoczną w empiku, np. Płatność z góry (na zamówieniu jest widoczna przy polu: Sposób płatności . Z kolei w nazwie zewnętrznej podaj: payment_type .

2. Tak skonfigurowane mapowanie widoczne będzie w panelu AtomStore.