BIbigchange
Stock

Create a stock supplier

Create a new stock supplier (required scope stock:write)

post/v1/stockDetails/{stockDetailsId}/suppliers

Request

  • Base URL
    https://api.bigchange.com
  • URL
    https://api.bigchange.com/v1/stockDetails/{stockDetailsId}/suppliers
  • Auth
    HTTP bearer

Path parameters

stockDetailsIdinteger required

Headers

Customer-Idinteger required

The customer identifier

Request body

contactIdinteger required

The unique identifier of the contact that supplies the stock

warrantyPeriodinteger nullable

The warranty period refers to the duration (in months) for which the stock supplier guarantees the inventory's quality and performance

costnumber double nullable

The cost refers to the amount charged by the stock supplier for each unit of inventory. If CurrencyCode is not null, this field is required

currencyCode'EUR' | 'AUD' | 'GBP' | 'BGN' | 'CAD' | 'CZK' | 'DKK' | 'HUF' | 'ILS' | 'LVL' | 'LTL' | 'MXN' | 'NZD' | 'NOK' | 'PLN' | 'RON' | 'RUB' | 'ZAR' | 'SEK' | 'CHF' | 'AED' | 'USD'

CurrencyCode definitions enum, matches currencies available in the BigChange Client Site<p>Possible values:</p><ul><li><b>EUR</b>: Euro</li><li><b>AUD</b>: Australian Dollar</li><li><b>GBP</b>: Pound Sterling</li><li><b>BGN</b>: Bulgarian Lev</li><li><b>CAD</b>: Canadian Dollar</li><li><b>CZK</b>: Czech Koruna</li><li><b>DKK</b>: Danish Krone</li><li><b>HUF</b>: Forint</li><li><b>ILS</b>: New Israeli Sheqel</li><li><b>LVL</b>: Latvian Lats - replaced by Euro</li><li><b>LTL</b>: Lithuanian Litas - replaced by Euro</li><li><b>MXN</b>: Mexican Peso</li><li><b>NZD</b>: New Zealand Dollar</li><li><b>NOK</b>: Norwegian Krone</li><li><b>PLN</b>: Zloty</li><li><b>RON</b>: Romanian Leu</li><li><b>RUB</b>: Russian Ruble</li><li><b>ZAR</b>: Rand</li><li><b>SEK</b>: Swedish Krona</li><li><b>CHF</b>: Swiss Franc</li><li><b>AED</b>: UAE Dirham</li><li><b>USD</b>: US Dollar</li></ul>

Example request

{
  "contactId": 5514123,
  "warrantyPeriod": 12,
  "cost": 12.99,
  "currencyCode": "EUR"
}

Response

Created

idinteger

Identifier of the newly created record

Changes

No recorded changes to this operation across all 13 revisions of this API.