Integracja z InPost von Halsky

InPost Von Halsky to nowoczesny moduł, który upraszcza proces zakupowy i logistykę e-commerce w jednym miejscu. Za jego pomocą możesz szybko, z poziomu panelu AtomStore wystawiać oferty produktowe – zarówno wariantowe, jak i zestawy zamknięte, a także między innymi importować zamówienia. Sprawdź, jak skonfigurować ustawienia, w sklepie na platformie AtomStore, a także poznaj praktyczne przykłady zastosowania. 

---

Pierwsze kroki z InPost Von Halsky

1. Aby rozpocząć pracę z InPost Von Halsky należy mieć podpisaną umowę logistyczną na kuriera oraz paczkomat InPost. 

2. Kolejno, należy wypełnić i wysłać formularz rejestracyjny, który znajdziesz w tym miejscu.

3. Po weryfikacji formularza, otrzymasz zaproszenie na adres e-mail do panelu merchanta. 

4. Następnie, przejdziesz przez proces onboardingu – zgodnie z krokami w panelu.

5. Po realizacji powyższego połączysz się z integratorem i wtedy możesz zacząć wystawiać i sprzedawać oferty.

---

Nadanie uprawnień do InPost Von Halsky

1. Przejdź do Ustawienia Grupy uprawnień .

2. Zaznacz checkbox Multichannel InPost Von Halsky .

3. Zapisz nowe uprawnienia klikając wskazany przycisk.

---

Konfiguracja ustawień modułu

1. Przejdź do Ustawienia Konfiguracja sklepu Multichannel InPost Von Halsky .

2. Rozwiń ustawienia. W tym miejscu znajduje się kilka zakładek, w których należy skonfigurować odpowiednie elementy. 

• Ustawienia ogólne;
• Dane dostępowe;
• Mapowanie atrybutów;
• Mapowanie statusów;
• Mapowanie form dostawy.

2. Na początek, skonfiguruj ustawienia ogólne:

• Szablon nazw produktów (ofert) – możesz użyć znaczników #nazwa#, #producent#, #kod# oraz #atrybut:X#, gdzie X to ID atrybutu. Nazwa według szablonu podstawiana będzie pod nazwę oferty przy jej wystawianiu;
• Cennik – jest to ustawienie opcjonalne, tj. można je skonfigurować, ale nie jest to konieczne. Domyślnie zawsze wysyłana jest cena podstawowa produktu. Można wskazać inny cennik, z którego pobierana będzie cena;
• Uwzględniaj ceny promocyjne – w tym ustawieniu należy zdecydować, czy wysyłana będzie cena podstawowa czy promocyjna. Jeżeli operujesz na cenniku, a jednocześnie w produkcie ustawiona jest promocja, to o cenie ostatecznej decyduje ustawienie globalne Promocje % vs cennik klienta . Cena obniżona pojawi się jako cena standardowa, a nie promocyjna (tj. z przekreśleniem);
• Aktualizuj cenę – do wyboru są opcje: Tak lub Nie . Ustawienie decyduje o tym, czy zmiana ceny w AtomStore ma wpływać na cenę w ofercie. O zmianie ceny decyduje wyzwalacz przy procesach takich jak np. zmiana ręczna, zmiana importem, zmiana przez API REST, SOAP, a także zmiana przez reguły cenowe
• Aktualizuj stan magazynowy – do wyboru są opcje: Tak lub Nie . ustawienie decyduje o tym, czy zmiana stanu dostępnego ma wpływać na ilość w ofercie. O zmianie ilości decyduje wyzwalacz przy różnych procesach, np. zmiana ręczna, zmiana importem, zmiana przez API REST, SOAP, zmiana przez zakup, a także nadanie statusów, również anulowanego;
• Powiązana forma płatności – w tym miejscu należy zmapować formę płatności do integracji. Służy do importu zamówień;
• Wystawianie oferty – pobieraj informacje o produkcie z bazy InPost – w momencie, gdy wystawiana jest oferta – informacje dotyczące produktu pobierane będą bezpośrednio z bazy InPostu Jeśli to ustawienie zostanie zaznaczone na Nie – zaznaczenie opcji Nie spowoduje, że będziesz musiał uzupełnić wszystkie wymagane wymiary, m.in. producenta, parametry zależne od kategorii oraz same kategorie. Jeśli z kolei zaznaczysz Tak – produkt zostanie wyszukany na podstawie kodu EAN w bazie InPost Von Halsky i to z tego miejsca będą pobrane te dane;
• Zamykaj ofertę po dezaktywacji produktu – w tym miejscu możesz ustawić, czy po dezaktywacji produktu oferta ma być zamykana;

