Skip to main content
The JTL Wawi (API) integration connects your JTL-Wawi REST API to Chatarmin CX for order lookup, tracking, and approved order changes.
This guide is for JTL-Wawi ERP. It is not FFN Connect / Fly, which connects Shopify to a fulfillment warehouse.

​
Prerequisites

Before setup, confirm that:
  • the JTL-Wawi REST API and app-registration service are running
  • you know the database name used after /api/ in the URL, often eazybusiness
  • a JTL-Wawi API user is available for cx
  • the API has a public hostname and reachable port
  • a valid TLS certificate covers that hostname and is trusted by standard clients
New connections require verified HTTPS. Private addresses and HTTP endpoints cannot be used.

​
Server URL

Use the full HTTPS base URL:
For example: https://wawi.example.com:5883/api/eazybusiness. The port is set in JTL-Wawi. 5883 is common, but use the value from your administrator. The final path segment is the JTL database name, not the shop or Windows service name.

​
Network and certificate

Chatarmin CX must reach the API port from the public internet. Allow inbound TCP on that port through the Windows, hypervisor, datacenter, and hosting-provider firewalls that apply. For the current Chatarmin outbound IP allowlist, contact Chatarmin support. Test from outside your office network without disabling certificate checks:
A JSON response or HTTP 401/403 confirms that the host and port are reachable. A timeout usually means the host, port, service, or firewall is wrong. A certificate error means the HTTPS setup must be corrected before connecting cx.
Do not switch to HTTP or bypass certificate validation. Install or renew the certificate, include the full certificate chain, and make sure its hostname matches the public hostname in the server URL. Ask the server or hosting administrator to correct it if needed.

​
Set it up

1

Start the JTL-Wawi REST API

Start the REST API and expose it through verified HTTPS. See JTL’s guide to start the REST server.
2

Open app registration in JTL-Wawi

On the Wawi server, open Admin → JTL-Wawi API → App Registration, click Add, and continue until JTL-Wawi is waiting for a registration request. Leave that screen open.
3

Enter the connection in cx

Open JTL Wawi integrations, click Add account, and enter the integration name and verified HTTPS server URL. Click Connect only while JTL-Wawi is waiting.
4

Approve and finish

Approve chatarmin/v1 / chatarmin.com GmbH in JTL-Wawi. Set the API username, return to cx, enter the same username, and click Finish Setup.

​
Verify the connection

Confirm that the account appears as connected. Then open a ticket for a known JTL customer and verify that order data and tracking can be read before enabling write actions.

​
AI Agent actions

JTL actions can retrieve orders and tracking, update shipping addresses or delivery data, and cancel orders. Keep every write action on Ask every time until you have verified the exact JTL and warehouse behavior with representative orders.

​
Troubleshooting

See the JTL Wawi API documentation for the vendor’s REST reference.