API reference · Products

Update product stock and price (by product code)

Updates stock and prices of the product found by Code and ProductSourceId and, optionally, of its variants in one call.

POST https://out.stockmount.com/api/Product/UpdateProductQuantityAndPriceByCode

Changes data Product package required

Each call updates a single product; you cannot send several products in one call. You can update several variants of that product in the same call with Variants.

The product is identified by Code + ProductSourceId; any ProductId you send is ignored. If Code is empty, ErrorMessage says ProductId; this means the code is missing.

The quantity you send replaces the product's available stock; the sold counter StockMount has kept so far is reset to zero. If the new product stock is below 1, the product's Status becomes 3, otherwise 2.

The product-level Quantity is written on every call. If you send only variant quantities without Quantity and do not set SetProductQuantityFromVariants to true, the product stock becomes 0. For products with variants, sending SetProductQuantityFromVariants: true is recommended.

Price, MarketPrice and Price2–Price5 are overwritten on every call with the values in the request; any field you omit becomes 0. Send every price you use each time.

Each item in Variants is matched to the product's variants by ProductVariantId, or by variant Code when no ID is given. A matched variant gets its stock replaced by Quantity and its prices by Price and Price2–Price5; omitted fields become 0. Variants not in the list are not touched. A variant-level CurrencyId is not read.

This endpoint does not validate prices: 0, negative values, or a MarketPrice lower than Price are accepted. Such problems surface as errors during marketplace synchronization, not in this call.

Quantities are not validated; negative values are not rejected.

The values are written to the product in StockMount first. If stock or price actually changed, the matching update (stock, price, or both) is queued for each active marketplace listing of the product. Marketplaces are updated by background jobs, not during this call.

If the product is not found or does not belong to your account, the response is Result: false with ErrorCode: "70005" and ErrorMessage: "ProductNotFound". Database errors return ErrorCode 99999.

Accounts without an active Product package get error 70018; if the package cannot be verified, 99999 is returned.

Request fields

Field	Type	Description
`ApiCode` required	string	The API code returned by `User/DoLogin`.
`Code` required	string	Product code (SKU), up to 50 characters. The product is looked up by `Code` together with `ProductSourceId`. `ProductId` is ignored by this endpoint.
`ProductSourceId` required	integer	ID of the product source the product belongs to (`GetProductSources`). `Code` is looked up within this source.
`Quantity`	integer	New stock quantity of the product. If omitted, `0` is written. Ignored when `SetProductQuantityFromVariants` is `true` and `Variants` has at least one item. Negative values are not rejected.
`SetProductQuantityFromVariants`	boolean	If `true`, the product stock is computed as the sum of its active variants: the new quantity for variants in the list, the current available stock for the other variants. Has no effect when `Variants` is empty. Default `false`.
`Price`	number	Sale price of the product. Stored with 2 decimal places. If omitted, `0` is written.
`MarketPrice`	number	Market (list) price. If omitted, `0` is written.
`Price2`	number	Product additional price 2. If omitted, `0` is written.
`Price3`	number	Product additional price 3. If omitted, `0` is written.
`Price4`	number	Product additional price 4. If omitted, `0` is written.
`Price5`	number	Product additional price 5. If omitted, `0` is written.
`CurrencyId`	integer	Currency ID (`GetCurrencies`). If greater than 0, the currency of the product and of the updated variants is set to this value. If omitted or `0`, the currency is unchanged.
`Variants`	object[]	Variants to update. Only listed variants change; entries that do not match are skipped without an error.
Variants[]. `ProductVariantId`	integer	Variant ID. If omitted or `0`, the variant is matched by `Code`.
Variants[]. `Code`	string	Variant code. Used for matching when `ProductVariantId` is not set.
Variants[]. `Quantity`	integer	New stock quantity of the variant. If omitted, `0` is written. Negative values are not rejected.
Variants[]. `Price`	number	Variant sale price. If omitted, `0` is written.
Variants[]. `Price2`	number	Variant additional price 2. If omitted, `0` is written.
Variants[]. `Price3`	number	Variant additional price 3. If omitted, `0` is written.
Variants[]. `Price4`	number	Variant additional price 4. If omitted, `0` is written.
Variants[]. `Price5`	number	Variant additional price 5. If omitted, `0` is written.

