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: 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-
CoverageChargeDiscounts: array
Adjustments
Title:
AdjustmentsThe adjustments resource is used to view, create, update, and delete an adjustment. It provides details of adjustment information. -
CoverageDescription: string
Title:
Template DescriptionMaximum Length:1000The value that uniquely identifies the standard coverage description. -
CoverageName: string
Title:
Template NameMaximum Length:150The name of the standard coverage. -
DynamicMatrixClassName: string
Title:
Entitlement TypeThe alternate value that uniquely identifies the dynamic matrix class. -
EndDate: string
(date)
Title:
End DateThe date when the standard coverage ends. -
MatrixId: integer
(int64)
The unique identifier of the dynamic matrix.
-
MatrixName: string
The name of the matrix.
-
PreventiveMaintenanceWorkRequirements: array
Preventive Maintenance Work Requirements
Title:
Preventive Maintenance Work RequirementsThe preventive maintenance work requirements resource is used to get the work requirements of a preventive maintenance program associated with a subscription coverage. -
ProgramCode: string
Title:
Program CodeMaximum Length:30The code of the associated maintenance program. -
ProgramId: integer
(int64)
The identifier of the associated maintenance program.
-
ProgramName: string
Title:
Program NameMaximum Length:120The name of the associated maintenance program. -
ProgramOrganizationId: integer
(int64)
Title:
OrganizationThe organization identifier of the associated maintenance program. -
StandardCoverageYn: string
Maximum Length:
1Indicates whether coverage is standard coverage. The default value is False. -
StartDate: string
(date)
Title:
Start DateThe date when the adjustments was created. -
SubscriptionProductPuid: string
The value that uniquely identifies the subscription product.
Nested Schema : Adjustments
Type:
arrayTitle:
AdjustmentsThe adjustments resource is used to view, create, update, and delete an adjustment. It provides details of adjustment information.
Show Source
Nested Schema : Preventive Maintenance Work Requirements
Type:
arrayTitle:
Preventive Maintenance Work RequirementsThe preventive maintenance work requirements resource is used to get the work requirements of a preventive maintenance program associated with a subscription coverage.
Show Source
Nested Schema : subscriptionCoverageHeaders-CoverageChargeDiscounts-item-patch-request
Type:
Show Source
object-
AdjustmentAmount: number
Title:
ValueThe amount entered for an adjustment type. -
AdjustmentTypeCode: string
Maximum Length:
30The 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 TypeThe 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 adjustmentsMaximum Length:1Indicates whether custom adjustments are allowed. The Default value is True. -
AllowPricingDiscountsFlag: boolean
Title:
Allow pricing discountsMaximum Length:1Indicates whether pricing discounts are allowed. The default value is False. -
BillingTypeCode: string
Maximum Length:
30The 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 TypeThe 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:
30The 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 ProcessThe 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. -
ChargeDefinitionCode: string
Maximum Length:
30The charge definition code. -
ChargeDefinitionId: integer
(int64)
Title:
Charge DefinitionThe charge definition identifier. -
ChargeDefinitionName: string
Title:
Charge DefinitionMaximum Length:255The charge definition name. -
ChargeDiscountId: integer
(int64)
The unique identifier of the adjustment.
-
ChargeSubtypeCode: string
Maximum Length:
30The charge subtype code. -
ChargeTypeCode: string
Maximum Length:
30The charge type code. -
CoverageHeaderId: integer
(int64)
The unique identifier of the parent coverage header against an adjustment.
-
CurrencyCode: string
Title:
CurrencyMaximum Length:15The currency code. -
EndDate: string
(date)
Title:
End DateThe date when the coverage adjustment ends. -
OrganizationId: integer
(int64)
The organization ID.
-
PriceUOM: string
Title:
Price UOMMaximum Length:255The price UOM. -
PriceUOMCode: string
Title:
Price UOMMaximum Length:3The price UOM code. -
PricingBasisId: integer
Title:
Adjustment BasisThe 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 BasisThe 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 ActivityMaximum Length:80The name of the service activity. A list of accepted values is defined in the view RCL_SERVICE_ACTIVITIES_VL for service activity name. -
ServiceItemId: integer
(int64)
Title:
Service ItemThe service item ID. -
ServiceItemNumber: string
Title:
Service ItemMaximum Length:255The service item number. -
StartDate: string
(date)
Title:
Start DateThe date when the adjustment starts.
Nested Schema : subscriptionCoverageHeaders-PreventiveMaintenanceWorkRequirements-item-patch-request
Type:
Show Source
objectResponse
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:
AdjustmentsThe adjustments resource is used to view, create, update, and delete an adjustment. It provides details of adjustment information. -
CoverageDescription: string
Title:
Template DescriptionMaximum Length:1000The value that uniquely identifies the standard coverage description. -
CoverageHeaderId: integer
(int64)
The unique identifier of the internal standard coverage.
-
CoverageHeaderPuid: string
Maximum Length:
120The value that uniquely identifies the standard coverage. -
CoverageName: string
Title:
Template NameMaximum Length:150The name of the standard coverage. -
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the standard coverage record. -
CreationDate: string
(date-time)
Read Only:
trueThe date when the standard coverage was created. -
DynamicMatrixClassId: integer
(int64)
Title:
Entitlement TypeThe unique identifier of the dynamic matrix class. -
DynamicMatrixClassName: string
Title:
Entitlement TypeThe alternate value that uniquely identifies the dynamic matrix class. -
EndDate: string
(date)
Title:
End DateThe date when the standard coverage ends. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date when the standard coverage was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the standard coverage. -
LastUpdateLogin: string
Read Only:
trueMaximum Length:32The name of the user who has last updated the standard coverage. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MatrixId: integer
(int64)
The unique identifier of the dynamic matrix.
-
MatrixName: string
The name of the matrix.
-
PreventiveMaintenanceWorkRequirements: array
Preventive Maintenance Work Requirements
Title:
Preventive Maintenance Work RequirementsThe preventive maintenance work requirements resource is used to get the work requirements of a preventive maintenance program associated with a subscription coverage. -
ProgramCode: string
Title:
Program CodeMaximum Length:30The code of the associated maintenance program. -
ProgramDescription: string
Title:
DescriptionRead Only:trueMaximum Length:240The description of the associated maintenance program. -
ProgramEndDate: string
(date)
Title:
End DateRead Only:trueThe end date of the associated maintenance program. -
ProgramId: integer
(int64)
The identifier of the associated maintenance program.
-
ProgramName: string
Title:
Program NameMaximum Length:120The name of the associated maintenance program. -
ProgramOrganizationId: integer
(int64)
Title:
OrganizationThe organization identifier of the associated maintenance program. -
ProgramStartDate: string
(date)
Title:
Start DateRead Only:trueThe start date of the associated maintenance program. -
StandardCoverageYn: string
Maximum Length:
1Indicates whether coverage is standard coverage. The default value is False. -
StartDate: string
(date)
Title:
Start DateThe date when the adjustments was created. -
SubscriptionProductPuid: string
The value that uniquely identifies the subscription product.
Nested Schema : Adjustments
Type:
arrayTitle:
AdjustmentsThe adjustments resource is used to view, create, update, and delete an adjustment. It provides details of adjustment information.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Preventive Maintenance Work Requirements
Type:
arrayTitle:
Preventive Maintenance Work RequirementsThe preventive maintenance work requirements resource is used to get the work requirements of a preventive maintenance program associated with a subscription coverage.
Show Source
Nested Schema : subscriptionCoverageHeaders-CoverageChargeDiscounts-item-response
Type:
Show Source
object-
AdjustmentAmount: number
Title:
ValueThe amount entered for an adjustment type. -
AdjustmentTypeCode: string
Maximum Length:
30The 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 TypeThe 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 adjustmentsMaximum Length:1Indicates whether custom adjustments are allowed. The Default value is True. -
AllowPricingDiscountsFlag: boolean
Title:
Allow pricing discountsMaximum Length:1Indicates whether pricing discounts are allowed. The default value is False. -
BillingTypeCode: string
Maximum Length:
30The 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 TypeThe 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:
30The 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 ProcessThe 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. -
ChargeDefinitionCode: string
Maximum Length:
30The charge definition code. -
ChargeDefinitionId: integer
(int64)
Title:
Charge DefinitionThe charge definition identifier. -
ChargeDefinitionName: string
Title:
Charge DefinitionMaximum Length:255The charge definition name. -
ChargeDiscountId: integer
(int64)
The unique identifier of the adjustment.
-
ChargeSubtypeCode: string
Maximum Length:
30The charge subtype code. -
ChargeTypeCode: string
Maximum Length:
30The charge type code. -
CoverageDiscountPuid: string
Maximum Length:
120The value that uniquely identifies the adjustments. -
CoverageHeaderId: integer
(int64)
The unique identifier of the parent coverage header against an adjustment.
-
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the adjustment. -
CreationDate: string
(date-time)
Read Only:
trueThe date when the adjustment was created. -
CurrencyCode: string
Title:
CurrencyMaximum Length:15The currency code. -
EndDate: string
(date)
Title:
End DateThe date when the coverage adjustment ends. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date when the adjustment was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the adjustment. -
LastUpdateLogin: string
Read Only:
trueMaximum Length:32The name of the user who has last updated the adjustment. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
OrganizationId: integer
(int64)
The organization ID.
-
PriceUOM: string
Title:
Price UOMMaximum Length:255The price UOM. -
PriceUOMCode: string
Title:
Price UOMMaximum Length:3The price UOM code. -
PricingBasisId: integer
Title:
Adjustment BasisThe 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 BasisThe 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 ActivityMaximum Length:80The name of the service activity. A list of accepted values is defined in the view RCL_SERVICE_ACTIVITIES_VL for service activity name. -
ServiceItemId: integer
(int64)
Title:
Service ItemThe service item ID. -
ServiceItemNumber: string
Title:
Service ItemMaximum Length:255The service item number. -
StartDate: string
(date)
Title:
Start DateThe date when the adjustment starts.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed 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 : subscriptionCoverageHeaders-PreventiveMaintenanceWorkRequirements-item-response
Type:
Show Source
object-
ActiveEndDate: string
(date)
Title:
End DateRead Only:trueStart Date -
ActiveStartDate: string
(date)
Title:
Start DateRead Only:trueEnd Date -
AssetInclusionTypeCode: string
Read Only:
trueMaximum Length:30The asset inclusion type code associated with a work requirement. -
ItemId: integer
(int64)
Title:
Related Inventory Item IDRead Only:trueRelated Inventory Item ID -
ItemName: string
Title:
ItemRead Only:trueMaximum Length:240Item -
ItemNumber: string
Read Only:
trueMaximum Length:300The number of the item associated with a work requirement. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
OrganizationId: integer
(int64)
Title:
OrganizationRead Only:trueOrganization -
ProgramId: integer
(int64)
Read Only:
trueThe identifier of the program associated with the work requirement. -
RequirementId: integer
Read Only:
trueThe unique identifier of the work requirement. -
RequirementName: string
Title:
NameRead Only:trueMaximum Length:120Name -
RequirementType: string
Read Only:
trueMaximum Length:80The type of the work requirement. -
RequirementTypeCode: string
Read Only:
trueMaximum Length:30The type code of the work requirement. -
Status: string
Title:
Line StatusRead Only:trueMaximum Length:80Line Status -
StatusCode: string
Title:
Line StatusRead Only:trueMaximum Length:30Line Status
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
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:
- EntitlementTypeVA
-
The following properties are defined on the LOV link relation:
- Source Attribute: DynamicMatrixClassName; Target Attribute: DynamicMatrixClassName
- Display Attribute: DynamicMatrixClassName
- MatrixNameLOVVA
-
Parameters:
- finder:
MatrixNameByMatrixClassFinder%3BbindMatrixClassId%3D{DynamicMatrixClassId}
The following properties are defined on the LOV link relation:- Source Attribute: MatrixName; Target Attribute: DynamicMatrixName
- Display Attribute: DynamicMatrixName
- finder:
- PreventiveMaintenanceProgramsVA
-
Parameters:
- finder:
PreventiveMaintenanceProgramsByEffectivityAndSubTypeAndValidWorkRequirementsFinder
The following properties are defined on the LOV link relation:- Source Attribute: ProgramName; Target Attribute: ProgramName
- Display Attribute: ProgramName, ProgramCode, OrganizationCode, ProgramDescription
- finder:
- PreventiveMaintenanceWorkRequirements
-
Parameters:
- CoverageHeaderPuid:
$request.path.CoverageHeaderPuid
The preventive maintenance work requirements resource is used to get the work requirements of a preventive maintenance program associated with a subscription coverage. - 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"
}
]
}