Skip to end of banner
Go to start of banner

job_ordered_physical_goods_update_parameters

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

 job_ordered_physical_goods object parameter data

Name

Type

Description

action

(mandatory)

String

Defines if a new or existing information will be updated

The supported values are the following

  • ADD
  • UPDATE
  • REMOVE

job_physical_good_identifier

(mandatory and applicable only on update and remove based on conditions)

Job Physical Good identifier

The job physical good that will be updated

The allowed job physical good identifier fields are the following

Name

Type

Description

id

(semi-optional)

String

The ID of the job physical good

installed_item_identifier

(semi-optional)

Installed Item Identifier

The identifier of the installed item related with the Job Physical Good. The allowed installed item identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the installed item

serial_number

(semi-optional)

String

The serial number of the installed item

alternative_code

(semi-optional)

String

The alternative code of  a installed item

product_identifier 

(semi-optional)

 

Product Identifier

The identifier of the physical good product related with the Job Physical Good. The allowed physical good product identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product

code

(semi-optional)

String

The code of the product

alternative_code

(semi-optional)

String

The alternative code of  the product

product_identifier
(mandatory and applicable only on add based on conditions)

Product Identifier

The identifier of the physical good that will be added in the ordered items

The allowed physical good product identifier fields are the following

Name

Type

Description

id

(semi-optional)

String

The ID of the product

code

(semi-optional)

String

The code of the product

alternative_code

(semi-optional)

String

The alternative code of  the product

installed_item_identifier

(mandatory and applicable only on update based on conditions)

Installed Item Identifier

The identifier of the installed item that will be provided based on an ordered physical good

The allowed installed item identifier fields are the following

Name

Type

Description

id

(semi-optional)

String

The ID of the installed item

serial_number

(semi-optional)

String

The serial number of the installed item

alternative_code

(semi-optional)

String

The alternative code of  a installed item

Applicable only if the related job_physical_good_identifier is a traceable physical good

quantity
(optional and applicable only on add and update based on conditions)

Number

The quantity of the requested subscription physical good. If not specified then it is set to 1

Applicable only if one of the following is specified

  • product_identifier (on add)
  • job_physical_good_identifier (on update)

replaced_by_installed_item_identifier

(mandatory and applicable only on update based on conditions)

Installed Item Identifier

The identifier of the installed item that will replace the Job Physical Good Replacement

The allowed installed item identifier fields are the following

Name

Type

Description

id

(semi-optional)

String

The ID of the installed item

serial_number

(semi-optional)

String

The serial number of the installed item

alternative_code

(semi-optional)

String

The alternative code of  a installed item

Applicable only if the installed_item identifier is specified and the related job_physical_good_identifier is owned by the account owner and is not used in any subscriptions

warranty_coverage_reason_identifier

(mandatory and applicable only on update based on conditions)

 

Warranty Coverage Reason Identifier

The Warranty Coverage Reason which indicates if the requested to be replaced installed item's warranty will eventually cover the replacement or not

The allowed warranty coverage reason identifier fields are the following

Name

Type

Description

id

(semi-optional)

String

The ID of the warranty coverage reason

name

(semi-optional)

String

The name of the warranty coverage reason

alternative_code

(semi-optional)

String

The alternative code of the warranty coverage reason

Applicable and mandatory only if the related physical good is an installed item that was requested to be replaced and is still under warranty

notes

(optional)

String

The notes of the job requested subscription physical goods

components_set

(applicable on conditions and only on add)

Set of Product Components objects

The physical good components that should be composing the specified physical good

This information is applicable only if the specified physical good is classified as a flexible product bundle

Referred Parameter Objects Data

 product component object parameter data
Name
Type
Description
product_identifier

(mandatory)

Product identifier  

The identifier of the product component. Only products that are allowed to be added on the related flexible product bundle are retrieved. The allowed product identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product

code

(semi-optional)

String

The code of the product

alternative_code

(semi-optional)

String

The alternative code of  the product

  • No labels