How do I create a product with additional attributes in Magento via Soap/Java

How do I create a product with additional attributes in Magento via Soap/Java

September 24, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How do I create a product with additional attributes in Magento via Soap/Java

Troubleshooting Magento SOAP API Product Creation

Hello everyone! Today I’m going to help you troubleshoot an issue related to creating products via the Magento SOAP API.

The Problem: Handling Additional Attributes in Magento’s SOAP API

Let’s say you’re trying to create a new product using Magento 1.6 and the SOAP API WS-I compliance on Mac OSX Lion with Mamp 2.0.5. You want to set some properties of the product object, like name, price, and additional attributes.

The Code: Creating a Product

Here’s how you might approach this in your code:

public int createProduct(DatabaseProduct product) {

    // Set categories
    ArrayOfString categories = new ArrayOfString();
    categories.getComplexObjectArray().add(categoryID);
    createEntity.setCategoryIds(categories);

    // Populate the entity with product data
    CatalogProductCreateEntity createEntity = populateCreateOrUpdateEntity(product);

    // Prepare request parameters
    CatalogProductCreateRequestParam param = new CatalogProductCreateRequestParam();
    param.setSessionId(sessionId);
    param.setSet(setId);
    param.setSku(product.getSku());
    param.setType("simple");
    param.setStore(storeId);
    param.setProductData(createEntity);

    // Send the request
    CatalogProductCreateResponseParam response = service.catalogProductCreate(param);
    return response.getResult();
}

private CatalogProductCreateEntity populateCreateOrUpdateEntity(DatabaseProduct product) {

    CatalogProductCreateEntity createEntity = new CatalogProductCreateEntity();

    // Set basic properties
    createEntity.setShortDescription(product.getDescription().substring(0, 20) + "...");
    createEntity.setDescription(product.getDescription());
    createEntity.setName(product.getName());
    createEntity.setPrice(String.valueOf(product.getPrice()));
    createEntity.setStatus("1");
    createEntity.setVisibility("4");
    createEntity.setWeight("70");
    createEntity.setTaxClassId("2");

    // Set additional attributes
    AssociativeArray attributes = new AssociativeArray();

    AssociativeObject attribute1 = new AssociativeObject();
    attribute1.setKey("my_attribute_key");
    attribute1.setValue("my_attribute_value");
    attributes.getComplexObjectArray().add(attribute1);

    createEntity.setAdditionalAttributes(attributes);
}

The System Log Error

However, when you run this code and check your system log, you might see an error like this:

[2018-09-03T15:16:47+0000] [main.INFO]: stdClass Object
(
    [productCode] => 4444,
    [name] => My Product,
    [description] => This is my product description.,
    [shortDescription] => This is my product description.
    [weight] => 1,
    [price] => 99.90,
    [taxClassId] => 2,
    [categoryIds] => Array
    (
        [0] => 3
        [1] => 4
    ),
    [visibility] => 4,
    [status] => 1,
    [additionalAttributes] => stdClass Object
    (
        [my_attribute_key] => my_attribute_value
    )
)

The Issue: Magento Expects an Associative Array

The problem lies in how you’re setting the additionalAttributes property. In your code, you’re using an AssociativeArray, but the Magento SOAP API expects an AssociativeObject.

To fix this, you should be setting the additional attributes like this:

// Set additional attributes
AssociativeObject attributes = new AssociativeObject();

AssociativeObject attribute1 = new AssociativeObject();
attribute1.setKey("my_attribute_key");
attribute1.setValue("my_attribute_value");

attributes.put("my_attribute_key", attribute1);

createEntity.setAdditionalAttributes(attributes);

The Solution: Use the Correct Data Structure

In your code, you’re using an AssociativeArray, but when you actually send a create request to Magento, it expects an AssociativeObject.

The fix is quite simple. You just need to use the correct data structure for setting additional attributes in your product creation function.

Conclusion: Details Matter When Working with APIs

This issue highlights how important it is to read and understand the documentation of the API you’re working with. While the concept might seem straightforward—setting properties on an object—the actual implementation can trip you up if you don’t pay close attention to the data structures Magento expects.

Remember, when working with external APIs like Magento’s SOAP API, the devil is often in the details of the data structure being used.

I hope this helps! Let me know if you have any other questions.

Happy coding!

[// Begin: Link to Laravel Company //]

If you’re looking for professional help or interested in learning more about Magento development and e-commerce solutions, feel free to check out Laravel Company. We specialize in building custom web applications and e-commerce platforms using the Laravel framework.

[// End: Link to Laravel Company //]

Magento 1 Catalog Database API

Our network