# Price lists _(Realtime-enabled)_

`GET` `POST` `PATCH` `DELETE` _(Table: Price List Header)_

```
eOne/core/v1.0/priceListHeaders
```

Price lists in the new pricing experience: a `priceListHeaders` header and its `priceListLines`. Each line carries its scope (assign-to type/number), product, quantity break, currency and validity dates.

`currencyCode` is an ISO code; blank means the local currency.

Create the header first. Leave `code` blank to draw the next number from the price list no. series, or supply your own. Changing `code` later renames the list and keeps its lines.

> **Note:** Deep-insert the [priceListLines](https://eonesolutions.github.io/eone-bc-integration/core-priceListLines.md) collection when you `POST` the header (its code is stamped onto each line for you), `$expand=priceListLines` to read a list with its lines, and use one OData `$batch` request to load prices in bulk. See [Price List Lines](https://eonesolutions.github.io/eone-bc-integration/core-priceListLines.md) for the line fields (item resolver, project pricing, quantity breaks).

> **Note:** Subscribe to these entities for a webhook when prices change. Filter with OData, e.g. `$filter=priceType eq 'Sale' and assetType eq 'Item' and status eq 'Active'`.

Related: [Sales Prices](https://eonesolutions.github.io/eone-bc-integration/core-salesPrices.md) and [Sales Line Discounts](https://eonesolutions.github.io/eone-bc-integration/core-salesLineDiscounts.md) expose the classic (pre-price-list) tables.

## Price List Headers fields

_API column → BC field._

**Legend**

- _(req)_ required on create
- _(res)_ resolver
- _(cur)_ currency-translated
- _(ro)_ read-only
- _(ext)_ added to this endpoint by another extension (BC field name shown; its API column name is not known here)

| API | BC field | Notes |
| --- | --- | --- |
| `id` | SystemId | BC record GUID. _(ro)_ |
| `bcCompanyId` | bcCompanyId | The company this row belongs to - the same GUID that appears in the request URL. Present on every endpoint so a store pooling several companies can keep them apart without relying on which URL it called. _(ro)_ |
| `bcCompanyName` | bcCompanyName | The name of the company this row belongs to. _(ro)_ |
| `code` | Code | Price list code (primary key). Leave blank on insert to auto-assign from the no. series. Changing it renames the list and keeps its lines. |
| `description` | Description |  |
| `priceType` | Price Type | Sale or Purchase. _(req)_ |
| `amountType` | Amount Type | Whether the list defines prices, discounts, or both. |
| `sourceType` | Source Type | Assign-to type: who the prices apply to (All / Customer / group...). |
| `sourceNo` | Source No. | Assign-to number: the entity the prices apply to. |
| `parentSourceNo` | Parent Source No. | Parent source for hierarchical sources. |
| `currencyCode` | currencyCode | ISO code; blank = LCY. _(cur)_ |
| `startingDate` | Starting Date | Validity start. |
| `endingDate` | Ending Date | Validity end. |
| `priceIncludesVAT` | Price Includes VAT |  |
| `vatBusPostingGrPrice` | VAT Bus. Posting Gr. (Price) |  |
| `allowLineDisc` | Allow Line Disc. |  |
| `allowInvoiceDisc` | Allow Invoice Disc. |  |
| `allowUpdatingDefaults` | Allow Updating Defaults | Whether lines may change values that default from the header. |
| `status` | Status | Draft / Active / Inactive. |
| `createdDateTime` | SystemCreatedAt | _(ro)_ |
| `lastModifiedDateTime` | SystemModifiedAt | _(ro)_ |

## Related pages

Collections nested under this endpoint:

- [Price List Lines](https://eonesolutions.github.io/eone-bc-integration/core-priceListLines.md)