Microsoft Dynamics 365 Business Central API
/
Default built by Microsoft
/
Business Central Purchase Invoice API
/
Creates an object of type purchaseInvoice in Dynamics 365 Business Central

Dynamics 365 Business Central API (1.0)

Dynamics 365 Business Central is a comprehensive business management solution developed by Microsoft. It is designed for small to medium-sized businesses to streamline operations across finance, sales, service, and supply chain. With powerful capabilities and cloud-based flexibility, it helps businesses make informed decisions and drive growth efficiently.

This is a complete REST API documentation for integrating with Dynamics 365 Business Central. It includes standard endpoints provided by Microsoft for managing business data and operations.

Metadata

KeyValue
releaseDate10 Apr 2025
keywordDynamics 365 Business Central API
Download OpenAPI description
default-built-by-microsoft.json
default-built-by-microsoft.yaml
Languages
Servers
Mock server

https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/

https://api.businesscentral.dynamics.com/v2.0/Production/api/v2.0/

https://login.microsoftonline.com/

Business Central Get Access Token API

To obtain an access token, you cannot directly call it through a web UI. Instead, use Postman to make the request. Below is a sample request that you can follow to retrieve your access token:

Operations

Business Central Entity API

(v1.0) Represents all Entities in Dynamics 365 Business Central

Operations

Business Central Company API

(v1.0) Represents an object of type company in Dynamics 365 Business Central

Operations

Business Central Item API

(v1.0) Represents an object of type item in Dynamics 365 Business Central

Operations

Business Central Picture API

(v1.0) Represents an object of type picture in Dynamics 365 Business Central

Operations

Business Central Default Dimensions API

(v1.0) Represents an object of type defaultDimensions in Dynamics 365 Business Central

Operations

Business Central Customer API

(v1.0) Represents an object of type customer in Dynamics 365 Business Central

Operations

Business Central Customer Financial Detail API

(v1.0) Represents an object of type customerFinancialDetail in Dynamics 365 Business Central

Operations

Business Central Vendor API

(v1.0) Represents an object of type vendor in Dynamics 365 Business Central

Operations

Business Central Company Information API

(v1.0) Represents an object of type companyInformation in Dynamics 365 Business Central

Operations

Business Central Sales Invoice API

(v1.0) Represents an object of type salesInvoice in Dynamics 365 Business Central

Operations

Business Central Sales Invoice Line API

(v1.0) Represents an object of type salesInvoiceLine in Dynamics 365 Business Central

Business Central PDF Document API

(v1.0) Represents an object of type pdfDocument in Dynamics 365 Business Central

Operations

Business Central Customer Payment Journal API

(v1.0) Represents an object of type customerPaymentJournal in Dynamics 365 Business Central

Business Central Customer Payment API

(v1.0) Represents an object of type customerPayment in Dynamics 365 Business Central

Business Central Account API

(v1.0) Represents an object of type account in Dynamics 365 Business Central

Operations

Business Central Tax Group API

(v1.0) Represents an object of type taxGroup in Dynamics 365 Business Central

Operations

Business Central Journal API

(v1.0) Represents an object of type journal in Dynamics 365 Business Central

Operations

Business Central Journal Line API

(v1.0) Represents an object of type journalLine in Dynamics 365 Business Central

Business Central Attachments API

(v1.0) Represents an object of type attachments in Dynamics 365 Business Central

Operations

Business Central Employee API

(v1.0) Represents an object of type employee in Dynamics 365 Business Central

Operations

Business Central Time Registration Entry API

(v1.0) Represents an object of type timeRegistrationEntry in Dynamics 365 Business Central

Business Central General Ledger Entry API

(v1.0) Represents an object of type generalLedgerEntry in Dynamics 365 Business Central

Operations

Business Central Currency API

(v1.0) Represents an object of type currency in Dynamics 365 Business Central

Operations

Business Central Payment Method API

