purchaseInvoiceLines resource type

NEW VERSION This is v1.0 of the Business Central API. For the newest version, see Business Central API (V2.0).

Represents a line on a purchase invoice in Dynamics 365 Business Central.


For information about enabling APIs for Dynamics NAV see Enabling the APIs for Dynamics 365 Business Central.


Method Return Type Description
GET purchaseInvoiceLines purchaseInvoiceLines Gets a purchase invoice line object.
POST purchaseInvoiceLines purchaseInvoiceLines Creates a purchase invoice line object.
PATCH purchaseInvoiceLines purchaseInvoiceLines Updates a purchase invoice line object.
DELETE purchaseInvoiceLines none Deletes a purchase invoice line object.


Property Type Description
documentId GUID The ID of the parent invoice.
sequence numeric The line sequence number.
itemId GUID The Id of the item in the invoice line.
accountId GUID The Id of the Account that will be used for this line. lineType will automatically be set to "Account" if this is set.
lineType string The type of the line. Can be Comment,Account,Item,Resource,Fixed Asset,Charge
lineDetails complex The details of the line.
description string A description of the item in the invoice line.
unitOfMeasure NAV.UnitOfMeasure The unit of measure complex type.
unitCost numeric The unit cost of each individual item in the invoice line.
quantity numeric The quantity of the item in the invoice line.
discountAmount numeric The line discount amount.
discountPercent numeric The line discount percent.
discountAppliedBeforeTax boolean Specified if the discount is applied before tax. Read-Only.
amountExcludingTax numeric The line amount excluding the tax. Read-Only.
taxCode string The tax code for the line.
taxPercent numeric The tax percent for the line. Read-Only.
totalTaxAmount numeric The total tax amount for the line. Read-Only.
amountIncludingTax numeric The total amount for the line including tax. Read-Only.
invoiceDiscountAllocation numeric The invoice discount allocation is the invoice discount distributed on the total amount. Read-Only.
netAmount numeric The net amount is the amount including all discounts (taken from invoice header). Read-Only.
netTaxAmount numeric The net tax amount is the tax amount calculated from net amount. Read-Only.
netAmountIncludingTax numeric The net amount including tax is the total net amount including tax. Read-Only.
expectedReceiptDate date The date the item in the line is expected to be received.


A Purchase Invoice (documentId) must exist in the Purchase Invoices table.

An Item (itemId) must exist in the Item table.

An Account (accountId) must exist in the Accounts table.

A Unit of Measure (unitOfMeasure) must exist in the Unit of Measure table.

JSON representation

Here is a JSON representation of the resource.

  "value": [
      "documentId": "GUID",
      "sequence": "decimal",
      "itemId": "GUID",
      "accountId": "GUID",
      "lineType": "String",
      "lineDetails": {NAV.documentLineObjectDetails},
      "description": "String",
      "unitOfMeasure": {NAV.UnitOfMeasure},
      "directUnitCost": "decimal",
      "unitCost": "decimal",
      "quantity": "decimal",
      "discountAmount": "decimal",
      "discountPercent": "decimal",
      "discountAppliedBeforeTax": "boolean",
      "amountExcludingTax": "decimal",
      "taxCode": "String",
      "taxPercent": "decimal",
      "totalTaxAmount": "decimal",
      "amountIncludingTax": "decimal",
      "invoiceDiscountAllocation": "decimal",
      "netAmount": "decimal",
      "netTaxAmount": "decimal",
      "netAmountIncludingTax": "decimal",
      "expectedReceiptDate": "Date"

See also

Get Purchase Invoice Line
Create Purchase Invoice Line
Update Purchase Invoice Line
Delete Purchase Invoice Line