Create a new order
POST/v2/orders
Creates a new order with items, addresses, payment, and shipping information.
Performs comprehensive validation of all required fields and business rules before order creation. The order creation process includes:
- Customer and shop validation
- Order item validation (products, quantities, pricing)
- Address validation for billing and delivery
- Payment method and amount validation
- Shipping method and cost calculation
- Tax calculation and currency conversion
- Inventory availability checks
- Business rule validation (minimum order amounts, restrictions)
Upon successful creation, the order is assigned a unique ID and UUID, and initial status is set. The response includes the complete order object with all calculated totals and generated metadata.
Request
Responses
- 201
- 400
- 401
- 403
- 409
- 500
Order created successfully
Invalid order data or validation errors
Authentication required - invalid or missing access token
Insufficient permissions to create orders
Order with the same external ID or cart ID already exists
Internal server error during order creation