API Documentation
❓ Introduction
N24 Labels provides an OData Web Service interface that allows integration with external applications such as PowerApps or Power Automate. This enables you to retrieve the list of available label layouts and build custom interfaces for template selection.
The endpoint is based on a Web Service (Codeunit Web Service) and uses the OData v4 protocol.
🔗 URL Format
The endpoint has the following format:
POST /ODataV4/LabelsWebService_{operation}?Company={companyName}
where:
{operation}is the name of the called procedure{companyName}is the company name in Business Central
📑 Table of Contents
🧾 Label Layouts API
Retrieving label layouts (GetLabelLayouts)
Returns a list of available label layouts along with information about which layout was last used by a given employee.
Endpoint: /ODataV4/LabelsWebService_GetLabelLayouts?Company={companyName}
Method: POST
Operations:
- POST - Retrieve label layouts with last used indication
Request parameters:
| Field | Type | Description |
|---|---|---|
| employeeSystemId | Text | Employee SystemId (Guid as text). An empty string skips marking the last used layout |
Headers:
| Header | Value |
|---|---|
| Content-Type | application/json |
Response fields (JSON array in the value field):
| Field | Type | Description |
|---|---|---|
| name | Text | Label layout name |
| description | Text | Label layout description |
| isLastUsed | Boolean | Whether the layout was last used by the specified employee |
Notes:
- The
valuefield in the response contains a JSON array encoded as text - If
employeeSystemIdis empty or invalid, all layouts will haveisLastUsed = false - Only layouts assigned to the label report (
N24LBL Label Report) are returned
Request example:
{
"employeeSystemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
Response example:
{
"value": "[{\"name\":\"StandardLabel\",\"description\":\"Standard product label\",\"isLastUsed\":true},{\"name\":\"ShippingLabel\",\"description\":\"Shipping label\",\"isLastUsed\":false}]"
}