订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（1）根据订单 id ，查询对应订单详情，入参：订单 id；
（2）根据订单状态和商户 id，查询指定时间内该商户下的订单列表，入参：商家id、订单状态、创单起止时间/修改起止时间；
（3）根据用户 id 和商户 id，查询某用户在该商户下的所有订单，入参：商家id、用户 id、创单起止时间/修改起止时间；
- 支付后未发码/发码失败订单查询方式：限定订单状态为“已支付”，如用户下单后超过 10 分钟未发码会发起退款；
- 退款申请待审核订单查询方式：限定券状态为“退款中”，如退款状态未响应超过 72 小时会自动退款。
- 金额计算公式：
- 原始金额 - 折扣金额（优惠金额） = 实付金额 original_amount - discount_amount = pay_amount
- 原始金额 = 各子单原始金额之和 （子单包含商品、配送费等）
使用限制
page_size和page_num必填，否则不返回内容
基本信息
| 名称 | 描述 |
|---|---|
| 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/?ext_order_id=U1N8qigi3e&create_order_end_time=4094223518455132345&get_secret_number=false&create_order_start_time=240206595487129613&page_num=8174724319517218882&page_size=57617445568287759&order_status=3267996027177096506&update_order_start_time=6975901639660221832&update_order_end_time=661052686283086131&open_id=cppVIz64fy&account_id=QAfMJ5yQoN&order_id=bW7mYH7tiC' \ --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": "20250731113843A500783E1021A78A7183", "now": 1753933124 }, "data": { "orders": [ { "sku_num": 8614172076991087000, "discounts": [ { "merchant_discount_amount": 2129397321840938500, "platform_discount_amount": 8585127493453258000, "discount_type": 8456369467067108000, "discount_amount": 1538889127966467300 } ], "refund_infos": [ { "refund_complete_time": 353572602720318850, "user_refund_amount": 2301606080548882000, "products_refund": [ { "origin_amount": 3010324205622212000, "product_name": "9LQLhJla37", "out_id": "s19vqBVpwp", "specs": [ { "name": "xhTd5Fq3Kr", "value": "k5t88InYsE", "sku_id": "QlDSp8xavj", "out_sku_id": "pb45khifSN", "value_type": 5970979028689128000, "value_metric": "cAlHF7AWs0" } ], "product_type": 895859342356662400, "product_id": "KJ7370I0pr", "product_origin_amount": 3750234692667551000, "num": 5334468786160067000, "attributes": [ { "value": "DGtzBKvzp6", "name": "7s6wHMc6ib" } ], "sku_id": "lKiAzD19rb", "ingredients": [ { "name": "H2iiHDewNE", "count": 201190240335909150, "out_id": "4QYwbeavhL", "product_id": "tVl5RXMM4A" } ], "commodities": [ { "total_count": 5763116035219870000, "option_count": 5672096881514037000, "item_list": [ { "unit": "WlKf7Rw6jU", "weight_count": 3000156309375133700, "count": 6491859405591142000, "weight_unit": "1PHBq7P5R7", "original_price": 3273244797508814300, "out_id": "aE3CXXz5AU", "specs": [ { "sku_id": "lN3cmelAMh", "out_sku_id": "zDHjLUE34q", "value_type": 1585094064212788200, "value_metric": "14kbWzBgG1", "name": "ZlYGrwm5st", "value": "IcfZyE9DAD" } ], "name": "s6Rfh2vEPq", "out_sku_id": "Wj6WyspxYc", "price": 1291371728102889000, "sku_id": "xHn6Alzg5u", "product_id": "bQjBmjdvMM", "desc": "RyF8Dhk0Vl", "deduction_info_list": [ { "third_part_code": "ZtdiRr3MBm", "verify_id": 2725192837453567000, "certificate_id": 4856014617331970000, "amount": 1863813036387862000 } ], "original_sku_id": "CaGU7lRaSv", "original_out_sku_id": "a7pLemGuFa", "attr_list": [ "5fvrKqWiV8" ], "item_tag": "lFSD6NQHAq", "ingredients": [ { "out_id": "7TFEsA5Bi1", "product_id": "Lj6EvMINc8", "name": "ObBaBf2FW9", "count": 6310071956579925000 } ], "sku_attr_list": [ { "num": 1535043372004702000, "product_id": "4T0botQObl", "out_id": "7D2OWxjPoy", "upgrade_price": 4821495460406536000, "attr_key": "7LxPyvuJzD", "group_name": "U5JD6lgHyg", "group_key": "ohiyxTwoHS", "attr_name": "wQn5v0GqVR" } ], "attributes": [ { "name": "rNyArYFXzI", "value": "uIy3SRQst8" } ] } ], "group_name": "UehKbSN4wz" } ], "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_max_amount": 881920551902746600, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_end_time": "0sv9mtWQDu", "end_time_is_next_day": false, "use_start_time": "AMkSpYZyuv" }, "deductible_amount": 3028016884642510000 } ], "dynamic_par_rule_desc": "efkMn0alIK", "dynamic_par_min_amount": 5415430306162107000 }, "voucher_par_type": 1 } } } ], "after_sale_id": "32dHTaSgMP" } ], "delivery_info": { "is_book": false, "user_expect_time": "sRbvVFDBiK", "sys_expect_time": "OCQjL04Y7i", "remark": "yEZyrraExH", "table_ware": "ZTPMEA0JdC", "deliver_model": 7125580294422892000, "shop_number": "Q5xDHFXThh" }, "user_id": 327471465749671400, "is_multi_order": false, "sub_order_amount_infos": [ { "sub_order_type": 8318603377193280000, "sub_order_id": "MD3Q3MRI1w", "pay_amount": 6692734612409301000, "origin_amount": 3269532254149055500, "discount_amount": 6654464614244693000, "discounts": [ { "discount_type": 771539644032942600, "discount_amount": 6360018444780977000, "merchant_discount_amount": 2166183378190905300, "platform_discount_amount": 2176120426528523800 } ] } ], "original_amount": 4474904671294311000, "discount_amount": 6452933227839239000, "update_order_time": 8010343673741720000, "total_sku_type_num": 7803989292686002000, "products_after_refund": [ { "sku_id": "Sll0ievJyM", "product_origin_amount": 707802419993207200, "ingredients": [ { "name": "9b7cVH60Ss", "count": 7715117992534558000, "out_id": "MG52p7N88t", "product_id": "s9RzBtITvy" } ], "product_type": 4320531744490099700, "origin_amount": 1086127481486404700, "commodities": [ { "group_name": "cWZ9TE2fwJ", "total_count": 5805220097937336000, "option_count": 4291430719434556000, "item_list": [ { "out_sku_id": "BGXWcQMn6T", "specs": [ { "value_type": 8731433592788199000, "value_metric": "vvyDI22cWx", "name": "sKKcN3638A", "value": "4laZLQOXy4", "sku_id": "xJ03bo2Un0", "out_sku_id": "Zj9Ah1Nlqw" } ], "item_tag": "1thcUDkvqc", "count": 3683970116395259400, "original_sku_id": "B0IXYFysCT", "out_id": "AdyWVEmxz4", "ingredients": [ { "name": "EzsYD94rYp", "count": 3849033078103318500, "out_id": "KnyRXwjyuh", "product_id": "XO8z7xUwYN" } ], "desc": "CgLtnPWkFr", "original_out_sku_id": "a3WnSILrZD", "deduction_info_list": [ { "certificate_id": 1281974149968624600, "amount": 8518973479035212000, "third_part_code": "o8Ewids1Tn", "verify_id": 6475792380132530000 } ], "product_id": "lLuVOE91W1", "name": "sqm4v0ZSl3", "original_price": 9136141117689061000, "weight_count": 8760932897102309000, "unit": "LY7OiJ2zMS", "attributes": [ { "name": "G4FEYTE9Zg", "value": "BB6jrl3MT8" } ], "sku_id": "wFITvuboLj", "price": 4881936555072103000, "attr_list": [ "q3xwN8bPPV" ], "sku_attr_list": [ { "upgrade_price": 262283333341008640, "attr_key": "B00lnXqboO", "group_name": "jSamk0Xyfq", "group_key": "lYXldepXHa", "attr_name": "KvU8YPFwGr", "num": 7611141886194529000, "product_id": "ZyB2cJgg7s", "out_id": "SOPF1ybHo7" } ], "weight_unit": "3ya8w9Nz1X" } ] } ], "attributes": [ { "name": "Qq26sMhLDR", "value": "obD6LYxSDx" } ], "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_max_amount": 7442091632972681000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "UoGQg76kQR", "use_end_time": "HiqwGQgKj2" }, "deductible_amount": 6233154767132303000 } ], "dynamic_par_rule_desc": "mdeG9Usf2N", "dynamic_par_min_amount": 8383512225461911000 } } }, "product_id": "vdgvRl9X7T", "num": 7124274340159716000, "product_name": "BdT4UPXnNa", "specs": [ { "value": "SHErD71jdD", "sku_id": "0YL1j93KdK", "out_sku_id": "XikszK2nBQ", "value_type": 4122511985409682000, "value_metric": "5YIyLU48iJ", "name": "fMpnOvK08K" } ], "out_id": "hd7w4v2kEu" } ], "amount_info": { "estimated_order_income": 6010480635371366000, "pay_amount": 8576418291137504000, "discounts": [ { "platform_discount_amount": 5922837857560554000, "discount_type": 8714992075439778000, "discount_amount": 2975787431762297300, "merchant_discount_amount": 7018090914674328000 } ], "packing_price": 3419876964690856400, "origin_amount": 1359718305881155000, "deduction_info_list": [ { "certificate_id": 497027225359631700, "serial_num": 8009472766479368000, "sale_price": 2143496562550484200, "merchant_discount_amount": 4161362326781091000, "pay_amount": 2645224366653325000, "deduction_amount": 8367705254445502000, "deduction_type": 1 } ], "discount_amount": 7261002059288174000, "freight_pay_amount": 4778032003943912000, "merchant_discount_amount": 5682727358769203000, "pay_discount_amount": 1762704938581487900, "freight_actual_pay_amount": 5380631291927484000, "sale_price": 2193555820502547700, "merchant_deliver_freight_fee": 9200577037895902000, "other_fee_amount": 523886458107248800, "commission_amount": 2088966378407831300, "activities_fee_amount": 4952942755279659000, "product_origin_amount": 442725514112419200, "platform_deliver_freight_fee": 1712190929832379100, "platform_discount_amount": 7610277499804953000 }, "receiver_info": { "receiver_phone": "Y3WFRkUu6N", "secret_number": "uz8Kh6rx3D", "province": "pDlYZFS8TH", "location_address": "nRTQWpK3tr", "door_plate_num": "wVn6c2wxpe", "district": "95DFcz4peJ", "lat": 0.2731760085579813, "city": "s2W6Vwmzke", "location_name": "TR7ezqFGvO", "receiver_real_phone": "XOyLTY8xOK", "receiver_name": "4TBcuNU3q7", "town": "YpMG4DFe9z", "lng": 0.07004725757820603 }, "sku_type_num": 5836940669025279000, "sku_name": "oJB02kniQu", "poi": { "poi_name": "RA2upl2cwc", "poi_id": "aQEMmqyadT" }, "poi_id": "M049qUe2Fq", "create_order_time": 4689092469127520000, "count": 5279958918075745000, "certificate": [ { "refund_time": 4143342937545402400, "order_item_id": "rhFWOHgwfe", "certificate_id": "N4JSuZMYdO", "item_status": 834421387599008000, "item_update_time": 4083154936551296500, "refund_amount": 6084789960902711000 } ], "dish_sku_num": 2614559975024395300, "pay_time": 8660599261073478000, "order_type": 8355322210474014000, "payment_discount": 6411502758534265000, "merchant_info": { "account_id": "llJPFaNeBI", "account_name": "rFDWH22xff" }, "dish_sku_type_num": 6824687431314171000, "products": [ { "product_name": "djoypFq5jC", "commodities": [ { "group_name": "fYE91Dd4TI", "total_count": 1183078603805555000, "option_count": 3314971226059716600, "item_list": [ { "weight_unit": "N0R8mckIOM", "unit": "2Z46iRnPaI", "item_tag": "IvRDVy0oxf", "specs": [ { "value": "BMecQcGJuY", "sku_id": "4RByntAhGf", "out_sku_id": "7cGCNgRRd5", "value_type": 4859438028498661000, "value_metric": "gMpqp07Edc", "name": "PoF1zhSRcT" } ], "attributes": [ { "name": "iWaudmtzfM", "value": "9te46NWCj6" } ], "deduction_info_list": [ { "certificate_id": 4196057669068732400, "amount": 3757092038972800000, "third_part_code": "ppDLwaPMSX", "verify_id": 9084797891264226000 } ], "price": 6623366247820270000, "sku_attr_list": [ { "num": 4909348515443101000, "product_id": "LxbHFlow4c", "out_id": "0KTtGVU9cE", "upgrade_price": 1634273890843252000, "attr_key": "Rv6b1kfWV4", "group_name": "7AtcFt82Oz", "group_key": "cNepA8VuZ4", "attr_name": "YaRfb5yutO" } ], "original_price": 4553117812140793300, "out_id": "rItsKs3Foz", "product_id": "SJKmn41Jjm", "count": 3570688385199322000, "desc": "99oTt0bMx4", "original_out_sku_id": "padQ0Q6RUC", "sku_id": "dJJbl9ak3u", "attr_list": [ "mzs3OosrYn" ], "ingredients": [ { "out_id": "X8fV3NRt4r", "product_id": "3sb4Wx4qvH", "name": "tBT6pAgJ5c", "count": 6524967729578064000 } ], "original_sku_id": "A1u2A7Md9b", "weight_count": 1504770145335409200, "name": "b1JzV0a05T", "out_sku_id": "fj9J7fIkMN" } ] } ], "product_id": "6ALpzKCHOS", "ingredients": [ { "name": "NZZIYlTMBr", "count": 7170521709421148000, "out_id": "1QVP5lUAiO", "product_id": "sP79jdV20A" } ], "num": 1159323055765239600, "out_id": "V32rHylpHI", "product_type": 6244253177360327000, "product_origin_amount": 1821999371627797800, "specs": [ { "value": "zl47j6foHi", "sku_id": "hhs1pxp6Zr", "out_sku_id": "vrHQFSvpRh", "value_type": 3993910454997793000, "value_metric": "nS1Q3Qv6jA", "name": "qmZ6lKL6ep" } ], "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_max_amount": 4280288631338248700, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_start_time": "vXQC6B5Aay", "use_end_time": "32g9puD5HL", "end_time_is_next_day": false }, "deductible_amount": 6605394514175715000 } ], "dynamic_par_rule_desc": "dai9a1ZHNB", "dynamic_par_min_amount": 4235254959145193000 } } }, "sku_id": "H5hUogF5wp", "attributes": [ { "name": "NF5hGBCats", "value": "2lCaExTMpB" } ], "origin_amount": 8296358761385732000 } ], "sku_id": "VWodRCIeM8", "is_deliver_later": false, "buyer_info": { "buyer_secret_number": "VLIPaj89P0", "buyer_real_phone": "ktIV12TpUR", "buyer_phone": "emNqkf50At" }, "contacts": [ { "name": "GcjF54U6il", "phone": "wXoeUuSJ2S", "phone_encrypt": "u96VXvAJZI" } ], "order_status": 3179938869838896600, "total_sku_num": 7791019132149930000, "pay_amount": 4315948277565329000, "third_sku_id": "T7PeDsziRl", "order_id": "6MxRVt4tsP", "open_id": "YmbNFKzsmi" } ], "page": { "page_size": 5424410154330667000, "total": 918858035894467100, "page_num": 7648904522534811000 }, "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 | 3000001 | 以实际错误信息为准 | |
| 200 | 5000001 | 服务器打瞌睡了，请稍后再试。 |
