Authentication and Work Context

Basic Authentication

The Axacon WMS REST API uses Basic Authentication with a username and password. The API user must:

Have a valid username and password.
Belong to the INTEGRATION user group.
Have access to the required owner, company, and warehouse.

Why Work Context matters

Axacon WMS uses a Work Context to determine which owner, company, and warehouse a request operates on. If the request does not explicitly specify the required context, Axacon WMS uses the default Work Context configured for the login user.

Important An incorrect default Work Context can cause data to be created or retrieved for the wrong owner, company, or warehouse.

Create an item

POST https://[SERVER]/integration/rest/V1/Item
Content-Type: application/json
Authorization: Basic [CREDENTIALS]

{
  "Id": "Item6",
  "ItemName": "Fiddle Violinfigen",
  "NetWeight": 7.7,
  "CustomsTariffCode": "6702100000",
  "CountryOfOrigin": "CN",
  "ItemGroupId": "KUNSTIGEPLANTER"
}

Specify warehouse and owner in the URL

POST https://[SERVER]/integration/rest/V1/Section?warehouse=Terminal2&owner=auto

{
  "Id": "Section1"
}

Implementation checklist

Confirm which owner should receive the data.
Confirm which company owns the transaction.
Confirm which warehouse should process the order.
Verify the integration user’s default Work Context.
Specify the context explicitly when the integration supports multiple contexts.