Transfer
The transfer function of the API is used to move the items of a work order between the different stages of the shop floor.
URL:{Root URL}/api/shopfloortracking/transfer/{API KEY}
Parameter |
Description |
Required |
Comment |
WoNo |
Work Order Number |
Y |
|
FromDeptNumber |
From Department Number |
Y |
Department number where the product is being transferred from. Must be a whole number with no decimals. |
FromDeptKey |
From Department Key |
Y |
Department Key where the product is being transferred from |
FromDeptUniqueRec |
From Department Unique Record |
Y |
Department Unique Record where the product is being transferred from |
ToDeptNumber |
To Department Number |
Y |
Department Number where the product is being transferred to. Must be a whole number with no decimals. |
ToDeptKey |
To Department Key |
Y |
Department Key where the product is being transferred to |
ToDeptUniqueRec |
To Department Unique Record |
Y |
Department Unique Record where the product is being transferred to |
transferQty |
Transfer Quantity |
Y |
Amount to be transferred |
serialNo |
Serial Number |
N |
Required if the part is serialized |
fromActvKey |
From Activity Key |
N |
Activity level where the part is being transferred from. Only needed if the work order has activity tracking turned on. |
toActvKey |
To Activity Key |
N |
Activity level where the part is being transferred to. Only needed if the work order has activity tracking turned on. |
WKey |
Warehouse Unique Record Identifier |
N |
Used to identify FGI when transferring to and from FGI. Required for a FGI transfer. If you have multiple locations, you will be able to provide 'Warehouse' and 'Location' if location is needed and the system will find the Wkey for you. |
Example requests
Transfer, no lot code, no serialization
URL- ?Wono=WONO&fromDeptNumber=1&toDeptNumber=2&transferQty=1
JSON
{
'WoNo':'WONO',
'fromDeptNumber':'1',
'toDeptNumber':'2',
'transferQty':'1'
}
Transfer serialized
URL-?wono=WONO&fromDeptNumber=1&toDeptNumber=2&TransferQty=1&SerialNo=000000000000000000000000000000
JSON
{
'WoNo':'WONO',
'fromDeptNumber':'1',
'toDeptNumber':'2',
'TransferQty':'1',
'SerialNo':'000000000000000000000000000000'
}
A successful transfer returns the following
{
"$id":"1",
"Code":200,
"Message":"Shop Floor Tracking transfer successfull.",
"SessionId":null,
"IsValidUser":true,
"ResponseObject":null
}
Common Errors
API Key Error
If there is an error with the API key the system will return an error describing it.
{
"$id": "1",
"Code": 403,
"Message": "Invalid API Key.",
"SessionId": null,
"IsValidUser": false,
"ResponseObject": null
}
JSON or URL Error
If there is an error with the URL used or some part of the JSON string the system will return a HTTP error.
{
"$id": "1",
"Message": "No HTTP resource was found that matches the request URI 'http://localhost/api/ShopFlooTracking/Transfer/123456789?won=4101'.",
"MessageDetail": "No type was found that matches the controller named 'ShopFlooTracking'."
}
Invalid Work Center
If one of the entered work centers is incorrect or does not exist for the work order then the system will return an error describing an invalid work center.
{
"$id": "1",
"Code": 403,
"Message": "Failed:The From and To Work Center/Activity (number/deptkey/uniquerec/actvkey) is not valid.",
"SessionId": null,
"IsValidUser": true,
"ResponseObject": null
}
Bad Work Order
If the entered work order is invalid or does not exist the system will return an error message describing the Work Order error.
{
"$id": "1",
"Code": 403,
"Message": "Failed:The Work Order Number does not exists.",
"SessionId": null,
"IsValidUser": true,
"ResponseObject": null
}
Permissions
The user needs the following checked on ManexCloud for permissions in order to use this API.
"Ignore Forced Routing Steps" needs to be checked for the user. See image below
|