Pripojte JTL k hubu

Poznámka: rozhranie aplikácie je zatiaľ dostupné v angličtine, nemčine a taliančine. V návode preto uvádzame anglické názvy ovládacích prvkov tučným písmom.

Pripojenie JTL Fulfillment Network (JTL FFN) umožňuje hubu, teda Balta Labs, odovzdávať zásielky vášmu fulfillerovi v JTL a spätne načítavať údaje o sledovaní zásielok, produktoch a zásobách. Samotné pripojenie účtu nič neodošle. Zásielky sa začnú odosielať až vtedy, keď v Fulfillment → Setup pridáte lokalitu a prepnete jej pracovné postupy na Active.

Skôr než začnete

• Vytvorte aplikáciu JTL a pripravte si jej client ID a client secret. Pozrite si návod Vytvorte aplikáciu JTL.
• Použite účet JTL s rolou Merchant, ktorý sa už raz prihlásil do portálu FFN.
• Pripojte weclapp. Objednávky a zásielky pochádzajú z neho. Pozrite si návod Pripojte weclapp.
• V pracovnom priestore potrebujete oprávnenie Connections a na nastavenie plnenia oprávnenie Fulfillment.

Autorizujte účet

1. Otvorte Settings → Connections, vyberte Add account a zvoľte JTL FFN. Môžete tiež vybrať Add provider v časti Fulfillment & notifications.
2. V dialógu Connect JTL Fulfillment Network v časti Before you continue skontrolujte, či sa callback URL zhoduje s adresou uloženou vo vašej aplikácii JTL.
3. V časti Environment zvoľte Production pre produkčný účet alebo Sandbox pre testovací systém JTL.
4. Zadajte Client ID a Client secret svojej aplikácie JTL.
5. Voliteľne zadajte Connection name. Bez neho hub použije názov účtu JTL.
6. Vyberte Continue to JTL.
7. V JTL sa prihláste účtom obchodníka, ktorý chcete pripojiť.
8. Skontrolujte požadovaný prístup a povoľte ho.
9. JTL vás vráti do Balta Labs, kde sa výsledok potvrdí.

Postup dokončite bez dlhšej prestávky. Každý pokus platí 10 minút a iba v prehliadači, v ktorom sa začal. Ak vyprší, začnite znova od kroku 1.

Vyberte správny účet JTL

Balta Labs pripojí účet, ktorým sa prihlásite v JTL. Nemusí to byť účet, ktorému patrí aplikácia. Ak je váš prehliadač v JTL už prihlásený, JTL môže túto reláciu použiť znova. Ak nejde o účet obchodníka, ktorý chcete pripojiť, najprv sa v JTL odhláste a začnite znova.

Balta Labs vedie pre každý účet JTL a prostredie jedno pripojenie. Autorizácia už pripojeného účtu aktualizuje jeho pripojenie a nepridá duplicitné. Ak chcete pripojiť ďalší účet obchodníka, znova vyberte Add account.

Obrazovka úspešného pripojenia

Keď Balta Labs účet uloží a overí, zobrazí JTL connected successfully! s údajmi Account, Connection a Environment. Skontrolujte, či ide o účet, ktorý ste chceli pripojiť.

Odpočítavanie vás potom po piatich sekundách presunie do nastavenia plnenia. Ak chcete pokračovať hneď, vyberte Continue now; ak chcete odpočítavanie zastaviť, vyberte Stay here. Po opätovnom pripojení obrazovka zobrazí JTL reconnected successfully! a namiesto toho vás vráti k pripojeniu.

Ak sa autorizácia nedokončila, obrazovka zobrazí nadpis, napríklad Permissions are missing, a pod ním časti What happened a What to do. Vyberte Try again, ak chcete začať znova, alebo Read the troubleshooting guide, ak chcete otvoriť príslušnú časť návodu Vyriešte chyby pripojenia JTL.

Skontrolujte pripojenie

V Settings → Connections sa účet zobrazí v časti Fulfillment & notifications. Jeho karta ukazuje stav a čas poslednej kontroly:

• Not checked: od pridania alebo zmeny účtu neprebehol žiadny test.
• Working: posledný test alebo požiadavka na JTL prebehli úspešne.
• Check failed: posledný test alebo požiadavka zlyhali. Karta zobrazuje hlásenie z JTL. Autorizácia zostáva zachovaná; odstráňte príčinu a test zopakujte.
• Reconnect needed: JTL už autorizáciu neprijíma. Účet znova pripojte podľa postupu nižšie.

