订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（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/?update_order_start_time=3442116316963987769&update_order_end_time=574175912182686313&page_num=938507426043997063&page_size=2696564999710489406&order_status=7382904334564361051&ext_order_id=sQwzYFRui6&create_order_end_time=4308121758006966113&get_secret_number=false&order_id=XcrfCVMxaD&account_id=0qMtitAluG&create_order_start_time=3017576165365510782&open_id=QuaSm4AV5y' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'Rpc-Transit-Life-Account: jQVeh0LIe9' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
业务数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "orders": [ { "amount_info": { "activities_fee_amount": 4149588207330918000, "commission_amount": 5732847090536073000, "deduction_info_list": [ { "certificate_id": 8335872618111953000, "deduction_amount": 6287875519909304000, "deduction_type": 1, "merchant_discount_amount": 5345638291546385000, "pay_amount": 4287986704654788600, "pay_discount_amount": 4211912578122602000, "platform_discount_amount": 2250500359878938000, "sale_price": 4172637883279321000, "serial_num": 498381951177864700 } ], "discount_amount": 4292314597329025000, "discounts": [ { "discount_amount": 4504337594157912000, "discount_subject": 5694229114345753000, "discount_type": 1840732921205706200, "merchant_discount_amount": 8276518173954836000, "platform_discount_amount": 3880526163658837500 } ], "estimated_order_income": 9060013051523653000, "freight_actual_pay_amount": 6573805354969308000, "freight_pay_amount": 7007641268294311000, "merchant_deliver_freight_fee": 5565970883136465000, "merchant_discount_amount": 2511398191578577000, "origin_amount": 1703467817280760600, "other_fee_amount": 1238132278227852000, "packing_price": 4799846691992572000, "pay_amount": 7566047127153194000, "pay_discount_amount": 746563484646187600, "platform_deliver_freight_fee": 198812259579373500, "platform_discount_amount": 262569264061195740, "platform_reverse_deliver_freight_fee": 5990324338865139000, "product_origin_amount": 6492397458010187000, "reverse_freight_actual_pay_amount": 9156969440240039000, "reverse_freight_handling_fee": 8498416226413560000, "sale_price": 4325938870014033000 }, "buyer_info": { "buyer_phone": "1hy7l5DS6D", "buyer_real_phone": "3sIy6KfCxm", "buyer_secret_number": "fY1TlkvC8f", "enc_buyer_real_phone": "zqiH7Wkech" }, "certificate": [ { "certificate_id": "Ff3td2n4Iw", "item_status": 5527404958979117000, "item_update_time": 6594633576325772000, "order_item_id": "Zl96ehOhjd", "refund_amount": 3255216125623766500, "refund_time": 3336542596622743000 } ], "contacts": [ { "name": "1m0QgYkOb2", "phone": "rLqleupPeh", "phone_encrypt": "8V4JeEOMSA" } ], "create_order_time": 655707261983516500, "degradation_status": { "affected_scopes": [ { "param_name": "xejJawVMla", "param_type": 1 } ], "current_level": 1, "is_degraded": false }, "delivery_info": { "create_delivery_channel": 4338717322729480700, "deliver_model": 1483529360519185200, "estimated_call_rider_time": 6635795433816266000, "estimated_finish_cooking_time": 3417057991376527000, "is_book": false, "latest_start_cooking_time": 8785319655184946000, "remark": "IIKatJ1kIA", "shop_number": "lDYSTM3sa7", "sys_expect_time": "NwBnNvPnKZ", "table_ware": "pNDMZAFuUh", "user_expect_time": "sqi6WaZCfi" }, "discount_amount": 2982221352132470300, "discounts": [ { "discount_amount": 6277339283670716000, "discount_subject": 2461410815281400000, "discount_type": 4558801744932801000, "merchant_discount_amount": 6365762668593278000, "platform_discount_amount": 9214614288180365000 } ], "is_deliver_later": false, "merchant_info": { "account_id": "jNlLOux6U5", "account_name": "3EcHdsAKGu" }, "modified_infos": { "modified_book_infos": [ { "modified_time": 5306853831431287000, "old_book_info": { "is_book": false, "shop_number": "IBnaAXfqSf" } } ], "modified_receiver_infos": [ { "modified_time": 4671971623257348000, "old_receiver_info": { "city": "kuyeZtKmbL", "district": "ktoD9oXk3l", "door_plate_num": "MgRfwYbCyn", "enc_receiver_phone": "C1WyMcwALi", "enc_receiver_real_phone": "UJgtl43iSd", "lat": 0.22284299292693918, "lng": 0.338711031235504, "location_address": "5Sj8OMlWBl", "location_name": "H3GTKF00RI", "province": "5VYGSU0QG3", "receiver_name": "9mKR2QpYwW", "receiver_phone": "r6C45MhUft", "receiver_real_phone": "g746G1afp8", "secret_number": "T2GxiLwlPn", "town": "X6SIYJRJlM" } } ] }, "open_id": "JxrtxAsYsY", "order_id": "ZCSAVSK4WN", "order_status": 4793936622005029000, "order_type": 9077622312453294000, "original_amount": 6987887207762220000, "pay_amount": 5205540628862756000, "pay_time": 4002956509023367000, "payment_discount": 4762913397005882000, "poi": { "poi_id": "Qo74PxwbaO", "poi_name": "llO5Y7H1x1" }, "poi_id": "FtchuLata5", "products": [ { "commodities": [ { "group_name": "Ya7Sgg6wTn", "item_list": [ { "attr_list": [ "oOajJwkqwb" ], "attributes": [ { "name": "iFoUSFSpt5", "value": "6F4kSntcyA" } ], "count": 1187323286440218400, "deduction_info_list": [ { "amount": 3158487635165220000, "certificate_id": 2089570462930947000, "deduction_type": 8255419887515969000, "serial_num": 5681945133921011000, "third_part_code": "EfYnnCNZIJ", "verify_id": 7285317065167109000 } ], "desc": "8kIfmVWP0S", "ingredients": [ { "count": 2083226509225025500, "name": "BTI5OHkEbn", "out_id": "hR5jaseuoV", "product_id": "ISgJK1mPN4" } ], "is_refunded": false, "item_tag": "CkhA2R8BKA", "name": "YbP5g2YoDe", "original_out_sku_id": "RqCgxEEJa1", "original_price": 4748331611339682000, "original_sku_id": "ZMscI3d3LG", "out_id": "p6WwbEsvjs", "out_sku_id": "RDcj3cetDV", "price": 8588641072400738000, "product_id": "1wlvTHOe7k", "sku_attr_list": [ { "attr_key": "2yMvfNOeTv", "attr_name": "yhHlNE2cMy", "group_key": "6WPrguRa7o", "group_name": "1WNsil4TDD", "is_refunded": false, "num": 5800303447284717000, "out_id": "TUVcNw4IIW", "product_id": "ZI93DPFjws", "upgrade_price": 329201117818385860 } ], "sku_id": "gdRzTPaoVn", "specs": [ { "name": "WDrTj9ntbL", "out_sku_id": "oDGUGEorJf", "sku_id": "MaNsTzeMLy", "value": "3N0QTUcyro", "value_metric": "bXDOoN0BHc", "value_type": 3870092642959768600 } ], "unit": "tsbcsveIaA", "weight_count": 2904824049737732600, "weight_unit": "0IU3sc6KnF" } ], "option_count": 3982108407050005500, "total_count": 5886215609279731000 } ], "num": 4426977904549884400, "order_item_id": "Its62TjjIx", "origin_amount": 4461774133814525000, "out_id": "GwzL1xPrLW", "product_id": "U5HL68yBxA", "product_name": "00Cv6oJdS6", "product_origin_amount": 8714005356982417000, "product_type": 7670713039018113000, "sku_id": "s0y9wTsa0a" } ], "products_after_refund": [ { "attributes": [ { "name": "8ORanDmCFU", "value": "Bfc0O5OWT3" } ], "commodities": [ { "group_name": "HGEZ39mtx6", "item_list": [ { "attr_list": [ "6syKvCI2of" ], "attributes": [ { "name": "EF0Wn7D7if", "value": "lNyLzqlA8c" } ], "count": 3744621973897167000, "deduction_info_list": [ { "amount": 7151010806913357000, "certificate_id": 4116321095029073400, "deduction_type": 2782879098277148000, "serial_num": 2843472087647708000, "third_part_code": "fxY6zfUT8G", "verify_id": 8986846016536295000 } ], "desc": "IweE231WQE", "ingredients": [ { "count": 7110036885439037000, "name": "dpOuGSYGp3", "out_id": "wkOsKxSmO7", "product_id": "stTj211cI8" } ], "is_refunded": false, "item_tag": "pPR6xcQ5AI", "name": "QvWBAzL21i", "original_out_sku_id": "8o5OeS0AC7", "original_price": 2708742938368915000, "original_sku_id": "KTyIfi0uQ3", "out_id": "ZzHNzUm3Yy", "out_sku_id": "M0xjiGtSZz", "price": 2893956190798212000, "product_id": "CzocmMJTfT", "sku_attr_list": [ { "attr_key": "Dt93noNuNW", "attr_name": "zkyKbzkFcI", "group_key": "URejJ6QiV3", "group_name": "rApFYmJQKe", "is_refunded": false, "num": 5802808355140450000, "out_id": "MwZP6KGZQ6", "product_id": "lRJ5LDDw4I", "upgrade_price": 2180210440467623200 } ], "sku_id": "P7D5nvSRr9", "specs": [ { "name": "UJeWPeh7Nd", "out_sku_id": "CzdCx5TK8D", "sku_id": "sKXhdpqJxr", "value": "9pujpxdvi8", "value_metric": "xCMuUGNuPo", "value_type": 5316844627081612000 } ], "unit": "QG68wbGBZd", "weight_count": 409902358967155840, "weight_unit": "jrwVMEDS2x" } ], "option_count": 3933853313719973400, "total_count": 5636251756071241000 } ], "ingredients": [ { "count": 7957824891145054000, "name": "vsLCirq6Tg", "out_id": "3i5ikIMAdg", "product_id": "EQ4TKN7j2u" } ], "num": 831801426597616900, "order_item_id": "j4By6ic4Vq", "origin_amount": 3603401953119881000, "out_id": "962sb6bMZe", "product_id": "GutJdwSJJd", "product_name": "Wg1A90hGNF", "product_origin_amount": 5889325892788020000, "product_type": 4714225436318074000, "sku_id": "VRyiV0iLel", "specs": [ { "name": "hVICXW6zxf", "out_sku_id": "wmMEzxed6W", "sku_id": "wgVpw2SuoQ", "value": "WlXh2ZdMEx", "value_metric": "1DZIQh4Qya", "value_type": 7294120361919460000 } ] } ], "receiver_info": { "city": "1HR3x3mzmD", "district": "NJn4E2AoUC", "door_plate_num": "7OzVgiMM96", "enc_receiver_phone": "jotuKUMIdm", "enc_receiver_real_phone": "W51m30m7Nn", "lat": 0.7315495751314854, "lng": 0.24904410185871556, "location_address": "T1IwbLfjrv", "location_name": "EaujRpkKm9", "province": "0uYBIlFd0J", "receiver_name": "c0ObRDXtev", "receiver_phone": "Qio6MqhNET", "receiver_real_phone": "dnozTgdDoW", "secret_number": "OWR1woeFgs", "town": "yZqlfagFQN" }, "refund_infos": [ { "after_sale_id": "BirKQ2mC5S", "products_refund": [ { "attributes": [ { "name": "2x2qyvhkFq", "value": "TrjX5nSzN5" } ], "commodities": [ { "group_name": "fcgfhMNfYt", "item_list": [ { "attr_list": [ "iMYEyeC9ea" ], "attributes": [ { "name": "6J31XXTXsk", "value": "4CiEMTP2td" } ], "count": 5422296716807293000, "deduction_info_list": [ { "amount": 1502920930007366400, "certificate_id": 3142208806057123300, "deduction_type": 3764112127672604700, "serial_num": 1080726899495318900, "third_part_code": "M4MpD6Cm4Z", "verify_id": 7818258776849109000 } ], "desc": "v1AxyphdWG", "ingredients": [ { "count": 5093516984709471000, "name": "aPBSUd1F06", "out_id": "i8HL5B8yBX", "product_id": "6TYU0SaqRV" } ], "is_refunded": false, "item_tag": "ZM3b6EgB3J", "name": "QZHbW5bawd", "original_out_sku_id": "jubNHwz9IX", "original_price": 1101709700437419800, "original_sku_id": "MNtVC3l5c6", "out_id": "CujEbTD233", "out_sku_id": "NGjxMBSVxu", "price": 5447728504377525000, "product_id": "dCQdChsh6S", "sku_attr_list": [ { "attr_key": "Z88yyuVLyC", "attr_name": "PG2eLtT0HW", "group_key": "7hncB2axSw", "group_name": "w2oaCdV3Jk", "is_refunded": false, "num": 2942217810679443500, "out_id": "cfT85VPQ5y", "product_id": "7cj2Wh2BQx", "upgrade_price": 3642944818663778000 } ], "sku_id": "11cFvAIYeC", "specs": [ { "name": "pKRvVgUGIC", "out_sku_id": "kZajopUHpi", "sku_id": "nzikd9ZDIu", "value": "q9eLVfYZ0O", "value_metric": "tpQxHLCR1t", "value_type": 6330138044868894000 } ], "unit": "ZZjySOn5tS", "weight_count": 7272018691432686000, "weight_unit": "G0xy6XUKl4" } ], "option_count": 3629785778847618600, "total_count": 7599526169569665000 } ], "ingredients": [ { "count": 1303098680230779400, "name": "GwIm9I4aUR", "out_id": "8ECy5vOMCT", "product_id": "cFc6QIdq1F" } ], "num": 1526804363798929400, "order_item_id": "DvfXy1E3DI", "origin_amount": 992578600867710000, "out_id": "rHVUvkyBOD", "product_id": "eMAZ3RCPgR", "product_name": "edxKtephPs", "product_origin_amount": 9192912410809207000, "product_type": 4650378675555347000, "sku_id": "kCOXQ2DjmJ", "specs": [ { "name": "BoDwywrrHh", "out_sku_id": "DiRqk6oEs5", "sku_id": "JwHLiVjU1m", "value": "F37pGNAIPE", "value_metric": "pfuU1IQqQZ", "value_type": 8357217672105976000 } ] } ], "refund_complete_time": 7339818318801085000, "user_refund_amount": 8407698006674064000 } ], "return_info": { "details": [ { "after_sale_id": "fHPFex9nTm", "delivery_type": 1, "freight_amount": 8665862982860074000, "freight_payer": 1, "return_goods_service_order_id": "Zbk00EHDOj" } ] }, "sku_num": 7414205160956563000, "sku_type_num": 7967769401729407000, "sub_order_amount_infos": [ { "discount_amount": 4937557138416929000, "discounts": [ { "discount_amount": 7134547009784241000, "discount_subject": 1936278100740643600, "discount_type": 307675031926583040, "merchant_discount_amount": 2938321700567441400, "platform_discount_amount": 1323440196121552600 } ], "origin_amount": 4711305355156783000, "pay_amount": 4698509453614444000, "sub_order_id": "u8myHwAZSK", "sub_order_seq": "dQaqyXmR4b", "sub_order_type": 2087563202977967900 } ], "update_order_time": 6060208690491804000 } ], "page": { "page_num": 6777374120395111000, "page_size": 8233237077591095000, "total": 4718263581618608000 } }, "extra": { "description": "KNN4FIMURH", "error_code": 1176683164025567000, "logid": "FObprPev88", "now": 3218067580574278700, "sub_description": "UGKxywv1fy", "sub_error_code": 7397585094128188000 } }
切换单列布局错误码
| 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 | 以实际错误信息为准 |
