PUT
https://test-api.finerworks.com/v3/update_virtual_inventory
Update Virtual Inventory
Updates virtual inventory items within a user's account.
Body
| Name | Description | Type | Additional information |
|---|---|---|---|
| virtual_inventory | An array of virtual inventory items you want to update. Update up to 50 at a time. | array (product_details_update) |
Required |
| account_key | Optional - This updates virtual inventory by account_key. Note, this will only be accepted for accounts with permission to utilize this parameter, otherwise it will be ignored and virtual inventory will be retrieved based upon the user's api credentials. Leave as null if not authorized to use this parameter. | text | None. |
Example JSON Body
application/json, text/json
{
"virtual_inventory": [
{
"sku": "AP1556P79511",
"asking_price": 200.0,
"name": "Framed Giclee - Fine Art Paper Prints",
"description": "<ul><ul><li data-priority=\"0\" data-key=\"type\">Framed Giclee - Fine Art Paper Prints</li><ul><li data-priority=\"1\" data-key=\"media\">8 x 10\" Archival Canvas Paper (Discontinued)</li><li data-priority=\"1\" data-key=\"style\">1/2\" Extra Border Added</li><li data-priority=\"1\" data-key=\"frame\">Rustic Britanny Vermill Red 1-1/2\"</li><li data-priority=\"1\" data-key=\"frame size\">13 x 15 Vermill Red 1-1/2\"</li><li data-priority=\"1\" data-key=\"base mat\">Off White (window: 9 x 11)</li><li data-priority=\"1\" data-key=\"glazing\">Premium Clear</li><ul><li data-priority=\"5\" data-key=\"sku\">AP1556P79511</li></ul></ul></ul></ul>",
"quantity_in_stock": 10,
"track_inventory": true,
"third_party_integrations": {
"etsy_product_id": 0,
"shopify_product_id": 123456789,
"shopify_variant_id": 24681012,
"shopify_graphql_product_id": null,
"shopify_graphql_variant_id": null,
"squarespace_product_id": null,
"squarespace_variant_id": null,
"square_product_id": null,
"square_variant_id": null,
"bigcommerce_id": null,
"bigcommerce_variant_id": null,
"wix_inventory_id": null,
"wix_product_id": null,
"wix_variant_id": null,
"woocommerce_product_id": 0,
"woocommerce_variant_id": 0
}
}
],
"account_key": null
}
Sample Code Library
curl --location --request PUT 'https://test-api.finerworks.com/v3/update_virtual_inventory' \
--header 'Content-Type: application/json' \
--header 'web_api_key: my-web-api-key-goes-here' \
--header 'app_key: my-app-key-goes-here' \
--data-raw '{
"virtual_inventory": [
{
"sku": "AP1556P79511",
"asking_price": 200.0,
"name": "Framed Giclee - Fine Art Paper Prints",
"description": "<ul><ul><li data-priority=\"0\" data-key=\"type\">Framed Giclee - Fine Art Paper Prints</li><ul><li data-priority=\"1\" data-key=\"media\">8 x 10\" Archival Canvas Paper (Discontinued)</li><li data-priority=\"1\" data-key=\"style\">1/2\" Extra Border Added</li><li data-priority=\"1\" data-key=\"frame\">Rustic Britanny Vermill Red 1-1/2\"</li><li data-priority=\"1\" data-key=\"frame size\">13 x 15 Vermill Red 1-1/2\"</li><li data-priority=\"1\" data-key=\"base mat\">Off White (window: 9 x 11)</li><li data-priority=\"1\" data-key=\"glazing\">Premium Clear</li><ul><li data-priority=\"5\" data-key=\"sku\">AP1556P79511</li></ul></ul></ul></ul>",
"quantity_in_stock": 10,
"track_inventory": true,
"third_party_integrations": {
"etsy_product_id": 0,
"shopify_product_id": 123456789,
"shopify_variant_id": 24681012,
"shopify_graphql_product_id": null,
"shopify_graphql_variant_id": null,
"squarespace_product_id": null,
"squarespace_variant_id": null,
"square_product_id": null,
"square_variant_id": null,
"bigcommerce_id": null,
"bigcommerce_variant_id": null,
"wix_inventory_id": null,
"wix_product_id": null,
"wix_variant_id": null,
"woocommerce_product_id": 0,
"woocommerce_variant_id": 0
}
}
],
"account_key": null
}'require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://test-api.finerworks.com/v3/update_virtual_inventory');
$request->setMethod(HTTP_Request2::METHOD_PUT);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'Content-Type' => 'application/json',
'web_api_key' => 'my-web-api-key-goes-here',
'app_key' => 'my-app-key-goes-here'
));
$request->setBody('{
'virtual_inventory': [
{
'sku': 'AP1556P79511',
'asking_price': 200.0,
'name': 'Framed Giclee - Fine Art Paper Prints',
'description': '<ul><ul><li data-priority=\'0\' data-key=\'type\'>Framed Giclee - Fine Art Paper Prints</li><ul><li data-priority=\'1\' data-key=\'media\'>8 x 10\' Archival Canvas Paper (Discontinued)</li><li data-priority=\'1\' data-key=\'style\'>1/2\' Extra Border Added</li><li data-priority=\'1\' data-key=\'frame\'>Rustic Britanny Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'frame size\'>13 x 15 Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'base mat\'>Off White (window: 9 x 11)</li><li data-priority=\'1\' data-key=\'glazing\'>Premium Clear</li><ul><li data-priority=\'5\' data-key=\'sku\'>AP1556P79511</li></ul></ul></ul></ul>',
'quantity_in_stock': 10,
'track_inventory': true,
'third_party_integrations': {
'etsy_product_id': 0,
'shopify_product_id': 123456789,
'shopify_variant_id': 24681012,
'shopify_graphql_product_id': null,
'shopify_graphql_variant_id': null,
'squarespace_product_id': null,
'squarespace_variant_id': null,
'square_product_id': null,
'square_variant_id': null,
'bigcommerce_id': null,
'bigcommerce_variant_id': null,
'wix_inventory_id': null,
'wix_product_id': null,
'wix_variant_id': null,
'woocommerce_product_id': 0,
'woocommerce_variant_id': 0
}
}
],
'account_key': null
}');
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}var client = new RestClient("https://test-api.finerworks.com/v3/update_virtual_inventory");
client.Timeout = -1;
var request = new RestRequest(Method.PUT);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("web_api_key", "my-web-api-key-goes-here");
request.AddHeader("app_key", "my-app-key-goes-here");
request.AddParameter("application/json", "{
'virtual_inventory': [
{
'sku': 'AP1556P79511',
'asking_price': 200.0,
'name': 'Framed Giclee - Fine Art Paper Prints',
'description': '<ul><ul><li data-priority=\'0\' data-key=\'type\'>Framed Giclee - Fine Art Paper Prints</li><ul><li data-priority=\'1\' data-key=\'media\'>8 x 10\' Archival Canvas Paper (Discontinued)</li><li data-priority=\'1\' data-key=\'style\'>1/2\' Extra Border Added</li><li data-priority=\'1\' data-key=\'frame\'>Rustic Britanny Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'frame size\'>13 x 15 Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'base mat\'>Off White (window: 9 x 11)</li><li data-priority=\'1\' data-key=\'glazing\'>Premium Clear</li><ul><li data-priority=\'5\' data-key=\'sku\'>AP1556P79511</li></ul></ul></ul></ul>',
'quantity_in_stock': 10,
'track_inventory': true,
'third_party_integrations': {
'etsy_product_id': 0,
'shopify_product_id': 123456789,
'shopify_variant_id': 24681012,
'shopify_graphql_product_id': null,
'shopify_graphql_variant_id': null,
'squarespace_product_id': null,
'squarespace_variant_id': null,
'square_product_id': null,
'square_variant_id': null,
'bigcommerce_id': null,
'bigcommerce_variant_id': null,
'wix_inventory_id': null,
'wix_product_id': null,
'wix_variant_id': null,
'woocommerce_product_id': 0,
'woocommerce_variant_id': 0
}
}
],
'account_key': null
}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);var settings = {
"url": "https://test-api.finerworks.com/v3/update_virtual_inventory",
"method": "PUT",
"timeout": 0,
"headers": {
"Content-Type": "application/json",
"web_api_key": "my-web-api-key-goes-here",
"app_key": "my-app-key-goes-here"
},
"data": JSON.stringify({
'virtual_inventory': [
{
'sku': 'AP1556P79511',
'asking_price': 200.0,
'name': 'Framed Giclee - Fine Art Paper Prints',
'description': '<ul><ul><li data-priority=\'0\' data-key=\'type\'>Framed Giclee - Fine Art Paper Prints</li><ul><li data-priority=\'1\' data-key=\'media\'>8 x 10\' Archival Canvas Paper (Discontinued)</li><li data-priority=\'1\' data-key=\'style\'>1/2\' Extra Border Added</li><li data-priority=\'1\' data-key=\'frame\'>Rustic Britanny Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'frame size\'>13 x 15 Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'base mat\'>Off White (window: 9 x 11)</li><li data-priority=\'1\' data-key=\'glazing\'>Premium Clear</li><ul><li data-priority=\'5\' data-key=\'sku\'>AP1556P79511</li></ul></ul></ul></ul>',
'quantity_in_stock': 10,
'track_inventory': true,
'third_party_integrations': {
'etsy_product_id': 0,
'shopify_product_id': 123456789,
'shopify_variant_id': 24681012,
'shopify_graphql_product_id': null,
'shopify_graphql_variant_id': null,
'squarespace_product_id': null,
'squarespace_variant_id': null,
'square_product_id': null,
'square_variant_id': null,
'bigcommerce_id': null,
'bigcommerce_variant_id': null,
'wix_inventory_id': null,
'wix_product_id': null,
'wix_variant_id': null,
'woocommerce_product_id': 0,
'woocommerce_variant_id': 0
}
}
],
'account_key': null
}),
};
$.ajax(settings).done(function (response) {
console.log(response);
});var https = require('follow-redirects').https;
var options = {
'method': 'PUT',
'hostname': 'test-api.finerworks.com',
'path': '/v3/update_virtual_inventory',
'headers': {
'Content-Type': 'application/json',
'web_api_key': 'my-web-api-key-goes-here',
'app_key': 'my-app-key-goes-here'
},
'maxRedirects': 20
};
var req = https.request(options, function (res) {
var chunks = [];
res.on("data", function (chunk) { chunks.push(chunk); });
res.on("end", function () {
var body = Buffer.concat(chunks);
console.log(body.toString());
});
res.on("error", function (error) { console.error(error); });
});
var postData = JSON.stringify({
'virtual_inventory': [
{
'sku': 'AP1556P79511',
'asking_price': 200.0,
'name': 'Framed Giclee - Fine Art Paper Prints',
'description': '<ul><ul><li data-priority=\'0\' data-key=\'type\'>Framed Giclee - Fine Art Paper Prints</li><ul><li data-priority=\'1\' data-key=\'media\'>8 x 10\' Archival Canvas Paper (Discontinued)</li><li data-priority=\'1\' data-key=\'style\'>1/2\' Extra Border Added</li><li data-priority=\'1\' data-key=\'frame\'>Rustic Britanny Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'frame size\'>13 x 15 Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'base mat\'>Off White (window: 9 x 11)</li><li data-priority=\'1\' data-key=\'glazing\'>Premium Clear</li><ul><li data-priority=\'5\' data-key=\'sku\'>AP1556P79511</li></ul></ul></ul></ul>',
'quantity_in_stock': 10,
'track_inventory': true,
'third_party_integrations': {
'etsy_product_id': 0,
'shopify_product_id': 123456789,
'shopify_variant_id': 24681012,
'shopify_graphql_product_id': null,
'shopify_graphql_variant_id': null,
'squarespace_product_id': null,
'squarespace_variant_id': null,
'square_product_id': null,
'square_variant_id': null,
'bigcommerce_id': null,
'bigcommerce_variant_id': null,
'wix_inventory_id': null,
'wix_product_id': null,
'wix_variant_id': null,
'woocommerce_product_id': 0,
'woocommerce_variant_id': 0
}
}
],
'account_key': null
});
req.write(postData);
req.end();require "uri"
require "net/http"
url = URI("https://test-api.finerworks.com/v3/update_virtual_inventory")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Content-Type"] = "application/json"
request["web_api_key"] = "my-web-api-key-goes-here"
request["app_key"] = "my-app-key-goes-here"
request.body = "{
'virtual_inventory': [
{
'sku': 'AP1556P79511',
'asking_price': 200.0,
'name': 'Framed Giclee - Fine Art Paper Prints',
'description': '<ul><ul><li data-priority=\'0\' data-key=\'type\'>Framed Giclee - Fine Art Paper Prints</li><ul><li data-priority=\'1\' data-key=\'media\'>8 x 10\' Archival Canvas Paper (Discontinued)</li><li data-priority=\'1\' data-key=\'style\'>1/2\' Extra Border Added</li><li data-priority=\'1\' data-key=\'frame\'>Rustic Britanny Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'frame size\'>13 x 15 Vermill Red 1-1/2\'</li><li data-priority=\'1\' data-key=\'base mat\'>Off White (window: 9 x 11)</li><li data-priority=\'1\' data-key=\'glazing\'>Premium Clear</li><ul><li data-priority=\'5\' data-key=\'sku\'>AP1556P79511</li></ul></ul></ul></ul>',
'quantity_in_stock': 10,
'track_inventory': true,
'third_party_integrations': {
'etsy_product_id': 0,
'shopify_product_id': 123456789,
'shopify_variant_id': 24681012,
'shopify_graphql_product_id': null,
'shopify_graphql_variant_id': null,
'squarespace_product_id': null,
'squarespace_variant_id': null,
'square_product_id': null,
'square_variant_id': null,
'bigcommerce_id': null,
'bigcommerce_variant_id': null,
'wix_inventory_id': null,
'wix_product_id': null,
'wix_variant_id': null,
'woocommerce_product_id': 0,
'woocommerce_variant_id': 0
}
}
],
'account_key': null
}"
response = https.request(request)
puts response.read_body| Name | Description | Type | Additional information |
|---|---|---|---|
| status | Response status | response_status | None. |
| skus_updated | A list of the supplied skus that were succesfully updated | array (text) | None. |
Example JSON Response
application/json, text/json
{
"status": {
"success": true,
"status_code": 200,
"message": "",
"debug": null,
"reference_id": "06fdf3395f91473cbd82a4aad0f6da7d",
"domain": null
},
"skus_updated": [
"AP0001P0001",
"AP0001P0002",
"AP0001P0003",
"AP0001P0004"
]
}