Response fields (Response)

Field	Type	Description
`ProductId`	integer	ID of the updated product.
`Variants`	object[]	Variants updated by this call. Empty array if you sent no variants.
Variants[]. `Code`	string	Variant code.
Variants[]. `ProductVariantId`	integer	Variant ID.

Error codes for this endpoint

Code	When
`70005`	The product was not found or does not belong to your account (`ErrorMessage`: `ProductNotFound`).
`00003`	`Code` is empty (`ErrorMessage: "ProductId"`) or `ProductSourceId` is less than 1 (`ErrorMessage: "ProductSourceId"`).
`70018`	Your account has no active Product package.
`99999`	An unexpected server error occurred.

For session errors (00001, 00006) and every other code see error codes.

Related endpoints

Example request

{
  "ApiCode": "API_CODE",
  "Code": "TSHIRT-RED",
  "ProductSourceId": 3051,
  "SetProductQuantityFromVariants": true,
  "Price": 349.9,
  "MarketPrice": 449.9,
  "Price2": 329.9,
  "Price3": 0,
  "Price4": 0,
  "Price5": 0,
  "Variants": [
    {
      "ProductVariantId": 9120344,
      "Quantity": 15,
      "Price": 349.9,
      "Price2": 329.9
    },
    {
      "Code": "TSHIRT-RED-L",
      "Quantity": 0,
      "Price": 359.9,
      "Price2": 339.9
    }
  ]
}

curl -X POST 'https://out.stockmount.com/api/Product/UpdateProductQuantityAndPriceByCode' \
  -H 'Content-Type: application/json' \
  -d '{
  "ApiCode": "API_CODE",
  "Code": "TSHIRT-RED",
  "ProductSourceId": 3051,
  "SetProductQuantityFromVariants": true,
  "Price": 349.9,
  "MarketPrice": 449.9,
  "Price2": 329.9,
  "Price3": 0,
  "Price4": 0,
  "Price5": 0,
  "Variants": [
    {
      "ProductVariantId": 9120344,
      "Quantity": 15,
      "Price": 349.9,
      "Price2": 329.9
    },
    {
      "Code": "TSHIRT-RED-L",
      "Quantity": 0,
      "Price": 359.9,
      "Price2": 339.9
    }
  ]
}'

using System.Net.Http;
using System.Text;

using var http = new HttpClient();
var json = """
{
  "ApiCode": "API_CODE",
  "Code": "TSHIRT-RED",
  "ProductSourceId": 3051,
  "SetProductQuantityFromVariants": true,
  "Price": 349.9,
  "MarketPrice": 449.9,
  "Price2": 329.9,
  "Price3": 0,
  "Price4": 0,
  "Price5": 0,
  "Variants": [
    {
      "ProductVariantId": 9120344,
      "Quantity": 15,
      "Price": 349.9,
      "Price2": 329.9
    },
    {
      "Code": "TSHIRT-RED-L",
      "Quantity": 0,
      "Price": 359.9,
      "Price2": 339.9
    }
  ]
}
""";

var response = await http.PostAsync(
    "https://out.stockmount.com/api/Product/UpdateProductQuantityAndPriceByCode",
    new StringContent(json, Encoding.UTF8, "application/json"));

var result = await response.Content.ReadAsStringAsync();
// Result == false ise ErrorCode ve ErrorMessage alanlarına bakın.
Console.WriteLine(result);

