---
id: object/page/20042
type: object
title: Page 20042 "APIV1 - Purchase Invoices"
summary: Page 20042 "APIV1 - Purchase Invoices" in APIV1 (Microsoft.API.V1). 1 public procedures. Introduced in BC29, still in BC30.
tier: official
language: en
tags:
  - page
  - apiv1
versions:
  introduced: "29"
  last_changed: null
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 90118ab7ee6b8169422a4b58b7316c0b9ed35be367d96c4bfe346b6107da1894
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/APIV1/app/src/pages/APIV1PurchaseInvoices.Page.al
    title: src/Apps/W1/APIV1/app/src/pages/APIV1PurchaseInvoices.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_delete
    title: (v1.0) Delete purchaseInvoices
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_get
    title: (v1.0) Get purchaseInvoices
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_pdfdocument
    title: (v1.0) Get purchaseInvoice pdfDocument
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_update
    title: (v1.0) Update purchaseInvoices
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_purchaseinvoice
    title: (v1.0) purchaseInvoices resource type
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_delete
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_get
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_pdfdocument
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_update
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_purchaseinvoice
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: page
object_id: 20042
name: APIV1 - Purchase Invoices
namespace: Microsoft.API.V1
app: APIV1
extends: null
first_version: "29"
last_version: "30"
present_in:
  - "29"
  - "30"
changed_in: []
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids:
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_delete.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_get.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_pdfdocument.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_update.md
  - docs/learn-devitpro/dev-itpro/api-reference/v1.0/resources/dynamics_purchaseinvoice.md
counts:
  fields: 0
  procedures: 14
  events: 0
  subscribers: 0
  controls: 30
  actions: 0
relations:
  out: 1
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 0
  calls: 5
  called_by: 0
  implements: 0
---

# Page 20042 "APIV1 - Purchase Invoices"

> Page 20042 "APIV1 - Purchase Invoices" in APIV1 (Microsoft.API.V1). 1 public procedures. Introduced in BC29, still in BC30.

APIV1 · Microsoft.API.V1 · BC29-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/APIV1/app/src/pages/APIV1PurchaseInvoices.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | 'purchaseInvoices', Locked = true |
| Extensible | false |
| SourceTable | Purch. Inv. Entity Aggregate |
| PageType | API |

## Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control's own, else the bound field's (marked).

| Group | Control | Shows | ToolTip |
|---|---|---|---|
| Group | id | [Id](../table/5477.md#fields) | — |
|  | number | [No.](../table/5477.md#fields) | — |
|  | invoiceDate | [Document Date](../table/5477.md#fields) | — |
|  | postingDate | [Posting Date](../table/5477.md#fields) | — |
|  | dueDate | [Due Date](../table/5477.md#fields) | — |
|  | vendorInvoiceNumber | [Vendor Invoice No.](../table/5477.md#fields) | — |
|  | vendorId | [Vendor Id](../table/5477.md#fields) | — |
|  | vendorNumber | [Buy-from Vendor No.](../table/5477.md#fields) | — |
|  | vendorName | [Buy-from Vendor Name](../table/5477.md#fields) | — |
|  | payToName | [Pay-to Name](../table/5477.md#fields) | — |
|  | payToContact | [Pay-to Contact](../table/5477.md#fields) | — |
|  | payToVendorId | [Pay-to Vendor Id](../table/5477.md#fields) | — |
|  | payToVendorNumber | [Pay-to Vendor No.](../table/5477.md#fields) | — |
|  | shipToName | [Ship-to Name](../table/5477.md#fields) | — |
|  | shipToContact | [Ship-to Contact](../table/5477.md#fields) | — |
|  | buyFromAddress | `BuyFromPostalAddressJSONText` | Specifies the buy-from address of the Purchase Invoice. |
|  | payToAddress | `PayToPostalAddressJSONText` | Specifies the pay-to address of the Purchase Invoice. |
|  | shipToAddress | `ShipToPostalAddressJSONText` | Specifies the ship-to address of the Purchase Invoice. |
|  | currencyId | [Currency Id](../table/5477.md#fields) | — |
|  | currencyCode | `CurrencyCodeTxt` | — |
|  | pricesIncludeTax | [Prices Including VAT](../table/5477.md#fields) | — |
|  | purchaseInvoiceLines | part [Page 20047 "APIV1 - Purchase Invoice Lines"](../page/20047.md) | — |
|  | pdfDocument | part [Page 20057 "APIV1 - PDF Document"](../page/20057.md) | — |
|  | discountAmount | [Invoice Discount Amount](../table/5477.md#fields) | — |
|  | discountAppliedBeforeTax | [Discount Applied Before Tax](../table/5477.md#fields) | — |
|  | totalAmountExcludingTax | [Amount](../table/5477.md#fields) | — |
|  | totalTaxAmount | [Total Tax Amount](../table/5477.md#fields) | — |
|  | totalAmountIncludingTax | [Amount Including VAT](../table/5477.md#fields) | — |
|  | status | [Status](../table/5477.md#fields) | — |
|  | lastModifiedDateTime | [Last Modified Date Time](../table/5477.md#fields) | — |

## Procedures

- `Post(var ActionContext: WebServiceActionContext)`

Plus 13 local procedures.

## Triggers

OnAfterGetRecord, OnDeleteRecord, OnInsertRecord, OnModifyRecord, OnNewRecord, OnOpenPage

## Relations

- source table [Table 5477 "Purch. Inv. Entity Aggregate"](../table/5477.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 5529 "Purch. Inv. Aggregator"](../codeunit/5529.md) (8 calls: `OnAfterGetRecord → RedistributeInvoiceDiscounts`, `OnDeleteRecord → PropagateOnDelete`, `OnInsertRecord → PropagateOnInsert`, …)
- [Codeunit 5527 "Graph Mgt - Purchase Invoice"](../codeunit/5527.md) (7 calls: `ProcessBuyFromPostalAddressOnInsert → ParseBuyFromVendorAddressFromJSON`, `ProcessBuyFromPostalAddressOnModify → ParseBuyFromVendorAddressFromJSON`, `ProcessShipToPostalAddressOnInsert → ParseShipToVendorAddressFromJSON`, …)
- [Codeunit 1320 "Lines Instruction Mgt."](../codeunit/1320.md) (1 call: `PostInvoice → PurchaseCheckAllLinesHaveQuantityAssigned`)
- [Codeunit 5465 "Graph Mgt - General Tools"](../codeunit/5465.md) (1 call: `SetCalculatedFields → TranslateNAVCurrencyCodeToCurrencyCode`)
- [Codeunit 66 "Purch - Calc Disc. By Type"](../codeunit/66.md) (1 call: `UpdateDiscount → ApplyInvDiscBasedOnAmt`)

## Across versions

- Present in: BC29-30
- Changed (declaration) in: none

## Documented on Microsoft Learn

- [(v1.0) Delete purchaseInvoices](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_delete)
- [(v1.0) Get purchaseInvoices](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_get)
- [(v1.0) Get purchaseInvoice pdfDocument](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_pdfdocument)
- [(v1.0) Update purchaseInvoices](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/api/dynamics_purchaseinvoice_update)
- [(v1.0) purchaseInvoices resource type](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_purchaseinvoice)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "page", object_name: "APIV1 - Purchase Invoices")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.