订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（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/?account_id=hZNlqreWoa&ext_order_id=vfMyLCIidK&page_num=3923172288083547874&open_id=xjQ6kqb9Wg&create_order_end_time=6832383448985273750&update_order_end_time=4782109931005493165&create_order_start_time=6549413695326188973&get_secret_number=false&order_status=8221803365443575973&page_size=3311925516529856299&order_id=ibkEjoYSfT&update_order_start_time=3902532704039884382' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
业务数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20251203111101319B52D8C8CF5A551C74", "now": 1764731464 }, "data": { "orders": [ { "dish_sku_type_num": 4902852023894787000, "count": 3176084810014726000, "payment_discount": 9171233085274457000, "open_id": "Lh5aXPfi3y", "is_multi_order": false, "pay_amount": 1084175974947298600, "create_order_time": 8699397352901676000, "sku_name": "2sUwf6ZcBV", "user_id": 4871516077184552000, "is_deliver_later": false, "third_sku_id": "jR9UyQDpnm", "poi": { "poi_id": "7bQAEcnWU4", "poi_name": "mCGagh8RHd" }, "total_sku_type_num": 507629307514290600, "poi_id": "RLRTjzsP3E", "amount_info": { "platform_discount_amount": 1268884747893766400, "origin_amount": 1939259491326359000, "platform_deliver_freight_fee": 7653328886130490000, "sale_price": 315468025338037300, "discount_amount": 6250562532305896000, "other_fee_amount": 5014159746314022000, "packing_price": 1573324586920608000, "discounts": [ { "merchant_discount_amount": 1041407761343014500, "platform_discount_amount": 5538861749008801000, "discount_subject": 6685454040026699000, "discount_type": 7434758061980253000, "discount_amount": 3301502129768484400 } ], "product_origin_amount": 6881784468504809000, "freight_actual_pay_amount": 1663196075000365300, "merchant_deliver_freight_fee": 2303505598946090800, "pay_amount": 7445589580450393000, "freight_pay_amount": 7133947349736379000, "activities_fee_amount": 5462449884151079000, "estimated_order_income": 2863314892063232000, "merchant_discount_amount": 4180889466067595300, "pay_discount_amount": 3130920836251167000, "commission_amount": 366197578236152450, "deduction_info_list": [ { "pay_amount": 6725226619415679000, "platform_discount_amount": 6097966327564595000, "serial_num": 3348545864807928300, "deduction_amount": 6209400875468785000, "pay_discount_amount": 5959372295513590000, "deduction_type": 1, "certificate_id": 6529822886698549000, "sale_price": 1992300590632815600, "merchant_discount_amount": 1322472990092728000 } ] }, "update_order_time": 5324858203296525000, "refund_infos": [ { "refund_complete_time": 1256544181032621300, "user_refund_amount": 6480450245034093000, "products_refund": [ { "num": 3279111362787032600, "product_origin_amount": 1724214289498630000, "origin_amount": 8447032413645741000, "ingredients": [ { "product_id": "sgeTaSVOSP", "name": "XU0dFL8WSd", "count": 5231471022121227000, "out_id": "ckyyTt9ZHD" } ], "product_name": "R1EVkkzZoS", "product_id": "TucTOZIRkm", "out_id": "9vkUYE3PbP", "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_item_list": [ { "time_period": { "end_time_is_next_day": false, "use_start_time": "aGo5uvzZz2", "use_end_time": "T0WWE63zyh" }, "deductible_amount": 32483555627631176, "day_of_week": [ 1 ] } ], "dynamic_par_rule_desc": "YsARLSXULn", "dynamic_par_min_amount": 2230286544616218400, "dynamic_par_max_amount": 8235834374801318000 } } }, "specs": [ { "out_sku_id": "4h9erSrw9A", "value_type": 2222968457109777200, "value_metric": "NX71NbHPvR", "name": "fZwPh60WdT", "value": "UGChnBsiw2", "sku_id": "B8CI74FFT8" } ], "attributes": [ { "name": "uVPtDi9djQ", "value": "j6pL2jBkrn" } ], "sku_id": "lugYO1eXnn", "commodities": [ { "total_count": 3369865421748378000, "option_count": 1503687836872858600, "item_list": [ { "product_id": "UXX1SFWliT", "original_out_sku_id": "ZX3uv0dKgm", "attr_list": [ "RWxNKFXfPv" ], "out_sku_id": "9Roj7pxGFE", "weight_unit": "ZoTdnIgZmH", "original_price": 2432923043275909600, "item_tag": "TuO84Tig99", "price": 762464418088125300, "weight_count": 3768791870428428000, "ingredients": [ { "name": "GMXmVWOuSS", "count": 8760635944541997000, "out_id": "UlAXeFkL9B", "product_id": "OwRCKYAB8d" } ], "out_id": "h9cw89fCtF", "unit": "vXDjiUa1tG", "sku_id": "afulB31LPX", "specs": [ { "sku_id": "UT4pwED6JA", "out_sku_id": "D6oXTZmvON", "value_type": 9056833283140741000, "value_metric": "twao6YUdh5", "name": "xvOJOy8tV6", "value": "gYhEhAiJiY" } ], "count": 5136382432879794000, "original_sku_id": "aOERWQdtBf", "attributes": [ { "name": "zIbQAR289D", "value": "7SaDEXAPGn" } ], "deduction_info_list": [ { "deduction_type": 2871596366202687500, "serial_num": 7371757230352465000, "certificate_id": 3793824203467620400, "amount": 3881456879425196000, "third_part_code": "byoVe8bxO9", "verify_id": 3449969333886849500 } ], "name": "UjbLUxvohQ", "sku_attr_list": [ { "group_key": "7eqK38WyDd", "attr_name": "h2PScN31jh", "num": 1621866654868015600, "product_id": "yPaaBQ42bM", "out_id": "32eyxQJNH5", "upgrade_price": 8800726878482569000, "attr_key": "MWDl3oIQ94", "group_name": "VUMZTQ5G1d" } ], "desc": "Duh1ABBU88" } ], "group_name": "BHTg4LT5wT" } ], "product_type": 9122122854606766000 } ], "after_sale_id": "N2H0iQs1gx" } ], "products_after_refund": [ { "sku_id": "FKBX6Z64Y6", "commodities": [ { "item_list": [ { "weight_count": 5110044841808965000, "price": 8504368378621835000, "desc": "EfbLGt0uVq", "out_id": "bL6I7MLvdl", "original_price": 6736444422876183000, "product_id": "Bt1bE7MwWf", "sku_attr_list": [ { "product_id": "ghoMMNi8CZ", "out_id": "KVQ8XXXd9z", "upgrade_price": 3769388934497615000, "attr_key": "m9IUsJbabS", "group_name": "eqiPiBGOHd", "group_key": "bahLrjlpPQ", "attr_name": "qq5TBST3vW", "num": 6980824634303118000 } ], "original_sku_id": "SKCeWkiOtW", "item_tag": "dkiYtZLd0N", "name": "VHOOAoX7Ue", "original_out_sku_id": "M9PEY0ezcq", "unit": "cOIRP4Nf3g", "attributes": [ { "name": "BUZ1fsyplv", "value": "Ur2gDkjyFN" } ], "ingredients": [ { "name": "y58oucKz5P", "count": 1747944677301269200, "out_id": "nuw1OD7DRw", "product_id": "TtSKFl8WNc" } ], "attr_list": [ "Z3MLfZI4rd" ], "weight_unit": "M70XEQRyKr", "sku_id": "5c9H7Czu77", "deduction_info_list": [ { "third_part_code": "IigRd2KXat", "verify_id": 2348640392089543000, "deduction_type": 189105680422237400, "serial_num": 4756088822178982000, "certificate_id": 8988906623850527000, "amount": 2713794972850616000 } ], "out_sku_id": "nGYdUs9WqB", "specs": [ { "value_type": 3856493217915348000, "value_metric": "ZjdmFVRCYW", "name": "oChcOoMYmW", "value": "L4B06eN07O", "sku_id": "HmDrWrHogs", "out_sku_id": "XxE4Be2Phl" } ], "count": 3756288305861379000 } ], "group_name": "7qoeYa3Rs7", "total_count": 8641095652166910000, "option_count": 1197682228761087500 } ], "out_id": "Uq5kMqIzbO", "product_name": "v2srdo71c7", "product_id": "nO6ExMDeIF", "product_origin_amount": 6706974072822259000, "specs": [ { "value_type": 3367535227777209000, "value_metric": "kg1FGPoETt", "name": "oHvxxQgFvl", "value": "zwxDFphK2a", "sku_id": "guaBgMnW49", "out_sku_id": "PlIkg7yM1u" } ], "ingredients": [ { "name": "Yc6xDxwpqq", "count": 3199478341653617000, "out_id": "uHRokTZPvg", "product_id": "CYK3on4QTb" } ], "origin_amount": 415388777057838340, "attributes": [ { "name": "4c8BmfHa3z", "value": "nuOgWDIeNW" } ], "product_type": 1785571032895510300, "num": 1449178485548086500, "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_max_amount": 347989374143365440, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_end_time": "ZoRiJtiWJV", "end_time_is_next_day": false, "use_start_time": "fUspF6enxa" }, "deductible_amount": 7458370057301239000 } ], "dynamic_par_rule_desc": "OdiMiaAeXQ", "dynamic_par_min_amount": 5785026438797754000 } } } } ], "pay_time": 1801891114543659800, "discount_amount": 978299048875342100, "order_id": "MWZyI3ggDs", "order_type": 2766824240081678300, "buyer_info": { "buyer_secret_number": "laVT2KmQQj", "buyer_real_phone": "bJtH8QWwk3", "buyer_phone": "fhZn1QL3B0" }, "degradation_status": { "current_level": 1, "is_degraded": false, "affected_scopes": [ { "param_name": "Fr9n9vs7rj", "param_type": 1 } ] }, "modified_infos": { "modified_book_infos": [ { "modified_time": 3777056582407097000, "old_book_info": { "shop_number": "xM7UxoPNdI", "is_book": false } } ], "modified_receiver_infos": [ { "modified_time": 4658348370842073000, "old_receiver_info": { "door_plate_num": "iTsz5ShhuE", "secret_number": "vokVpbQ3lA", "location_address": "y7oVmXf95T", "receiver_name": "AGE8LM12Xl", "receiver_phone": "iIKw192GxI", "lng": 0.5045073248345818, "lat": 0.19704580329436908, "location_name": "jE7iXkZN8M", "district": "iikYQ9cp7n", "city": "vv8PvbaTSJ", "receiver_real_phone": "gtQzo6lhCz", "province": "yvzZS0gTRy", "town": "Fwyqn0T3Vy" } } ] }, "order_status": 8767180190511127000, "original_amount": 1077431792864174800, "merchant_info": { "account_id": "ilutKZ7c8c", "account_name": "5YpaimuDDm" }, "dish_sku_num": 6016978691129646000, "discounts": [ { "merchant_discount_amount": 5860822329787043000, "platform_discount_amount": 5727165642448590000, "discount_subject": 5462372367464729000, "discount_type": 4178780903662248400, "discount_amount": 9095528199739271000 } ], "delivery_info": { "remark": "sgCjjlJ4xd", "is_book": false, "user_expect_time": "UvvmnBCrAY", "sys_expect_time": "wUPzETXnWQ", "shop_number": "4dX8ffoiGb", "estimated_call_rider_time": 3805373248670003700, "table_ware": "C3eSsz9avF", "deliver_model": 526246253637913800, "latest_start_cooking_time": 5333205412255196000, "estimated_finish_cooking_time": 8055387460890728000 }, "sku_num": 3779928288753354000, "sku_type_num": 6749257792224338000, "sku_id": "WerZLtBFsA", "total_sku_num": 3127418732750633000, "contacts": [ { "phone": "qpJ3Ei6ypX", "phone_encrypt": "yFsVTKgSh5", "name": "p9y8eWFyNJ" } ], "certificate": [ { "refund_time": 7521591880899783000, "order_item_id": "fKREYIDfms", "certificate_id": "IY9AJpgDu8", "item_status": 5714132249126787000, "item_update_time": 9036059134392635000, "refund_amount": 1107098254307042700 } ], "sub_order_amount_infos": [ { "sub_order_type": 2472190476721365500, "sub_order_id": "5e5HWLsWD7", "pay_amount": 2903303681378524000, "origin_amount": 3824165949357902300, "discount_amount": 6097521189828899000, "discounts": [ { "discount_type": 7170422680401839000, "discount_amount": 6266056144602163000, "merchant_discount_amount": 2003390434747057200, "platform_discount_amount": 1683646557954280200, "discount_subject": 6102926133523911000 } ], "sub_order_seq": "VJiQu7altn" } ], "receiver_info": { "receiver_name": "YpxzEzV3Sr", "location_address": "DHaKCJFxjX", "lng": 0.2199066282142381, "receiver_phone": "CEaNNQqC3T", "door_plate_num": "xAHnNXOPXI", "town": "tZTvB66XAv", "location_name": "deUje7473n", "lat": 0.921038110879388, "province": "oem2FRPzQB", "city": "6UMwCro6U4", "district": "6M4SxAeS7C", "receiver_real_phone": "OdglZVsqKu", "secret_number": "Onqx1nomki" }, "products": [ { "product_id": "ohRHisjtnM", "num": 6453731326442206000, "commodities": [ { "group_name": "tAHsUC0QzH", "total_count": 1768348449388780500, "option_count": 7500072889968853000, "item_list": [ { "desc": "yohh57W1fS", "ingredients": [ { "name": "VlVlCBCear", "count": 700676532990319100, "out_id": "bRUMzy8gds", "product_id": "3EvXXfHIF4" } ], "price": 8334136251924103000, "count": 8443821626894909000, "product_id": "EzvVTNCGek", "original_out_sku_id": "K1McdGJRXQ", "deduction_info_list": [ { "certificate_id": 9049493225573324000, "amount": 1844846537836159000, "third_part_code": "C3O9aqotFT", "verify_id": 2809493458195464000, "deduction_type": 2359607380053951000, "serial_num": 3372307834475977700 } ], "original_price": 2429235398377493500, "sku_id": "7JCnFFhsTj", "unit": "tVEV68TLRD", "weight_count": 6825302533539859000, "out_id": "7qHQyE4CBM", "attributes": [ { "name": "7Qdc2Q7qbu", "value": "SeXUqoiXMC" } ], "item_tag": "1ZkjUhYpLi", "attr_list": [ "FbVv2PeSrw" ], "sku_attr_list": [ { "group_key": "SHoDeKmGB3", "attr_name": "MQqjlzs7n6", "num": 7120092000213862000, "product_id": "aW5l6F9p9z", "out_id": "feVFmpXTeb", "upgrade_price": 6939935463162363000, "attr_key": "CBdo24eug8", "group_name": "O5POI26NM9" } ], "out_sku_id": "82sKPkXnEa", "specs": [ { "out_sku_id": "DG0iVVzj6n", "value_type": 8739335726675377000, "value_metric": "a73tQn0VPB", "name": "rf1cyz0tp5", "value": "HJ36fhXZmI", "sku_id": "qizS0YPLEZ" } ], "name": "s0jLmpuny8", "original_sku_id": "pfyWKqfyuk", "weight_unit": "oSvYj4zJto" } ] } ], "product_type": 5255523328994535000, "ingredients": [ { "name": "l8CCW5P2kD", "count": 2722537785849480000, "out_id": "VwxG05bzQE", "product_id": "3okWELGrAF" } ], "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_min_amount": 5914966898764087000, "dynamic_par_max_amount": 8686014486116982000, "dynamic_par_rule_item_list": [ { "deductible_amount": 2337591561969378000, "day_of_week": [ 1 ], "time_period": { "use_end_time": "WkyTvYtP60", "end_time_is_next_day": false, "use_start_time": "pNElT58BQ2" } } ], "dynamic_par_rule_desc": "td1V47nC7r" } } }, "product_name": "ZfryIL68uu", "sku_id": "N2sIJvQW6P", "specs": [ { "value_type": 1962562499662791700, "value_metric": "4yaiKH1g0c", "name": "BDP9i62HYb", "value": "UPMy6iKSvK", "sku_id": "4eqcEzBKUA", "out_sku_id": "cJkXXmR2DO" } ], "attributes": [ { "name": "MGTrGZ3eZX", "value": "1sRb7XAelQ" } ], "product_origin_amount": 8688431575742175000, "origin_amount": 4007832648070038000, "out_id": "e7yGxUC02b" } ] } ], "page": { "page_num": 8439971097003093000, "page_size": 3845162834678494000, "total": 1783520763444128800 }, "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 | 以实际错误信息为准 |
