Commerce Transaction Line REST APIs

Overview

Commerce Transaction Line REST APIs provide access to transaction line data. If you are using a custom process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information. Additionally, the action names may vary and you may not see all of the action endpoints listed below.

Administration

ClosedCustom Process Endpoint Parameters

Commerce REST APIs use the following resource paths for the standard process:

  • Main document /commerceDocumentsOraclecpqoTransaction

  • Sub document /commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine

The following variable may differ for custom processes:

  • {Stage} The stage variable identifies where a transaction is within the Commerce process flow. (Documents, Quotes, Agreements, or Orders) e.g. Documents

  • {ProcessVarName} The variable name of the commerce process, note the first letter must be capitalized. e.g. Oraclecpqo

  • {MainDocVarName} The variable name of the main document, note the first letter must be capitalized. e.g. Transaction

  • {id} The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site. e.g. 36365444

  • {subDocVarName} The sub-document number e.g. transactionLine

Commerce REST APIs use the following resource paths for the standard process:

  • Main document /commerceDocumentsOraclecpqoTransaction

  • Sub document /commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine

The following variable may differ for custom processes:

  • {Stage} The stage variable identifies where a transaction is within the Commerce process flow. (Documents, Quotes, Agreements, or Orders) e.g. Documents

  • {ProcessVarName} The variable name of the commerce process, note the first letter must be capitalized. e.g. Oraclecpqo

  • {MainDocVarName} The variable name of the main document, note the first letter must be capitalized. e.g. Transaction

  • {id} The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site. e.g. 36365444

  • {subDocVarName} The sub-document number e.g. transactionLine


ClosedAdd Transaction Lines

Add Transaction LinesPost method

Description

Use this endpoint to add line items to the specified transaction.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/actions/addLineItem_t

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

HTTP Method

POST

Request Body Parameters

cacheInstanceId

The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first create Transaction or Open Transaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.

criteria

The query definition for the current resource request.

delta

The boolean parameter to request a delta response for data as well as state in the context of current criteria.

documents

The transaction object

revisionId

The revision Id

selectionMode

Indicating how selections content should be interpreted, supported values are:

  • Content of the 'selections' parameter, or

  • 'ResultSetExceptSelected' - all entries in result set except those listed in 'selections' parameter

selections

An array of selected line items

skipIntegration

If the value for 'skipIntegration' is true, integration tab logic is skipped, otherwise(value is false or absent) it is executed.

Response Body Parameters

cacheInstanceId

The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first create Transaction or Open Transaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.

destinationURL

The destination url as defined in destination tab in action definition.

documents

The transaction object

layoutVariableName

The string parameter that contains selected redwood layout's variable name.

revsionId

The string parameter that contains the revision information.

warnings

Array of messages that have been generated for a specific object.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/3022920645/actions/addLineItems_t


ClosedRequest Sample

{ "cacheInstanceId": "c9eG836AOqcI35aHa0p3yqcE3se8HQu50W0FJWk57SZt8IzWMZzXUpOkSQa8iECV", "documents": { "_price_book_var_name": "_default_price_book", "transactionLine": { "items": [{ "_part_number": "part1", "_price_book_var_name": "_default_price_book" } ] } }, "revisionId": "2,0" }


ClosedResponse Sample

