Update a standard coverage
patch
/crmRestApi/resources/11.13.18.05/subscriptionCoverageHeaders/{CoverageHeaderPuid}
Request
Path Parameters
-
CoverageHeaderPuid(required): string
The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Header Parameters
-
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.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
CoverageChargeDiscounts: array
Adjustments
Title:
Adjustments
The adjustments resource is used to view, create, update, and delete an adjustment. It provides details of adjustment information. -
CoverageDescription: string
Title:
Template Description
Maximum Length:1000
The value that uniquely identifies the standard coverage description. -
CoverageName: string
Title:
Template Name
Maximum Length:150
The name of the standard coverage. -
DynamicMatrixClassName: string
Title:
Entitlement Type
The alternate value that uniquely identifies the dynamic matrix class. -
EndDate: string
(date)
Title:
End Date
The date when the standard coverage ends. -
MatrixId: integer
(int64)
The unique identifier of the dynamic matrix.
-
MatrixName: string
The name of the matrix.
-
ProgramCode: string
Title:
Program Code
Maximum Length:30
The code of the associated maintenance program. -
ProgramId: integer
(int64)
The identifier of the associated maintenance program.
-
ProgramName: string
Title:
Program Name
Maximum Length:120
The name of the associated maintenance program. -
ProgramOrganizationId: integer
(int64)
Title:
Organization
The organization identifier of the associated maintenance program. -
StandardCoverageYn: string
Maximum Length:
1
Indicates whether coverage is standard coverage. The default value is False. -
StartDate: string
(date)
Title:
Start Date
The date when the adjustments was created. -
SubscriptionProductPuid: string
The value that uniquely identifies the subscription product.
Nested Schema : Adjustments
Type:
array
Title:
Adjustments
The adjustments resource is used to view, create, update, and delete an adjustment. It provides details of adjustment information.
Show Source
Nested Schema : subscriptionCoverageHeaders-CoverageChargeDiscounts-item-patch-request
Type:
Show Source
object
-
AdjustmentAmount: number
Title:
Value
The amount entered for an adjustment type. -
AdjustmentTypeCode: string
Maximum Length:
30
The unique code for adjustment type lookup. Valid values include discount percent or markup percent. A list of accepted values is defined in the lookup type ORA_QP_LINE_ADJ_TYPES. -
AdjustmentTypeMeaning: string
Title:
Adjustment Type
The display value for the adjustment type lookup. The alternate valid values include discount percent or markup percent. A list of accepted values is defined in the lookup type ORA_QP_LINE_ADJ_TYPES. -
AllowCustomAdjustmentsFlag: boolean
Title:
Allow custom adjustments
Maximum Length:1
Indicates whether custom adjustments are allowed. The Default value is True. -
AllowPricingDiscountsFlag: boolean
Title:
Allow pricing discounts
Maximum Length:1
Indicates whether pricing discounts are allowed. The default value is False. -
BillingTypeCode: string
Maximum Length:
30
The unique code for billing type lookup. A list of accepted values is defined in the lookup type EGP_MATERIAL_BILLABLE_TYPE for billing type code. Review and update the list of values using the Setup and Maintenance work area, and the Manage Service Logistics Lookups task. -
BillingTypeMeaning: string
Title:
Billing Type
The display value for the billing type lookup code. A list of accepted values is defined in the lookup type EGP_MATERIAL_BILLABLE_TYPE for billing type meaning. Review and update the list of values using the Setup and Maintenance work area, and the Manage Service Logistics Lookups task. -
BusinessProcessCode: string
Maximum Length:
30
The unique code for the business process type lookup. A list of accepted values is defined in the lookup type ORA_RCL_BUSINESS_PROCESS for business process code. Review and update the list of values using the Setup and Maintenance work area, and the Manage Service Logistics Lookups task. -
BusinessProcessMeaning: string
Title:
Business Process
The display value for the business process type lookup. A list of accepted values is defined in the lookup type ORA_RCL_BUSINESS_PROCESS for business process meaning. Review and update the list of values using the Setup and Maintenance work area, and the Manage Service Logistics Lookups task. -
ChargeDiscountId: integer
(int64)
The unique identifier of the adjustment.
-
CoverageHeaderId: integer
(int64)
The unique identifier of the parent coverage header against an adjustment.
-
EndDate: string
(date)
Title:
End Date
The date when the coverage adjustment ends. -
PricingBasisId: integer
The unique identifier of the pricing basis. A list of accepted values is defined in the view qp_pricing_basis_vl for pricing basis ID.
-
PricingBasisName: string
Title:
Adjustment Basis
The name of the pricing basis. A list of accepted values is defined in the view qp_pricing_basis_vl for pricing basis name. -
ServiceActivityId: integer
(int64)
The unique identifier of the service activity. A list of accepted values is defined in the view RCL_SERVICE_ACTIVITIES_VL for service activity ID.
-
ServiceActivityName: string
Title:
Service Activity
Maximum Length:80
The name of the service activity. A list of accepted values is defined in the view RCL_SERVICE_ACTIVITIES_VL for service activity name. -
StartDate: string
(date)
Title:
Start Date
The date when the adjustment starts.
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 : subscriptionCoverageHeaders-item-response
Type:
Show Source
object
-
CoverageChargeDiscounts: array
Adjustments
Title:
Adjustments
The adjustments resource is used to view, create, update, and delete an adjustment. It provides details of adjustment information. -
CoverageDescription: string
Title:
Template Description
Maximum Length:1000
The value that uniquely identifies the standard coverage description. -
CoverageHeaderId: integer
(int64)
The unique identifier of the internal standard coverage.
-
CoverageHeaderPuid: string
Maximum Length:
120
The value that uniquely identifies the standard coverage. -
CoverageName: string
Title:
Template Name
Maximum Length:150
The name of the standard coverage. -
CreatedBy: string
Read Only:
true
Maximum Length:64
The user who created the standard coverage record. -
CreationDate: string
(date-time)
Read Only:
true
The date when the standard coverage was created. -
DynamicMatrixClassId: integer
(int64)
Title:
Entitlement Type
The unique identifier of the dynamic matrix class. -
DynamicMatrixClassName: string
Title:
Entitlement Type
The alternate value that uniquely identifies the dynamic matrix class. -
EndDate: string
(date)
Title:
End Date
The date when the standard coverage ends. -
LastUpdateDate: string
(date-time)
Read Only:
true
The date when the standard coverage was last updated. -
LastUpdatedBy: string
Read Only:
true
Maximum Length:64
The user who last updated the standard coverage. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
The name of the user who has last updated the standard coverage. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MatrixId: integer
(int64)
The unique identifier of the dynamic matrix.
-
MatrixName: string
The name of the matrix.
-
ProgramCode: string
Title:
Program Code
Maximum Length:30
The code of the associated maintenance program. -
ProgramDescription: string
Title:
Description
Read Only:true
Maximum Length:240
The description of the associated maintenance program. -
ProgramEndDate: string
(date)
Title:
End Date
Read Only:true
The end date of the associated maintenance program. -
ProgramId: integer
(int64)
The identifier of the associated maintenance program.
-
ProgramName: string
Title:
Program Name
Maximum Length:120
The name of the associated maintenance program. -
ProgramOrganizationId: integer
(int64)
Title:
Organization
The organization identifier of the associated maintenance program. -
ProgramStartDate: string
(date)
Title:
Start Date
Read Only:true
The start date of the associated maintenance program. -
StandardCoverageYn: string
Maximum Length:
1
Indicates whether coverage is standard coverage. The default value is False. -
StartDate: string
(date)
Title:
Start Date
The date when the adjustments was created. -
SubscriptionProductPuid: string
The value that uniquely identifies the subscription product.
Nested Schema : Adjustments
Type:
array
Title:
Adjustments
The adjustments resource is used to view, create, update, and delete an adjustment. It provides details of adjustment information.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : subscriptionCoverageHeaders-CoverageChargeDiscounts-item-response
Type:
Show Source
object
-
AdjustmentAmount: number
Title:
Value
The amount entered for an adjustment type. -
AdjustmentTypeCode: string
Maximum Length:
30
The unique code for adjustment type lookup. Valid values include discount percent or markup percent. A list of accepted values is defined in the lookup type ORA_QP_LINE_ADJ_TYPES. -
AdjustmentTypeMeaning: string
Title:
Adjustment Type
The display value for the adjustment type lookup. The alternate valid values include discount percent or markup percent. A list of accepted values is defined in the lookup type ORA_QP_LINE_ADJ_TYPES. -
AllowCustomAdjustmentsFlag: boolean
Title:
Allow custom adjustments
Maximum Length:1
Indicates whether custom adjustments are allowed. The Default value is True. -
AllowPricingDiscountsFlag: boolean
Title:
Allow pricing discounts
Maximum Length:1
Indicates whether pricing discounts are allowed. The default value is False. -
BillingTypeCode: string
Maximum Length:
30
The unique code for billing type lookup. A list of accepted values is defined in the lookup type EGP_MATERIAL_BILLABLE_TYPE for billing type code. Review and update the list of values using the Setup and Maintenance work area, and the Manage Service Logistics Lookups task. -
BillingTypeMeaning: string
Title:
Billing Type
The display value for the billing type lookup code. A list of accepted values is defined in the lookup type EGP_MATERIAL_BILLABLE_TYPE for billing type meaning. Review and update the list of values using the Setup and Maintenance work area, and the Manage Service Logistics Lookups task. -
BusinessProcessCode: string
Maximum Length:
30
The unique code for the business process type lookup. A list of accepted values is defined in the lookup type ORA_RCL_BUSINESS_PROCESS for business process code. Review and update the list of values using the Setup and Maintenance work area, and the Manage Service Logistics Lookups task. -
BusinessProcessMeaning: string
Title:
Business Process
The display value for the business process type lookup. A list of accepted values is defined in the lookup type ORA_RCL_BUSINESS_PROCESS for business process meaning. Review and update the list of values using the Setup and Maintenance work area, and the Manage Service Logistics Lookups task. -
ChargeDiscountId: integer
(int64)
The unique identifier of the adjustment.
-
CoverageDiscountPuid: string
Maximum Length:
120
The value that uniquely identifies the adjustments. -
CoverageHeaderId: integer
(int64)
The unique identifier of the parent coverage header against an adjustment.
-
CreatedBy: string
Read Only:
true
Maximum Length:64
The user who created the adjustment. -
CreationDate: string
(date-time)
Read Only:
true
The date when the adjustment was created. -
EndDate: string
(date)
Title:
End Date
The date when the coverage adjustment ends. -
LastUpdateDate: string
(date-time)
Read Only:
true
The date when the adjustment was last updated. -
LastUpdatedBy: string
Read Only:
true
Maximum Length:64
The user who last updated the adjustment. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
The name of the user who has last updated the adjustment. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PricingBasisId: integer
The unique identifier of the pricing basis. A list of accepted values is defined in the view qp_pricing_basis_vl for pricing basis ID.
-
PricingBasisName: string
Title:
Adjustment Basis
The name of the pricing basis. A list of accepted values is defined in the view qp_pricing_basis_vl for pricing basis name. -
PricingTermId: integer
The unique identifier of the pricing term.
-
ServiceActivityId: integer
(int64)
The unique identifier of the service activity. A list of accepted values is defined in the view RCL_SERVICE_ACTIVITIES_VL for service activity ID.
-
ServiceActivityName: string
Title:
Service Activity
Maximum Length:80
The name of the service activity. A list of accepted values is defined in the view RCL_SERVICE_ACTIVITIES_VL for service activity name. -
StartDate: string
(date)
Title:
Start Date
The date when the adjustment starts.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
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.
Links
- CoverageChargeDiscounts
-
Parameters:
- CoverageHeaderPuid:
$request.path.CoverageHeaderPuid
The adjustments resource is used to view, create, update, and delete an adjustment. It provides details of adjustment information. - CoverageHeaderPuid:
Examples
You can update a standard coverage by submitting a PATCH request on the REST resource using the following URL:
crmRestApi/resources/11.13.18.05/subscriptionCoverageHeaders/CDRM_7035
Example of Request Body
The following shows the contents of the Request Body in JSON format.
{ "CoverageDescription": "Gold Premium Coverage Template" }
Example of Response Body
The following shows the contents of the Response Body in JSON format.
{ "CoverageName": "Gold Coverage", "CoverageDescription": "Gold Premium Coverage Template", "CoverageHeaderId": 300100543803294, "DynamicMatrixClassId": 100100112405854, "DynamicMatrixClassName": "Subscription Entitlements", "MatrixId": 300100543706812, "MatrixName": "Gold Coverage Entitlements", "StartDate": "2020-01-01", "EndDate": "2025-12-31", "CreatedBy": "CONMGR", "CreationDate": "2021-04-15T09:46:43+00:00", "LastUpdateDate": "2021-04-15T09:46:43.001+00:00", "LastUpdateLogin": "BFB17732D7F10395E0531C5CF00ADC77", "LastUpdatedBy": "CONMGR", "CoverageHeaderPuid": "CDRM_7035", "StandardCoverageYn": "Y", "SubscriptionProductPuid": null, "links": [ { "rel": "self", "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/subscriptionCoverageHeaders/CDRM_7035", "name": "subscriptionCoverageHeaders", "kind": "item", "properties": { "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278" } }, { "rel": "canonical", "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/subscriptionCoverageHeaders/CDRM_7035", "name": "subscriptionCoverageHeaders", "kind": "item" }, { "rel": "child", "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/subscriptionCoverageHeaders/CDRM_7035/child/CoverageChargeDiscounts", "name": "CoverageChargeDiscounts", "kind": "collection" } ] }