Sign in
InventoryProducts

Add a supplier to an Inventory Product

Associates a supplier with a product, capturing the supplier's SKU, default order quantity, and unit price. Multiple suppliers can be associated with the same product.

post/inventory/products/{productId}/suppliers

Request body

supplier_idstring uuid required

Supplier to attach to the product. Suppliers belong to the same inventory brand as the product; cross-brand links are rejected with 422. A product can be linked to multiple suppliers, each with their own pricing.

supplier_product_idstring

The supplier's ID of the product being ordered (e.g. their SKU).

order_quantityinteger

The default quantity of the product to order from this supplier.

unit_priceinteger

The unit price of this item in the lowest denomination for the product's currency.

currencystring

The currency of the supplier product.

Example request

{
  "supplier_id": "5f8a1b2c-9d3e-4a5b-8c6d-7e8f9a0b1c2d",
  "supplier_product_id": "MRJ-45-100",
  "order_quantity": 10,
  "unit_price": 200,
  "currency": "gbp"
}

Response

A single product-supplier association.

Example response

{
  "data": {
    "product_name": "Blissful Body Butter",
    "supplier_name": "Elemis",
    "order_quantity": 10,
    "unit_price": 200,
    "currency": "gbp"
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.