---
title: "API salesInvoice"
slug: "api-salesinvoice"
description: "Comprehensive Softera Sales Invoice API reference detailing customer data, amounts, taxes, dimensions, attachments, and sales invoice lines."
tags: ["Business Central API", "Integration", "API", "Softera sprendimai", "Integracija", "Business Central"]
updated: 2026-09-09T16:01:53Z
published: 2026-09-09T16:01:53Z
canonical: "instrukcijos.softera.lt/api-salesinvoice"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://instrukcijos.softera.lt/llms.txt
> Use this file to discover all available pages before exploring further.

# salesInvoice

| **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](https://instrukcijos.softera.lt/docs/en/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 |  |
| email | 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) |  |