Update Transaction Lines

post

/rest/v7/commerceDocuments{ProcessVarName}{MainDocVarName}/{_id}/actions/_update_line_items

This operation modifies Transaction Line details and updates the existing Transaction.

Request

Path Parameters
  • The variable name of the main document, the first letter must be capitalized
  • The variable name of the Commerce process, the first letter must be capitalized
  • Current unique user-side ID. This is the internal identifier for a transaction within a CPQ site.
Body ()
Root Schema : commerceTransaction-UpdateLineItemsRequest
Type: object
Show Source
  • Title: Cache Instance Id
    The unique identifier for the entry of transaction data stored in the cache. This typically is obtained from first createTransaction or OpenTransaction action and passed along in subsequent Modify/Interact action to avoid reload transaction data from db.
  • Title: Delta
    When the delta parameter is enabled and an action is invoked, only the data and state properties that have changed from the cache image are included in the response. Delta data is only calculated for the requested criteria.
  • commerceTransaction
  • selections
  • Title: Skip Integration
    When this parameter is passed in the payload as true, system will not run the integration XSLs. If the parameter is not present in the request, default behavior will be to run the integration XSLs.
Nested Schema : commerceTransaction
Type: object
Show Source
Nested Schema : selections
Type: array
Show Source
Nested Schema :
Type: object
Title:
Show Source
Nested Schema : Customer Country
Type: object
Title: Customer Country
Name of the country associated with the customer address.
Show Source
Nested Schema : Customer State
Type: object
Title: Customer State
Name of the state associated with the customer address.
Show Source
Nested Schema : eSignature File Attachment[eSignature Attribute Set]
Type: object
Title: eSignature File Attachment[eSignature Attribute Set]
The File Attachment attribute holds the documents to be sent to the eSignature Vendor
Nested Schema : eSignature Status (eSignature Attribute Set)
Type: object
Title: eSignature Status (eSignature Attribute Set)
The Status field contains the current status of this document
Show Source
Nested Schema : Invoice To Country
Type: object
Title: Invoice To Country
Name of the country on the invoice address.
Show Source
Nested Schema : Invoice To State
Type: object
Title: Invoice To State
Name of the state on the invoice address.
Show Source
Nested Schema : Ship To Country
Type: object
Title: Ship To Country
Name of the country associated with the shipping address.
Show Source
Nested Schema : Ship To State
Type: object
Title: Ship To State
Name of the state associated with the shipping address.
Show Source
Nested Schema : Sold To Country
Type: object
Title: Sold To Country
Name of the country associated with the Sold To party.
Show Source
Nested Schema : Sold To State
Type: object
Title: Sold To State
Name of the state associated with the Sold To party.
Show Source
Nested Schema : state
Type: object
Title: state
Captures the current state of the resource row. Of available properties, only those that are applicable and whose values are known in the current context are included.
Show Source
  • Actions
    Title: Actions
    Captures the current state of each action whose state was requested. The object contains one property per action, where the property name is the variable name for the action.
  • Attributes
    Title: Attributes
    Captures the current state of each attribute whose state was requested. The object contains one property per group, where the property name is the resource field name for the attribute.
  • Title: Deletable
    Boolean value that specifies whether the row can be deleted.
  • Groups
    Title: Groups
    Captures the current state of each group whose state was requested. The object contains one property per group, where the property name is the expression string that uniquely identifies the group.
  • Title: Has Error
    Boolean value that specifies whether any error that occurred has been assigned to the row itself.
  • Title: Has Warning
    Boolean value that specifies whether any warning that was issued has been assigned to the row itself.
  • Title: Hidden
    Boolean value that specifies whether the row can be hidden.
  • Messages
    Title: Messages
    Array of messages that have been generated for a specific object.
  • Title: Updatable
    Boolean value that specifies whether the row can be updated.
