API - Lots | Wisefish Manuals

Overview

This API is for the lot table.

Every item entry in Wisefish must be linked to a Lot, because in fact, the Lot makes it possible to “track” items of Wisefish.

It is important to understand that lots are mainly of 2 types:

Origin Lots. These are used for stock that comes into the system either with purchase, landing or positive adjustments.
Production Lots. These are used for posting the produced items into stock or removing the consumed items out of stock.

Endpoint name	`lots`
Source table	`WiFi Lot`
Fixed view	There is no fixed filter on this list.
Requests allowed	GET, POST, PATCH, DELETE
Primary Key	`code`
Record ID	`code`
Procedures	Additionally POST requests can be done on a procedure endpoints. `produceItem` `consumeItem`

Data

Field List

Property	Type	Max Len	Description
`systemId`	string uuid	GUID	The system id of the record.
`code`	string	20		primary key Record ID
`description`	string	100
`postingStatus`	string
`stockCenterCode`	string	20
`itemCategoryCode`	string	20
`activeInProduction`	true/false		Needs to be true in order to post on the lot. When creating this will be set as true by default.
`productionType`	string		Options: blank - then it is an “origin lot” Production - a normal production lot
`startingDate`	date
`endingDate`	date
`certificationProcess`	string
`certification`	string		(CertificationInfo – unknown type)
`certifications`	array		Array of object `lotCertification`
`lastModified`	datetime

Example Object

JSON

{
    "@odata.context": "https://containers.wisefish.com/BC/api/wisefish/base/v1.0/$metadata#companies(cf9f7b85-dd11-ef11-9f8b-6045bde9cc61)/lots/$entity",
    "@odata.etag": "W/\"JzIwOzExNTM0OTg1MTQzMzE3OTg4MDAxMTswMDsn\"",
    "code": "COD-LIVER-18-12",
    "systemId": "0f8f305a-09dc-f011-b02a-8bca792786d1",
    "description": "Þorsklifur móttekin 18. des",
    "postingStatus": "Open",
    "stockCenterCode": "FROSTI",
    "itemCategoryCode": "",
    "productionType": "Production",
    "startingDate": "2025-12-18",
    "endingDate": "2025-12-18",
    "certificationProcess": "Yes",
    "certification": "Certified",
    "lastModified": "2025-12-18T12:01:58.453Z"
}

Usage

Read all lots

JSON

GET .../lots

Read one lot

The record id is the lot number itself, so one entry is read with a GET request on the following format:

JSON

GET .../lots('COD-LIVER-18-12')

Create a new Lot

Here it is important to keep in mind that the User Profile within Wisefish, can have defaults which are used when a new lot is created.

If it is set on Production Lot Type = Production, the created lot will be a production Lot.

Note: There is also a specific endpoint to crate Production Lots, which can have more properties that origin lots: API - Production Lots

JSON

POST .../lots

Body:
{
    "code": "cod-liver-21-12",
    "description": "Þorsklifur móttekin 21. des",
    "startingDate": "2025-12-21",
    "endingDate": "2025-12-21"
}

In this case the User Profile does not have any defaults, the created lot will be an origin lot (productionType field is empty).

{
    "@odata.context": "https://containers.wisefish.com/BC/api/wisefish/base/v1.0/$metadata#companies(cf9f7b85-dd11-ef11-9f8b-6045bde9cc61)/lots/$entity",
    "@odata.etag": "W/\"JzE5OzU4MTgwODMxMjM5NTU1NTM5MjAxOzAwOyc=\"",
    "code": "COD-LIVER-21-12",
    "systemId": "4d9188eb-17dc-f011-b02a-8bca792786d1",
    "description": "Þorsklifur móttekin 21. des",
    "postingStatus": "Open",
    "stockCenterCode": "FROSTI",
    "itemCategoryCode": "",
    "productionType": " ",
    "startingDate": "2025-12-21",
    "endingDate": "2025-12-21",
    "certificationProcess": "Yes",
    "certification": "",
    "lastModified": "2025-12-18T13:46:15.247Z"
}

Delete a Lot

The endpoint is not closed for deleting, but Wisefish will not allow the deletion if any trade items have been created on the Lot.