{ "revisionId": "3,0", "documents": { "totalOneTimeListAmount_t": { "value": 0.0, "currency": "USD" }, "oRCL_ERP_CPQSourceSystemCode_t": "ORA_BM_CPQ", "_customer_id": "account112", "_eSignatureAttributeSet_esig_file_attachment": { "fileName": null, "fileType": null, "fileID": null, "isFileSaved": false, "fileLocation": "http://sitename.oracle.com/rest/v19/commerceProcesses/oraclecpqo/documents/18351533/attachmentAttributes/_eSignatureAttributeSet_esig_file_attachment/transactions/3022920645/documentNumbers/1" }, "_invoiceTo_t_state": { "displayValue": "Arkansas", "value": "Arkansas" }, "_invoiceTo_t_city": "Little Rock", "transactionTotalDiscountPercent_t": 0.0, "_customer_t_state": { "displayValue": "Arkansas", "value": "Arkansas" }, "totalContractValue_t": { "value": 0.0, "currency": "USD" }, "oRCL_SFDC_Probability_t": null, "_date_modified": "2023-03-02T08:09:58.000Z", "_invoiceTo_t_email": "Bill.Jones@email.com", "_customer_t_address": "401 Main Street", "oRCL_ERP_OrgID_t": "999", "_soldTo_t_state": null, "hasRecurringPricing_t": false, "oRCL_ERP_IntegrationStatusText_t": null, "taxExemptReason_t": null, "totalAnnualCostAmount_t": { "value": 0.0, "currency": "USD" }, "_shipTo_t_last_name": null, "oRCL_ERP_ERPSystem_t": null, "_invoiceTo_t_company_name_2": "Co.", "proposalPreparedByEmail_t": null, "_soldTo_t_zip": null, "_soldTo_t_fax": null, "_customer_t_country": { "displayValue": "United States", "value": "United States" }, "totalOneTimeNetAmount_t": { "value": 0.0, "currency": "USD" }, "bs_id": "3022920645", "currentStepForTesting_tempDisplay_t": "start_step", "_submitted_by_submit_t": "", "_customer_t_email": "Bill.Jones@email.com", "oRCL_SFDC_Stage_t": null, "oRCL_SFDC_Product1000IDs_t": null, "opportunityNumber_t": null, "oRCL_SFDC_CloseDate_t": null, "customerPartySiteID_t": null, "totalContractDiscount_t": { "value": 0.0, "currency": "USD" }, "priceWithinPolicy_t": true, "_soldTo_t_first_name": null, "totalOneTimeCostAmount_t": { "value": 0.0, "currency": "USD" }, "_invoiceTo_t_company_name": "Apple", "statusDate_t": null, "_reject_link": "", "customerID_t": "account112", "_soldTo_t_country": null, "_shipTo_t_zip": null, "_shipTo_t_fax": null, "_customer_t_company_name": "Apple", "userKey_t": "CPQ-16v1", "totalContractCostAmount_t": { "value": 0.0, "currency": "USD" }, "priceExpirationDate_t": null, "_transaction_total": { "value": 0.0, "currency": "USD" }, "annualContractListValue_t": { "value": 0.0, "currency": "USD" }, "approve_reject_icon_submit_t": null, "oRCL_ERP_OrderID_t": null, "soldToCustomerAccountID_t": null, "_customer_t_city": "Little Rock", "totalOneTimeMarginAmount_t": { "value": 0.0, "currency": "USD" }, "_eSignatureAttributeSet_esig_date_modified": null, "coverLetter_t": null, "proposalPreparedByName_t": null, "transactionName_t": null, "statusPartial_t": false, "_pp_id": 18355578, "_document_number": "1", "proposalPreparedByTitle_t": null, "oRCL_ERP_SoapRequest_t": null, "shipToPartySiteID_t": null, "_shipTo_t_phone": null, "owner_t": "Super User", "_soldTo_t_email": null, "_invoiceTo_t_first_name": "Bill", "_customer_t_zip": "60081", "_customer_t_fax": "555-555-5678", "currency_t": { "displayValue": "USD", "value": "USD" }, "totalMonthlyListAmount_t": { "value": 0.0, "currency": "USD" }, "totalContractListValue_t": { "value": 0.0, "currency": "USD" }, "_eSignatureAttributeSet_esig_status": { "displayValue": "Not Sent", "value": "Not Sent" }, "shipToPartyID_t": null, "_soldTo_t_company_name": null, "_shipTo_t_first_name": null, "_invoiceTo_t_country": { "displayValue": "United States", "value": "United States" }, "version_t": 1, "_shipTo_t_company_name": null, "proposalPreparedByPhone_t": null, "_price_book_var_name": "_default_price_book", "_currency_pref": { "id": 14619668, "currencyCode": "USD", "links": [{ "rel": "domain", "href": "http://sitename.oracle.com/rest/v19/currencies" }, { "rel": "canonical", "href": "http://sitename.oracle.com/rest/v19/currencies/USD" } ] }, "_shipTo_t_address": null, "totalOneTimeDiscount_t": { "value": 0.0, "currency": "USD" }, "totalMonthlyNetAmount_t": { "value": 0.0, "currency": "USD" }, "winLossStatus_t": { "displayValue": "In Progress", "value": "IN PROGRESS" }, "lastUpdatedDate_t": "2023-03-02T07:07:00Z", "_document_var_name": "transaction", "_invoiceTo_t_address": "401 Main Street", "_customer_t_phone": "555-555-5678", "lastPricedDate_t": "2023-03-02T07:07:00Z", "lastUpdatedBy_t": "Super User", "oRCL_SFDC_UserID_t": null, "oRCL_ERP_OrderNumber_t": null, "_soldTo_t_city": null, "paymentTerms_t": null, "createdDate_t": "2023-03-01", "oRCL_SFDC_Product200IDs_t": null, "approval_status_submit_t": null, "oRCL_INT_ExchangeRate_t": null, "transactionDescription_t": null, "totalMonthlyCostAmount_t": { "value": 0.0, "currency": "USD" }, "oRCL_SFDC_Product800IDs_t": null, "_date_added": "2023-03-02T07:07:25.000Z", "oRCL_SFDC_Product600IDs_t": null, "oRCL_SFDC_Product400IDs_t": null, "_invoiceTo_t_phone": "555-555-5678", "oRCL_ERP_PartialShipAllowed_t": false, "customerPartyID_t": null, "_shipTo_t_state": null, "proposalPreparedByCell_t": null, "_soldTo_t_address_2": null, "invoiceToPartyID_t": null, "_process_var_name": "oraclecpqo", "_invoiceTo_t_zip": "60081", "createdBy_t": "Super User", "_soldTo_t_last_name": null, "oRCL_INT_TargetCurrency_t": { "displayValue": "USD", "value": "USD" }, "invoiceToPartySiteID_t": null, "oRCL_ERP_ReservationStatus_t": null, "_eSignatureAttributeSet_esig_envelope_id": null, "transactionID_t": "CPQ-16", "taxExempt_t": false, "_buyer_company_name": "phoenix87575", "opportunityName_t": null, "totalMonthlyDiscount_t": { "value": 0.0, "currency": "USD" }, "_invoiceTo_t_fax": "555-555-5678", "_shipTo_t_email": null, "parent_transaction_id_versionTransaction_t": null, "opportunityID_t": null, "fulfillmentStatus_t": null, "_soldTo_t_phone": null, "_eSignatureAttributeSet_esig_recipients": null, "oRCL_ERP_IntegrationStatus_t": "0_revertToDefault", "approval_history_submit_t": null, "soldToPartySiteID_t": null, "_customer_t_last_name": "Jones", "salesChannel_t": null, "totalAnnualValue_t": { "value": 0.0, "currency": "USD" }, "transactionTotalDiscount_t": { "value": 0.0, "currency": "USD" }, "transactionListTotal_t": { "value": 0.0, "currency": "USD" }, "_shipTo_t_city": null, "_shipTo_t_country": null, "defaultRequestDate_t": null, "priceScore_t": 9, "oRCL_ERP_AvailabilityCheckDate_t": null, "transactionMarginPercent_t": 0.0, "purchaseOrderNumber_t": null, "_last_document_number": 15, "_approve_link": "", "_customer_t_address_2": "Unit 55", "requireApprovalIfChecked_temporary_t": false, "_id": 3022920645, "_invoiceTo_t_address_2": "Unit 55", "oRCL_ERP_SoapResponse_t": null, "_shipTo_t_company_name_2": null, "soldToPartyID_t": null, "oRCL_SFDC_TransactionID_t": null, "totalAnnualMarginAmount_t": { "value": 0.0, "currency": "USD" }, "_shipTo_t_address_2": null, "_step_var_name": null, "_soldTo_t_company_name_2": null, "transactionMarginTotal_t": { "value": 0.0, "currency": "USD" }, "TotalAnnualDiscount_t": { "value": 0.0, "currency": "USD" }, "_soldTo_t_address": null, "_invoiceTo_t_last_name": "Jones", "totalContractMarginAmount_t": { "value": 0.0, "currency": "USD" }, "_customer_t_company_name_2": "Co.", "approval_revision_submit_t": 1, "_supplier_company_name": "phoenix87575", "version_number_versionTransaction_t": "1", "_customer_t_first_name": "Bill", "transactionCostTotal_t": { "value": 0.0, "currency": "USD" }, "totalMonthlyMarginAmount_t": { "value": 0.0, "currency": "USD" }, "_pp_name": "Admin", "status_t": { "displayValue": "Created", "value": "CREATED" }, "transactionLine": { "hasMore": false, "links": [{ "rel": "self", "href": "http://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/3022920645/transactionLine" } ], "items": [{ "_line_bom_attributes": null, "listAmount_l": { "value": 5.0, "currency": "USD" }, "discountAmount_l": { "value": 0.0, "currency": "USD" }, "contractStartDate_l": null, "requestedQuantity_l": 5, "_model_partner_entity_id": null, "_config_attributes": { "value": null }, "oRCL_ERP_ReservationDate_l": null, "oRCL_ERP_FifthOverridePeriod_l": null, "oRCL_ERP_ThirdOverrideAmount_l": null, "_part_display_number": "Part Display 1", "_model_attributes": { "value": null }, "_price_list_price_each": { "value": 1.0, "currency": "USD" }, "_line_bom_effective_date": null, "includedInBasePrice": null, "_parent_line_item": null, "_date_modified": "2023-03-02T08:09:58.000Z", "oRCL_ERP_SecondRecurringInvoiceDate_l": null, "rootAssetKey_l": null, "annualMargin_l": { "value": 0.0, "currency": "USD" }, "_model_product_line_attributes": { "value": null }, "_price_configurable_price": { "value": 1.0, "currency": "USD" }, "oRCL_ERP_FirstOverrideAmount_l": null, "costAmount_l": { "value": 0.0, "currency": "USD" }, "_is_part_pricing_rule_price": false, "contractEndDate_l": null, "_last_modified_date": "2023-03-02 00:09:58", "parentLineID_l": null, "_config_extra_info": null, "oRCL_ERP_ThirdOverridePeriod_l": null, "unitMargin_l": { "value": 1.0, "currency": "USD" }, "canChangeQuantity_l": false, "oRCL_ERP_FifthOverrideAmount_l": null, "_part_number": "part1", "_sequence_number": 1, "_line_bom_display_name": null, "taxExemptReason_l": null, "unitCost_l": { "value": 0.0, "currency": "USD" }, "_price_unit_price_each": { "value": 1.0, "currency": "USD" }, "actualAmount_l": { "value": 0.0, "currency": "USD" }, "_model_base_price": null, "customDiscountValue_l": null, "_model_product_line_name": null, "_price_item_price_each": { "value": 1.0, "currency": "USD" }, "_transaction_currency_pref": { "id": 14619668, "currencyCode": "USD" }, "oRCL_ABO_ComponentAttributes_l": null, "_price_override_discount": { "displayValue": "None", "value": "None" }, "priceWithinPolicy_l": true, "_model_supplier_company_id": null, "_model_segment_id": null, "displayedItemName_l": null, "oRCL_ERP_FourthOverridePeriod_l": null, "_partner_entity_id": null, "statusPartial_l": false, "_part_custom_field14": "Custom Field 14, part1", "_part_custom_field15": "Custom Field 15, part1", "requestDate_l": null, "_part_custom_field16": null, "_part_base_price": { "value": 1.0, "currency": "USD" }, "_part_custom_field17": null, "_part_custom_field10": "Custom Field 10, part1", "_part_custom_field11": "Required value", "oRCL_SFDC_ExternalID_l": "2-3022920645", "contractMargin_l": { "value": 5.0, "currency": "USD" }, "_part_custom_field12": null, "pricePeriod_l": null, "_part_custom_field13": "Custom Field 13, part1", "_model_partner_organization_id": null, "_part_custom_field9": "100K Parts", "_model_segment_name": null, "statusDate_l": null, "firstRecurringInvoiceDate_l": null, "_part_custom_field3": null, "_part_custom_field4": null, "_part_custom_field1": "String", "priceType_l": { "displayValue": "One Time", "value": "One Time" }, "_part_custom_field2": "Value 1", "_part_custom_field20": "Custom Field 20, part1", "_part_custom_field7": 0.0, "_part_custom_field8": null, "_part_custom_field5": 0.0, "_part_custom_field6": 0.0, "_config_attr_info": { "value": null }, "_part_custom_field25": "Custom Field 25, part1", "_part_custom_field26": "Custom Field 26, part1", "_part_custom_field27": "Custom Field 27, part1", "_part_custom_field28": null, "_part_custom_field21": "Custom Field 21, part1", "contractValue_l": { "value": 5.0, "currency": "USD" }, "_part_custom_field22": "Custom Field 22, part1", "_part_custom_field23": "Custom Field 23, part1", "oRCL_ERP_CancellationEffectiveDate_l": null, "_part_custom_field24": "Custom Field 24, part1", "_price_net_price": { "value": 5.0, "currency": "USD" }, "_prior_price": null, "customDiscountAmount_l": { "value": 0.0, "currency": "USD" }, "_parent_doc_number": null, "_part_custom_field18": "Custom Field 18, part1", "_part_custom_field19": "Custom Field 19, part1", "_reconfiguration_date": "1970-01-01 00:00:00", "annualCost_l": { "value": 0.0, "currency": "USD" }, "_part_desc": null, "_pp_id": 18355578, "_document_number": 2, "_price_discount_percent": 0.0, "oRCL_ERP_InventoryAvailability_l": { "displayValue": "Not Checked", "value": "Not Checked" }, "oRCL_ERP_ReservationQuantity_l": null, "_rollup_delta_price": null, "_is_bom_price": false, "winLossStatus_l": { "displayValue": "In Progress", "value": "IN PROGRESS" }, "_price_calculation_info": "[]", "oRCL_ERP_RequestShipDate_l": "2023-03-02", "_price_component_prices": { "value": null }, "_part_supplier_company_id": "4118171", "_original_document_number": "-1", "contractListValue_l": { "value": 5.0, "currency": "USD" }, "_line_item_spare_rule_var_name": null, "_part_id": "8523072", "_part_company_associations": null, "oRCL_ERP_BillingInstr_l": null, "lineID_l": "2", "marginPercent_l": 100.0, "_price_book_var_name": "_default_price_book", "_price_subtotal": { "value": 5.0, "currency": "USD" }, "customDiscountType_l": null, "_group_sequence_number": "1.0", "lastUpdatedDate_l": null, "_price_quantity": 5, "lastUpdatedBy_l": "Super User", "_part_supplier_company_name": "phoenix87575", "_document_var_name": "transactionLine", "oRCL_SFDC_SynchronizationID_l": null, "createdDate_l": "2023-03-02T08:09:00Z", "contractCost_l": { "value": 0.0, "currency": "USD" }, "actualQuantity_l": null, "oRCL_ERP_PackingInstr_l": null, "contractDiscount_l": { "value": 0.0, "currency": "USD" }, "_line_bom_name": null, "_model_is_valid": false, "canChangeConfiguration_l": false, "_config_attr_text": { "value": null }, "itemInstanceName_l": null, "_line_bom_model_path": null, "_model_id": null, "_date_added": "2023-03-02T08:09:58.000Z", "_model_product_line_id": null, "parentLineNumber_l": null, "requestedUnitOfMeasure_l": null, "_configuration_id": null, "_part_custom_field30": "Custom Field 30, part1", "_model_bom": null, "contractedPeriods_l": 1, "createdBy_l": "Super User", "fulfillmentStatus_l": null, "_model_variable_name": null, "_part_custom_field29": null, "_model_product_line_var_name": null, "_is_recommended_price": false, "oRCL_ERP_FourthOverrideAmount_l": null, "annualListValue_l": { "value": 0.0, "currency": "USD" }, "_line_bom_id": null, "_model_supplier_company_name": null, "oRCL_ERP_ReservationStatus_l": null, "oRCL_ERP_SecondOverrideAmount_l": null, "taxExempt_l": false, "transactionID_l": "3022920645", "_line_bom_part_number": "part1", "itemInstanceId_l": null, "oRCL_ERP_ShippingInstr_l": null, "_line_bom_item_quantity": 1, "oRCL_ERP_ShipSet_l": null, "annualDiscount_l": { "value": 0.0, "currency": "USD" }, "_model_segment_var_name": null, "_line_bom_level": null, "_bs_id": 3022920645, "customerItemName_l": null, "_price_total_discount": { "value": 0.0, "currency": "USD" }, "netAmount_l": { "value": 5.0, "currency": "USD" }, "oRCL_ERP_SecondOverridePeriod_l": null, "_part_units": null, "_part_direct_buy": "1", "oRCL_ABO_ActionCode_l": null, "oRCL_ERP_FirstOverridePeriod_l": null, "_line_bom_parent_id": null, "priceScore_l": 9, "_line_item_type": "Standard Item", "_delta_price": null, "_line_display_name": "Part Display 1", "netPrice_l": { "value": 1.0, "currency": "USD" }, "oRCL_ERP_SecondBillingPeriodStartDate_l": null, "oRCL_ERP_LineID_l": null, "listPrice_l": { "value": 1.0, "currency": "USD" }, "_part_extended_desc_2": "Extended description 2 for part1", "_part_extended_desc_1": "Extended description 1 for part1", "statusQuantity_l": null, "_is_line_item_mandatory": false, "_id": 3022920673, "oRCL_ERP_AvailableQuantity_l": null, "_part_lead_time": "N/A", "lineNumber_l": null, "status_l": { "displayValue": "Created", "value": "CREATED" }, "_line_item_comment": null, "_price_discount_comment": null, "_line_bom_sequence_index": null, "_step_var_name": null, "_price_override_price": { "displayValue": "No", "value": "No" }, "_model_name": null, "_config_attr_values": null, "_part_drawing_position": null, "_pricing_rule_price_each": { "value": 0.0, "currency": "USD" }, "_price_override_quantity": false, "oRCL_ERP_ShippingCharges_l": null, "_line_bom_variable_name": "configIntegrationRoot", "marginAmount_l": { "value": 5.0, "currency": "USD" }, "oRCL_ERP_ReservationID_l": null, "annualValue_l": { "value": 0.0, "currency": "USD" }, "_pp_name": "Admin", "_line_bom_condition_index": null, "links": [{ "rel": "self", "href": "http://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/3022920645/transactionLine/2" }, { "rel": "parent", "href": "http://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/3022920645" } ] }, { "_line_bom_attributes": null, "listAmount_l": { "value": 20.0, "currency": "USD" }, "discountAmount_l": { "value": 0.0, "currency": "USD" }, "contractStartDate_l": null, "requestedQuantity_l": 10, "_model_partner_entity_id": null, "_config_attributes": { "value": null }, "oRCL_ERP_ReservationDate_l": null, "oRCL_ERP_FifthOverridePeriod_l": null, "oRCL_ERP_ThirdOverrideAmount_l": null, "_part_display_number": "Part Display 2", "_model_attributes": { "value": null }, "_price_list_price_each": { "value": 2.0, "currency": "USD" }, "_line_bom_effective_date": null, "includedInBasePrice": null, "_parent_line_item": "part1", "_date_modified": "2023-03-02T08:09:58.000Z", "oRCL_ERP_SecondRecurringInvoiceDate_l": null, "rootAssetKey_l": null, "annualMargin_l": { "value": 0.0, "currency": "USD" }, "_model_product_line_attributes": { "value": null }, "_price_configurable_price": { "value": 2.0, "currency": "USD" }, "oRCL_ERP_FirstOverrideAmount_l": null, "costAmount_l": { "value": 0.0, "currency": "USD" }, "_is_part_pricing_rule_price": false, "contractEndDate_l": null, "_last_modified_date": "2023-03-02 00:09:58", "parentLineID_l": "2", "_config_extra_info": null, "oRCL_ERP_ThirdOverridePeriod_l": null, "unitMargin_l": { "value": 2.0, "currency": "USD" }, "canChangeQuantity_l": false, "oRCL_ERP_FifthOverrideAmount_l": null, "_part_number": "part2", "_sequence_number": 2, "_line_bom_display_name": null, "taxExemptReason_l": null, "unitCost_l": { "value": 0.0, "currency": "USD" }, "_price_unit_price_each": { "value": 2.0, "currency": "USD" }, "actualAmount_l": { "value": 0.0, "currency": "USD" }, "_model_base_price": null, "customDiscountValue_l": null, "_model_product_line_name": null, "_price_item_price_each": { "value": 2.0, "currency": "USD" }, "_transaction_currency_pref": { "id": 14619668, "currencyCode": "USD" }, "oRCL_ABO_ComponentAttributes_l": null, "_price_override_discount": { "displayValue": "None", "value": "None" }, "priceWithinPolicy_l": true, "_model_supplier_company_id": null, "_model_segment_id": null, "displayedItemName_l": null, "oRCL_ERP_FourthOverridePeriod_l": null, "_partner_entity_id": null, "statusPartial_l": false, "_part_custom_field14": "Custom Field 14, part2", "_part_custom_field15": "Custom Field 15, part2", "requestDate_l": null, "_part_custom_field16": null, "_part_base_price": { "value": 2.0, "currency": "USD" }, "_part_custom_field17": null, "_part_custom_field10": "Custom Field 10, part2", "_part_custom_field11": "Required value", "oRCL_SFDC_ExternalID_l": "3-3022920645", "contractMargin_l": { "value": 20.0, "currency": "USD" }, "_part_custom_field12": null, "pricePeriod_l": null, "_part_custom_field13": "Custom Field 13, part2", "_model_partner_organization_id": null, "_part_custom_field9": "100K Parts", "_model_segment_name": null, "statusDate_l": null, "firstRecurringInvoiceDate_l": null, "_part_custom_field3": null, "_part_custom_field4": null, "_part_custom_field1": "String", "priceType_l": { "displayValue": "One Time", "value": "One Time" }, "_part_custom_field2": "Value 1", "_part_custom_field20": "Custom Field 20, part2", "_part_custom_field7": 0.0, "_part_custom_field8": null, "_part_custom_field5": 0.0, "_part_custom_field6": 0.0, "_config_attr_info": { "value": null }, "_part_custom_field25": "Custom Field 25, part2", "_part_custom_field26": "Custom Field 26, part2", "_part_custom_field27": "Custom Field 27, part2", "_part_custom_field28": null, "_part_custom_field21": "Custom Field 21, part2", "contractValue_l": { "value": 20.0, "currency": "USD" }, "_part_custom_field22": "Custom Field 22, part2", "_part_custom_field23": "Custom Field 23, part2", "oRCL_ERP_CancellationEffectiveDate_l": null, "_part_custom_field24": "Custom Field 24, part2", "_price_net_price": { "value": 20.0, "currency": "USD" }, "_prior_price": null, "customDiscountAmount_l": { "value": 0.0, "currency": "USD" }, "_parent_doc_number": "2", "_part_custom_field18": "Custom Field 18, part2", "_part_custom_field19": "Custom Field 19, part2", "_reconfiguration_date": "1970-01-01 00:00:00", "annualCost_l": { "value": 0.0, "currency": "USD" }, "_part_desc": null, "_pp_id": 18355578, "_document_number": 3, "_price_discount_percent": 0.0, "oRCL_ERP_InventoryAvailability_l": { "displayValue": "Not Checked", "value": "Not Checked" }, "oRCL_ERP_ReservationQuantity_l": null, "_rollup_delta_price": null, "_is_bom_price": false, "winLossStatus_l": { "displayValue": "In Progress", "value": "IN PROGRESS" }, "_price_calculation_info": "[]", "oRCL_ERP_RequestShipDate_l": "2023-03-02", "_price_component_prices": { "value": null }, "_part_supplier_company_id": "4118171", "_original_document_number": "-1", "contractListValue_l": { "value": 20.0, "currency": "USD" }, "_line_item_spare_rule_var_name": null, "_part_id": "8523074", "_part_company_associations": null, "oRCL_ERP_BillingInstr_l": null, "lineID_l": "3", "marginPercent_l": 100.0, "_price_book_var_name": "_default_price_book", "_price_subtotal": { "value": 20.0, "currency": "USD" }, "customDiscountType_l": null, "_group_sequence_number": "1.1", "lastUpdatedDate_l": null, "_price_quantity": 10, "lastUpdatedBy_l": "Super User", "_part_supplier_company_name": "phoenix87575", "_document_var_name": "transactionLine", "oRCL_SFDC_SynchronizationID_l": null, "createdDate_l": "2023-03-02T08:09:00Z", "contractCost_l": { "value": 0.0, "currency": "USD" }, "actualQuantity_l": null, "oRCL_ERP_PackingInstr_l": null, "contractDiscount_l": { "value": 0.0, "currency": "USD" }, "_line_bom_name": null, "_model_is_valid": false, "canChangeConfiguration_l": false, "_config_attr_text": { "value": null }, "itemInstanceName_l": null, "_line_bom_model_path": null, "_model_id": null, "_date_added": "2023-03-02T08:09:58.000Z", "_model_product_line_id": null, "parentLineNumber_l": null, "requestedUnitOfMeasure_l": null, "_configuration_id": null, "_part_custom_field30": "Custom Field 30, part2", "_model_bom": null, "contractedPeriods_l": 1, "createdBy_l": "Super User", "fulfillmentStatus_l": null, "_model_variable_name": null, "_part_custom_field29": null, "_model_product_line_var_name": null, "_is_recommended_price": false, "oRCL_ERP_FourthOverrideAmount_l": null, "annualListValue_l": { "value": 0.0, "currency": "USD" }, "_line_bom_id": null, "_model_supplier_company_name": null, "oRCL_ERP_ReservationStatus_l": null, "oRCL_ERP_SecondOverrideAmount_l": null, "taxExempt_l": false, "transactionID_l": "3022920645", "_line_bom_part_number": "part2", "itemInstanceId_l": null, "oRCL_ERP_ShippingInstr_l": null, "_line_bom_item_quantity": 2, "oRCL_ERP_ShipSet_l": null, "annualDiscount_l": { "value": 0.0, "currency": "USD" }, "_model_segment_var_name": null, "_line_bom_level": null, "_bs_id": 3022920645, "customerItemName_l": null, "_price_total_discount": { "value": 0.0, "currency": "USD" }, "netAmount_l": { "value": 20.0, "currency": "USD" }, "oRCL_ERP_SecondOverridePeriod_l": null, "_part_units": null, "_part_direct_buy": "1", "oRCL_ABO_ActionCode_l": null, "oRCL_ERP_FirstOverridePeriod_l": null, "_line_bom_parent_id": null, "priceScore_l": 9, "_line_item_type": "Standard Item", "_delta_price": null, "_line_display_name": "Part Display 2", "netPrice_l": { "value": 2.0, "currency": "USD" }, "oRCL_ERP_SecondBillingPeriodStartDate_l": null, "oRCL_ERP_LineID_l": null, "listPrice_l": { "value": 2.0, "currency": "USD" }, "_part_extended_desc_2": "Extended description 2 for part2", "_part_extended_desc_1": "Extended description 1 for part2", "statusQuantity_l": null, "_is_line_item_mandatory": true, "_id": 3022920672, "oRCL_ERP_AvailableQuantity_l": null, "_part_lead_time": "N/A", "lineNumber_l": null, "status_l": { "displayValue": "Created", "value": "CREATED" }, "_line_item_comment": null, "_price_discount_comment": null, "_line_bom_sequence_index": null, "_step_var_name": null, "_price_override_price": { "displayValue": "No", "value": "No" }, "_model_name": null, "_config_attr_values": null, "_part_drawing_position": null, "_pricing_rule_price_each": { "value": 0.0, "currency": "USD" }, "_price_override_quantity": false, "oRCL_ERP_ShippingCharges_l": null, "_line_bom_variable_name": "configIntegrationParentText", "marginAmount_l": { "value": 20.0, "currency": "USD" }, "oRCL_ERP_ReservationID_l": null, "annualValue_l": { "value": 0.0, "currency": "USD" }, "_pp_name": "Admin", "_line_bom_condition_index": null, "links": [{ "rel": "self", "href": "http://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/3022920645/transactionLine/3" }, { "rel": "parent", "href": "http://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/3022920645" } ] }, "links": [{ "rel": "self", "href": "http://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/3022920645" } ] }, "warnings": {}, "cacheInstanceId": "DIDZTgMLAWzyX6fUwJejEfn1xj9fnhiN2UmfR4cLpWPzKbLdeqm35ndhWBcqTX8z", "destinationURL": "http://sitename.oracle.com/commerce/display_company_profile.jsp?action_id=18353692&document_id=18351533&id=3022920645&version_id=18358579&destination_url=" }


ClosedBack to Transaction

Back to TransactionPost method

Description

Use this endpoint to return the user to the transaction page from the line items details page.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/actions/_back

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

HTTP Method

POST

Request Body Parameters

cacheInstanceId

The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first create Transaction or Open Transaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.

criteria

The query definition for the current resource request.

errorCriteria

The error query definition for the current resource request.

revsionId

The string parameter that contains the revision information.

Response Body Parameters

cacheInstanceId

The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first create Transaction or Open Transaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.

destinationURL

The destination url as defined in destination tab in action definition.

documents

The transaction object

layoutVariableName

The string parameter that contains selected redwood layout's variable name.

revsionId

The string parameter that contains the revision information.

warnings

Array of messages that have been generated for a specific object.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/18016533/transactionLine/2/actions/back_l


ClosedResponse Sample


ClosedCalculate Line Item Price

Calculate Line Item PricePost method

Description

Use this endpoint to apply pricing changes for updates to transaction line price attributes.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/actions/_calculate_price_action

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

HTTP Method

POST

Request Body Parameters

cacheInstanceId

The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first create Transaction or Open Transaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.

criteria

The query definition for the current resource request.

delta

The boolean parameter to request a delta response for data as well as state in the context of current criteria.

documents

The transaction object

revisionId

The revision Id

Response Body Parameters

cacheInstanceId

The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first create Transaction or Open Transaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.

documents

The transaction line object

layoutVariableName

The string parameter that contains selected redwood layout's variable name.

revsionId

The string parameter that contains the revision information.

warnings

Array of messages that have been generated for a specific object.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/18016533/ transactionLine/3/actions/_calculate_price_action


ClosedRequest Body Sample

Notes:

  • The following attributes are not allowed: _price_list_price_each, _price_subtotal, _price_net_price, and _price_discount_comment
  • The "Override Price" attribute should be set to "Yes" to allow overrides when invoking the REST to perform recalculation.
  • If "Override Price" is set to "No" and there are new price values, the values will be reset to the original values and returned via the REST API. There will be no warning or error message when new values are provided for recalculation.
  • The recalculated values returned via the REST API are not saved in the database until a modify type action is invoked.

ClosedCopy Transaction Lines

Copy Transaction Lines Post method

Description

Use this endpoint to copy specified transaction lines within the current transaction.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/actions/copyLineItems_t

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

HTTP Method

POST

Request Body Parameters

cacheInstanceId

The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first create Transaction or Open Transaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.

criteria

The query definition for the current resource request.

delta

The boolean parameter to request a delta response for data as well as state in the context of current criteria.

documents

The transaction object

numberOfCopies

An array to specify the number of copies for each line listed in selections.

revisionId

The revision Id

selectionMode

Indicating how selections content should be interpreted, supported values are:

  • Content of the 'selections' parameter, or

  • 'ResultSetExceptSelected' - all entries in result set except those listed in 'selections' parameter

selections

An array of selected line items

Response Body Parameters

cacheInstanceId

The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first create Transaction or Open Transaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.

documents

The transaction object

layoutVariableName

The string parameter that contains selected redwood layout's variable name.

revsionId

The string parameter that contains the revision information.

warnings

Array of messages that have been generated for a specific object.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/18097326/actions/copyLineItems_t


ClosedRequest Body Samples

  1. Copy transaction lines 5 and 3, copy each item once
  2. { "numberOfCopies": [1,1], "selections": ["transactionLine/5", "transactionLine/3"] }

  1. Modify, and then copy transaction lines 5 and 7, copy each item once
  2. { "documents": {"transactionDescription": "Mar31", "transactionLine": { "items": [ {"_document_number": "5", "_price_quantity": "45"}, {"_document_number": "7", "_price_quantity": "45"} ] } }, "numberOfCopies": [1,1], "selections": ["transactionLine/5", "transactionLine/7"] }


ClosedCreate Transaction Line

Create Transaction LinePost method

Description

Use this endpoint to create a transaction line item for the part item, model, or favorite item listed in the request body.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/transactionLine

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

HTTP Method

POST

Request Body Parameters

_favorite_Id

The favorite Id

_model_path

The model path

_part_number

The Part Number to be added to this transaction.

_price_book_var_name

Variable Name of the Price Book used to get the price for this line item.

_price_quantity

The quantity of parts to be added to this transaction.

Response Body

The transaction line data

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/38456469/transactionLine


ClosedRequest Body Samples

Add Unconfigured Model

{ "_part_number": "part1", "_price_quantity": "1", "_price_book_var_name": "_default_price_book", "_model_path": "configvisionVehicles:consumerVehicles:sUV", "_price_quantity": "1", }

Add Favorite Item

{ "_favorite_id": 3023140143 }


ClosedDelete Transaction Line

Delete Transaction LineDELETE method

Description

Use this endpoint to delete the specified transaction line.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

HTTP Method

DELETE

Request Body Parameters

None

Success Response

204 No Content


ClosedDelete Transaction Lines

Delete Transaction Lines Post method

Description

Use this endpoint to delete the specified transaction line(s) from a transaction.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/actions/_remove_transactionLine

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

Request Body Parameters

 

selections

Required, this parameter is used for transaction level actions that support line selection. Selection items are an array of transactionLine/{documentNumber} combinations.

This operation supports the following optional parameters: cacheInstanceId, criteria, delta, documents, revisionId, selectionMode, skipIntegration, and skipRules.
Refer to Request Body Objects for additional information

HTTP Method

POST

Response Body Parameters

cacheInstanceId

The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first create Transaction or Open Transaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.

documents

The transaction object

layoutVariableName

The string parameter that contains selected redwood layout's variable name.

revsionId

The string parameter that contains the revision information.

warnings

Array of messages that have been generated for a specific object.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/actions/_remove_transactionLine


ClosedRequest Sample


ClosedGet Transaction Line Product Association

Get Transaction Line Associated ProductGET Method

Description

Use this endpoint to retrieve an associated product for the specified transaction line.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}}/_productAssociationSet/{_row_number}

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

