Price lists
Price lists — saved unit prices for items and bundles, each tied to purchase or sales orders.
Đối tượng PriceList
Phần tiêu đề “Đối tượng PriceList”A price list with its line items.
Price list id.
Price list display name.
"purchase" for purchase price lists; "sales" for sales price lists. A price list is tied to one order type.
Giá trị có thể cópurchasesales
ISO 4217 currency code, or null when unset.
Server-side creation timestamp.
Last edit timestamp, or the creation timestamp when never edited.
Line items, ordered by rank ascending.
Hiển thị thuộc tính
Set when this line references a single item; null for bundle lines.
Hiển thị thuộc tính
Item or bundle id.
Display name.
SKU. Empty string when unset.
Barcode. Empty string when unset.
Whether the underlying item or bundle is deleted.
Set when this line references a bundle; null for item lines.
Hiển thị thuộc tính
Item or bundle id.
Display name.
SKU. Empty string when unset.
Barcode. Empty string when unset.
Whether the underlying item or bundle is deleted.
Unit price stored on this line.
Line position within the price list (0-based).
Ví dụ
{ "id": 81023, "name": "Wholesale prices", "order_type": "sales", "currency_code": "USD", "created_at": "2026-01-02T03:04:05.000Z", "updated_at": "2026-01-02T03:04:05.000Z", "items": [ { "item": { "id": 14290445, "name": "Finish Setting Powder", "sku": "SKU-12345678", "barcode": "2097678335587", "deleted": false }, "bundle": null, "price": "12.50", "rank": 0 }, { "item": null, "bundle": { "id": 4042, "name": "Starter Kit", "sku": "BUNDLE-STARTER", "barcode": "8801234567890", "deleted": false }, "price": "24.00", "rank": 1 } ]}Endpoint
Phần tiêu đề “Endpoint”- List price lists
GET /v1/price-lists - Create a price list
POST /v1/price-lists - Get a price list
GET /v1/price-lists/{price_list_id} - Update a price list
PUT /v1/price-lists/{price_list_id} - Delete a price list
DELETE /v1/price-lists/{price_list_id}