To access the warehouse and sales document management APIs, every request must include authentication headers. The following headers are required for each API call:

companyId: Your company's unique identifier.

siteId: The specific site or location identifier within the company.

username: Your API username.

password: Your API password.

namespace: The environment namespace, which determines whether the request is for the test or production environment.

languageId: IT or EN.

Example Headers

CAUTION

In addition to the authentication headers, it is mandatory to include the loadRoles=Y header in your API requests. Furthermore, the URL must include the parameters applicationId=MOBILE_SHOP and appId=MOBILE_SHOP.

Sample request

TIP

The URL for API calls is the same for both test and production environments. The difference is made by the namespace value:

Use TEST for the test environment.

Use PROD for the production environment.

Ensure that you set the namespace header correctly depending on whether you are testing or making real transactions.

Base url endpoint

Env	Base Url
TEST	https://keepit-test.clienteller.com/platform
PROD	https://api.clienteller.com/platform

Authentication

Example Headers#

Sample request#

Base url endpoint#

Example Headers

Sample request

Base url endpoint