What is the REST API payload to create a supplier in Oracle Fusion?

POST /suppliers — REST payload to create a supplier | Oracle Fusion REST example

POST /suppliers — REST payload to create a supplier

REST APIOracle Fusion · Procurement · SuppliersHigh confidenceCurated

The Suppliers REST resource creates a supplier (POZ_SUPPLIERS). Minimum body: Supplier (name), SupplierType and TaxOrganizationType. Sites, addresses, contacts and bank accounts are added as child resources or in follow-up calls.

Endpoint

POSThttps://<your-fusion-host>/fscmRestApi/resources/11.13.18.05/suppliers

Purpose

Create a supplier record. HTTP POST, Content-Type application/json. The response returns the generated SupplierId and SupplierNumber. Address and site creation follow via /suppliers/{SupplierId}/child/addresses and /child/sites.

Parameters

SupplierrequiredSupplier name — must be unique.

SupplierTyperequirede.g. 'Supplier' or 'Individual'.

TaxOrganizationTyperequirede.g. 'Corporation', 'Individual', 'Partnership'.

BusinessRelationshipe.g. 'SPEND_AUTHORIZED' or 'PROSPECTIVE'. Optional; defaults to prospective.

Example request

Request

{
  "Supplier": "Contoso Logistics LLC",
  "SupplierType": "Supplier",
  "TaxOrganizationType": "Corporation",
  "BusinessRelationship": "SPEND_AUTHORIZED",
  "SupplierParty": "Contoso Logistics LLC",
  "AliasName": "Contoso"
}

Example response

Response

{
  "SupplierId": 300000456789012,
  "SupplierNumber": "1042",
  "Supplier": "Contoso Logistics LLC",
  "SupplierType": "Supplier",
  "TaxOrganizationType": "Corporation",
  "Status": "ACTIVE",
  "links": [
    { "rel": "self", "href": ".../suppliers/300000456789012" },
    { "rel": "child", "name": "addresses", "href": ".../suppliers/300000456789012/child/addresses" },
    { "rel": "child", "name": "sites", "href": ".../suppliers/300000456789012/child/sites" }
  ]
}