Teljesítési szolgáltatók csatlakoztatása

Megjegyzés: az alkalmazás felülete jelenleg angol, német és olasz nyelven érhető el. Az útmutató a kezelőelemek angol feliratait használja, félkövérrel kiemelve.

A teljesítési szolgáltatók (más néven 3PL-ek) átveszik a szállítmányaidat, és visszajelzik a nyomkövetési, termék- és készletadatokat. Ezeket a fiókokat a Settings → Connections oldalon adhatod hozzá, ahol a Fulfillment providers szakaszban jelennek meg.

Egy fiók csatlakoztatása soha nem indítja el a szállítmányok küldését. Ez helyszínenként, a Fulfillment → Setup oldalon történik, és csak azoknál a munkafolyamatoknál, amelyeket Active módba állítasz.

Szolgáltató	Mit kell megadnod	Útmutató
JTL FFN	Saját JTL-alkalmazás, majd bejelentkezés a JTL-nél	JTL csatlakoztatása a hubhoz
Magware	API URL, tulajdonoskód és API-kulcs	Magware
Mintsoft	API-kulcs	Mintsoft
Logisoft (Asendia)	Ügyfélazonosító és API-token; a számlákhoz opcionálisan SFTP-tárhely	Logisoft (Asendia)

Mielőtt elkezded

• Készítse elő a szolgáltató kapcsolati adatait. Szükség esetén kérje el őket a szolgáltatótól.
• Az API-kulcsokat, tokeneket és privát kulcsokat csak a hub űrlapján add meg. A Balta Labs titkosítva tárolja őket, és soha többé nem jeleníti meg. Soha ne küldd el őket e-mailben vagy csevegőüzenetben.
• A munkaterületen a Connections jogosultságra van szükséged.

Fiók hozzáadása

1. Nyisd meg a Settings → Connections oldalt. A Fulfillment providers szakaszban válaszd az Add provider gombot. Az oldal tetején lévő Add account gomb ugyanezeket a szolgáltatókat kínálja.
2. Válaszd ki a szolgáltatót.
3. Ha szeretnéd, töltsd ki a Connection name mezőt, majd az alább ismertetett mezőket.
4. Válaszd a Save account gombot.
5. A fiók kártyáján válaszd a Test gombot. Javítsd az értékeket, amíg a kártyán a Working állapot nem látható.
6. A Details gombbal megtekintheted az Account, a What the hub can do és a Reference lists részt; a helyszínek beállításakor ezekből a listákból választasz.

Ha később módosítanád a fiókot, válaszd a kártyáján az Edit gombot. Ha egy titkos mezőt üresen hagysz, a mentett érték megmarad. A hitelesítő adatok vagy a címek módosítása után az állapot a következő tesztig Not checked lesz.

Magware

• API URL: a Magware API címe, ahogyan a raktárad megadta, például https://wms.example.com/api/. Nyilvános címnek kell lennie, felhasználónév, lekérdezési rész és # utáni rész nélkül. A http:// is működik, ha a Magware-szervered mást nem kínál, de lehetőleg https:// címet használj.
• Owner code: az ügyfélkódod a Magware-ben.
• API key: az ehhez az ügyfélkódhoz tartozó kulcs.

A Test beolvassa a készletlistát, és semmit sem módosít a Magware-ben. Ha a cím nem a Magware API-hoz hasonlóan válaszol, a teszt ezt jelzi. A Magware-helyszínekhez nem kell szolgáltatói beállításokat megadni.

A Magware minden szállítmányfrissítést csak egyszer ad vissza. A hub ezt az adatfolyamot csak aktív nyomkövetésnél olvassa; Shadow módban nem kérdezi le.

Mintsoft

• API key: az ügyfélfiókod Mintsoft API-kulcsa.

A Test listázza azokat a raktárakat és futárszolgáltatásokat, amelyekhez a kulcs hozzáfér, a Details pedig az azonosítóikkal együtt megjeleníti őket. A helyszín hozzáadásakor add meg a Mintsoft warehouse ID, a Courier service ID és a Prime courier service ID értékét; ez utóbbi az Amazon Prime-rendelésekre vonatkozik.

Logisoft (Asendia)

