| API | Path |
|---|---|
| salesInvoices | businesscentralPrefix/softera/softeraEInvoice/v2.0/companies({{companyId}})/salesInvoices |
Methods
| Method | Return Type | Description |
|---|---|---|
| GET salesInvoice | salesInvoice | Gets a sales invoice object. |
| POST salesInvoice | salesInvoice | Creates a sales invoice object. |
| PATCH salesInvoice | salesInvoice | Updates a sales invoice object. |
| DELETE salesInvoice | none | Deletes a sales invoice object. |
Bound Actions
| Action | Description | Action Call | Response | Response Code |
|---|---|---|---|---|
| cancel | Cancels the corresponding sales invoice | salesInvoices({id})/Microsoft.NAV.cancel | No response | 204 |
| cancelAndSend | Cancels and sends the corresponding sales invoice | salesInvoices({id})/Microsoft.NAV.cancelAndSend | No response | 204 |
| makeCorrectiveCreditMemo | Creates the corresponding sales credit memo | salesInvoices({id})/Microsoft.NAV.makeCorrectiveCreditMemo | No response | 204 |
| post | Posts the corresponding sales invoice | salesInvoices({id})/Microsoft.NAV.post | No response | 204 |
| postAndSend | Posts and sends the corresponding sales invoice | salesInvoices({id})/Microsoft.NAV.postAndSend | No response | 204 |
| send | Sends the corresponding sales invoice | salesInvoices({id})/Microsoft.NAV.send | No response | 204 |
Important
Always populate apiTotalAmountExclVAT and apiTotalAmountInclVAT with the totals calculated in your external system. Business Central compares these against its own calculated amounts, and any mismatch will block posting with a VAT error. See API Setup for how the VAT mismatch check works and how to allow auto-correction or bypass it if needed.
Fields
| Name | Type | MaxLength | Description |
|---|---|---|---|
| id | Guid | Read-only | |
| number | String | 20 | Read-only |
| externalDocumentNumber | String | 35 | |
| invoiceDate | Date | ||
| postingDate | Date | ||
| dueDate | Date | ||
| customerPurchaseOrderReference | String | 35 | |
| postingDescription | String | ||
| customerId | Guid | ||
| customerNumber | String | 20 | |
| customerName | String | 100 | Read-only |
| billToName | String | 100 | Read-only |
| billToCustomerId | Guid | ||
| billToCustomerNumber | String | 20 | |
| shipToName | String | 100 | |
| shipToContact | String | 100 | |
| sellToAddressLine1 | String | 100 | |
| sellToAddressLine2 | String | 50 | |
| sellToCity | String | 30 | |
| sellToCountry | String | 10 | |
| sellToState | String | 30 | |
| sellToPostCode | String | 20 | |
| billToAddressLine1 | String | 100 | Read-only |
| billToAddressLine2 | String | 50 | Read-only |
| billToCity | String | 30 | Read-only |
| billToCountry | String | 10 | Read-only |
| billToState | String | 30 | Read-only |
| billToPostCode | String | 20 | Read-only |
| shipToAddressLine1 | String | 100 | |
| shipToAddressLine2 | String | 50 | |
| shipToCity | String | 30 | |
| shipToCountry | String | 10 | |
| shipToState | String | 30 | |
| shipToPostCode | String | 20 | |
| currencyId | Guid | ||
| shortcutDimension1Code | String | ||
| shortcutDimension2Code | String | ||
| currencyCode | String | ||
| orderId | Guid | Read-only | |
| orderNumber | String | 20 | Read-only |
| paymentTermsId | Guid | ||
| paymentMethodCode | String | ||
| shipmentMethodId | Guid | ||
| salesperson | String | 20 | |
| pricesIncludeTax | Boolean | Read-only | |
| remainingAmount | Decimal | Read-only | |
| discountAmount | Decimal | ||
| discountAppliedBeforeTax | Boolean | Read-only | |
| totalAmountExcludingTax | Decimal | Read-only | |
| totalTaxAmount | Decimal | Read-only | |
| totalAmountIncludingTax | Decimal | Read-only | |
| status | String | Read-only | |
| posted | Boolean | Read-only | |
| lastModifiedDateTime | DateTimeOffset | Read-only | |
| phoneNumber | String | 30 | |
| String | 80 | ||
| locationCode | String | ||
| userId | String | ||
| documentLink | String | ||
| documentNote | String | ||
| closed | Boolean | ||
| apiTotalAmountExclVAT | Decimal | ||
| apiTotalAmountInclVAT | Decimal |
Related API's (expand)
| Name | Type | Description |
|---|---|---|
| customer | Microsoft.NAV.customer | |
| dimensionSetLines | Collection(Microsoft.NAV.dimensionSetLine) | |
| salesInvoiceLines | Collection(Microsoft.NAV.salesInvoiceLine) | |
| pdfDocument | Microsoft.NAV.pdfDocument | |
| attachments | Collection(Microsoft.NAV.attachment) | |
| documentAttachments | Collection(Microsoft.NAV.documentAttachment) |