Ustvarite aplikacijo JTL

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.

Balta Labs se z JTL Fulfillment Network (JTL FFN) poveže prek aplikacije, ki jo pri JTL registrirate sami. JTL jo imenuje odjemalec OAuth. Aplikacija vam dodeli client ID in client secret. Obe vrednosti vnesete v Balta Labs in nato pri JTL dovolite dostop, kot je opisano v vodniku Povežite JTL s hubom.

JTL te korake opisuje v razdelku Getting started svoje dokumentacije za Merchant API. Zasloni JTL se lahko spremenijo. Če se oznaka razlikuje od tega vodnika, upoštevajte trenutno poimenovanje pri JTL.

Pred začetkom

• Račun v centru za stranke JTL (JTL Customer Center). V njem ustvarite aplikacijo.
• Račun JTL z vlogo Merchant v JTL FFN. S tem računom se prijavite ob povezovanju. JTL dovoli uporabo API-ja, ki ga potrebuje Balta Labs, samo uporabnikom z vlogo Merchant.
• Enkratna prijava v portal FFN s tem računom. Za produkcijsko okolje uporabite fulfillment.jtl-software.com, za peskovnik pa fulfillment-sandbox.jtl-software.com. JTL ustvari uporabnika API ob prvi prijavi. Do takrat JTL odgovarja z not found, Balta Labs pa prikaže sporočilo The JTL account is not ready yet.
• Dovoljenje Connections v delovnem prostoru Balta Labs. Potrebujete ga, da odprete pogovorno okno za povezavo in kopirate povratni URL.

Kopirajte povratni URL iz Balta Labs

Ko dovolite dostop, vas JTL prek povratnega URL-ja aplikacije vrne v Balta Labs. Ta URL se mora natanko ujemati z naslovom, ki ga prikazuje Balta Labs.

1. V Balta Labs odprite Settings → Connections, izberite Add account in nato JTL FFN. Izberete lahko tudi Add provider pod Fulfillment & notifications. Odpre se pogovorno okno Connect JTL Fulfillment Network.
2. V razdelku Before you continue poiščite povratni URL in izberite Copy. Videti je kot https://api.example.com/connections/oauth/jtl_ffn/callback. Ne uporabljajte tega primera, ampak vedno naslov iz svojega pogovornega okna.
3. Pogovorno okno pustite odprto, medtem ko ustvarjate aplikacijo. V njem so navedeni tudi obsegi dostopa, ki jih morate označiti, in povezava do tega vodnika.

Naslova ne vnašajte ročno. Drugačen znak, http namesto https, dodatna poševnica na koncu ali presledek povzroči neujemanje povratnega URL-ja. Če pogovorno okno sporoča JTL connections are not available on this server yet, Balta Labs ne more ponuditi povratnega URL-ja. Obrnite se na podporo Balta Labs.

Ustvarite aplikacijo pri JTL

1. Odprite kundencenter.jtl-software.de/oauth in se prijavite. Na isto stran vodi tudi povezava Open the JTL Customer Center v pogovornem oknu. Meni centra za stranke ne vsebuje povezave do te strani, zato naslov odprite neposredno.
2. Ustvarite novega odjemalca OAuth.
3. Če JTL zahteva ime, uporabite takšno, ki ga boste pozneje prepoznali, na primer Balta Labs.
4. Označite obsega dostopa (scopes) ffn.merchant.read in ffn.merchant.write. JTL lahko obsege ponudi v obliki predloge; izberite predlogo, ki vključuje oba. Sami obsegi za izvajalce izpolnitve (fulfiller) ne zadostujejo.
5. Povratni URL iz Balta Labs prilepite kot redirect URI aplikacije. JTL to polje morda imenuje tudi callback URI.
6. Shranite odjemalca.
7. Kopirajte client ID in client secret, ki ju JTL prikaže za odjemalca.

Obseg	Opis pri JTL	Za kaj ga uporablja Balta Labs
ffn.merchant.read	Popoln dostop za branje do Merchant API	Branje podatkov o vašem računu, skladiščih, načinih pošiljanja, izdelkih, zalogah in posodobitvah pošiljk
ffn.merchant.write	Popoln dostop za pisanje do Merchant API	Ustvarjanje pošiljk, izdelkov in dobav v skladišče, samo za poteke dela v načinu active

Produkcijsko okolje in peskovnik

JTL upravlja produkcijski sistem in ločen peskovnik za preizkušanje. Po navedbah JTL en odjemalec OAuth deluje za oba, povratni URL pa je enak. Razlikujeta se račun, s katerim se prijavite, in portal, v katerega se je ta račun moral enkrat prijaviti.

	Produkcijsko okolje	Peskovnik
Portal FFN za prvo prijavo	fulfillment.jtl-software.com	fulfillment-sandbox.jtl-software.com
Račun JTL	Vaš produkcijski račun trgovca	Račun v peskovniku
Možnost pod Environment v pogovornem oknu	Production	Sandbox
Podatki	Prave pošiljke in zaloge	Testni podatki, ločeni od produkcijskih

Vsaka možnost v pogovornem oknu prikazuje tudi naslov svojega portala. Povezava ostane v okolju, v katerem je bila ustvarjena. Za prehod iz peskovnika v produkcijsko okolje dodajte novo povezavo z izbrano možnostjo Production. Za preizkušanje lahko obdržite tudi ločeno aplikacijo JTL.

Varno vnesite client ID in client secret

• Client ID in client secret vnesite samo v polji Client ID in Client secret pogovornega okna Connect JTL Fulfillment Network. Balta Labs client secret shrani šifrirano in ga nikoli več ne prikaže.
• Vrednosti client secret nikoli ne pošiljajte po e-pošti, v klepetu ali v zahtevku za podporo in je ne lepite v skupne dokumente. Podpora potrebuje samo client ID.
• Ko račun znova povežete, lahko obe polji pustite prazni, da ohranite shranjene poverilnice aplikacije.
• Če je bil client secret morda razkrit, ga zamenjajte pri JTL. Če JTL obnovitve ne omogoča, ustvarite novo aplikacijo. Nato račun znova povežite z novimi vrednostmi.

Nato povežite JTL s hubom.