Povežite JTL s hubom

Opomba: vmesnik aplikacije je trenutno na voljo v angleščini, nemščini in italijanščini. Vodnik zato navaja angleška imena gumbov in menijev v krepkem tisku.

Povezava z JTL Fulfillment Network (JTL FFN) omogoča, da hub Balta Labs preda pošiljke vašemu izvajalcu izpolnitve (fulfiller) v omrežju JTL ter nazaj prebere podatke o sledenju, izdelkih in zalogah. Povezava računa ne pošlje ničesar. Pošiljanje se začne šele, ko v Fulfillment → Setup dodate lokacijo in njene poteke dela preklopite v način Active.

Pred začetkom

• Ustvarite aplikacijo JTL in pripravite njen client ID in client secret. Glejte Ustvarite aplikacijo JTL.
• Uporabite račun JTL z vlogo Merchant, ki se je vsaj enkrat prijavil v portal FFN.
• Povežite weclapp. Iz njega prihajajo naročila in pošiljke. Glejte Povežite weclapp.
• V delovnem prostoru potrebujete dovoljenje Connections, za nastavitev pa še dovoljenje Fulfillment.

Pooblastite račun

1. Odprite Settings → Connections, izberite Add account in nato JTL FFN. Izberete lahko tudi Add provider pod Fulfillment & notifications.
2. V pogovornem oknu Connect JTL Fulfillment Network v razdelku Before you continue preverite, ali je povratni URL enak tistemu, ki je shranjen v vaši aplikaciji JTL.
3. Pod Environment izberite Production za produkcijski račun ali Sandbox za testni sistem JTL.
4. Vnesite Client ID in Client secret svoje aplikacije JTL.
5. Po želji vnesite Connection name. Če ga ne vnesete, hub uporabi ime računa JTL.
6. Izberite Continue to JTL.
7. Pri JTL se prijavite z računom trgovca, ki ga želite povezati.
8. Preglejte zahtevani dostop in ga dovolite.
9. JTL vas vrne v Balta Labs, ki potrdi rezultat.

Postopek dokončajte brez daljšega premora. Vsak poskus velja 10 minut in samo v brskalniku, v katerem se je začel. Če poteče, začnite znova pri 1. koraku.

Izberite pravi račun JTL

Balta Labs poveže račun, s katerim se prijavite pri JTL. To ni nujno račun, ki je lastnik aplikacije. Če ste v brskalniku že prijavljeni pri JTL, lahko JTL znova uporabi to sejo. Če to ni želeni račun trgovca, se najprej odjavite pri JTL in začnite znova.

Balta Labs hrani po eno povezavo za vsak račun JTL in okolje. Če pooblastite račun, ki je že povezan, se posodobi njegova povezava, dvojnik pa ne nastane. Za povezavo drugega računa trgovca znova izberite Add account.

Zaslon ob uspešni povezavi

Ko Balta Labs račun shrani in preveri, prikaže JTL connected successfully! s podatki Account, Connection in Environment. Preverite, ali je to račun, ki ste ga želeli povezati.

Nato vas odštevanje po petih sekundah preusmeri v nastavitev izpolnitve naročil. Izberite Continue now, če želite nadaljevati takoj, ali Stay here, če želite odštevanje ustaviti. Po ponovni povezavi zaslon prikaže JTL reconnected successfully! in vas namesto tega vrne k povezavi.

Če pooblastitev ni bila dokončana, zaslon prikaže naslov, na primer Permissions are missing, ter razdelka What happened in What to do. Izberite Try again, da začnete znova, ali Read the troubleshooting guide, da odprete ustrezni razdelek vodnika Odpravite napake pri povezavi JTL.

Preverite povezavo

V Settings → Connections je račun prikazan pod Fulfillment & notifications. Njegova kartica prikazuje stanje in čas zadnjega preverjanja:

• Not checked: od dodajanja ali spremembe računa se ni izvedel še noben preizkus.
• Working: zadnji preizkus ali zadnja zahteva do JTL je uspela.
• Check failed: zadnji preizkus ali zadnja zahteva ni uspela. Kartica prikazuje sporočilo JTL. Pooblastitev se ohrani; odpravite vzrok in znova izvedite preizkus.
• Reconnect needed: JTL pooblastitve ne sprejema več. Račun znova povežite, kot je opisano spodaj.