Nested Schema : Transaction Total
Type: object
Title: Transaction Total
The Transaction Total. The total value of this transaction including all one-time, recurring and shipping charges over the duration of the contract. Synonymous with the Total Contract Value.
Show Source
Nested Schema : My Approval[Submit]
Type: object
Title: My Approval[Submit]
This attribute lists all approval currently pending for current logged in user. This is not available as rule input.
Nested Schema : Cancel Reason
Type: object
Title: Cancel Reason
The reason expressed by the customer for canceling this order.
Show Source
Nested Schema : Currency
Type: object
Title: Currency
The currency used to price and invoice this transaction.
Show Source
Nested Schema : Fulfillment Status
Type: object
Title: Fulfillment Status
This is the most advanced fulfillment status for any line on the transaction. The value for this attribute is derived from that supplied for each line by the fulfillment system after the transaction is submitted as a sales order.
Show Source
Nested Schema : Payment Terms
Type: object
Title: Payment Terms
The payment terms the customer will receive on their invoice.
Show Source
Nested Schema : Reject Reason
Type: object
Title: Reject Reason
The reason expressed by customer for rejecting this deal.
Show Source
Nested Schema : Sales Channel
Type: object
Title: Sales Channel
The channel that originated the transaction.
Show Source
Nested Schema : Status
Type: object
Title: Status
The most advanced milestone reached by lines of this transaction.
Show Source
Nested Schema : Tax Exempt Reason
Type: object
Title: Tax Exempt Reason
The reason why this transaction is exempt from sales tax. For example, in the U.S. goods purchased for re-sale are not taxed. This value defaults to the line items where it can be overridden.
Show Source
Nested Schema : Annual Contract Discount
Type: object
Title: Annual Contract Discount
The total value each year of the discounts on recurring charges for the transaction.
Show Source
Nested Schema : Annual Contract Value
Type: object
Title: Annual Contract Value
The total value of recurring charges each year.
Show Source
Nested Schema : Total Contract Discount
Type: object
Title: Total Contract Discount
The total discount on this transaction including discounts on all one-time, recurring and shipping charges for the duration of the contract.
Show Source
Nested Schema : Total Contract Value
Type: object
Title: Total Contract Value
The total value of this transaction including all one-time, recurring and shipping charges over the duration of the contract.
Show Source
Nested Schema : Total Discount Per Month
Type: object
Title: Total Discount Per Month
The total of discounts off monthly recurring charges.
Show Source
Nested Schema : Total (List) Per Month
Type: object
Title: Total (List) Per Month
The total of all monthly list amounts on the lines.
Show Source
Nested Schema : Total (Net) Per Month
Type: object
Title: Total (Net) Per Month
The total of all monthly net amounts on the lines.
Show Source
Nested Schema : Total Discount
Type: object
Title: Total Discount
The total of all extended discount amounts for one time pricing/charges.
Show Source
Nested Schema : Total (List)
Type: object
Title: Total (List)
The total of all one-time charges on the lines.
Show Source
Nested Schema : Total (Net)
Type: object
Title: Total (Net)
The total one time net charge.
Show Source
Nested Schema : Actions
Type: object
Title: Actions
Captures the current state of each action whose state was requested. The object contains one property per action, where the property name is the variable name for the action.
Nested Schema : Attributes
Type: object
Title: Attributes
Captures the current state of each attribute whose state was requested. The object contains one property per group, where the property name is the resource field name for the attribute.
Nested Schema : Groups
Type: object
Title: Groups
Captures the current state of each group whose state was requested. The object contains one property per group, where the property name is the expression string that uniquely identifies the group.
Nested Schema : Messages
Type: array
Title: Messages
Array of messages that have been generated for a specific object.
Show Source
Back to Top

Response

Default Response

Body ()
Root Schema : commerceTransaction-UpdateLineItemsResponse
Type: object
Show Source
Nested Schema : commerceTransaction
Type: object
Show Source
Nested Schema : Warnings
Type: array
Title: Warnings
Array of warnings that have been generated for a specific object.
Show Source
Nested Schema :
Type: object
Title:
Show Source
Nested Schema : Customer Country
Type: object
Title: Customer Country
Name of the country associated with the customer address.
Show Source
Nested Schema : Customer State
Type: object
Title: Customer State
Name of the state associated with the customer address.
Show Source
Nested Schema : eSignature File Attachment[eSignature Attribute Set]
Type: object
Title: eSignature File Attachment[eSignature Attribute Set]
The File Attachment attribute holds the documents to be sent to the eSignature Vendor
Nested Schema : eSignature Status (eSignature Attribute Set)
Type: object
Title: eSignature Status (eSignature Attribute Set)
The Status field contains the current status of this document
Show Source
Nested Schema : Invoice To Country
Type: object
Title: Invoice To Country
Name of the country on the invoice address.
Show Source
Nested Schema : Invoice To State
Type: object
Title: Invoice To State
Name of the state on the invoice address.
Show Source
Nested Schema : Ship To Country
Type: object
Title: Ship To Country
Name of the country associated with the shipping address.
Show Source
Nested Schema : Ship To State
Type: object
Title: Ship To State
Name of the state associated with the shipping address.
Show Source
Nested Schema : Sold To Country
Type: object
Title: Sold To Country
Name of the country associated with the Sold To party.
Show Source
Nested Schema : Sold To State
Type: object
Title: Sold To State
Name of the state associated with the Sold To party.
Show Source
Nested Schema : state
Type: object
Title: state
Captures the current state of the resource row. Of available properties, only those that are applicable and whose values are known in the current context are included.
Show Source
  • Actions
    Title: Actions
    Captures the current state of each action whose state was requested. The object contains one property per action, where the property name is the variable name for the action.
  • Attributes
    Title: Attributes
    Captures the current state of each attribute whose state was requested. The object contains one property per group, where the property name is the resource field name for the attribute.
  • Title: Deletable
    Boolean value that specifies whether the row can be deleted.
  • Groups
    Title: Groups
    Captures the current state of each group whose state was requested. The object contains one property per group, where the property name is the expression string that uniquely identifies the group.
  • Title: Has Error
    Boolean value that specifies whether any error that occurred has been assigned to the row itself.
  • Title: Has Warning
    Boolean value that specifies whether any warning that was issued has been assigned to the row itself.
  • Title: Hidden
    Boolean value that specifies whether the row can be hidden.
  • Messages
    Title: Messages
    Array of messages that have been generated for a specific object.
  • Title: Updatable
    Boolean value that specifies whether the row can be updated.
