1. REST API for Oracle Fusion Cloud Procurement
  2. Tasks
  3. Supplier Negotiations
  4. Suppliers

Create one supplier

post

/fscmRestApi/resources/11.13.18.05/supplierNegotiations/{supplierNegotiationsUniqID}/child/suppliers

Request

Path Parameters
  • This is the hash key of the attributes which make up the composite key for the Supplier Negotiations resource and used to uniquely identify an instance of Supplier Negotiations. The client should not generate the hash key value. Instead, the client should query on the Supplier Negotiations collection resource in order to navigate to a specific instance of Supplier Negotiations to get the hash key.
Header Parameters
  • 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".
  • 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.
  • Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
Nested Schema : Access Restrictions
Type: array
Title: Access Restrictions
The Access Restrictions resource manages details about negotiation lines where supplier access is restricted.
Show Source
Nested Schema : schema
Type: object
Show Source
  • Title: Line
    Maximum Length: 25
    Number that identifies the negotiation line.
  • Value that uniquely identifies the negotiation line.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • 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".
  • 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.
Body ()
Root Schema : supplierNegotiations-suppliers-item-response
Type: object
Show Source
  • Title: Acknowledged By
    Read Only: true
    Maximum Length: 255
    Name of the supplier contact who acknowledged whether they would participate in the negotiation.
  • Title: Acknowledgment Date
    Read Only: true
    Value that indicates the time when the supplier acknowledged whether they would participate in the negotiation.
  • Title: Note to Buyer
    Read Only: true
    Maximum Length: 4000
    Value that indicates the reason provided by the supplier for participating or not participating in the negotiation.
  • Title: Additional Email
    Maximum Length: 240
    Email address of the additional contact for each invited supplier.
  • Read Only: true
    Value that uniquely identifies the negotiation.
  • Read Only: true
    Maximum Length: 80
    Display name of the business relationship of the supplier's enterprise. Values include None, Prospective, and Spend Authorized.
  • Title: Business Relationship
    Read Only: true
    Maximum Length: 30
    Abbreviation that identifies the business relationship of the supplier's enterprise. Values include NONE, PROSPECTIVE, and SPEND_AUTHORIZED. A list of accepted values is defined in the lookup type ORA_POZ_BUSINESS_RELATIONSHIP.
  • Title: Conversion Rate
    Read Only: true
    Rate at which the negotiation currency equals one response currency.
  • Read Only: true
    Maximum Length: 64
    User who created the supplier.
  • Read Only: true
    Date and time when the user created the supplier.
  • Read Only: true
    Date and time when the user most recently updated the supplier.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the supplier.
  • Links
  • Title: Notify All Contacts
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then notifications are sent to all contacts of the supplier. If false, notifications are sent only to the invited contact or additional email of the supplier. The default value is false.
  • Read Only: true
    Contains one of the following values: true or false. If true, the price precision is read-only. If false, the price precision is editable.
  • Title: Price Precision
    Read Only: true
    Number of decimal places that the application displays for price attributes in the response.
  • Read Only: true
    Contains one of the following values: true or false. If true, the conversion rate is read-only. If false, the conversion rate is editable.
  • Read Only: true
    Maximum Length: 80
    Display name of the status of the supplier's registration request. Values include Approved, Not Submitted, Pending Approval, and Rejected.
  • Read Only: true
    Maximum Length: 30
    Abbreviation that identifies the status of the supplier's registration request. Values include APPROVED, DRAFT, PENDING, and REJECTED.
  • Maximum Length: 240
    Name of the supplier that the application invites to respond to the negotiation. Applies during approval pending.
  • Name of the contact at the supplier that the application invites to respond to the negotiation. Applies during approval pending.
  • Value that identifies the contact at the supplier that the application invites to respond to the negotiation. Applies during approval pending.
  • Value that identifies the supplier that the application invites to respond to the negotiation. Applies during approval pending.
  • Title: Response Currency
    Read Only: true
    Maximum Length: 80
    Name of currency that the supplier uses in the negotiation response.
  • Title: Response Currency Code
    Read Only: true
    Maximum Length: 15
    Abbreviation that identifies the currency that the supplier uses in the negotiation response.
  • Read Only: true
    Maximum Length: 80
    Display name of the supplier's spend authorization review status. Values include Pending Approval and Rejected.
  • Read Only: true
    Maximum Length: 30
    Abbreviation that identifies the supplier's spend authorization review status. Values include PENDING_APPROVAL and REJECTED. A list of accepted values is defined in the lookup type ORA_POZ_SPEND_AUTH_REV_STATUS.
  • Title: Will Participate
    Read Only: true
    Maximum Length: 1
    Value that indicates whether the supplier intends to participate in the negotiation.
  • Title: Supplier
    Maximum Length: 360
    Name of the supplier company that the application invited to response to the negotiation.
  • Name of the supplier employee who represents the supplier during communication with the buying organization.
  • Value that identifies the supplier employee who represents the supplier during communication with the buying organization.
  • Read Only: true
    Maximum Length: 80
    Display name of the status indicating whether supplier creation was successful after approval. Values include Canceled, Completed, and Error. A list of accepted values is defined in the lookup type POZ_SUPPLIER_CREATION_STATUS.
  • Read Only: true
    Maximum Length: 30
    Abbreviation that identifies the status indicating whether supplier creation was successful after approval. Values include CANCELED, COMPLETED, and ERROR. A list of accepted values is defined in the lookup type POZ_SUPPLIER_CREATION_STATUS.
  • Read Only: true
    Maximum Length: 255
    Display name of the supplier's sourcing eligibility status. Values include Eligible, Not eligible, and Eligible with warning.
  • Read Only: true
    Maximum Length: 255
    Abbreviation that identifies the supplier's sourcing eligibility status. Values include ALLOWED, NOT_ALLOWED, and WARNING. A list of accepted values is defined in the lookup type ORA_POQ_SOURCING_ELIGIBILITY.
  • Value that identifies the supplier company that the application invited to respond to the negotiation.
  • Read Only: true
    Value that uniquely identifies the supplier invited to the negotiation.
  • Access Restrictions
    Title: Access Restrictions
    The Access Restrictions resource manages details about negotiation lines where supplier access is restricted.
  • Read Only: true
    Number that identifies the supplier that the application invited to respond to the negotiation.
  • Read Only: true
    Value that uniquely identifies the supplier company.
  • Title: Supplier Responses
    Read Only: true
    Number of active responses submitted by a supplier.
  • Title: Supplier Site
    Maximum Length: 240
    Name of the supplier site.
  • Value that identifies the supplier site.
  • Read Only: true
    Number that uniquely identifies the supplier.
  • Title: Supplier Number
    Read Only: true
    Maximum Length: 30
    Number that identifies the supplier and may be visible to the buying organization.