<?php
$body = <<<'JSON'
{
  "ApiCode": "API_CODE",
  "Code": "TSHIRT-RED",
  "ProductSourceId": 3051,
  "SetProductQuantityFromVariants": true,
  "Price": 349.9,
  "MarketPrice": 449.9,
  "Price2": 329.9,
  "Price3": 0,
  "Price4": 0,
  "Price5": 0,
  "Variants": [
    {
      "ProductVariantId": 9120344,
      "Quantity": 15,
      "Price": 349.9,
      "Price2": 329.9
    },
    {
      "Code": "TSHIRT-RED-L",
      "Quantity": 0,
      "Price": 359.9,
      "Price2": 339.9
    }
  ]
}
JSON;

$ch = curl_init('https://out.stockmount.com/api/Product/UpdateProductQuantityAndPriceByCode');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (!$result['Result']) {
    echo $result['ErrorCode'] . ' ' . $result['ErrorMessage'];
}

import requests

payload = {
    "ApiCode": "API_CODE",
    "Code": "TSHIRT-RED",
    "ProductSourceId": 3051,
    "SetProductQuantityFromVariants": True,
    "Price": 349.9,
    "MarketPrice": 449.9,
    "Price2": 329.9,
    "Price3": 0,
    "Price4": 0,
    "Price5": 0,
    "Variants": [
        {
            "ProductVariantId": 9120344,
            "Quantity": 15,
            "Price": 349.9,
            "Price2": 329.9
        },
        {
            "Code": "TSHIRT-RED-L",
            "Quantity": 0,
            "Price": 359.9,
            "Price2": 339.9
        }
    ]
}

response = requests.post("https://out.stockmount.com/api/Product/UpdateProductQuantityAndPriceByCode", json=payload, timeout=60)
result = response.json()

if not result["Result"]:
    print(result["ErrorCode"], result["ErrorMessage"])

const payload = {
  "ApiCode": "API_CODE",
  "Code": "TSHIRT-RED",
  "ProductSourceId": 3051,
  "SetProductQuantityFromVariants": true,
  "Price": 349.9,
  "MarketPrice": 449.9,
  "Price2": 329.9,
  "Price3": 0,
  "Price4": 0,
  "Price5": 0,
  "Variants": [
    {
      "ProductVariantId": 9120344,
      "Quantity": 15,
      "Price": 349.9,
      "Price2": 329.9
    },
    {
      "Code": "TSHIRT-RED-L",
      "Quantity": 0,
      "Price": 359.9,
      "Price2": 339.9
    }
  ]
};

const response = await fetch("https://out.stockmount.com/api/Product/UpdateProductQuantityAndPriceByCode", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(payload),
});
const result = await response.json();

if (!result.Result) {
  console.error(result.ErrorCode, result.ErrorMessage);
}

Example response

{
  "Result": true,
  "Response": {
    "ProductId": 184522,
    "Variants": [
      {
        "Code": "TSHIRT-RED-M",
        "ProductVariantId": 9120344
      },
      {
        "Code": "TSHIRT-RED-L",
        "ProductVariantId": 9120345
      }
    ]
  }
}

Try it

The request goes straight from your browser to out.stockmount.com. The ApiCode is not stored by this site; it is kept only while this tab is open.

Get an ApiCode before sending requests.

This endpoint changes real data in your account.

Body (JSON)

{
  "ApiCode": "{{apiCode}}",
  "Code": "TSHIRT-RED",
  "ProductSourceId": 3051,
  "SetProductQuantityFromVariants": true,
  "Price": 349.9,
  "MarketPrice": 449.9,
  "Price2": 329.9,
  "Price3": 0,
  "Price4": 0,
  "Price5": 0,
  "Variants": [
    {
      "ProductVariantId": 9120344,
      "Quantity": 15,
      "Price": 349.9,
      "Price2": 329.9
    },
    {
      "Code": "TSHIRT-RED-L",
      "Quantity": 0,
      "Price": 359.9,
      "Price2": 339.9
    }
  ]
}

I understand this request changes real data in my account.