Function
The Kit Issue API is used to issue parts from a warehouse into a kit.
URL
{Root URL}/API/Kit/Issue?{API Key} |
Parameters
Parameter | Description | Required | Comment | |
1 | WoNo | Work order number | N | |
2 | KASEQNUM | Unique kitting record identifier | Y | |
3 | WKey | Pick from warehouse key | Y | |
4 | PickQty | Amount being picked | Y | |
5 | IssuedSerialNo | Serial number for picked part | N | Required if the part is serialized. |
6 | IssuedSerialUniq | Unique serial identifier | N | Can be used in place of IssuedSerialNo. |
7 | OverIssuedSerialNo | Serial number for over-issued quantity | N | Required only if there is an over-issued quantity. |
8 | OoverIssuedSerialUniq | Unique serial identifier for over-issued quantity | N | Required only if there is an over-issued quantity. |
9 | LotCode | Lot code | N | Required if the part is lot coded. |
10 | ExpDate | Expiration date and time | N | Required if the part is lot coded. Format example, 2018-08-08 00:00:00 |
11 | Reference | Issued reference | N | Required if the part is lot coded. Format example, month/day/year |
12 | PoNum | Purchase order number | N | Part of the lot code Identification, which will not be empty if the part was received via purchase order. But, can be left empty if the part was received through general receiving. |
13 | IpKeyUnique | IP key | N |
Example Strings
Kit Issue
URL
?KASEQNUM=KASEQNUM&WKey=WKEY&PickQty=QTY |
JSON
{ “KASEQNUM”:”KASEQNUM”, “WKey”:”WKEY”, “PickQty”:”QTY” } |
A successful request returns the following:
{ "$id": "1", "Code": "200", "Message": "Kit issue successfull.", "SessionId": "null", "IsValidUser": "true", "ResponseObject": "null" } |
Common Errors
URL Error
If there is an issue with the URL, the system should return an error message showing that there is a problem with the URL:
{ "$id": "1", "Message": "No HTTP resource was found that matches the request URI 'http://localhost/api/Kit/Pick/123456789'.", "MessageDetail": "No action was found on the controller 'Kit' that matches the request." } |
Not Enough Quantity
If there is not enough quantity in the warehouse to issue, the system will return a "Not Enough Quantity" error:
{ "$id": "1", "Code": "403", "Message": "Failed:Not enough quantity to pick.", "SessionId": "null", "IsValidUser": "true", "ResponseObject": "null" } |
Incorrect Parameter
If one of the parameters entered is incorrect, the system will return an error code describing which parameter has the error:
{ "$id": "1", "Code": "403", "Message": "Failed:KaMain record does not exists for Kaseqnum provided.", "SessionId": "null", "IsValidUser": "true", "ResponseObject": "null" } |