# 訂單接口 #### 1.生成訂單 ``` <pre class="calibre14">``` post:/index.php?ctl=Buyer_Order&met=addOrder&typ=json *string:receiver_name#收貨人姓名 *string:receiver_address#收貨地址 *string:receiver_phone#收貨人電話 string:invoice#發票信息 int:invoice_id#發票id string:invoice_title#發票抬頭 string:invoice_content#發票內容 *row:cart_id#購物車id *row:shop_id#店鋪id row:remark#備注 row:increase_arr#加價購商品 row:voucher_id#使用的代金券id string:redpacket_id#使用的紅包id *int:pay_way_id#支付方式id 1-在線支付 2-貨到付款 *int:address_id#收貨地址id string:from#訂單來源 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{"uorder":合并支付訂單}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 2.商家發貨 ``` <pre class="calibre14">``` post:/index.php?ctl=Seller_Trade_Order&met=send&typ=json *string:order_id#訂單號 *int:order_shipping_code#物流單號 *int:order_shipping_express_id#物流公司id string:order_shipping_message#發貨備忘 string:order_seller_message#給買家留言 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 3.確認收貨 ``` <pre class="calibre14">``` post:/index.php?ctl=Buyer_Order&met=confirmOrder&typ=json *string:order_id#訂單號 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 4.評價訂單 ``` <pre class="calibre14">``` get:/index.php?ctl=Goods_Evaluation&met=addGoodsEvaluation&typ=json *int:package_scores=5#描述相符 *int:send_scores=5#發貨速度 *int:service_scores=5#服務態度 *int:isanonymous#是否匿名 0-不匿名 1-匿名 *row:evaluation#商品評價信息 <<< success {cmd_id: -140, status: 200, msg: 1, data: Object} <<< error {cmd_id: -140, status: 250, msg: 1, data: Object} ``` ``` #### 5.追加評價訂單 ``` <pre class="calibre14">``` get:/index.php?ctl=Goods_Evaluation&met=againGoodsEvaluation&typ=json *int:goods_scores#商品評價 *string:result#評價結果 good,neutral,bad *string:content#評論內容 *string:evaluate_img#曬圖 *int:isanonymous=0#是否匿名 0-不匿名 1-匿名 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 6.取消訂單 ``` <pre class="calibre14">``` post:/index.php?ctl=Buyer_Order&met=orderCancel&typ=json *string:order_id#訂單id *string:state_info#取消原因 *string:state_info1#其他取消原因 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 7.買家申請退款退貨 ``` <pre class="calibre14">``` post:/index.php?ctl=Buyer_Service_Return&met=addReturn&typ=json *string:order_id#訂單id *int:goods_id#訂單商品id string:return_message#"退款/退貨"說明 int:return_reason_id#"退款/退貨"原因id int:nums#"退款/退貨"商品數量 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 8.商家審核退款退貨 ``` <pre class="calibre14">``` post:/index.php?ctl=Seller_Service_Return&met=agreeReturn&typ=json *string:order_return_id#退單id string:return_shop_message#商家處理備注 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 9.平臺審核退款退貨 ``` <pre class="calibre14">``` post:/index.php?ctl=Api_Trade_Return&met=agree&typ=json *string:order_return_id#退單id string:return_platform_message#處理備注 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{"rs":處理結果}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 10.實物訂單列表與訂單詳情 ``` <pre class="calibre14">``` get:/index.php?ctl=Buyer_Order&met=physical&typ=json string:act#操作標識 details:訂單詳情 string:order_id#訂單id <<< success cmd_id : -140 status：200 msg："success" data { page：當前頁數 total：共計頁數 totalsize：記錄總數 items { 0 { order_id：訂單id shop_id：店鋪id shop_name：店鋪名稱 buyer_user_id：買家id buyer_user_name：買家名稱 seller_user_id：賣家id seller_user_name：賣家名稱 order_date：訂單生成日期 年-月-日 order_create_time：訂單生成日期 年-月-日 時：分：秒 order_receiver_name：收貨人姓名 order_receiver_address：收貨地址 order_receiver_contact：收貨人聯系電話 order_receiver_date：收貨時間（最晚收貨時間） payment_id：支付方式id payment_name：支付方式名稱 payment_time：支付時間 payment_number：訂單支付單號 payment_other_number：最終支付單號 order_seller_name：發貨人名稱 order_seller_address：發貨人地址 order_seller_contact：發貨人聯系電話 order_shipping_time：發貨時間 order_shipping_express_id：物流公司id order_shipping_code：物流單號 order_shipping_message：賣家備注 order_finished_time：訂單完成時間 order_invoice：發票信息 order_invoice_id：發票id order_goods_amount：商品總價格（不包含運費） order_payment_amount：應付金額（商品支付金額+運費） order_discount_fee：優惠價格 order_point_fee：買家使用積分 order_shipping_fee：運費 order_buyer_evaluation_status：買家評價狀態 0-未評價 1-已評價 order_buyer_evaluation_time：買家評價時間 order_seller_evaluation_status：賣家評價狀態 0-未評價 1-已評價 order_seller_evaluation_time：賣家評價時間 order_message：訂單留言 order_status：訂單狀態 order_points_add：訂單贈送積分 voucher_id：代金券id voucher_price：代金券面額 voucher_code：代金券編碼 order_refund_status：退款狀態：0-無退款 1-退款中 2-退款完成 order_return_status：退貨狀態：0-無退貨 1-退貨中 2-退貨完成 order_refund_amount：退款金額 order_return_num：退貨數量 order_from：訂單來源 1-pc 2-wap order_commission_fee：交易傭金 order_commission_return_fee：交易傭金退款 order_is_virtual：虛擬訂單 order_virtual_code：虛擬商品兌換碼 order_virtual_use：虛擬商品是否使用 0-未使用 1-已使用 order_shop_hidden：賣家刪除 order_buyer_hidden：買家刪除 order_subuser_hidden：主管賬號刪除 order_cancel_identity：訂單取消者 1-買家 2-賣家 3-系統 order_cancel_reason：訂單取消原因 order_cancel_date：訂單取消時間 order_shop_benefit：訂單取消時間 chain_id：門店id order_seller_message：賣家給買家留言 directseller_flag：是否是分傭訂單 directseller_p_id：推廣員上級 redpacket_code：紅包編碼 redpacket_price：紅包金額 order_rpt_price：紅包抵扣金額 order_rpt_return：紅包退還金額 order_settlement_time：訂單結算時間 order_is_settlement：訂單是否結算 0-未結算 1-已結算 shop_distributor_id：分銷商 order_distribution_seller_type：SO訂單分銷類型 1:直銷(E) 2:分銷代銷轉發銷售(P, SP) order_distribution_buyer_type：PO訂單類型 1:購買(E采購，SP:代銷采購) 2:分銷采購,代客下單 (P開頭) order_source_id：源訂單Id（P開頭）:SP開頭訂單對應的P開頭訂單 directseller_gp_id：推廣員上級的上級 directseller_id：推廣員上級的上級 directseller_is_settlement：推廣員 district_id：所在地 order_sub_pay：0-自己支付 1-主管賬號支付 order_sub_user：付款主管賬號id order_directseller_commission：分銷員三級總傭金 directseller_discount：等級折扣金額 id：主鍵 express_name：快遞公司名稱 order_state_con：訂單狀態 order_refund_status_con：訂單退款狀態 shop_names：店鋪名稱 complain_day：交易投訴的有效時間 complain_status：投訴狀態 0-不可投訴 1-不可投訴 goods_list: { 0 { order_goods_id：訂單商品id order_id：訂單id goods_id：商品id common_id：商品common_id buyer_user_id：買家id goods_name：商品名稱 goods_class_id：商品對應的類目id spec_id：規格id order_spec_info：規格描述 goods_price：商品價格 order_goods_num：訂單商品數量 goods_image：商品圖片 order_goods_returnnum：退貨數量 order_goods_amount：商品實付金額 order_goods_discount_fee：優惠金額 order_goods_payment_amount：實付金額 order_goods_adjust_fee：手工調整金額 order_goods_point_fee：積分費用 order_goods_commission：訂單商品的傭金（總） shop_id：店鋪id order_goods_status：訂單狀態 order_goods_evaluation_status：訂單商品評價狀態 0-未評價 1-已評價 order_goods_benefit：訂單商品優惠 goods_return_status：退款狀態 0-無退款 1-退款中 2-退款完成 3-商家拒絕退款 goods_refund_status：退貨狀態 0-無退貨 1-退貨中 2-退貨完成 3-商家拒絕退貨 order_goods_time：時間 directseller_flag：是否參與分銷 directseller_id：推廣銷售員-訂單 directseller_is_settlement：分銷傭金是否結算 0-未結算 1-已結算 directseller_commission_0：直屬一級分傭 directseller_commission_1：直屬二級分傭 directseller_commission_2：直屬三級分傭 directseller_goods_discount：等級折扣金額 order_goods_source_id：SP訂單號 order_goods_source_ship：供應商物流 order_goods_finish_time：訂單商品完成時間 id：主鍵 evaluation_count：評價數 goods_refund_status_con：退貨狀況 goods_return_status_con：退款狀況 order_refund_id：退貨id order_return_id：退款id } evala_status：訂單評價狀態，1表示待評價，2表示已評價待追加評價，3表示查看評價 } <<< error cmd_id : -140 status：250 msg："failure" data{} ``` ``` #### 11.刪除訂單 此處的刪除訂單只是改變訂單的顯示狀態，使其不顯示 ``` <pre class="calibre14">``` get:/index.php?ctl=Buyer_Order&met=hideOrder&typ=json *string:order_id#訂單id user#刪除者身份 op#操作類型 ,當值為del時表示徹底刪除訂單 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 12.還原回收站中的訂單 ``` <pre class="calibre14">``` get:/index.php?ctl=Buyer_Order&met=restoreOrder&typ=json *string:order_id#訂單id user#操作者身份 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` #### 13.采購單列表與詳情 ``` <pre class="calibre15">``` get:index.php?ctl=Buyer_Order&met=subPhysical&typ=json string:act:操作 order_id#需要查看詳情的訂單id name#說明文字 <<< success <<< error ``` ```