Nested Schema : Transaction Total
Type: object
Title: Transaction Total
The Transaction Total. The total value of this transaction including all one-time, recurring and shipping charges over the duration of the contract. Synonymous with the Total Contract Value.
Show Source
Nested Schema : My Approval[Submit]
Type: object
Title: My Approval[Submit]
This attribute lists all approval currently pending for current logged in user. This is not available as rule input.
Nested Schema : Cancel Reason
Type: object
Title: Cancel Reason
The reason expressed by the customer for canceling this order.
Show Source
Nested Schema : Currency
Type: object
Title: Currency
The currency used to price and invoice this transaction.
Show Source
Nested Schema : Fulfillment Status
Type: object
Title: Fulfillment Status
This is the most advanced fulfillment status for any line on the transaction. The value for this attribute is derived from that supplied for each line by the fulfillment system after the transaction is submitted as a sales order.
Show Source
Nested Schema : Payment Terms
Type: object
Title: Payment Terms
The payment terms the customer will receive on their invoice.
Show Source
Nested Schema : Reject Reason
Type: object
Title: Reject Reason
The reason expressed by customer for rejecting this deal.
Show Source
Nested Schema : Sales Channel
Type: object
Title: Sales Channel
The channel that originated the transaction.
Show Source
Nested Schema : Status
Type: object
Title: Status
The most advanced milestone reached by lines of this transaction.
Show Source
Nested Schema : Tax Exempt Reason
Type: object
Title: Tax Exempt Reason
The reason why this transaction is exempt from sales tax. For example, in the U.S. goods purchased for re-sale are not taxed. This value defaults to the line items where it can be overridden.
Show Source
Nested Schema : Annual Contract Discount
Type: object
Title: Annual Contract Discount
The total value each year of the discounts on recurring charges for the transaction.
Show Source
Nested Schema : Annual Contract Value
Type: object
Title: Annual Contract Value
The total value of recurring charges each year.
Show Source
Nested Schema : Total Contract Discount
Type: object
Title: Total Contract Discount
The total discount on this transaction including discounts on all one-time, recurring and shipping charges for the duration of the contract.
Show Source
Nested Schema : Total Contract Value
Type: object
Title: Total Contract Value
The total value of this transaction including all one-time, recurring and shipping charges over the duration of the contract.
Show Source
Nested Schema : Total Discount Per Month
Type: object
Title: Total Discount Per Month
The total of discounts off monthly recurring charges.
Show Source
Nested Schema : Total (List) Per Month
Type: object
Title: Total (List) Per Month
The total of all monthly list amounts on the lines.
Show Source
Nested Schema : Total (Net) Per Month
Type: object
Title: Total (Net) Per Month
The total of all monthly net amounts on the lines.
Show Source
Nested Schema : Total Discount
Type: object
Title: Total Discount
The total of all extended discount amounts for one time pricing/charges.
Show Source
Nested Schema : Total (List)
Type: object
Title: Total (List)
The total of all one-time charges on the lines.
Show Source
Nested Schema : Total (Net)
Type: object
Title: Total (Net)
The total one time net charge.
Show Source
Nested Schema : Actions
Type: object
Title: Actions
Captures the current state of each action whose state was requested. The object contains one property per action, where the property name is the variable name for the action.
Nested Schema : Attributes
Type: object
Title: Attributes
Captures the current state of each attribute whose state was requested. The object contains one property per group, where the property name is the resource field name for the attribute.
Nested Schema : Groups
Type: object
Title: Groups
Captures the current state of each group whose state was requested. The object contains one property per group, where the property name is the expression string that uniquely identifies the group.
Nested Schema : Messages
Type: array
Title: Messages
Array of messages that have been generated for a specific object.
Show Source
Back to Top