v2

latestOpenAPI 3.0.42026-08-084694591.6 MB
Item PriceBreaks

Create or update a purchase price break for an item. The price break is identified by the combination of (item, vendor, currency, unit of measure): if a match exists it is replaced, otherwise a new price break is created.

put/api/items/{itemId}/purchase-price-breaks

Path parameters

itemIdstring required

The id of the item.

Request body

vendorIdstring required

Identifier of the vendor this price break applies to.

currencyCodestring nullable

ISO 4217 currency code. Null is treated as the vendor's currency (or, if the vendor has no currency, the company's primary currency) for identity matching. When matching an existing break, that break's stored CurrencyCode is preserved. On insert, the value stored is the supplied value or the vendor's currency if none was supplied.

unitOfMeasureNamestring nullable

Purchasing unit of measure. Null indicates the item's default unit of measure. Same null/default-equivalence rules as FulcrumProduct.PublicApi.Dto.PriceBreak.PurchasePriceBreakUpsertDto.CurrencyCode.

unitPricenumber double nullable

The unit price at quantity 1. Required.

vendorItemNumberstring nullable

The vendor's part number for this item, if different from the internal number.

vendorItemNamestring nullable

The vendor's part description for this item.

Response

The upserted price break.

idstring required

Identifier of the price break.

itemIdstring required

Identifier of the item this price break applies to.

vendorIdstring required

Identifier of the vendor this price break applies to.

currencyCodestring nullable

ISO 4217 currency code. Null indicates the company's primary currency.

unitOfMeasureNamestring nullable

Purchasing unit of measure for this price break. Null indicates the item's default unit of measure.

unitPricenumber double nullable

The unit price at quantity 1.

vendorItemNumberstring nullable

The vendor's part number for this item, if different from the internal number.

vendorItemNamestring nullable

The vendor's part description for this item.

modifiedUtcstring date-time

When this price break was last modified.