Skip to main content
To build on the JTL platform, you’ll work across four connected environments. Each one plays a different role in your development workflow. Three of them are needed to start building, and the fourth comes in when you’re ready to test your app. This guide walks you through setting them up in one go. It takes about 10 minutes.

​
Your Development Environment

Here’s what each environment does and why you need it:
EnvironmentWhat you’ll use it for
JTL-WawiThe ERP system where merchant data lives: products, orders, customers, inventory. Your app reads and writes this data through APIs or GraphQL.
Partner PortalWhere you create and manage your apps.
JTL HubA dedicated environment where you can install and test your apps, verify the connection to JTL-Wawi, and manage the app lifecycle before going live.
ERP CloudThe web-based interface where your installed app actually runs. Currently in development, with MVP release coming soon. You can already use it to test your app and validate how it integrates. See Test your App.
JTL-Wawi is the ERP itself (the data), Partner Portal is where you create and manage your apps, JTL Hub is where you install, and ERP Cloud is where your app runs for the merchant.
Here’s how they connect: The overall flow is: you create your app in the Partner Portal, install it in JTL Hub, run it in the ERP Cloud against live data from JTL-Wawi, and when everything looks good, submit it to the App Store. Now let’s get everything set up.

​
Step 1: Set up your Partner Portal

This is your app management hub where you create apps and get your client credentials.
1

Go to the Partner Portal

Open Partner Portal in your browser.
2

Create your JTL ID

SSO is currently not supported with your JTL ID. You’ll need to register separately with your email.
Once you navigate to the URL, you’ll be prompted to log in with your JTL ID. Click on the Register now button to create a new JTL ID.JTL ID provides a single access point to all JTL cloud-related services (JTL Hub, Partner Portal, ERP Cloud, etc.)Partner Portal registration screenshotOn registering, you’ll be asked to fill in the confirmation code sent to your email address. Once you fill in the code, you’ll be redirected to the log in page.
3

Log in and Create a Customer Center Account

Once you log in with your credentials, choose one of the following:Create or link customer account
  • New to JTL: Click Create organization and fill in the required details if you don’t have an existing Customer Center Account.
  • Existing JTL customer: Click Link your JTL customer account and log in to your Customer Center Account. Then Authorize JTL Cloud when prompted.
Customer Center Account is your central hub for managing licenses, JTL services, billing, and support.
After completing either option above, continue with the steps below:
  1. Once your organization is created, you’ll see your organization name and custom URL path. Organization created
  2. Click Continue to JTL Hub and you’ll be redirected to JTL Hub dashboard. Continue to JTL Hub
    It’s recommended to set up 2FA before proceeding.
  3. On your JTL Hub dashboard, click the Partner Portal link. Partner Portal link You’ll be redirected to the Partner Portal domain. Click Create an account. Next, select how you want to use the Partner Portal and then Continue. How to use Partner Portal
  4. Enter your business contact details and Create account. Business contact details Once your account is created, you’ll be redirected to the Partner Portal dashboard. This is where you’ll create and manage your apps. Partner Portal dashboard

​
Step 2: Connect to JTL-Wawi

The final step is to connect your JTL Hub environment to Wawi. This is what your app will use to read and write merchant data. To connect your JTL Hub environment to JTL-Wawi:
  • Log into your OnPremise or Cloud-ERP instance.
  • In the Admin menu, click the JTL Cloud button and select Connect. This will open a new tab with the JTL Cloud login page. Connect to JTL Cloud
  • Log in with your JTL ID you created in step 1.
  • Once logged in and the pairing is successful, close the browser tab and go back to your instance. You should see statuses indicating the connection was established. Connected Wawi instance
Finally, navigate to the Connection (JTL-Wawi) menu on JTL Hub to see your connected Wawi instance. Connected Wawi instance You now have everything you need to start building your first app.

​
What’s Next?

Quickstart: From Template

Start from a template and get a Cloud App running in minutes. Recommended for most developers.

Quickstart: From Scratch

Build a Cloud App step by step to understand how everything fits together.
Need help? If you run into issues during account setup, reach out via the support channel.