_row_number

Unique row number to be used to specify the rate plan.
Query Parameters

This endpoint supports the following optional parameters: excludeFieldTypes, fields, limit, offset, orderby, q, and totalResults.
Refer to Manage Collections for additional information.

HTTP Method

GET

Request Body Parameters

None

Success Response

The response contains a collection of the available rate plans for the specified transaction line.

 


ClosedGet Transaction Line Product Associations

Get Transaction Line Associated ProductsGET Method

Description

Use this endpoint to retrieve a list of associated products to the specified transaction line.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/_productAssociationSet

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

Query Parameters

This endpoint supports the following optional parameters: excludeFieldTypes, fields, limit, offset, orderby, q, and totalResults.
Refer to Manage Collections for additional information.

HTTP Method

GET

Request Body Parameters

None

Success Response

The response contains a collection of the available rate plans for the specified transaction line.

 


ClosedGet Available Rate Plan

Get Available Rate PlanGET Method

Description

Use this endpoint to retrieve the specified transaction line available rate plan.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/_availableRatePlanSet/{_row_number}

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

_row_number

Unique row number to be used to specify the rate plan.
Query Parameters

This endpoint supports the optional excludeFieldTypes parameter, refer to Manage Collections for additional information.

HTTP Method

GET

Request Body Parameters

