# salesOrders 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 order 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_salesorder_get|salesOrders|Get a sales order object.
POST salesOrders<../api/dynamics_create_salesorder>|salesOrders|Create a sales order object.
PATCH salesOrders<../api/dynamics_salesorder_update>|salesOrders|Update a sales order object.
../api/dynamics_salesorder_delete|none|Delete a sales order object.
## Properties
Property|Type|Description
id|GUID|The order ID. Non-editable.
number|string, maximum size 20|The order number. Read-Only.
orderDate|date|The order date
customerId|GUID|The id of the order customer.
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.
customerNumber|string, maximum size 20|The customer number for the order.
customerName|string, maximum size 50|The full name of the customer. Read-Only.
billingPostalAddress|complex|The billing postal address for the order.
currencyId|GUID|The id of the order currency.
currencyCode|string, maximum size 10|The currency code for the order.
pricesIncludeTax|boolean|Specifies whether the prices include Tax or not. Read-Only.
paymentTermsId|GUID|The id of the order payment term.
paymentTerms|string, maximum size 10|The payment terms of the order.
salesperson|string, maximum size 20|The salesperson code for the order.
partialShipping|boolean|Specifies whether partial shipping of items is preferred or not.
requestedDeliveryDate|Date|The requested delivery date.
discountAmount|numeric|The order discount amount
discountAppliedBeforeTax|boolean|Specifies whether the discount is applied before tax. Read-Only.
totalAmountExcludingTax|numeric|The total amount excluding tax. Read-Only.
totalTaxAmount|numeric|The total tax amount for the order. Read-Only.
totalAmountIncludingTax|numeric|The total amount for the order, including tax. Read-Only.
fullyShipped|boolean|Specifies whether the items of the order were fully shipped or not.
status|string, maximum size 20|The order status. Status can be: Draft, Cancelled, Paid, On hold, Created. 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
lastModifiedDateTime|datetime|The last datetime the sales order was modified. Read-Only.
## 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.
## JSON representation
Here is a JSON representation of the resource.
```json
{
      "id": "GUID",
      "number": "string",
      "orderDate": "Date",
      "customerId": "GUID",
      "contactId": "string",
      "customerNumber": "string",
      "customerName": "string",
      "billingPostalAddress": {NAV.PostalAddress},
      "currencyId": "GUID",
      "currencyCode": "string",
      "pricesIncludeTax": "boolean",
      "paymentTermsId": "GUID",
      "salesperson": "string",
      "partialShipping": "boolean",
      "requestedDeliveryDate": "Date",
      "discountAmount": "decimal",
      "discountAppliedBeforeTax": "boolean",
      "totalAmountExcludingTax": "decimal",
      "totalTaxAmount": "decimal",
      "totalAmountIncludingTax": "decimal",
      "fullyShipped": "boolean",
      "status": "string",
      "lastModifiedDateTime": "DateTime"
}
```
## Related information
Get Sales Order<../api/dynamics_salesorder_get>
Create Sales Order<../api/dynamics_create_salesorder>
Update Sales Order<../api/dynamics_salesorder_update>
Delete Sales Order<../api/dynamics_salesorder_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_salesorder, 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_salesorder/
