Create purchaseInvoices
Create a purchase invoice report object in Business Central.
HTTP request
Replace the URL prefix for Business Central depending on environment following the guideline.
POST businesscentralPrefix/companies({id})/purchaseInvoices
Request headers
Header | Value |
---|---|
Authorization | Bearer {token}. Required. |
Content-Type | application/json |
If-Match | Required. When this request header is included and the eTag provided does not match the current tag on the purchaseInvoice, the purchaseInvoice will not be updated. |
Request body
In the request body, supply a JSON representation of a purchaseInvoices object.
Response
If successful, this method returns 201 Created
response code and a purchaseInvoices object in the response body.
Example
Request
Here is an example of a request.
POST https://{businesscentralPrefix}/api/v2.0/companies({id})/purchaseInvoices
Content-type: application/json
{
"invoiceDate": "2019-01-01",
"postingDate": "2019-01-01",
"dueDate": "2019-01-01",
"vendorInvoiceNumber": "107001",
"vendorId": "f8a5738a-44e3-ea11-bb43-000d3a2feca1",
"vendorNumber": "20000",
"payToVendorId": "f8a5738a-44e3-ea11-bb43-000d3a2feca1",
"payToVendorNumber": "20000",
"shipToName": "",
"shipToContact": "",
"buyFromAddressLine1": "100 Day Drive",
"buyFromAddressLine2": "",
"buyFromCity": "Chicago",
"buyFromCountry": "US",
"buyFromState": "IL",
"buyFromPostCode": "61236",
"shipToAddressLine1": "7122 South Ashford Street",
"shipToAddressLine2": "Westminster",
"shipToCity": "Atlanta",
"shipToCountry": "US",
"shipToState": "",
"shipToPostCode": "31772",
"currencyId": "00000000-0000-0000-0000-000000000000",
"currencyCode": "USD",
"pricesIncludeTax": false,
"discountAmount": 0,
"discountAppliedBeforeTax": true,
"totalAmountIncludingTax": 3310.17
}
Response
Here is an example of the response.
HTTP/1.1 201 Created
Content-type: application/json
{
"id": "5d115c9c-44e3-ea11-bb43-000d3a2feca1",
"number": "108001",
"invoiceDate": "2019-01-01",
"postingDate": "2019-01-01",
"dueDate": "2019-01-01",
"vendorInvoiceNumber": "107001",
"vendorId": "f8a5738a-44e3-ea11-bb43-000d3a2feca1",
"vendorNumber": "20000",
"vendorName": "First Up Consultants",
"payToName": "First Up Consultants",
"payToContact": "Evan McIntosh",
"payToVendorId": "f8a5738a-44e3-ea11-bb43-000d3a2feca1",
"payToVendorNumber": "20000",
"shipToName": "CRONUS International Ltd.",
"shipToContact": "",
"buyFromAddressLine1": "100 Day Drive",
"buyFromAddressLine2": "",
"buyFromCity": "Chicago",
"buyFromCountry": "US",
"buyFromState": "IL",
"buyFromPostCode": "61236",
"shipToAddressLine1": "7122 South Ashford Street",
"shipToAddressLine2": "Westminster",
"shipToCity": "Atlanta",
"shipToCountry": "US",
"shipToState": "",
"shipToPostCode": "31772",
"payToAddressLine1": "100 Day Drive",
"payToAddressLine2": "",
"payToCity": "Chicago",
"payToCountry": "US",
"payToState": "IL",
"payToPostCode": "61236",
"shortcutDimension1Code": "",
"shortcutDimension2Code": "",
"currencyId": "00000000-0000-0000-0000-000000000000",
"currencyCode": "USD",
"orderId": "00000000-0000-0000-0000-000000000000",
"orderNumber": "",
"pricesIncludeTax": false,
"discountAmount": 0,
"discountAppliedBeforeTax": false,
"totalAmountExcludingTax": 0,
"totalTaxAmount": 0,
"totalAmountIncludingTax": 0,
"status": "Draft",
"lastModifiedDateTime": "2020-08-21T00:26:53.793Z"
}
Related information
Tips for working with the APIs
Purchase Invoice
Get Purchase Invoice
Update Purchase Invoice
Delete Purchase Invoice