3. Kolejno, rozwiń zakładkę: Dane dostępowe i skonfiguruj ustawienia:

• Tryb testowy – wybierz czy chcesz, aby integracja działała w trybie testowym lub trybie produkcyjnym. W przypadku wyboru trybu testowego, w panelu sklepu pojawiać się będą zarówno realne zamówienia, jak i takie, które składane są przez testerów; 
• ID organizacji – ID organizacji, które otrzymujesz od InPost;
• Access Token – generowany jest automatycznie po kliknięciu: Uzyskaj token . Działa na podstawie ID organizacji;
• Access Token – czas ważności – przez jaki czas token dostępu ma być ważny (ustawia się samoczynnie);
• Refresh Token;
• Refresh Token – czas ważności – czas, przez który token ma być ważny (ustawia się samoczynnie).

Dane dostępowe, takie jak ID organizacji należy uzyskać od InPost.

4. Następnie, czas przejść do etapu mapowań. Pierwszą zakładką związaną z mapowaniami to: Mapowanie atrybutów . Podczas wystawiania oferty istnieją wspólne pola wystawiane – są to pola z mapowań. Część danych znajdować się będzie w mapowaniu, ponieważ są to informacje wspólne dla wielu ofert. System wtedy automatycznie uzupełnia je na podstawie wcześniej zdefiniowanych ustawień. Niektóre z nich będą wymagane, a niektóre nie.