None

Success Response

The response contains the available rate plan integration Id, available rate plan name, available rate plan number, and transaction currency preference.


ClosedGet Available Rate Plans

Get Available Rate PlansGET Method

Description

Use this endpoint to retrieve a list of Available Rate Plans for the specified transaction line.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/_availableRatePlanSet

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

Query Parameters

This endpoint supports the following optional parameters: excludeFieldTypes, fields, limit, offset, orderby, q, and totalResults.
Refer to Manage Collections for additional information.

HTTP Method

GET

Request Body Parameters

None

Success Response

The response contains a collection of the available rate plans for the specified transaction line.


ClosedGet Charge

Get ChargeGET Method

Description

Use this endpoint to retrieve the specified transaction line charge .

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/_chargeSet/{_row_number}

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

_row_number

Unique row number to be used as a charge identifier in an charge set.
Query Parameters

This endpoint supports the optional excludeFieldTypes parameter, refer to Manage Collections for additional information.

HTTP Method

GET

Request Body Parameters

None

Success Response

The JSON data for the requested transaction line charge set.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/38926297/transactionLine/2/_chargeSet/2


ClosedSample Response Body


ClosedGet Charges

Get ChargesGET Method

Description

Use this endpoint to retrieve all charges for the specified transaction line.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/_chargeSet

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

