# salesInvoices resource type (v1.0)
> NEW VERSION This is v1.0 of the Business Central API. For the newest version, see Business Central API (V2.0)<../../v2.0>.
Represents a sales invoice in Business Central.
> NOTE
> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../enabling-apis-for-dynamics-nav>.
## Methods
Method|Return Type|Description
../api/dynamics_salesinvoice_get|salesInvoices|Gets a sales invoice object.
POST salesInvoices<../api/dynamics_create_salesinvoice>|salesInvoices|Creates a sales invoice object.
PATCH salesInvoices<../api/dynamics_salesinvoice_update>|salesInvoices|Updates a sales invoice object.
../api/dynamics_salesinvoice_delete|none|Deletes a sales invoice object.
## Navigation
Navigation|Return type|Description
../api/dynamics_salesquote_pdfdocument|pdfDocument|Gets a PDF document.
currency<dynamics_currencies>|currency|Gets the currency.
dynamics_paymentterms|paymentTerm|Gets the paymentTerm.
dynamics_shipmentmethods|shipmentMethod|Gets the method of shipment.
dynamics_customer|customer|Gets the customer.
dynamics_salesinvoiceline|salesInvoiceLines|Gets a line on a sales invoice.
## Properties
Property|Type|Description
id|GUID|The invoice ID. Non-editable.
number|string, maximum size 20|The invoice number. Read-Only.
externalDocumentNumber|string|The external document number
invoiceDate|date|The invoice date.
customerPurchaseOrderReference|string, maximum size 35|The customer purchase order reference for the invoice
dueDate|date|The date the invoice is due.
customerNumber|string, maximum size 20|The customer number for the invoice.
contactId|string, maximum size 250|The exchange contact id for the given customer. If a customer id is not specified, we will use the contact id to find it.
customerId|GUID|The id of the invoice customer.
customerName|string, maximum size 50|The full name of the customer. Read-Only.
currencyId|GUID|The id of the invoice currency.
currencyCode|string, maximum size 10|The currency code for the invoice.
email|string, maximum size 80|Email for the customer, cash sales
phone|string, maximum size 30|Phone number for the customer, cash sales
orderId|GUID|The unique id of the order to which the invoice is associated to. Read-Only.
orderNumber|string, maximum size 20|The number of the order to which the invoice is associated to. Read-Only.
status|string, maximum size 20|The invoice status. Status can be: Draft, In Review, Open, Paid, Canceled, or Corrective. Read-Only.
discountAmount|numeric|The invoice discount amount.
discountAppliedBeforeTax|boolean|Specifies whether the discount is applied before tax.
totalAmountExcludingTax|numeric|The total amount excluding tax. Read-Only.
totalTaxAmount|numeric|The total tax amount for the invoice. Read-Only.
totalAmountIncludingTax|numeric|The total amount for the invoice, including tax. Read-Only.
pricesIncludeTax|boolean|Specifies whether the prices include Tax or not. Read-Only.
billingPostalAddress|complex|The billing postal address for the invoice.
paymentTermsId|GUID|The id of the invoice payment term.
paymentTerms|string, maximum size 10|The payment terms of the invoice.
shipmentMethodId|GUID|The id of the invoice shipment method.
shipmentMethod|string, maximum size 10|The shipment method of the invoice.
salesperson|string, maximum size 20|The salesperson code for the invoice.
lastModifiedDateTime|datetime|The last datetime the sales invoice was modified. Read-Only.
billToName|string, maximum length 100|The name of the customer to bill.
billToCustomerId|GUID|Id of the customer to bill
billToCustomerNumber|string, maximum length 20|Number of the customer to bill.
shipToName|string, maximum size 100|Name of the customer in ship to address.
shipToContact|string, maximum size 100|Ship to contact
sellingPostalAddress|Microsoft.NAV.postalAddressType|Selling postal address
billingPostalAddress|Microsoft.NAV.postalAddressType|Billing postal address
shippingPostalAddress|Microsoft.NAV.postalAddressType|Shipping postal address
## Relationships
A Currency (currencyCode) must exist in the Currencies table.
A Payment Term (paymentTerms) must exist in the Payment Terms table.
A Shipment Method (shipmentMethod) must exist in the Shipment Method table.
A Customer (customerId) must exist in the Customer table.
An Order (orderId) must exist in the Sales Orders table.
## JSON representation
Here is a JSON representation of the resource.
```json
{
      "id": "GUID",
      "number": "string",
      "invoiceDate": "Date",
      "dueDate": "Date",
      "customerPurchaseOrderReference": "string",
      "customerId": "GUID",
      "contactId": "string",
      "customerNumber": "string",
      "customerName": "string",
      "billingPostalAddress": {NAV.PostalAddress},
      "currencyId": "GUID",
      "currencyCode": "string",
      "orderId": "GUID",
      "orderNumber": "string",
      "paymentTermsId": "GUID",
      "shipmentMethodId": "GUID",
      "shipmentMethod": "string",
      "salesperson": "string",
      "pricesIncludeTax": "boolean",
      "discountAmount": "decimal",
      "discountAppliedBeforeTax": "boolean",
      "totalAmountExcludingTax": "decimal",
      "totalTaxAmount": "decimal",
      "totalAmountIncludingTax": "decimal",
      "status": "string",
      "lastModifiedDateTime": "DateTime"
}
```
## Related information
Get Sales Invoice<../api/dynamics_salesinvoice_get>
Create Sales Invoice<../api/dynamics_create_salesinvoice>
Update Sales Invoice<../api/dynamics_salesinvoice_update>
Delete Sales Invoice<../api/dynamics_salesinvoice_delete>

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_salesinvoice, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/api-reference/v1.0/resources/dynamics_salesinvoice/