Izberite Test, da račun preverite takoj. Preizkus podatke iz JTL samo bere. Izberite Details, da vidite Account, What the hub can do in v razdelku Reference lists seznama Warehouses in Shipping methods: pri vsakem vnosu njegov ID, v stolpcu Fulfiller pa izvajalca, ki mu pripada. Pogovorno okno lokacije ponuja enake možnosti. Edit prikaže račun JTL, njegovo okolje, client ID aplikacije in čas pooblastitve. Tam lahko povezavo tudi preimenujete.

Kartica vas tudi opomni, da se račun ne uporablja za pošiljke, dokler ne vklopite lokacije, in ponuja povezavo Open fulfillment setup.

Nastavite lokacijo

Lokacija je skladišče weclapp, ki ga upravlja račun izvajalca izpolnitve naročil. Dodajte jo za vsako skladišče, za katero skrbi JTL:

1. Odprite Fulfillment → Setup. Če stran prikaže Start with weclapp, izberite svojo povezavo pod weclapp connection in nato Save and continue.
2. Pod Locations izberite Add location.
3. Vnesite Name.
4. Pod weclapp warehouse izberite skladišče, katerega pošiljke obravnava JTL, ali vnesite njegov ID.
5. Pod Provider account izberite račun JTL. Pogovorno okno nato naloži možnosti tega računa.
6. Pod Warehouse at JTL izberite skladišče. S tem se izpolnita Fulfiller ID in Fulfiller warehouse ID; obe vrednosti lahko še vedno urejate. Če pogovorno okno prikaže The account’s choices could not be loaded. Enter the IDs instead., oba ID-ja vnesite sami ali na kartici računa izberite Test, da ugotovite vzrok.
7. Pod Shipping methods za vsakega prevoznika iz weclappa izberite Add carrier in med predlogi izberite njegov FFN shipping method ID. Predlogi vsebujejo le načine pošiljanja tega izvajalca in pod ID-jem prikazujejo ime načina pošiljanja. Pošiljka, katere prevoznik nima dodeljenega načina pošiljanja, gre v JTL s standardno vrsto pošiljanja, hub pa zabeleži opozorilo.
8. Izberite Save location.
9. Če se še nič ne sinhronizira, pod Sync izberite Start syncing.

Vsak potek dela nove lokacije se začne v načinu Off. Lokacija JTL ima te poteke dela:

• Dispatch: preda sproščene pošiljke v JTL.
• Tracking: zapiše številke za sledenje nazaj v weclapp.
• Catalog: pošlje artikle, slike in odobritve izdelkov v JTL.
• Stock check: primerja zalogo v weclappu z zalogo v JTL.
• Inbound: pri JTL najavi prihajajoče dobave.

Vsak potek dela je v enem od treh načinov:

• Off: nič se ne zgodi.
• Shadow: hub odloči in zabeleži, kaj bi naredil. V JTL ali weclapp ne zapiše ničesar in ne pošlje obvestil.
• Active: hub delo opravi.

Postopke nastavite v Fulfillment → Setup. Odločitve preverite v Shadow in nato omogočite Active. Prehod v Active ali iz njega zahteva potrditev. Glejte Povezovanje ponudnikov.

Znova povežite račun

Račun znova povežite, ko kartica prikazuje Reconnect needed ali ko ste pri JTL zamenjali client secret aplikacije.

1. Odprite Settings → Connections in poiščite račun pod Fulfillment & notifications.
2. Na njegovi kartici izberite Reconnect.
3. Polji Client ID in Client secret pustite prazni, da ohranite shranjene poverilnice aplikacije, ali vnesite novi vrednosti.
4. Izberite Reconnect with JTL.
5. Prijavite se z istim računom JTL kot prej in dovolite dostop.
6. Na zaslonu JTL reconnected successfully! preverite račun. Nato na kartici izberite Test.

Ponovna povezava ostane v okolju računa. Če se prijavite z drugim računom JTL, hub prikaže A different account was used in povezave ne spremeni. Če želite povezati drug račun, ga dodajte kot novo povezavo.

Kako dostop ostane veljaven

Žetoni za dostop JTL veljajo približno 30 minut. Hub jih samodejno obnavlja, vsaka obnovitev pa zamenja žeton za osvežitev. Ničesar vam ni treba storiti. Če JTL obnovitev zavrne, na primer ker je bil dostop preklican, kartica prikaže Reconnect needed in hub z računom ne more delati, dokler ga znova ne povežete. Nato v Fulfillment → Operations poiščite elemente, ki medtem niso uspeli.