API - Stock Centers

Overview

The list page that contains the Stock Centers of Wisefish. All Trade Items must belong to a stock center at every point of time.

The number series for production lot is on the stock center, therefore it has procedures to create lots, either an origin lot or a production lot.

Data

Field List

Object Example

An example of one object:

{
    "code": "OWN",
    "systemId": "04daea07-a0a1-ef11-b017-aa2d6f3d6955",
    "name": "Our Stock Center",
    "address": "Katrínartún 4",
    "address2": "",
    "postCode": "105",
    "city": "Reykjavik",
    "countryCode": "IS",
    "contact": "",
    "eMail": "",
    "gln": "0000123456784",
    "vendorId": "00000000-0000-0000-0000-000000000000",
    "vendorCode": "",
    "customerId": "00000000-0000-0000-0000-000000000000",
    "customerCode": "",
    "stockCenterType": " ",
    "itemMixOnPalletAllowed": true,
    "palletBarcodeUsage": "SSCC (GS1) Nos.",
    "ssccAllocationCode": "OUR",
    "certificationProcess": "Single Certification",
    "transferCertificateRequired": false,
    "systemRowVersion": 2581230,
    "lastModified": "2025-12-15T11:54:10.823Z"
}

Procedures

Procedures are called on a specific stock center: POST stockCenters('<code>')/Microsoft.NAV.<procedureName> with a JSON body of parameters. Each procedure returns the code of the record it created (a lot code or a pallet barcode) in the value property of the response, no other text. On failure it returns an error with a readable message.

Lots

Create Origin Lot

Usually origin lots are created automatically by the system when received items are posted, but they could also be made beforehand.

POST
.../stockCenters([record-id])/Microsoft.NAV.createOriginLot

Body:
{
    "description" : [some description],
    "lotGroup" : [a code for Lot Group that exists]
}

Possible errors:

• An error from assigning the new lot code from the number series when the lot is inserted (standard Business Central error, e.g. if the number series is missing or exhausted).

• An error from validating the description on the lot.

• The Lot Group given in lotGroup does not exist or is not valid (standard Business Central validation error on the Group field of the lot).

• An error from validating the Stock Center Code on the lot.

• A parameter value longer than its maximum length is rejected by Business Central (standard error).

Note: The lot gets this stock center as its Stock Center Code (replacing any value from the User Profile), a blank Production Type, a blank Default Hold Status and today as Creation Date. There are no custom error messages in this procedure; all errors come from Business Central / Wisefish validation.

Create Production Lot

Creates a lot that is active in production, starting on the given date.

POST
.../stockCenters([record-id])/Microsoft.NAV.createProductionLot

Body:
{
    "description" : [some description],
    "lotGroup" : [a code for a Lot Group that exists],
    "startingDate": [a date]
}

Possible errors:

• An error from assigning the new lot code from the number series when the lot is inserted (standard Business Central error, e.g. if the number series is missing or exhausted).

• An error from validating the description on the lot.

• The Lot Group given in lotGroup does not exist or is not valid (standard Business Central validation error on the Group field of the lot).

• An error from validating the Stock Center Code on the lot.

• An error from validating Production Type, Active in Production or Starting Date on the lot (standard Business Central / Wisefish validation error).

• A parameter value longer than its maximum length is rejected by Business Central (standard error).

Note: The lot gets this stock center as its Stock Center Code, Production Type Production, Active in Production set to true, the given Starting Date, a blank Default Hold Status and NAV Inv. Production Posting Lot. There are no custom error messages in this procedure; all errors come from Business Central / Wisefish validation.

Pallets

Create Pallet Barcode

This method is used to create a new entry in the Pallet table, where the barcode is generated according to the settings on the Stock Center.

The procedure is named createPalletBarcode (not createPallet, which is the name of a separate API endpoint, createPallets).

POST
.../stockCenters([record-id])/Microsoft.NAV.createPalletBarcode

Body:
{
    "location": "BLUE",
    "fishingTripNo" : [if the pallet should be connected to a fishing trip]
}

Possible errors:

• No User Setup exists for the current user (standard Business Central error, record not found).

• The WiFi User Profile Code on the User Setup of the current user is blank (standard Business Central TestField error).

• The User Profile does not exist (standard Business Central error, record not found).

• Only when location is blank: the Location Code on the User Profile is blank (standard Business Central TestField error).

• Pallet Barcode Usage on the stock center is not SSCC (GS1) (standard Business Central TestField error).