Query Parameters

This endpoint supports the following optional parameters: excludeFieldTypes, expand, fields, limit, offset, orderby, q, and totalResults.

Refer to Manage Collections for additional information

HTTP Method

GET

Request Body Parameters

None

Success Response

The response contains a collection of charge sets for the specified transaction line.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/38926297/transactionLine/2/_chargeSet


ClosedSample Response Body


ClosedGet Transaction Line

Get Transaction LineGET Method

Description

Use this endpoint to retrieve the specified transaction line.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

Query Parameters

This endpoint supports optional excludeFieldTypes and expand parameters.

HTTP Method

GET

Request Body Parameters

None

Success Response

The JSON data for the requested transaction line.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/36365444/transactionLine/2


ClosedSample Response Body


ClosedGet Transaction Lines

Get Transaction LinesGET Method

Description

Use this endpoint to retrieve all transaction lines for the specified transaction.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

Query Parameters

This endpoint supports the following optional parameters:excludeFieldTypes, expand, fields, limit, offset, orderby, q, and totalResults.

Refer to Manage Collections for additional information

HTTP Method

GET

Request Body Parameters

None

Success Response

The JSON data for the requested transaction lines.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/36365444/transactionLine


ClosedInteract - Transaction Line

Interact - Transaction LinePost method