(v1.0) Represents an object of type paymentMethod in Dynamics 365 Business Central

Operations

Business Central Dimension API

(v1.0) Represents an object of type dimension in Dynamics 365 Business Central

Operations

Business Central Dimension Value API

(v1.0) Represents an object of type dimensionValue in Dynamics 365 Business Central

Operations

Business Central Dimension Line API

(v1.0) Represents an object of type dimensionLine in Dynamics 365 Business Central

Operations

Business Central Payment Term API

(v1.0) Represents an object of type paymentTerm in Dynamics 365 Business Central

Operations

Business Central Shipment Method API

(v1.0) Represents an object of type shipmentMethod in Dynamics 365 Business Central

Operations

Business Central Item Category API

(v1.0) Represents an object of type itemCategory in Dynamics 365 Business Central

Operations

Business Central Cash Flow Statement API

(v1.0) Represents an object of type cashFlowStatement in Dynamics 365 Business Central

Operations

Business Central Country Region API

(v1.0) Represents an object of type countryRegion in Dynamics 365 Business Central

Operations

Business Central Sales Order API

(v1.0) Represents an object of type salesOrder in Dynamics 365 Business Central

Operations

Business Central Sales Order Line API

(v1.0) Represents an object of type salesOrderLine in Dynamics 365 Business Central

Business Central Retained Earnings Statement API

(v1.0) Represents an object of type retainedEarningsStatement in Dynamics 365 Business Central

Operations

Business Central Unit Of Measure API

(v1.0) Represents an object of type unitOfMeasure in Dynamics 365 Business Central

Operations

Business Central Aged Accounts Receivable API

(v1.0) Represents an object of type agedAccountsReceivable in Dynamics 365 Business Central

Operations

Business Central Aged Accounts Payable API

(v1.0) Represents an object of type agedAccountsPayable in Dynamics 365 Business Central

Operations

Business Central Balance Sheet API

(v1.0) Represents an object of type balanceSheet in Dynamics 365 Business Central

Operations

Business Central Trial Balance API

(v1.0) Represents an object of type trialBalance in Dynamics 365 Business Central

Operations

Business Central Income Statement API

(v1.0) Represents an object of type incomeStatement in Dynamics 365 Business Central

Operations

Business Central Tax Area API

(v1.0) Represents an object of type taxArea in Dynamics 365 Business Central

Operations

Business Central Sales Quote API

(v1.0) Represents an object of type salesQuote in Dynamics 365 Business Central

Operations

Business Central Sales Quote Line API

(v1.0) Represents an object of type salesQuoteLine in Dynamics 365 Business Central

Business Central Sales Credit Memo API

(v1.0) Represents an object of type salesCreditMemo in Dynamics 365 Business Central

Operations

Business Central Sales Credit Memo Line API

(v1.0) Represents an object of type salesCreditMemoLine in Dynamics 365 Business Central

Business Central General Ledger Entry Attachments API

(v1.0) Represents an object of type generalLedgerEntryAttachments in Dynamics 365 Business Central

Operations

Business Central Purchase Invoice API

(v1.0) Represents an object of type purchaseInvoice in Dynamics 365 Business Central

Operations

Returns a list of purchaseInvoices

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
Query
$topinteger

(v1.0) Number of items to return from the top of the list

Example: $top=100
$skipinteger

(v1.0) Number of items to skip from the list

Example: $skip=0
$limitinteger

(v1.0) Number of items to return from the list

Example: $limit=100
$filterstring

(v1.0) Filtering expression

$expandArray of strings

(v1.0) Entities to expand

Items Enum"purchaseInvoiceLines""pdfDocument""vendor""currency"
$selectArray of strings

(v1.0) Selected properties to be retrieved

Items Enum"id""number""invoiceDate""dueDate""vendorInvoiceNumber""vendorId""vendorNumber""vendorName""payToName""payToContact"
curl -i -X GET \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/purchaseInvoices?%24expand=purchaseInvoiceLines&%24filter=string&%24limit=100&%24select=id&%24skip=0&%24top=100' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