Nested Schema : Access Restrictions
Type: array
Title: Access Restrictions
The Access Restrictions resource manages details about negotiation lines where supplier access is restricted.
Show Source
Nested Schema : supplierNegotiations-suppliers-supplierLineAccessRestrictions-item-response
Type: object
Show Source
Links
supplierLineAccessRestrictions
Parameters:
  • SupplierInvitationId: $request.path.SupplierInvitationId
  • supplierNegotiationsUniqID: $request.path.supplierNegotiationsUniqID
The Access Restrictions resource manages details about negotiation lines where supplier access is restricted.
Back to Top

Examples

This example describes how to create a supplier.

Example cURL Command

Use the following cURL command to submit a request on the REST resource.

curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.resourceitem+json" -d 'request payload' 
"https://servername/fscmRestApi/resources/version/supplierNegotiations/supplierNegotiationsUniqID/child/suppliers"

Example Request Body

The following example includes the contents of the request body in JSON format:
{
    "Supplier": "Tall Manufacturing",
    "SupplierId": 35320,
    "SupplierSite": "Atlanta",
    "SupplierSiteId": 5298,
    "SupplierContact": "Smith, Timothy",
    "SupplierContactId": 299802,
    "NotifyAllSupplierContactsFlag": true
}

Example Response Body

The following example includes the contents of the response body in JSON format:
{
    "AuctionHeaderId": 300100179439813,
    "SupplierInvitationId": 10,
    "SupplierNumber": 641,
    "Supplier": "Tall Manufacturing",
    "SupplierId": 35320,
    "SupplierSite": "Atlanta",
    "SupplierSiteId": 5298,
    "SupplierContact": "Smith, Timothy",
    "SupplierContactId": 299802,
    "AdditionalContactEmail": null,
    "RequestedSupplier": null,
    "RequestedSupplierId": null,
    "RequestedSupplierContact": null,
    "RequestedSupplierContactId": null,
    "ResponseCurrency": null,
    "ResponseCurrencyCode": null,
    "ConversionRate": null,
    "PricePrecision": null,
    "NotifyAllSupplierContactsFlag": true,
    "CreatedBy": "CVBUYER01",
    "CreationDate": "2019-05-22T23:09:10.001+00:00",
    "LastUpdateDate": "2019-05-22T23:09:10.708+00:00",
    "LastUpdatedBy": "CVBUYER01",
    "links": [<Do not change anything here>]
}
Back to Top