Description

Use this endpoint to modify transaction line attribute values, and optionally trigger auto-update rules without committing or retrieving the latest data from the database. Since this action does not save the transaction line to the CPQ database, it does not affect how other users see the transaction line.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/actions/_interact

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

HTTP Method

POST

Request Body Parameters

 

deleteRows

Used to select specific items for deletion.

focus

The attribute that the user is currently editing. The format matches that of the triggerAttrVarName parameter. If the value of the focus param is empty string, the user will be considered to be focused on no attribute

refreshCache

Allows users to invoke the interact service without prior initiation of a cache instance on the server. Additionally, administrators can pass a new parameter, "refreshCache" = true, to reload the current cache and discard the changes.

triggerAttrVarName

The attribute which trigger the interact action. When the trigger attribute is in current document, it is the variable name of the attribute.

This operation supports the following optional parameters: cacheInstanceId, criteria, delta, documents, and revisionId.
Refer to Request Body Objects for additional information.

Response Body Parameters

The requested cached transaction is returned


ClosedOpen Transaction Line

Open Transaction LinePost method

Description

Use this endpoint to display the Line Items Details for a specified transaction line.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/actions/_open_transactionLine

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

HTTP Method

POST

Request Body Parameters

selections

Required, use to specify the transaction line to open. This action only accepts a single line selection.

