🔒 Create sales order from offer V3

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: salesOrder:create.

Create a sales order from an offer, as the offer action "Continue as sales order" does. The sales order takes over the header of the offer with its addresses and tax rates, the line items with their texts and individual discounts, and the intermediate lines, and references the offer. As in the UI, the discounts of the header and of line items without an individual discount are reloaded from the customer. Optional line items are taken over only when listed in acceptedOptionalLineItems; for an offer with optional line items that list is required, and an empty list takes over none of them. The offer is set to commissioned and write-protected, and its follow-ups are closed. The sales order is released right away when the system setting "Create receipts quickly without manual approval" is on, and is created as a draft otherwise. Either way, the sales order is returned calculated as Xentral calculates an order when it is opened: just-in-time bills of materials are resolved where the project explodes them automatically, a released order reserves its stock where the project reserves stock automatically, and the traffic lights are set. Draft and cancelled offers, and offers without a customer, cannot be continued.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
offer
object
required

The offer to create the sales order from.

acceptedOptionalLineItems
array of objects

The optional line items of the offer that the customer accepted. They are taken over as regular line items of the sales order, the optional line items that are not listed are left out. Required when the offer has optional line items; an empty list takes over none of them. An optional part of a bill of materials can be accepted only together with its bill of materials. When the bill of materials is priced from its parts, an accepted optional part is added to its price.

acceptedOptionalLineItems
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

401

Unauthorized

403

Forbidden

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json