Update a claim settlement
patch
/crmRestApi/resources/11.13.18.05/mdfClaims/{ClaimCode}/child/ClaimSettlements/{ClaimSettlementCode}
Request
Path Parameters
-
ClaimCode(required): string
The user-defined, unique label for the MDF claim.
-
ClaimSettlementCode(required): string
The user-defined, unique label for the MDF claim settlement.
Header Parameters
-
Metadata-Context: string
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".
-
REST-Framework-Version: string
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.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
AccountingType: string
Title:
Accounting Type
Maximum Length:30
The accounting type of the MDF claim settlement, which represents credit or debit in the back-end financial system. -
ClaimSettlementAmount: number
Title:
Amount
The amount settled in the MDF claim settlement. -
ClaimSettlementCode: string
Title:
Code
Maximum Length:100
The user-defined, unique label for the MDF claim settlement. -
ClaimSettlementType: string
Title:
Type
Maximum Length:30
The type of the MDF claim settlement, for example deduction or payment. -
CurrencyCode: string
Title:
Currency
Maximum Length:30
The currency code associated with the claim settlement account. A list of valid values are defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Currency Profile Options task. -
Description: string
Title:
Description
Maximum Length:1000
A brief description of the marketing claim settlement. -
InvoiceReference: string
Title:
Transaction Reference
Maximum Length:100
The reference identifier of the invoice to be settled with the MDF claim settlement. -
smartActions: array
Smart Actions
Title:
Smart Actions
This VO stores the endpoint and security details for every user action. -
StatusCode: string
Title:
Status
Maximum Length:30
Default Value:INCOMPLETE
The code indicating the completion status of the marketing claim settlement. -
TransactionDate: string
(date)
Title:
Transaction Date
The date when the claim settlement was processed or marked as complete. -
TransactionMethod: string
Title:
Transaction Method
Maximum Length:30
The method by which the claim settlement transaction was processed.
Nested Schema : Smart Actions
Type:
array
Title:
Smart Actions
This VO stores the endpoint and security details for every user action.
Show Source
Nested Schema : mdfClaims-ClaimSettlements-smartActions-item-patch-request
Type:
Show Source
object
-
ActionIntent: string
(byte)
Title:
Action Intent
JSON object that describes what an action does and what context data can be passed to the action. -
ConfirmationMessage: string
Title:
Confirmation Message
Maximum Length:4000
A message to seek confirmation for the action being performed. -
ContentType: string
Title:
Content Type
Maximum Length:50
The content type to use when invoking the REST endpoint. -
DisplayLabel: string
Title:
Action Name
Maximum Length:256
Consumer-friendly action name. -
Entity: string
Title:
Parent Entity
Maximum Length:150
REST Resources the action belongs to. -
Href: string
Title:
REST Endpoint
Maximum Length:1024
The REST endpoint to perform the action. -
IncludedInApplication: string
Title:
Included in Application
Maximum Length:512
List of applications that this action can be used in. -
MassActionFlag: boolean
Title:
Mass Action
Maximum Length:1
Boolean type indicating if this action can be mass processed. -
Method: string
Title:
HTTP Method
Maximum Length:15
HTTP method to use with HREF. -
ObjectFunctionName: string
Title:
Object Function
Maximum Length:64
The object function associated with the smart action. -
PageType: string
Title:
Page Type
Maximum Length:256
The list of pages that this action can be used in. -
SmartSuggestFlag: boolean
Title:
Smart Suggest
Maximum Length:1
Indicates if smart suggest is enabled for the action. -
SystemActionFlag: boolean
Title:
System Action
Maximum Length:1
Boolean type indicating if the action is seeded or custom. -
UpdateOfAttributes: string
Title:
Attributes to Update
Maximum Length:512
Attributes to be updated when the Actions UI is launched. - UserActionNavigation: array Smart Action User Interface Definitions
-
UserActionRank: integer
(int64)
Title:
Priority
Number to indicate priority of the action. -
UserActionRequestPayload: array
Smart Action REST Payload Definitions
Title:
Smart Action REST Payload Definitions
If an LOV required for constructing a request payload needs to post data, the payload metadata is stored here. -
UserActionURLBinding: array
Smart Action User Interface Definitions
Title:
Smart Action User Interface Definitions
Binding metadata for a variable in the URL.
Nested Schema : Smart Action REST Payload Definitions
Type:
array
Title:
Smart Action REST Payload Definitions
If an LOV required for constructing a request payload needs to post data, the payload metadata is stored here.
Show Source
Nested Schema : Smart Action User Interface Definitions
Type:
array
Title:
Smart Action User Interface Definitions
Binding metadata for a variable in the URL.
Show Source
Nested Schema : mdfClaims-ClaimSettlements-smartActions-UserActionRequestPayload-item-patch-request
Type:
Show Source
object
-
Binding: string
Title:
Payload Value Binding Type
Maximum Length:64
Indicates the binding type of the value. -
MandatoryFlag: boolean
Title:
Mandatory
Maximum Length:1
Boolean value indicating if the payload is mandatory. -
RequestPayloadName: string
Title:
Request Payload Attribute Name
Maximum Length:256
The key in the Key Value pair that forms the payload. -
SmartSuggestPath: string
Title:
Smart Suggest Path
Maximum Length:2048
The path used for smart suggest. -
SystemActionFlag: boolean
Title:
System Action
Maximum Length:1
Default Value:false
Boolean value. -
Value: string
Title:
Request Payload Attribute Value
Maximum Length:1000
The value in the Key Value pair that forms the payload. -
ValueStruct: string
Title:
Payload Value Structure
Maximum Length:20
If the value in the Key Value pair isn't a single value, this would be set.
Nested Schema : mdfClaims-ClaimSettlements-smartActions-UserActionURLBinding-item-patch-request
Type:
Show Source
object
-
Binding: string
Title:
URL Binding Type
Maximum Length:64
This is a hint for processing the Url Binding runtime. -
SystemActionFlag: boolean
Title:
System Action
Maximum Length:1
Default Value:false
Boolean indicator. -
URLBindingName: string
Title:
URL Binding Parameter Name
Maximum Length:256
For action REST endpoints that require runtime binding, this is the key in the key value pair. -
Value: string
Title:
URL Binding Parameter Value
Maximum Length:1000
For action REST endpoints that require runtime binding, this is the value in the key value pair.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
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".
-
REST-Framework-Version:
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.
Root Schema : mdfClaims-ClaimSettlements-item-response
Type:
Show Source
object
-
AccountingType: string
Title:
Accounting Type
Maximum Length:30
The accounting type of the MDF claim settlement, which represents credit or debit in the back-end financial system. -
AccountingTypeMeaning: string
Title:
Accounting Type
Read Only:true
The accounting type of the marketing claim settlement, which represents a credit or debit in the back-end financial system. -
BudgetCurrencyExchangeRate: number
Title:
Conversion Rate to Budget
Read Only:true
Default Value:1
The exchange rate used to convert the marketing claim settlement currency to the parent budget currency. -
BudgetId: number
Title:
Budget ID
Read Only:true
The unique identifier of the parent budget associated with the MDF claim. -
BudgetName: string
Title:
Name
Read Only:true
Maximum Length:250
The name of the MDF budget associated with the claim. MDF budget is associated to the claim through fund request. -
ClaimCode: string
Title:
Code
Maximum Length:100
The user-defined, unique label for the marketing claim. -
ClaimCurrencyExchangeRate: number
Title:
Conversion Rate to Claim
Read Only:true
Default Value:1
The exchange rate used to convert the marketing claim settlement currency to the parent marketing claim currency. -
ClaimId: number
Title:
Claim ID
The unique identifier of the MDF claim. -
ClaimName: string
Title:
Name
Read Only:true
Maximum Length:250
The name of the claim associated with the claim settlement. -
ClaimSettlementAmount: number
Title:
Amount
The amount settled in the MDF claim settlement. -
ClaimSettlementCode: string
Title:
Code
Maximum Length:100
The user-defined, unique label for the MDF claim settlement. -
ClaimSettlementId: integer
Title:
Claim Settlement ID
The unique identifier of the MDF claim settlement. -
ClaimSettlementType: string
Title:
Type
Maximum Length:30
The type of the MDF claim settlement, for example deduction or payment. -
ClaimSettlmntTypeMeaning: string
Title:
Type
Read Only:true
The type of marketing claim settlement, for example deduction or payment. -
ClaimStatusCode: string
Title:
Status
Read Only:true
Maximum Length:30
The status of the claim settlement. -
ConversionCurrencyCode: string
Title:
Conversion Currency Code
Read Only:true
Maximum Length:30
The currency code associated with the claim settlement. -
ConversionRateType: string
Title:
Conversion Rate Type
Read Only:true
Maximum Length:30
The conversion rate type associated with the claim settlement. -
ConvExchangeRate: number
Title:
Conversion Exchange Rate
Read Only:true
The currency exchange rate for the claim settlement against the corporate currency. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
The user who created the MDF claim settlement. -
CreatedById: integer
(int64)
Title:
Created by ID
Read Only:true
The unique identifier of the creator of the claim settlement. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
The date when the claim settlement was created. -
CurrencyCode: string
Title:
Currency
Maximum Length:30
The currency code associated with the claim settlement account. A list of valid values are defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Currency Profile Options task. -
CurrencyConversionDate: string
(date)
Title:
Currency Conversion Date
Read Only:true
The date of currency exchange rate for the claim settlement against the corporate currency. -
Description: string
Title:
Description
Maximum Length:1000
A brief description of the marketing claim settlement. -
InvoiceReference: string
Title:
Transaction Reference
Maximum Length:100
The reference identifier of the invoice to be settled with the MDF claim settlement. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
The date when the settlement was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
The user who last updated the marketing claim settlement. -
LastUpdateLogin: string
Title:
Last Update Login
Read Only:true
Maximum Length:32
The login of the user who last updated the settlement. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
OutstandingClaimLiabilityAmount: number
Title:
Liability Amount
Read Only:true
Default Value:0
The outstanding claim liability amount. -
PartnerId: integer
(int64)
Title:
Partner ID
Read Only:true
The unique identifier of the party. -
PartnerName: string
Title:
Partner
Read Only:true
The name of the party. -
smartActions: array
Smart Actions
Title:
Smart Actions
This VO stores the endpoint and security details for every user action. -
StatusCode: string
Title:
Status
Maximum Length:30
Default Value:INCOMPLETE
The code indicating the completion status of the marketing claim settlement. -
StatusMeaning: string
Title:
Status
Read Only:true
The completion status of the marketing claim settlement. -
TransactionDate: string
(date)
Title:
Transaction Date
The date when the claim settlement was processed or marked as complete. -
TransactionMethod: string
Title:
Transaction Method
Maximum Length:30
The method by which the claim settlement transaction was processed. -
TransactionMethodMeaning: string
Title:
Transaction Method
Read Only:true
The method by which claim settlement transaction is processed.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Smart Actions
Type:
array
Title:
Smart Actions
This VO stores the endpoint and security details for every user action.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : mdfClaims-ClaimSettlements-smartActions-item-response
Type:
Show Source
object
-
ActionIntent: string
(byte)
Title:
Action Intent
JSON object that describes what an action does and what context data can be passed to the action. -
ConfirmationMessage: string
Title:
Confirmation Message
Maximum Length:4000
A message to seek confirmation for the action being performed. -
ContentType: string
Title:
Content Type
Maximum Length:50
The content type to use when invoking the REST endpoint. -
DisplayLabel: string
Title:
Action Name
Maximum Length:256
Consumer-friendly action name. -
Entity: string
Title:
Parent Entity
Maximum Length:150
REST Resources the action belongs to. -
Href: string
Title:
REST Endpoint
Maximum Length:1024
The REST endpoint to perform the action. -
IncludedInApplication: string
Title:
Included in Application
Maximum Length:512
List of applications that this action can be used in. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MassActionFlag: boolean
Title:
Mass Action
Maximum Length:1
Boolean type indicating if this action can be mass processed. -
Method: string
Title:
HTTP Method
Maximum Length:15
HTTP method to use with HREF. -
ObjectFunctionName: string
Title:
Object Function
Maximum Length:64
The object function associated with the smart action. -
PageType: string
Title:
Page Type
Maximum Length:256
The list of pages that this action can be used in. -
SmartSuggestFlag: boolean
Title:
Smart Suggest
Maximum Length:1
Indicates if smart suggest is enabled for the action. -
SystemActionFlag: boolean
Title:
System Action
Maximum Length:1
Boolean type indicating if the action is seeded or custom. -
UpdateOfAttributes: string
Title:
Attributes to Update
Maximum Length:512
Attributes to be updated when the Actions UI is launched. -
UserActionId: integer
(int64)
Title:
User Action ID
Uniquely identifies the action. For internal use. -
UserActionName: string
Title:
Action Name
Maximum Length:256
Uniquely identifies the action with a name. For internal use. - UserActionNavigation: array Smart Action User Interface Definitions
-
UserActionRank: integer
(int64)
Title:
Priority
Number to indicate priority of the action. -
UserActionRequestPayload: array
Smart Action REST Payload Definitions
Title:
Smart Action REST Payload Definitions
If an LOV required for constructing a request payload needs to post data, the payload metadata is stored here. -
UserActionURLBinding: array
Smart Action User Interface Definitions
Title:
Smart Action User Interface Definitions
Binding metadata for a variable in the URL.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Smart Action REST Payload Definitions
Type:
array
Title:
Smart Action REST Payload Definitions
If an LOV required for constructing a request payload needs to post data, the payload metadata is stored here.
Show Source
Nested Schema : Smart Action User Interface Definitions
Type:
array
Title:
Smart Action User Interface Definitions
Binding metadata for a variable in the URL.
Show Source
Nested Schema : mdfClaims-ClaimSettlements-smartActions-UserActionRequestPayload-item-response
Type:
Show Source
object
-
Binding: string
Title:
Payload Value Binding Type
Maximum Length:64
Indicates the binding type of the value. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MandatoryFlag: boolean
Title:
Mandatory
Maximum Length:1
Boolean value indicating if the payload is mandatory. -
RequestPayloadId: integer
(int64)
Uniquely identifies the payload for smart actions. For internal use.
-
RequestPayloadName: string
Title:
Request Payload Attribute Name
Maximum Length:256
The key in the Key Value pair that forms the payload. -
SmartSuggestPath: string
Title:
Smart Suggest Path
Maximum Length:2048
The path used for smart suggest. -
SystemActionFlag: boolean
Title:
System Action
Maximum Length:1
Default Value:false
Boolean value. -
Value: string
Title:
Request Payload Attribute Value
Maximum Length:1000
The value in the Key Value pair that forms the payload. -
ValueStruct: string
Title:
Payload Value Structure
Maximum Length:20
If the value in the Key Value pair isn't a single value, this would be set.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : mdfClaims-ClaimSettlements-smartActions-UserActionURLBinding-item-response
Type:
Show Source
object
-
Binding: string
Title:
URL Binding Type
Maximum Length:64
This is a hint for processing the Url Binding runtime. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
SystemActionFlag: boolean
Title:
System Action
Maximum Length:1
Default Value:false
Boolean indicator. -
URLBindingId: integer
(int64)
Uniquely identifies the URL Bind for smart actions. For internal use.
-
URLBindingName: string
Title:
URL Binding Parameter Name
Maximum Length:256
For action REST endpoints that require runtime binding, this is the key in the key value pair. -
Value: string
Title:
URL Binding Parameter Value
Maximum Length:1000
For action REST endpoints that require runtime binding, this is the value in the key value pair.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Links
- AccountingTypeLOVVA
-
Parameters:
- finder:
LookupTypeActiveEnabledOrBindCodeFinder%3BBindLookupType%3DMKT_MDF_CLAIM_STLMNT_ACC_TYPE%2CBindLookupCode%3D{AccountingType}
The list of values indicating the claim settlement accounting type.
The following properties are defined on the LOV link relation:- Source Attribute: AccountingType; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ClaimStlmntTypeLOVVA
-
Parameters:
- finder:
LookupTypeActiveEnabledOrBindCodeFinder%3BBindLookupType%3DMKT_MDF_CLAIM_STLMNT_TYPE%2CBindLookupCode%3D{ClaimSettlementType}
The list of values indicating the claim settlement type.
The following properties are defined on the LOV link relation:- Source Attribute: ClaimSettlementType; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- CurrencyLOVVA
-
The list of values indicating the currency code associated with the MDF claim settlement, such as USD, CAD, or Euro.
The following properties are defined on the LOV link relation:- Source Attribute: CurrencyCode; Target Attribute: CurrencyCode
- Display Attribute: CurrencyCode
- StatusLOVVA
-
Parameters:
- finder:
LookupTypeActiveEnabledOrBindCodeFinder%3BBindLookupType%3DMKT_MDF_CLAIM_STLMNT_STATUS%2CBindLookupCode%3D{StatusCode}
The list of values indicating the status of the MDF claim settlement.
The following properties are defined on the LOV link relation:- Source Attribute: StatusCode; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- TransactionMethodVA
-
Parameters:
- finder:
LookupTypeActiveEnabledOrBindCodeFinder%3BBindLookupType%3DORA_MKT_MDFCLAIMSETT_TRANS%2CBindLookupCode%3D{TransactionMethod}
The list of values indicating the claim settlement transaction methods.
The following properties are defined on the LOV link relation:- Source Attribute: TransactionMethod; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- smartActions
-
Parameters:
- ClaimCode:
$request.path.ClaimCode
- ClaimSettlementCode:
$request.path.ClaimSettlementCode
This VO stores the endpoint and security details for every user action. - ClaimCode: