订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（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/?account_id=CXXjpX4GGV&update_order_start_time=5655374673510001509&ext_order_id=gQW2SL3xvC&create_order_start_time=2565355462743213518&page_size=4365713959166438231&order_status=8388134123491635328&open_id=VrwsGyiLdu&update_order_end_time=2345335600845412440&page_num=2335382872476647733&order_id=y56N7Hp17E&create_order_end_time=1755448065072274538&get_secret_number=false' \ --header 'access-token: 0801121846735352506a356a6' \ --header 'content-type: application/json' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
业务数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202606232010471001F23D13371F56AFC2", "now": 1782216650 }, "data": { "page": { "page_num": 1818298270163823900, "page_size": 781815398485878900, "total": 2704693658258221600 }, "orders": [ { "dish_sku_num": 2670387764776446500, "payment_discount": 5884382059672169000, "discounts": [ { "platform_discount_amount": 2938899235267485000, "discount_subject": 5213161432369641000, "discount_type": 21978215459138550, "discount_amount": 7864899680476438000, "merchant_discount_amount": 1194766458954922500 } ], "poi_id": "3Q1liMqdbe", "certificate": [ { "item_update_time": 3672931264876532000, "refund_amount": 2185903104696829000, "refund_time": 7516426763350915000, "order_item_id": "DcMFXlIWd4", "certificate_id": "bxVG4Jdjzv", "item_status": 2287609702686454300 } ], "order_id": "Gxqf9AudBS", "create_order_time": 8702940538968275000, "sku_num": 7598580376144865000, "sub_order_amount_infos": [ { "sub_order_type": 8969247828101015000, "sub_order_id": "HpNLgeHC2d", "pay_amount": 6796727820610576000, "origin_amount": 2964360019130191000, "discount_amount": 2977305877820435500, "discounts": [ { "merchant_discount_amount": 3400406906216368000, "platform_discount_amount": 8680822639426573000, "discount_subject": 4472728308782491000, "discount_type": 3476729634122034700, "discount_amount": 8528766070196040000 } ], "sub_order_seq": "UOsgRdkoDn" } ], "receiver_info": { "district": "DzmeiYp40i", "receiver_name": "cM9Uswb07B", "location_name": "QXe63WYU35", "receiver_real_phone": "dXuNju8W10", "enc_receiver_phone": "hFdu5FfGBe", "enc_receiver_real_phone": "za1NWDVx2Z", "receiver_phone": "DyScosGTap", "city": "mATLE8wFoD", "secret_number": "FVzh3SdJyr", "door_plate_num": "np1vqM63cy", "lat": 0.7238718474223469, "province": "B5nIQSshUy", "town": "ORzfLnV0yg", "lng": 0.6417208464415294, "location_address": "YY3cqe1z8y" }, "is_deliver_later": false, "is_multi_order": false, "degradation_status": { "current_level": 1, "is_degraded": false, "affected_scopes": [ { "param_name": "kSOxMsn7T8", "param_type": 1 } ] }, "contacts": [ { "phone": "5cBtYbE4B2", "phone_encrypt": "8L6TcDpak6", "name": "OTEtFyVGER" } ], "sku_type_num": 6101936322156051000, "delivery_info": { "sys_expect_time": "XPeyJ30m5w", "latest_start_cooking_time": 1013402046989397400, "create_delivery_channel": 1729270861639531300, "estimated_finish_cooking_time": 1711097607217209000, "deliver_model": 6333125290998641000, "estimated_call_rider_time": 8596050169912367000, "shop_number": "y7Nss2zHse", "is_book": false, "user_expect_time": "pKjncdksPF", "table_ware": "JZwOlBBDYB", "remark": "lHeWVfdWh7" }, "modified_infos": { "modified_book_infos": [ { "modified_time": 5147083380231663000, "old_book_info": { "shop_number": "O2EW1BwdRY", "is_book": false } } ], "modified_receiver_infos": [ { "modified_time": 3719844594843404000, "old_receiver_info": { "location_address": "RQnLRml7VI", "secret_number": "6uNbwQw302", "town": "GzpFqlflKy", "receiver_real_phone": "lpXuNkNUeq", "enc_receiver_real_phone": "QOCod0AIiR", "receiver_name": "XbqWbZg8q2", "receiver_phone": "ezUZc7NGPT", "location_name": "xCLxgfzfDO", "province": "4iDDegNMPO", "lat": 0.3307501570612852, "enc_receiver_phone": "olg2rjcrlg", "city": "x7LLeDquAP", "lng": 0.8631281712523827, "door_plate_num": "y2hH7w2Gwf", "district": "EweHvwZT2G" } } ] }, "count": 2025224671020251600, "dish_sku_type_num": 2818882778609275000, "products": [ { "specs": [ { "sku_id": "YOIZ4meeYm", "out_sku_id": "oN4yctItYn", "value_type": 2889402647674367500, "value_metric": "YGBTza7Rzn", "name": "pMSM1boX4A", "value": "NiAVoVpeZJ" } ], "product_name": "GawtGxwurv", "out_id": "r20G2tHFov", "product_type": 5991817340098045000, "ingredients": [ { "out_id": "dg8D5QzN8L", "product_id": "Evqsee09nN", "name": "Er7t4zbCqf", "count": 7603640152415752000 } ], "sku_id": "72txpQZYPc", "origin_amount": 7367358282610838000, "product_origin_amount": 2154028644920583700, "attributes": [ { "name": "wlxptNA9vb", "value": "22jhiW6Fi0" } ], "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_desc": "NTvRmGwzSM", "dynamic_par_min_amount": 7148605585431038000, "dynamic_par_max_amount": 5643176921085756000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "jnoJM3zHSF", "use_end_time": "cA7MEBPJmN" }, "deductible_amount": 7218082378001772000 } ] } } }, "commodities": [ { "group_name": "EiI884Bsje", "total_count": 3676487535323837000, "option_count": 4731841597602383000, "item_list": [ { "sku_attr_list": [ { "product_id": "8iNKaFV1fo", "upgrade_price": 1901799593052570000, "group_key": "X1yOgXSxbM", "attr_name": "5M4fw7onW5", "attr_key": "QUC1BJFEgW", "num": 207561611859447740, "out_id": "603Uruxbra", "group_name": "1SvjLBmN0H" } ], "out_sku_id": "jJXYE3x5rT", "sku_id": "0fVuLeo8NU", "original_out_sku_id": "6kCTzxN4l2", "unit": "BYssKq3Ew1", "deduction_info_list": [ { "certificate_id": 4041182663121785000, "amount": 8840830937509211000, "third_part_code": "FrFrvAf9OI", "verify_id": 84516895088675420, "deduction_type": 4298454580588385000, "serial_num": 491302786128773100 } ], "original_price": 9194586642030376000, "desc": "37UBm2Y8tg", "weight_count": 8770093337495165000, "ingredients": [ { "product_id": "zOInCsAhCh", "name": "eTEpIEvZOe", "count": 839021545267425800, "out_id": "DsrpJBMq5Q" } ], "name": "dDlCg7h2wE", "item_tag": "0J6JMHLchE", "attr_list": [ "KXG0bLnvO0" ], "original_sku_id": "dLb65OqWvZ", "count": 1295658174542887200, "specs": [ { "out_sku_id": "rjvWKqWxRE", "value_type": 7623252497472446000, "value_metric": "PJfbscGHpR", "name": "ynfW4v8v88", "value": "6aYft9lXuA", "sku_id": "QNdpVHyTkB" } ], "attributes": [ { "value": "6TPE4FYu3o", "name": "C4omomobN0" } ], "out_id": "xqHiq1XovT", "weight_unit": "cHfp3RILmF", "price": 1026332141112686300, "product_id": "UB90XAdzbs" } ] } ], "product_id": "ol7c4JAaWr", "num": 132229860773264700 } ], "sku_name": "k2sE7EAWYk", "open_id": "tFMnsENUqe", "buyer_info": { "buyer_phone": "19ocTmOB9h", "buyer_secret_number": "r9FeayT66M", "buyer_real_phone": "l9C6R52nXy", "enc_buyer_real_phone": "8AxiU6bNe7" }, "update_order_time": 571419760834618800, "pay_time": 6354875888439785000, "discount_amount": 5063230967521619000, "user_id": 6318443970110980000, "third_sku_id": "CThnBJff5y", "total_sku_num": 143950176647657020, "merchant_info": { "account_id": "VWIgkm0DLJ", "account_name": "Z4YRIf8bOR" }, "sku_id": "ebIxWZ6JBI", "products_after_refund": [ { "num": 5781840743504946000, "out_id": "6ai7J6QaHe", "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_end_time": "gctD74ZMEG", "end_time_is_next_day": false, "use_start_time": "ht2DkA6SNJ" }, "deductible_amount": 5286587207569846000 } ], "dynamic_par_rule_desc": "2n1KrMhuhB", "dynamic_par_min_amount": 5599051720150167000, "dynamic_par_max_amount": 5503235727307340000 } } }, "commodities": [ { "item_list": [ { "original_out_sku_id": "HBO5UUUDYy", "original_sku_id": "UldJAh9lVj", "original_price": 4090819356525949400, "sku_attr_list": [ { "group_key": "B4TWQwy6nm", "attr_key": "ORjR7Fku6b", "upgrade_price": 3834430108857677000, "group_name": "h0tme8qgHG", "out_id": "Bnqv9nEEHP", "num": 6144325971504761000, "product_id": "L5ygh9ERsj", "attr_name": "65g5CQd3X8" } ], "sku_id": "Qj69WdMQYe", "item_tag": "fQaKzGkbsv", "weight_unit": "t387bJZFBY", "out_id": "RSPi97ilN8", "out_sku_id": "Pu7ujinfHC", "ingredients": [ { "name": "fIuJx52nXf", "count": 2795319861636261000, "out_id": "iNYpkr3TIY", "product_id": "zWzNyN3rK4" } ], "attr_list": [ "4GZMQX2ZQF" ], "weight_count": 3348256049656230000, "unit": "pVxa4fgWPn", "price": 2764916466179197400, "count": 8898100429341614000, "product_id": "qyl0l0dDw8", "attributes": [ { "name": "SZIJe8TdbP", "value": "26SAxjOzIL" } ], "deduction_info_list": [ { "amount": 6769497304262147000, "third_part_code": "PEMZN127bh", "verify_id": 7541616673003516000, "deduction_type": 1255459316104823800, "serial_num": 6945336979536835000, "certificate_id": 8338286879204366000 } ], "name": "1Amk0dqDOc", "specs": [ { "value_type": 2058651051371219200, "value_metric": "0zNBvqIRq2", "name": "dsn7wYyVsZ", "value": "RS1MpAvkpF", "sku_id": "9bur1ECqRy", "out_sku_id": "lkHZZMsdLg" } ], "desc": "VjIhDM4RSP" } ], "group_name": "eLGf8itKSR", "total_count": 8948408447451994000, "option_count": 3394098533928425500 } ], "product_origin_amount": 5651187203660961000, "origin_amount": 5326150164861794000, "ingredients": [ { "product_id": "j6z9wcTtPG", "name": "bfJvy4UgHw", "count": 2788181287215881700, "out_id": "paCdy6U84S" } ], "product_id": "wkelO5b6aB", "attributes": [ { "value": "uvT9YvZurl", "name": "5Sri89HEkA" } ], "product_name": "551b9rDno0", "specs": [ { "out_sku_id": "oRaHq4jYL9", "value_type": 1463249021071826200, "value_metric": "hkMRkW58OW", "name": "iG2YsR08Xw", "value": "f73Zk8o28z", "sku_id": "9neVflRqCK" } ], "product_type": 3634841886431587300, "sku_id": "EdAyECdHoY" } ], "poi": { "poi_id": "bGfnywbhsB", "poi_name": "ZkELtDSliW" }, "order_type": 7645221892908585000, "pay_amount": 5778109774026742000, "amount_info": { "origin_amount": 165527570060271780, "merchant_deliver_freight_fee": 7415202511233627000, "freight_actual_pay_amount": 671529770916928500, "activities_fee_amount": 5838649393942038000, "discounts": [ { "discount_type": 575723148873581600, "discount_amount": 4004608937774013400, "merchant_discount_amount": 5828674842345046000, "platform_discount_amount": 2748908839385217500, "discount_subject": 5140679562404027000 } ], "product_origin_amount": 3434555432894670300, "pay_amount": 3043073749940526000, "other_fee_amount": 8814396274862028000, "pay_discount_amount": 7253847098596418000, "sale_price": 6546958145294428000, "estimated_order_income": 3876486538136325000, "deduction_info_list": [ { "sale_price": 4505907592752550000, "deduction_amount": 6467409426185765000, "serial_num": 6464717957035235000, "certificate_id": 4477524251603026400, "deduction_type": 1, "pay_discount_amount": 2400256311138368500, "platform_discount_amount": 1396488975827481900, "merchant_discount_amount": 6120031733688682000, "pay_amount": 6340465311317476000 } ], "freight_pay_amount": 7234478917974833000, "commission_amount": 3265884801036021000, "packing_price": 500988828005036500, "merchant_discount_amount": 6570755271828651000, "platform_discount_amount": 3088055537972431400, "platform_deliver_freight_fee": 5562296184824117000, "discount_amount": 166521425109029730 }, "order_status": 8335757427146112000, "total_sku_type_num": 1075400704964512800, "original_amount": 1271792835581470500, "refund_infos": [ { "refund_complete_time": 7569465672664439000, "user_refund_amount": 2504321282031793000, "products_refund": [ { "sku_id": "K0ajrWMvjH", "product_origin_amount": 3338104451613132000, "product_name": "ID1Afsumsh", "out_id": "x0a4PWV3wH", "num": 6871901815251983000, "commodities": [ { "total_count": 4680622126131698000, "option_count": 5933970789899014000, "item_list": [ { "attr_list": [ "ExGH09sdeX" ], "name": "bZ69ZDn3R1", "unit": "dy9HtyQnxn", "ingredients": [ { "out_id": "ifypxLvRyk", "product_id": "MfJ3YKE0dg", "name": "Seh3yrytWe", "count": 6446472771064269000 } ], "count": 4614304294697207000, "price": 6753841914215601000, "sku_attr_list": [ { "attr_name": "ktF9dVbEUt", "num": 5201675105931119000, "out_id": "rBz3dRpLQZ", "group_name": "HbOKix8vpw", "group_key": "NTztSRAdrF", "upgrade_price": 5142633530475680000, "product_id": "HqSUWsE9fD", "attr_key": "FHOYYnvAGt" } ], "out_sku_id": "hWiwEfPXo7", "weight_count": 5314719934740046000, "out_id": "OFq4lsAiTZ", "sku_id": "yMLV6W3CZs", "desc": "Mx2sTmgBCt", "original_out_sku_id": "6C97XtBGmL", "original_price": 3281198217173440500, "weight_unit": "swduDrh9qE", "original_sku_id": "pBFD5gbVDO", "attributes": [ { "name": "fhMCvEnWGN", "value": "sZFW5gAN5C" } ], "item_tag": "Rcwnup6nM0", "specs": [ { "name": "20j34MBB7V", "value": "BssqlBv1Ad", "sku_id": "9NpPx30WFE", "out_sku_id": "0WpQRQerUg", "value_type": 516511143564008450, "value_metric": "H5SzTOg6bG" } ], "product_id": "EnjNpWAlE7", "deduction_info_list": [ { "deduction_type": 3082046695341788000, "serial_num": 745830426322932600, "certificate_id": 7965607405856024000, "amount": 4378044412260185600, "third_part_code": "uvYHHJJhwv", "verify_id": 85804857516634460 } ] } ], "group_name": "NrwiH1XHsi" } ], "specs": [ { "out_sku_id": "2QPGXEEzl6", "value_type": 4476388953446158300, "value_metric": "GDHAMkiYyv", "name": "sNTTWxJWHE", "value": "PSizEMZWZ0", "sku_id": "Z4HVtnq0OD" } ], "product_id": "bppkh0AcYW", "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_rule_desc": "tKZNFdBtZY", "dynamic_par_min_amount": 3935209910296947000, "dynamic_par_max_amount": 7871101573220201000, "dynamic_par_rule_item_list": [ { "time_period": { "use_end_time": "DhEPOJPx3n", "end_time_is_next_day": false, "use_start_time": "hFeGiOapj8" }, "deductible_amount": 4634072313920617000, "day_of_week": [ 1 ] } ] }, "voucher_par_type": 1 } }, "origin_amount": 45385628875182980, "product_type": 4442812358125245000, "ingredients": [ { "name": "r1FiuJEJQ2", "count": 5186272687724105000, "out_id": "ZcKifH4Dqd", "product_id": "kyOiueygQI" } ], "attributes": [ { "name": "72qMmx77YU", "value": "l9mBcZo3Nn" } ] } ], "after_sale_id": "iQjtgktUvA" } ] } ], "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 | 服务器打瞌睡了，请稍后再试。 |