selectionNavigation

Use this parameter to navigate between line item detail pages. Supported values are: first, prev, next, and last.

When query parameters are provided, the navigation flow is within the filtered and/or sorted line items.

This operation supports the following optional parameters: cacheInstanceId, criteria, documents, errorCriteria, revisionId, selectionMode, and skipIntegration.
Refer to Request Body Objects for additional information.

Response Body Parameters

The JSON data for the parent transaction, or a subset of transaction items, depending on the input request

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/18094477/actions/_open_transactionLine


ClosedRequest Body Sample

{ "selections": ["transactionLine/3"] }


ClosedRequest Body Sample with Selection Navigation


ClosedPipeline Viewer - Transaction Line

Pipeline Viewer - Transaction LinePost method

Description

Use this endpoint to display rules that are in effect for the current Commerce process. This action returns only transaction line items.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/actions/_pipelineViewer

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

HTTP Method

POST

Request Body Parameters

cacheInstanceId

Optional, only valid cache instance ids are supported. The "-1" value is not supported.

Response Body Parameters

Pipeline Viewer rules and impacted sub-document attributes and actions

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/18016533/transactionLine/2/actions/_pipelineViewer


ClosedRequest Body Sample

{ "cacheInstanceId": "bDYxrCAnUwiVpYXUGDoT1GilCF0CFMPEGTcuKCPER3QFuxHJf33AYtAU1atZItpt" }


