Jump to

• Request
• Response
• Examples

Create one repair time

post

/fscmRestApi/resources/11.13.18.05/assetWarrantyStandardRepairTimes

Request

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.
• 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.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• EndDate: string (date-time)
  Title: Active to Date

  End date of the warranty repair time. This attribute is optional.
• OrganizationCode: string
  Title: Organization Code

  Maximum Length: 255

  Name of the organization.
• OrganizationId: integer
  Title: Organization ID

  Abbreviation that uniquely identifies the organization.
• StandardOperationCode: string
  Title: Standard Operation Code

  Maximum Length: 255

  Abbreviation that uniquely identifies the standard operation. Either a standard operation ID or code is required.
• StandardOperationId: integer (int64)
  Title: Standard Operation ID

  Value that uniquely identifies the standard operation. Either a standard operation ID or code is required.
• StandardRepairTime: number
  Title: Standard Repair Time

  Value that identifies the number of labor hours for which the standard operation will be reimbursed in a warranty claim. This attribute is required.
• StartDate: string (date-time)
  Title: Active from Date

  Start date of the warranty repair time. This attribute is required.
• WarrantyProviderId: integer (int64)
  Title: Warranty Provider ID

  Value that uniquely identifies the warranty provider. Either a provider ID or a number is required.
• WarrantyProviderNumber: string
  Title: Warranty Provider Number

  Maximum Length: 255

  Value that uniquely identifies the supplier number of a warranty provider. Either a provider ID or a number is required.

{
    "type":"object",
    "properties":{
        "StartDate":{
            "title":"Active from Date",
            "type":"string",
            "description":"Start date of the warranty repair time. This attribute is required.",
            "format":"date-time",
            "nullable":true
        },
        "StandardOperationCode":{
            "title":"Standard Operation Code",
            "maxLength":"255",
            "type":"string",
            "description":"Abbreviation that uniquely identifies the standard operation. Either a standard operation ID or code is required.",
            "nullable":true
        },
        "StandardOperationId":{
            "title":"Standard Operation ID",
            "type":"integer",
            "description":"Value that uniquely identifies the standard operation.  Either a standard operation ID or code is required.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18"
            }
        },
        "OrganizationCode":{
            "title":"Organization Code",
            "maxLength":"255",
            "type":"string",
            "description":"Name of the organization.",
            "nullable":true
        },
        "OrganizationId":{
            "title":"Organization ID",
            "type":"integer",
            "description":"Abbreviation that uniquely identifies the organization.",
            "nullable":true,
            "x-queryable":false,
            "x-hints":{
                "dependencies":[
                    "OrganizationId1"
                ]
            }
        },
        "StandardRepairTime":{
            "title":"Standard Repair Time",
            "type":"number",
            "description":"Value that identifies the number of labor hours for which the standard operation will be reimbursed in a warranty claim. This attribute is required.",
            "nullable":false
        },
        "WarrantyProviderId":{
            "title":"Warranty Provider ID",
            "type":"integer",
            "description":"Value that uniquely identifies the warranty provider. Either a provider ID or a number is required.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18"
            }
        },
        "EndDate":{
            "title":"Active to Date",
            "type":"string",
            "description":"End date of the warranty repair time. This attribute is optional.",
            "format":"date-time",
            "nullable":true
        },
        "WarrantyProviderNumber":{
            "title":"Warranty Provider Number",
            "maxLength":"255",
            "type":"string",
            "description":"Value that uniquely identifies the supplier number of a warranty provider. Either a provider ID or a number is required.",
            "nullable":true
        }
    }
}

Back to Top

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.

Body ()

Root Schema : assetWarrantyStandardRepairTimes-item-response

Type: object

Show Source

• CreatedBy: string
  Title: Created By

  Read Only: true

  Maximum Length: 64

  User who created the row.
• CreationDate: string (date-time)
  Title: Creation Date

  Read Only: true

  Date on which the row was created.
• EndDate: string (date-time)
  Title: Active to Date

  End date of the warranty repair time. This attribute is optional.
