API - External Item Labels


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

externalItemLabels

Source table

WiFi Ext. Item Label Selection

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

systemId

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


systemId

string

uuid

SystemId

Record ID

non-editable

typeOfExternalParty

string

enum

Type of Ext. Party. Options: Stock Center, Customer, Vendor, Country

primary key

externalPartyCode

string

max 20

External Party Code: a stock center code, customer number, vendor number or country/region code, depending on typeOfExternalParty.

primary key

externalItemNo

string

max 20

Ext. Item No., the external item the labels are for.

primary key

shipToCode

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

stockCenterCode

string

max 20

Stock Center Code. Empty if the selection is not for a specific stock center.

primary key

innerLabel

string

max 30

Inner Label, the code of the inner label.


tradeItemLabel

string

max 30

Trade Item Label, the code of the trade item label.


outerLabel

string

max 30

Outer Label, the code of the outer label.


palletLabel

string

max 30

Pallet Label, the code of the pallet label.


gtin

string

max 14

GTIN


gtinTradeItem

string

max 14

GTIN (TI), the GTIN of the trade item.


gtinOuter

string

max 14

GTIN (Outer), the GTIN of the outer box.


productionInformation

string

max 500

Production Information, text to print on the labels, for example importer details.


systemRowVersion

integer


System row version. Increments every time the record is modified.

non-editable

lastModified

string

date-time

SystemModifiedAt (date and time of last change)

non-editable


Object Example

An example of one object:

JSON
{
    "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:

JSON
GET .../externalItemLabels?$filter=typeOfExternalParty eq 'Customer' and externalPartyCode eq '41000' and externalItemNo eq 'HAD-160-MSC'&$select=shipToCode,stockCenterCode,innerLabel,tradeItemLabel,palletLabel

Response:

JSON
{
    "@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