JTL Cloud setup

JTL is an ERP system designed for small and medium-sized businesses, especially those operating online stores. It integrates with multiple sales channels, manages inventory, orders, shipping, and offers financial reporting and customizability. You can connect your JTL Wawi using the JTL Cloud for a seamless integration.

🚨 important: Before you start create your JTL Cloud account, make sure you have registered for the Returnless App Closed Beta pilot via https://kundencenter.jtl-software.de/pilot

Step 1: creating your JTL ID & Organization

The JTL ID is a new, independent login for all JTL Cloud services (JTL Hub, Partner Portal, and Cloud Apps).

🚨 Important: Your JTL ID is NOT the same as your JTL Customer Center (Contract) credentials. Even if you already have a customer account, you must create a new JTL ID.

Create your JTL ID

  1. Visit the Portal: Go to hub.jtl-cloud.com.
  2. Register: Click "Register Now" at the bottom of the page.
  3. Account Details: Enter your Name, Email Address, and a secure Password.
  4. Verification: Check your email for a confirmation code.
    • Enter the code on the registration page to verify your identity.
  5. Security Note: JTL ID supports high-security standards, including Multi-Factor Authentication (MFA) and Passkeys.

Set up your Organization

An "Organization" in the JTL Cloud acts as the umbrella for your company and employees.

  1. Initial Login: Log in to the Hub using your newly created JTL ID.
  2. Create Organization: Follow the prompts to name and create your organization.
  3. Ownership: As the Organization Owner, you have the authority to invite employees later so they can access the JTL Hub under your company profile.

To sync your existing contracts and licenses with your new Cloud ID, you must link them.

  1. Navigate: In the Organization Setup area, click "Link JTL Customer Account."
  2. Authenticate: You will be redirected to the JTL Customer Center. Log in here with your existing contract/customer credentials.
  3. Permissions: * Review the requested permissions.
    • Click "Grant Permission" to authorize the link.
  4. Redirect: You will be automatically redirected back to the JTL Hub once the link is confirmed.

✅ Success: You now have a verified JTL ID linked to your company’s contract account. You are now ready to perform the Wawi 2.0 Cloud Connection.

Step 2: JTL Administrator & Cloud setup wizard

This guide covers the technical configuration of the JTL Cloud Hub, including profile selection and the installation of necessary Windows Services.

Accessing the JTL Administrator

Since the Administrator tool is often tucked away in the installation folder, follow these steps to create easy access:

  1. Locate Source: Right-click your JTL Wawi desktop shortcut and select Open file location.
  2. Filter Files: In the folder that opens, sort or filter the list by "Application" type.
  3. Create Shortcut: Find "JTL-Administrator.exe".
    • Right-click and drag it onto your desktop.
    • Select Create shortcuts here.
  4. Launch: Open the new JTL Administrator shortcut.

Running the Setup Assistant

Once the Administrator is open, you will use the Setup Wizard to link your local database to the JTL Hub.

  1. Initialize: Click on the JTL Cloud Setup Assistant within the main interface and click Next to begin.
  2. Profile Selection: Choose the specific Wawi profile you wish to connect to the JTL Hub and click Next to continue (Note: You also have the option here to configure a brand new profile or client if required).
  3. Client Selection: Select the correct Client (Mandant) from your account that needs the Hub connection and click Next to continue.
  4. Cloud Authentication: Enter your JTL Cloud/Hub credentials (the same ones used to sign into the JTL Hub portal). Once the login is successful, the assistant will automatically move to the next stage.

Services & Finalization

This section ensures the connection runs as a background process on your server/PC.

  1. Select Windows Services: You will be prompted to choose which services to install and Click Next to continue.(Recommendation: Leave all suggested services enabled by default to ensure full functionality)
  2. Review Summary: Verify the Profile, Client, Connected Cloud, and the list of Windows Services to be installed.
  3. Finish: Click Finish to apply the settings.
  4. Start API: Click Start Wawi API to push the connection live.

✅ Success: The setup process is now complete, and your JTL services are running.

Step 3: connecting JTL Wawi to JTL Cloud

This guide outlines the end-to-end process of connecting your JTL Wawi environment to the JTL Cloud and configuring the API for app integration.

Enable Cloud Connection (pre-requisites)

Before starting the connection, ensure the feature is active in your version of JTL Wawi.

  1. Check Visibility: Open JTL Wawi and check if the JTL Cloud Connection option is selectable.
  2. Activate Beta Features: If the option is grayed out:
    • Navigate to: Help   > JTL Customer Account  > Beta Features.
    • Activate the JTL Cloud Connection function.
  3. Legacy Versions (< 1.11): If you are running a version older than 1.11, you must manually activate the function using the specific activation code provided by JTL.

Establishing the Initial Connection

🚨 You must have a JTL ID and complete the registration process on the JTL Cloud website before proceeding!

  1. Initiate Link: Select the JTL Cloud Connection option in Wawi.
  2. Confirmation: Click OK on the prompt to start the process.
  3. Authentication: Click Login and enter your JTL ID credentials.
  4. Verify Status: Once the status displays as "Connected," you may close the application window.

Configuring the JTL Wawi API & Admin shortcut

To allow cloud access to interact with your local data, the API must be configured via the Administrator interface.

  1. Locate Installation Files: Right-click your JTL Wawi shortcut and select "Open file location" to find your local installation folder.
  2. Create Admin Shortcut: * Find the file named JTL-Administrator.exe.
    • Right-click and drag it to your desktop to create a Shortcut.
  3. Configure Instance:
    • Open the new JTL Administrator shortcut.
    • Choose an Instance Name.
    • Select the Profile relevant to your company connection.
  4. Security & Cloud Activation:
    • Generate a New Official Certificate.
    • Ensure Cloud Connection is selected/checked.
    • Click Save.

Final verification & App activation

  1. Launch Services: Ensure both the Console and the JTL Administrative Interface are actively running in the background.
  2. Sync Check: Return to JTL Wawi, navigate to the Admin section, and open JTL Cloud Connection.
  3. Verify Gateway: Log in with your JTL ID again if prompted.
    • Check the Gateway Status to ensure the connection to JTL Wawi is established.
  4. Add Applications:
    • Navigate to the App Section.
    • Select the desired application (e.g., Returnless).
    • If you have an Activation Code for a specific app, enter it here to finalize the integration.

🚨Legacy versions: If you are using a version older than 1.11, you must manually enable the feature using the specific activation code provided by your Account Manager from Returnless.

✅ Success: Your JTL Wawi is now fully synced with the JTL Cloud.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us