• Atrybut “Model” – zmapuj atrybut odpowiadający za model (to wariant z danej grupy, np. Basic v-neck lub Basic crew-neck);
• Atrybut “SuperModel” – zmapuj atrybut odpowiadający za supermodel (to ogólna grupa, do której należy produkt, np. T-shirt ;
• Atrybut “Szerokość” – zmapuj atrybut odpowiadający za szerokość produktu;
• Atrybut “Wysokość” (cm) – zmapuj atrybut odpowiadający za wysokość produktu;
• Atrybut “Długość” (cm) – zmapuj atrybut odpowiadający za długość produktu;

W przypadku atrybutów: Szerokość, Wysokość oraz Długość chodzi o wymiary logistyczne opakowania.

• Atrybut “Waga” (kg) – zmapuj atrybut odpowiadający za wagę produktu (rozumiany jako parametr logistyczny);
• Identyfikator dla pola ‘SKU’ – w tym miejscu wybierz identyfikator odpowiadający kodowi SKU. Może to być: ID produktu, Kod produktu lub Wybrany atrybut . Jeśli wybierzesz Wybrany atrybut zmapuj atrybut w ustawieniu poniżej;
• Identyfikator dla pola ‘SKU’ – atrybut – jeśli wybrałeś powyżej opcję: Wybrany atrybut w tym miejscu zmapuj atrybut odpowiadający za SKU produktu, np. ID;
• Identyfikator dla pola ‘manufacturerProductNumber’ –  w tym miejscu wybierz identyfikator odpowiadający kodowi producenta. Może to być: Kod produktu lub Wybrany atrybut . Jeśli wybierzesz Wybrany atrybut zmapuj atrybut w ustawieniu poniżej; ;
• Identyfikator dla pola ‘manufacturerProductNumber’ – atrybut –  jeśli wybrałeś powyżej opcję: Wybrany atrybut w tym miejscu zmapuj atrybut odpowiadający za kod producenta;
• Identyfikator dla pola ‘EAN’ –  w tym miejscu wybierz identyfikator odpowiadający kodowi EAN. Może to być: Kod produktu lub Wybrany atrybut . Jeśli wybierzesz Wybrany atrybut zmapuj atrybut w ustawieniu poniżej;
• Identyfikator dla pola ‘EAN’ – atrybut –  jeśli wybrałeś powyżej opcję: Wybrany atrybut w tym miejscu zmapuj atrybut odpowiadający za kod EAN.

5. Rozwiń zakładkę: Mapowanie statusów . Mapowania statusów oraz form dostawy służą późniejszemu pobieraniu zamówień. Pamiętaj, aby wcześniej utworzyć nowe statusy, specjalnie do InPost.

W tym miejscu skonfiguruj: 

• Status ‘CREATED’ – mapowanie dla statusu “Utworzone”;
• Status ‘ACCEPTED’ – mapowanie dla statusu “Zaakceptowane”;
• Status ‘CANCELED’ – mapowanie dla statusu “Anulowane”;
• Status ‘REFUSED’ – mapowanie dla statusu “Odmowa”;
• Status ‘REJECTED’ – mapowanie dla statusu “Odrzucone”;
• Status oznaczający akceptację zamówienia – mapowanie dla statusu potwierdzającego akceptację zamówienia w InPost Von Halsky;
• Status oznaczający odrzucenie zamówienia – mapowanie dla statusu odrzucającego zamówienie w InPost Von Halsky. 

6. Ostatnią zakładką jest Mapowanie form dostawy . W tym miejscu należy zmapować formy dostawy, które dostępne będą w ramach integracji. Wybór tych opcji jest odgórnie narzucony przez InPost.

• Forma dostawy ‘Paczkomaty’ (APM) – tu zmapuj formę odpowiadającą paczkomatom;
• Forma dostawy ‘Kurier’ (COURIER) – tu zmapuj formę odpowiadającą kurierowi. AtomStore rekomenduje w tym miejscu mapowanie kuriera InPost. Wymagane jest posiadanie umowy na paczkomat oraz kuriera.

7. Zapisz dane. Integracja została skonfigurowana i można przejść do kolejnych etapów. 

---

Wystawianie ofert

Obecnie, można wystawiać:

• Produkty bez wariantów – grupowo oraz indywidualnie;
• Produkty z wariantami – wyłącznie indywidualnie. Należy wybrać konkretny wariant do wystawiania. Nie ma możliwości wystawienia grupowego;
• Zestaw zamknięty – indywidualnie z wyborem wariantu (jezeli zestaw składa się z produktu z wariantem). Nie ma możliwości wystawienia grupowego. Więcej informacji na temat zestawów zamkniętych znajdziesz w tym miejscu. 

1. Przejdź do Katalog Produkty . W tym miejscu kliknij przycisk Szukaj lub wybierz odpowiednie filtry, aby pojawiła się lista produktów. 

2. Zaznacz produkt i kliknij ikonę młotka oznaczającą Wystawianie na InPost Von Halsky . Ikoną młotka możesz wystawić produkty z wariantami.

3. Możesz ewentualnie w kolumnie Opcje kliknąć ikonę plusa, która oznacza również możliwość wystawiania na InPost Von Halsky. Ta ikona pozwala na wystawianie wariantów pojedynczo.

Przykład 1: Oferta z produktem posiadającym warianty

4. Zostanie wyświetlone okno wystawiania produktu. W przypadku, gdy produkt posiada warianty (np. rozmiarowe), do wyboru będzie najpierw odpowiedni wariant.

Jeśli wystawiasz ofertę przy użyciu opcji grupowej, wtedy widok wyboru wariantu jest następujący:

5. Po kliknięciu Wystaw wyświetlony zostanie widok konfiguracji oferty. W tym miejscu zobaczysz, jakie informacje o produkcie zostały pobrane do oferty:

A. Dane o nazwie oferty, kody SKU/EAN, informacje o producencie (UWAGA! W przypadku kodu EAN upewnij się, że  jest poprawny. Brak możliwości edycji (jest to ograniczenie InPost)

B. Atrybuty, które zostały zmapowane na etapie konfiguracji oraz: informacja o możliwości zwrotu i opis. Waga, która ustawiona jest w atrybucie globalnym, będzie mieć priorytet nad wagą ustawioną w edycji produktu.

C. Kategoria i pozostałe atrybuty, a także cena brutto i ilość sztuk.

Przy kategorii dodatkowo widoczny jest checkbox Nadpisz mapowanie kategorii . Zaznacz jeżeli chcesz nadpisać mapowanie kategorii głównej produktu na wybraną kategorię InPost. Jak zostanie wystawiona taka oferta, to w zakładce Ustawienia Mapowanie obiektów , utworzy się mapowanie moduł: InPost Von Halsky, typ obiektu: kategoria, powinno zostać utworzone mapowanie kategorii. Przy kolejnym wystawieniu produktu z tej kategorii automatyczne wczytana zostanie ta kategoria z inposta. Jak zostanie zmieniona i klikniesz Nadpisz mapowanie kategorii to zostanie nadpisana.

UWAGA! Każda oferta wymaga zdjęcia produktu, jest on przesyłany automatycznie ze zdjęcia produktu lub zdjęcia wariantu. 

6. Kliknij Wystaw . 

7. Zostaniesz poinformowany o zapisaniu i wysłaniu oferty.

8. W ofercie przesyłane są dodatkowo pola, które pierwotnie mogą nie być widoczne lub edytowalne. Są to:

• daysToShip – produkt ma przykładowo stan dostępności = Dostępny i w tym statusie jest uzupełnione pole: Czas realizacji (w dniach) i z tego pola jest to przesyłane;
• Stawka podatkowa – vat na produkcie;
• Jednostka – sztuka, para – jednostka miary z produktu;
• Kaucja informacja – kaucja produkt/wariant;
• GPSR – z produktu albo producenta;
• Polityka zwrotu/reklamacji – wskazany atrybut;
• Zdjęcia;
• Dostępność/cena – stan dostępny/cena.

Przykład 2: Oferta z jednym produktem

1. W Multichannel InPost Von Halsky- oferty zaznacz produkt, a następnie kliknij ikonę Wystaw ofertę na InPost Von Halsky .

2. Zostanie wyświetlone okno z pobranymi informacjami o produkcie:

3. Kliknij Wystaw .

O czym należy pamiętać podczas wystawiania oferty?

1. W sytuacji, w której spróbujesz wystawić ofertę, która nie ma pól zmapowanych, tam gdzie jest wymagane uzupełnienie, wyświetli się informacja z prośbą o poprawne uzupełnienie pól

Pola te trzeba zawsze uzupełnić ręcznie lub zmapować ustawieniach globalnych. 

2. Jeśli atrybuty globalne będą poprawnie zmapowane i będą one zapisane w produktach, to przy wystawianiu będą one widoczne.

---

Gdzie można znaleźć oferty?

1. Oferty możesz znaleźć przechodząc do: Multichannel InPost Von Halsky – Oferty .

2. Na liście ofert zobaczysz kilka kolumn:

• ID oferty;
• Produkt;
• Status, cena, ilość, opcje (w tym: edycja, zamknięcie oferty, usunięcie jej).

3. Gdy oferta zostanie zaakceptowana uzyska ona status: PUBLISHED . Co istotne, w sytuacji, gdy oferta zyskuje status: PENDING oznacza to, że czegoś brakuje. W tooltipie znajdziesz szczegółową informację

---

Zamykanie oferty

1. Przejdź do Multichannel InPost Von Halsky – oferty , a następnie w kolumnie: Opcje wybierz: Zamknij ofertę .

2. Potwierdź zamknięcie oferty.

3. Status oferty zostanie zmieniony na CLOSED .

---

Jak ręcznie edytować cenę w ofercie? 

1. W sytuacji, gdy w ustawieniach wyłączone są ustawienia: Aktualizuj cenę oraz Aktualizuj stan magazynowy .

w edycji oferty będzie możliwość uzupełnienia pól: Cena brutto oraz Ilość sztuk .

(jeśli te ustawienia są włączone, wtedy zadziała automatyczne aktualizowanie).

UWAGA! Jeżeli jest włączona aktualizacja cen lub aktualizacja ilości na podstawie ustawień: Aktualizuj cenę lub Aktualizuj stan magazynowy , to uruchomione zostaną wyzwalacze i jednocześnie z nimi pobierane będą pola z produktu i przesyłane do istniejącej oferty:

• daysToShip;
• Stawka podatkowa;
• Jednostka – sztuka, para;
• Kaucja informacja;
• GPSR z produktu albo producenta;
• Polityka zwrotu/reklamacji;
• Zdjęcia;
• Dostępność/cena.

Dojdzie zatem do nadpisywania.

2. Po zapisaniu zmian, nowa cena jest wyświetlana w kolumnie.

---

Jak ustawić ceny inne dla InPost vs ceny sklepu?

1. W Sprzedaż Cenniki istnieje przykładowy: Ręczny cennik .

2. Po przejściu do Katalog Produkty Edycja produktu , a następnie wyborze zakładki: Ceny i promocje istnieje pole odpowiadające cennikowi z punktu 1. 

3. Po zapisaniu w niej ceny, podczas wystawiania oferty cena, która się w niej pojawi odpowiadać będzie cenie wskazanej w cenniku. Cena z cennika będzie zależna od ustawienia: Cennik w ustawieniach ogólnych modułu.

4. Jeśli nie posiadasz cennika, w takiej sytuacji cena w ofercie odpowiadać będzie cenie podstawowej produktu.

5. Jeśli jednak istnieje cennik, ale nie ma w niej podanej ceny – w takiej sytuacji cena wczytana będzie również z ceny podstawowej produktu.