Using API
The SSCC Management app exposes a dedicated API that allows external systems (such as handheld warehouse devices or third-party logistics platforms) to interact with SSCC data.
This app is first designed as a backup when no registration or false registration has been made using a handheld device app. Handheld device apps can better interact with the API, and back-office users will see the outcome in the web client using the enclosed screens.
Packagetype resource type
The API supports the following operations:
| Resource | Operation | Description |
|---|---|---|
| sscc | Read | Retrieve SSCC records (by ID, by user ID, or by SSCC number). |
| sscc | Create | Create a new SSCC, setting it to In Progress for the specified user. |
| sscc | Update | Update the status, package type, or assigned user of an existing SSCC. The SSCC number itself cannot be modified. |
| sscc | Trigger the label print for an SSCC directly via the API. | |
| packageTypes | Read | Retrieve the list of configured package types (code, description, external code). |
Methods
| Method | Return Type | Description | |
|---|---|---|---|
| GET | packagetype | Gets an array of packagetype objects. |
Properties
| Property | Type | Description | |
|---|---|---|---|
| code | string | Specifies the package code (20 digits) as defined on the Package Type list. | |
| description | string | Specifies the package description. | |
| externalCode | string | Specifies the package external code. | |
| id | Guid | The Unique ID of the package type. |
HTTP request
Get request
Replace the URL prefix for Business Central depending on environment following the guideline.
GET businesscentralPrefix/api/isatech/sscc/v1.0/companies({companyId})/packageTypes
Returned Value
{
"value": [
{
"@odata.etag": "string",
"code": "string",
"description": "string",
"externalCode": "string",
"systemId": "guid"
}
]
}
SSCC resource type
Methods
| Method | Return Type | Description | |
|---|---|---|---|
| GET | sscc | Gets an array of sscc objects. | |
| POST | sscc | Create a sscc object. | |
| PATCH | sscc | Update a sscc object. |
Properties
| Property | Type | Description | |
|---|---|---|---|
| ssccNo | string | Specifies the SSCC number. | |
| packageType | string | PackageType Code. | |
| status | string | SSCC status. | |
| userID | string | User ID Code identifier. | |
| id | Guid | The Unique ID of the sscc type. |
HTTP request
Get request
Replace the URL prefix for Business Central depending on environment following the guideline.
GET businesscentralPrefix/api/isatech/sscc/v1.0/companies({companyId})/sscc
Direct filtering is possible on id, userID and ssccNo using following oData filtering syntaxes
GET businesscentralPrefix/api/isatech/sscc/v1.0/companies({companyId})/sscc?filter eq id
GET businesscentralPrefix/api/isatech/sscc/v1.0/companies({companyId})/sscc?filter eq userID
GET businesscentralPrefix/api/isatech/sscc/v1.0/companies({companyId})/sscc?filter eq ssccNo
Returned Value
{
"value": [
{
"@odata.etag": "string",
"id": "guid",
"ssccNo": "string",
"packageType": "string",
"status": "srting",
"userID": "string"
}
]
}
Bound Actions
The SSCC resource type offers a bound action called print which prints the corresponding SSCC Label. This feature uses the SSCC Label report selection to select the corresponding report. This is illustrated in the following example:
POST businesscentralPrefix/api/isatech/sscc/v1.0/companies({companyId})/sscc/Microsoft.NAV.print
The response has no content; the response code is 204.
Note: The API enforces the same business rules as the user interface. For example, a user cannot be assigned to an SSCC that is already In Progress under a different user, and the SSCC number field is read-only once created.