(v1.0) Succesfully returned a list of purchaseInvoices

Bodyapplication/json
valueArray of objects(purchaseInvoice)
Response
application/json
{
  "value": [
    { … }
  ]
}

Creates an object of type purchaseInvoice in Dynamics 365 Business Central

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
Headers
Content-Typestringrequired

(v1.0) application/json

Bodyapplication/jsonrequired
idstring or null(uuid)

(v1.0) The id property for the Dynamics 365 Business Central purchaseInvoice entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
numberstring or null<= 20 characters

(v1.0) The number property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
invoiceDatestring or null(date-time)

(v1.0) The invoiceDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
dueDatestring or null(date-time)

(v1.0) The dueDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorInvoicenumberstring or null<= 35 characters

(v1.0) The vendorInvoiceNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorIdstring or null(uuid)

(v1.0) The vendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendornumberstring or null<= 20 characters

(v1.0) The vendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorNamestring or null<= 100 characters

(v1.0) The vendorName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToNamestring or null<= 100 characters

(v1.0) The payToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToContactstring or null<= 100 characters

(v1.0) The payToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendorIdstring or null(uuid)

(v1.0) The payToVendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendornumberstring or null<= 20 characters

(v1.0) The payToVendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToNamestring or null<= 100 characters

(v1.0) The shipToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToContactstring or null<= 100 characters

(v1.0) The shipToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencyIdstring or null(uuid)

(v1.0) The currencyId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencycodestring or null

(v1.0) The currencyCode property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
pricesIncludeTaxboolean or null

(v1.0) The pricesIncludeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAmountnumber or null(decimal)

(v1.0) The discountAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAppliedBeforeTaxboolean or null

(v1.0) The discountAppliedBeforeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountExcludingTaxnumber or null(decimal)

(v1.0) The totalAmountExcludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalTaxAmountnumber or null(decimal)

(v1.0) The totalTaxAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountIncludingTaxnumber or null(decimal)

(v1.0) The totalAmountIncludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
statusstring or null

(v1.0) The status property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
lastModifiedDateTimestring or null(date-time)

(v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
curl -i -X POST \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/purchaseInvoices' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "number": null,
    "invoiceDate": null,
    "dueDate": null,
    "vendorInvoicenumber": null,
    "vendorId": null,
    "vendornumber": null,
    "vendorName": null,
    "payToName": null,
    "payToContact": null,
    "payToVendorId": null,
    "payToVendornumber": null,
    "shipToName": null,
    "shipToContact": null,
    "currencyId": null,
    "currencycode": null,
    "pricesIncludeTax": null,
    "discountAmount": null,
    "discountAppliedBeforeTax": null,
    "totalAmountExcludingTax": null,
    "totalTaxAmount": null,
    "totalAmountIncludingTax": null,
    "status": null,
    "lastModifiedDateTime": null
  }'

Responses

(v1.0) A new purchaseInvoice has been succesfully created

Bodyapplication/json
idstring(uuid)

(v1.0) The id property for the Dynamics 365 Business Central purchaseInvoice entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
numberstring or null<= 20 characters

(v1.0) The number property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
invoiceDatestring or null(date-time)

(v1.0) The invoiceDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
dueDatestring or null(date-time)

(v1.0) The dueDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorInvoiceNumberstring or null<= 35 characters

(v1.0) The vendorInvoiceNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorIdstring or null(uuid)

(v1.0) The vendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorNumberstring or null<= 20 characters

(v1.0) The vendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorNamestring or null<= 100 characters

(v1.0) The vendorName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToNamestring or null<= 100 characters

(v1.0) The payToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToContactstring or null<= 100 characters

(v1.0) The payToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendorIdstring or null(uuid)

(v1.0) The payToVendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendorNumberstring or null<= 20 characters

