This API retrieves the list positions of a project from Smart Materials. You can either retrieve a single list position using list position Id or all the list positions of a project.
Required Privilege: API_READONLY
Headers
Header Name |
Description |
Required |
Values |
---|---|---|---|
Authorization |
Access token |
Required |
Bearer <access_token> |
Content-Type |
Request type format |
Required |
application/JSON |
Body
URL Format: GET https://{host}/Smat/V1/Projects(‘:project’)/Disciplines(‘:discipline’)/Nls(‘:language’)/ListPositions({key})
Specify values for the 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 list positions Id (LpId).
To retrieve all the list positions of a project, use the following URL:
GET https://{host}/Smat/V1/Projects(‘:project’)/Disciplines(‘:discipline’)/Nls(‘:language’)/ListPositions
Sample Code
GET https://{host}/Smat/V1/Projects(‘RS’)/Disciplines(‘PIPING’)/Nls(‘English’)/ListPositions(9782)
Success Response
Status: 200 OK
Content:
{
"@odata.context": "https://{host}/Smat/V1/$metadata#Projects('RS')/Disciplines('PIPING')/Nls('English')/ListPositions",
"value":[
{
"LpId":9782,
"LnId":5945,
"StatId":5565,
"ProjId":"RS",
"LstId":5021,
"DpId":5020,
"ListPosition":"10",
"Quantity":10,
"RequisitionInd":"N",
"LoadInd":"Y",
"ParentLpId":null,
"CommodityId":4507598,
"PartId":500244,
"UnitId":500127,
"Ident":14640871,
"ShortCode":null,
"ItyId":500018,
"ListSubPosition":null,
"Input1":"A10",
"Input2":"B2",
"Input3":"S-20",
"Input4":"S-STD",
"Input5":"0",
"ResvQty":0,
"TagNumber":null,
"FahId":null,
"GroupId":500054,
"IssueQty":0,
"Weight":null,
"WeightUnitId":null,
"PlateId":null,
"LockInd":"N"
}]
}
Element |
Description |
Type |
---|---|---|
LpId |
Unique ID of the retrieved list position |
Integer |
LnId |
Unique ID of the list node. Retrieved list position belongs to this node. |
Integer |
StatId |
Unique ID of the associated issue status |
Integer |
ProjId |
Unique ID of the Project. Retrieved list positions belong to this Project. |
String |
LstId |
Unique ID of the list status |
Integer |
DpId |
Unique ID of the Discipline. Retrieved list positions belong to this Discipline. |
Integer |
ListPosition |
Unique position with this structure-element |
String |
Quantity |
Ident - quantity of the list position |
Decimal |
RequisitionInd |
Allowed values are Y and N.
|
String |
LoadInd |
Allowed values are Y and N.
|
String |
ParentLpId |
Unique ID of the parent list position |
Integer |
CommodityId |
Unique ID of the commodity code |
Integer |
PartId |
Unique ID of the commodity part |
Integer |
UnitId |
Unique ID of the unit |
Integer |
Ident |
Ident number |
Integer |
ShortCode |
Specifies the short code |
String |
ItyId |
Unique ID of the item type |
Integer |
ListSubPosition |
Sub positions of the list position |
String |
Input (1-5) |
Value for size 1 to 5 |
String |
ResvQty |
Reserved quantity set by the Forecast Run |
Decimal |
TagNumber |
Tag number |
String |
FahId |
Unique ID of the Forecast header |
Integer |
GroupId |
Unique ID of the commodity group |
Integer |
IssueQty |
Issued quantity |
Decimal |
Weight |
Specifies weight for position of current node |
Decimal |
WeightUnitId |
Specifies unit of weight for position of current node |
Integer |
PlateId |
Unique ID of the plate |
Integer |
LockInd |
String |