SKU Data Bulk Update
{{api_url}}/shop/products/sku_dataSets SKU Data entries across many SKUs in one call. The body is a JSON array of rows, each naming the SKU, the data name, and the value; every row is saved independently, creating the entry if the name is new to that SKU and overwriting it if it already exists. Entries not sent are left untouched. Use SKU Data Set when every entry is on the same SKU; this endpoint is for mapping imports and anything that spans SKUs, such as loading a retailer's SKU list or clearing one data name across the catalog. The output of SKU Data Search can be reshaped into this body directly.
SKU Data is the per-SKU key/value store connections read when they interact with a SKU: thehomedepot_sku is what InfiPlex sends to Home Depot for the SKU, costco_sku what it sends to Costco, amazon_business_pricing_base_price the Amazon Business price, and so on. The full list of reserved names is on SKU Data Get. Any other name is accepted and becomes a custom entry, so a misspelled reserved name saves silently as a new custom entry rather than failing.
An empty data_value clears the entry, leaving the name on the SKU with no value. To remove entries use SKU Data Delete. Values InfiPlex writes on its own, such as amazon_business_pricing_last_sync_time, can be overwritten; clearing a sync time makes the next sync treat the SKU as never synced. Entries that hold JSON, avcr_auto_confirm_rule_price and avcr_auto_confirm_rule_inventory, must be sent as a complete JSON string.
Body
A JSON array, one object per entry. No fixed batch limit.
| Field | Type | Description |
|---|---|---|
sku | string | The SKU the entry belongs to. |
data_name | string | The data name, reserved or custom. |
data_value | string | The value to store. Empty string clears the entry. |
[
{"sku": "abc", "data_name": "thehomedepot_sku", "data_value": "1004567890"},
{"sku": "abc", "data_name": "costco_sku", "data_value": "8834120"},
{"sku": "def", "data_name": "thehomedepot_sku", "data_value": "1004567891"}
]
Example
{{api_url}}/shop/products/sku_data
Response
A JSON array with one object per row sent, in the order sent:
[
{
"message": "data saved",
"sku": "abc",
"data_name": "thehomedepot_sku",
"data_value": "1004567890",
"success": true
},
{
"message": "data saved",
"sku": "abc",
"data_name": "costco_sku",
"data_value": "8834120",
"success": true
},
{
"message": "data saved",
"sku": "def",
"data_name": "thehomedepot_sku",
"data_value": "1004567891",
"success": true
}
]
| Field | Type | Description |
|---|---|---|
message | string | data saved on success, otherwise the reason the row was not saved. |
sku | string | The SKU as sent. |
data_name | string | The data name as sent. |
data_value | string | The value as stored. |
success | boolean | true when the row was saved. |
Check success on every row rather than the HTTP status: one row failing does not fail the others.
Authorization
Bearer token, sent in the Authorization header. Inherited from the collection.
Body
[
{
"sku": "abc",
"data_name": "custom_data_1",
"data_value": "some value abc 111"
},
{
"sku": "abc",
"data_name": "custom_data_2",
"data_value": "some value abc 222"
},
{
"sku": "def",
"data_name": "custom_data_1",
"data_value": "some value def 111"
},
{
"sku": "def",
"data_name": "custom_data_2",
"data_value": "some value def 222"
}
]Example Request
curl --location --request POST '{{api_url}}/shop/products/sku_data' \
--header 'Authorization: Bearer {{auth_token}}' \
--data '[
{
"sku": "abc",
"data_name": "custom_data_1",
"data_value": "some value abc 111"
},
{
"sku": "abc",
"data_name": "custom_data_2",
"data_value": "some value abc 222"
},
{
"sku": "def",
"data_name": "custom_data_1",
"data_value": "some value def 111"
},
{
"sku": "def",
"data_name": "custom_data_2",
"data_value": "some value def 222"
}
]'Example Responses
SKU Data Bulk Update
Request
curl --location --request POST '{{api_url}}/shop/products/sku_data' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '[
{
"sku": "abc",
"data_name": "custom_data_1",
"data_value": "some value abc 111"
},
{
"sku": "abc",
"data_name": "custom_data_2",
"data_value": "some value abc 222"
},
{
"sku": "def",
"data_name": "custom_data_1",
"data_value": "some value def 111"
},
{
"sku": "def",
"data_name": "custom_data_2",
"data_value": "some value def 222"
}
]'Response 200 OK
[
{
"message": "data saved",
"sku": "abc",
"data_name": "custom_data_1",
"data_value": "some value abc 111",
"success": true
},
{
"message": "data saved",
"sku": "abc",
"data_name": "custom_data_2",
"data_value": "some value abc 222",
"success": true
},
{
"message": "data saved",
"sku": "def",
"data_name": "custom_data_1",
"data_value": "some value def 111",
"success": true
},
{
"message": "data saved",
"sku": "def",
"data_name": "custom_data_2",
"data_value": "some value def 222",
"success": true
}
]
