Update a sales order
Update details of a specific sales order identified by its uinque sales order ID, and receive the updated details in return. An existing sales order can be invoiced by updating its status to "Invoice". Before a sales order can be invoiced, it needs to include at least one sales order line.
Path parameters
-
id
integer(int32) Required A unique identifier for the sales order within 24SevenOffice ERP.
Body
-
id
number A unique identifier for the sales order within 24SevenOffice ERP.
-
customer
object Customer details for the sales order. Note that the
customerobject for the/salesOrdersendpoint is not the same as the customer that can be retrieved from the/customersendpoint, even though both share the same ID reference and their schemas are similar. Thecustomerobject in the context of/salesOrderscontains the customer details as they were at the time the sales order was created. In contrast, the/customersendpoint always provides the latest state values for the customer properties. -
status
string Current status of the sales order.
Values are
Draft,Proposal,Confirmed,Invoice, orAdvanceInvoice. -
deliveryCustomer
object Delivery details for the sales order.
-
invoice
object Details of an invoice associated with a sales order.
-
date
string(date) The date when the sales order was issued.
-
internalMemo
string An internal memo for the sales order.
Maximum length is
300. -
memo
string A memo or comments for the sales order.
-
salesType
object The sales type for the sales order.
-
createdAt
string(date-time) A timestamp for when a record was created, in ISO 8601 format.
-
modifiedAt
string(date-time) A timestamp for when one of the properties of a record was last modified, in ISO 8601 format.
curl \
--request PATCH 'https://rest.api.24sevenoffice.com/v1/salesorders/{id}' \
--header "Content-Type: application/json" \
--header "Authorization: string" \
--data '{"id":1234,"customer":{"id":12345,"organizationNumber":"123456789","invoiceEmailAddresses":["hello@example.com"],"gln":"1234567890123","name":"ABC Corporation","street":"Hovedgata 1","postalCode":"0123","postalArea":"Fornebu","city":"Fornebu","countrySubdivision":"Viken","countryCode":"NO"},"status":"Invoice","deliveryCustomer":{"id":12345,"name":"ABC Corporation","street":"Hovedgata 1","postalCode":"0123","postalArea":"Fornebu","city":"Fornebu","countrySubdivision":"Viken","countryCode":"NO"},"invoice":{"number":123,"date":"2023-06-01","dueDate":"2023-06-15","remittanceReference":"ABC12345","transaction":{"id":"63293496-884f-4358-b489-f641fe51cdaa"}},"date":"2023-06-01","internalMemo":"Customer requested special packaging.","memo":"Urgent delivery.","salesType":{"id":-100},"createdAt":"2023-06-01T12:00:00Z","modifiedAt":"2023-06-02T15:30:00Z"}'# Headers
Authorization: string
# Payload
{
"id": 1234,
"customer": {
"id": 12345,
"organizationNumber": "123456789",
"invoiceEmailAddresses": [
"hello@example.com"
],
"gln": "1234567890123",
"name": "ABC Corporation",
"street": "Hovedgata 1",
"postalCode": "0123",
"postalArea": "Fornebu",
"city": "Fornebu",
"countrySubdivision": "Viken",
"countryCode": "NO"
},
"status": "Invoice",
"deliveryCustomer": {
"id": 12345,
"name": "ABC Corporation",
"street": "Hovedgata 1",
"postalCode": "0123",
"postalArea": "Fornebu",
"city": "Fornebu",
"countrySubdivision": "Viken",
"countryCode": "NO"
},
"invoice": {
"number": 123,
"date": "2023-06-01",
"dueDate": "2023-06-15",
"remittanceReference": "ABC12345",
"transaction": {
"id": "63293496-884f-4358-b489-f641fe51cdaa"
}
},
"date": "2023-06-01",
"internalMemo": "Customer requested special packaging.",
"memo": "Urgent delivery.",
"salesType": {
"id": -100
},
"createdAt": "2023-06-01T12:00:00Z",
"modifiedAt": "2023-06-02T15:30:00Z"
}# Headers
Access-Control-Allow-Origin: string
Access-Control-Allow-Credentials: string
X-Trace-Id: string
# Payload
{
"id": 1234,
"customer": {
"id": 12345,
"organizationNumber": "123456789",
"invoiceEmailAddresses": [
"hello@example.com"
],
"gln": "1234567890123",
"name": "ABC Corporation",
"street": "Hovedgata 1",
"postalCode": "0123",
"postalArea": "Fornebu",
"city": "Fornebu",
"countrySubdivision": "Viken",
"countryCode": "NO"
},
"status": "Invoice",
"deliveryCustomer": {
"id": 12345,
"name": "ABC Corporation",
"street": "Hovedgata 1",
"postalCode": "0123",
"postalArea": "Fornebu",
"city": "Fornebu",
"countrySubdivision": "Viken",
"countryCode": "NO"
},
"invoice": {
"number": 123,
"date": "2023-06-01",
"dueDate": "2023-06-15",
"remittanceReference": "ABC12345",
"transaction": {
"id": "63293496-884f-4358-b489-f641fe51cdaa"
}
},
"date": "2023-06-01",
"internalMemo": "Customer requested special packaging.",
"memo": "Urgent delivery.",
"salesType": {
"id": -100
},
"createdAt": "2023-06-01T12:00:00Z",
"modifiedAt": "2023-06-02T15:30:00Z"
}# Headers
Access-Control-Allow-Origin: string
Access-Control-Allow-Credentials: string
X-Trace-Id: string
# Payload
{
"id": 1234,
"customer": {
"id": 12345,
"organizationNumber": "123456789",
"invoiceEmailAddresses": [
"hello@example.com"
],
"gln": "1234567890123",
"name": "ABC Corporation",
"street": "Hovedgata 1",
"postalCode": "0123",
"postalArea": "Fornebu",
"city": "Fornebu",
"countrySubdivision": "Viken",
"countryCode": "NO"
},
"status": "Invoice",
"deliveryCustomer": {
"id": 12345,
"name": "ABC Corporation",
"street": "Hovedgata 1",
"postalCode": "0123",
"postalArea": "Fornebu",
"city": "Fornebu",
"countrySubdivision": "Viken",
"countryCode": "NO"
},
"invoice": {
"number": 123,
"date": "2023-06-01",
"dueDate": "2023-06-15",
"remittanceReference": "ABC12345",
"transaction": {
"id": "63293496-884f-4358-b489-f641fe51cdaa"
}
},
"date": "2023-06-01",
"internalMemo": "Customer requested special packaging.",
"memo": "Urgent delivery.",
"salesType": {
"id": -100
},
"createdAt": "2023-06-01T12:00:00Z",
"modifiedAt": "2023-06-02T15:30:00Z"
}# Headers
Access-Control-Allow-Origin: string
Access-Control-Allow-Credentials: string
X-Trace-Id: string
# Payload
{
"error": {
"name": "BadRequestError",
"payload": {
"errors": [
{
"type": "NoLines",
"message": "No lines in the sales order",
"arguments": [
"lineItems"
]
}
]
}
},
"trackingId": "ghi789"
}# Headers
Access-Control-Allow-Origin: string
Access-Control-Allow-Credentials: string
X-Trace-Id: string
# Payload
{
"error": {
"name": "ValidationError",
"payload": {
"validationErrors": [
{
"path": "customer.name",
"keyword": "required"
}
]
}
},
"trackingId": "def456"
}