(v1.0) The payToVendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToNamestring or null<= 100 characters

(v1.0) The shipToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToContactstring or null<= 100 characters

(v1.0) The shipToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencyIdstring or null(uuid)

(v1.0) The currencyId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencyCodestring or null

(v1.0) The currencyCode property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
pricesIncludeTaxboolean or null

(v1.0) The pricesIncludeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAmountnumber or null(decimal)

(v1.0) The discountAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAppliedBeforeTaxboolean or null

(v1.0) The discountAppliedBeforeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountExcludingTaxnumber or null(decimal)

(v1.0) The totalAmountExcludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalTaxAmountnumber or null(decimal)

(v1.0) The totalTaxAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountIncludingTaxnumber or null(decimal)

(v1.0) The totalAmountIncludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
statusstring or null

(v1.0) The status property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
lastModifiedDateTimestring or null(date-time)

(v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
purchaseInvoiceLinesArray of objects or null(purchaseInvoiceLine)
pdfDocumentArray of objects or null(pdfDocument)
vendorobject(vendor)
currencyobject(currency)
Response
application/json
{
  "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "number": null,
  "invoiceDate": null,
  "dueDate": null,
  "vendorInvoiceNumber": null,
  "vendorId": null,
  "vendorNumber": null,
  "vendorName": null,
  "payToName": null,
  "payToContact": null,
  "payToVendorId": null,
  "payToVendorNumber": null,
  "shipToName": null,
  "shipToContact": null,
  "currencyId": null,
  "currencyCode": null,
  "pricesIncludeTax": null,
  "discountAmount": null,
  "discountAppliedBeforeTax": null,
  "totalAmountExcludingTax": null,
  "totalTaxAmount": null,
  "totalAmountIncludingTax": null,
  "status": null,
  "lastModifiedDateTime": null,
  "purchaseInvoiceLines": [
    { … }
  ],
  "pdfDocument": [
    { … }
  ],
  "vendor": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "number": null,
    "displayName": null,
    "phoneNumber": null,
    "email": null,
    "website": null,
    "taxRegistrationNumber": null,
    "currencyId": null,
    "currencyCode": null,
    "irs1099Code": null,
    "paymentTermsId": null,
    "paymentMethodId": null,
    "taxLiable": null,
    "blocked": null,
    "balance": null,
    "lastModifiedDateTime": null,
    "picture": [ … ],
    "defaultDimensions": [ … ],
    "currency": { … },
    "paymentTerm": { … },
    "paymentMethod": { … }
  },
  "currency": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": "BKSD94GH",
    "displayName": null,
    "symbol": null,
    "amountDecimalPlaces": null,
    "amountRoundingPrecision": null,
    "lastModifiedDateTime": null
  }
}

Retrieve the properties and relationships of an object of type purchaseInvoice for Dynamics 365 Business Central.

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
purchaseInvoice_idstring(uuid)required

(v1.0) id for purchaseInvoice

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
Query
$expandArray of strings

(v1.0) Entities to expand

Items Enum"purchaseInvoiceLines""pdfDocument""vendor""currency"
$selectArray of strings

(v1.0) Selected properties to be retrieved

Items Enum"id""number""invoiceDate""dueDate""vendorInvoiceNumber""vendorId""vendorNumber""vendorName""payToName""payToContact"
curl -i -X GET \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/purchaseInvoices(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)?%24expand=purchaseInvoiceLines&%24select=id' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

(v1.0) Succesfully returned the requested purchaseInvoice

Bodyapplication/json
idstring(uuid)

(v1.0) The id property for the Dynamics 365 Business Central purchaseInvoice entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
numberstring or null<= 20 characters

(v1.0) The number property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
invoiceDatestring or null(date-time)

(v1.0) The invoiceDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
dueDatestring or null(date-time)

(v1.0) The dueDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorInvoiceNumberstring or null<= 35 characters

(v1.0) The vendorInvoiceNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorIdstring or null(uuid)

