Overview
The list page that contains the External Item Label Selection: which labels (inner, trade item, outer and pallet label) and GTINs to use for an external item, and the production information to print. The label selection can be set per ship-to address of a customer and per stock center. No data update is allowed: the label selection is maintained in Business Central.
Each label selection belongs to one external item (same type of external party, external party code and external item number), see API - External Items. An external item can have many label selections.
|
Endpoint name |
|
|
Source table |
|
|
Fixed view |
No filter. Returns the label selections of all types of external party. |
|
Requests allowed |
GET |
|
Primary key |
“Type of Ext. Party”, “External Party Code”, “Ext. Item No.”, “Ship-to Code”, “Stock Center Code” |
|
Record ID |
|
|
Procedures |
None |
Finding the right labels
To find the labels for an external item, filter on typeOfExternalParty, externalPartyCode and externalItemNo. A label selection with an empty shipToCode and stockCenterCode is general for the external item; the others are for one ship-to address or one stock center.
Data
Field List
|
Property |
Type |
Format |
Description |
|
|
|
string |
uuid |
SystemId |
Record ID non-editable |
|
|
string |
enum |
Type of Ext. Party. Options: Stock Center, Customer, Vendor, Country |
primary key |
|
|
string |
max 20 |
External Party Code: a stock center code, customer number, vendor number or country/region code, depending on |
primary key |
|
|
string |
max 20 |
Ext. Item No., the external item the labels are for. |
primary key |
|
|
string |
max 10 |
Ship-to Code. For type Customer, a ship-to address of the customer. Empty if the selection is not for a specific ship-to address. |
primary key |
|
|
string |
max 20 |
Stock Center Code. Empty if the selection is not for a specific stock center. |
primary key |
|
|
string |
max 30 |
Inner Label, the code of the inner label. |
|
|
|
string |
max 30 |
Trade Item Label, the code of the trade item label. |
|
|
|
string |
max 30 |
Outer Label, the code of the outer label. |
|
|
|
string |
max 30 |
Pallet Label, the code of the pallet label. |
|
|
|
string |
max 14 |
GTIN |
|
|
|
string |
max 14 |
GTIN (TI), the GTIN of the trade item. |
|
|
|
string |
max 14 |
GTIN (Outer), the GTIN of the outer box. |
|
|
|
string |
max 500 |
Production Information, text to print on the labels, for example importer details. |
|
|
|
integer |
|
System row version. Increments every time the record is modified. |
non-editable |
|
|
string |
date-time |
SystemModifiedAt (date and time of last change) |
non-editable |
Object Example
An example of one object:
{
"systemId": "6f041b10-faed-ef11-aac0-c0b6f9b7cac7",
"typeOfExternalParty": "Customer",
"externalPartyCode": "41000",
"externalItemNo": "HAD-160-MSC",
"shipToCode": "WAREHOUSE",
"stockCenterCode": "",
"innerLabel": "F_DK_INNER",
"tradeItemLabel": "D_DK_9405",
"outerLabel": "",
"palletLabel": "P_STD",
"gtin": "05690000123456",
"gtinTradeItem": "15690000123453",
"gtinOuter": "",
"productionInformation": "Importer: Nordic Seafood A/S, Esbjerg, Denmark",
"systemRowVersion": 2580342,
"lastModified": "2026-10-02T13:20:53.67Z"
}
Examples
Read label selections
Read all entries
Reads all label selections. The response is a list of label selection objects, as shown in Object Example.
GET .../externalItemLabels
Read the labels of an external item
Reads the label selections of external item HAD-160-MSC of customer 41000, and returns only the key fields and labels with $select.
Request:
GET .../externalItemLabels?$filter=typeOfExternalParty eq 'Customer' and externalPartyCode eq '41000' and externalItemNo eq 'HAD-160-MSC'&$select=shipToCode,stockCenterCode,innerLabel,tradeItemLabel,palletLabel
Response:
{
"@odata.context": "https://containers.wisefish.com/BC/api/wisefish/base/v1.0/$metadata#companies(cf9f7b85-dd11-ef11-9f8b-6045bde9cc61)/externalItemLabels(shipToCode,stockCenterCode,innerLabel,tradeItemLabel,palletLabel)",
"value": [
{
"@odata.etag": "W/\"JzE5OzUzNjIzODk5MjE1OTU3MTgzODcxOzAwOyc=\"",
"shipToCode": "",
"stockCenterCode": "",
"innerLabel": "F_STD_INNER",
"tradeItemLabel": "D_STD_9405",
"palletLabel": "P_STD"
},
{
"@odata.etag": "W/\"JzIwOzEzODcwNDIxNjE2MDQ1NzE1OTA5MTswMDsn\"",
"shipToCode": "WAREHOUSE",
"stockCenterCode": "",
"innerLabel": "F_DK_INNER",
"tradeItemLabel": "D_DK_9405",
"palletLabel": "P_STD"
}
]
}
Read label selections changed since a given time
Reads the label selections that have been changed after a given date and time, for example to synchronize them to a production system.
GET .../externalItemLabels?$filter=lastModified gt 2026-11-01T00:00:00Z