updateServiceProduct

Description
This transaction updates the details of an existing service product.
Web Services
Operation name: updateServiceProduct
Service name: ProductService
Example
Update the description for the Deposit Box Rental service product.
Usage information

The product type cannot be updated.

UpdateServiceProduct can be used as a coarse-grained transaction to add or update the following business objects:
  • ProductIdentifierBObj
  • ProductAdminSysKeyBObj
  • ProductCategoryAssociationBObj
  • ProductRelationshipBObj
  • ProductSpecValueBOBj
  • TermConditionBObj

Localized content can be added for the Name, ShortDescription, and Description elements. Product spec values can also be localized.

For more information about root products, variant products, product spec values and related rules, see the transaction updateProductInstance.

Preconditions
When adding or updating a relationship to another product, that product must exist.

When adding or updating an association to a category, that category must exist and allow products to be categorized to it. Also the product cannot already be in that category for the start and end dates provided.

When adding or updating product spec values, the spec usage on which the values are based must be active.

Mandatory input
  • ProductId
  • ProductLastUpdateDate
  • ServiceProductLastUpdateDate
Inquiry levels
Not applicable
Filter values
Not applicable
Transaction behavior
When adding or updating product spec values, all product spec values are validated against the provided spec format.
When adding or updating a ProductSpecValueBObj, either the SpecFormatId (associated with the ProductSpecValueBObj) or the target SpecNameSpace in the XML document must be provided.
  • If one of these values is missing, both SpecFormatId and SpecNameSpace will be available and in synch before validation. In other words, they will both identify the same Spec format.
  • If both the SpecFormatId and the SpecNameSpace are provided, validation is performed to ensure that they both identify the same Spec format.

When adding a TermConditionBObj, an EntityConditionAssociationBObj is required. Within the EntityConditionAssociationBObj, the EntityName must be either PRODUCT or PRODUCTREL.

Request message

<TCRMTxType> updateServiceProduct

<TCRMTxObject> ServiceProductBObj

<TCRMObject> ServiceProductBObj

with optional business objects:
Response objects
ServiceProductBObj
with optional child business objects:
Special note
Not applicable