---
title: "Codeunit 130512 Library - Purchase"
author: "JOP-AL"
url: https://jonas-paprotka.de/ref/codeunit/130512-library-purchase/
type: codeunit
id: 130512
name: "Library - Purchase"
app: "Application Test Library"
versions: "28-29"
build: 29.0.54011.55644
countries: "W1, DE, US"
source: "https://jonas-paprotka.de/ref/codeunit/130512-library-purchase/source/"
checked: 2026-11-20
changed: 2026-10-05
subject: "Microsoft Dynamics 365 Business Central"
license: "Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/"
---

# Codeunit 130512 Library - Purchase

JOP-AL, https://jonas-paprotka.de/ref/codeunit/130512-library-purchase/

| | |
| --- | --- |
| App | Application Test Library |
| Versions | 28-29 |
| Minors | W1 28.0-29.0; DE 28.0-29.0; US 28.0-29.0, [every minor](https://jonas-paprotka.de/ref/codeunit/130512-library-purchase/editions.json) |
| Source file | LibraryPurchase.Codeunit.al |

## Procedures

| Name | Parameters | Returns | Access | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- | --- |
| AssignPurchChargeToPurchRcptLine | (PurchaseHeader: Record "Purchase Header"; PurchRcptLine: Record "Purch. Rcpt. Line"; Qty: Decimal; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| AssignPurchChargeToPurchInvoiceLine | (PurchaseHeader: Record "Purchase Header"; PurchInvLine: Record "Purch. Inv. Line"; Qty: Decimal; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| AssignPurchChargeToPurchaseLine | (PurchaseHeader: Record "Purchase Header"; PurchaseLine: Record "Purchase Line"; Qty: Decimal; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| AssignPurchChargeToPurchReturnLine | (PurchaseHeader: Record "Purchase Header"; PurchaseLine: Record "Purchase Line"; Qty: Decimal; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| CreateItemChargePurchaseLine | (var PurchaseLine: Record "Purchase Line"; var ItemCharge: Record "Item Charge"; PurchaseHeader: Record "Purchase Header"; Qty: Decimal; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| BlanketPurchaseOrderMakeOrder | (var PurchaseHeader: Record "Purchase Header") | Code[20] | public | 28-29 | - | - |
| CopyPurchaseDocument | (PurchaseHeader: Record "Purchase Header"; FromDocType: Enum "Purchase Document Type From"; FromDocNo: Code[20]; NewIncludeHeader: Boolean; NewRecalcLines: Boolean) | - | public | 28-29 | - | - |
| CreateItemChargeAssignment | (var ItemChargeAssignmentPurch: Record "Item Charge Assignment (Purch)"; PurchaseLine: Record "Purchase Line"; ItemCharge: Record "Item Charge"; DocType: Enum "Purchase Applies-to Document Type"; DocNo: Code[20]; DocLineNo: Integer; ItemNo: Code[20]; Qty: Decimal; UnitCost: Decimal) | - | public | 28-29 | - | - |
| CreateOrderAddress | (var OrderAddress: Record "Order Address"; VendorNo: Code[20]) | - | public | 28-29 | - | - |
| CreateRemitToAddress | (var RemitToAddress: Record "Remit Address"; VendorNo: Code[20]) | - | public | 28-29 | - | - |
| CreatePrepaymentVATSetup | (var LineGLAccount: Record "G/L Account"; VATCalculationType: Enum "Tax Calculation Type") | Code[20] | public | 28-29 | - | - |
| CreatePurchasingCode | (var Purchasing: Record Purchasing) | - | public | 28-29 | - | - |
| CreateDropShipmentPurchasingCode | (var Purchasing: Record Purchasing) | - | public | 28-29 | - | - |
| CreateSpecialOrderPurchasingCode | (var Purchasing: Record Purchasing) | - | public | 28-29 | - | - |
| CreatePurchHeader | (var PurchaseHeader: Record "Purchase Header"; DocumentType: Enum "Purchase Document Type"; BuyfromVendorNo: Code[20]) | - | public | 28-29 | - | - |
| CreatePurchHeaderWithDocNo | (var PurchaseHeader: Record "Purchase Header"; DocumentType: Enum "Purchase Document Type"; BuyfromVendorNo: Code[20]; DocNo: Code[20]) | - | public | 28-29 | - | - |
| CreatePurchaseLine | (var PurchaseLine: Record "Purchase Line"; PurchaseHeader: Record "Purchase Header"; LineType: Enum "Purchase Line Type"; No: Code[20]; Quantity: Decimal) | - | public | 28-29 | - | - |
| CreatePurchaseLineSimple | (var PurchaseLine: Record "Purchase Line"; PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| CreatePurchaseLineWithUnitCost | (var PurchaseLine: Record "Purchase Line"; PurchaseHeader: Record "Purchase Header"; ItemNo: Code[20]; UnitCost: Decimal; Quantity: Decimal) | - | public | 28-29 | - | - |
| CreatePurchaseQuote | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| CreatePurchaseInvoice | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| CreatePurchaseInvoiceForVendorNo | (var PurchaseHeader: Record "Purchase Header"; VendorNo: Code[20]) | - | public | 28-29 | - | - |
| CreatePurchaseOrder | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| CreatePurchaseOrderForVendorNo | (var PurchaseHeader: Record "Purchase Header"; VendorNo: Code[20]) | - | public | 28-29 | - | - |
| CreatePurchaseCreditMemo | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| CreatePurchaseCreditMemoForVendorNo | (var PurchaseHeader: Record "Purchase Header"; VendorNo: Code[20]) | - | public | 28-29 | - | - |
| CreatePurchaseOrderWithLocation | (var PurchaseHeader: Record "Purchase Header"; VendorNo: Code[20]; LocationCode: Code[10]) | - | public | 28-29 | - | - |
| CreatePurchaseReturnOrderWithLocation | (var PurchaseHeader: Record "Purchase Header"; VendorNo: Code[20]; LocationCode: Code[10]) | - | public | 28-29 | - | - |
| CreatePurchaseCreditMemoWithLocation | (var PurchaseHeader: Record "Purchase Header"; VendorNo: Code[20]; LocationCode: Code[10]) | - | public | 28-29 | - | - |
| CreatePurchaseReturnOrder | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| CreatePurchaseDocument | (var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; DocType: Enum "Purchase Document Type"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| CreatePurchaseOrder | (var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| CreatePurchaseQuote | (var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| CreatePurchaseBlanketOrder | (var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| CreatePurchaseReturnOrder | (var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| CreatePurchaseCreditMemo | (var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| CreatePurchaseInvoice | (var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal) | - | public | 28-29 | - | - |
| CreatePurchCommentLine | (var PurchCommentLine: Record "Purch. Comment Line"; DocumentType: Enum "Purchase Comment Document Type"; No: Code[20]; DocumentLineNo: Integer) | - | public | 28-29 | - | - |
| CreatePurchaseDocumentWithItem | (var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; DocumentType: Enum "Purchase Document Type"; VendorNo: Code[20]; ItemNo: Code[20]; Quantity: Decimal; LocationCode: Code[10]; ExpectedReceiptDate: Date) | - | public | 28-29 | - | - |
| CreateFCYPurchaseDocumentWithItem | (var PurchaseHeader: Record "Purchase Header"; var PurchaseLine: Record "Purchase Line"; DocumentType: Enum "Purchase Document Type"; VendorNo: Code[20]; ItemNo: Code[20]; Quantity: Decimal; LocationCode: Code[10]; ExpectedReceiptDate: Date; CurrencyCode: Code[10]) | - | public | 28-29 | - | - |
| CreatePurchasePrepaymentPct | (var PurchasePrepaymentPct: Record "Purchase Prepayment %"; ItemNo: Code[20]; VendorNo: Code[20]; StartingDate: Date) | - | public | 28-29 | - | - |
| CreateStandardPurchaseCode | (var StandardPurchaseCode: Record "Standard Purchase Code") | - | public | 28-29 | - | - |
| CreateStandardPurchaseLine | (var StandardPurchaseLine: Record "Standard Purchase Line"; StandardPurchaseCode: Code[10]) | - | public | 28-29 | - | - |
| CreateVendorDocumentLayout | (VendorNo: Code[20]; ReportSelectionUsage: Enum "Report Selection Usage"; ReportID: Integer; CustomReportLayoutCode: Code[20]; EmailAddress: Text) | - | public | 28-29 | - | - |
| CreateSubcontractor | (var Vendor: Record Vendor) | - | public | 28-29 | - | - |
| CreateVendor | (var Vendor: Record Vendor) | Code[20] | public | 28-29 | - | - |
| CreateVendorNo | () | Code[20] | public | 28-29 | - | - |
| CreateVendorPostingGroup | (var VendorPostingGroup: Record "Vendor Posting Group") | - | public | 28-29 | - | - |
| CreateAltVendorPostingGroup | (ParentCode: Code[10]; AltCode: Code[10]) | - | public | 28-29 | - | - |
| CreateVendorWithLocationCode | (var Vendor: Record Vendor; LocationCode: Code[10]) | Code[20] | public | 28-29 | - | - |
| CreateVendorWithBusPostingGroups | (GenBusPostGroupCode: Code[20]; VATBusPostGroupCode: Code[20]) | Code[20] | public | 28-29 | - | - |
| CreateVendorWithVATBusPostingGroup | (VATBusPostGroupCode: Code[20]) | Code[20] | public | 28-29 | - | - |
| CreateVendorWithVATRegNo | (var Vendor: Record Vendor) | Code[20] | public | 28-29 | - | - |
| CreateVendorWithAddress | (var Vendor: Record Vendor) | - | public | 28-29 | - | - |
| CreateVendorBankAccount | (var VendorBankAccount: Record "Vendor Bank Account"; VendorNo: Code[20]) | - | public | 28-29 | - | - |
| CreateVendorPurchaseCode | (var StandardVendorPurchaseCode: Record "Standard Vendor Purchase Code"; VendorNo: Code[20]; Code: Code[10]) | - | public | 28-29 | - | - |
| CreatePurchaseHeaderPostingJobQueueEntry | (var JobQueueEntry: Record "Job Queue Entry"; PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| CreateIntrastatContact | (CountryRegionCode: Code[10]) | Code[20] | public | 28-29 | - | - |
| DeleteInvoicedPurchOrders | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| ExplodeBOM | (var PurchaseLine: Record "Purchase Line") | - | public | 28-29 | - | - |
| FilterPurchaseHeaderArchive | (var PurchaseHeaderArchive: Record "Purchase Header Archive"; DocumentType: Enum "Purchase Document Type"; DocumentNo: Code[20]; DocNoOccurance: Integer; Version: Integer) | - | public | 28-29 | - | - |
| FilterPurchaseLineArchive | (var PurchaseLineArchive: Record "Purchase Line Archive"; DocumentType: Enum "Purchase Document Type"; DocumentNo: Code[20]; DocNoOccurance: Integer; Version: Integer) | - | public | 28-29 | - | - |
| FindVendorPostingGroup | () | Code[20] | public | 28-29 | - | - |
| FindFirstPurchLine | (var PurchaseLine: Record "Purchase Line"; PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| FindReturnShipmentHeader | (var ReturnShipmentHeader: Record "Return Shipment Header"; ReturnOrderNo: Code[20]) | - | public | 28-29 | - | - |
| GetDropShipment | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| GetInvRoundingAccountOfVendPostGroup | (VendorPostingGroupCode: Code[20]) | Code[20] | public | 28-29 | - | - |
| GetPurchaseReturnShipmentLine | (var PurchaseLine: Record "Purchase Line") | - | public | 28-29 | - | - |
| GetPurchaseReceiptLine | (var PurchaseLine: Record "Purchase Line") | - | public | 28-29 | - | - |
| GetSpecialOrder | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| GegVendorLedgerEntryUniqueExternalDocNo | () | Code[10] | public | 28-29 | - | - |
| PostPurchaseOrder | (var PurchaseHeader: Record "Purchase Header"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal; Receive: Boolean; Invoice: Boolean) | - | public | 28-29 | - | - |
| PostPurchaseOrderWithItemTracking | (var PurchaseHeader: Record "Purchase Header"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal; Receive: Boolean; Invoice: Boolean; SerialNo: Code[50]; LotNo: Code[50]) | - | public | 28-29 | - | - |
| PostPurchaseOrderPartially | (var PurchaseHeader: Record "Purchase Header"; Item: Record Item; LocationCode: Code[10]; VariantCode: Code[10]; Qty: Decimal; PostingDate: Date; DirectUnitCost: Decimal; Receive: Boolean; ReceiveQty: Decimal; Invoice: Boolean; InvoiceQty: Decimal) | - | public | 28-29 | - | - |
| PostPurchasePrepaymentCrMemo | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| PostPurchasePrepaymentCreditMemo | (var PurchaseHeader: Record "Purchase Header") | Code[20] | public | 28-29 | - | - |
| PostPurchasePrepaymentInvoice | (var PurchaseHeader: Record "Purchase Header") | Code[20] | public | 28-29 | - | - |
| PostPurchaseDocument | (var PurchaseHeader: Record "Purchase Header"; NewShipReceive: Boolean; NewInvoice: Boolean) | Code[20] | public | 28-29 | - | - |
| QuoteMakeOrder | (var PurchaseHeader: Record "Purchase Header") | Code[20] | public | 28-29 | - | - |
| ReleasePurchaseDocument | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| ReopenPurchaseDocument | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| CalcPurchaseDiscount | (PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| RunBatchPostPurchaseReturnOrdersReport | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| RunDeleteInvoicedPurchaseReturnOrdersReport | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| RunMoveNegativePurchaseLinesReport | (var PurchaseHeader: Record "Purchase Header"; FromDocType: Option; ToDocType: Option; ToDocType2: Option) | - | public | 28-29 | - | - |
| SetAllowVATDifference | (AllowVATDifference: Boolean) | - | public | 28-29 | - | - |
| SetAllowDocumentDeletionBeforeDate | (Date: Date) | - | public | 28-29 | - | - |
| SetApplnBetweenCurrencies | (ApplnBetweenCurrencies: Option) | - | public | 28-29 | - | - |
| SetArchiveQuotesAlways | () | - | public | 28-29 | - | - |
| SetArchiveOrders | (ArchiveOrders: Boolean) | - | public | 28-29 | - | - |
| SetArchiveBlanketOrders | (ArchiveBlanketOrders: Boolean) | - | public | 28-29 | - | - |
| SetArchiveReturnOrders | (ArchiveReturnOrders: Boolean) | - | public | 28-29 | - | - |
| SetCreateItemFromItemNo | (NewValue: Boolean) | - | public | 28-29 | Pending 27.0 | Discontinued functionality |
| SetDefaultPostingDateWorkDate | () | - | public | 28-29 | - | - |
| SetDefaultPostingDateNoDate | () | - | public | 28-29 | - | - |
| SetDiscountPosting | (DiscountPosting: Option) | - | public | 28-29 | - | - |
| SetDiscountPostingSilent | (DiscountPosting: Option) | - | public | 28-29 | - | - |
| SetCalcInvDiscount | (CalcInvDiscount: Boolean) | - | public | 28-29 | - | - |
| SetInvoiceRounding | (InvoiceRounding: Boolean) | - | public | 28-29 | - | - |
| SetExactCostReversingMandatory | (ExactCostReversingMandatory: Boolean) | - | public | 28-29 | - | - |
| SetExtDocNo | (ExtDocNoMandatory: Boolean) | - | public | 28-29 | - | - |
| SetPostWithJobQueue | (PostWithJobQueue: Boolean) | - | public | 28-29 | - | - |
| SetPostAndPrintWithJobQueue | (PostAndPrintWithJobQueue: Boolean) | - | public | 28-29 | - | - |
| SetOrderNoSeriesInSetup | () | - | public | 28-29 | - | - |
| SetPostedNoSeriesInSetup | () | - | public | 28-29 | - | - |
| SetQuoteNoSeriesInSetup | () | - | public | 28-29 | - | - |
| SetReturnOrderNoSeriesInSetup | () | - | public | 28-29 | - | - |
| SetCopyCommentsOrderToInvoiceInSetup | (CopyCommentsOrderToInvoice: Boolean) | - | public | 28-29 | - | - |
| SelectPmtJnlBatch | (var GenJournalBatch: Record "Gen. Journal Batch") | - | public | 28-29 | - | - |
| SelectPmtJnlTemplate | () | Code[10] | public | 28-29 | - | - |
| UndoPurchaseReceiptLine | (var PurchRcptLine: Record "Purch. Rcpt. Line") | - | public | 28-29 | - | - |
| UndoReturnShipmentLine | (var ReturnShipmentLine: Record "Return Shipment Line") | - | public | 28-29 | - | - |
| DisableConfirmOnPostingDoc | () | - | public | 28-29 | - | - |
| DisableWarningOnCloseUnreleasedDoc | () | - | public | 28-29 | - | - |
| DisableWarningOnCloseUnpostedDoc | () | - | public | 28-29 | - | - |
| EnablePurchSetupIgnoreUpdatedAddresses | () | - | public | 28-29 | - | - |
| DisablePurchSetupIgnoreUpdatedAddresses | () | - | public | 28-29 | - | - |
| PreviewPostPurchaseDocument | (var PurchaseHeader: Record "Purchase Header") | - | public | 28-29 | - | - |
| CreatePostVendorLedgerEntry | (var VendorLedgerEntry: Record "Vendor Ledger Entry") | - | public | 28-29 | - | - |

## Events

| Kind | Name | Parameters | Versions | Obsolete | Reason |
| --- | --- | --- | --- | --- | --- |
| Integration event | OnAfterCreatePurchHeader | (var PurchaseHeader: Record "Purchase Header"; DocumentType: Enum "Purchase Document Type"; BuyfromVendorNo: Code[20]) | 28-29 | - | - |
| Integration event | OnAfterCreatePurchaseLine | (var PurchaseLine: Record "Purchase Line"; PurchaseHeader: Record "Purchase Header"; Type: Enum "Purchase Line Type"; No: Code[20]; Quantity: Decimal) | 28-29 | - | - |
| Integration event | OnAfterCreateVendor | (var Vendor: Record Vendor) | 28-29 | - | - |
| Integration event | OnBeforeCreatePurchaseHeader | (var PurchaseHeader: Record "Purchase Header"; DocumentType: Enum "Purchase Document Type"; BuyfromPurchaseNo: Code[20]) | 28-29 | - | - |

## Source

Symbols: Microsoft.ApplicationTestLibrary.symbols.d852d5d2-a39d-4179-baeb-f99a19e32510, https://dynamicssmb2.pkgs.visualstudio.com/DynamicsBCPublicFeeds/_packaging/MSSymbols/nuget/v3/index.json, highest build per major on 2026-11-20.
AL source 29: https://github.com/microsoft/BCApps, MIT, releases/29.x at 4303e5e584d3aa5d9e98cbc615525a5396ad6ed7.

JOP-AL, 2026-11-20.
