# SalesChannelCreateOrder

## Create a new order

> Creates a new order in the system for the specified channel

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"channel_path":{"name":"channel_id","in":"path","description":"The channel ID of the resource.","required":true,"schema":{"type":"integer"}}},"schemas":{"OrderCreate":{"type":"object","required":["order","order_item"],"properties":{"order":{"allOf":[{"$ref":"#/components/schemas/CreateOrder"},{"type":"object","description":"Order data containing all necessary information"}]},"order_item":{"type":"array","description":"List of items in the order","items":{"type":"object","required":["product","quantity","unit_price","total_price"],"properties":{"order":{"type":"integer","description":"ID of the order (optional, can be null)"},"product":{"type":"integer","description":"ID of the product"},"status":{"$ref":"#/components/schemas/OrderStatus"},"price_currency":{"$ref":"#/components/schemas/CurrencyEnum"},"price":{"type":"number","format":"decimal","description":"Price of the product"},"quantity":{"type":"integer","description":"Quantity of the product"},"unit_price":{"type":"number","format":"decimal","description":"Price per unit"},"total_price":{"type":"number","format":"decimal","description":"Total price for this item"},"tax_rate":{"type":"number","format":"decimal","description":"Tax rate applied to this item"},"tax_amount":{"type":"number","format":"decimal","description":"Total tax amount for this item"},"extra_field":{"type":"object","description":"Additional information as JSON"},"price_list":{"type":"integer","description":"ID of the price list"},"stock_list":{"type":"integer","description":"ID of the stock list"},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany"},"shipment_code":{"type":"string","description":"Shipment tracking code"},"attributes":{"type":"object","description":"Additional attributes as JSON"},"cancel_status":{"$ref":"#/components/schemas/CancelStatusEnum"},"installment_interest_amount":{"type":"number","format":"decimal","description":"Interest amount for installment"},"is_tradable":{"type":"boolean","description":"Whether the item is tradable"},"datasource":{"type":"integer","description":"ID of the data source"},"localized_attributes":{"type":"object","description":"Localized attributes"},"localized_attributes_kwargs":{"type":"object","description":"Additional arguments for localized attributes"},"cancellation_reconciliation":{"type":"integer","description":"Cancellation reconciliation ID"},"reconciliation":{"type":"integer","description":"Reconciliation ID"},"forced_refund":{"type":"boolean","description":"Whether refund was forced"},"original_stock":{"type":"integer","description":"Original stock ID"},"shipping_option_group":{"type":"integer","description":"Shipping option group ID"},"e_archive_url":{"type":"string","format":"uri","description":"URL to the electronic archive","readOnly":true},"tracking_number":{"type":"string","description":"Shipment tracking number","readOnly":true},"carrier_shipping_code":{"type":"string","description":"Shipping code from the carrier","readOnly":true},"external_status":{"type":"integer","description":"External status reference ID","readOnly":true},"discount_amount":{"type":"number","format":"decimal","description":"Discount amount applied to this item"},"retail_price":{"type":"number","format":"decimal","description":"Retail price of the item"},"image":{"type":"string","format":"binary","description":"Image file upload"},"parent":{"type":"integer","description":"ID of the parent order item"},"estimated_delivery_date":{"type":"string","format":"date","description":"Estimated delivery date"},"defined_tracking_url":{"type":"string","format":"uri","description":"Custom tracking URL"},"defined_shipping_company":{"type":"string","description":"Custom shipping company name"}}}}}},"CreateOrder":{"type":"object","required":["number","channel","customer","date_placed","amount","status"],"properties":{"number":{"type":"string","description":"Order number, unique within the context of a channel"},"channel":{"type":"integer","description":"ID of the channel through which the order was placed"},"status":{"$ref":"#/components/schemas/OrderStatus"},"date_placed":{"type":"string","format":"date-time","description":"Timestamp when the order was placed"},"customer":{"type":"integer","description":"ID of the customer who placed the order"},"shipping_address":{"type":"integer","description":"ID of the shipping address"},"billing_address":{"type":"integer","description":"ID of the billing address"},"currency":{"$ref":"#/components/schemas/CurrencyEnum"},"amount":{"type":"number","format":"decimal","description":"Total amount for the order"},"shipping_amount":{"type":"number","format":"decimal","description":"Shipping charge for the order"},"shipping_tax_rate":{"type":"number","format":"decimal","description":"Tax rate applied to the shipping charge"},"extra_field":{"type":"object","description":"Additional information about the order"},"payment_option":{"type":"integer","description":"ID of the payment option used"},"payment_option_slug":{"type":"string","description":"Slug of the payment option"},"bin_number":{"type":"string","description":"First 6 digits of the customer's card"},"installment":{"type":"integer","description":"ID of the installment option selected"},"installment_count":{"type":"integer","description":"Number of installments for the payment"},"delivery_type":{"type":"string","enum":["same_day","next_day","standard","in_store"],"description":"Type of delivery selected"},"installment_interest_amount":{"type":"number","format":"decimal","description":"Interest charged on installment payments"},"cargo_company":{"type":"integer","description":"ID of the company responsible for shipping"},"invoice_number":{"type":"string","description":"Invoice number for the order"},"invoice_date":{"type":"string","format":"date-time","description":"Invoice date for the order"},"e_archive_url":{"type":"string","format":"uri","description":"URL for the e-archive of the invoice"},"refund_amount":{"type":"number","format":"decimal","description":"Total refund amount for the order"},"discount_refund_amount":{"type":"number","format":"decimal","description":"Refund amount for the discount"},"shipping_refund_amount":{"type":"number","format":"decimal","description":"Refund amount for the shipping"},"discount_amount":{"type":"number","format":"decimal","description":"Discount applied to the order"},"is_send":{"type":"boolean","description":"Indicates whether the order has been sent"},"net_shipping_amount":{"type":"number","format":"decimal","description":"Net shipping amount","readOnly":true},"shipping_interest_amount":{"type":"number","format":"decimal","description":"Interest applied to the shipping cost"},"tracking_number":{"type":"string","description":"Tracking number for the order"},"carrier_shipping_code":{"type":"string","description":"Shipping code from the carrier"},"remote_addr":{"type":"string","description":"IP address from where the order was placed"},"fundstransfertransaction_set":{"type":"array","items":{"type":"integer"},"description":"Set of funds transfer transaction IDs"},"has_gift_box":{"type":"boolean","description":"Indicates whether the order has a gift box"},"gift_box_note":{"type":"string","description":"Message for the gift box"},"external_status":{"type":"integer","description":"ID of the external status"},"client_type":{"type":"string","enum":["default","android","ios","instore","b2b"],"description":"Type of client placing the order"},"language_code":{"type":"string","description":"Language code for the order"},"notes":{"type":"string","description":"Customer instructions for the order"},"delivery_range":{"type":"object","description":"Date range for delivery","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}}},"shipping_option_slug":{"type":"string","description":"Slug for the shipping option"},"segment":{"type":"string","description":"Customer segment for the order"},"modified_date":{"type":"string","format":"date-time","description":"Last modification date of the order"},"checkout_provider_id":{"type":"integer","description":"ID of the provider used for checkout"},"created_date":{"type":"string","format":"date-time","description":"Creation date of the order"},"cancellation_info":{"type":"object","description":"Details regarding the cancellation of the order"},"shipping_company":{"$ref":"#/components/schemas/ShippingCompany","readOnly":true},"cancel_status":{"$ref":"#/components/schemas/CancelStatusEnum","readOnly":true},"defined_tracking_url":{"type":"string","format":"uri","description":"Custom tracking URL"},"installment_free":{"type":"boolean","description":"Whether installment is free","readOnly":true},"first_refund_strategy":{"type":"string","description":"First refund strategy","readOnly":true}}},"OrderStatus":{"type":"string","enum":["cancellation_waiting","cancelled","waiting","payment_waiting","confirmation_waiting","approved","preparing","shipped","shipped_and_informed","ready_for_pickup","attempted_delivery","review_started","review_waiting","waiting_for_payment","paid","delivered","refunded"],"description":"Status of the order item"},"CurrencyEnum":{"type":"string","description":"Currency type for the price list.","enum":["tr","eu","usd","egp","gbp","mad","pln","sar","ron","uah","czk","huf","rub","bgn","iqd","kwd","bhd","omr","qar","aed","ngn","inr","lei","kzt","jod","rsd"]},"ShippingCompany":{"type":"string","description":"Shipping company options","enum":["aras","ups","asil","yurtici","mng","hbexpress","aramex","other","ismail","gls","hoopkapida","fancourier","tmmexpress","ptt","horoz","novaposhta","droplight","surat","ups_intl","b2c_direct","jetizz","tyexpress","ay_cargo","cainiao","acs","packupp","k_gelsin","birgunde","kargo_ist","giz","mylerz","mylerzsdd","r2s","boomex","chrono","scotty","netkargo","murat_lgc","fast_cargo","dpd","in_post","k_sende","rupost","cdek","loomis","carrtell","speeta","bringo","dhlexpress","bovo","gelal","arvato","bpost_athome","bpost_24_7","cathedis","dincer","sameday","gkn","svuum","hjetxl","aramex_express","tnt_cargo","ceva_cargo","bringo_express","sendeo","cargus","pinkpost","speedy","deliverigo","jetizz_v7","evdemo_lojistik","extension","apiship","octovan_express","clickpost","iMile","jetlogi","bolt","pony_express","boxaty","monist","city_express","fero_ai","carriyo","pakettaxi","falcon_flex","porter_express","sky_express","pts_express","bpost_pickup"]},"CancelStatusEnum":{"type":"string","description":"Cancellation status of the order item","enum":["waiting","confirmation_waiting","confirmed","approved","rejected","waiting_for_payment","manuel_refund_need","completed"]},"OrderResponse":{"$ref":"#/components/schemas/CreateOrder"}},"responses":{"400":{"description":"Required field(s) are missing, data is invalid, or the action is not allowed.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"field":{"oneOf":[{"type":"array","description":"Indicates that no value was provided for the {field} field in the request.","items":{"type":"string"}},{"type":"array","description":"Indicates usage of a non-existent object for {field} in the request.","items":{"type":"string"}}]},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"non_field_errors":{"description":"Indicates invalid data or action usage in the request.","type":"array","items":{"type":"string"}},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"detail":{"description":"Provides a detailed message for the given error.","type":"string"},"code":{"type":"string","description":"Represents the server-side error code."}}}]}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"406":{"description":"A custom 406 error occurs due to different validation failures in viewset or service level, such as uniqueness checks or other service-related exceptions.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Detailed message of the 406 error."}}}}}}}},"paths":{"/api/v1/channel/{channel_id}/create_orders/":{"post":{"tags":["SalesChannelCreateOrder"],"summary":"Create a new order","description":"Creates a new order in the system for the specified channel","operationId":"createOrder","parameters":[{"$ref":"#/components/parameters/channel_path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderCreate"}}}},"responses":{"201":{"description":"Order created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResponse"}}}},"400":{"$ref":"#/components/responses/400"},"404":{"$ref":"#/components/responses/404"},"406":{"$ref":"#/components/responses/406"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.akinon.com/omnitron-openapis/saleschannelcreateorder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.