• SSCC Allocation Code on the stock center is blank (standard Business Central TestField error).

• The GS1 SSCC Allocation does not exist (standard Business Central error, record not found).

• SSCC Circle on the GS1 SSCC Allocation is blank (standard Business Central TestField error).

• An error from inserting the pallet, e.g. if a pallet with the generated barcode already exists (standard Business Central error).

• A parameter value longer than its maximum length is rejected by Business Central (standard error).

Note: The barcode is always generated (it cannot be given as a parameter). The Pallet No. is derived from the barcode, and the Physical Pallet ID is set as 99 followed by characters 3-20 of the barcode. The fishing trip no., location code and item no. are not validated by this procedure.

Create Pallet With Key Item

Creates a new pallet in the same way as createPalletBarcode, and sets the given item as the key item of the pallet.

POST
.../stockCenters([record-id])/Microsoft.NAV.createPalletWithKeyItem

Body:
{
    "location": "BLUE",
    "fishingTripNo" : [if the pallet should be connected to a fishing trip],
    "itemNo" : [the item no. of the key item]
}

Possible errors: the same as for createPalletBarcode (see Create Pallet Barcode).

Examples

Read stock centers

Read all entries

Reads all stock centers. The response is a list of stock center objects, as shown in Object Example.

GET
.../stockCenters

Read a specific entry

Reads one stock center by its Record ID (code).

GET
.../stockCenters('OWN')

Read stock centers of a given type

For example, to read all stock centers that are external producers:

GET .../stockCenters?$filter=stockCenterType eq 'External Producer'

Read a stock center with its certification programs

Reads stock center OWN with its certification programs as a child array.

GET .../stockCenters('OWN')?$expand=certificationPrograms

Create lots

Create an origin lot on a stock center

Creates an origin lot on stock center OWN in Lot Group WEEK-1 using createOriginLot.

POST .../stockCenters('OWN')/Microsoft.NAV.createOriginLot
{
    "description" : "Received items",
    "lotGroup" : "WEEK-1"
}

Response:
{
    "@odata.context": "https://containers.wisefish.com/BC/api/wisefish/base/v1.0/$metadata#Edm.String",
    "value": "LOT0206"
}

Create an origin lot with default values

Creates an origin lot on stock center OWN without parameters; the description is set to “Origin lot”.

Request:

POST
.../stockCenters('OWN')/Microsoft.NAV.createOriginLot

Body:
{
}

Response:

{
    "@odata.context": "https://containers.wisefish.com/BC/api/wisefish/base/v1.0/$metadata#Edm.String",
    "value": "LOT0208"
}

Create a production lot on a stock center

Creates a production lot on stock center OWN starting 2 December 2025 using createProductionLot.

POST .../stockCenters('OWN')/Microsoft.NAV.createProductionLot
{
    "startingDate": "2025-12-02",
    "description": "Production 2nd Dec - 2",
    "lotGroup": "Arna"
}

Response:
{
    "@odata.context": "https://containers.wisefish.com/BC/api/wisefish/base/v1.0/$metadata#Edm.String",
    "value": "LOT0207"
}

Create pallets

Create a pallet with a generated barcode

Creates an empty pallet on stock center OWN at location BLUE using createPalletBarcode.

Request:

POST
.../stockCenters('OWN')/Microsoft.NAV.createPalletBarcode

Body:
{
    "location": "BLUE"
}

Response:

{
    "@odata.context": "https://containers.wisefish.com/BC/api/wisefish/base/v1.0/$metadata#Edm.String",
    "value": "00050000000000001101"
}

Create a pallet connected to a fishing trip

Creates a pallet on stock center OWN connected to fishing trip FT-0012; the location is taken from the User Profile.

Request:

POST
.../stockCenters('OWN')/Microsoft.NAV.createPalletBarcode

Body:
{
    "fishingTripNo": "FT-0012"
}

Response:

{
    "@odata.context": "https://containers.wisefish.com/BC/api/wisefish/base/v1.0/$metadata#Edm.String",
    "value": "00050000000000001118"
}

Create a pallet with a key item

Creates a pallet on stock center OWN at location BLUE with key item 1000 using createPalletWithKeyItem.

Request:

POST
.../stockCenters('OWN')/Microsoft.NAV.createPalletWithKeyItem

Body:
{
    "location": "BLUE",
    "itemNo": "1000"
}

Response:

{
    "@odata.context": "https://containers.wisefish.com/BC/api/wisefish/base/v1.0/$metadata#Edm.String",
    "value": "00050000000000001125"
}