Update order logistics to CREATED

put

https://example.com/v2/shop/commercial-orders/{commercialOrderId}/created

Validates a commercial order to trigger downstream logistic processing.

This is the final step of the checkout process. It transitions the order from a draft phase to a confirmed state.

Once validated:
- All linked logistic orders are marked as CREATED.
- The commercial order is flagged with isValidated = true.
- If no payment method is attached, the order's payment status is set to NOT_INITIATED.

✅ Eligibility conditions:
- All logistic orders must be in status DRAFT_ORDER or DRAFT_ORDER_ON_HOLD.
- Each logistic order must have:
- A shipping address
- A billing address
- A delivery method defined

✅ Stock checks:
- Without Real-Time Pricing (RTP): Quantities are validated against stock availability, minimum/maximum purchase limits, and packaging multiples.
- With Real-Time Pricing (RTP): Stock availability is validated live using the Real-Time Data API.

✅ Payment rules:
- If the order is not derived from a quote, payment options must be validated based on the customer's account type.
- Example: BANK_WIRE_ON_DUE_DATE requires a customer account of type DUE_DATE.

🔐 Permissions:
- If the user is not the owner of the commercial order, they must have the ORDER_VALIDATE_ON_ALL_ACCOUNT permission within the same account.

Authentication: Requires a valid API key and client type.

Multistore Support: Optional headers allow scoping to a specific store and store view.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

commercialOrderId

string

required

Unique REFERENCE identifier of the commercial order to mark as created.
Business IDs or EXTERNAL_IDs are not supported for this path.

Body Params

mangoPayOrderOptions

object

Required only for MangoPay card payments.
Contains the pre-authorization token that must be passed to confirm the payment.

paymentOption

string

enum

required

Selected payment method for the order.

- BANK_WIRE: Standard bank transfer
- BANK_WIRE_ON_DUE_DATE: Bank transfer with due date, requires DUE_DATE account
- CREDIT_CARD: Card payment (via supported PSP)
- DIRECT_PAYMENT: Immediate payment at order creation
- BANK_WIRE_ON_ACCEPTANCE: Transfer initiated after manual order validation

Allowed:

paymentProvider

string

enum

required

 Payment service provider used to process the transaction.<br/><br/>
                - `MANGOPAY`: MangoPay PSP<br/>
                - `LEMONWAY`: Lemonway PSP<br/>
                - `DJUSTPAY`: Native DJUST PSP integration

Allowed:

Headers

dj-client

string

enum

required

Specifies the client type making the request.

OPERATOR: Platform operator user.
ACCOUNT: Customer account user.
SUPPLIER: Supplier managing orders.

Allowed:

dj-api-key

string

required

API key required for authentication. Must be valid and linked to the requesting user.

dj-store

string

(Optional) Store ID in multi-store environments.

dj-store-view

string

(Optional) Store view ID in multi-store environments.

customer-account-id

string

(Optional) Customer account ID in multi-account customer user.

Responses

204

Commercial order successfully validated.

All linked logistic orders are now in CREATED status.

400Order is not in a valid state for creation (e.g., not in DRAFT_ORDER).

401User is not authorized to validate the order (e.g., not owner and lacks permission).

404Commercial order not found or account/store reference is invalid.