• LastUpdateDate: string (date-time)
  Title: Last Update Date

  Read Only: true

  Date and time the row was most recently updated.
• LastUpdatedBy: string
  Title: Last Updated By

  Read Only: true

  Maximum Length: 64

  User who last updated the row.
• links: array Links
  Title: Links

  The link relations associated with the resource instance.
• OrganizationCode: string
  Title: Organization Code

  Maximum Length: 255

  Name of the organization.
• OrganizationId: integer
  Title: Organization ID

  Abbreviation that uniquely identifies the organization.
• StandardOperationCode: string
  Title: Standard Operation Code

  Maximum Length: 255

  Abbreviation that uniquely identifies the standard operation. Either a standard operation ID or code is required.
• StandardOperationDescription: string
  Title: Standard Operation Description

  Read Only: true

  Maximum Length: 240

  Description of the standard operation. This is a read-only value.
• StandardOperationId: integer (int64)
  Title: Standard Operation ID

  Value that uniquely identifies the standard operation. Either a standard operation ID or code is required.
• StandardOperationName: string
  Title: Standard Operation Name

  Read Only: true

  Maximum Length: 120

  Name of the standard operation. This is a read-only value.
• StandardRepairTime: number
  Title: Standard Repair Time

  Value that identifies the number of labor hours for which the standard operation will be reimbursed in a warranty claim. This attribute is required.
• StartDate: string (date-time)
  Title: Active from Date

  Start date of the warranty repair time. This attribute is required.
• WarrantyProviderId: integer (int64)
  Title: Warranty Provider ID

  Value that uniquely identifies the warranty provider. Either a provider ID or a number is required.
• WarrantyProviderName: string
  Title: Warranty Provider Name

  Read Only: true

  Maximum Length: 360

  Name of the warranty provider. This is a read-only value.
• WarrantyProviderNumber: string
  Title: Warranty Provider Number

  Maximum Length: 255

  Value that uniquely identifies the supplier number of a warranty provider. Either a provider ID or a number is required.
• WarrantyStandardRepairTimeId: integer (int64)
  Title: Warranty Standard Repair Time ID

  Read Only: true

  Value that uniquely identifies the warranty repair time. The application creates this value when it creates the repair time.

