- Updates a merchandise with the specified ID.
This method will update an existing merchandise with the specified ID.
The updated merchandise that will be saved.
If this product is inventoried, whether or not inventories are allowed
If true, the customer can choose their installment plan
Whether to track inventory for the entire bundle, or for each product separately
Whether or not cancellation fees are applicable
If set, document entitlements will be created to access folders or documents
If true, purchasing this product will generate coupons
If set, the order engine will call out to a custom lambda function for custom/complex pricing
If set, document entitlements will be created to access folders or documents
When sent, customers can change products with customization modifiers
If enabled, a custom email goes out whenever this product is ordered
If true, purchase limits are in place for this product
If set, purchases of this merchandise are restricted
When sent, customers can change products with variant options
Whether or not this product should be available in the portal
If this record was loaded via bulk, the timestamp when the record was processed
If this record was loaded via bulk, the ID of the bulk load process
If this record was loaded via bulk, the tenant and key of the bulk load process used as a partition key
If this record was loaded via bulk, the record number in the source file
If this record was loaded via bulk, the source file
The error associated with the calculated field
If a snapshot was restored/applies to this record, the ID of the snapshot
The date/time that this record was created, expressed in ISO-8601 date format
The ID of the user that deleted (or last tried to delete) this object
Means for passing directive information into an object processing logic
If true, this record has files in S3. If false, it doesnt, so no need to hit S3 upon deletion
If this record was last touched by a bulk data operation, the ID of that operation
If this record was last touched by a bulk data operation, the sys_version at the time of that operation
The date/time that this record record was last modified, expressed in ISO-8601 date format
The ID of the user that last modified this record
The security context of the last insert, modify, or delete performed on this item
The version to use as a base when creating a configuration snapshot; if not set, 1 is used. Helpful when creating a sandbox
A number representing the version of this record in the database
- Mock serverhttps://docs.api.rhythmsoftware.com/_mock/apis/commerce/commerce-v1/merchandise/{tenantId}/{id}
- https://commerce.api.rhythmsoftware.comhttps://commerce.api.rhythmsoftware.com/merchandise/{tenantId}/{id}
curl -i -X PUT \
'https://docs.api.rhythmsoftware.com/_mock/apis/commerce/commerce-v1/merchandise/{tenantId}/{id}' \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"additional_image_urls": [
"string"
],
"allow_back_orders": true,
"allow_customer_to_choose_installment_plan": true,
"bulk_pricing_rules": [
{
"discount_amount": 0,
"discount_type": "flat rate",
"ending_range": 0,
"starting_range": 0
}
],
"bundled_products": [
{
"member_price": 0.1,
"price": 0.1,
"product_id": "string",
"product_type": "string",
"quantity": 0,
"type": "bundled product"
}
],
"bundled_products_inventory_handling": "bundle",
"business_unit_id": "string",
"cancellation_fee": 0.1,
"category_ids": [
"string"
],
"commerce_entitlements_to_create": [
{
"expiration_date": "2019-08-24T14:15:22Z",
"expiration_type": "none",
"quantity": 0.1,
"relative_expiration_date": {
"number": null,
"position": "after",
"relative_to": "the beginning of the month",
"unit_of_time": "days"
},
"type_id": "string"
}
],
"coupon_codes": [
{
"coupon_code_generation_process_id": "string",
"coupon_code_type": "multi use",
"coupon_id": "string",
"coupon_type": "string",
"expiration_date": "2019-08-24T14:15:22Z",
"expiration_type": "none",
"maximum_number_of_total_uses": 1,
"maximum_number_of_uses_per_customer": 1,
"quantity": 250,
"relative_expiration_date": {
"number": null,
"position": "after",
"relative_to": "the beginning of the month",
"unit_of_time": "days"
},
"restrict_to_contact": true,
"restrict_to_organization": true
}
],
"custom_field_values": [
{
"boolean_value": true,
"custom_field_id": "string",
"file_url_value": "string",
"list_value": [
"string"
],
"numeric_value": 0.1,
"string_value": "string",
"table_value": [
{}
]
}
],
"custom_pricing_options": {
"lambda_function_id": "string"
},
"date_added": "string",
"description": "string",
"document_entitlements_to_create": [
{
"expiration_date": "2019-08-24T14:15:22Z",
"expiration_type": "none",
"file_cabinet_id": "string",
"item_id": "string",
"library_path": "string",
"relative_expiration_date": {
"number": null,
"position": "after",
"relative_to": "the beginning of the month",
"unit_of_time": "days"
}
}
],
"enable_bulk_pricing": true,
"enable_bundled_products": true,
"enable_cancellation_fees": true,
"enable_commerce_entitlement_creation": true,
"enable_coupon_code_generation": true,
"enable_custom_pricing": true,
"enable_document_entitlement_creation": true,
"enable_modifier_options": true,
"enable_product_confirmation_email": true,
"enable_purchase_limits": true,
"enable_purchasing_eligibility": true,
"enable_restocking_fees": true,
"enable_special_prices": true,
"enable_task_generation": true,
"enable_variant_options": true,
"featured_options": {
"featured_from": "2019-08-24T14:15:22Z",
"featured_until": "2019-08-24T14:15:22Z"
},
"featured_product": true,
"foreign_currency_prices": [
{
"cancellation_fee": 0.1,
"currency_code": "AED",
"member_price": 0.1,
"mode": "calculate price",
"price": 0.1,
"restocking_fee": 0.1
}
],
"hide_from_portal": true,
"id": "string",
"image_url": "string",
"installment_plan_options": [
{
"additional_cost": 0.1,
"installment_plan_id": "string",
"is_default": true
}
],
"is_active": true,
"member_price": 0.1,
"modifier_options": [
{
"ad_hoc_modifier_options": {
"default_value": "string",
"enable_character_restriction": true,
"id": "string",
"maximum_number_of_characters": 0.1,
"name": "string",
"type": "checkbox",
"values": [
"string"
]
},
"required": true,
"shared_modifier_options": {
"shared_modifier_option_id": "string"
},
"type": "ad hoc"
}
],
"modifier_rules": [
{
"enable_price_adjustment": true,
"enable_weight_adjustment": true,
"option_id": "string",
"price_adjustment_options": {
"affects": "both",
"amount": 0.1,
"operation": "add"
},
"trigger_values": [
"string"
],
"weight_adjustment_options": {
"amount": 0.1,
"operation": "add"
}
}
],
"name": "string",
"new_until": "2019-08-24T14:15:22Z",
"notes": "string",
"portal_options": {
"available_from": "2019-08-24T14:15:22Z",
"available_until": "2019-08-24T14:15:22Z"
},
"price": 0.1,
"product_confirmation_email_options": {
"product_confirmation_email_id": "string",
"product_specific_email": {
"bcc": "string",
"body": "string",
"cc": "string",
"from": "string",
"from_name": "string",
"reply_to": "string",
"subject": "string"
},
"type": "product specific"
},
"publish_to_portal": true,
"purchase_limits": {
"error_message": "string",
"maximum": 0.1,
"relative_time_window": {
"number": null,
"position": "after",
"relative_to": "the beginning of the month",
"unit_of_time": "days"
},
"time_period": "all time",
"type": "per customer"
},
"purchasing_eligibility_criteria": {},
"reorder_point": 0,
"restocking_fee": 0.1,
"sellable_from": "2019-08-24T14:15:22Z",
"sellable_until": "2019-08-24T14:15:22Z",
"shippable": true,
"sort_order": 0.1,
"special_prices": [
{
"criteria": {},
"enable_formula": true,
"formula": "string",
"name": "string",
"price": 0.1
}
],
"sys_bulk_load_at": "string",
"sys_bulk_load_id": "string",
"sys_bulk_load_pk": "string",
"sys_bulk_load_record_no": 0.1,
"sys_bulk_load_source_file": "string",
"sys_calculated_field_error": "string",
"sys_calculated_field_errors": [
{
"error": "string",
"field": "string"
}
],
"sys_configuration_snapshot_id": "string",
"sys_created_at": "2019-08-24T14:15:22Z",
"sys_created_by_id": "string",
"sys_deleted_by_id": "string",
"sys_directive": "string",
"sys_external_id": "string",
"sys_has_files_in_s3": true,
"sys_last_bulk_data_operation_id": "string",
"sys_last_bulk_data_operation_sys_version": "string",
"sys_last_modified_at": "2019-08-24T14:15:22Z",
"sys_last_modified_by_id": "string",
"sys_last_security_context": {},
"sys_locked": true,
"sys_snapshot_base_version": 0.1,
"sys_version": 0.1,
"tasks_to_generate": [
{
"assignee_type": "assignment role",
"assignment_role_id": "string",
"description": "string",
"due_date_type": "none",
"name": "string",
"notify_assignees": true,
"priority": "high",
"queue_id": "string",
"relative_due_date": {
"number": null,
"position": "after",
"relative_to": "the beginning of the month",
"unit_of_time": "days"
},
"specific_due_date": "2019-08-24T14:15:22Z",
"type_id": "string",
"user_id": "string"
}
],
"track_inventory": true,
"track_inventory_by": "product",
"type": "commerce-merchandise",
"variant_options": [
{
"ad_hoc_variant_options": {
"default_value": "string",
"id": "string",
"name": "string",
"type": "dropdown",
"values": [
"string"
]
},
"shared_variant_options": {
"shared_variant_option_id": "string"
},
"type": "ad hoc"
}
],
"variants": [
{
"image_uri": "string",
"member_price": 0.1,
"not_purchasable": true,
"options": [
{
"option_id": "string",
"value": "string"
}
],
"price": 0.1,
"sku": "string",
"weight": 0.1
}
],
"weight": 0.1
}'The merchandise was updated successfully.
If this product is inventoried, whether or not inventories are allowed
If true, the customer can choose their installment plan
Whether to track inventory for the entire bundle, or for each product separately
Whether or not cancellation fees are applicable
If set, document entitlements will be created to access folders or documents
If true, purchasing this product will generate coupons
If set, the order engine will call out to a custom lambda function for custom/complex pricing
If set, document entitlements will be created to access folders or documents
When sent, customers can change products with customization modifiers
If enabled, a custom email goes out whenever this product is ordered
If true, purchase limits are in place for this product
If set, purchases of this merchandise are restricted
When sent, customers can change products with variant options
Whether or not this product should be available in the portal
If this record was loaded via bulk, the timestamp when the record was processed
If this record was loaded via bulk, the ID of the bulk load process
If this record was loaded via bulk, the tenant and key of the bulk load process used as a partition key
If this record was loaded via bulk, the record number in the source file
If this record was loaded via bulk, the source file
The error associated with the calculated field
If a snapshot was restored/applies to this record, the ID of the snapshot
The date/time that this record was created, expressed in ISO-8601 date format
The ID of the user that deleted (or last tried to delete) this object
Means for passing directive information into an object processing logic
If true, this record has files in S3. If false, it doesnt, so no need to hit S3 upon deletion
If this record was last touched by a bulk data operation, the ID of that operation
If this record was last touched by a bulk data operation, the sys_version at the time of that operation
The date/time that this record record was last modified, expressed in ISO-8601 date format
The ID of the user that last modified this record
The security context of the last insert, modify, or delete performed on this item
The version to use as a base when creating a configuration snapshot; if not set, 1 is used. Helpful when creating a sandbox
A number representing the version of this record in the database
{ "additional_image_urls": [ "string" ], "allow_back_orders": true, "allow_customer_to_choose_installment_plan": true, "bulk_pricing_rules": [ { … } ], "bundled_products": [ { … } ], "bundled_products_inventory_handling": "bundle", "business_unit_id": "string", "cancellation_fee": 0.1, "category_ids": [ "string" ], "commerce_entitlements_to_create": [ { … } ], "coupon_codes": [ { … } ], "custom_field_values": [ { … } ], "custom_pricing_options": { "lambda_function_id": "string" }, "date_added": "string", "description": "string", "document_entitlements_to_create": [ { … } ], "enable_bulk_pricing": true, "enable_bundled_products": true, "enable_cancellation_fees": true, "enable_commerce_entitlement_creation": true, "enable_coupon_code_generation": true, "enable_custom_pricing": true, "enable_document_entitlement_creation": true, "enable_modifier_options": true, "enable_product_confirmation_email": true, "enable_purchase_limits": true, "enable_purchasing_eligibility": true, "enable_restocking_fees": true, "enable_special_prices": true, "enable_task_generation": true, "enable_variant_options": true, "featured_options": { "featured_from": "2019-08-24T14:15:22Z", "featured_until": "2019-08-24T14:15:22Z" }, "featured_product": true, "foreign_currency_prices": [ { … } ], "hide_from_portal": true, "id": "string", "image_url": "string", "installment_plan_options": [ { … } ], "is_active": true, "member_price": 0.1, "modifier_options": [ { … } ], "modifier_rules": [ { … } ], "name": "string", "new_until": "2019-08-24T14:15:22Z", "notes": "string", "portal_options": { "available_from": "2019-08-24T14:15:22Z", "available_until": "2019-08-24T14:15:22Z" }, "price": 0.1, "product_confirmation_email_options": { "product_confirmation_email_id": "string", "product_specific_email": { … }, "type": "product specific" }, "publish_to_portal": true, "purchase_limits": { "error_message": "string", "maximum": 0.1, "relative_time_window": { … }, "time_period": "all time", "type": "per customer" }, "purchasing_eligibility_criteria": {}, "reorder_point": 0, "restocking_fee": 0.1, "sellable_from": "2019-08-24T14:15:22Z", "sellable_until": "2019-08-24T14:15:22Z", "shippable": true, "sort_order": 0.1, "special_prices": [ { … } ], "sys_bulk_load_at": "string", "sys_bulk_load_id": "string", "sys_bulk_load_pk": "string", "sys_bulk_load_record_no": 0.1, "sys_bulk_load_source_file": "string", "sys_calculated_field_error": "string", "sys_calculated_field_errors": [ { … } ], "sys_configuration_snapshot_id": "string", "sys_created_at": "2019-08-24T14:15:22Z", "sys_created_by_id": "string", "sys_deleted_by_id": "string", "sys_directive": "string", "sys_external_id": "string", "sys_has_files_in_s3": true, "sys_last_bulk_data_operation_id": "string", "sys_last_bulk_data_operation_sys_version": "string", "sys_last_modified_at": "2019-08-24T14:15:22Z", "sys_last_modified_by_id": "string", "sys_last_security_context": {}, "sys_locked": true, "sys_snapshot_base_version": 0.1, "sys_version": 0.1, "tasks_to_generate": [ { … } ], "track_inventory": true, "track_inventory_by": "product", "type": "commerce-merchandise", "variant_options": [ { … } ], "variants": [ { … } ], "weight": 0.1 }