订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（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/?get_secret_number=false&page_size=822670991425168050&account_id=mWoyhiFHep&open_id=T3CYRAtiXA&create_order_end_time=5966539275903200802&order_id=2GCgyC22ft&order_status=6001377276793519491&update_order_start_time=9202164966508749770&ext_order_id=58QU86sbSB&update_order_end_time=132258737671753182&page_num=7824252996920991806&create_order_start_time=4169112003060414250' \ --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": "2026031715354601048FDFCF7E6AEB5E15", "now": 1773732949 }, "data": { "orders": [ { "products_after_refund": [ { "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_min_amount": 7359788979775033000, "dynamic_par_max_amount": 6851671302429052000, "dynamic_par_rule_item_list": [ { "deductible_amount": 156442612553090560, "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "7SYA3qXO31", "use_end_time": "9uJHfwyobm" } } ], "dynamic_par_rule_desc": "51jyMwMdKS" } } }, "product_id": "yyLMbYByGp", "num": 7863872644230108000, "sku_id": "1aJkKmjgla", "ingredients": [ { "product_id": "RyvSiHctSd", "name": "DhTvOMHHIq", "count": 3146550608967111000, "out_id": "aoh0dA9Ocj" } ], "commodities": [ { "group_name": "JjgdVQJJPH", "total_count": 4407770841237575000, "option_count": 2256094591599947300, "item_list": [ { "original_sku_id": "8EqdsoUnWh", "desc": "EZe4OguomW", "attributes": [ { "value": "J9HDwRfeYa", "name": "GFIR7c7gHM" } ], "sku_attr_list": [ { "out_id": "DLlzHte0QT", "attr_name": "rWDIDKTb0n", "upgrade_price": 5484292928720158000, "group_name": "JoOIi0sLxa", "group_key": "NL7mhQIvAY", "product_id": "mVgIOvPd5g", "num": 5050476256668104000, "attr_key": "We0U3foTrQ" } ], "weight_unit": "0evRxZCdc5", "weight_count": 8869885966904797000, "item_tag": "O1nUjBfZps", "sku_id": "YAxFOCE0uW", "count": 7419420239053439000, "specs": [ { "sku_id": "cJFKIrqfiE", "out_sku_id": "wi1gleaPP3", "value_type": 1751208400604022500, "value_metric": "3DjXwyir6u", "name": "pcmWBkyuQe", "value": "qLQNuoe9vz" } ], "original_out_sku_id": "P6bOrz7oah", "product_id": "IuhfCWOlIx", "out_id": "WyT4aDbZwf", "ingredients": [ { "out_id": "jsI5LW6UGs", "product_id": "8cgILgn9UM", "name": "7tVT5KHary", "count": 999097337353716500 } ], "out_sku_id": "7YCrUSEqo3", "attr_list": [ "2oUcbEpGYc" ], "unit": "NIxPf9iDNd", "name": "4dxYAQDfWY", "deduction_info_list": [ { "deduction_type": 3874333332614951400, "serial_num": 8356781644461426000, "certificate_id": 5111774041072273000, "amount": 5296344067973318000, "third_part_code": "cNcVxIk9GU", "verify_id": 1434039114649571000 } ], "original_price": 6263081094551907000, "price": 4652256264857380000 } ] } ], "product_origin_amount": 7273837724139966000, "product_type": 5295414157754537000, "product_name": "CbL4EQ0zbz", "origin_amount": 4157109481688055300, "out_id": "nNYFDSx3Tv", "specs": [ { "value": "RX2nlDeq97", "sku_id": "B5wk7JRzHm", "out_sku_id": "BNU4riHvn0", "value_type": 6669358930963558000, "value_metric": "0ZIYVkXqyd", "name": "KdUkUQw4kM" } ], "attributes": [ { "name": "Qtw3vqh2oO", "value": "vzLg8G0rL1" } ] } ], "poi_id": "oOj8K1d9mu", "merchant_info": { "account_id": "qiqgqZCcGd", "account_name": "gqbHObubKw" }, "total_sku_num": 4064817022109132300, "degradation_status": { "is_degraded": false, "affected_scopes": [ { "param_name": "p4BBlD7R7a", "param_type": 1 } ], "current_level": 1 }, "buyer_info": { "buyer_phone": "0Fp5JqSlLE", "buyer_secret_number": "3mYOBfcjSh", "buyer_real_phone": "M5L1ls3EO8", "enc_buyer_real_phone": "yo0X1WGInT" }, "sku_type_num": 356478036670701060, "order_status": 433261677583237000, "total_sku_type_num": 8802876587887791000, "sku_name": "ty1aZXyrDt", "receiver_info": { "district": "GgQSHpt6rE", "receiver_real_phone": "9Tykje1Bik", "receiver_phone": "A4eAJMnlSL", "enc_receiver_real_phone": "ODv8DNU1wo", "location_name": "RdgqUktUNH", "enc_receiver_phone": "vKJyQQ76g2", "lat": 0.07668524093898511, "province": "OnJx0SGlyv", "town": "6LgreTGoN8", "city": "lwrsReL91Y", "secret_number": "D7hEtnHkYg", "door_plate_num": "xRj5KaacZd", "receiver_name": "ym0liiKMEk", "lng": 0.36627004863765167, "location_address": "E9BkfDFHXd" }, "order_id": "OKmuPoMzc5", "pay_time": 4799160213979005000, "dish_sku_num": 2572760872506900500, "certificate": [ { "item_status": 8962184167340303000, "item_update_time": 3024020756600049000, "refund_amount": 2068254724348303400, "refund_time": 8707409061121154000, "order_item_id": "tnoYWFqdGQ", "certificate_id": "fzzZ74V6gZ" } ], "open_id": "fSzfRJdwul", "user_id": 8445493224786321000, "dish_sku_type_num": 8237029638743178000, "is_deliver_later": false, "count": 8039188580631263000, "sku_id": "yjmVIQ2ubg", "update_order_time": 8516024752284921000, "payment_discount": 1257810979207831000, "sub_order_amount_infos": [ { "pay_amount": 5685855139608796000, "origin_amount": 6924972230375260000, "discount_amount": 7147591775331164000, "discounts": [ { "discount_subject": 5720001949009985000, "discount_type": 6645194431254739000, "discount_amount": 3760769197818159600, "merchant_discount_amount": 2434697120133049300, "platform_discount_amount": 1157849904632659200 } ], "sub_order_seq": "TLGtElEYVq", "sub_order_type": 5785338641983933000, "sub_order_id": "Med0Zx6rKX" } ], "modified_infos": { "modified_receiver_infos": [ { "modified_time": 1599623381894173400, "old_receiver_info": { "location_address": "prYqtoHYEw", "receiver_name": "vOa9bfbC1v", "location_name": "rrea2VNc46", "receiver_real_phone": "C8opvuwCUm", "receiver_phone": "lVNz9M0jyd", "district": "FtshTvXNrC", "secret_number": "d1EFhCpPCT", "town": "M6zxHvtbcC", "enc_receiver_phone": "iMhV4Xe4tH", "lat": 0.8723878130713046, "door_plate_num": "mywhKN77M5", "enc_receiver_real_phone": "JWepDNDudq", "city": "1CjwfBSy1k", "province": "qI4itDwwi5", "lng": 0.4410700571412249 } } ], "modified_book_infos": [ { "old_book_info": { "shop_number": "lG5BWmsyLp", "is_book": false }, "modified_time": 3600344202156377000 } ] }, "third_sku_id": "gPTtd4mIst", "refund_infos": [ { "after_sale_id": "p70eRsRpqM", "refund_complete_time": 1857141244421905000, "user_refund_amount": 6280993252874662000, "products_refund": [ { "commodities": [ { "option_count": 2208746576377674200, "item_list": [ { "original_out_sku_id": "Ro0amN8X0s", "attr_list": [ "oLHbkoM4C7" ], "item_tag": "GQL0YPQIAR", "price": 724526720756008700, "sku_id": "YDWzEAd4rF", "original_price": 1460664943643263700, "count": 4018832699545016300, "specs": [ { "name": "BA1SqbABMy", "value": "KOFcbrioVJ", "sku_id": "fic56kJkwo", "out_sku_id": "0PoyuPfbyU", "value_type": 8032530128127670000, "value_metric": "MiyA2aFDXm" } ], "product_id": "4HSCplkHj3", "ingredients": [ { "out_id": "UM2nGH9a2O", "product_id": "odVwxFsFpC", "name": "maMTBUnD6n", "count": 1466657313861845200 } ], "weight_unit": "TnSSWMlE32", "name": "0u2xrPVF1j", "deduction_info_list": [ { "amount": 5997105761804292000, "third_part_code": "k4KEDHgY1Q", "verify_id": 5054275679345631000, "deduction_type": 2680701145843654700, "serial_num": 5650021534078877000, "certificate_id": 9079661401920275000 } ], "sku_attr_list": [ { "product_id": "5blgej457U", "num": 3410046738882291000, "out_id": "7roQkKcMW8", "attr_key": "V7K3m8hwby", "attr_name": "QsneBguwTr", "group_key": "XOChAi1hkw", "group_name": "mGI9pExw5f", "upgrade_price": 303504749419660400 } ], "out_sku_id": "d9nB9qKJz4", "out_id": "UOvuYCJIsH", "attributes": [ { "name": "IvnJUxK4MT", "value": "UGBpIm477i" } ], "desc": "aeR20XXo6V", "weight_count": 8871721955196250000, "unit": "rYr20ct5UV", "original_sku_id": "u1dVYhlXCM" } ], "group_name": "bHyidQ7L1p", "total_count": 6835508221967279000 } ], "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_desc": "9b6r2Z4hTJ", "dynamic_par_min_amount": 679574912643234000, "dynamic_par_max_amount": 860181025372244900, "dynamic_par_rule_item_list": [ { "deductible_amount": 6343702221372298000, "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "gxEbJ7qPdX", "use_end_time": "CiXs4mKd1m" } } ] } } }, "product_type": 6157200879447434000, "product_origin_amount": 2485680184973292500, "ingredients": [ { "out_id": "Gu7d7G1fa2", "product_id": "mU8jt0qkZ5", "name": "kNuATDAAdt", "count": 6644151132293276000 } ], "out_id": "5PLtT6QdNq", "specs": [ { "sku_id": "HoOEt9jx2R", "out_sku_id": "fJvd5TpE9d", "value_type": 4691005900619724000, "value_metric": "Azd4bfVOUh", "name": "uB2fmXTJCV", "value": "znxI7KoruB" } ], "attributes": [ { "name": "CGg3awd6Ld", "value": "7se8YVE9oL" } ], "sku_id": "TgF7gkDnFa", "product_id": "Xw5gAondyI", "product_name": "69y3dFYkPa", "num": 3463391192829759500, "origin_amount": 3920745696226416000 } ] } ], "original_amount": 7626747633881597000, "pay_amount": 466973572480781630, "sku_num": 8786092657949575000, "discounts": [ { "discount_amount": 2887450613385118700, "merchant_discount_amount": 6378750304711267000, "platform_discount_amount": 5027379862454469000, "discount_subject": 2370263103313404400, "discount_type": 8619043222965116000 } ], "is_multi_order": false, "products": [ { "product_id": "BZ3vVgbheR", "product_name": "sFhLigFVLj", "product_origin_amount": 943344898506469500, "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_max_amount": 8626090643772581000, "dynamic_par_rule_item_list": [ { "deductible_amount": 8034758356232415000, "day_of_week": [ 1 ], "time_period": { "end_time_is_next_day": false, "use_start_time": "O3yDdS2oOb", "use_end_time": "uadFpQRZow" } } ], "dynamic_par_rule_desc": "7lFyEthelb", "dynamic_par_min_amount": 7588592716332483000 } } }, "out_id": "JyCXygJ7Ef", "sku_id": "ZaXMBBfFHJ", "num": 8145269828605671000, "product_type": 5807875532704385000, "specs": [ { "out_sku_id": "QtzTd5GZGN", "value_type": 6386460943131002000, "value_metric": "oAXYRMJey7", "name": "IkxBgwR3h3", "value": "zF6MbICUve", "sku_id": "eZ96QDEW60" } ], "ingredients": [ { "product_id": "tT7iuAbtmq", "name": "bksxxdudx5", "count": 2803796756814727000, "out_id": "pb9x1C9EHC" } ], "commodities": [ { "group_name": "I9OcVLcQHZ", "total_count": 4548384379873434000, "option_count": 2244684599554495000, "item_list": [ { "price": 4291314139100360700, "name": "s5kvazkdAv", "attr_list": [ "cqWZdk2lyO" ], "original_out_sku_id": "OOjOwSyn7s", "count": 1748792411378333000, "out_sku_id": "utCOrysmMC", "unit": "pBsK4MLoKp", "original_price": 1081230930105615600, "original_sku_id": "rbxpjFuxUw", "desc": "G5yEW8DNdz", "sku_id": "6Vm89p6ZfZ", "product_id": "MUA84hvGg4", "deduction_info_list": [ { "third_part_code": "dvEyQvBPdv", "verify_id": 5728022756318705000, "deduction_type": 3296009754769110000, "serial_num": 3182096910456939500, "certificate_id": 1872614306493997600, "amount": 6684817054713084000 } ], "ingredients": [ { "name": "6GjrNm6iNG", "count": 3764659741331809000, "out_id": "akDYvQHmPg", "product_id": "WeSNwohF7J" } ], "item_tag": "SZcuyBzqur", "weight_unit": "0D0gfMOpPr", "out_id": "jjnOXsajTP", "weight_count": 8425930039707384000, "attributes": [ { "name": "ZlqTKG7Z5B", "value": "MLzmC5DQal" } ], "sku_attr_list": [ { "out_id": "XaHghC8Oqh", "group_name": "Qp1nllStMm", "attr_key": "8hNDCq4hs3", "num": 634420114408500600, "product_id": "q17gu5Ieon", "group_key": "1G9BTgp9OP", "upgrade_price": 4703672445505526000, "attr_name": "TzTS68TZgT" } ], "specs": [ { "out_sku_id": "uljBkXSP8M", "value_type": 5238031653019940000, "value_metric": "hAdZtGfzMe", "name": "abq4elzgZ8", "value": "aMxtJDHfA3", "sku_id": "eyiAHbaSrH" } ] } ] } ], "origin_amount": 9211250435399347000, "attributes": [ { "value": "NluNWS4kGU", "name": "XB7EQYjCKZ" } ] } ], "discount_amount": 2135228233856205800, "order_type": 8271406447957626000, "contacts": [ { "name": "TwkU18y70g", "phone": "67vcoVncDw", "phone_encrypt": "AW0EmkPsOx" } ], "delivery_info": { "table_ware": "79QTC8gubN", "deliver_model": 4453216684648216600, "estimated_call_rider_time": 1228411594421440500, "remark": "lexS4fxXit", "estimated_finish_cooking_time": 4272235143953156000, "user_expect_time": "PQi4zgVwtR", "sys_expect_time": "vns7lgSQIw", "shop_number": "rHAteDwVHj", "is_book": false, "latest_start_cooking_time": 6410977285960783000 }, "create_order_time": 3187117823739231700, "poi": { "poi_id": "XkPIQrVIC6", "poi_name": "2j1NFdOmjo" }, "amount_info": { "merchant_deliver_freight_fee": 9143826181673954000, "other_fee_amount": 5454634559166822000, "merchant_discount_amount": 2005313404837144000, "estimated_order_income": 7674613558849446000, "sale_price": 4378623786347130000, "discounts": [ { "discount_type": 8368585953053084000, "discount_amount": 5784497418220083000, "merchant_discount_amount": 7642985179621033000, "platform_discount_amount": 7676436269554731000, "discount_subject": 4955335354722324000 } ], "deduction_info_list": [ { "pay_amount": 7138199063778932000, "sale_price": 4916180670249423000, "platform_discount_amount": 8579214807480026000, "certificate_id": 1684989493558050800, "deduction_type": 1, "merchant_discount_amount": 6725029782765136000, "pay_discount_amount": 4365572302165480400, "serial_num": 2994934470933096000, "deduction_amount": 1516324094352837000 } ], "pay_amount": 6724012936712997000, "packing_price": 1361682669492916000, "pay_discount_amount": 4128869351344394000, "product_origin_amount": 9158625960378195000, "freight_pay_amount": 4920901225504412000, "freight_actual_pay_amount": 4304342415387406000, "platform_discount_amount": 4599893366917251000, "origin_amount": 7006206465369282000, "platform_deliver_freight_fee": 5684212670225927000, "discount_amount": 5432129522895823000, "activities_fee_amount": 7925803929355805000, "commission_amount": 5724556348619435000 } } ], "page": { "page_size": 4229991478029695000, "total": 3476585337044862000, "page_num": 7543635067694760000 }, "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 | 5000001 | 服务器打瞌睡了，请稍后再试。 | |
| 200 | 3000001 | 以实际错误信息为准 |