{
    "type":"object",
    "properties":{
        "LastUpdatedBy":{
            "title":"Last Updated By",
            "maxLength":"64",
            "type":"string",
            "description":"User who last updated the row.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "CreationDate":{
            "title":"Creation Date",
            "type":"string",
            "description":"Date on which the row was created.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "StandardOperationCode":{
            "title":"Standard Operation Code",
            "maxLength":"255",
            "type":"string",
            "description":"Abbreviation that uniquely identifies the standard operation. Either a standard operation ID or code is required.",
            "nullable":true,
            "x-queryable":true
        },
        "CreatedBy":{
            "title":"Created By",
            "maxLength":"64",
            "type":"string",
            "description":"User who created the row.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "StandardOperationId":{
            "title":"Standard Operation ID",
            "type":"integer",
            "description":"Value that uniquely identifies the standard operation.  Either a standard operation ID or code is required.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "WarrantyProviderName":{
            "title":"Warranty Provider Name",
            "maxLength":"360",
            "type":"string",
            "description":"Name of the warranty provider. This is a read-only value.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "OrganizationId":{
            "title":"Organization ID",
            "type":"integer",
            "description":"Abbreviation that uniquely identifies the organization.",
            "nullable":true,
            "x-queryable":false,
            "x-hints":{
                "dependencies":[
                    "OrganizationId1"
                ]
            }
        },
        "EndDate":{
            "title":"Active to Date",
            "type":"string",
            "description":"End date of the warranty repair time. This attribute is optional.",
            "format":"date-time",
            "nullable":true,
            "x-queryable":true
        },
        "WarrantyProviderNumber":{
            "title":"Warranty Provider Number",
            "maxLength":"255",
            "type":"string",
            "description":"Value that uniquely identifies the supplier number of a warranty provider. Either a provider ID or a number is required.",
            "nullable":true,
            "x-queryable":true
        },
        "StandardOperationName":{
            "title":"Standard Operation Name",
            "maxLength":"120",
            "type":"string",
            "description":"Name of the standard operation. This is a read-only value.",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        },
        "StartDate":{
            "title":"Active from Date",
            "type":"string",
            "description":"Start date of the warranty repair time. This attribute is required.",
            "format":"date-time",
            "nullable":true,
            "x-queryable":true
        },
        "WarrantyStandardRepairTimeId":{
            "title":"Warranty Standard Repair Time ID",
            "type":"integer",
            "description":"Value that uniquely identifies the warranty repair time. The application creates this value when it creates the repair time.",
            "format":"int64",
            "nullable":false,
            "readOnly":true,
            "x-hints":{
                "precision":"18",
                "fnd:GLOBALLY_UNIQUE":"true"
            },
            "x-queryable":true
        },
        "StandardOperationDescription":{
            "title":"Standard Operation Description",
            "maxLength":"240",
            "type":"string",
            "description":"Description of the standard operation. This is a read-only value.",
            "nullable":true,
            "readOnly":true,
            "x-queryable":true
        },
        "OrganizationCode":{
            "title":"Organization Code",
            "maxLength":"255",
            "type":"string",
            "description":"Name of the organization.",
            "nullable":true,
            "x-queryable":true
        },
        "links":{
            "title":"Links",
            "type":"array",
            "description":"The link relations associated with the resource instance.",
            "items":{
                "$ref":"#/components/schemas/link"
            }
        },
        "StandardRepairTime":{
            "title":"Standard Repair Time",
            "type":"number",
            "description":"Value that identifies the number of labor hours for which the standard operation will be reimbursed in a warranty claim. This attribute is required.",
            "nullable":false,
            "x-queryable":true
        },
        "WarrantyProviderId":{
            "title":"Warranty Provider ID",
            "type":"integer",
            "description":"Value that uniquely identifies the warranty provider. Either a provider ID or a number is required.",
            "format":"int64",
            "nullable":false,
            "x-hints":{
                "precision":"18"
            },
            "x-queryable":true
        },
        "LastUpdateDate":{
            "title":"Last Update Date",
            "type":"string",
            "description":"Date and time the row was most recently updated.",
            "format":"date-time",
            "nullable":false,
            "readOnly":true,
            "x-queryable":true
        }
    }
}

Nested Schema : Links

Type: array

Title: Links

The link relations associated with the resource instance.

Show Source

• Array of: object link

{
    "title":"Links",
    "type":"array",
    "description":"The link relations associated with the resource instance.",
    "items":{
        "$ref":"#/components/schemas/link"
    }
}

Nested Schema : link

Type: object

Show Source

• 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.

{
    "type":"object",
    "properties":{
        "kind":{
            "title":"kind",
            "type":"string",
            "description":"The kind of the related resource.",
            "enum":[
                "collection",
                "item",
                "describe",
                "other"
            ]
        },
        "rel":{
            "title":"relation",
            "type":"string",
            "description":"The name of the relation to the resource instance.  Example: self.",
            "enum":[
                "self",
                "lov",
                "parent",
                "canonical",
                "child",
                "enclosure",
                "action",
                "custom"
            ]
        },
        "name":{
            "title":"name",
            "type":"string",
            "description":"The name of the link to the related resource."
        },
        "href":{
            "title":"hyperlink reference",
            "type":"string",
            "description":"The URI to the related resource."
        },
        "properties":{
            "type":"object",
            "properties":{
                "changeIndicator":{
                    "type":"string",
                    "description":"Change indicator or the ETag value of the resource instance."
                }
            }
        }
    }
}

Nested Schema : properties

Type: object

Show Source

• changeIndicator: string
  Change indicator or the ETag value of the resource instance.

