Položky a množství
Číslo položky, popis, množství a dohodnutý kód jednotky.
Individuell
Viele Komponenten, eine Artikelnummer — für Ihre Anwendung zusammengestellt, nicht aus dem Regal.
AnfragenSTASTO × VÁŠ NÁKUPNÍ SYSTÉM
Otevřete katalog STASTO ve svém systému pro správu nákupů. Vyhledejte vhodné komponenty a přeneste obsah košíku do svého nákupního procesu.
01 / PUNCHOUT
Spusťte katalog STASTO ze svého systému pro správu nákupů. Údaje o přístupu do katalogu a adresa pro návrat se předají do obchodu.
Vyhledávejte podle čísla výrobku nebo klíčového slova, vybírejte pomocí obrázků produktů a zúžte výběr variant pomocí technických filtrů.
Spusťte PunchOut v nákupním košíku. Zkontrolujte přehled přenosu a poté potvrďte odeslání dat do vašeho ERP systému.
Zkontrolujte převzaté položky ve vašem systému pro řízení nákupu a pokračujte ve svém interním schvalovacím a objednávkovém procesu.
Samotné odeslání košíku ještě neznamená zadání objednávky u společnosti STASTO. Další kroky nákupu proběhnou ve vašem nákupním systému.
02 / NASTAVENÍ
https://www.stasto.eu/oci/catalogProdukční koncový bod. Před provedením integračního testu se domluvte se společností STASTO na zprovoznění samostatného testovacího prostředí.
| Parametry | Význam |
|---|---|
HOOK_URL | Povinné. Adresa pro návrat, kterou váš systém pro zadávání veřejných zakázek poskytl pro aktuální relaci. |
uživatelské jméno | Nastavené přihlašovací údaje uživatele pro katalog. Vyžaduje se při přihlášení pomocí parametrů. |
heslo | Heslo pro tento přístup do katalogu. Je vyžadováno při přihlášení pomocí parametrů. |
Příklad se zástupnými znaky. Hodnoty předávejte v těle požadavku v URL kódování a nahraďte všechny zástupné znaky ve své konfiguraci integrace.
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_PASSWORDPodporováno je také základní ověřování HTTP. V takovém případě vynechte parametry „username“ a „password“ a předejte přihlašovací údaje v hlavičce „Authorization“. Parametr „HOOK_URL“ zůstává povinný.
U kompatibilních systémů je akceptován příkaz GET. Upřednostňujte protokol HTTPS s metodou POST, aby se přihlašovací údaje neobjevovaly v historii adres a v protokolech adres. Po přihlášení bude prohlížeč přesměrován na stránku /shop; pro předání košíku zachovejte stejnou relaci prohlížeče.
03 / DATA
Formulář pro vrácení zboží odesílá údaje o položkách pomocí metody POST v prohlížeči na vaši adresu HOOK_URL. Pole jsou pro každou položku v košíku očíslována od 1. Tabulka zobrazuje standardní přiřazení; přizpůsobená nastavení zákazníka mohou jednotlivé hodnoty přepsat.
Číslo položky, popis, množství a dohodnutý kód jednotky.
Jednotková cena po slevě, měna a dodací lhůta v celých dnech.
Skupina zboží, volitelné zákaznické číslo položky a obrázek produktu.
| Pole | Standardní obsah |
|---|---|
NEW_ITEM-VENDORMAT[1] | Číslo výrobku STASTO. |
NEW_ITEM-DESCRIPTION[1] | Název produktu. |
NEW_ITEM-LONGTEXT_1:132[] | Popis produktu, případně název produktu. |
NEW_ITEM-QUANTITY[1] | Množství položky v nákupním košíku. |
NEW_ITEM-UNIT[1] | Přiřazení jednotek podle požadavků zákazníka, jinak se použije zadaná jednotka OCI; výchozí hodnota C62. Přísné kontroly mohou neplatné přiřazení zablokovat. |
NEW_ITEM-PRICE[1] | Jednotková cena z nákupního košíku po uplatnění slevy. |
NEW_ITEM-PRICEUNIT[1] | 1 (cena za kus). |
NEW_ITEM-CURRENCY[1] | Měna v nákupním košíku, například EUR. |
NEW_ITEM-VENDOR[1] | Název prodávající společnosti STASTO. |
NEW_ITEM-LEADTIME[1] | Dodací lhůta v celých dnech, zaokrouhlená nahoru. |
NEW_ITEM-MATGROUP[1] | Nakonfigurovaný kód eClass nebo výchozí hodnota kategorie. Viz pokyny k klasifikaci níže. |
NEW_ITEM_ATTACHMENT[1] | Absolutní URL obrázku produktu, pokud je obrázek zadán. |
NEW_ITEM_ATTACHMENT_TITLE[1] | Název produktu k obrázku. |
NEW_ITEM-CUST_FIELD1[1] … NEW_ITEM-CUST_FIELD4[1] | Ve výchozím nastavení je pole prázdné; lze nakonfigurovat pevné hodnoty podle požadavků zákazníka. |
NEW_ITEM-CUST_FIELD5[1] | Číslo položky zákazníka, je-li zadáno, nebo nakonfigurovaná pevná hodnota. |
Formulář pro vrácení zboží navíc odesílá ~OkCode=ADDI, ~target=_top, ~ForceTarget=yes a ~caller=CTLG. Tyto parametry si při převzetí dohodněte s příjemcem.
Standardem je eClass 7.1. eClass 8.1 předpokládá existenci příslušného pole a správně zadaných údajů. První přiřazená kategorie webové stránky určuje klasifikaci; pomlčky se z kódu odstraní.
Pokud vybraný kód chybí, zkontroluje se nakonfigurovaná záložní verze, poté se použije interní kategorie nebo „General“. Je-li klasifikace deaktivována, odešle se „General“. Zkontrolujte, které hodnoty váš ERP systém akceptuje.
Kódy jednotek a pevné hodnoty polí se konfigurují pro společnost zákazníka. Pole „dodavatel“ vždy označuje prodávající společnost. Obrázky produktů se přenášejí jako odkazy; předání nákupního košíku neobsahuje balíček dokumentů.
04 / KONTROLA
Než systém zpřístupníte svým nákupčím, použijte sladěné testovací prostředí a malý vzorový nákupní košík.
V nákupním košíku je možnost vyprázdnění ve výchozím nastavení aktivována. K vyprázdnění dojde při vytváření přehledu přenosu, ještě předtím, než systém ERP potvrdí příjem. Tuto skutečnost zohledněte při testování opakovaného pokusu o přenos.
05 / PODPORA
Při podání žádosti o podporu uveďte svůj systém pro správu nákupů, čas, kdy k problému došlo, a text chybové zprávy. Přihlašovací údaje sdělujte pouze prostřednictvím předem dohodnutého zabezpečeného kanálu.
Projednat propojeníVáš ERP systém musí při otevření adresy /oci/catalog zadat adresu pro návrat. Zkontrolujte přesné psaní velkých písmen v proměnné HOOK_URL a kódování URL.
Zkontrolujte dohodnuté přihlašovací údaje do katalogu, heslo a způsob přihlášení. Samotný úspěšný stav HTTP ještě neznamená, že se přihlášení podařilo: zkontrolujte, zda se prohlížeč dokáže připojit k obchodu.
Spusťte relaci ze svého ERP systému přes /oci/catalog a přidejte položku. Při přímém vyvolání obchodu se nezadá adresa pro návrat v rámci PunchOut. Neměňte relaci prohlížeče.
Potvrďte druhý krok přenosu v přehledu. Zkontrolujte, zda adresa pro přesměrování přijímá odeslání formuláře metodou POST, zda nevypršela platnost relace a zda prohlížeč omezuje vnořená okna. Pokud byl košík vyprázdněn, před dalším pokusem nejprve zkontrolujte ERP.
Porovnejte přenesené hodnoty UNIT a MATGROUP s hodnotami povolenými v systému ERP. Sladěte přiřazení jednotek, verzi eClass a náhradní hodnoty se společností STASTO.
Tento návod popisuje implementované rozhraní OCI. Před nastavením se poraďte se společností STASTO ohledně jiných protokolů nebo požadavků specifických pro daný systém.