Update attribute

Updating Attribute Values for Product Master Data

This API enables external systems to update the descriptions of an existing attribute associated with a product's master data. For example, updating the Italian or English descriptions for an attribute.

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 attribute must exist in the system before the update request is made.

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

Main Success Scenario

If the attribute and hierarchy exist, the system will update the description successfully and return an HTTP 200 response with the updated attribute details.

Example Response:

{
  "attribute": {
    "attribute_level": {
      "prog_id": 14983
    }
  }
}

Alternate Flows

Attribute type not found:
If the specified attribute_type does not exist, the following error will be returned:

{
  "message": "attribute_type with {attribute_type*} not found"
}

HTTP Status: 422 Unprocessable Entity

Attribute level already exists:
If the attribute level already exists, the following error will be returned:

{
  "message": "attribute_level with {attribute_level} already exists"
}

HTTP Status: 422 Unprocessable Entity

Best Practices

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

Code Example in Node.js

This Node.js example shows how to update the description of an existing attribute using the API.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Updating Attribute Values for Product Master Data#

Languages#

Actors#

Preconditions#

Main Success Scenario#

Alternate Flows#

Code Example in Node.js#

Request

Request Code Samples

Responses

Updating Attribute Values for Product Master Data

Languages

Actors

Preconditions

Main Success Scenario

Alternate Flows

Code Example in Node.js