Create Order

POST {{baseUrl}}/orders

This endpoint allows you to create an order related to your store directly from this endpoint.

💡 Note

When creating an order, you must send either the customer_id variable or the receiver object, or both.

Scope: orders.read_write - Orders Read & Write

Request Body

{"customer"=>{"id"=>"<number>", "mobile"=>"<string>", "name"=>"<string>", "email"=>"<string>"}, "receiver"=>{"name"=>"<string>", "country"=>"<string>", "phone"=>"<string>", "email"=>"<string>", "notify"=>"<boolean>", "country_code"=>"<string>"}, "payment"=>{"status"=>"pending_payment", "method"=>"credit_card", "bank_id"=>"<number>", "receipt_image_path"=>"<string>", "accepted_methods"=>"mada", "cash_on_delivery"=>{"amount"=>"<integer>", "currency"=>"<string>"}}, "delivery_method"=>"shipping", "branch_id"=>"<number>", "courier_id"=>"<string>", "ship_to"=>{"country"=>"<number>", "city"=>"<number>", "block"=>"<string>", "street_number"=>"<string>", "address_line"=>"<string>", "postal_code"=>"<number>", "geo_coordinates"=>{"lat"=>"<integer>", "lang"=>"<integer>"}}, "products"=>[{"quantity"=>"<number>", "identifier_type"=>"id", "identifier"=>"<string>", "options"=>[{"id"=>"<number>", "value"=>["<string>", "<string>"]}, {"id"=>"<number>", "value"=>["<string>", "<string>"]}], "donating_amount"=>"<integer>"}, {"quantity"=>"<number>", "identifier_type"=>"id", "identifier"=>"<string>", "options"=>[{"id"=>"<number>", "value"=>["<string>", "<string>"]}, {"id"=>"<number>", "value"=>["<string>", "<string>"]}], "donating_amount"=>"<integer>"}], "coupon_code"=>"<string>"}

HEADERS

RESPONSES

status: OK

