This API adds inventory items to the specified Material Receiving Report (MRR).
Required Privilege: API_CREATE_INV_RECEIPTS
Headers
Header Name |
Description |
Required |
Values |
---|---|---|---|
Authorization |
Access token |
Required |
Bearer <access_token> |
Content-Type |
Request type format |
Required |
application/JSON |
Body
URL Format: POST http://host/smat/v1/Projects(':project')/Disciplines(':discipline')/Nls(':language')/ ReceivingHeaders({key})/Com.Ingr.Smat.V1.InvReceipts/
Specify values for project, discipline, language, and key parameter in the URL. The project, discipline, and language together, define the project environment and the key parameter defines the Receiving header Id.
Element |
Description |
Type |
Required |
Notes |
---|---|---|---|---|
LocId |
Unique ID of the location |
Decimal |
Optional |
To view available locations, GET https://{host}/Smat/V1/Projects |
WhId |
Unique ID of the warehouse |
Decimal |
Optional |
To view available warehouses, GET https://{host}/Smat/V1/Projects |
BnlId |
Unique ID of the bin location |
Decimal |
Optional |
To view available bin GET https://{host}/Smat/V1/Projects |
SmstId |
Unique ID of the site material status. |
Decimal |
Required |
To view available site GET https://{host}/Smat/V1/Projects( |
ItemShipId |
Unique ID of the Item Shipments and |
Decimal |
Optional |
To view available item shipments, use: GET https://{host}/Smat/V1/Projects |
Ident |
Ident number and is required only |
Decimal |
Optional |
To view available idents, GET https://{host}/Smat/V1/Projects( |
RecvQty |
Quantity received for this item shipment |
Decimal |
Optional |
To know the expected quantity, GET https://{host}/Smat/V1/Projects(':project') |
RecvDate |
Date and time when the material is received |
Date Time Offset |
Optional |
Acceptable format is YYYY-MM-DD. |
UnitId |
Unique ID of the unit |
Decimal |
Optional |
To view available units, GET https://{host}/Smat/V1/Projects( |
TagNumber |
Tag number of the item shipment |
String |
Optional |
|
HeatNumber |
Name of the heat number |
String |
Optional |
To view available heats, GET https://{host}/Smat/V1/Projects |
CertificateNumber |
Certificate Number |
String |
Optional |
You can update a |
Manufacturer |
Name of the manufacturer |
String |
Optional |
You can update a |
FileLocation |
File Location |
String |
Optional |
You can update a |
EsTagShortDesc |
Specifies short description of the TAG |
String |
Optional |
|
EsTagDescription |
Specifies the TAG description |
String |
Optional |
|
ItyCode |
Name of the item type |
String |
Optional |
Sample Code
Example 1, Use following for the MRR by Direct Receive:
POST http://host/smat/v1/Projects('AB')/Disciplines('PIPING')/Nls('English')/ReceivingHeaders(5689)/Com.Ingr.Smat.V1.InvReceipts/
{
"invReceipt":{
"LocId":6783,
"WhId":5921,
"SmstId":5681,
"Ident":73354280,
"RecvQty":500,
"RecvDate":"2016-05-24",
"UnitId":502543,
"TagNumber":"---",
"HeatNumber":"330PLT11 S123 $ H1",
"CertificateNumber":"CERTIFICATE 1",
"Manufacturer":"hcci",
"FileLocation":"",
"EsTagShortDesc":"tag short description",
"EsTagDescription":"tag description",
"ItyCode":"SPOOL"
}
}
Example 2, Use following for the MRR by PO:
POST http://host/smat/v1/Projects Projects('AB')/Disciplines('PIPING')/Nls('English')ReceivingHeaders(5689)/Com.Ingr.Smat.V1.InvReceipts/
{
"invReceipt":{
"LocId":6783,
"WhId":5921,
"RecvQty":500,
"RecvDate":"2016-05-24",
"HeatNumber":"330PLT11 S123 $ H1",
"CertificateNumber":"CERTIFICATE 1",
"Manufacturer":"hcci",
"FileLocation":"",
"EsTagShortDesc":"tag short description",
"EsTagDescription":"tag description",
"ItyCode":"SPOOL",
"SmstId":5681,
"ItemShipId":10000391352
}
}
Success Response
Status: 200 OK
{
"@odata.context": " https://{host}/Smat/V1/$metadata#Edm.Int64",
"value": 10000114458
}
Where value is the Unique ID of the Inventory Receipt (IrpId).