订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（1）根据订单 id ，查询对应订单详情，入参：订单 id；
（2）根据订单状态和商户 id，查询指定时间内该商户下的订单列表，入参：商家id、订单状态、创单起止时间/修改起止时间；
（3）根据用户 id 和商户 id，查询某用户在该商户下的所有订单，入参：商家id、用户 id、创单起止时间/修改起止时间；
- 支付后未发码/发码失败订单查询方式：限定订单状态为“已支付”，如用户下单后超过 10 分钟未发码会发起退款；
- 退款申请待审核订单查询方式：限定券状态为“退款中”，如退款状态未响应超过 72 小时会自动退款。
- 金额计算公式：
- 原始金额 - 折扣金额（优惠金额） = 实付金额 original_amount - discount_amount = pay_amount
- 原始金额 = 各子单原始金额之和 （子单包含商品、配送费等）
使用限制
page_size和page_num必填，否则不返回内容
基本信息
| 名称 | 描述 |
|---|---|
| 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_end_time=5743612715139131371&open_id=mYt7Mht0kM&create_order_end_time=7342348876446585282&update_order_start_time=5001055742600271399&page_size=6189074656586752036&ext_order_id=Bt57v8xo7n&create_order_start_time=8741014735388093916&order_id=ytlFtpCZdA&order_status=1094258248166667996&account_id=EGbIVHkIac&get_secret_number=false&page_num=2330881390731483814' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
业务数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "2025091619541088A081777449A32DA6E0", "now": 1758023650 }, "data": { "orders": [ { "receiver_info": { "lat": 0.5466336165792935, "location_name": "QaULUdhte6", "door_plate_num": "OCt4OIaFx9", "receiver_real_phone": "iUc1SugnMy", "city": "CQByAK9tlk", "secret_number": "6G4cdSjS65", "lng": 0.40609164522546654, "town": "ElkweiVQAi", "province": "H2fHGwQNNh", "receiver_name": "nWQULSIFpV", "district": "yTsVGYIKTP", "receiver_phone": "T0TOlRBTOR", "location_address": "TivhjrdvwO" }, "products_after_refund": [ { "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_max_amount": 8039580165000957000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_start_time": "mGKXsSOa49", "use_end_time": "lpeWEfokCW", "end_time_is_next_day": false }, "deductible_amount": 392559781070001300 } ], "dynamic_par_rule_desc": "juuMZEltJb", "dynamic_par_min_amount": 1177150884710318800 } } }, "sku_id": "hlPkvlfw11", "origin_amount": 4890919126239450000, "attributes": [ { "value": "iO5eOeP1Yp", "name": "G0dd5g6GxY" } ], "commodities": [ { "total_count": 3012852350061172000, "option_count": 6606613957405083000, "item_list": [ { "specs": [ { "value_type": 6581664666872151000, "value_metric": "sPw8MuaqN9", "name": "Ehb3o4uUbF", "value": "x6MJwEVVdz", "sku_id": "R0LPsYc4nR", "out_sku_id": "l932YQ9dFP" } ], "ingredients": [ { "out_id": "dpY5tL0P9T", "product_id": "dvB7dsgeRt", "name": "D8jD4uPRm0", "count": 2244064960109801200 } ], "price": 4067475360262492700, "attr_list": [ "c1l0SVtngq" ], "weight_count": 2118954216114790000, "item_tag": "C5e8PRzouX", "sku_id": "xTnoKGpj0I", "original_price": 353998693835627260, "name": "HuJ5GLaVoh", "sku_attr_list": [ { "attr_name": "Mk0FxNjGod", "num": 1743438129395929300, "product_id": "7KZIndDhTU", "out_id": "PiXsrvTzdj", "upgrade_price": 9184966330974729000, "attr_key": "pG4cD8R3IS", "group_name": "PtAWYI8as3", "group_key": "8AaspMoFPw" } ], "count": 4767155786286085000, "original_out_sku_id": "up17J5CgV6", "out_sku_id": "RaNITVPrzU", "unit": "e9EvcjUeWU", "attributes": [ { "value": "yW1kCCaPE1", "name": "l20gmoZCpb" } ], "original_sku_id": "cLr71AhoGP", "desc": "atx7kuOmff", "product_id": "HLPmpp4jma", "out_id": "KesV4SQtaG", "weight_unit": "0ouW7okoQ4", "deduction_info_list": [ { "third_part_code": "jEhn5TLUeb", "verify_id": 6275004300757462000, "certificate_id": 8405456206276077000, "amount": 7288887062786596000 } ] } ], "group_name": "0F6yokBOo8" } ], "product_origin_amount": 798434619706502100, "product_type": 619216033159704000, "specs": [ { "value_type": 4856099062272605000, "value_metric": "mvFYsYQsaA", "name": "jDQcIfMB5z", "value": "LIKo55QDfc", "sku_id": "ocgw0pi8Pf", "out_sku_id": "rn6Fw1JFXX" } ], "product_name": "TntHwKpUeV", "ingredients": [ { "name": "eaWzMGEabR", "count": 4048543990288751600, "out_id": "uSpcmVjFAA", "product_id": "AKBhO7z54M" } ], "product_id": "J37s4xVmQQ", "num": 3789543625957634000, "out_id": "iPS04Jj0MJ" } ], "pay_amount": 2263194298553654300, "sku_name": "xudQtQo70p", "contacts": [ { "phone": "9SFZ0TSbVu", "phone_encrypt": "fyH9jvVl3n", "name": "n5ofeXwCAC" } ], "poi": { "poi_id": "uAI2eVgPP2", "poi_name": "vAVDpCbbky" }, "buyer_info": { "buyer_secret_number": "97KAocetF6", "buyer_real_phone": "1HH3dJIigL", "buyer_phone": "Dz4TEu9A6D" }, "open_id": "mgXiEbkKgN", "update_order_time": 4670732521978111000, "original_amount": 312744165858158000, "order_status": 5349867997055327000, "certificate": [ { "order_item_id": "m8irs3wMXC", "certificate_id": "H4HpqGmru0", "item_status": 6518701277098640000, "item_update_time": 8427269197158471000, "refund_amount": 7753366251869907000, "refund_time": 162411674046828830 } ], "payment_discount": 2166456308903465000, "sku_id": "rcXilgzOud", "products": [ { "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_desc": "B6Vd0JYidj", "dynamic_par_min_amount": 4412132328008138000, "dynamic_par_max_amount": 3498084746154406000, "dynamic_par_rule_item_list": [ { "deductible_amount": 6516801863163580000, "day_of_week": [ 1 ], "time_period": { "use_start_time": "Z0qKfymDjb", "use_end_time": "Pp3WkEXpkI", "end_time_is_next_day": false } } ] } } }, "attributes": [ { "value": "eI7boyrM0Z", "name": "ngZHtcsW2X" } ], "commodities": [ { "item_list": [ { "unit": "UNVDk6CMp6", "desc": "1CKsAr9821", "item_tag": "nIOFw1muXB", "specs": [ { "value_metric": "B5A2mXAmP4", "name": "Qd8OGusOOb", "value": "lLIdYAv70f", "sku_id": "Nt7KTHBYPB", "out_sku_id": "50vicX4W7Y", "value_type": 2163025152557723000 } ], "weight_unit": "kBb0Dvdg7e", "attr_list": [ "4FUucLC41G" ], "out_sku_id": "a8hCMKoAB0", "ingredients": [ { "out_id": "XRHueAVTp2", "product_id": "bWSoVFibka", "name": "Oi1vWaBT44", "count": 3282083701674888700 } ], "original_price": 8633715407269896000, "count": 3996790088946824000, "price": 3205126607583529500, "name": "SHMz8hkxVo", "attributes": [ { "value": "OnWlexTxkb", "name": "Xp1mbRZu6N" } ], "weight_count": 3389194082134992000, "sku_attr_list": [ { "attr_name": "O0PofVt7MD", "num": 6056544241435856000, "product_id": "cMglyXNCXI", "out_id": "VGYeZxlmBL", "upgrade_price": 7523583311376243000, "attr_key": "l3xciHOHiI", "group_name": "nQ0wFUjyqk", "group_key": "fW3AcA86nP" } ], "out_id": "UE3jbykGpz", "product_id": "Mhq1ImiRhG", "original_sku_id": "aRXlfjJcEO", "deduction_info_list": [ { "amount": 560880451664828740, "third_part_code": "41p7apTYct", "verify_id": 4487304555508999000, "certificate_id": 951696261833896200 } ], "sku_id": "1ccPinT7Qr", "original_out_sku_id": "vZ7ug5zEqN" } ], "group_name": "symwK2zcm0", "total_count": 3490662976341888000, "option_count": 6801620447652994000 } ], "specs": [ { "sku_id": "0gb4A4xjss", "out_sku_id": "6egVNtf1k4", "value_type": 7795631741247162000, "value_metric": "wskA7gCgVv", "name": "3BaYThBaYl", "value": "zLhnEvI3ZR" } ], "out_id": "fzdFeVYdT4", "product_name": "0vy2WJd8MG", "sku_id": "TgaU7v0jXm", "product_origin_amount": 2430350453474893300, "ingredients": [ { "product_id": "oHHIsuJd6R", "name": "qTvS23yeFH", "count": 7431396949447523000, "out_id": "UJpDBCAiiB" } ], "num": 798869024617663700, "origin_amount": 3671934184455781000, "product_type": 4429174086724886500, "product_id": "B0GvgWnYXI" } ], "delivery_info": { "table_ware": "eR9WbNBm5m", "deliver_model": 4777854328983554000, "shop_number": "wIWpS2XQKv", "is_book": false, "user_expect_time": "thxIQnzmSs", "sys_expect_time": "RZbewH8vuc", "remark": "eEKwSe8UCn" }, "refund_infos": [ { "user_refund_amount": 2047178851179166200, "products_refund": [ { "attributes": [ { "name": "eS0a41dvFa", "value": "cUHoNpo5qF" } ], "out_id": "59z0hTsX1x", "specs": [ { "name": "Yek2Y3Hy97", "value": "zvCDWoQFmL", "sku_id": "tHGUARPQcW", "out_sku_id": "fX8Qhtn8be", "value_type": 2311951762266974700, "value_metric": "KE9Y3kv1jR" } ], "num": 8469285218311542000, "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_rule_desc": "4ZTpWpcSES", "dynamic_par_min_amount": 3749227218607571500, "dynamic_par_max_amount": 4317710910874424300, "dynamic_par_rule_item_list": [ { "deductible_amount": 5452124330294611000, "day_of_week": [ 1 ], "time_period": { "use_end_time": "krPLptxiJt", "end_time_is_next_day": false, "use_start_time": "7TCQ6WFE54" } } ] }, "voucher_par_type": 1 } }, "ingredients": [ { "name": "vc8YitLgA1", "count": 2448050731681989600, "out_id": "IzndPGw6pH", "product_id": "Vth8vSkKwc" } ], "sku_id": "l6h0XQL7tQ", "commodities": [ { "item_list": [ { "weight_unit": "9QFdCUbAjP", "original_price": 6476489378425314000, "out_id": "PVGBiOjInn", "item_tag": "BEXNxfDZYC", "attr_list": [ "jTSGP9q4M7" ], "ingredients": [ { "out_id": "FZ2bPv0fKj", "product_id": "eDXwQv5eC3", "name": "inBvhsCuJq", "count": 7462106155078625000 } ], "deduction_info_list": [ { "amount": 7936463306754674000, "third_part_code": "KXjmoyKP6f", "verify_id": 4614819362118863000, "certificate_id": 5221404152851005000 } ], "original_out_sku_id": "mL21V61zKx", "count": 1713869295015636500, "desc": "1g60KFnRsR", "attributes": [ { "name": "5TJ6EAPtb4", "value": "KVWYDD12bB" } ], "weight_count": 2366784469843559400, "sku_attr_list": [ { "out_id": "mg1zS2cthz", "upgrade_price": 8981157514120045000, "attr_key": "GeWjOaeO6W", "group_name": "riyN5G1acp", "group_key": "t42K9A2z1Q", "attr_name": "NVEvtniwQA", "num": 5036791529300731000, "product_id": "aabdybvmnJ" } ], "price": 4530642153764993000, "unit": "4WmoddLLoi", "name": "hUxfxja0YY", "product_id": "sdiE229GMb", "original_sku_id": "GzVltAJdNa", "specs": [ { "sku_id": "Ll0BluCxhb", "out_sku_id": "k9kZzY10IH", "value_type": 1944977544698284300, "value_metric": "YBzBMnAiho", "name": "WuKT3DcNeR", "value": "jiAQixvMDR" } ], "out_sku_id": "CxBkfhjCBw", "sku_id": "VZlN32csKa" } ], "group_name": "79Iqm2OcNN", "total_count": 7901957524917282000, "option_count": 4520753872990738400 } ], "product_origin_amount": 7840845333178182000, "product_type": 4595059786292943000, "product_id": "zCEYqziyXS", "origin_amount": 7804987642608413000, "product_name": "vqsBeoztCV" } ], "after_sale_id": "I8KQOxDCE1", "refund_complete_time": 2819706863784121300 } ], "third_sku_id": "zL8cD1G0w5", "sku_type_num": 6317112816952390000, "discount_amount": 8649916781892924000, "dish_sku_type_num": 4427440741582337500, "degradation_status": { "affected_scopes": [ { "param_name": "nYma5eJGB0", "param_type": 1 } ], "current_level": 1, "is_degraded": false }, "poi_id": "F50dE2YMyV", "total_sku_type_num": 3346389030844852000, "merchant_info": { "account_id": "odUGe15RGr", "account_name": "ROEIUWeVKM" }, "discounts": [ { "discount_type": 7893723023555288000, "discount_amount": 7622432330273044000, "merchant_discount_amount": 3317069955329750000, "platform_discount_amount": 7923074340174574000, "discount_subject": 8286435766915329000 } ], "total_sku_num": 612768783261459800, "order_type": 499910958941453760, "sku_num": 5347518459894602000, "dish_sku_num": 3063666797298467300, "modified_infos": { "modified_receiver_infos": [ { "modified_time": 6354675271132089000, "old_receiver_info": { "lng": 0.7263684425447913, "lat": 0.32363818919516424, "receiver_name": "6hEuuD4v3B", "receiver_phone": "78rFwDbftt", "town": "74hXa9xU0k", "district": "0KxHD2zgWE", "receiver_real_phone": "zeSw2v9ebd", "location_address": "stwDvgLDdL", "door_plate_num": "g01warQF5A", "location_name": "2OVg0WHswi", "secret_number": "MuFRUAQjFo", "province": "HlUvCmp3Z0", "city": "wppjAqOmRn" } } ] }, "sub_order_amount_infos": [ { "sub_order_type": 1545112302963208000, "sub_order_id": "rwJ2lQzvyR", "pay_amount": 6970847251617837000, "origin_amount": 558064289755682300, "discount_amount": 5567760468939737000, "discounts": [ { "discount_amount": 6936104892949529000, "merchant_discount_amount": 6203678595323028000, "platform_discount_amount": 8072074786050512000, "discount_subject": 7785038593426702000, "discount_type": 8055782581948404000 } ] } ], "pay_time": 8010776140574328000, "is_deliver_later": false, "create_order_time": 5461677198841765000, "count": 146099079914710100, "is_multi_order": false, "amount_info": { "pay_amount": 479522853065346100, "platform_discount_amount": 735147587343775500, "merchant_discount_amount": 6092658422877315000, "packing_price": 9138185310821906000, "estimated_order_income": 8505751683947620000, "activities_fee_amount": 6843812586549273000, "origin_amount": 1584033808139280100, "discounts": [ { "discount_amount": 6392136566767869000, "merchant_discount_amount": 8179484852682637000, "platform_discount_amount": 1174049028159599600, "discount_subject": 1382810581672320500, "discount_type": 5815198943072408000 } ], "product_origin_amount": 4874561666725634000, "platform_deliver_freight_fee": 2213576104573480000, "freight_actual_pay_amount": 1298271862078886700, "commission_amount": 5634968346685723000, "discount_amount": 1163623297970783000, "freight_pay_amount": 5850255114276980000, "deduction_info_list": [ { "sale_price": 4228692766268854000, "serial_num": 2700847890697706500, "pay_amount": 4387133623397743600, "deduction_amount": 3100382321174424600, "platform_discount_amount": 5834382209407737000, "merchant_discount_amount": 5596000830497951000, "certificate_id": 3939657277620314000, "pay_discount_amount": 5386851682137752000, "deduction_type": 1 } ], "pay_discount_amount": 7388504476048639000, "other_fee_amount": 3783876974038724000, "merchant_deliver_freight_fee": 2121707658309164300, "sale_price": 4644288583715020000 }, "order_id": "u9DoomC1Jz", "user_id": 136494104753731900 } ], "page": { "page_num": 8761100998580216000, "page_size": 3829057992623261700, "total": 2803187936492161500 }, "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 | 服务器打瞌睡了，请稍后再试。 |
