1. REST API for Oracle Fusion Cloud Procurement
  2. Tasks
  3. Purchase Requisitions
  4. Lines
  5. Distributions

Create one distribution

post

/fscmRestApi/resources/11.13.18.05/purchaseRequisitions/{purchaseRequisitionsUniqID}/child/lines/{linesUniqID}/child/distributions

Request

Path Parameters
  • This is the hash key of the attributes which make up the composite key for the Lines resource and used to uniquely identify an instance of Lines. The client should not generate the hash key value. Instead, the client should query on the Lines collection resource in order to navigate to a specific instance of Lines to get the hash key.
  • This is the hash key of the attributes which make up the composite key for the Purchase Requisitions resource and used to uniquely identify an instance of Purchase Requisitions. The client should not generate the hash key value. Instead, the client should query on the Purchase Requisitions collection resource in order to navigate to a specific instance of Purchase Requisitions 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 : DFF
Type: array
Show Source
Nested Schema : projectDFF
Type: array
Show Source
  • Discriminator: __FLEX_Context
    Discriminator: { "propertyName":"__FLEX_Context", "mapping":{ "AP_Distribution_Sets":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FDistribution__5FSetsVO-item-post-request", "AP_Invoice_Distribution":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FInvoice__5FDistributionVO-item-post-request", "AP_Invoice_Line":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FInvoice__5FLineVO-item-post-request", "EXM_Expense_Report":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFEXM__5FExpense__5FReportVO-item-post-request", "EXM_Expense_Report_Line":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFEXM__5FExpense__5FReport__5FLineVO-item-post-request", "INV_Misc_Transactions":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFINV__5FMisc__5FTransactionsVO-item-post-request", "OM_Sales_Order":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFOM__5FSales__5FOrderVO-item-post-request", "PJC_All":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPJC__5FAllVO-item-post-request", "PJC_Expenditure_Batch":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPJC__5FExpenditure__5FBatchVO-item-post-request", "POR_Requisition":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPOR__5FRequisitionVO-item-post-request", "POR_User_Preferences":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPOR__5FUser__5FPreferencesVO-item-post-request", "PO_Purchase_Order":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrderVO-item-post-request", "PO_Purchase_Order_Line":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrder__5FLineVO-item-post-request", "PO_Purchase_Order_Schedule":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrder__5FScheduleVO-item-post-request" } }
Nested Schema : schema
Type: object
Show Source
Nested Schema : Discriminator: __FLEX_Context
Type: object
Discriminator: __FLEX_Context

Discriminator Values

