API - Stock Centers | Wisefish Manuals

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.

Endpoint name	`stockCenters`
Source table	`WiFi Stock Center`
Fixed view
Requests allowed	GET, POST, PATCH, DELETE
Primary key	Code
Record ID	code
Procedures	`createOriginLot` `createProductionLot` `createPallet`

Data

Field List

Property	Type	Format	Description
`code`	string	max 10	The unique id of this stock center.	Record ID primary key
`name`	string		Name	mandatory
`systemId`	string	uuid		non-editable
`address`	string	max 50	Address	optional
`address2`	string	max 50	Address 2	optional
`postCode`	string	max 20	Post Code	optional
`city`	string	max 30	City	optional
`countryCode`	string	max 10	Country Code	optional
`contact`	string	max 50	Contact Name	optional
`eMail`	string		Email	optional
`gln`	string	max 13	Global location number (GLN)	optional
`vendorId`	string	uuid	Stock centers can be linked to a Vendor. Then this field will show the GUID of the Vendor.	non-editable
`vendorCode`	string	max 20	The number of a linked Vendor	optional
`customerId`	string	uuid	Stock centers can be linked to a Customer. Then this field will show the GUID of the Customer.	non-editable
`customerCode`	string	max 20	The number of a linked Customer	optional
`stockCenterType`	string	enum	Options: (blank) - this is the default External Producer 3rd Party Producer	optional
`itemMixOnPalletAllowed`	boolean		Default value is false.	optional
`palletBarcodeUsage`	string		Options: SSCC (GS1) Not Used	optional
`ssccAllocationCode`	string	max 20		optional
`certificationProcess`	string	enum	Options: No Certification Single Certification Multiple Certifications"	optional
`transferCertificateRequired`	boolean			optional
`certificationPrograms`	array	json	Certification Programs. This can be added as a child array with `?$expand=certificationPrograms`
`lastModified`	string	date-time		non-editable

Example Object

Expand to see the example json

An example of one object :

JSON

{
    "code": "OWN",
    "systemId": "04daea07-a0a1-ef11-b017-aa2d6f3d6955",
    "address": "Katrínartún 4",
    "address2": "",
    "postCode": "105",
    "city": "Reykavik",
    "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,
    "lastModified": "2025-12-15T11:54:10.823Z"
}

Usage

Read all entries

JSON

GET
.../stockCenters

Read a specific entry

JSON

GET
.../stockCenters('INSIDE')

Create a Lot for Stock Center

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.

Create an origin Lot

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

JSON

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

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

Parameters	Type	Max Len	Description
`description`	string	20	The description to put on the lot. If skipped, it will be set as “Origin Lot”	optional
`lotGroup`	string	20	If the lot is to be put into a Lot Group.	optional

An entry in the table Lot is created, and the number is shown in the value property of the response .

Example:

JSON

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": "Lot LOT0206 created"
}

Create a production Lot

JSON

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

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

Parameters	Type	Max Len	Description
`description`	string	20	The description to put on the lot. If skipped, it will be set as “Production Lot”	optional
`lotGroup`	string	20	If the lot is to be put into a Lot Group.	optional
`startingDate`	date		The starting date of the lot.	mandatory

An entry in the table Lot is created, and the number is shown in the value property of the response .

Example:

JSON

POST .../stockCenters('OWN')/Microsoft.NAV.createOriginLot
{
    "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": "Lot LOT0207 created"
}

Create a Pallet

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.

JSON

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

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

Parameters	Type	Max Len	Description
`location`	string	10	If left blank, the Location Code will be taken from the User Profile	optional
`fishingTripNo`	string	20		optional

A barcode will be generated and an entry in the Pallet list is created

The pallet gets the current Stock Center Code.
Location Code must be populated, either with the parameter, or taken from the User Profile of the current user
Key Item No. on this pallet is blank, but will be populated when trade items are posted on the pallet.
Date Created is set as the date today
Status of the pallet is Empty