Ak chcete účet skontrolovať hneď, vyberte Test. Test z JTL údaje iba načítava. Cez Details zobrazíte časti Account, What the hub can do a Reference lists so zoznamami Warehouses a Shipping methods: pri každej položke jej ID a v stĺpci Fulfiller fulfillera, ku ktorému patrí. Dialóg lokality ponúka tie isté možnosti. Edit zobrazí účet JTL, jeho prostredie, client ID aplikácie a čas autorizácie. Tam môžete pripojenie aj premenovať.

Karta vás tiež upozorňuje, že účet sa nepoužíva na zásielky, kým nie je zapnutá niektorá lokalita, a ponúka odkaz Open fulfillment setup.

Nastavte lokalitu

Lokalita je sklad vo weclappe, ktorý prevádzkuje účet poskytovateľa plnenia. Pridajte ju pre každý sklad, ktorý obsluhuje JTL:

1. Otvorte Fulfillment → Setup. Ak stránka zobrazuje Start with weclapp, v poli weclapp connection vyberte svoje pripojenie a zvoľte Save and continue.
2. V časti Locations vyberte Add location.
3. Do poľa Name zadajte názov.
4. V poli weclapp warehouse vyberte sklad, ktorého zásielky spracúva JTL, alebo zadajte jeho ID.
5. V poli Provider account zvoľte účet JTL. Dialóg potom načíta možnosti tohto účtu.
6. V poli Warehouse at JTL vyberte sklad. Tým sa vyplnia polia Fulfiller ID a Fulfiller warehouse ID; obe zostanú upraviteľné. Ak dialóg zobrazí správu The account’s choices could not be loaded. Enter the IDs instead., zadajte obe ID sami alebo na karte účtu vyberte Test a zistite príčinu.
7. V časti Shipping methods vyberte pre každého dopravcu z weclappu Add carrier a z návrhov zvoľte jeho FFN shipping method ID. Návrhy obsahujú iba spôsoby dopravy daného fulfillera a pod ID zobrazujú názov spôsobu dopravy. Zásielka, ktorej dopravca nemá priradenie, sa odošle do JTL so štandardným typom dopravy a hub zaznamená upozornenie.
8. Vyberte Save location.
9. V časti Sync vyberte Start syncing, ak synchronizácia ešte nebeží.

Všetky pracovné postupy novej lokality začínajú v režime Off. Lokalita JTL má tieto pracovné postupy:

• Dispatch: odovzdáva uvoľnené zásielky do JTL.
• Tracking: zapisuje sledovacie čísla späť do weclappu.
• Catalog: posiela do JTL produkty, obrázky a schválenia produktov.
• Stock check: porovnáva zásoby vo weclappe so zásobami v JTL.
• Inbound: ohlasuje JTL prichádzajúce dodávky.

Každý pracovný postup má jeden z troch režimov:

• Off: nič sa nedeje.
• Shadow: hub rozhodne a zaznamená, čo by urobil. Do JTL ani do weclappu nič nezapisuje a neposiela žiadne notifikácie.
• Active: hub prácu vykonáva.

Postupy nastavte v Fulfillment → Setup. Rozhodnutia overte v Shadow a potom zapnite Active. Zmena do Active alebo z Active vyžaduje potvrdenie. Pozrite Pripojenie poskytovateľov plnenia.

Znova pripojte účet

Účet znova pripojte, keď karta zobrazuje Reconnect needed, alebo keď ste v JTL vymenili client secret aplikácie.

1. Otvorte Settings → Connections a nájdite účet v časti Fulfillment & notifications.
2. Na jeho karte vyberte Reconnect.
3. Ak chcete zachovať uložené prístupové údaje aplikácie, nechajte Client ID a Client secret prázdne, alebo zadajte nové.
4. Vyberte Reconnect with JTL.
5. Prihláste sa tým istým účtom JTL ako predtým a povoľte prístup.
6. Na obrazovke JTL reconnected successfully! skontrolujte účet. Potom na karte vyberte Test.

Opätovné pripojenie zostáva v prostredí účtu. Ak sa prihlásite iným účtom JTL, hub zobrazí A different account was used a pripojenie nezmení. Iný účet pridajte ako nové pripojenie.

Ako sa udržiava platnosť prístupu

Prístupové tokeny JTL platia približne 30 minút. Hub ich obnovuje automaticky a každé obnovenie nahradí obnovovací token. Nemusíte nič robiť. Ak JTL obnovenie odmietne, napríklad preto, že bol prístup odvolaný, karta zobrazí Reconnect needed a hub nemôže s účtom pracovať, kým ho znova nepripojíte. Potom v Fulfillment → Operations skontrolujte položky, ktoré medzitým zlyhali.