订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（1）根据订单 id ，查询对应订单详情，入参：订单 id；
（2）根据订单状态和商户 id，查询指定时间内该商户下的订单列表，入参：商家id、订单状态、创单起止时间/修改起止时间；
（3）根据用户 id 和商户 id，查询某用户在该商户下的所有订单，入参：商家id、用户 id、创单起止时间/修改起止时间；
- 支付后未发码/发码失败订单查询方式：限定订单状态为“已支付”，如用户下单后超过 10 分钟未发码会发起退款；
- 退款申请待审核订单查询方式：限定券状态为“退款中”，如退款状态未响应超过 72 小时会自动退款。
- 金额计算公式：
- 原始金额 - 折扣金额（优惠金额） = 实付金额 original_amount - discount_amount = pay_amount
- 原始金额 = 各子单原始金额之和 （子单包含商品、配送费等）
使用限制
page_size和page_num必填，否则不返回内容
SLA：支持的最大QPS:10;基本信息
| 名称 | 描述 |
|---|---|
| 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/?create_order_start_time=536300089217219127&create_order_end_time=7351579416402265396&page_size=3344187815744387354&page_num=7668951882173368192&update_order_end_time=736902522976312047&account_id=Ackiytf9Ob&order_id=aEFWd0T9gR&open_id=CDKt5tvStq&ext_order_id=t7Vb2RZMVV&update_order_start_time=6907174190129993722&get_secret_number=false&order_status=8677675936585530214' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
业务数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "orders": [ { "modified_infos": { "modified_receiver_infos": [ { "modified_time": 568475786368640960, "old_receiver_info": { "secret_number": "G9dwZqVbQZ", "receiver_phone": "TbpaLQGJEt", "location_address": "TETuAYUwZi", "receiver_real_phone": "w71yS8cV7r", "province": "MfcF7OrQuE", "city": "kTla2Ql6eQ", "door_plate_num": "tvPcy4wPQ5", "town": "e6Pwtogp5b", "receiver_name": "tnx2ffO2h5", "lat": 0.1831959926268388, "location_name": "joEqmvE2Lk", "district": "czVKgsaFqZ", "lng": 0.20516274591263298 } } ], "modified_book_infos": [ { "modified_time": 203382326689869660, "old_book_info": { "shop_number": "otj8xvz5r7", "is_book": false } } ] }, "discount_amount": 1807485335439860500, "delivery_info": { "table_ware": "ZgF2AeI0bl", "deliver_model": 8410334581107518000, "shop_number": "6EHWnmgTpT", "is_book": false, "user_expect_time": "LgYGnLxzFO", "sys_expect_time": "eJy0MYUnf3", "remark": "oNn9R9F1xQ" }, "payment_discount": 2271808541308072000, "sub_order_amount_infos": [ { "pay_amount": 4744210372726247000, "origin_amount": 238415530844030600, "discount_amount": 7950455672931739000, "discounts": [ { "platform_discount_amount": 8916719624985588000, "discount_subject": 4603781871984603000, "discount_type": 2651345030413073400, "discount_amount": 1291651716889226500, "merchant_discount_amount": 3126759751785940000 } ], "sub_order_type": 1157633608987416300, "sub_order_id": "Tl00bvIE4K" } ], "total_sku_type_num": 3689942281373077000, "original_amount": 6300808697396654000, "receiver_info": { "district": "xBShcsMBPb", "door_plate_num": "3ELjPAN4Qj", "secret_number": "Nm9dKEHcw6", "location_address": "q3G6JhCx1i", "receiver_phone": "y0eQImbXFw", "province": "f3kCN4Py3d", "city": "fluCU8GAnG", "receiver_name": "HO7hNyaq1k", "lat": 0.906486008292223, "location_name": "9esjpjvHcZ", "lng": 0.22989603813661605, "town": "3iJJ4iJ6Z4", "receiver_real_phone": "fXwJXRR57h" }, "total_sku_num": 7454840641738109000, "dish_sku_num": 3665150673716118000, "create_order_time": 1121169017311804300, "poi": { "poi_id": "1Eps2gfUUm", "poi_name": "bIfHlH240j" }, "order_id": "kkc3mGXy9y", "update_order_time": 7603353924512595000, "certificate": [ { "certificate_id": "98XSvjawnm", "item_status": 7746262877640732000, "item_update_time": 8365771400441402000, "refund_amount": 8512458215147904000, "refund_time": 1314668909299507200, "order_item_id": "PhDhSUUInN" } ], "poi_id": "s92TNokso3", "dish_sku_type_num": 3343737406222567000, "products_after_refund": [ { "attributes": [ { "name": "OEbpUtllKL", "value": "k5lLCKzq5F" } ], "product_type": 333965693252818000, "ingredients": [ { "product_id": "vCIqNcHvEZ", "name": "qJrhEKRLM9", "count": 377747436452135100, "out_id": "OCxg7cAT9d" } ], "product_id": "mw40zw8GuB", "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_min_amount": 5013401981342703000, "dynamic_par_max_amount": 5228003166662703000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_end_time": "xd0tzmOxKp", "end_time_is_next_day": false, "use_start_time": "ahWyCFWDpY" }, "deductible_amount": 2973507351392232000 } ], "dynamic_par_rule_desc": "9emsdqgjyg" }, "voucher_par_type": 1 } }, "product_origin_amount": 6779614091564886000, "specs": [ { "name": "71f4H5dJ3W", "value": "xjhmLFygvI", "sku_id": "tK66oVwcJq", "out_sku_id": "ytcJDaXxAU", "value_type": 3662629553482893000, "value_metric": "a9p7n8GCUn" } ], "out_id": "SHPuz3HvNf", "sku_id": "vnTJwi89MM", "num": 918524007665192600, "product_name": "gZLqojmnay", "origin_amount": 3610410968745395000, "commodities": [ { "group_name": "Ei9wYMTvHL", "total_count": 2600525588406609000, "option_count": 7156593022751205000, "item_list": [ { "out_id": "Q2F6orTbPg", "name": "5Yee3fpbt7", "weight_unit": "gVCs5xhZt9", "count": 6608445226448465000, "attributes": [ { "name": "X1MQewcCBC", "value": "cmFnpSjsd1" } ], "original_out_sku_id": "KXG79qh1m6", "weight_count": 8250844998260664000, "specs": [ { "value_type": 5472221453272030000, "value_metric": "UA2StjKH1D", "name": "9lsbZnT8lM", "value": "DaA7jqNnqq", "sku_id": "7LdabGlQ8B", "out_sku_id": "RS78mm97x8" } ], "original_sku_id": "QNanUfHRd3", "sku_id": "ZLnq3Zdboc", "attr_list": [ "MyvHFfYlpE" ], "product_id": "d0N6vZKyWD", "unit": "oXnJ6Ow6wZ", "deduction_info_list": [ { "verify_id": 8772207800303353000, "certificate_id": 3833816217467784000, "amount": 8691714666548749000, "third_part_code": "NF56tUB3em" } ], "original_price": 7424717897810866000, "sku_attr_list": [ { "attr_key": "pymq0ZXSwd", "group_name": "vFh7RDCHsE", "group_key": "zuF7BwFx3T", "attr_name": "KW1Z3saGyA", "num": 1380573146141360600, "product_id": "Md83FyAr0H", "out_id": "h9xw9ttqNM", "upgrade_price": 6559908869999356000 } ], "item_tag": "XNTLPLQxLj", "out_sku_id": "tXuJCBRocN", "desc": "q1fCbZDXUq", "price": 6107550452664547000, "ingredients": [ { "product_id": "faIGFyAKFb", "name": "VzG9edmnB6", "count": 7671231490870612000, "out_id": "YEZ4nJKdZt" } ] } ] } ] } ], "sku_id": "QGrQZluoF0", "contacts": [ { "name": "PNJ6VdM1Oj", "phone": "USmzyZkji9", "phone_encrypt": "jvB2HgMEhK" } ], "degradation_status": { "current_level": 1, "is_degraded": false, "affected_scopes": [ { "param_name": "dMp3Nd1GvS", "param_type": 1 } ] }, "order_status": 8840526149768911000, "refund_infos": [ { "refund_complete_time": 695479751111911300, "user_refund_amount": 6549525992364225000, "products_refund": [ { "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": "KgkbbjFKhK", "use_end_time": "djsuyCpKit" }, "deductible_amount": 8369700467890125000, "day_of_week": [ 1 ] } ], "dynamic_par_rule_desc": "n3zIfczfjC", "dynamic_par_min_amount": 3802519227573210000, "dynamic_par_max_amount": 2068472307316765200 } } }, "ingredients": [ { "out_id": "ICuSZdQd9K", "product_id": "AlbGbyOTAZ", "name": "J5IIm4rPy0", "count": 7069976325567540000 } ], "attributes": [ { "name": "G2sopl9d3J", "value": "4saRSZA5k9" } ], "product_origin_amount": 7949393661355427000, "product_type": 4112347322619066000, "origin_amount": 7606840665174618000, "sku_id": "5jHOCcVylT", "specs": [ { "name": "pk1WA34gfV", "value": "b7Ts9v7uwy", "sku_id": "HPIYrmim5w", "out_sku_id": "CE70LiinFN", "value_type": 3284553115689851000, "value_metric": "fDgvYV6dTz" } ], "product_name": "Ff8ZnbZyRQ", "num": 146255046927590850, "commodities": [ { "item_list": [ { "sku_attr_list": [ { "out_id": "jrGiP2Usug", "upgrade_price": 5826499432758861000, "attr_key": "fvWS1HfRt9", "group_name": "nxMIJKsMiO", "group_key": "xt8N2aAkOt", "attr_name": "hXUHPoQhal", "num": 3781456350091362000, "product_id": "34JVp1hXnI" } ], "original_sku_id": "oDI4XI2PqH", "desc": "Tau302WMOG", "ingredients": [ { "product_id": "GHKFK1zIQp", "name": "3Z20G1hVB3", "count": 7143301795934245000, "out_id": "wzHBH1V6lw" } ], "weight_count": 655077596699167600, "original_price": 517296096893881860, "product_id": "hCFP0rzXcI", "out_sku_id": "NRdDKdFiEj", "unit": "YUEEcPp6KD", "name": "ODkHI1yBTg", "price": 6669141802486001000, "specs": [ { "sku_id": "BeJaPAibn2", "out_sku_id": "PVTCiuHjuK", "value_type": 5668169850155792000, "value_metric": "Do6HMGrcHC", "name": "lfOlQQ677l", "value": "F6HWObhLFK" } ], "attr_list": [ "vHEdD4YEXF" ], "out_id": "RDyaZHn1BK", "item_tag": "M86OFQXRba", "count": 939938743763661600, "sku_id": "DJ3n9TsRKI", "weight_unit": "wOzHxgoxYc", "attributes": [ { "name": "Za8wIXrZAx", "value": "k3uGmpJpCd" } ], "original_out_sku_id": "nZyxJmuXgX", "deduction_info_list": [ { "verify_id": 6980807861221293000, "certificate_id": 5878045984769780000, "amount": 5632028178333087000, "third_part_code": "clBigg8FFb" } ] } ], "group_name": "yAgJ8Q6cHI", "total_count": 5988559837071406000, "option_count": 5865570523307703000 } ], "out_id": "UAlje8sujy", "product_id": "QrXAs7a0hc" } ], "after_sale_id": "7wTqMhHVcw" } ], "open_id": "YGO0v5St4Y", "user_id": 1925879277971847000, "order_type": 974266456151200500, "is_deliver_later": false, "pay_amount": 8427214179746511000, "sku_name": "evGOKj4qZu", "sku_num": 5028743161693407000, "is_multi_order": false, "pay_time": 6163589146600504000, "products": [ { "num": 4206726770656017400, "commodities": [ { "item_list": [ { "weight_unit": "EB0KdOLwMr", "original_out_sku_id": "sL7vItwyrP", "attr_list": [ "xpN26CVHU5" ], "product_id": "39P2i7KFfe", "price": 4506752120286670000, "ingredients": [ { "name": "wHT4lWSalH", "count": 4503338004428509700, "out_id": "wa4nGiiFLZ", "product_id": "zxZT7GvH2v" } ], "sku_attr_list": [ { "group_key": "mZkeTjrPhC", "attr_name": "IFH9Ek5qBK", "num": 2211601539225621000, "product_id": "rnvFIVFeOD", "out_id": "hkMjShEPMv", "upgrade_price": 8803398156015138000, "attr_key": "uxXbFFtg43", "group_name": "kznbCg2at0" } ], "count": 8804035918611512000, "desc": "5oPjZVAEIe", "item_tag": "w5buRKchci", "weight_count": 1114064900095249700, "deduction_info_list": [ { "certificate_id": 7132620869059863000, "amount": 185854489682213730, "third_part_code": "fgAFurLC6P", "verify_id": 1734041957246547500 } ], "original_price": 6775320313018752000, "out_sku_id": "panGybxvGD", "out_id": "UI5C2Qk8t2", "sku_id": "Rt73EqKxX6", "specs": [ { "name": "uCtlHLWD3C", "value": "kltjehcuSF", "sku_id": "o8vSNOJ6aR", "out_sku_id": "NbBdscrLbU", "value_type": 4311396937261777400, "value_metric": "Pl2uMKoJh3" } ], "attributes": [ { "name": "JatIySpcYN", "value": "F9WCbJgHCL" } ], "name": "Mw9BbMOo9E", "unit": "zVPORscszR", "original_sku_id": "cyNjs4hMSc" } ], "group_name": "MHk6t2JwkF", "total_count": 7200512358935064000, "option_count": 8647172907286718000 } ], "ingredients": [ { "count": 7448702397256348000, "out_id": "eOnQvd3MQc", "product_id": "qXE4n7fgDH", "name": "0mkKznm788" } ], "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_rule_desc": "xBJcaWafCa", "dynamic_par_min_amount": 6741149306222872000, "dynamic_par_max_amount": 5310774930289990000, "dynamic_par_rule_item_list": [ { "deductible_amount": 7168962552595913000, "day_of_week": [ 1 ], "time_period": { "use_start_time": "uierhq6t1b", "use_end_time": "wm4VFKkWFZ", "end_time_is_next_day": false } } ] }, "voucher_par_type": 1 } }, "attributes": [ { "name": "egRRWft3Tx", "value": "TVywbgBSbP" } ], "product_type": 3814728657517331500, "sku_id": "BNsuQshEmf", "product_name": "5t4YDlGxO2", "origin_amount": 4418493417557554000, "out_id": "wgrva5oxQv", "product_origin_amount": 6282398932118557000, "specs": [ { "out_sku_id": "9tXaMQMtaT", "value_type": 4678882463766722000, "value_metric": "C7gZ61vDfI", "name": "w20TgGmKzg", "value": "znjZVWlVl2", "sku_id": "faUZo1oF69" } ], "product_id": "N5dNQ8eP7A" } ], "discounts": [ { "platform_discount_amount": 9144751225112535000, "discount_subject": 8708821924523129000, "discount_type": 164004910873754050, "discount_amount": 7317410152804173000, "merchant_discount_amount": 2137721593786379300 } ], "third_sku_id": "GhHKL5JUez", "merchant_info": { "account_id": "2ORjU0s3mQ", "account_name": "H1ivcbSfp4" }, "count": 9165845625465339000, "amount_info": { "activities_fee_amount": 8619830889583416000, "merchant_discount_amount": 7493865382206452000, "discounts": [ { "discount_subject": 4550631232167726600, "discount_type": 6603962944854579000, "discount_amount": 2167419585805340700, "merchant_discount_amount": 6190361561153062000, "platform_discount_amount": 3991952417832513000 } ], "origin_amount": 333870861841402750, "pay_discount_amount": 7480044426677986000, "freight_actual_pay_amount": 2498120183922869000, "estimated_order_income": 9221532067615683000, "pay_amount": 2070759010323853600, "platform_discount_amount": 7513381211233827000, "packing_price": 4714377341543997000, "other_fee_amount": 8959326752235600000, "discount_amount": 2187044164571803600, "deduction_info_list": [ { "deduction_amount": 1196488239328865500, "deduction_type": 1, "serial_num": 8173293851638221000, "sale_price": 4515409126569033700, "merchant_discount_amount": 7617571383605713000, "pay_discount_amount": 1637045039968802300, "certificate_id": 3164336187290124300, "pay_amount": 4450554422755242500, "platform_discount_amount": 6133102396832081000 } ], "platform_deliver_freight_fee": 2678812656542012400, "product_origin_amount": 3651240327518105000, "commission_amount": 8585847289762114000, "freight_pay_amount": 3405507469556063700, "merchant_deliver_freight_fee": 2367457050752662500, "sale_price": 5420596063094510000 }, "buyer_info": { "buyer_phone": "oaOr0aifJG", "buyer_secret_number": "9xz71SkTzs", "buyer_real_phone": "seqfI1HKBz" }, "sku_type_num": 4309724939974831600 } ], "page": { "page_num": 1438625105444328400, "page_size": 8341452572331111000, "total": 842853919664650900 }, "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "2025092520422133CCA1BCD4AA41A8D3FB", "now": 1758804149 } }
切换单列布局错误码
| 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 | 服务器打瞌睡了，请稍后再试。 |