(v1.0) The vendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorNumberstring or null<= 20 characters

(v1.0) The vendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorNamestring or null<= 100 characters

(v1.0) The vendorName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToNamestring or null<= 100 characters

(v1.0) The payToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToContactstring or null<= 100 characters

(v1.0) The payToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendorIdstring or null(uuid)

(v1.0) The payToVendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendorNumberstring or null<= 20 characters

(v1.0) The payToVendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToNamestring or null<= 100 characters

(v1.0) The shipToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToContactstring or null<= 100 characters

(v1.0) The shipToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencyIdstring or null(uuid)

(v1.0) The currencyId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencyCodestring or null

(v1.0) The currencyCode property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
pricesIncludeTaxboolean or null

(v1.0) The pricesIncludeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAmountnumber or null(decimal)

(v1.0) The discountAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAppliedBeforeTaxboolean or null

(v1.0) The discountAppliedBeforeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountExcludingTaxnumber or null(decimal)

(v1.0) The totalAmountExcludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalTaxAmountnumber or null(decimal)

(v1.0) The totalTaxAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountIncludingTaxnumber or null(decimal)

(v1.0) The totalAmountIncludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
statusstring or null

(v1.0) The status property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
lastModifiedDateTimestring or null(date-time)

(v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
purchaseInvoiceLinesArray of objects or null(purchaseInvoiceLine)
pdfDocumentArray of objects or null(pdfDocument)
vendorobject(vendor)
currencyobject(currency)
Response
application/json
{
  "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "number": null,
  "invoiceDate": null,
  "dueDate": null,
  "vendorInvoiceNumber": null,
  "vendorId": null,
  "vendorNumber": null,
  "vendorName": null,
  "payToName": null,
  "payToContact": null,
  "payToVendorId": null,
  "payToVendorNumber": null,
  "shipToName": null,
  "shipToContact": null,
  "currencyId": null,
  "currencyCode": null,
  "pricesIncludeTax": null,
  "discountAmount": null,
  "discountAppliedBeforeTax": null,
  "totalAmountExcludingTax": null,
  "totalTaxAmount": null,
  "totalAmountIncludingTax": null,
  "status": null,
  "lastModifiedDateTime": null,
  "purchaseInvoiceLines": [
    { … }
  ],
  "pdfDocument": [
    { … }
  ],
  "vendor": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "number": null,
    "displayName": null,
    "phoneNumber": null,
    "email": null,
    "website": null,
    "taxRegistrationNumber": null,
    "currencyId": null,
    "currencyCode": null,
    "irs1099Code": null,
    "paymentTermsId": null,
    "paymentMethodId": null,
    "taxLiable": null,
    "blocked": null,
    "balance": null,
    "lastModifiedDateTime": null,
    "picture": [ … ],
    "defaultDimensions": [ … ],
    "currency": { … },
    "paymentTerm": { … },
    "paymentMethod": { … }
  },
  "currency": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": "BKSD94GH",
    "displayName": null,
    "symbol": null,
    "amountDecimalPlaces": null,
    "amountRoundingPrecision": null,
    "lastModifiedDateTime": null
  }
}

Deletes an object of type purchaseInvoice in Dynamics 365 Business Central

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
purchaseInvoice_idstring(uuid)required

