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.Documentation Index
Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
Use this file to discover all available pages before exploring further.
Your Development Environment
Here’s what each environment does and why you need it:| Environment | What you’ll use it for |
|---|---|
| JTL-Wawi | The ERP system where merchant data lives: products, orders, customers, inventory. Your app reads and writes this data through APIs or GraphQL. |
| Partner Portal | Where you create and manage your apps. |
| JTL Hub | A 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 Cloud | The 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.
Step 1: Set up your Partner Portal
This is your app management hub where you create apps and get your client credentials.Go to the Partner Portal
Open Partner Portal in your browser.
Create your JTL ID
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.)
On 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.

Log in and Create a Customer Center Account
Once you log in with your credentials, choose one of the following:

- 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.
-
Once your organization is created, you’ll see your organization name and custom URL path.

-
Click Continue to JTL Hub and you’ll be redirected to JTL Hub dashboard.

-
On your JTL Hub dashboard, click the 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.

-
Enter your business contact details and Create account.
Once your account is created, you’ll be redirected to the Partner Portal dashboard. This is where you’ll create and manage your apps.

Step 2: Connect to JTL-Wawi
The final step is to connect your JTL Cloud environment to JTL-Wawi. Your app uses this connection to read and write merchant data.Initiate connection from JTL-Wawi
Log in to your JTL-Wawi instance.In the Admin menu, click JTL Cloud, then click Connect.
Read the message in the dialog carefully and click OK. This opens a new tab with the JTL Cloud login page.

Log in to JTL Cloud
Log in using the JTL ID you created in Step 1.Once authentication is successful, close the browser tab and return to your JTL-Wawi instance.
Confirm connection status
Back in JTL-Wawi, you’ll see a Connected status, indicating the pairing was successful.

Start the Wawi API
Pairing JTL-Wawi with JTL Cloud is not sufficient on its own. You must also configure and start the Wawi API so your app can access and sync data.Open the JTL Administrator to start the Wawi API.Create a new entry by selecting Wawi-API.
Select the desired profile and certificate, then enable the Cloud Connection checkbox.Click Save.
Once the connection is established, you will see an is running status. This may take a few seconds.
You can start or stop the API service from the JTL Administrator.
JTL creates a desktop shortcut for the JTL Administrator after installation.
For older versions of JTL-Wawi, you can find it in the installation folder.
For older versions of JTL-Wawi, you can find it in the installation folder.



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.
