订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（1）根据订单 id ，查询对应订单详情，入参：订单 id；
（2）根据订单状态和商户 id，查询指定时间内该商户下的订单列表，入参：商家id、订单状态、创单起止时间/修改起止时间；
（3）根据用户 id 和商户 id，查询某用户在该商户下的所有订单，入参：商家id、用户 id、创单起止时间/修改起止时间；
- 支付后未发码/发码失败订单查询方式：限定订单状态为“已支付”，如用户下单后超过 10 分钟未发码会发起退款；
- 退款申请待审核订单查询方式：限定券状态为“退款中”，如退款状态未响应超过 72 小时会自动退款。
- 金额计算公式：
- 原始金额 - 折扣金额（优惠金额） = 实付金额 original_amount - discount_amount = pay_amount
- 原始金额 = 各子单原始金额之和 （子单包含商品、配送费等）
使用限制
- page_size和page_num必填，否则不返回内容
- 该接口目前仅支持查询「41-随心团配送（老订单模式）」、「90-随心团配送（新订单模型）」这两个类型的订单信息，其他订单类型数据不建议用该接口，可以用通用的订单查询接口
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/goodlife/v1/hermes/trade/order/query/ |
| HTTP Method | GET |
| Scope | life.capacity.order.query |
| 权限要求 | 订单查询 |
请求参数
请求头
access-token必填String
示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Rpc-Transit-Life-AccountString
来客商户根账户ID
Query
account_id必填String
商家ID
create_order_end_timeInt64
创单结束时间 秒时间戳
create_order_start_timeInt64
创单起始时间 秒时间戳
ext_order_idString
外部订单id
get_secret_numberBool
是否需要获取隐私号
open_idString
抖音用户id
order_idString
订单ID
order_statusInt32
订单状态
page_numInt32
页数 默认1
page_sizeInt32
页面大小 （不传默认0 不返回内容），建议最小传10，最大200
update_order_end_timeInt64
修改起始时间 秒时间戳
update_order_start_timeInt64
修改起始时间 秒时间戳
请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/hermes/trade/order/query/?order_id=AyJXU79FQl&ext_order_id=UHJNYb0XtM&update_order_start_time=8423491413777255447&get_secret_number=false&update_order_end_time=851454124669673118&order_status=3386747764799097982&create_order_start_time=2729867739738984776&account_id=R6Wb1Vj1hg&page_num=6180630203964440759&page_size=4813890227216617763&open_id=tVYklS29L3&create_order_end_time=3319501080974987141' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
业务数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "2025102211293662A8B761F164A751D061", "now": 1761103776 }, "data": { "orders": [ { "discounts": [ { "merchant_discount_amount": 7225289234749963000, "platform_discount_amount": 7200726453498418000, "discount_subject": 5874175398369914000, "discount_type": 7502258670169920000, "discount_amount": 314760250291397100 } ], "count": 2131349294106230300, "delivery_info": { "shop_number": "7Gcd5edLu7", "is_book": false, "user_expect_time": "YrgxRNdMsN", "sys_expect_time": "awpbPsSzEq", "remark": "LqXUBRcort", "table_ware": "Dm3dgeWL5z", "deliver_model": 1153725556776543000 }, "products": [ { "out_id": "bjoROSyOLv", "product_origin_amount": 1134543495805062500, "specs": [ { "value_type": 6239152658082221000, "value_metric": "7kmUl37rwB", "name": "usPH2xyq3w", "value": "crQL3XfzLl", "sku_id": "qmrIOEzGvO", "out_sku_id": "AnVhyl5pji" } ], "ingredients": [ { "name": "fzoKOhVPrT", "count": 6790771221776766000, "out_id": "e7sUlt0LHT", "product_id": "kc4g08lAgH" } ], "commodities": [ { "item_list": [ { "item_tag": "D9xCo8SHzg", "out_sku_id": "6ouLzgsqOE", "weight_unit": "7Pnz1bV2bF", "attributes": [ { "value": "tbUcoYvSJs", "name": "HupedDlp18" } ], "price": 509094863155749600, "desc": "EgLDqD1Bq7", "name": "8xxIJ7jra0", "ingredients": [ { "count": 4726422124116227000, "out_id": "4WCimMMPHO", "product_id": "VJNBmyeEmc", "name": "NH9lnjCmVa" } ], "deduction_info_list": [ { "third_part_code": "6ZixLhwziM", "verify_id": 4950437531496676000, "certificate_id": 4236467937629090300, "amount": 1653938035084137700 } ], "unit": "ydiDtAZCOu", "original_sku_id": "kr4DobUIRo", "sku_id": "jMJu0VZrL6", "specs": [ { "value": "ZrIA2yChZl", "sku_id": "MPxri8RwWz", "out_sku_id": "eivSyhHtpH", "value_type": 8535061056981396000, "value_metric": "DnHV2MMKKG", "name": "lGpP54pzrz" } ], "sku_attr_list": [ { "product_id": "W2NlIlcxWk", "out_id": "xxag7Dc0IK", "upgrade_price": 2184022235245310200, "attr_key": "ITvvi3siK1", "group_name": "P8yXrdUxMk", "group_key": "gvkxFJpP80", "attr_name": "uedMyidBeN", "num": 8087576933309295000 } ], "count": 3948428651546320400, "product_id": "m2mVRLnyy6", "original_out_sku_id": "Om2wtmpG0K", "weight_count": 3939755910424089000, "original_price": 1687543601863476000, "out_id": "eirs58uXVV", "attr_list": [ "ynDv5xPuDa" ] } ], "group_name": "MYmSA2jWNP", "total_count": 7968256224946633000, "option_count": 1931173777897792000 } ], "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "UtqekDFez2", "use_end_time": "l6GOZZcXyk" }, "deductible_amount": 7345697580284797000 } ], "dynamic_par_rule_desc": "TwYSDXlL67", "dynamic_par_min_amount": 1892693213013922300, "dynamic_par_max_amount": 7097614486572906000 } } }, "attributes": [ { "name": "iCDst6kLFM", "value": "JFDdaEQoc6" } ], "product_name": "WSaHzabJIk", "num": 948627846127747200, "origin_amount": 4027393491555172400, "product_type": 3815027137837681700, "sku_id": "2avprGPqA9", "product_id": "i3PDhNsYPe" } ], "pay_time": 5403019270887045000, "pay_amount": 5085126243349759000, "user_id": 3646906998780321300, "sku_id": "UI7aDjWX1D", "open_id": "8fOL0VMwlO", "order_type": 9193894560414133000, "order_status": 3435928370280259600, "sub_order_amount_infos": [ { "pay_amount": 5465778704769435000, "origin_amount": 1427821183276752600, "discount_amount": 5529608381374817000, "discounts": [ { "discount_amount": 8512794439665914000, "merchant_discount_amount": 7257541667075003000, "platform_discount_amount": 6995042206481422000, "discount_subject": 2461193613377932300, "discount_type": 6573650123170678000 } ], "sub_order_type": 3920324474747926000, "sub_order_id": "Q51taqU77R" } ], "certificate": [ { "certificate_id": "FtZmQBZn9j", "item_status": 1361269705280872200, "item_update_time": 4130517534779216000, "refund_amount": 4448538831968549000, "refund_time": 692266162937836900, "order_item_id": "38uocld3XE" } ], "update_order_time": 5447432163995492000, "original_amount": 3649543859876649000, "amount_info": { "product_origin_amount": 3880259693408107500, "freight_actual_pay_amount": 1340753192816204000, "deduction_info_list": [ { "pay_discount_amount": 4813066284695094000, "platform_discount_amount": 3585844943484893700, "certificate_id": 3122727536962301000, "pay_amount": 7383277912664415000, "serial_num": 6707261634391727000, "deduction_type": 1, "sale_price": 1276542034183070500, "deduction_amount": 1789192094967394000, "merchant_discount_amount": 4599177771579406300 } ], "discount_amount": 6858626787373771000, "packing_price": 2160905208093318700, "merchant_discount_amount": 7049114980418710000, "discounts": [ { "discount_subject": 2211890209860970500, "discount_type": 3104210208505697000, "discount_amount": 8801160637045116000, "merchant_discount_amount": 762284882565358200, "platform_discount_amount": 4025487448266664000 } ], "pay_discount_amount": 3202969517644617000, "estimated_order_income": 42911110212582504, "platform_deliver_freight_fee": 7479725361669801000, "sale_price": 751201732971850100, "commission_amount": 4531977250123690500, "merchant_deliver_freight_fee": 7977472623127792000, "platform_discount_amount": 8835250753599938000, "activities_fee_amount": 7552849677686723000, "origin_amount": 6575319585592331000, "pay_amount": 5062518358821987000, "freight_pay_amount": 8409562969294428000, "other_fee_amount": 5811525543676165000 }, "buyer_info": { "buyer_real_phone": "hRji8HHe6y", "buyer_phone": "y0OxbQEh2m", "buyer_secret_number": "hWwt71CBUe" }, "total_sku_type_num": 5047290958025300000, "is_deliver_later": false, "contacts": [ { "name": "NhalR0rdru", "phone": "HbToPgzwPC", "phone_encrypt": "sZ24NJtyj2" } ], "poi": { "poi_id": "1OjzbmHPtL", "poi_name": "4sbwaWry9r" }, "degradation_status": { "current_level": 1, "is_degraded": false, "affected_scopes": [ { "param_type": 1, "param_name": "RSSZVoXmio" } ] }, "poi_id": "EbbzIQJtxx", "sku_name": "VPrqY3xgGS", "third_sku_id": "DO5rslcW0C", "create_order_time": 4297183128814933500, "total_sku_num": 4301936862834447000, "sku_num": 6457055325323176000, "dish_sku_type_num": 5343234566747044000, "payment_discount": 2593092847323007000, "merchant_info": { "account_id": "UYF0shGTeL", "account_name": "zmArVwnJGu" }, "modified_infos": { "modified_book_infos": [ { "modified_time": 1680680588420602600, "old_book_info": { "is_book": false, "shop_number": "KOpYMaVeMh" } } ], "modified_receiver_infos": [ { "old_receiver_info": { "district": "oChXiHAcsE", "location_address": "P81rOb0oR6", "province": "yKBOJJpdVC", "secret_number": "6oviGbmkM4", "town": "VYO11dlsaw", "receiver_real_phone": "NiEQ2PhPaH", "receiver_phone": "vzTQpGhjOJ", "lat": 0.2069775519916876, "city": "7h3RELkt0T", "lng": 0.2503684028628553, "location_name": "1Mz2ZNpvp2", "receiver_name": "6dsLW0M3lF", "door_plate_num": "IRCW1GHE3b" }, "modified_time": 401785838260297800 } ] }, "receiver_info": { "location_address": "hhilYTnoC1", "door_plate_num": "6BkntzPJid", "town": "e4hUAhKnTm", "lng": 0.2632558464952716, "province": "i83BdbDjqv", "receiver_real_phone": "5jkcSTZSjc", "secret_number": "8SVuntPOs4", "district": "0RA92I6cnR", "location_name": "2Fd23bXBIr", "city": "FbBdtsrVVy", "receiver_phone": "0OsWXOHSI4", "receiver_name": "vxm99e6KOZ", "lat": 0.5770973665151002 }, "products_after_refund": [ { "product_type": 1816051186453654000, "attributes": [ { "value": "vxHuscffjQ", "name": "Pxnj1pSWVT" } ], "product_id": "B8UoyEJHSK", "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "dcGMW10kt6", "use_end_time": "Flx70jvXDN" }, "deductible_amount": 6975930426926793000 } ], "dynamic_par_rule_desc": "LOJaCvpyzg", "dynamic_par_min_amount": 868546444913660300, "dynamic_par_max_amount": 8076268473278374000 } } }, "num": 8954013931966977000, "commodities": [ { "total_count": 4692954703817052000, "option_count": 5694405763859682000, "item_list": [ { "product_id": "dg8d2S4JaR", "attr_list": [ "rHVoaZMegL" ], "unit": "ydvitV5SZy", "attributes": [ { "value": "jLOVKq31vC", "name": "cFMQfwcx5E" } ], "original_price": 3055135272359854000, "original_sku_id": "HWpesOqP58", "weight_unit": "QCG8plh1bc", "specs": [ { "sku_id": "ywJtB3KlPM", "out_sku_id": "PAkYvRW6jw", "value_type": 2592313479397197000, "value_metric": "JFjHcSI76y", "name": "U5V4RNAyPa", "value": "3QIZ9WYVs2" } ], "item_tag": "CcFRGAQ3tw", "sku_attr_list": [ { "out_id": "Gk3pjDQdtc", "upgrade_price": 7162176970357603000, "attr_key": "kqUuWtOl1g", "group_name": "aFOtXFdQYC", "group_key": "xX6yFN3t26", "attr_name": "A8SuFJsjsg", "num": 3409141414649881600, "product_id": "Piy8h3I2Sh" } ], "ingredients": [ { "out_id": "CIDfzC6fp5", "product_id": "D23jvVdnbl", "name": "AdPxGMShOY", "count": 1432895867775407600 } ], "out_id": "IkIArN6PQc", "out_sku_id": "lEwS7feS4H", "count": 6053164359962799000, "name": "iSaYbkscT4", "weight_count": 3109794296557400000, "deduction_info_list": [ { "certificate_id": 4582321235695063000, "amount": 6921778032373566000, "third_part_code": "jeuDX8EtwS", "verify_id": 3843548729992436000 } ], "desc": "5qp7hlBnMt", "price": 688705642426394800, "sku_id": "Ur33Q2oTZi", "original_out_sku_id": "jgWjAteVJv" } ], "group_name": "kWnvy6xlLn" } ], "product_origin_amount": 2046614541546751200, "ingredients": [ { "name": "L00R4dVLVp", "count": 1471978430763555800, "out_id": "pCMnVOuyP3", "product_id": "h3tcRpEpjM" } ], "out_id": "yKv8ahYxVn", "sku_id": "0mwTt4x0IN", "origin_amount": 5001483826327329000, "specs": [ { "name": "pv9xk9LMaN", "value": "YVA5FUdOw6", "sku_id": "1QRIm0eDa9", "out_sku_id": "jpsQh0dQDp", "value_type": 6135066861529774000, "value_metric": "wljWxgvjj4" } ], "product_name": "yeYVBGIopx" } ], "is_multi_order": false, "sku_type_num": 5525215280677060000, "dish_sku_num": 6807401531756961000, "order_id": "COAt9gi8Rt", "discount_amount": 65442630787053420, "refund_infos": [ { "products_refund": [ { "ingredients": [ { "name": "y15cavj51T", "count": 487533783077629200, "out_id": "lBnOA67mu9", "product_id": "IvVDH8fToE" } ], "specs": [ { "name": "TO8XaSOGLg", "value": "2XJmmESQNn", "sku_id": "Wuj0KruK8i", "out_sku_id": "KNaLv0v424", "value_type": 6521503271727788000, "value_metric": "2NSyjzf0Ky" } ], "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_desc": "TZi0AxL1lL", "dynamic_par_min_amount": 4974731797286879000, "dynamic_par_max_amount": 4905404570392662000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "rJyvzNL5ox", "use_end_time": "8ZVHkaIqZW" }, "deductible_amount": 3678905454084338000 } ] } } }, "origin_amount": 3494233473846097400, "product_origin_amount": 7928114501266708000, "attributes": [ { "value": "v10Mz0TqIL", "name": "PP3DLBpJgj" } ], "sku_id": "oWjc1l7owb", "commodities": [ { "total_count": 3622083608540787000, "option_count": 3018543532544844300, "item_list": [ { "price": 7424917659403843000, "specs": [ { "name": "fh73K08qFP", "value": "pXR9cOuEme", "sku_id": "5Vuvc0NA76", "out_sku_id": "V6fCKsMZi6", "value_type": 2805035487944977000, "value_metric": "OiN6OHY5CY" } ], "ingredients": [ { "product_id": "fQ6ZD99ntn", "name": "jIT6C4DKCj", "count": 5117461805635867000, "out_id": "fPSDa469lz" } ], "original_price": 2713492838707232000, "original_out_sku_id": "DsDFkzagLE", "attributes": [ { "value": "jsafl6AGrX", "name": "T3UjwAd0Mo" } ], "out_sku_id": "vQ2sNbJP69", "weight_unit": "xH1kzAKNoP", "count": 7947357694283872000, "out_id": "69qJrEnWJQ", "sku_attr_list": [ { "num": 4314231773570222000, "product_id": "KEzcQqKLm8", "out_id": "AnaD94AZV9", "upgrade_price": 4657819851464205000, "attr_key": "Ly3FJIgU6D", "group_name": "hY7b3XV3bK", "group_key": "f3zIAbbTfj", "attr_name": "Ez29vylN3Q" } ], "sku_id": "QURgvjFGb1", "desc": "rMGnlM3O6r", "weight_count": 4229598088397418000, "name": "hMgaeHY1bH", "deduction_info_list": [ { "certificate_id": 7848559881194802000, "amount": 1087550732349285200, "third_part_code": "sIv0jRRg6X", "verify_id": 7055949086164080000 } ], "unit": "2HgSASLetk", "item_tag": "0w2UVCXhTN", "product_id": "UliVrBPsPy", "attr_list": [ "sobI2ZUknC" ], "original_sku_id": "1S1HYuXz6v" } ], "group_name": "W86cetw7oN" } ], "num": 3940191258628164000, "out_id": "FxLK9GUJY4", "product_id": "dbHSbng331", "product_name": "63hClZ9l3y", "product_type": 8220838520046099000 } ], "after_sale_id": "BwSS3R6uRn", "refund_complete_time": 4552366231868883500, "user_refund_amount": 6314035412704023000 } ] } ], "page": { "page_num": 3816959788211932700, "page_size": 1468831635147968500, "total": 3992594232599137300 }, "error_code": 0, "description": "" } }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 2100001 | 未知错误 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100004 | 系统繁忙，此时请开发者稍候再试 | 重试接口，重试3次仍报错联系抖音生活服务技术支持 |
| 200 | 2100005 | 参数不合法 | 更换参数 |
| 200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
| 200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
| 200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制，检查是否有测试环境在同步刷新token |
| 200 | 2119001 | 参数不合法 | 更换参数 |
| 200 | 2119002 | 系统繁忙，请稍候再试 | 重试 |
| 200 | 2119003 | 请求太过频繁，请稍后再试 | 重试 |
| 200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权，并在服务商后台同意授权 |
| 200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 4000001 | 根据实际业务错误返回 | 补充参数 |
| 200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
| 200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
| 200 | 5000001 | 服务器打瞌睡了，请稍后再试。 | |
| 200 | 3000001 | 以实际错误信息为准 |
