Create one claim
/fscmRestApi/resources/11.13.18.05/assetWarrantyClaims
Request
-
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.
-
Upsert-Mode:
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
- application/json
object-
ActiveEndDate: string
(date)
Title:
Active End DateDate that indicates if a claim is disabled. This date is set by the disabled flag = true. -
ClaimAdjustmentAmount: number
Title:
Claim Adjustment AmountDefault Value:0Total amount of the adjustments to the claim total. -
ClaimAssignedId: integer
(int64)
Title:
Claim Assigned To IDValue that uniquely identifies the employee who is assigned to the claim. -
ClaimAssignedToName: string
Title:
Claim Assigned ToMaximum Length:255Name of the employee who is assigned to the claim. -
ClaimCurrencyConversionRate: number
Title:
Currency Conversion RateRate of a claim currency converstion. -
ClaimCurrencyConversionType: string
Title:
Currency Conversion TypeMaximum Length:30Type of a claim currency converstion. -
ClaimCurrencyConversionTypeCode: string
Title:
Currency Conversion Type CodeMaximum Length:30Abbreviation that uniquely identifies the claim currency conversion type. A list of accepted values is defined in the lookup type. This attribute is optional to create the warranty claim. -
ClaimDate: string
(date)
Title:
Claim DateDate of a warranty claim. This value is required. -
ClaimDescription: string
Title:
Claim DescriptionMaximum Length:240Detailed description of the claim. -
ClaimNotes: string
Title:
Claim NotesMaximum Length:4000Notes of the warranty claim. -
ClaimReference: string
Title:
Claim ReferenceMaximum Length:120Reference of a warranty claim reimbursement. -
ClaimReimbursementAmount: number
Title:
Reimbursement AmountDefault Value:0Total amount of the claim reimbursement. -
ClaimReimbursementTypeCode: string
Title:
Reimbursement Type CodeMaximum Length:30Abbreviation that uniquely identifies the type of claim reimbursement. A list of accepted values is defined in the lookup type ORA_CSE_WTY_CLAIM_REIMB_TYPE. This attribute is optional for creating the warranty claim. -
ClaimResolutionDate: string
(date)
Title:
Claim Resolution DateResolution Date of the warranty claim. This value is optional. -
ClaimStatusCode: string
Title:
Claim Status CodeMaximum Length:30Default Value:ORA_PENDING_REVIEWAbbreviation that uniquely identifies the claim status. A list of accepted values is defined in the lookup type ORA_CSE_WTY_CLAIMS_STATUS. This attribute is required to create the warranty claim. -
ClaimSubmitByDate: string
(date)
Title:
Claim Submit by DateDate in which you must submit a claim to the provider. -
ClaimTypeCode: string
Title:
Claim Type CodeMaximum Length:30Abbreviation that uniquely identifies the claim type. A list of accepted values is defined in the lookup type ORA_CSE_WTY_CLAIMS_TYPE. This attribute is optional to create the warranty claim. -
ManuallyCreatedFlag: boolean
Title:
Manually Created IndicatorMaximum Length:1Indicates if a claim is manually created or not. -
ObjectId: integer
(int64)
Title:
Object IDValue that uniquely identifies the the object for which the claim was created. -
ObjectTypeCode: string
Title:
Object Type CodeMaximum Length:30Abbreviation that uniquely identifies the object for which the claim was created. A list of accepted values is defined in the lookup type ORA_CSE_WTY_CLAIM_OBJECT_TYPE. This attribute is required to create the warranty claim. -
WarrantyProviderId: integer
(int64)
Title:
Warranty Provider IDValue that uniquely identifies the warranty provider who provides warranty coverage. -
WarrantyProviderLaborRate: number
Title:
Hourly RateValue for the hourly labor rate for the provider. -
WarrantyProviderNumber: string
Title:
Warranty Provider IDMaximum Length:255Number that uniquely identifies the warranty provider who provides warranty coverage.
Response
- application/json
Default Response
-
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.
object-
ActiveEndDate: string
(date)
Title:
Active End DateDate that indicates if a claim is disabled. This date is set by the disabled flag = true. -
AssetDescription: string
Title:
Asset DescriptionRead Only:trueMaximum Length:255Description of the asset. -
AssetId: integer
Title:
Asset IDRead Only:trueValue that uniquely identifies an asset. -
AssetNumber: string
Title:
Asset NumberRead Only:trueMaximum Length:255Number that uniquely identifies an asset. -
AssetSerialNumber: string
Title:
Asset Serial NumberRead Only:trueMaximum Length:255Serial number of the asset. -
ClaimAdjustmentAmount: number
Title:
Claim Adjustment AmountDefault Value:0Total amount of the adjustments to the claim total. -
ClaimAssignedId: integer
(int64)
Title:
Claim Assigned To IDValue that uniquely identifies the employee who is assigned to the claim. -
ClaimAssignedToName: string
Title:
Claim Assigned ToMaximum Length:255Name of the employee who is assigned to the claim. -
ClaimCurrency: string
Title:
Claim CurrencyRead Only:trueMaximum Length:255Name of the claim amount currency code. -
ClaimCurrencyCode: string
Title:
Claim Currency CodeRead Only:trueMaximum Length:20Abbreviation that uniquely identifies the currency code of the claim amount. -
ClaimCurrencyConversionRate: number
Title:
Currency Conversion RateRate of a claim currency converstion. -
ClaimCurrencyConversionType: string
Title:
Currency Conversion TypeMaximum Length:30Type of a claim currency converstion. -
ClaimCurrencyConversionTypeCode: string
Title:
Currency Conversion Type CodeMaximum Length:30Abbreviation that uniquely identifies the claim currency conversion type. A list of accepted values is defined in the lookup type. This attribute is optional to create the warranty claim. -
ClaimDate: string
(date)
Title:
Claim DateDate of a warranty claim. This value is required. -
ClaimDescription: string
Title:
Claim DescriptionMaximum Length:240Detailed description of the claim. -
ClaimEquipmentAmount: number
Title:
Work Order Equipment CostRead Only:trueDefault Value:0Total amount of the equipment claimed for reimbursement in the claim. -
ClaimId: integer
(int64)
Title:
Claim IDRead Only:trueValue that uniquely identifies the warranty claim. The application creates this value when it creates the claim. -
ClaimMaterialAmount: number
Title:
Work Order Material CostRead Only:trueDefault Value:0Total amount of the materials claimed for reimbursement in the claim. -
ClaimNotes: string
Title:
Claim NotesMaximum Length:4000Notes of the warranty claim. -
ClaimNumber: string
Title:
Claim NumberRead Only:trueMaximum Length:80Number that uniquely identifies the warranty claim. The application creates this value when it creates the claim. -
ClaimOtherAmount: number
Title:
Claim Other AmountRead Only:trueDefault Value:0Total amount of the other repairs claimed for reimbursement in the claim. -
ClaimReference: string
Title:
Claim ReferenceMaximum Length:120Reference of a warranty claim reimbursement. -
ClaimReimbursementAmount: number
Title:
Reimbursement AmountDefault Value:0Total amount of the claim reimbursement. -
ClaimReimbursementType: string
Title:
Reimbursement TypeRead Only:trueMaximum Length:80Type of claim reimbursement. -
ClaimReimbursementTypeCode: string
Title:
Reimbursement Type CodeMaximum Length:30Abbreviation that uniquely identifies the type of claim reimbursement. A list of accepted values is defined in the lookup type ORA_CSE_WTY_CLAIM_REIMB_TYPE. This attribute is optional for creating the warranty claim. -
ClaimResolutionDate: string
(date)
Title:
Claim Resolution DateResolution Date of the warranty claim. This value is optional. -
ClaimResourceAmount: number
Title:
Work Order Labor CostRead Only:trueDefault Value:0Total amount of the resources claimed for reimbursement in the claim. -
ClaimStandardRepairAmount: number
Title:
Claim Standard Repair AmountRead Only:trueDefault Value:0Total amount of the standard repairs claimed for reimbursement in the claim. -
ClaimStatus: string
Title:
Claim StatusRead Only:trueMaximum Length:80Status of a warranty claim. -
ClaimStatusCode: string
Title:
Claim Status CodeMaximum Length:30Default Value:ORA_PENDING_REVIEWAbbreviation that uniquely identifies the claim status. A list of accepted values is defined in the lookup type ORA_CSE_WTY_CLAIMS_STATUS. This attribute is required to create the warranty claim. -
ClaimSubmitByDate: string
(date)
Title:
Claim Submit by DateDate in which you must submit a claim to the provider. -
ClaimSubmitByNumberOfDays: number
Title:
Submission Due InRead Only:trueValue for the number of days to submit a claim to the provider. -
ClaimTotalAmount: number
Title:
Claim AmountRead Only:trueDefault Value:0Total amount of the claim. -
ClaimType: string
Title:
Claim TypeRead Only:trueMaximum Length:80Type of a warranty claim. -
ClaimTypeCode: string
Title:
Claim Type CodeMaximum Length:30Abbreviation that uniquely identifies the claim type. A list of accepted values is defined in the lookup type ORA_CSE_WTY_CLAIMS_TYPE. This attribute is optional to create the warranty claim. -
CreatedBy: string
Read Only:
trueMaximum Length:64Login username of the user who created the record. -
CreationDate: string
(date-time)
Read Only:
trueDate when the record was created. -
LastUpdateDate: string
(date-time)
Read Only:
trueDate when the record was updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64Login user name of the user who updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ManuallyCreatedFlag: boolean
Title:
Manually Created IndicatorMaximum Length:1Indicates if a claim is manually created or not. -
MatchToTransactionCodeFlag: boolean
Title:
Match Transaction CodesRead Only:trueMaximum Length:1Indicates if the claim entitlements were created only for cost transations with matching repair transaction coding to warranty contracts. -
ObjectId: integer
(int64)
Title:
Object IDValue that uniquely identifies the the object for which the claim was created. -
ObjectType: string
Title:
Object TypeRead Only:trueMaximum Length:80Name of the object for which the claim was created. -
ObjectTypeCode: string
Title:
Object Type CodeMaximum Length:30Abbreviation that uniquely identifies the object for which the claim was created. A list of accepted values is defined in the lookup type ORA_CSE_WTY_CLAIM_OBJECT_TYPE. This attribute is required to create the warranty claim. -
OrganizationCode: string
Title:
Organization CodeRead Only:trueMaximum Length:18Abbreviation that uniquely identifies the work order organization. -
OrganizationId: integer
(int64)
Title:
Organization IDRead Only:trueValue that uniquely identifies the work order organization. -
PrimaryReasonForRepairCode: string
Title:
Primary Reason for Repair CodeRead Only:trueMaximum Length:30Abbreviation that uniquely identifies the work order operation reason for repair code. -
PrimaryReasonForRepairName: string
Title:
Primary Reason for RepairRead Only:trueMaximum Length:240Name of the work order operation reason for repair code. -
RootAssetId: integer
Title:
Root Asset IDRead Only:trueValue that uniquely identifies a root asset. -
WarrantyProviderId: integer
(int64)
Title:
Warranty Provider IDValue that uniquely identifies the warranty provider who provides warranty coverage. -
WarrantyProviderLaborRate: number
Title:
Hourly RateValue for the hourly labor rate for the provider. -
WarrantyProviderName: string
Title:
Warranty Provider NameRead Only:trueMaximum Length:360Name of the warranty provider who provides warranty coverage. -
WarrantyProviderNumber: string
Title:
Warranty Provider IDMaximum Length:255Number that uniquely identifies the warranty provider who provides warranty coverage. -
WorkOrderEquipmentCost: number
Title:
Work Order Equipment CostRead Only:trueTotal cost of the equipment resources transacted in the work order. -
WorkOrderId: integer
(int64)
Title:
Work Order IDRead Only:trueValue that uniquely identifies the work order associated to the warranty claim. This attribute is read-only. -
WorkOrderLaborCost: number
Title:
Work Order Labor CostRead Only:trueTotal cost of the people resources transacted in the work order. -
WorkOrderMaterialCost: number
Title:
Work Order Material CostRead Only:trueTotal cost of the materials transacted in the work order. -
WorkOrderNumber: string
Title:
Work Order NumberRead Only:trueMaximum Length:120Number that uniquely identifies the work order for the claim. -
WorkOrderStatus: string
Title:
Work Order StatusRead Only:trueMaximum Length:120Name of the work order status. -
WorkOrderStatusCode: string
Title:
Work Order Status CodeRead Only:trueMaximum Length:30Abbreviation that uniquely identifies the work order status. -
WorkOrderTotalCost: number
Title:
Work Order Total CostRead Only:trueTotal cost of the work order.
arrayLinksobject-
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.
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Examples
Example cURL Command
Use the following cURL command to submit a request on the REST resource.
curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.resourceitem+json" -d 'request payload' "https://servername/fscmRestApi/resources/version/assetWarrantyClaims"
Example 1
This example describes how to create a warranty claim using a work order and a warranty provider number reference.
Example 1 Request Body
The following example includes the contents of the request body in JSON format. You replace the request payload in the cURL command with the contents of the Example Request Body. The request payload specifies attribute values that the command will use in the record that it updates.
{
"ObjectTypeCode": "ORA_WORK_ORDER",
"ObjectId": 300100571254590,
"WarrantyProviderNumber": "44111"
}
Example 1 Response Body
The following example includes the contents of the response body in JSON format:
{
"ClaimId": 300100573922592,
"ClaimNumber": "300100573922592",
"ClaimDate": "2019-12-11",
"ObjectTypeCode": "ORA_WORK_ORDER",
"ObjectType": "Work order",
"ObjectId": 64448,
"ClaimStatusCode": "ORA_PENDING_REVIEW",
"ClaimStatus": "Pending review",
"ClaimTypeCode": null,
"ClaimType": null,
"ManuallyCreatedFlag": true,
"WorkOrderNumber": "MNTALM1031",
"WorkOrderStatusCode": "ORA_COMPLETED",
"WorkOrderStatus": "Completed",
"OrganizationId": 300100113363336,
"OrganizationCode": "MNTALM",
"AssetId": 300100185519885,
"AssetNumber": "Asset_01",
"AssetDescription": "Asset_01",
"AssetSerialNumber": null,
"RootAssetId": null,
"MatchToTransactionCodeFlag": null,
"PrimaryReasonForRepairCode": null,
"PrimaryReasonForRepairName": null,
"WarrantyProviderId": 999992000329389,
"WarrantyProviderNumber": "44111",
"WarrantyProviderName": "CORNER BAKERY INC",
"WarrantyProviderLaborRate": null,
"ClaimSubmitByNumberOfDays": null,
"ClaimSubmitByDate": "2023-03-23",
"ClaimAssignedId": null,
"ClaimAssignedToName": null,
"WorkOrderMaterialCost": 0,
"WorkOrderLaborCost": 0,
"WorkOrderEquipmentCost": 0,
"WorkOrderTotalCost": 0,
"ClaimMaterialAmount": 0,
"ClaimResourceAmount": 0,
"ClaimEquipmentAmount": 0,
"ClaimStandardRepairAmount": 0,
"ClaimOtherAmount": 0,
"ClaimAdjustmentAmount": 0,
"ClaimTotalAmount": 0,
"ClaimCurrencyCode": null,
"ClaimCurrency": null,
"ClaimDescription": "300100573922592",
"ClaimResolutionDate": null,
"ClaimReference": null,
"ClaimReimbursementTypeCode": null,
"ClaimReimbursementType": null,
"ClaimReimbursementAmount": 0,
"ClaimCurrencyConversionTypeCode": null,
"ClaimCurrencyConversionType": null,
"ClaimCurrencyConversionRate": null,
"ClaimNotes": null,
"ActiveEndDate": null,
"CreatedBy": "MNT_QA",
"CreationDate": "2023-03-23T18:46:29+00:00",
"LastUpdatedBy": "MNT_QA",
"LastUpdateDate": "2023-03-23T18:46:29.002+00:00",
"links": [
{
"rel": "self",
"href": "http://servername/fscmRestApi/resources/version/assetWarrantyClaims/300100573922592",
"name": "assetWarrantyClaims",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
}
},
{
"rel": "canonical",
"href": "http://servername/fscmRestApi/resources/version/assetWarrantyClaims/300100573922592",
"name": "assetWarrantyClaims",
"kind": "item"
}
]
}
Example 2
This example describes how to create a warranty claim using a work order and a warranty provider ID reference.
Example 2 Request Body
The following example includes the contents of the request body in JSON format. You replace the request payload in the cURL command with the contents of the Example Request Body. The request payload specifies attribute values that the command will use in the record that it updates.
{
"ObjectTypeCode": "ORA_WORK_ORDER",
"ObjectId": 300100571254590,
"WarrantyProviderId": 999992000322154,
"ClaimStatusCode": "ORA_PENDING_REVIEW",
"ClaimAssignedId": 123456
}
Example 2 Response Body
The following example includes the contents of the response body in JSON format:
{
"ClaimId": 300100573922592,
"ClaimNumber": "300100573922592",
"ClaimDate": "2019-12-11",
"ObjectTypeCode": "ORA_WORK_ORDER",
"ObjectType": "Work order",
"ObjectId": 64448,
"ClaimStatusCode": "ORA_PENDING_REVIEW",
"ClaimStatus": "Pending review",
"ClaimTypeCode": null,
"ClaimType": null,
"ManuallyCreatedFlag": true,
"WorkOrderNumber": "MNTALM1031",
"WorkOrderStatusCode": "ORA_COMPLETED",
"WorkOrderStatus": "Completed",
"OrganizationId": 300100113363336,
"OrganizationCode": "MNTALM",
"AssetId": 300100185519885,
"AssetNumber": "Asset_01",
"AssetDescription": "Asset_01",
"AssetSerialNumber": null,
"RootAssetId": null,
"MatchToTransactionCodeFlag": null,
"PrimaryReasonForRepairCode": null,
"PrimaryReasonForRepairName": null,
"WarrantyProviderId": 999992000329389,
"WarrantyProviderNumber": "44111",
"WarrantyProviderName": "CORNER BAKERY INC",
"WarrantyProviderLaborRate": null,
"ClaimSubmitByNumberOfDays": null,
"ClaimSubmitByDate": "2023-03-23",
"ClaimAssignedId": null,
"ClaimAssignedToName": null,
"WorkOrderMaterialCost": 0,
"WorkOrderLaborCost": 0,
"WorkOrderEquipmentCost": 0,
"WorkOrderTotalCost": 0,
"ClaimMaterialAmount": 0,
"ClaimResourceAmount": 0,
"ClaimEquipmentAmount": 0,
"ClaimStandardRepairAmount": 0,
"ClaimOtherAmount": 0,
"ClaimAdjustmentAmount": 0,
"ClaimTotalAmount": 0,
"ClaimCurrencyCode": null,
"ClaimCurrency": null,
"ClaimDescription": "300100573922592",
"ClaimResolutionDate": null,
"ClaimReference": null,
"ClaimReimbursementTypeCode": null,
"ClaimReimbursementType": null,
"ClaimReimbursementAmount": 0,
"ClaimCurrencyConversionTypeCode": null,
"ClaimCurrencyConversionType": null,
"ClaimCurrencyConversionRate": null,
"ClaimNotes": null,
"ActiveEndDate": null,
"CreatedBy": "MNT_QA",
"CreationDate": "2023-03-23T18:46:29+00:00",
"LastUpdatedBy": "MNT_QA",
"LastUpdateDate": "2023-03-23T18:46:29.002+00:00",
"links": [
{
"rel": "self",
"href": "http://servername/fscmRestApi/resources/version/assetWarrantyClaims/300100573922592",
"name": "assetWarrantyClaims",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
}
},
{
"rel": "canonical",
"href": "http://servername/fscmRestApi/resources/version/assetWarrantyClaims/300100573922592",
"name": "assetWarrantyClaims",
"kind": "item"
}
]
}