Match One Schema
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FDistribution__5FSetsVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FInvoice__5FDistributionVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FInvoice__5FLineVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFEXM__5FExpense__5FReportVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFEXM__5FExpense__5FReport__5FLineVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFINV__5FMisc__5FTransactionsVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFOM__5FSales__5FOrderVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPJC__5FAllVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPJC__5FExpenditure__5FBatchVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPOR__5FRequisitionVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPOR__5FUser__5FPreferencesVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrderVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrder__5FLineVO-item-post-request
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrder__5FScheduleVO-item-post-request
Type: object
Show Source
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 : purchaseRequisitions-lines-distributions-item-response
Type: object
Show Source
Nested Schema : DFF
Type: array
Show Source
Nested Schema : projectDFF
Type: array
Show Source
  • Discriminator: __FLEX_Context
    Discriminator: { "propertyName":"__FLEX_Context", "mapping":{ "AP_Distribution_Sets":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FDistribution__5FSetsVO-item-response", "AP_Invoice_Distribution":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FInvoice__5FDistributionVO-item-response", "AP_Invoice_Line":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FInvoice__5FLineVO-item-response", "EXM_Expense_Report":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFEXM__5FExpense__5FReportVO-item-response", "EXM_Expense_Report_Line":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFEXM__5FExpense__5FReport__5FLineVO-item-response", "INV_Misc_Transactions":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFINV__5FMisc__5FTransactionsVO-item-response", "OM_Sales_Order":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFOM__5FSales__5FOrderVO-item-response", "PJC_All":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPJC__5FAllVO-item-response", "PJC_Expenditure_Batch":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPJC__5FExpenditure__5FBatchVO-item-response", "POR_Requisition":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPOR__5FRequisitionVO-item-response", "POR_User_Preferences":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPOR__5FUser__5FPreferencesVO-item-response", "PO_Purchase_Order":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrderVO-item-response", "PO_Purchase_Order_Line":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrder__5FLineVO-item-response", "PO_Purchase_Order_Schedule":"#/components/schemas/oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrder__5FScheduleVO-item-response" } }
Nested Schema : purchaseRequisitions-lines-distributions-DFF-item-response
Type: object
Show Source
Nested Schema : Discriminator: __FLEX_Context
Type: object
Discriminator: __FLEX_Context

Discriminator Values

Match One Schema
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FDistribution__5FSetsVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FInvoice__5FDistributionVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFAP__5FInvoice__5FLineVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFEXM__5FExpense__5FReportVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFEXM__5FExpense__5FReport__5FLineVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFINV__5FMisc__5FTransactionsVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFOM__5FSales__5FOrderVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPJC__5FAllVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPJC__5FExpenditure__5FBatchVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPOR__5FRequisitionVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPOR__5FUser__5FPreferencesVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrderVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrder__5FLineVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_flex_prc_por_manageReq_restModel_pjcRequisitionDistributions_view_PJCDFFPO__5FPurchase__5FOrder__5FScheduleVO-item-response
Type: object
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Links
DFF
Parameters:
  • RequisitionDistributionId: $request.path.RequisitionDistributionId
  • linesUniqID: $request.path.linesUniqID
  • purchaseRequisitionsUniqID: $request.path.purchaseRequisitionsUniqID
projectDFF
Parameters:
  • RequisitionDistributionId: $request.path.RequisitionDistributionId
  • linesUniqID: $request.path.linesUniqID
  • purchaseRequisitionsUniqID: $request.path.purchaseRequisitionsUniqID
Back to Top

Examples

These examples describe how to create a distribution.

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/purchaseRequisitions/purchaseRequisitionsUniqID/child/lines/linesUniqID/child/distributions"
Example Description
1. Create a distribution for a quantity-based expense line.
2. Create a distribution for an amount-based service line in a budgetary controlled requisitioning BU.

Example 1: Create a Distribution for a Quantity-Based Expense Line

Example 1: Request Body

The following example includes the contents of the request body in JSON format to create a distribution for a quantity-based expense line. This example illustrates how a distribution is created by providing quantity and charge account.

You replace the request payload in the cURL command with the contents of the Example Request Body. The request payload specifies attribute values that the command will use in the record that it creates. 

{ 
    "DistributionNumber":1,
    "Quantity":10,
    "ChargeAccount": "01-510-7530-0000-000"
}

Example 1: Response Body

The following example includes the contents of the response body in JSON format:
{
    "RequisitionDistributionId": 300100549194165,
    "RequisitionLineId": 300100549194164,
    "Quantity": 10,
    "DistributionNumber": 1,
    "ChargeAccountId": 13185,
    "ChargeAccount": "01-510-7530-0000-000",
    "CurrencyAmount": null,
    "CurrencyNonrecoverableExclusiveTax": null,
    "CurrencyRecoverableExclusiveTax": null,
    "ChartOfAccountId": 101,
    "UserAccountOverrideFlag": true,
    "BudgetDate": null,
    "links": [
        . . . 
    ]
}

Example 2: Create a Distribution for an Amount-Based Service Line in a Budgetary Controlled Requisitioning BU

Example 2: Request Body

The following example includes the contents of the request body in JSON format to create a distribution for an amount-based service line in a budgetary controlled requisitioning BU. This example illustrates how a distribution is created by providing amount, charge account, and budget date.

Note:

If budget date is not provided, it will be defaulted to the system date based on the time zone of the Legal Entity of the requisition line's inventory organization when submit requisition custom action is invoked.

You replace the request payload in the cURL command with the contents of the Example Request Body. The request payload specifies attribute values that the command will use in the record that it creates. 

{ 
    "DistributionNumber":1,
    "CurrencyAmount":100,
    "ChargeAccount": "01-510-7530-0000-000",
    "BudgetDate": "2021-11-03"
}

Example 2: Response Body

Here's an example of the response body in JSON format:

{
    "RequisitionDistributionId": 300100549979804,
    "RequisitionLineId": 300100549979803,
    "Quantity": null,
    "DistributionNumber": 1,
    "ChargeAccountId": 13185,
    "ChargeAccount": "01-510-7530-0000-000",
    "CurrencyAmount": 100,
    "CurrencyNonrecoverableExclusiveTax": null,
    "CurrencyRecoverableExclusiveTax": null,
    "ChartOfAccountId": 101,
    "UserAccountOverrideFlag": true,
    "BudgetDate": "2021-11-03",
    "links": [
        . . . 
    ]
}
Back to Top