订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（1）根据订单 id ，查询对应订单详情，入参：订单 id；
（2）根据订单状态和商户 id，查询指定时间内该商户下的订单列表，入参：商家id、订单状态、创单起止时间/修改起止时间；
（3）根据用户 id 和商户 id，查询某用户在该商户下的所有订单，入参：商家id、用户 id、创单起止时间/修改起止时间；
- 支付后未发码/发码失败订单查询方式：限定订单状态为“已支付”，如用户下单后超过 10 分钟未发码会发起退款；
- 退款申请待审核订单查询方式：限定券状态为“退款中”，如退款状态未响应超过 72 小时会自动退款。
- 金额计算公式：
- 原始金额 - 折扣金额（优惠金额） = 实付金额 original_amount - discount_amount = pay_amount
- 原始金额 = 各子单原始金额之和 （子单包含商品、配送费等）
基本信息
| 名称 | 描述 |
|---|---|
| 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
页面大小 默认10 最大200
update_order_end_timeInt64
修改起始时间 秒时间戳
update_order_start_timeInt64
修改起始时间 秒时间戳
请求示例
curl --location --request GET 'https://open.douyin.com/goodlife/v1/hermes/trade/order/query/?page_size=3368715698087456666&open_id=TmXzE14bhl&order_status=5524794195097881762&get_secret_number=false&create_order_start_time=194029823983757110&ext_order_id=YGfDPEJCU5&create_order_end_time=3793378503731988545&update_order_end_time=6894852461881954308&update_order_start_time=7504469266900295107&page_num=4664362121706330569&order_id=dRmUlPa0S2&account_id=dMmJdW9aso' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
业务数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "orders": [ { "pay_amount": 7127283120725208000, "order_id": "cxlvN0UmwH", "contacts": [ { "phone": "yvuJmDpNuS", "phone_encrypt": "MFXjWCZF1Z", "name": "ed0whdWu4k" } ], "pay_time": 4365833544790120400, "sku_name": "Y71RDZX77b", "open_id": "ZD1B3UOfWM", "poi": { "poi_id": "wq1wIrx9g2", "poi_name": "FyAhPNaRr0" }, "order_status": 3031793184263792000, "count": 791585944963132700, "sku_id": "odALQbdrGw", "sub_order_amount_infos": [ { "sub_order_type": 4914822267556398000, "sub_order_id": "Sgz6e7kleL", "pay_amount": 7081008128851234000, "origin_amount": 4722750099388829000, "discount_amount": 3147955359834187000, "discounts": [ { "discount_amount": 7644911463364867000, "merchant_discount_amount": 9182189900158709000, "platform_discount_amount": 6637339953262325000, "discount_type": 1194663784732075800 } ] } ], "products_after_refund": [ { "product_name": "sinAQgo3BA", "out_id": "g1jpwL5eBl", "ingredients": [ { "count": 1032573245922869500, "out_id": "HZ3tQyAgEG", "product_id": "SwGJRpaTFi", "name": "2SWnQaAMau" } ], "sku_id": "KecHxH46GJ", "attributes": [ { "name": "9i1Y4WTFHy", "value": "r9L5WOXo4D" } ], "product_type": 1833521031985532700, "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_desc": "j99lSWmW1N", "dynamic_par_min_amount": 6480316983276983000, "dynamic_par_max_amount": 9124799418805025000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_start_time": "aKNS1IU0pv", "use_end_time": "CGOPzkEnbK", "end_time_is_next_day": false }, "deductible_amount": 6416767672580312000 } ] } } }, "product_origin_amount": 4794832083074131000, "origin_amount": 2174376342487127600, "num": 1819876737755524900, "product_id": "dadF8k0zcI", "specs": [ { "value": "iOUbLdICOt", "sku_id": "BQSET8ZwxA", "out_sku_id": "N5RliZxLBN", "value_type": 4347785956090700000, "value_metric": "l5Nfxk7PD7", "name": "QAmv5IhIdo" } ], "commodities": [ { "total_count": 3790649324150274600, "option_count": 6019910062045054000, "item_list": [ { "count": 3589075344945138700, "sku_attr_list": [ { "attr_name": "jEFu4DfJp1", "num": 8903557419125481000, "product_id": "RLvaA1OPp4", "out_id": "PIgtVbywtp", "upgrade_price": 56397774050426550 } ], "unit": "AmOm4lDfHO", "weight_count": 7657975894002477000, "attributes": [ { "name": "lOyFSajrQz", "value": "6cyoEMFvdi" } ], "original_sku_id": "Q6u6OCgmat", "sku_id": "h9jIESCjea", "item_tag": "QemNHguSof", "deduction_info_list": [ { "certificate_id": 1528707115724741600, "amount": 6762689022947186000, "third_part_code": "EJLEb4nxox" } ], "price": 920310832478173700, "ingredients": [ { "name": "ATseBCngdO", "count": 961062016990651500, "out_id": "6Jac1sLChU", "product_id": "q7rePLaqre" } ], "original_price": 3743923509618852400, "name": "rWjPL6xFQI", "attr_list": [ "DPp4i24HgY" ], "product_id": "nSPmqsIpdE", "weight_unit": "8zhWU2gQdt", "desc": "1l2iY4ThJs", "out_sku_id": "Zp84SmbnMW", "out_id": "y2RIVVvJCZ", "specs": [ { "value_type": 4920739546498146000, "value_metric": "oHvK6Y50qZ", "name": "uZSXna2GRD", "value": "EGoivprNba", "sku_id": "J6GUf57bXP", "out_sku_id": "8bCzvtrg0M" } ], "original_out_sku_id": "BVZmDVTn88" } ], "group_name": "aOtOD7M8Sp" } ] } ], "merchant_info": { "account_name": "2mmNXviC7F", "account_id": "S793smaRFg" }, "total_sku_num": 7468106872910771000, "refund_infos": [ { "products_refund": [ { "num": 4806184189697916000, "attributes": [ { "value": "JGd2yc4zDy", "name": "FaT9hNw6Ul" } ], "product_type": 3849058828209598500, "ingredients": [ { "product_id": "TIJoyYC6lv", "name": "CcwoZtTF2i", "count": 9000842694822529000, "out_id": "q1TWOutMoo" } ], "commodities": [ { "option_count": 4735864875494206000, "item_list": [ { "desc": "iQS6mj6UFc", "sku_id": "G2liDR4aRm", "original_sku_id": "gBxjVBytXY", "weight_unit": "AyhAiTgNCQ", "unit": "geerNNijzq", "product_id": "bcuE86S4KX", "item_tag": "GK6PMCnbiE", "out_sku_id": "bqV8klzVr1", "original_out_sku_id": "ydPuj99y7o", "specs": [ { "value": "oKbX6pCCSX", "sku_id": "boKMWaQqQT", "out_sku_id": "mNj8fr7OWI", "value_type": 4228978119972633600, "value_metric": "AGSDSgIL9w", "name": "QZ2Rkr24JI" } ], "name": "EciMETpmq7", "ingredients": [ { "name": "rIHDBkCei1", "count": 5619388121246647000, "out_id": "Br5Ty6fvkr", "product_id": "7azSKdpE9U" } ], "attributes": [ { "value": "hrlyN9wdUy", "name": "0OWc0VDNmA" } ], "attr_list": [ "BwIlozkRh9" ], "weight_count": 5370646048260800000, "out_id": "L44FLX23fZ", "count": 685475269755118200, "price": 6778554840861956000, "sku_attr_list": [ { "attr_name": "JwOL1hIHpD", "num": 4154906639024837000, "product_id": "vpQQsSp5rv", "out_id": "xF4W0MFUGh", "upgrade_price": 7341369941471117000 } ], "original_price": 1727090086322058000, "deduction_info_list": [ { "amount": 2136769938720524300, "third_part_code": "ZVLA9P9nO0", "certificate_id": 3595915714410969000 } ] } ], "group_name": "LLupYxNxvj", "total_count": 8553219545113025000 } ], "product_origin_amount": 4728176823057822000, "origin_amount": 2338558263199922000, "specs": [ { "name": "J3HSS7IAdu", "value": "ejKer4la8h", "sku_id": "SnF46fGj6F", "out_sku_id": "RLtDxtGIJp", "value_type": 6134673787018078000, "value_metric": "kDqNfvhSaN" } ], "sku_id": "aLSnR6Do6j", "out_id": "wToGhBhWm3", "product_name": "9Dja1F1trw", "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": "oXz25EpAZe", "use_end_time": "X7aUItgtNO" }, "deductible_amount": 6905801367719740000 } ], "dynamic_par_rule_desc": "sJ7wisScL8", "dynamic_par_min_amount": 7054874254148881000, "dynamic_par_max_amount": 7198455670839239000 } } }, "product_id": "Z2GdMys8VW" } ], "after_sale_id": "gnClkj3OKI", "refund_complete_time": 4686477512143938000, "user_refund_amount": 1711584051559830300 } ], "total_sku_type_num": 2743315083737838000, "payment_discount": 1395485380940754700, "buyer_info": { "buyer_real_phone": "rzunenBqyP", "buyer_phone": "GcloTTbuq1", "buyer_secret_number": "U7FUXXJjyE" }, "delivery_info": { "shop_number": "oTC4OybryH", "is_book": false, "user_expect_time": "8wPTVBhWNY", "sys_expect_time": "cp0cE7GVby", "remark": "tWkXAFjRXb", "table_ware": "LzeuzAfZKb", "deliver_model": 5548794267050627000 }, "third_sku_id": "iFc5569x1p", "update_order_time": 3364957065286221000, "is_multi_order": false, "user_id": 9007677497308690000, "original_amount": 6643716147006372000, "discounts": [ { "merchant_discount_amount": 6506929474918991000, "platform_discount_amount": 4281752426405238000, "discount_type": 2765846842924913700, "discount_amount": 4599573812270483000 } ], "sku_num": 972390202585170300, "dish_sku_type_num": 8404287739437206000, "poi_id": "iCdNVhEoGe", "sku_type_num": 765540553800337300, "amount_info": { "platform_discount_amount": 1478505528834094300, "sale_price": 3292327609267127300, "origin_amount": 8042143560717720000, "estimated_order_income": 8167927119983593000, "freight_pay_amount": 6462454868966754000, "merchant_deliver_freight_fee": 5369209922307371000, "platform_deliver_freight_fee": 4239950274733168000, "activities_fee_amount": 3762383054650362000, "packing_price": 7570443327900121000, "discount_amount": 3367549548495148500, "pay_amount": 8963910579946612000, "other_fee_amount": 355884572716779140, "commission_amount": 3231628801499669500, "freight_actual_pay_amount": 2603224307306912300, "product_origin_amount": 430925329455521660, "discounts": [ { "discount_type": 6646699504788128000, "discount_amount": 4279590410103720000, "merchant_discount_amount": 8122002535095784000, "platform_discount_amount": 2563858770256912400 } ], "pay_discount_amount": 6990772111683785000, "merchant_discount_amount": 2896898176884422000 }, "certificate": [ { "item_status": 4714874755407573000, "item_update_time": 7037451543486621000, "refund_amount": 8375992777234970000, "refund_time": 5301351493726866000, "order_item_id": "8mKtmcXoIZ", "certificate_id": "oUTi9JIuTG" } ], "receiver_info": { "secret_number": "udd44Kzw8R", "town": "FfB4JOdM92", "lng": 0.36541508526634625, "city": "ATQdMfz8pp", "province": "1RXaz5hsYb", "door_plate_num": "E9VS0ZmH0J", "location_name": "f94faE5B7g", "receiver_phone": "S4ZhAGxxoi", "receiver_real_phone": "niXW1zGUE3", "location_address": "MYkuBxP4M6", "receiver_name": "v7h4VF3mCY", "district": "xZ1Fi2DYuE", "lat": 0.30862222072065587 }, "discount_amount": 1733119923947133700, "products": [ { "out_id": "9F6h4Me9b3", "origin_amount": 69859499849782820, "product_origin_amount": 5415226898509167000, "product_id": "DmWQX6xD8l", "product_name": "55JUSM9cG1", "sku_id": "PrQfnSYo6P", "specs": [ { "value_type": 4208623004002082000, "value_metric": "I9BvMwD3nK", "name": "88QOukebxT", "value": "BatKNZ1s9i", "sku_id": "bLh3pWsQtN", "out_sku_id": "iBnZW6Ez4S" } ], "commodities": [ { "total_count": 1375369948945333500, "option_count": 8885688263267345000, "item_list": [ { "original_out_sku_id": "EB2Np60P2L", "count": 8810817788330976000, "deduction_info_list": [ { "third_part_code": "j0AUTq3nnn", "certificate_id": 2010603562237298700, "amount": 5320411737167827000 } ], "specs": [ { "value_metric": "pGY0ouDdPd", "name": "28FldS3DEB", "value": "sKcuXiVd7w", "sku_id": "29EWj0sD2B", "out_sku_id": "tvDnH6Bnuo", "value_type": 6810407044277379000 } ], "weight_unit": "WI5kXu0kwj", "original_sku_id": "CN952TYgJE", "weight_count": 4473358922349559300, "original_price": 8408667555677128000, "ingredients": [ { "out_id": "PyYqsBRGdk", "product_id": "zBJhj2nuKh", "name": "l7iQ8Nfuwf", "count": 3021259540745263000 } ], "out_sku_id": "4sx5udFENO", "unit": "Cgl4reR1Px", "out_id": "A7QCPZ1UBl", "desc": "Qm0SaiE833", "item_tag": "aCBEHWP5BW", "price": 815283806363632500, "attr_list": [ "wA4gFGecAN" ], "name": "aUV9ys9N1B", "attributes": [ { "name": "kPaC0YCqsK", "value": "du2AbqF4e6" } ], "sku_id": "oTm95AkMBp", "product_id": "ED2R8fpJEJ", "sku_attr_list": [ { "product_id": "7sxhVxnnYW", "out_id": "hIamjIFBJo", "upgrade_price": 3752175759349269000, "attr_name": "z6KmhISBfL", "num": 7648566783542092000 } ] } ], "group_name": "AURDE4YTTW" } ], "attributes": [ { "name": "bEI3vHi6J1", "value": "DfuKXQ318I" } ], "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_max_amount": 8899206015209782000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "5OJucMSzSF", "use_end_time": "WzpTeiOvTR" }, "deductible_amount": 7336762151985718000 } ], "dynamic_par_rule_desc": "PpBnuqBG7t", "dynamic_par_min_amount": 8863435537864080000 } } }, "num": 6877211118622512000, "product_type": 7802563630722769000, "ingredients": [ { "product_id": "2UqCCky2p9", "name": "7GJ3Q7geRM", "count": 6541257824931063000, "out_id": "yfvEl7k09G" } ] } ], "is_deliver_later": false, "dish_sku_num": 9076497513403240000, "order_type": 5127556149817402000, "create_order_time": 1789969596702119200 } ], "page": { "page_num": 6210838049237751000, "page_size": 7874015993764506000, "total": 3626802266814996000 }, "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20250402115735E47F11D60BCA1125A24B", "now": 1743566256 } }
切换单列布局错误码
| 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 | 以实际错误信息为准 |
