# Posted Purchase Invoices _(Realtime-enabled)_

`GET` _(Table: Purch. Inv. Header)_

```
eOne/core/v1.0/postedPurchaseInvoices
```

Read-only feed of posted purchase invoice headers, the AP-side, posted counterpart of the writable [Purchase Invoices](https://eonesolutions.github.io/eone-bc-integration/core-purchaseInvoices.md) endpoint, with `integrationId` mirrored from the order at post time. See [Posted Documents](https://eonesolutions.github.io/eone-bc-integration/posted-documents.md) for the shared rationale.

## Lines

`$expand=purchaseInvoiceLines` for lightweight lines, or `$expand=purchaseInvoiceTrackingLines` when you need serial/lot/package numbers. `$expand=documentAttachments` for files.

> **Note:** Carries the vendor's own references, `vendorInvoiceNumber` and `vendorOrderNumber`. Read-only; filter on `number`, `orderNumber`, `buyFromVendorNumber`, `postingDate`, or `integrationId`. `currencyCode` blank = LCY.

## Posted Purchase Invoices 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; the OData key. _(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)_ |
| `number` | No. | Posted invoice number. _(ro)_ |
| `integrationId` | EONE Integration Id | Your external key, mirrored from the order at post time. _(ro)_ |
| `orderNumber` | Order No. | Originating purchase order number. _(ro)_ |
| `postingDate` | Posting Date | _(ro)_ |
| `documentDate` | Document Date | _(ro)_ |
| `dueDate` | Due Date | _(ro)_ |
| `vendorInvoiceNumber` | Vendor Invoice No. | The vendor's own invoice number. _(ro)_ |
| `vendorOrderNumber` | Vendor Order No. | _(ro)_ |
| `yourReference` | Your Reference | _(ro)_ |
| `buyFromVendorNumber` | Buy-from Vendor No. | _(ro)_ |
| `buyFromVendorName` | Buy-from Vendor Name | _(ro)_ |
| `payToVendorNumber` | Pay-to Vendor No. | _(ro)_ |
| `payToName` | Pay-to Name | _(ro)_ |
| `currencyCode` | Currency Code | Blank means the local currency (LCY). _(cur)_ |
| `amount` | Amount | Net of tax. _(ro)_ |
| `amountIncludingTax` | Amount Including VAT | _(ro)_ |
| `pricesIncludingTax` | Prices Including VAT | _(ro)_ |
| `paymentTermsCode` | Payment Terms Code | _(ro)_ |
| `paymentMethodCode` | Payment Method Code | _(ro)_ |
| `purchaserCode` | Purchaser Code | _(ro)_ |
| `locationCode` | Location Code | _(ro)_ |
| `shortcutDimension1Code` | Shortcut Dimension 1 Code | Shortcut dimension 1. See Dimensions. _(ro)_ |
| `shortcutDimension2Code` | Shortcut Dimension 2 Code | Shortcut dimension 2. See Dimensions. _(ro)_ |
| `dimensionSetId` | Dimension Set ID | The dimension set this record carries. Join it to the dimensionSetEntries endpoint to resolve the full set of dimension codes and values, including any beyond the eight shortcut dimension columns. _(ro)_ |
| `lastModifiedDateTime` | SystemModifiedAt | _(ro)_ |

## Related pages

Collections nested under this endpoint:

- [Posted Purchase Invoice Lines](https://eonesolutions.github.io/eone-bc-integration/core-postedPurchaseInvoiceLines.md)
- [Posted Purchase Invoice Tracking Lines](https://eonesolutions.github.io/eone-bc-integration/core-postedPurchaseInvoiceTrackingLines.md)