{"status":"\u003cnumber\u003e","success":"\u003cboolean\u003e","data":{"id":"\u003cnumber\u003e","cart_reference_id":"\u003cnumber\u003e","reference_id":"\u003cnumber\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"date":{"date":"\u003cdateTime\u003e","timezone_type":"\u003cnumber\u003e","timezone":"\u003cstring\u003e"},"updated_at":{"date":"\u003cdateTime\u003e","timezone_type":"\u003cnumber\u003e","timezone":"\u003cstring\u003e"},"source":"abandoned-cart","draft":"\u003cboolean\u003e","read":"\u003cboolean\u003e","source_device":"\u003cstring\u003e","source_details":{"type":"\u003cstring\u003e","value":"\u003cstring\u003e","device":"\u003cstring\u003e","user-agent":"\u003cstring\u003e","ip":"\u003cstring\u003e"},"status":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","slug":"\u003cstring\u003e","customized":{"id":"\u003cinteger\u003e","name":"\u003cstring\u003e"}},"is_price_quote":"\u003cboolean\u003e","payment_method":"\u003cstring\u003e","receipt_image":"\u003cstring\u003e","currency":"\u003cstring\u003e","amounts":{"sub_total":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"shipping_cost":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"cash_on_delivery":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"tax":{"percent":"\u003cstring\u003e","amount":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"discounts":[{"title":"\u003cstring\u003e","type":"\u003cstring\u003e","code":"\u003cstring\u003e","discount":"\u003cstring\u003e","discounted_shipping":"\u003cinteger\u003e"}],"total":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"can_cancel":"\u003cboolean\u003e","show_weight":"\u003cboolean\u003e","can_reorder":"\u003cboolean\u003e","is_pending_payment":"\u003cboolean\u003e","pending_payment_ends_at":"\u003cinteger\u003e","total_weight":"\u003cstring\u003e","rating_link":"\u003cstring\u003e","shipping":{"id":"\u003cnumber\u003e","app_id":"\u003cnumber\u003e","company":"\u003cstring\u003e","logo":"\u003cstring\u003e","receiver":{"name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e"},"shipper":{"name":"\u003cstring\u003e","company_name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e"},"pickup_address":{"country":"\u003cstring\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","shipping_address":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","geo_coordinates":{"lat":"\u003cnumber\u003e","lng":"\u003cnumber\u003e"}},"address":{"country":"\u003cstring\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","shipping_address":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","geo_coordinates":{"lat":"\u003cinteger\u003e","lng":"\u003cinteger\u003e"}},"shipment":{"id":"\u003cnumber\u003e","pickup_id":"\u003cinteger\u003e","tracking_link":"\u003cstring\u003e","label":[{"format":"\u003cstring\u003e","url":"\u003cstring\u003e"}]},"policy_options":[{"boxes":"\u003cstring\u003e"}]},"shipments":[{"id":"\u003cnumber\u003e","created_at":"\u003cstring\u003e","type":"\u003cstring\u003e","courier_id":"\u003cnumber\u003e","courier_name":"\u003cstring\u003e","courier_logo":"\u003cstring\u003e","shipping_number":"\u003cstring\u003e","tracking_number":"\u003cstring\u003e","pickup_id":"\u003cinteger\u003e","trackable":true,"tracking_link":"\u003cstring\u003e","label":{"format":"\u003cstring\u003e","url":"\u003cstring\u003e"},"payment_method":"\u003cstring\u003e","source":"\u003cstring\u003e","total":{"amount":"\u003cstring\u003e","currency":"\u003cstring\u003e"},"cash_on_delivery":{"amount":"\u003cstring\u003e","currency":"\u003cstring\u003e"},"ship_to":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","country_id":"\u003cnumber\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","city_id":"\u003cnumber\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e"},"ship_from":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","company_name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","country_id":"\u003cstring\u003e","country_code":"\u003cstring\u003e","city":"\u003cstring\u003e","city_id":"\u003cnumber\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e","branch_id":"\u003cinteger\u003e"},"total_weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"},"packages":[{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","quantity":"\u003cinteger\u003e","weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"}}],"is_international":false,"meta":{"app_id":"\u003cstring\u003e","policy_options":{"boxes":"\u003cstring\u003e","dimensions":{"length":"\u003cstring\u003e","width":"\u003cstring\u003e","height":"\u003cstring\u003e"}}}}],"pickup_branch":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","status":"inactive","location":{"lat":"\u003cstring\u003e","lng":"\u003cstring\u003e"},"street":"\u003cstring\u003e","address_description":"\u003cstring\u003e","additional_number":"\u003cstring\u003e","building_number":"\u003cstring\u003e","local":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","contacts":{"phone":"\u003cstring\u003e","whatsapp":"\u003cstring\u003e","telephone":"\u003cstring\u003e"},"preparation_time":"\u003cstring\u003e","is_open":"\u003cboolean\u003e","closest_time":"\u003cstring\u003e","working_hours":[{"name":"\u003cstring\u003e","times":[{"from":"\u003cstring\u003e","to":"\u003cstring\u003e"}]}],"is_cod_available":"\u003cboolean\u003e","is_default":"\u003cboolean\u003e","type":"branch","cod_cost":"\u003cstring\u003e","country":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","name_en":"\u003cstring\u003e","code":"\u003cstring\u003e","mobile_code":"\u003cstring\u003e"},"city":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","name_en":"\u003cstring\u003e"}},"shipment_branch":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","status":"\u003cstring\u003e","is_default":"\u003cboolean\u003e","type":"\u003cstring\u003e"},"customer":{"id":"\u003cnumber\u003e","first_name":"JLXKIWwkIM ZPdi KQkNMUhUi","last_name":"L FjRkLKpbQG lJNtcdfsKve-","mobile":"\u003cnumber\u003e","mobile_code":"\u003cstring\u003e","email":"\u003cstring\u003e","urls":{"customer":"\u003cstring\u003e","admin":"\u003cstring\u003e"},"avatar":"\u003cstring\u003e","gender":"\u003cstring\u003e","brithday":{"date":"\u003cstring\u003e","timezone_type":"\u003cinteger\u003e","timezone":"\u003cstring\u003e"},"city":"\u003cstring\u003e","country":"\u003cstring\u003e","country_code":"\u003cstring\u003e","currency":"\u003cstring\u003e","location":"\u003cstring\u003e","updated_at":{"date":"\u003cdateTime\u003e","timezone_type":"\u003cnumber\u003e","timezone":"\u003cstring\u003e"},"groups":["\u003cinteger\u003e"]},"items":[{"product_reservations":["\u003cstring\u003e"],"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","sku":"\u003cstring\u003e","quantity":"\u003cinteger\u003e","currency":"\u003cstring\u003e","weight":"\u003cnumber\u003e","weight_label":"\u003cstring\u003e","amounts":{"price_without_tax":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"total_discount":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"},"tax":{"percent":"\u003cstring\u003e","amount":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"total":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}},"notes":"\u003cstring\u003e","product":{"id":"\u003cnumber\u003e","type":"donating","promotion":{"title":"\u003cstring\u003e","sub_title":"\u003cstring\u003e"},"status":"\u003cstring\u003e","is_available":"\u003cboolean\u003e","sku":"\u003cstring\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"sale_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"url":"\u003cstring\u003e","has_special_price":"\u003cboolean\u003e","regular_price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"currency":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","calories":"\u003cstring\u003e","mpn":"\u003cstring\u003e","gtin":"\u003cstring\u003e","favorite":"\u003cstring\u003e","starting_price":"\u003cstring\u003e"},"options":[{"id":"\u003cnumber\u003e","product_option_id":"\u003cnumber\u003e","name":"\u003cstring\u003e","type":"date","value":[{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e","price":{"amount":"\u003cinteger\u003e","currency":"\u003cstring\u003e"}}]}],"images":[{"id":"\u003cnumber\u003e","image":"\u003cstring\u003e","type":"\u003cstring\u003e"}],"codes":[{"code":"\u003cstring\u003e","status":"\u003cstring\u003e"}],"files":[{"url":"\u003cstring\u003e","name":"\u003cstring\u003e","size":"\u003cnumber\u003e"}],"reservations":"\u003cstring\u003e"}],"bank":{"id":"\u003cnumber\u003e","bank_name":"\u003cstring\u003e","bank_id":"\u003cnumber\u003e","account_name":"\u003cstring\u003e","account_number":"\u003cstring\u003e","iban_number":"\u003cstring\u003e","status":"\u003cstring\u003e"},"tags":{"id":"\u003cnumber\u003e","name":"\u003cstring\u003e"},"store":{"id":"\u003cstring\u003e","store_id":"\u003cstring\u003e","user_id":"\u003cstring\u003e","user_email":"\u003cstring\u003e","username":"\u003cstring\u003e","name":{"ar":"\u003cstring\u003e","en":"\u003cstring\u003e"},"avatar":"\u003cstring\u003e"}}}