Artykuły i ilości
Numer artykułu, opis, ilość i uzgodniony kod jednostki.
STASTO × TWÓJ SYSTEM ZAMÓWIEŃ
Wybierz w sklepie.
Kontynuuj pracę w systemie ERP.
Otwórz katalog STASTO w swoim systemie zamówień. Znajdź odpowiednie komponenty i przenieś zawartość koszyka do procesu zakupowego.
Twój system zamówieńRozpocznij sesję katalogową
OCI
STASTO STOREZnajdź. Wybierz. Dodaj do koszyka.
PneumatykaArmatura
Przekazanie zawartości koszyka
Powrót do procesu zakupowegoSprawdź w systemie ERP i kontynuuj
01 / PUNCHOUT
Cztery kroki od katalogu do zakupu.
- 01
Rozpocznij pracę w systemie ERP
Uruchom katalog STASTO z poziomu systemu zaopatrzeniowego. Dostęp do katalogu oraz adres powrotny zostaną przekazane do sklepu.
- 02
Wybierz komponenty
Wyszukaj według numeru artykułu lub hasła, wybierz spośród zdjęć produktów i zawęź wyniki za pomocą filtrów technicznych.
- 03
Przenieś koszyk
Uruchom program PunchOut w koszyku. Sprawdź podsumowanie transferu, a następnie potwierdź zwrot danych do systemu ERP.
- 04
Kontynuuj zakupy
Proszę sprawdzić przejęte pozycje w systemie zaopatrzenia i kontynuować wewnętrzny proces zatwierdzania i składania zamówień.
Samo przekazanie koszyka nie powoduje jeszcze złożenia zamówienia w STASTO. Kolejne etapy zakupu odbywają się w Państwa systemie zaopatrzeniowym.
02 / KONFIGURACJA
Wszystko dla Twojego zespołu ds. integracji.
Strona główna katalogu
POST
https://www.stasto.eu/oci/catalogPunkt końcowy środowiska produkcyjnego. Przed przeprowadzeniem testu integracji należy uzgodnić z firmą STASTO utworzenie oddzielnego środowiska testowego.
| Parametry | Znaczenie |
|---|---|
HOOK_URL | Wymagane. Adres powrotny udostępniony przez system zamówień na potrzeby bieżącej sesji. |
nazwa użytkownika | Ustalone dane logowania użytkownika do katalogu. Wymagane przy logowaniu za pomocą parametrów. |
hasło | Hasło do tego wpisu w katalogu. Wymagane przy logowaniu za pomocą parametrów. |
Przykład wywołania · POST
Przykład z symbolami zastępczymi. Przekaż wartości zakodowane w formacie URL w treści żądania i zastąp wszystkie symbole zastępcze w konfiguracji integracji.
POST /oci/catalog HTTP/1.1
Host: www.stasto.eu
Content-Type: application/x-www-form-urlencoded
HOOK_URL=https%3A%2F%2Ferp.example%2Foci%2Freturn&username=STASTO_LOGIN&password=STASTO_PASSWORDAlternatywny sposób logowania i zachowanie podczas sesji
Obsługiwane jest również uwierzytelnianie HTTP Basic. W tym przypadku należy pominąć parametry „username” i „password” oraz przekazać dane dostępowe w nagłówku „Authorization”. Parametr HOOK_URL pozostaje obowiązkowy.
W przypadku kompatybilnych systemów akceptowane jest GET. Zaleca się stosowanie protokołu HTTPS z metodą POST, aby dane logowania nie pojawiały się w historii adresów URL ani w logach adresów URL. Po zalogowaniu przeglądarka zostanie przekierowana na stronę /shop; należy zachować tę samą sesję przeglądarki do przekazania zawartości koszyka.
03 / DANE
Co trafia do Państwa systemu ERP.
Formularz zwrotu wysyła dane pozycji za pomocą żądania POST z przeglądarki na adres HOOK_URL. Pola są numerowane od 1 dla każdej pozycji w koszyku. Tabela przedstawia domyślne przyporządkowanie; dostosowane ustawienia klienta mogą nadpisać poszczególne wartości.
Ceny i czas dostawy
Cena jednostkowa po uwzględnieniu rabatu, waluta i czas dostawy w pełnych dniach.
Klasyfikacja i dane klientów
Grupa towarowa, opcjonalny numer artykułu klienta oraz zdjęcie produktu.
Referencje terenowe OCI
| Pole | Standardowa treść |
|---|---|
NEW_ITEM-VENDORMAT[1] | Numer katalogowy STASTO. |
NEW_ITEM-DESCRIPTION[1] | Nazwa produktu. |
NEW_ITEM-LONGTEXT_1:132[] | Opis produktu lub, w razie braku, nazwa produktu. |
NEW_ITEM-QUANTITY[1] | Ilość pozycji w koszyku. |
NEW_ITEM-UNIT[1] | Przypisanie jednostki zdefiniowane przez klienta, w przeciwnym razie jednostka OCI zdefiniowana w systemie; wartość domyślna C62. Rygorystyczne kontrole mogą zablokować nieprawidłowe przypisanie. |
NEW_ITEM-PRICE[1] | Cena jednostkowa z koszyka po uwzględnieniu rabatu. |
NEW_ITEM-PRICEUNIT[1] | 1 (cena za sztukę). |
NEW_ITEM-CURRENCY[1] | Waluta koszyka, na przykład EUR. |
NEW_ITEM-VENDOR[1] | Nazwa spółki STASTO będącej sprzedawcą. |
NEW_ITEM-LEADTIME[1] | Czas dostawy w pełnych dniach, zaokrąglony w górę. |
NEW_ITEM-MATGROUP[1] | Skonfigurowany kod eClass lub wartość domyślna kategorii. Zobacz wskazówki dotyczące klasyfikacji poniżej. |
NEW_ITEM_ATTACHMENT[1] | Bezwzględny adres URL zdjęcia produktu, o ile zdjęcie zostało dodane. |
NEW_ITEM_ATTACHMENT_TITLE[1] | Nazwa produktu na zdjęciu. |
NEW_ITEM-CUST_FIELD1[1] … NEW_ITEM-CUST_FIELD4[1] | Domyślnie puste; można skonfigurować stałe wartości dostosowane do potrzeb klienta. |
NEW_ITEM-CUST_FIELD5[1] | Numer artykułu klienta, jeśli został wprowadzony, lub skonfigurowana stała wartość. |
Formularz zwrotu wysyła ponadto parametry ~OkCode=ADDI, ~target=_top, ~ForceTarget=yes oraz ~caller=CTLG. Podczas odbioru należy uzgodnić te pola sterujące z odbiorcą.
eClass, grupy towarowe i przypisanie jednostek
Standardem jest eClass 7.1. eClass 8.1 wymaga istnienia odpowiedniego pola i zaktualizowanych danych. Pierwsza przypisana kategoria strony internetowej określa klasyfikację; z kodu usuwane są myślniki.
Jeśli brakuje wybranego kodu, sprawdzana jest skonfigurowana wersja awaryjna, a następnie stosowana jest kategoria wewnętrzna lub „Ogólne”. Gdy klasyfikacja jest wyłączona, wysyłana jest wartość „Ogólne”. Należy określić, jakie wartości akceptuje system ERP.
Kody jednostek i stałe wartości pól są konfigurowane dla przedsiębiorstwa klienta. Pole „dostawca” zawsze odnosi się do firmy sprzedającej. Zdjęcia produktów są przesyłane w postaci linków; przekazywany koszyk nie zawiera pakietu dokumentów.
04 / SPRAWDŹ
Sprawdzić cały przebieg.
Przed udostępnieniem systemu kupującym należy skorzystać ze zharmonizowanego środowiska testowego oraz małego przykładowego koszyka.
- Otwórz katalog z systemu ERP i sprawdź odpowiedni kontekst klienta oraz ceny.
- Wybierz dwa różne artykuły i zmień co najmniej jedną ilość.
- Sprawdź numery artykułów, ilość, jednostkę miary, walutę, cenę i termin dostawy w podsumowaniu przesyłki.
- Potwierdzić zwrot i porównać wszystkie przejęte pozycje w systemie ERP, w tym klasyfikację i pola klienta.
W koszyku opcja opróżnienia jest domyślnie włączona. Opróżnienie koszyka następuje podczas tworzenia zestawienia przesyłek, zanim system ERP potwierdzi ich odbiór. Należy to uwzględnić podczas testowania ponownej próby przesyłania.
05 / WSPARCIE
Masz pytania dotyczące połączenia?
W zgłoszeniu do pomocy technicznej prosimy podać nazwę systemu zakupowego, datę i godzinę próby oraz treść komunikatu o błędzie. Dane dostępowe należy przekazywać wyłącznie za pośrednictwem uzgodnionego, bezpiecznego kanału.
Omówić kwestię połączeniaBrakuje HOOK_URL – co to oznacza?
System ERP musi podawać adres powrotny przy otwieraniu strony /oci/catalog. Należy sprawdzić, czy nazwa HOOK_URL jest wpisana dokładnie z zachowaniem wielkich liter oraz czy kodowanie adresu URL jest prawidłowe.
Rejestracja nie powiodła się. Co należy sprawdzić?
Sprawdź uzgodniony login katalogowy, hasło oraz metodę logowania. Sam pozytywny kod statusu HTTP nie potwierdza pomyślnego zalogowania: sprawdź, czy przeglądarka nawiązuje połączenie ze sklepem.
W koszyku brakuje przycisku „PunchOut”.
Rozpocznij sesję z poziomu systemu ERP poprzez /oci/catalog i dodaj artykuł. Bezpośrednie wywołanie sklepu nie zapisuje adresu powrotnego PunchOut. Nie zmieniaj sesji przeglądarki.
Koszyk nie trafia do systemu ERP.
Potwierdź drugi etap przesyłania w podglądzie. Sprawdź, czy adres przekierowania akceptuje dane przesłane metodą POST z formularza, czy sesja wygasła oraz czy przeglądarka ogranicza korzystanie z okien osadzonych. Jeśli zawartość koszyka została wyczyszczona, przed ponowną próbą sprawdź najpierw system ERP.
Pozycja zostaje odrzucona ze względu na jednostkę miary lub grupę towarów.
Proszę porównać przeniesione wartości UNIT i MATGROUP z wartościami dopuszczalnymi w systemie ERP. Proszę uzgodnić przyporządkowanie jednostek, wersję eClass oraz wartości awaryjne z firmą STASTO.
Czy ta instrukcja dotyczy również cXML?
W niniejszej instrukcji opisano zaimplementowany interfejs OCI. Przed rozpoczęciem konfiguracji należy skonsultować się z firmą STASTO w sprawie innych protokołów lub wymagań specyficznych dla danego systemu.
Poznaj nasz sklep.Przejdź do przewodnika po sklepieZobacz asortyment