订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（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/?order_status=8012508899298315450&ext_order_id=xggWFDfuz3&get_secret_number=false&page_num=6394825945045418562&account_id=wAEH0Bd4Iz&open_id=qDgF9gArTS&update_order_end_time=692862622817131871&page_size=2127347721358481273&create_order_end_time=2266183452592336565&order_id=kPIeKL57gc&update_order_start_time=2467500456084193017&create_order_start_time=4610801926490285599' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
业务数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "page": { "page_num": 3960318626373912000, "page_size": 7275307480726401000, "total": 1283730141060827000 }, "orders": [ { "sku_id": "7lXy1ohAmW", "merchant_info": { "account_id": "M90h7aJN5Q", "account_name": "Xpw6LZ7Cnq" }, "certificate": [ { "order_item_id": "YHaFfLJMSe", "certificate_id": "fduJRNOQG8", "item_status": 160016093476956100, "item_update_time": 8569860587122187000, "refund_amount": 8685594386219543000, "refund_time": 7330052847927129000 } ], "update_order_time": 8818323590580255000, "payment_discount": 5718446041250289000, "count": 5344397591304300000, "dish_sku_num": 6287154085690195000, "sub_order_amount_infos": [ { "sub_order_type": 1559730944175869200, "sub_order_id": "Q44DSWu7Uq", "pay_amount": 7079270143495834000, "origin_amount": 6745223298083579000, "discount_amount": 7905516034132664000, "discounts": [ { "merchant_discount_amount": 7352712454109288000, "platform_discount_amount": 6293828044341540000, "discount_subject": 7342722580573970000, "discount_type": 7997461749232898000, "discount_amount": 1858018568474275000 } ], "sub_order_seq": "szzWNPBiTR" } ], "order_type": 9055021579183937000, "refund_infos": [ { "products_refund": [ { "origin_amount": 6415968456692410000, "product_type": 4715347287428008000, "product_origin_amount": 5638068886279878000, "attributes": [ { "name": "jL7ScdWMlJ", "value": "GJyRR0X9uz" } ], "order_item_id": "fewKN44Yid", "product_id": "XBc0P41jXR", "commodities": [ { "total_count": 7009737517330181000, "option_count": 4268568533499155000, "item_list": [ { "count": 3806953613295902700, "desc": "AZ2fVwOAYg", "weight_count": 7026274313889336000, "name": "MlUZffGbJy", "ingredients": [ { "count": 7685232505461780000, "out_id": "DP9pnozJ5Z", "product_id": "B5tyCkG1iw", "name": "VNZrGByqsw" } ], "out_id": "dVELU4egbU", "sku_id": "SNzfnEjcgR", "attr_list": [ "p66lASkkyG" ], "original_out_sku_id": "RBFbSBZrOM", "unit": "VFjjz7Avsq", "item_tag": "P2Z7oIwaE0", "sku_attr_list": [ { "upgrade_price": 8854784796243218000, "attr_key": "68NOJl2EZG", "group_name": "jUZ7ciOLgs", "num": 7528594797235564000, "product_id": "3hxiUMgJop", "out_id": "P9LYpb56w3", "group_key": "ky9APhC6pu", "is_refunded": false, "attr_name": "UBI8M5oGji" } ], "weight_unit": "ZqKeRQ5X3E", "attributes": [ { "name": "0G6xvH8QRf", "value": "08qn5wTE46" } ], "original_price": 7345633662283009000, "product_id": "WIICtc7Eff", "out_sku_id": "iF2V67gvP8", "price": 6941875006768167000, "is_refunded": false, "specs": [ { "value_type": 123722034833419060, "value_metric": "1MT8H3aKcx", "name": "3IdYJox4QT", "value": "8HVuWys92D", "sku_id": "nrzliBthpR", "out_sku_id": "GA6EqyApLt" } ], "deduction_info_list": [ { "verify_id": 1979009765147111000, "deduction_type": 4349703600206850600, "serial_num": 5157159271556307000, "certificate_id": 8356516976826555000, "amount": 7278807682375633000, "third_part_code": "Ed1eMximfX" } ], "original_sku_id": "c0Xk96Wd4r" } ], "group_name": "yreVrsE7WB" } ], "sku_id": "D12k86W3Uz", "ingredients": [ { "count": 6286950478632479000, "out_id": "eKKbrSTrUj", "product_id": "uT84MQ0GRb", "name": "Zrlp2hM2UK" } ], "product_name": "cI1M7zSyx3", "specs": [ { "value_metric": "QaELV0AueA", "name": "7PJvE93gWo", "value": "1cUGaAKYGB", "sku_id": "3vldbotZdU", "out_sku_id": "pY9eCPE05F", "value_type": 8940603921526270000 } ], "out_id": "ZodV7VzgrR", "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_max_amount": 2049885253762775600, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_start_time": "COgVjHcSqm", "use_end_time": "2WpD1UtL4l", "end_time_is_next_day": false }, "deductible_amount": 6057212105490868000 } ], "dynamic_par_rule_desc": "CB70cBOQII", "dynamic_par_min_amount": 4273408153918814000 } } }, "num": 1180775366933632000 } ], "after_sale_id": "YekZp91ynu", "refund_complete_time": 57320938796295010, "user_refund_amount": 449381815401059200 } ], "original_amount": 5570520132413822000, "products": [ { "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_max_amount": 1428137583286167000, "dynamic_par_rule_item_list": [ { "time_period": { "use_start_time": "XcdoqbvKK4", "use_end_time": "vanOa0l00n", "end_time_is_next_day": false }, "deductible_amount": 3843075260782886000, "day_of_week": [ 1 ] } ], "dynamic_par_rule_desc": "ARmuz1yntm", "dynamic_par_min_amount": 3625253743354258000 } } }, "product_type": 4979964292048768000, "order_item_id": "w4D3VO7Mlr", "out_id": "nDcN6RmUA2", "attributes": [ { "value": "ltoqKpup1S", "name": "vnLDyZdCha" } ], "commodities": [ { "group_name": "LWn27s3J8s", "total_count": 7277991923205763000, "option_count": 2747597843540790000, "item_list": [ { "out_sku_id": "fJaibroNpj", "original_out_sku_id": "bFXF47KJ8j", "attr_list": [ "Ps7aXUUGq4" ], "name": "9yFxok227Z", "sku_attr_list": [ { "group_name": "JJZolnWvs3", "attr_name": "dqV36bZ47L", "upgrade_price": 501215330908701000, "num": 7546026259572133000, "product_id": "PR8zo82Evr", "attr_key": "MKyNlteoEe", "is_refunded": false, "out_id": "r8KVfp7Qs0", "group_key": "5hFbZdc93j" } ], "item_tag": "T9F4lVcQPi", "weight_unit": "lA5INaXBrV", "count": 1385967963321108200, "attributes": [ { "name": "s3NGZyTRgd", "value": "1W3sGJUlDc" } ], "original_price": 1262176575725412000, "weight_count": 4377866781081569300, "price": 6485072355197672000, "out_id": "BAqkUOhAvi", "product_id": "C0GJq9ycNZ", "sku_id": "7Ksxokb6Cb", "unit": "e0AwfQHUiP", "original_sku_id": "CCbHLqf3UB", "specs": [ { "name": "2LzgZY1YtA", "value": "riQmKwyAtt", "sku_id": "6WIAvNxZEU", "out_sku_id": "IVkM0XetCO", "value_type": 594879546899052200, "value_metric": "P91Cs6vV2z" } ], "deduction_info_list": [ { "third_part_code": "ncIleIUraV", "verify_id": 2181741292762846200, "deduction_type": 2762188178828133400, "serial_num": 4617823169632937000, "certificate_id": 794629022652431000, "amount": 1060326216413461200 } ], "is_refunded": false, "ingredients": [ { "name": "7Y8F9Cytqx", "count": 7615650073068399000, "out_id": "WtzUr9B5aG", "product_id": "mkC61K9hCa" } ], "desc": "Tidj0gnFZC" } ] } ], "sku_id": "Wv2Uq9L9Ae", "specs": [ { "name": "QElaSmIdPo", "value": "IHrG6nmyPg", "sku_id": "g84GeCSk6Q", "out_sku_id": "iv38gKpeWq", "value_type": 7434377317483811000, "value_metric": "y1yPo6RMap" } ], "num": 3837494403980261400, "origin_amount": 8473952235635388000, "ingredients": [ { "count": 7734496773849818000, "out_id": "N6mtJMDUDi", "product_id": "RkFFTbHGlK", "name": "yTLZFBWplE" } ], "product_id": "Ukz4G8clL3", "product_name": "wJSH0KFOrS", "product_origin_amount": 5154551962738163000 } ], "delivery_info": { "user_expect_time": "kM1QKRaOW3", "is_book": false, "estimated_call_rider_time": 306637657248437570, "latest_start_cooking_time": 3487082084352445000, "table_ware": "Qt2L4mPwi3", "remark": "WvgfCccm7Y", "create_delivery_channel": 2644107846898133000, "shop_number": "quIhMXB2dZ", "deliver_model": 1199899193118799400, "estimated_finish_cooking_time": 6617554583767642000, "sys_expect_time": "2qY9Mbwg1K" }, "total_sku_type_num": 1330987495109630200, "create_order_time": 3055805932015895600, "third_sku_id": "RmxDXhxvb1", "sku_num": 5781912285589738000, "poi_id": "oNPHCNvRh9", "order_status": 179878924022829000, "buyer_info": { "buyer_phone": "rU4tVWftwO", "buyer_secret_number": "b67oPzVUu6", "buyer_real_phone": "452bc3qMk0", "enc_buyer_real_phone": "zZVJXN6XWn" }, "dish_sku_type_num": 2506874942822148000, "sku_type_num": 5273019390900391000, "discount_amount": 335962252966614460, "products_after_refund": [ { "sku_id": "tF6dY4SJ2T", "ingredients": [ { "product_id": "lgQCuMvhB8", "name": "a8v8RXj1et", "count": 2495641878657649700, "out_id": "MvgIDbHbJ0" } ], "product_id": "IWq3xX9yuw", "commodities": [ { "total_count": 4023543234722968000, "option_count": 944866574941391200, "item_list": [ { "count": 1177962288837027800, "attr_list": [ "CCVbzxXpop" ], "weight_unit": "8c3YCsLNxH", "out_id": "ee3sztVIaZ", "sku_attr_list": [ { "upgrade_price": 8407932352352128000, "attr_key": "8d18lth38c", "group_name": "A8b9DLJZdY", "is_refunded": false, "attr_name": "1R3tJqGC2d", "out_id": "WsbduZKmNO", "num": 3958743752831064600, "product_id": "qx1bVfaIdu", "group_key": "LuSI54Q6pS" } ], "item_tag": "BtWbuvSzlU", "product_id": "l0nkf4uVLs", "is_refunded": false, "original_price": 6495666514576674000, "out_sku_id": "loiizUcB8L", "original_sku_id": "lwKc81LSCq", "unit": "vztRPz5hct", "specs": [ { "value": "vCUfdKiZmY", "sku_id": "mme88AUWPB", "out_sku_id": "crTFqgBecT", "value_type": 2040663341929262600, "value_metric": "2Vp340fGxP", "name": "26UZHRMlWO" } ], "attributes": [ { "name": "S4mO5W9fB2", "value": "8f5qnobAF6" } ], "name": "hMyuNSdt2w", "desc": "0bOrxc1JH6", "deduction_info_list": [ { "verify_id": 4616167653457639000, "deduction_type": 2170738783887828000, "serial_num": 8785641900824254000, "certificate_id": 7416978303262773000, "amount": 5108599162544877000, "third_part_code": "zV3pPH6CEf" } ], "ingredients": [ { "count": 3598878893124964400, "out_id": "PIUmWtBPuV", "product_id": "BtbuxztxpD", "name": "Qo49PjwUwv" } ], "sku_id": "svlTBtb6d9", "original_out_sku_id": "t2VqgNWK4E", "price": 3927860953316910000, "weight_count": 3718771169710740000 } ], "group_name": "qmwone6YL6" } ], "origin_amount": 4337995121684922400, "product_origin_amount": 6747092307486379000, "attributes": [ { "name": "d6gmNMR0ra", "value": "MVM8j4wa6o" } ], "out_id": "9rNEscCieO", "num": 8281049333629861000, "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_max_amount": 2033733216111495700, "dynamic_par_rule_item_list": [ { "deductible_amount": 6316387308174379000, "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "pn42XAmfGe", "use_end_time": "be3ng2FUVO" } } ], "dynamic_par_rule_desc": "fpll80czsC", "dynamic_par_min_amount": 1344434392157109000 }, "voucher_par_type": 1 } }, "product_name": "2fHcsI55hF", "product_type": 4788804883147931000, "specs": [ { "name": "q5CYayPbUN", "value": "5UPpmEcnyx", "sku_id": "0CyRpWWBXS", "out_sku_id": "dy9dEkobKx", "value_type": 3461276212653159400, "value_metric": "AB2yJVknAa" } ], "order_item_id": "jGo0iVyVMl" } ], "receiver_info": { "location_name": "CHEEGyEBFz", "receiver_phone": "kOeYTUpVrv", "province": "2NJmkpr7HB", "enc_receiver_real_phone": "4oKHMuaMfg", "enc_receiver_phone": "fPs7GDLKZt", "lng": 0.17290289377587478, "town": "QRjURfacpS", "receiver_name": "AWH4iV92n7", "door_plate_num": "4r0WCiCjPr", "secret_number": "aVTl5JpaYD", "city": "C74ag8hcQb", "location_address": "T7beQrM5RV", "district": "HDButjIhTL", "receiver_real_phone": "XDxFyq07j7", "lat": 0.6920673709589096 }, "is_deliver_later": false, "total_sku_num": 4602851447695435000, "discounts": [ { "merchant_discount_amount": 493584968877423300, "platform_discount_amount": 3046706295557787600, "discount_subject": 7561681786078650000, "discount_type": 7140038557371414000, "discount_amount": 1622793077772167700 } ], "open_id": "4lii5IOiKt", "user_id": 5814348808881912000, "sku_name": "JZtxOv48wl", "modified_infos": { "modified_receiver_infos": [ { "modified_time": 2619158666413670400, "old_receiver_info": { "enc_receiver_phone": "jnUFdVAuJb", "receiver_phone": "dfP0NTGzPp", "receiver_name": "GVBrZdWqfH", "province": "zIkE1l35Xp", "district": "YOY6LMJssM", "lng": 0.19742150659283847, "town": "AixO1IC2SC", "location_address": "HqYYrz58R6", "city": "gu5jEAw49A", "secret_number": "BIClRy5Ee6", "door_plate_num": "FOSYOebfE6", "receiver_real_phone": "qX0TyFDEzn", "enc_receiver_real_phone": "xKBtC3hAaY", "lat": 0.6428233874497938, "location_name": "daWg0OrN0o" } } ], "modified_book_infos": [ { "modified_time": 6378670230772120000, "old_book_info": { "shop_number": "u38WMZQkwf", "is_book": false } } ] }, "is_multi_order": false, "pay_time": 4729941954019483000, "pay_amount": 3726004858169403000, "contacts": [ { "phone_encrypt": "Noo2iO9eFW", "name": "IsLWRv41zv", "phone": "cq7Sqc6E98" } ], "order_id": "t7WlgvrM07", "amount_info": { "commission_amount": 3118257825297801700, "platform_deliver_freight_fee": 286187954922021280, "merchant_deliver_freight_fee": 6387559868463534000, "packing_price": 3679435789372377000, "sale_price": 4541721602954724000, "discount_amount": 7292466807878216000, "pay_discount_amount": 4467424237899007000, "origin_amount": 3498741707518321700, "discounts": [ { "discount_type": 731594891981649000, "discount_amount": 5124577359958255000, "merchant_discount_amount": 2807497942224229000, "platform_discount_amount": 6214910304421365000, "discount_subject": 4683529237085641000 } ], "other_fee_amount": 6729011594331729000, "activities_fee_amount": 3861536381339440000, "deduction_info_list": [ { "certificate_id": 3593550287731888000, "serial_num": 4951473391224542000, "sale_price": 4253222926498701300, "pay_amount": 2635070075202819600, "deduction_amount": 4532372511546489300, "deduction_type": 1, "pay_discount_amount": 5101895896130384000, "merchant_discount_amount": 214562147659496220, "platform_discount_amount": 1156664577993088500 } ], "estimated_order_income": 1812401475133589200, "freight_actual_pay_amount": 5174368514718649000, "pay_amount": 3365738712417054000, "merchant_discount_amount": 4652076245020129000, "platform_discount_amount": 2402857966078151000, "product_origin_amount": 6654541814524307000, "freight_pay_amount": 7213961867412099000 }, "poi": { "poi_id": "7dDxIaovyJ", "poi_name": "ibnmlkTB82" }, "degradation_status": { "is_degraded": false, "affected_scopes": [ { "param_name": "4Pn87a7HpF", "param_type": 1 } ], "current_level": 1 } } ], "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "2026091416415765AFA6B0BD8EB8992D46", "now": 1789375319 } }
切换单列布局错误码
| 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 | 以实际错误信息为准 |
