URL https://developer.jtl-software.com/
JTL-Software-GmbH partner@jtl-software.com
Welcome to the JTL-WAWI technical API documentation. This guide is here to help developers understand how our REST API works and how it can be integrated into your existing systems. We'll delve into the details of authentication and data manipulation processes, providing clear examples along the way. Whether you're a developer or an IT professional, this documentation aims to give you a practical understanding, laying the groundwork for effectively using the JTL-WAWI API to enhance your processes.
You register your application with the API by sending a POST request with the required information and corresponding keys. You can find the exact request details at https://developer.jtl-software.com/products/erp/swagger/appregistration. This information has to include the following:
This data is crucial for identifying and registering your application with the API. The API uses it to generate a temporary authentication ID that allows your application to access the necessary resources. After successful validation of this information, you will receive the API key required for future authentication and API requests.
Before you can begin the registration process, you must open JTL-Wawi (new interface) and start the registration process under 'Admin->App registration'. Only at this point are you authorised to send the first API call. This step in JTL-Wawi ensures that your application is properly registered and has permission to use the API.
The API will send you an authentication ID in the form of a token. Once you have received this token and successfully completed the registration in JTL-Wawi, you will send another request to the API by including this authentication ID in the URL path.
After successful validation of this second request by the API and confirmation of the correct information, you will be provided with the actual API key. It is important to note that this API key will not be displayed again!
This API key will be used in the future to authenticate requests to the API. It is of utmost importance that you securely store the API key upon receipt, as it cannot be retrieved from any other location in the system.
This is the name of your application, in this case "MyApp/1.0.0". It is used to identify your application.
This is where the version number of your application is entered, in this case "1.0.0".
The User-Id as int or uuid to run the Request, a JTL-Wawi user can be specified to perform an API call on their behalf (more details in the documentation, Optional). To use the Header, you must have the needed Scope 'Application.RunAs'
curl -i -X GET \
'https://developer.jtl-software.com/_mock/products/erpapi/1.0-cloud/openapi/categories?pageNumber=0&pageSize=0' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'api-version: string' \
-H 'tenant-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-appid: string' \
-H 'x-appversion: string' \
-H 'x-runas: string'Returns all categories.
Gets or sets the total number of items available in the data source.
Gets or sets the collection of items contained in the paged list.
Name of the category in the default language of JTL-Wawi.
Category description in the default language of JTL-Wawi.
ID of the parent category, if the category is a child category.
Returns the category level number within its category tree. A root category without a parent has a level 1.
The category sort number used in some sales channels for arranging the categories.
Gets the total number of pages based on the total number of items and the page size.
Gets a value indicating whether there is a previous page available in the paginated list.
Gets the number of the next page if there is one; otherwise, returns the total number of pages.
{ "TotalItems": 0, "PageNumber": 0, "PageSize": 0, "Items": [ { … } ], "TotalPages": 0, "HasPreviousPage": true, "HasNextPage": true, "NextPageNumber": 0, "PreviousPageNumber": 0 }
This is the name of your application, in this case "MyApp/1.0.0". It is used to identify your application.
This is where the version number of your application is entered, in this case "1.0.0".
The User-Id as int or uuid to run the Request, a JTL-Wawi user can be specified to perform an API call on their behalf (more details in the documentation, Optional). To use the Header, you must have the needed Scope 'Application.RunAs'
The category to create.
Category description in the default language of JTL-Wawi.
ID of the parent category, if the category is a child category.
The category sort number used in some sales channels for arranging the categories.
curl -i -X POST \
https://developer.jtl-software.com/_mock/products/erpapi/1.0-cloud/openapi/categories \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'api-version: string' \
-H 'tenant-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-appid: string' \
-H 'x-appversion: string' \
-H 'x-runas: string' \
-d '{
"Name": "Binoculars",
"Description": "Best Binoculars",
"ParentCategoryId": 5,
"SortNumber": 1,
"ActiveSalesChannels": "1-1-1"
}'The created category.
Category description in the default language of JTL-Wawi.
ID of the parent category, if the category is a child category.
Returns the category level number within its category tree. A root category without a parent has a level 1.
The category sort number used in some sales channels for arranging the categories.
{ "Id": 13, "Name": "Binoculars", "Description": "Best Binoculars", "ParentCategoryId": 5, "Level": 2, "SortNumber": 1, "ActiveSalesChannels": "1-1-1" }
This is the name of your application, in this case "MyApp/1.0.0". It is used to identify your application.
This is where the version number of your application is entered, in this case "1.0.0".
The User-Id as int or uuid to run the Request, a JTL-Wawi user can be specified to perform an API call on their behalf (more details in the documentation, Optional). To use the Header, you must have the needed Scope 'Application.RunAs'
curl -i -X GET \
'https://developer.jtl-software.com/_mock/products/erpapi/1.0-cloud/openapi/categories/{categoryId}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'api-version: string' \
-H 'tenant-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-appid: string' \
-H 'x-appversion: string' \
-H 'x-runas: string'Returns the category for the given id.
Category description in the default language of JTL-Wawi.
ID of the parent category, if the category is a child category.
Returns the category level number within its category tree. A root category without a parent has a level 1.
The category sort number used in some sales channels for arranging the categories.
{ "Id": 13, "Name": "Binoculars", "Description": "Best Binoculars", "ParentCategoryId": 5, "Level": 2, "SortNumber": 1, "ActiveSalesChannels": "1-1-1" }
This is the name of your application, in this case "MyApp/1.0.0". It is used to identify your application.
This is where the version number of your application is entered, in this case "1.0.0".
The User-Id as int or uuid to run the Request, a JTL-Wawi user can be specified to perform an API call on their behalf (more details in the documentation, Optional). To use the Header, you must have the needed Scope 'Application.RunAs'
The category to update.
Category description in the default language of JTL-Wawi.
ID of the parent category, if the category is a child category.
The category sort number used in some sales channels for arranging the categories.
curl -i -X PATCH \
'https://developer.jtl-software.com/_mock/products/erpapi/1.0-cloud/openapi/categories/{categoryId}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'api-version: string' \
-H 'tenant-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-appid: string' \
-H 'x-appversion: string' \
-H 'x-runas: string' \
-d '{
"Name": "Binoculars",
"Description": "Best Binoculars",
"ParentCategoryId": 5,
"SortNumber": 1,
"ActiveSalesChannels": "1-1-1"
}'The updated category.
Category description in the default language of JTL-Wawi.
ID of the parent category, if the category is a child category.
Returns the category level number within its category tree. A root category without a parent has a level 1.
The category sort number used in some sales channels for arranging the categories.
{ "Id": 13, "Name": "Binoculars", "Description": "Best Binoculars", "ParentCategoryId": 5, "Level": 2, "SortNumber": 1, "ActiveSalesChannels": "1-1-1" }
This is the name of your application, in this case "MyApp/1.0.0". It is used to identify your application.
This is where the version number of your application is entered, in this case "1.0.0".
The User-Id as int or uuid to run the Request, a JTL-Wawi user can be specified to perform an API call on their behalf (more details in the documentation, Optional). To use the Header, you must have the needed Scope 'Application.RunAs'
curl -i -X GET \
'https://developer.jtl-software.com/_mock/products/erpapi/1.0-cloud/openapi/categories/{categoryId}/descriptions' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'api-version: string' \
-H 'tenant-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-appid: string' \
-H 'x-appversion: string' \
-H 'x-runas: string'The requested category descriptions.
The category name in the given language and sales channel. The name in JTL-Wawi and the default language is the default name of the category.
The category description in the given language and sales channel.
The SEO metadescription in the given language and sales channel.
The title tag (SEO) in the given language and sales channel.
The meta keywords in the given language and sales channel.
The sales channel ID of the description. Only specific sales channels are allowed for this operation and are specified in the sales channel endpoint(GET).
[ { "CategoryId": 13, "Name": "Binoculars", "Description": "Best Binoculars", "SeoPath": "binoculars", "SeoMetaDescription": "Best Binoculars", "SeoTitleTag": "Best Binoculars", "SeoMetaKeywords": "Best, Binoculars", "LanguageIso": "DE", "SalesChannelId": "1-1-0" } ]
This is the name of your application, in this case "MyApp/1.0.0". It is used to identify your application.
This is where the version number of your application is entered, in this case "1.0.0".
The User-Id as int or uuid to run the Request, a JTL-Wawi user can be specified to perform an API call on their behalf (more details in the documentation, Optional). To use the Header, you must have the needed Scope 'Application.RunAs'
The categoryDescription to create.
The category name in the given language and sales channel. The name in JTL-Wawi and the default language is the default name of the category.
The category description in the given language and sales channel.
The SEO metadescription in the given language and sales channel.
The title tag (SEO) in the given language and sales channel.
The meta keywords in the given language and sales channel.
curl -i -X POST \
'https://developer.jtl-software.com/_mock/products/erpapi/1.0-cloud/openapi/categories/{categoryId}/descriptions' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'api-version: string' \
-H 'tenant-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-appid: string' \
-H 'x-appversion: string' \
-H 'x-runas: string' \
-d '{
"Name": "Binoculars",
"Description": "Best Binoculars",
"SeoPath": "binoculars",
"SeoMetaDescription": "Best Binoculars",
"SeoTitleTag": "Best Binoculars",
"SeoMetaKeywords": "Best, Binoculars",
"LanguageIso": "DE",
"SalesChannelId": "1-1-0"
}'The created category description.
The category name in the given language and sales channel. The name in JTL-Wawi and the default language is the default name of the category.
The category description in the given language and sales channel.
The SEO metadescription in the given language and sales channel.
The title tag (SEO) in the given language and sales channel.
The meta keywords in the given language and sales channel.
{ "CategoryId": 13, "Name": "Binoculars", "Description": "Best Binoculars", "SeoPath": "binoculars", "SeoMetaDescription": "Best Binoculars", "SeoTitleTag": "Best Binoculars", "SeoMetaKeywords": "Best, Binoculars", "LanguageIso": "DE", "SalesChannelId": "1-1-0" }
This is the name of your application, in this case "MyApp/1.0.0". It is used to identify your application.
This is where the version number of your application is entered, in this case "1.0.0".
The User-Id as int or uuid to run the Request, a JTL-Wawi user can be specified to perform an API call on their behalf (more details in the documentation, Optional). To use the Header, you must have the needed Scope 'Application.RunAs'
curl -i -X DELETE \
'https://developer.jtl-software.com/_mock/products/erpapi/1.0-cloud/openapi/categories/{categoryId}/descriptions/{salesChannelId}/{languageIso}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'api-version: string' \
-H 'tenant-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-appid: string' \
-H 'x-appversion: string' \
-H 'x-runas: string'This is the name of your application, in this case "MyApp/1.0.0". It is used to identify your application.
This is where the version number of your application is entered, in this case "1.0.0".
The User-Id as int or uuid to run the Request, a JTL-Wawi user can be specified to perform an API call on their behalf (more details in the documentation, Optional). To use the Header, you must have the needed Scope 'Application.RunAs'
The category to update.
The category name in the given language and sales channel. The name in JTL-Wawi and the default language is the default name of the category.
The category description in the given language and sales channel.
The SEO metadescription in the given language and sales channel.
The title tag (SEO) in the given language and sales channel.
curl -i -X PATCH \
'https://developer.jtl-software.com/_mock/products/erpapi/1.0-cloud/openapi/categories/{categoryId}/descriptions/{salesChannelId}/{languageIso}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'api-version: string' \
-H 'tenant-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-appid: string' \
-H 'x-appversion: string' \
-H 'x-runas: string' \
-d '{
"Name": "Binoculars",
"Description": "Best Binoculars",
"SeoPath": "binoculars",
"SeoMetaDescription": "Best Binoculars",
"SeoTitleTag": "Best Binoculars",
"SeoMetaKeywords": "Best, Binoculars"
}'This is the name of your application, in this case "MyApp/1.0.0". It is used to identify your application.
This is where the version number of your application is entered, in this case "1.0.0".
The User-Id as int or uuid to run the Request, a JTL-Wawi user can be specified to perform an API call on their behalf (more details in the documentation, Optional). To use the Header, you must have the needed Scope 'Application.RunAs'
The item Ids to be assigned to the category.
curl -i -X POST \
'https://developer.jtl-software.com/_mock/products/erpapi/1.0-cloud/openapi/categories/{categoryId}/items' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'api-version: string' \
-H 'tenant-id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
-H 'x-api-key: YOUR_API_KEY_HERE' \
-H 'x-appid: string' \
-H 'x-appversion: string' \
-H 'x-runas: string' \
-d '[
0
]'[ 0 ]