1. Integration Playbooks for Procurement
  2. REST APIs (Outbound) for Supplier Model

REST APIs (Outbound) for Supplier Model

Use the Oracle Supplier Model REST APIs to retrieve information relating to entities such as suppliers, contacts, addresses, business classifications, bank accounts, and sites.

Key Features

  • Use Suppliers REST APIs for real-time integration requirements.
  • Use Suppliers REST APIs to achieve end-to-end process orchestration.
  • Perform BATCH operations to execute multiple GET operations in a single call.
  • You can use these Oracle Fusion Cloud Financials REST resources to retrieve:
    • External Payees REST resource: Supplier payment attributes.
    • External Party Payment Methods REST resource: Supplier payment methods.
    • External Bank Accounts and Instrument Assignments REST resources: Supplier bank accounts.
    • Taxpayer Identifiers, Tax Registrations, Third Party Fiscal Classifications, Third Party Site Fiscal Classifications, Tax Exemptions, Third-Party Tax Reporting Code Associations, Third-Party Site Tax Reporting Code Associations REST resources: Supplier transaction tax attributes.

Best Practices

  • Use this option only if you need to perform near real-time mode operations.
  • Use the Oracle Visual Builder Add-in for Excel, which lets you retrieve data using Microsoft Excel. It's an intuitive option that you can use instead a REST client.
  • For better performance:
    • Limit the number of attributes using the fields query parameter while performing GET operations whenever it's supported.
    • Avoid OR conditions with LIKE clauses.
    • Use the limit and offset query parameters to specify how many records to return, and which batch of records to return. When exporting large amounts of data, these query parameters are required to retrieve the next batch of records because the maximum number of records you can retrieve at once within a single batch is 500.
  • Handle timeouts and other generic errors intelligently at the integration point to avoid leaving generic exceptions unmanaged.

Constraints

  • JSON format only.
  • You can't retrieve child entities at three or more levels with the main record. For example, third-party payments can't be retrieved directly using the supplier number. Instead, you first must retrieve the site details using the supplier, and then retrieve the third-party payments for the site.

Related Topics