• Customer reference: az ügyfélszámod a Logisoftnál.
• API token: a Logisoft API-tokened.
• Advanced settings (opcionális): Core service WSDL URL (alapérték: https://soap.myasendia.it/LogisticService.svc?wsdl), Logistics service WSDL URL (alapérték: https://soap.myasendia.it/Service.svc?wsdl) és Timeout (seconds) (alapérték: 120). Csak akkor módosítsd őket, ha a Logisoft más szolgáltatáscímeket adott meg, vagy hosszabb időkorlátot kér. A WSDL-címek csak https:// kezdetűek lehetnek, az időkorlát pedig 10 és 300 másodperc között lehet.

Számlák feltöltéséhez töltsd ki az SFTP drop (optional) részt is: SFTP host (csak a hostnév, sftp:// nélkül), SFTP port (alapértelmezés szerint 22), SFTP username és SFTP private key (a teljes kulcs a BEGIN és END sorokkal együtt, OpenSSH, PEM vagy PuTTY formátumban). Az SFTP-tárhelyhez vagy a hostot, a felhasználónevet és a privát kulcsot is meg kell adni, vagy egyiket sem.

A Test ellenőrzi a tokent, listázza az üzleteidet, és kapcsolódik a logisztikai szolgáltatáshoz. SFTP-tárhely esetén be is jelentkezik, és ellenőrzi a számlamappát. Az első sikeres tesztnél a hub rögzíti az SFTP-szerver kulcsát. A kártyán ezután az SFTP host key pinned felirat látható, és a hub csak az ezzel a kulccsal rendelkező szerverrel kommunikál. Ha módosítod a hostot, a következő sikeres teszt az új szerver kulcsát rögzíti. Ha egy későbbi teszt ugyanahhoz a hosthoz eltérő kulcsot jelez, egyeztesd az Asendiával, hogy a változás várható volt-e, majd fordulj az ügyfélszolgálathoz.

A helyszín hozzáadásakor a Carrier code alapértéke ASENDIA_IT, a Store code alapértéke pedig CUSTOM.

Az állapotok jelentése

Állapot	Jelentés	Teendő
Working	A legutóbbi teszt vagy szolgáltatói kérés sikeres volt.	Nincs teendő.
Check failed	A legutóbbi teszt vagy kérés sikertelen volt. A kártya megjeleníti a szolgáltató üzenetét.	Hárítsd el a hiba okát, például egy cím-, hálózati vagy beállítási problémát, majd válaszd a Test gombot.
Reconnect needed	A szolgáltató elutasította a hitelesítő adatokat vagy az engedélyezést.	Válaszd az Edit gombot, és add meg az új hitelesítő adatokat, vagy JTL-fióknál használd a Reconnect gombot, majd válaszd a Test gombot.
Not checked	A fiók új, vagy módosultak a hitelesítő adatai vagy a címei.	Válaszd a Test gombot.

A kártya azt is mutatja, mikor ellenőrizték utoljára a fiókot. Az állapot akkor változik, amikor a Test gombot választod, vagy amikor a hub a fiókkal dolgozik. Az állapot a fiókra vonatkozik, nem az egyes szállítmányokra: ezeket a Fulfillment → Operations oldalon ellenőrizheted.

Raktári munkafolyamatok engedélyezése

A Fulfillment → Setup oldalon adjon hozzá egy forrásfiókot és egy helyszínt, amely annak raktárát összeköti a szolgáltatóval. Az ütemezések és a kézi feladatok a Sync lapon találhatók. A rendelési szabályokat és a fiók automatizálási módját az Automations oldalon kezelheti.

Ellenőrizze a döntéseket Shadow módban, majd kapcsolja a szükséges folyamatokat Active módba. Az Active módba vagy abból történő váltáshoz megerősítés kell, a módosítás naplóba kerül. Az eredményeket az Operations, a készleteltéréseket és a termékmegfeleltetéseket az Inventory oldalon találja. Szüneteltetéshez válassza az Off vagy Shadow módot, és ellenőrizze a már futó munkát az Operations oldalon.

Több helyszín módosításához jelölje ki a sorokat, válasszon munkafolyamatot és módot, majd kattintson a Review changes gombra. Az eredmény jelzi a sikertelen módosításokat. Minden forrásfióknak saját szabályai, mentett vázlatai és aktiválási előzményei vannak.