Update dimension

Updating a Product Dimension in a Dimension Group

This API allows an external system to update specific dimensions (e.g., sizes) associated with a predefined dimension group (e.g., "EU Sizes"). This functionality helps maintain accurate and relevant product attributes based on various size classifications.

description_it: Description in Italian.

additional_description_it: Any additional description in Italian.

generic_name: Generic name for the dimension.

generic_name_it: Generic name in Italian.

dimension_grouping: Grouping category for the dimension.

position: Position or rank of the dimension within the group.

INFO

To learn more about how dimensions are managed, including defining dimension types, creating dimensional groups, and associating dimensions with products, please refer to our Product Dimensions

Languages

To understand how languages are managed, please refer to our Managing Languages Documentation.

Actors

API Client: The system or user initiating the request.

4ws.trade: The backend system that processes the request.

Preconditions

The dimension_group must already exist and be created through the Insert dimension group API.

The dimension_type must be predefined (e.g., "TAGLIA").

The external system must have the necessary permissions and access to the document creation service, please refer to Authentication.

Main Success Scenario

If the request is successful, the system will return an HTTP 200 response along with the internal program ID (prog_id) and the updated dimension.

Example Success Response:

{
  "dimension": {
    "prog_id": 83434,
    "dimension": "XL"
  }
}

Alternate Flows

Dimension Type Not Found:
If the provided dimension_type does not exist in the system, the following error will be returned:

{
  "message": "dimension_type with {dimension_type} not found"
}

HTTP Status: 422 Unprocessable Entity

Dimension Group Not Found:
If the dimension_group does not exist, the following error will be returned:

{
  "message": "dimension_group with {dimension_group} not found"
}

HTTP Status: 422 Unprocessable Entity

Best Practices

Please refer to Best Practices for Error Handling in External System for best practices on implementation.

Sequence Diagram

Code Example in Node.js

This Node.js example demonstrates how to update a dimension in a specified dimension group using the provided API.

Request

Path Params

Header Params

Body Params application/json

Example

{
    "description_it": "{{description_it}}",
    "additional_description_it":"{{additional_description_it}}",
    "generic_name":"{{generic_name}}",
    "generic_name_it":"{{generic_name_it}}",
    "dimension_grouping":"{{dimension_grouping}}",
    "position":{{position}}
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Updating a Product Dimension in a Dimension Group#

Languages#

Actors#

Preconditions#

Main Success Scenario#

Alternate Flows#

Sequence Diagram#

Code Example in Node.js#

Request

Request Code Samples

Responses

Updating a Product Dimension in a Dimension Group

Languages

Actors

Preconditions

Main Success Scenario

Alternate Flows

Sequence Diagram

Code Example in Node.js