{
    "type":"object",
    "properties":{
        "changeIndicator":{
            "type":"string",
            "description":"Change indicator or the ETag value of the resource instance."
        }
    }
}

Back to Top

Examples

These examples describe how to create a warranty standard repair time.

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/assetWarrantyStandardRepairTimes"

Example 1

This example describes how to create a warranty standard repair time using a number reference for a warranty provider and standard operation. The repair times are considered when warranty claims are created for a warranty repair work order.

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.

{
"WarrantyProviderNumber": 123456,
"StandardOperationCode": "STD_OP_CODE",
"StandardRepairTime": "2.5",
"StartDate": "2021-03-31",
"EndDate": "2023-12-31"
}

Example 1 Response Body

The following example includes the contents of the response body in JSON format:

{
	"WarrantyStandardRepairTimeId": 300100571254518,
       "WarrantyProviderId": 999992000322153,
	"WarrantyProviderNumber": "123456789",
	"WarrantyProviderName": "Provider ABC",
	"StandardOperationId": 300100571252166,
	"StandardOperationCode": "STD_OP_CODE",
	"StandardOperationName": "Standard Operation",
	"StandardOperationDescription": "Standard Operation DESC",
	"StandardRepairTime": 2.5,
	"StartDate": "2021-03-31T00:00:00+00:00",
	"EndDate": "2023-12-31T00:00:00+00:00",
	"CreatedBy": "MNT_QA",
	"CreationDate": "2023-03-17T21:39:50+00:00",
	"LastUpdatedBy": "MNT_QA",
	"LastUpdateDate": "2023-03-17T21:39:50.001+00:00",
	"links": [
		{
			"rel": "self",
			"href": "https://servername/fscmRestApi/resources/version/assetWarrantyStandardRepairTimes/300100582777055",
			"name": "assetWarrantyStandardRepairTimes",
			"kind": "item",
			"properties": {
				"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
			}
		},
		{
			"rel": "canonical",
			"href": "https://servername/fscmRestApi/resources/version/assetWarrantyStandardRepairTimes/300100582777055",
			"name": "assetWarrantyStandardRepairTimes",
			"kind": "item"
		}
	]
}

Example 2

This example describes how to create a warranty standard repair time using an ID reference for a warranty provider and standard operation. The repair times are considered when warranty claims are created for a warranty repair work order.

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.

{
"WarrantyProviderId": 999992000322153,
"StandardOperationCode": "STD_OP_CODE",
"StandardRepairTime": "2.5",
"StartDate": "2024-01-01",
"EndDate": "2024-12-31"
}

Example 2 Response Body

The following example includes the contents of the response body in JSON format:

{
	"WarrantyStandardRepairTimeId": 300100571254518,
       "WarrantyProviderId": 999992000322153,
	"WarrantyProviderNumber": "123456789",
	"WarrantyProviderName": "Provider ABC",
	"StandardOperationId": 300100571252166,
	"StandardOperationCode": "STD_OP_CODE",
	"StandardOperationName": "Standard Operation",
	"StandardOperationDescription": "Standard Operation DESC",
	"StandardRepairTime": 2.5,
	"StartDate": "2021-03-31T00:00:00+00:00",
	"EndDate": "2023-12-31T00:00:00+00:00",
	"CreatedBy": "MNT_QA",
	"CreationDate": "2023-03-17T21:39:50+00:00",
	"LastUpdatedBy": "MNT_QA",
	"LastUpdateDate": "2023-03-17T21:39:50.001+00:00",
	"links": [
		{
			"rel": "self",
			"href": "https://servername/fscmRestApi/resources/version/assetWarrantyStandardRepairTimes/300100582777055",
			"name": "assetWarrantyStandardRepairTimes",
			"kind": "item",
			"properties": {
				"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
			}
		},
		{
			"rel": "canonical",
			"href": "https://servername/fscmRestApi/resources/version/assetWarrantyStandardRepairTimes/300100582777055",
			"name": "assetWarrantyStandardRepairTimes",
			"kind": "item"
		}
	]
}

Back to Top