ClosedResponse Body Sample

{ "pipelineViewerRules": [{ "name": "Hiding: Unhide Rules- Hiding Panel Subdoc", "type": "Hiding Rule", "components": { "mainDoc": { "attributes": [], "actions": [] }, "subDoc": { "attributes": [ "Hiding Tab 3 Attribute 1 Subdoc [hidingTab3Attribute1Subdoc]", "Hiding Tab 1 Attribute 2 Subdoc [hidingTab1Attribute2Subdoc]", "Hiding Tab 2 Attribute 2 Subdoc [hidingTab2Attribute2Subdoc]", "Hiding Tab 1 Attribute 1 Subdoc [hidingTab1Attribute1Subdoc]" ], "actions": [] } } }, { "name": "Composite Sub Hiding", "type": "Hiding Rule", "components": { "mainDoc": { ... }, "subDoc": { ... } } }, { "name": "Constrain Commerce BOM Attribute Mapping Rules - Float to Float", "type": "Constraint Rule", "components": { "mainDoc": { ... }, "subDoc": { ... } } } ] }


ClosedReconfigure Transaction Line

Reconfigure Transaction LinePost method

Description

Use this endpoint to edit a configuration after its been added to the transaction.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/actions/_reconfigure_action

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

HTTP Method

POST

Request Body Parameters

This operation supports the following optional parameters: cacheInstanceId, criteria, delta, documents, revisionId, selections, selectionMode, and skipIntegration.
Refer to Request Body Objects for additional information.

Response Body

The response contains the "Destination URL", which can be used to launch the product catalog page to select and configure a product.

ClosedURI Endpoint Sample

https://sitename.oracle.com/rest/v19/commerceDocumentsOraclecpqoTransaction/18016533/transactionLine/2/actions/_reconfigure_action


ClosedRequest Body Sample

{
"documents": {"_price_quantity": "20"}
}


ClosedResponse Body Sample


ClosedReconfigure Transaction Line - Inbound

Reconfigure Transaction Line - Inbound Post method

Description

Use this endpoint when saving the reconfiguration of a transaction line.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/actions/_reconfigure_inbound_action

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

HTTP Method

POST

Request Body Parameters

This operation supports the following optional parameters: cacheInstanceId, , revisionId, selections, selectionMode, and skipIntegration.
Refer to Request Body Objects for additional information.

Response Body

The response contains the cache instance Id, revision Id, and warnings.


ClosedSave Transaction Line

Save Transaction Line Post method

Description

Use this endpoint to save the current state of the line item to the database.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/TransactionLine/{documentNumber}/actions/save_l

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

documentNumber

The sub-document number

HTTP Method

POST

Request Body Parameters

This endpoint supports the following optional parameters: cacheInstanceId, criteria, deleteRows, delta, documents, revisionId, selections, selectionMode, skipIntegration, and skipRules.

Refer to Request Body Objects for additional information

Response Body

The JSON data for the saved transaction.


ClosedUpdate Transaction Lines

Update Transaction Line Post method

Description

This operation modifies transaction line details and updates the existing transaction.

URI Endpoint

/rest/v19/commerceDocumentsOraclecpqoTransaction/{id}/actions/_update_line_items

Endpoint Parameters

Note: If you are using a custom commerce process your endpoints may vary, refer to Custom Process Endpoint Parameters for more information.

id

The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site.

HTTP Method

POST

Request Body Parameters

This endpoint supports the following optional parameters: cacheInstanceId, criteria, delta, documents, revisionId, selections, selectionMode, and skipIntegration.

Refer to Request Body Objects for additional information.

Response Body

JSON data for the transaction, including the updated transaction line

ClosedURI Endpoint Sample


Related Topics

Related Topics Link IconSee Also