{"title":"salesOrders resource type (v1.0)","url":"https://jonas-paprotka.de/docs/dev-itpro/api-reference/v1.0/resources/dynamics_salesorder/","by":"JOP-AL","license":"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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/api-reference/v1.0/resources/dynamics_salesorder","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"(v1.0) A sales order object in Dynamics 365 Business Central.","date":"2024-05-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"salesOrders resource type (v1.0)","slug":"salesorders-resource-type-v10","at":0,"chars":4485},{"level":2,"title":"Methods","slug":"methods","at":364,"chars":366},{"level":2,"title":"Properties","slug":"properties","at":730,"chars":2373},{"level":2,"title":"Relationships","slug":"relationships","at":3103,"chars":279},{"level":2,"title":"JSON representation","slug":"json-representation","at":3382,"chars":871},{"level":2,"title":"Related information","slug":"related-information","at":4253,"chars":232}],"text":"# salesOrders resource type (v1.0)\n> NEW VERSION This is v1.0 of the Business Central API. For the newest version, see Business Central API (V2.0)<../../v2.0>.\nRepresents a sales order in Business Central.\n> NOTE\n> For information about enabling APIs for Business Central see Enabling the APIs for Dynamics 365 Business Central<../enabling-apis-for-dynamics-nav>.\n## Methods\nMethod|Return Type|Description\n../api/dynamics_salesorder_get|salesOrders|Get a sales order object.\nPOST salesOrders<../api/dynamics_create_salesorder>|salesOrders|Create a sales order object.\nPATCH salesOrders<../api/dynamics_salesorder_update>|salesOrders|Update a sales order object.\n../api/dynamics_salesorder_delete|none|Delete a sales order object.\n## Properties\nProperty|Type|Description\nid|GUID|The order ID. Non-editable.\nnumber|string, maximum size 20|The order number. Read-Only.\norderDate|date|The order date\ncustomerId|GUID|The id of the order customer.\ncontactId|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.\ncustomerNumber|string, maximum size 20|The customer number for the order.\ncustomerName|string, maximum size 50|The full name of the customer. Read-Only.\nbillingPostalAddress|complex|The billing postal address for the order.\ncurrencyId|GUID|The id of the order currency.\ncurrencyCode|string, maximum size 10|The currency code for the order.\npricesIncludeTax|boolean|Specifies whether the prices include Tax or not. Read-Only.\npaymentTermsId|GUID|The id of the order payment term.\npaymentTerms|string, maximum size 10|The payment terms of the order.\nsalesperson|string, maximum size 20|The salesperson code for the order.\npartialShipping|boolean|Specifies whether partial shipping of items is preferred or not.\nrequestedDeliveryDate|Date|The requested delivery date.\ndiscountAmount|numeric|The order discount amount\ndiscountAppliedBeforeTax|boolean|Specifies whether the discount is applied before tax. Read-Only.\ntotalAmountExcludingTax|numeric|The total amount excluding tax. Read-Only.\ntotalTaxAmount|numeric|The total tax amount for the order. Read-Only.\ntotalAmountIncludingTax|numeric|The total amount for the order, including tax. Read-Only.\nfullyShipped|boolean|Specifies whether the items of the order were fully shipped or not.\nstatus|string, maximum size 20|The order status. Status can be: Draft, Cancelled, Paid, On hold, Created. Read-Only.\nbillToName|string, maximum length 100|The name of the customer to bill.\nbillToCustomerId|GUID|Id of the customer to bill\nbillToCustomerNumber|string, maximum length 20|Number of the customer to bill.\nshipToName|string, maximum size 100|Name of the customer in ship to address.\nshipToContact|string, maximum size 100|Ship to contact\nsellingPostalAddress|Microsoft.NAV.postalAddressType|Selling postal address\nbillingPostalAddress|Microsoft.NAV.postalAddressType|Billing postal address\nshippingPostalAddress|Microsoft.NAV.postalAddressType|Shipping postal address\nlastModifiedDateTime|datetime|The last datetime the sales order was modified. Read-Only.\n## Relationships\nA Currency(currencyCode) must exist in the Currencies table.\nA Payment Term(paymentTerms) must exist in the Payment Terms table.\nA Shipment Method(shipmentMethod) must exist in the Shipment Method table.\nA Customer (customerId) must exist in the Customer table.\n## JSON representation\nHere is a JSON representation of the resource.\n```json\n{\n      \"id\": \"GUID\",\n      \"number\": \"string\",\n      \"orderDate\": \"Date\",\n      \"customerId\": \"GUID\",\n      \"contactId\": \"string\",\n      \"customerNumber\": \"string\",\n      \"customerName\": \"string\",\n      \"billingPostalAddress\": {NAV.PostalAddress},\n      \"currencyId\": \"GUID\",\n      \"currencyCode\": \"string\",\n      \"pricesIncludeTax\": \"boolean\",\n      \"paymentTermsId\": \"GUID\",\n      \"salesperson\": \"string\",\n      \"partialShipping\": \"boolean\",\n      \"requestedDeliveryDate\": \"Date\",\n      \"discountAmount\": \"decimal\",\n      \"discountAppliedBeforeTax\": \"boolean\",\n      \"totalAmountExcludingTax\": \"decimal\",\n      \"totalTaxAmount\": \"decimal\",\n      \"totalAmountIncludingTax\": \"decimal\",\n      \"fullyShipped\": \"boolean\",\n      \"status\": \"string\",\n      \"lastModifiedDateTime\": \"DateTime\"\n}\n```\n## Related information\nGet Sales Order<../api/dynamics_salesorder_get>\nCreate Sales Order<../api/dynamics_create_salesorder>\nUpdate Sales Order<../api/dynamics_salesorder_update>\nDelete Sales Order<../api/dynamics_salesorder_delete>"}