Integrate and Extend Procurement Using REST Resources

In this release, Oracle Fusion Cloud Procurement delivers modified REST APIs to enable and simplify integration with external systems.

The following REST resources were previously available, and have been updated:

  • Draft Purchase Orders
    • Use the new Configuration Components child resource to manage and retrieve the components that are associated with a configured item. A configured item is a unique item created by a customer who selected which options are desired as part of the finished product.
    • Use the Add Contract Terms custom action to add contract terms to a purchase order. You can either add a Terms Template or an Attached Document as a contract source for contract terms.
    • Use the Apply Latest Terms custom action to apply the latest terms template version from the terms library to a purchase order. This action can performed only when the contract source is a Terms Template.
    • Use the Change Contract Source custom action to change the source of contract terms on a purchase order. For example, you change the contract source on a purchase order from Terms Template to Attached Document.
    • Use the Remove Contract Terms custom action to remove contract terms from a purchase order. When you perform this action, contract terms and all associated contract documents are removed from the purchase order.
    • GET, POST, DELETE, PATCH supported for Contracts documents associated with contract terms on a purchase order.
    • GET, POST, DELETE, PATCH supported for Supporting documents associated with contract terms on a purchase order.
    • GET is supported to retrieve details of the contract terms template used on a purchase order.
  • Purchase Orders
    • Use the new Configuration Components child resource to manage and retrieve the components that are associated with a configured item. A configured item is a unique item created by a customer who selected which options are desired as part of the finished product.
    • GET is supported for the following purchase order line attributes to support the Redwood pages: Configured Item Flag, Base Model, Base Model Price and Options Price.
    • GET is supported to retrieve details of the contract terms template used on a purchase order.
    • GET is supported to retrieve the contract documents that are associated with a purchase order, such as an approval abstract or other materials related to the contract terms.
    • GET is supported to retrieve the contract supporting documents that are associated with a purchase order and are related to the contract terms.
  • Purchase Agreements
    • New child resources added in this release include:
      • Attachments for Agreements
      • Attachments for Lines
      • Flexfields for Lines
      • Flexfields for Item Attributes
      • Attachments for Price Breaks
      • Flexfields for Price Breaks
    • Use the View PDF custom action to download PDF content of a purchase agreement in Base64 format.
    • Use the Duplicate custom action to copy a purchase agreement, including its header, lines, controls, contract terms, and attachments.
    • Use the Hold custom action to place a purchase agreement on hold, preventing release against the purchase agreement.
    • Use the Remove Hold custom action to release a purchase agreement from hold status, allowing release against the purchase agreement.
    • Use the Communicate Purchase Agreement custom action to communicate a purchase agreement to the supplier by email, fax, or print.
    • Use the Freeze custom action on purchase agreement to prevent changes or additions while maintaining the ability to release against the purchase agreement.
    • Use the Unfreeze custom action on purchase agreement to allow changes back on the agreement.
    • Use the Cancel custom action to cancel a purchase agreement when the agreement is no longer required.
    • Use the Finally Close custom action to permanently close a purchase agreement and prevent further activity.
    • Use the View Master Contract custom action to download PDF content of the master contract that's associated to the purchase agreement. The content is downloaded in Base64 format.
    • GET is supported to retrieve details of the contract terms template used on a purchase agreement.
    • GET is supported to retrieve the contract documents that are associated with a purchase agreement, such as an approval abstract or other materials related to the contract terms.
    • GET is supported to retrieve the contract supporting documents that are associated with a purchase agreement and are related to the contract terms.
  • Purchase Agreement Lines
    • New child resources added in this release include:
      • Attachments for Lines
      • Flexfields for Lines
      • Flexfields for Item Attributes
      • Attachments for Price Breaks
      • Flexfields for Price Breaks
  • Purchasing Document Versions
    • GET is supported to retrieve the document history of all actions such as submit, create a change order, approve, or reject that's performed on a purchase agreement.
  • Supplier Negotiations
    • Use the Duplicate Negotiation custom action to duplicate a negotiation.
    • Use the Add from Attribute List custom action to add attributes to a negotiation line from a predefined attribute list in a Draft negotiation.
    • Use the Equalize or Clear Attribute Weights custom actions to automatically apply equal weights or clear existing weights to the attributes on a line when defining scoring criteria in a draft negotiation.
    • Use the Add Question and Add QualificationAreas custom actions to add predefined questions and qualification areas to a draft negotiation.
    • PATCH is supported for current price in active negotiations.
    • POST, PATCH and DELETE are supported to add, update or delete internal requirements in active negotiations.
    • POST and DELETE are supported for negotiation header attachments, line attachments and requirement attachments in active negotiations.
    • Use the Manage Abstract And Negotiation PDF custom action to post and withdraw negotiation abstracts, include or exclude the negotiation PDF on abstract, post and withdraw response tabulation, and award notice.
    • Use the Add Requirement Branch custom action to add a branching requirement to an existing requirement's acceptable response value.
    • Use the Add Questions Branch custom action to add a branching predefined question to an existing requirement's acceptable response value.
    • Use the Open Scoring and Close Scoring custom actions to either open or close scoring by evaluation team members.
    • Use the custom actions Generate Add Lines Spreadsheet and Import Lines Spreadsheet to export lines and import lines in a spreadsheet.
    • Use the Validate and Publish Negotiation custom action to validate or publish a draft negotiation.
    • Use the Supplier Activity Summary Attributes resource to fetch a summary of activities performed by supplier on a negotiation.
    • Use the Supplier Activities resource to fetch details of all activities performed by suppliers on a negotiation.
    • Use the Lock Supplier and Unlock Supplier custom actions to lock a supplier out from accessing a negotiation, or allow back the access.
    • Use the Calculate Team Scoring Progress custom action to calculate scoring progress for a collaboration team, and use the Calculate Team Member Scoring Progress to calculate scoring progress for a collaboration team member.
    • Use the Team Member Score Details child resource to fetch the details of scoring for all responses for a scoring team member.
  • Draft Supplier Negotiation Responses
    • PATCH is supported for Response Date Value, Response Number Value and Response Text Value attributes for the Line Attributes resource so that suppliers can respond to line attributes.
    • PATCH is supported for Response Value attribute in Cost Factors so that suppliers can respond to line cost factors.
    • PATCH is supported for Minimum Quantity, Maximum Quantity and Price attributes in Quantity Based Price Tiers so that suppliers can respond to quantity-based price tiers for the line.
    • PATCH is supported for Ship To Location, Ship To Organization, Quantity, Pricing Basis, Response Value, Price Break Start Date and Price Break End Date attributes so that suppliers can respond to line price breaks.
    • POST and DELETE are supported to add or remove price breaks and quantity-based price tiers when responding to line.
    • PATCH is supported for Proxy Decrement so that supplier can set an automatic price decrement to apply in a proxy bid or automatic bid.
    • PATCH is supported for Proxy Decrement and Proxy Minimum at line level so that supplier can set an automatic price decrement and limit price for the line when creating a response.
    • Use Cancel Proxy custom action to cancel automatic bidding for lines in auctions.
  • Supplier Qualifications
    • PATCH is supported for Qualification Responses and Descriptive Flexfields.
    • POST and DELETE are supported for Qualification Attachments.
    • Use the Finalize custom action to finalize a qualification.
    • Use the Cancel custom action to cancel a qualification.

You can use these new and modified REST resources to simplify integrations and support standards-based interoperability with your other applications and external systems.

Steps to Enable

Review the REST service definition in the REST API guides to leverage (available from the Oracle Help Center > your apps service area of interest > APIs & Schema). If you are new to Oracle's REST services you may want to begin with the Quick Start section.