Integrate and Extend Procurement Using REST Resources

In this update, Oracle Fusion Cloud Procurement and Oracle Fusion Cloud Self Service Procurement deliver new and modified REST resources to enable and simplify integration with external systems.

The new REST resources introduced in this update are:

  • Purchase Agreement Acknowledgments
  • Supplier Configuration Options
  • Supplier Entity Configurations
  • Supplier Negotiation Awards
  • Supplier Negotiation Purchasing Documents
  • Supplier Details
  • Supplier Negotiation Contracts
  • Contract Type List of Values
  • Requisitioning Business Units List of Values

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

  • Purchase Requisitions
    • Use the Replace custom action to replace a requisition line with a single catalog line or multiple lines from a punchout supplier.
    • Use the Parse and Validate Punchout Cart custom action on data received from punchout suppliers before passing the data to the Replace action.
  • Purchase Orders
    • Use the Apply Discount custom action to apply a header level discount to a purchase order.
  • Supplier Negotiations
    • Use the new Contract Term Changes child resource to fetch a summary of the changes made to the contract terms associated with a negotiation document.
    • Use the new Contract Term Templates child resource to fetch changes made to the terms template associated with a negotiation that can be used for version comparison.
    • Use the Uptake Latest Revision custom action to update the existing requirements in a draft negotiation with the latest version of the predefined question.
    • Use the Generate Add Lines Spreadsheet and Import Lines Spreadsheet custom actions to export the template and add lines and line details such as Price Breaks, Price Tiers, External Cost Factors, and Line Attributes in a draft negotiation.
    • Use the Add from Cost Factor List custom action to add a set of External Cost Factors to a line when creating the negotiation.
    • Use the Add Contract Terms, Download Contract Terms and Remove Contract Terms custom actions to add, download and remove contract terms in a negotiation document.
    • Use the Apply Latest Template custom action to apply latest terms to a business document. This action retrieves and applies the latest terms template version from the terms library to the business document.
    • Use the Open Scoring and Close Scoring custom actions to open, reopen, and  close team scoring in a negotiation.
    • Use the Submit Response Scores custom action to submit the scores for one or all responses.
    • Use the Submit Award for Approval custom action to submit the award decision for approval.
    • Internal cost factors are now supported
      • Use Internal Cost Factors child resource to add internal cost factors at the supplier response level and update cost factor values through the resource Internal Cost Factor Values.
      • Use the Line Default Internal Cost Factors child resource to define internal cost factors that will automatically apply to newly created negotiation lines.
      • Use the Line Internal Cost Factors child resource resource to add internal cost factors to a negotiation line and update cost factor values through the resource Line Internal Cost Factor Values.
      • Use the Initialize Internal Cost Factor Values custom action so that you can update the values for the cost factors.
      • Use the Calculate Transformed Values custom action to recalculate transformed amounts and overall ranks only when internal cost factor values are updated after the negotiation is published.
  • Supplier Negotiation Responses
    • PATCH is supported on the Supplier Negotiation Responses resource to add Internal Note.
    • PATCH is supported on the Requirements child resource to provide Score and add Internal Note for the requirement response.
    • GET, POST, PATCH, and DELETE are supported on the Scoring Attachments child resource.
    • Team scoring is now supported
      • PATCH is supported on the Team Member Score Details child resource to add an Internal Note.
      • PATCH is supported on the Team Member Requirement Scores child resource to provide Score and add Internal Note for the requirement.
      • Use the Initialize Team Member Scoring custom action so that you can update the scores for the requirement.
      • Use the Override Score custom action to override the system calculated overall score or composite score. Use the Reset Overridden Score custom action to revert the user overridden score to the system calculated overall score or composite score.
  • Supplier Initiatives
    • Use the new Questionnaires child resource to manage initiative questionnaires.
    • PATCH and DELETE are supported for Supplier Initiatives, Qualification Areas, and Suppliers resources.
    • DELETE is supported for Evaluation Team Members.
    • Use the Duplicate custom action to create an initiative by copying an existing one.
    • Use the Validate custom action to check for errors associated with the initiative.
    • Use the Cancel custom action to cancel any questionnaires, qualifications and assessments associated with the initiative.

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 and Configure

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.

Key Resources

Access Requirements

Refer to the Privileges section in the REST API for Oracle Fusion Cloud Procurement documentation, available on the Oracle Help Center.