Get one schedule
get
/fscmRestApi/resources/11.13.18.05/purchaseOrderSchedules/{purchaseOrderSchedulesUniqID}
Request
Path Parameters
-
purchaseOrderSchedulesUniqID(required): string
This is the hash key of the attributes which make up the composite key for the Purchase Order Schedules resource and used to uniquely identify an instance of Purchase Order Schedules. The client should not generate the hash key value. Instead, the client should query on the Purchase Order Schedules collection resource in order to navigate to a specific instance of Purchase Order Schedules to get the hash key.
Query Parameters
-
dependency: string
This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2
Format: <attr1>=<val1>,<attr2>=<value2> -
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
-
fields: string
This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2 -
links: string
This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>
Example:
self,canonical -
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
-
Effective-Of:
This header accepts a string value. The string is a semi-colon separated list of
= . It is used to perform effective date range operations. The accepted parameters are RangeMode, RangeSpan, RangeStartDate, RangeEndDate, RangeStartSequence and RangeEndSequence. The parameter values are always strings. The possible values for RangeMode are SET_LOGICAL_START, SET_LOGICAL_END, END_DATE, SET_EFFECTIVE_START, SET_EFFECTIVE_END, REPLACE_CORRECTION, REPLACE_UPDATE, RECONCILE_CORRECTION, CORRECTION, RECONCILE_UPDATE, UPDATE, ZAP and DELETE_CHANGES. The possible values for RangeSpan are PHYSICAL_ROW_END_DATE and LOGICAL_ROW_END_DATE. The values for RangeStartDate and RangeEndDate have to be a string representation of a date in yyyy-MM-dd format. The value for RangeStartSequence and RangeEndSequence must be strings such that when parsed they yield positive integers. -
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : purchaseOrderSchedules-item-response
Type:
Show Source
object-
AcceptedAmount: number
Title:
Accepted AmountRead Only:trueAmount accepted for service lines. -
AcceptedQuantity: number
Title:
Accepted QuantityRead Only:trueQuantity accepted after inspection. -
AccrueAtReceiptFlag: boolean
Title:
Accrue at ReceiptRead Only:trueMaximum Length:1Contains one of the following values: true or false. If true, then accrue the purchase order schedule upon receipt. If false, then do not accrue upon receipt. -
Amount: number
Title:
OrderedRead Only:trueAmount for the service on the purchase order schedule. -
AnticipatedArrivalDate: string
(date)
Title:
Anticipated Arrival DateRead Only:trueDate when the ordered goods are expected to be delivered based on the current projected date of shipping. -
BilledAmount: number
Title:
Invoiced AmountRead Only:trueAmount equivalent of the matched invoice lines based on the purchase price. -
BilledQuantity: number
Title:
Invoiced QuantityRead Only:trueQuantity invoiced against the purchase order schedule. -
Buyer: string
Title:
BuyerRead Only:trueMaximum Length:240Person who is responsible for managing the purchase order. -
BuyerId: integer
(int64)
Read Only:
trueValue that uniquely identifies the buyer. -
Category: string
Title:
Category NameRead Only:trueMaximum Length:2400Name of the purchasing category that the purchase order uses to classify the purchase for the order line. -
CategoryCode: string
Read Only:
trueMaximum Length:820Abbreviation that identifies the purchasing category. -
CategoryId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchasing category. -
ClosedReason: string
Title:
Closed ReasonRead Only:trueMaximum Length:240Text that describes the reason why the schedule was closed. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueDate and time when the buyer or application created the purchase order schedule. -
DocumentStatus: string
Title:
Order StatusRead Only:trueMaximum Length:80Status of the purchase order relative to the purchase order life cycle. -
DocumentStatusCode: string
Title:
Document Status CodeRead Only:trueMaximum Length:25Abbreviation that identifies the purchase order status in the order life cycle. -
DocumentStyle: string
Title:
Document StyleRead Only:trueMaximum Length:240Name of the purchasing document style. This attribute allows organizations to control the parameters and values displayed on the application to match the usage of the purchasing document. -
DocumentStyleId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchasing style of the document. -
DueDate: string
(date)
Title:
Due DateRead Only:trueDate when the goods are requested or promised to deliver. -
FreightTerms: string
Title:
Freight TermsRead Only:trueMaximum Length:80Terms that describe who pays the charges to transport the item. -
FreightTermsCode: string
Title:
Freight Terms CodeRead Only:trueMaximum Length:30Abbreviation that identifies the type of freight terms for the purchase order. -
FundsStatus: string
Title:
Funds StatusRead Only:trueMaximum Length:80Status of the funds check or funds reservation validation result for the schedule. -
FundsStatusCode: string
Title:
Funds StatusRead Only:trueMaximum Length:25Abbreviation that identifies the funds status. -
InvoiceMatchOption: string
Title:
Invoice Match OptionRead Only:trueMaximum Length:80Value that determines whether to match the invoice to the purchase order or the receipt. If the purchase order line is under consignment, then match each invoice to the consumption advice. -
InvoiceMatchOptionCode: string
Title:
Invoice Match Option CodeRead Only:trueMaximum Length:25Determines whether the invoice for the purchase order schedule must match the purchase order or the receipt. Values include C for consumption advice, P for order, or R for receipt. -
ItemDescription: string
Title:
DescriptionRead Only:trueMaximum Length:240Description of the item that the purchase order references. -
ItemId: integer
(int64)
Read Only:
trueValue that uniquely identifies the item on the purchase order. -
ItemNumber: string
Title:
ItemRead Only:trueAbbreviation that uniquely identifies the item on the purchase order. -
ItemOrScheduleDescription: string
Title:
DescriptionRead Only:trueMaximum Length:255Displays either the description of the item or of the work associated with a progress payment schedule. -
LineLocationId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchase order schedule. -
LineNumber: number
Title:
LineRead Only:trueNumber that uniquely identifies the purchase order line. -
LineNumberScheduleNumber: string
Title:
Line - ScheduleRead Only:trueMaximum Length:255Concatenation of the PO line number and the schedule number. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
OrderNumber: string
Title:
OrderRead Only:trueMaximum Length:30Number that uniquely identifies the purchase order in the sold-to legal entity. -
PaymentTerms: string
Title:
Payment TermsRead Only:trueMaximum Length:50Terms that the application uses to schedule payments and calculate due dates, discount dates, and discount amounts for each invoice against the purchase order. -
PaymentTermsId: integer
(int64)
Read Only:
trueValue that uniquely identifies the payment terms. -
POHeaderId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchase order. -
POLineId: integer
(int64)
Read Only:
trueValue that uniquely identifies the parent line of the schedule. This attribute is used when the schedule is split. -
Price: number
Title:
PriceRead Only:truePrice of the purchase order line. -
ProcurementBU: string
Title:
Procurement BURead Only:trueMaximum Length:240Business unit that manages and owns the purchase order. -
ProcurementBUId: integer
(int64)
Read Only:
trueValue that uniquely identifies the business unit that manages and owns the purchase order. -
PurchaseBasis: string
Title:
Purchase BasisRead Only:trueMaximum Length:80Value that indicates whether the schedule is for goods or services. -
PurchaseBasisCode: string
Title:
Purchase Basis CodeRead Only:trueMaximum Length:30Abbreviation that indicates if the schedule is for quantity based purchases or fixed price services. -
Quantity: number
Title:
QuantityRead Only:trueQuantity of the item scheduled to be shipped or delivered. -
ReceivedAmount: number
Title:
Received AmountRead Only:trueAmount received for service lines. -
ReceivedQuantity: number
Title:
Received QuantityRead Only:trueQuantity received against the purchase order schedule. -
RequestedDeliveryDate: string
(date)
Title:
Requested Delivery DateRead Only:trueDate when the buyer requested that the supplier deliver the item. -
RequestedShipDate: string
(date)
Title:
Requested Ship DateRead Only:trueDate when the buyer requested that the supplier ship the item. -
RequisitioningBU: string
Title:
Requisitioning BURead Only:trueMaximum Length:240Business unit that creates the requisition. -
RequisitioningBUId: integer
(int64)
Read Only:
trueValue that uniquely identifies the business unit that creates the requisition. -
RetainageAmount: number
Title:
RetainageRead Only:trueTotal amount withheld as retainage against the schedule. -
RetainageRate: number
Title:
Retainage RateRead Only:truePercentage of the invoice value that can be withheld as retainage. -
RetainageReleasedAmount: number
Title:
Retainage ReleasedRead Only:trueAmount of retainage released for the schedule. -
ScheduleDescription: string
Title:
Schedule DescriptionRead Only:trueMaximum Length:240Description of the work associated with a progress payment schedule. -
ScheduleNumber: integer
Title:
ScheduleRead Only:trueNumber that uniquely identifies the purchase order schedule for the purchase order line. -
ScheduleStatus: string
Title:
StatusRead Only:trueMaximum Length:80Status of the purchase order schedule. -
ScheduleStatusCode: string
Title:
Status CodeRead Only:trueMaximum Length:25Abbreviation that identifies the status of the purchase order schedule. -
ScheduleType: string
Title:
Schedule TypeRead Only:trueMaximum Length:80Value that identifies whether the payment is released based on units of work or lump sum. -
ScheduleTypeCode: string
Read Only:
trueMaximum Length:30Abbreviation that identifies the schedule type. -
ShippedAmount: number
Title:
Shipped AmountRead Only:trueAmount shipped for service lines. -
ShippedQuantity: number
Title:
Shipped QuantityRead Only:trueQuantity shipped against the purchase order schedule. -
ShipToCustomer: string
Title:
Ship-to PartyRead Only:trueMaximum Length:360Name of the party who receives the item that the supplier ships. -
ShipToCustomerId: integer
(int64)
Read Only:
trueValue that uniquely identifies the third party that receives the item. -
ShipToLocation: string
Title:
Ship-to LocationRead Only:trueMaximum Length:240Name of the location where the supplier ships the item. -
ShipToLocationCode: string
Title:
Ship-to Location CodeRead Only:trueMaximum Length:60Abbreviation that identifies the location where the supplier ships the item. -
ShipToLocationId: integer
(int64)
Read Only:
trueValue that uniquely identifies the location where the supplier ships the item. -
SoldToLegalEntity: string
Title:
Sold-to Legal EntityRead Only:trueMaximum Length:240Legal entity that is financially responsible for purchases on the purchase order. -
SoldToLegalEntityId: integer
(int64)
Read Only:
trueValue that uniquely identifies the legal entity that is financially responsible for purchases on the purchase order. -
Supplier: string
Title:
SupplierRead Only:trueMaximum Length:360Name of the supplier who fulfills the item. -
SupplierId: integer
(int64)
Read Only:
trueValue that uniquely identifies the supplier. -
SupplierItem: string
Title:
Supplier ItemRead Only:trueMaximum Length:300Number that the supplier uses to identify the item on the purchase order line. -
SupplierSite: string
Title:
Supplier SiteRead Only:trueMaximum Length:240Location that the supplier uses to purchase the item. -
SupplierSiteId: integer
(int64)
Read Only:
trueValue that uniquely identifies the supplier site. -
Total: number
Title:
TotalRead Only:trueTotal of the ordered amount and the exclusive tax amounts on the purchase order line. -
TotalTax: number
Title:
Total TaxRead Only:trueTotal of the exclusive tax amounts that the purchaser can recover and not recover for the purchase order line. -
UOM: string
Title:
UOMRead Only:trueMaximum Length:25Unit of measure in the item quantity. -
UOMCode: string
Read Only:
trueMaximum Length:3Abbreviation that identifies the unit of measure.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Links
- close
-
Parameters:
- purchaseOrderSchedulesUniqID:
$request.path.purchaseOrderSchedulesUniqID
Closes a purchase order schedule. You can manually close for receiving, close for invoicing, close, or finally close a schedule. - purchaseOrderSchedulesUniqID:
- confirmWork
-
Parameters:
- purchaseOrderSchedulesUniqID:
$request.path.purchaseOrderSchedulesUniqID
Add lines to an existing work confirmation on the progress payment schedule. You can provide the quantity, amount, or percentage of work completed on the schedule for a performance period. - purchaseOrderSchedulesUniqID:
Examples
This example describes how to get one schedule.
Example cURL Command
Use the following cURL command to submit a request on the REST resource:
curl -u username:password "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/purchaseOrderSchedulesUniqID"
For example, the following command gets purchase order schedule where the line location identifier is 300100185985737:
curl -u username:password "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/300100185985737"
Example 1 Response Body
The following shows an example of the response body in JSON
format.
{
"POHeaderId": 300100185985423,
"OrderNumber": "1011589",
"ItemDescription": "test fps",
"Price": null,
"LineNumber": 2,
"SupplierItem": null,
"LineLocationId": 300100185985737,
"ScheduleNumber": 1,
"RequestedDeliveryDate": null,
"ScheduleStatusCode": "CANCELED",
"ClosedReason": null,
"InvoiceMatchOptionCode": "P",
"BilledQuantity": null,
"ShippedQuantity": null,
"ReceivedQuantity": null,
"AcceptedQuantity": null,
"BilledAmount": 0,
"ShippedAmount": 0,
"ReceivedAmount": 0,
"AcceptedAmount": 0,
"SoldToLegalEntity": "Vision Operations",
"UOM": null,
"ScheduleStatus": "Canceled",
"Category": "Miscellaneous_1",
"Buyer": "Furey,Clare",
"InvoiceMatchOption": "Order",
"PaymentTerms": "45 Net (terms date + 45)",
"FreightTerms": "Due",
"ShipToCustomer": null,
"PurchaseBasisCode": "SERVICES",
"ItemNumber": null,
"Total": 0,
"TotalTax": 0,
"PurchaseBasis": "Services",
"Quantity": null,
"Amount": 0,
"ShipToLocation": "V1- New York City",
"DocumentStatus": "Canceled",
"AnticipatedArrivalDate": null,
"CreationDate": "2020-04-15T17:12:01+00:00",
"RequestedShipDate": null,
"Supplier": "CV_SuppA01",
"SupplierSite": "CVSuppA01Site01",
"RetainageRate": null,
"RetainageAmount": null,
"RetainageReleasedAmount": null,
"ProcurementBU": "Vision Operations",
"RequisitioningBU": "Vision Operations",
"DocumentStyle": "Purchase Order",
"links": [
{
"rel": "self",
"href": "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/300100185985737",
"name": "purchaseOrderSchedules",
"kind": "item"
},
{
"rel": "canonical",
"href": "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/300100185985737",
"name": "purchaseOrderSchedules",
"kind": "item"
},
{
"rel": "action",
"href": "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/300100185985737/action/close",
"name": "close",
"kind": "other"
}
]
}Example 2
This example shows how to query additional attributes using the the fields parameter.
Example 2 cURL Command
Use the following cURL command to submit a request on the REST resource:
curl -u username:password "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/100000017965453?fields=OrderNumber,ShipToLocationId,ShipToLocationCode,ShipToLocation,ItemId,CategoryId,SoldToLegalEntityId"
Example 2 Response Body
The following shows an example of the response body in JSON format.
{
"OrderNumber": "1000033",
"ShipToLocationId": 211,
"ShipToLocationCode": "VC - Vision City",
"ShipToLocation": "VC - Vision City",
"ItemId": null,
"CategoryId": 2920,
"SoldToLegalEntityId": 458,
"links": [
{
"rel": "self",
"href": "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/100000017965453",
"name": "purchaseOrderSchedules",
"kind": "item"
},
{
"rel": "canonical",
"href": "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/100000017965453",
"name": "purchaseOrderSchedules",
"kind": "item"
},
{
"rel": "action",
"href": "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/100000017965453/action/close",
"name": "close",
"kind": "other"
},
{
"rel": "action",
"href": "https://servername/fscmRestApi/resources/version/purchaseOrderSchedules/100000017965453/action/confirmWork",
"name": "confirmWork",
"kind": "other"
}
]
}