(v1.0) id for purchaseInvoice

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
curl -i -X DELETE \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/purchaseInvoices(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

(v1.0) Succesfully deleted the specified purchaseInvoice

Updates an object of type purchaseInvoice in Dynamics 365 Business Central

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
purchaseInvoice_idstring(uuid)required

(v1.0) id for purchaseInvoice

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
Headers
Content-Typestringrequired

(v1.0) application/json

If-Matchstringrequired

(v1.0) Required. When this request header is included and the eTag provided does not match the current tag on the entity, this will not be updated.

Example: true
Bodyapplication/jsonrequired
idstring or null(uuid)

(v1.0) The id property for the Dynamics 365 Business Central purchaseInvoice entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
numberstring or null<= 20 characters

(v1.0) The number property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
invoiceDatestring or null(date-time)

(v1.0) The invoiceDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
dueDatestring or null(date-time)

(v1.0) The dueDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorInvoicenumberstring or null<= 35 characters

(v1.0) The vendorInvoiceNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorIdstring or null(uuid)

(v1.0) The vendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendornumberstring or null<= 20 characters

(v1.0) The vendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorNamestring or null<= 100 characters

(v1.0) The vendorName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToNamestring or null<= 100 characters

(v1.0) The payToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToContactstring or null<= 100 characters

(v1.0) The payToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendorIdstring or null(uuid)

(v1.0) The payToVendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendornumberstring or null<= 20 characters

(v1.0) The payToVendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToNamestring or null<= 100 characters

(v1.0) The shipToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToContactstring or null<= 100 characters

(v1.0) The shipToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencyIdstring or null(uuid)

(v1.0) The currencyId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencycodestring or null

(v1.0) The currencyCode property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
pricesIncludeTaxboolean or null

(v1.0) The pricesIncludeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAmountnumber or null(decimal)

(v1.0) The discountAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAppliedBeforeTaxboolean or null

(v1.0) The discountAppliedBeforeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountExcludingTaxnumber or null(decimal)

(v1.0) The totalAmountExcludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalTaxAmountnumber or null(decimal)

(v1.0) The totalTaxAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountIncludingTaxnumber or null(decimal)

(v1.0) The totalAmountIncludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
statusstring or null

(v1.0) The status property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
lastModifiedDateTimestring or null(date-time)

(v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
curl -i -X PATCH \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/purchaseInvoices(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'If-Match: true' \
  -d '{
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "number": null,
    "invoiceDate": null,
    "dueDate": null,
    "vendorInvoicenumber": null,
    "vendorId": null,
    "vendornumber": null,
    "vendorName": null,
    "payToName": null,
    "payToContact": null,
    "payToVendorId": null,
    "payToVendornumber": null,
    "shipToName": null,
    "shipToContact": null,
    "currencyId": null,
    "currencycode": null,
    "pricesIncludeTax": null,
    "discountAmount": null,
    "discountAppliedBeforeTax": null,
    "totalAmountExcludingTax": null,
    "totalTaxAmount": null,
    "totalAmountIncludingTax": null,
    "status": null,
    "lastModifiedDateTime": null
  }'

Responses

(v1.0) Succesfully updated the specifiedpurchaseInvoice

Bodyapplication/json
idstring(uuid)

(v1.0) The id property for the Dynamics 365 Business Central purchaseInvoice entity

Example: "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4"
numberstring or null<= 20 characters

(v1.0) The number property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
invoiceDatestring or null(date-time)

(v1.0) The invoiceDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
dueDatestring or null(date-time)

(v1.0) The dueDate property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorInvoiceNumberstring or null<= 35 characters

(v1.0) The vendorInvoiceNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorIdstring or null(uuid)

(v1.0) The vendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorNumberstring or null<= 20 characters

(v1.0) The vendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
vendorNamestring or null<= 100 characters

(v1.0) The vendorName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToNamestring or null<= 100 characters

(v1.0) The payToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToContactstring or null<= 100 characters

(v1.0) The payToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendorIdstring or null(uuid)

(v1.0) The payToVendorId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
payToVendorNumberstring or null<= 20 characters

(v1.0) The payToVendorNumber property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToNamestring or null<= 100 characters

(v1.0) The shipToName property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
shipToContactstring or null<= 100 characters

(v1.0) The shipToContact property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencyIdstring or null(uuid)

(v1.0) The currencyId property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
currencyCodestring or null

(v1.0) The currencyCode property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
pricesIncludeTaxboolean or null

(v1.0) The pricesIncludeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAmountnumber or null(decimal)

(v1.0) The discountAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
discountAppliedBeforeTaxboolean or null

(v1.0) The discountAppliedBeforeTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountExcludingTaxnumber or null(decimal)

(v1.0) The totalAmountExcludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalTaxAmountnumber or null(decimal)

(v1.0) The totalTaxAmount property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
totalAmountIncludingTaxnumber or null(decimal)

(v1.0) The totalAmountIncludingTax property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
statusstring or null

(v1.0) The status property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
lastModifiedDateTimestring or null(date-time)

(v1.0) The lastModifiedDateTime property for the Dynamics 365 Business Central purchaseInvoice entity

Example: null
purchaseInvoiceLinesArray of objects or null(purchaseInvoiceLine)
pdfDocumentArray of objects or null(pdfDocument)
vendorobject(vendor)
currencyobject(currency)
Response
application/json
{
  "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
  "number": null,
  "invoiceDate": null,
  "dueDate": null,
  "vendorInvoiceNumber": null,
  "vendorId": null,
  "vendorNumber": null,
  "vendorName": null,
  "payToName": null,
  "payToContact": null,
  "payToVendorId": null,
  "payToVendorNumber": null,
  "shipToName": null,
  "shipToContact": null,
  "currencyId": null,
  "currencyCode": null,
  "pricesIncludeTax": null,
  "discountAmount": null,
  "discountAppliedBeforeTax": null,
  "totalAmountExcludingTax": null,
  "totalTaxAmount": null,
  "totalAmountIncludingTax": null,
  "status": null,
  "lastModifiedDateTime": null,
  "purchaseInvoiceLines": [
    { … }
  ],
  "pdfDocument": [
    { … }
  ],
  "vendor": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "number": null,
    "displayName": null,
    "phoneNumber": null,
    "email": null,
    "website": null,
    "taxRegistrationNumber": null,
    "currencyId": null,
    "currencyCode": null,
    "irs1099Code": null,
    "paymentTermsId": null,
    "paymentMethodId": null,
    "taxLiable": null,
    "blocked": null,
    "balance": null,
    "lastModifiedDateTime": null,
    "picture": [ … ],
    "defaultDimensions": [ … ],
    "currency": { … },
    "paymentTerm": { … },
    "paymentMethod": { … }
  },
  "currency": {
    "id": "2a2dfc50-f21b-4ab0-8f89-463efd0dfce4",
    "code": "BKSD94GH",
    "displayName": null,
    "symbol": null,
    "amountDecimalPlaces": null,
    "amountRoundingPrecision": null,
    "lastModifiedDateTime": null
  }
}

Performs the post action for purchaseInvoices entity

Request

Path
company_idstring(uuid)required

(v1.0) id for company

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
purchaseInvoice_idstring(uuid)required

(v1.0) id for purchaseInvoice

Example: e942a270-62d2-4aef-aa48-6fe3ef9e53e1
curl -i -X POST \
  'https://docs.beehexa.com/_mock/api/microsoft-dynamics-365-business-central-api/default-built-by-microsoft/companies(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/purchaseInvoices(e942a270-62d2-4aef-aa48-6fe3ef9e53e1)/Microsoft.NAV.post' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

(v1.0) Succesfully performed a post action on the Dynamic 365 Business Central purchaseInvoices entity

Business Central Purchase Invoice Line API

(v1.0) Represents an object of type purchaseInvoiceLine in Dynamics 365 Business Central

Business Central Project API

(v1.0) Represents an object of type project in Dynamics 365 Business Central

Operations

Business Central Bank Account API

(v1.0) Represents an object of type bankAccount in Dynamics 365 Business Central

Operations

Business Central Customer Sale API

(v1.0) Represents an object of type customerSale in Dynamics 365 Business Central

Operations

Business Central Vendor Purchase API

(v1.0) Represents an object of type vendorPurchase in Dynamics 365 Business Central

Operations