订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（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=922794369788483885&create_order_end_time=2407049074990805227&page_num=8728703182056251281&open_id=AZ4gCjpSCF&get_secret_number=false&create_order_start_time=5367194763262763743&order_id=RCcytCCh5O&update_order_start_time=5085150559380165146&page_size=5135392756142825201&order_status=3182043607328875145&account_id=IKXMYv91SG&ext_order_id=lgGFKQOEZj' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \
响应参数
Body展开全部子属性
extra必填Struct
扩展信息
展开子属性
dataStruct
业务数据
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "page": { "page_num": 5765695704450021000, "page_size": 4200911808700643000, "total": 7836610694479145000 }, "orders": [ { "dish_sku_num": 7201050752666468000, "original_amount": 1323293990531832600, "order_status": 4474932905909910000, "discount_amount": 1760919562433575200, "order_id": "hSeTej3FR6", "buyer_info": { "buyer_phone": "p8QA5ZvPgM", "buyer_secret_number": "2QSpYG7NlL", "buyer_real_phone": "D7iEVJakW6" }, "user_id": 1852755170868836000, "products_after_refund": [ { "num": 2555246403570509300, "product_origin_amount": 5260035886924221000, "product_type": 6708205133322371000, "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_item_list": [ { "deductible_amount": 1681396140759445500, "day_of_week": [ 1 ], "time_period": { "use_start_time": "tlh4mercqD", "use_end_time": "gg5mcjGDIJ", "end_time_is_next_day": false } } ], "dynamic_par_rule_desc": "qjuf2scQjF", "dynamic_par_min_amount": 2182473909936898000, "dynamic_par_max_amount": 6967079619080488000 } } }, "out_id": "g0xLQ1riro", "origin_amount": 6592896051508901000, "product_id": "AFoM1v7Hhp", "commodities": [ { "option_count": 7196204473166660000, "item_list": [ { "item_tag": "mYauzXgz5a", "sku_attr_list": [ { "group_name": "JzVat0F48z", "group_key": "SHPgk0gFff", "attr_name": "TwLNKT7kB7", "num": 5330428370617138000, "product_id": "FAAsFgjU5B", "out_id": "DYJph70gnf", "upgrade_price": 2462419958782863400, "attr_key": "NfUJxzDqxQ" } ], "unit": "mOSceFgnU1", "desc": "VMvQQAxvqU", "weight_unit": "8an8ypsj6v", "product_id": "mUVmvFKSDK", "deduction_info_list": [ { "certificate_id": 2062769263656321000, "amount": 1228140163651544800, "third_part_code": "uJzPCQTddl", "verify_id": 1303251232320214800 } ], "name": "28cHwPZshN", "original_sku_id": "578y6tUp4Z", "original_out_sku_id": "jFES7PeJTg", "attr_list": [ "Nb8hZqAZFG" ], "out_sku_id": "Z4itZRNCdH", "out_id": "xdzdfZbF9B", "price": 1130249782806864900, "attributes": [ { "name": "LrAyOojyRJ", "value": "zj0LjKKJEc" } ], "count": 8856751455053691000, "specs": [ { "sku_id": "ADAKKhPmFw", "out_sku_id": "Lu1389Bwy1", "value_type": 6537077512971675000, "value_metric": "nZCc0wc1NH", "name": "D8GUWV1lWT", "value": "mwccvEbS4c" } ], "original_price": 4365377331956537300, "weight_count": 3498821924926342700, "sku_id": "B48JTzSlH4", "ingredients": [ { "name": "NxKCsyuNEA", "count": 4985768499121628000, "out_id": "ViuBnEkT0k", "product_id": "TJhPIsRjuG" } ] } ], "group_name": "bKavnTZ05t", "total_count": 6554623040201040000 } ], "specs": [ { "value": "IVfrtyNj7n", "sku_id": "jvdPUf9jC4", "out_sku_id": "XepJhB4poF", "value_type": 7946443525200440000, "value_metric": "OZgzkefArd", "name": "yVanyJVkvd" } ], "ingredients": [ { "out_id": "krXUPuA2UA", "product_id": "PahoRKrOXb", "name": "m4ZWMilZZ7", "count": 5355961650616172000 } ], "sku_id": "HTax8PIuuq", "product_name": "WNdR9vSwKi", "attributes": [ { "value": "vGPNwJ9FPO", "name": "n9EetxHOps" } ] } ], "is_deliver_later": false, "total_sku_num": 4893482094419714000, "merchant_info": { "account_name": "6sLu0orN1B", "account_id": "5seaixrh7A" }, "poi": { "poi_id": "apBUpSBY76", "poi_name": "S6AGdHDv1C" }, "sku_name": "PdBNP0OdtQ", "dish_sku_type_num": 6476817484223614000, "pay_amount": 2869201637951492600, "total_sku_type_num": 5002072460963105000, "poi_id": "52XZFGmPWT", "refund_infos": [ { "after_sale_id": "T0rfIoNkvi", "refund_complete_time": 6459153177117262000, "user_refund_amount": 2250099987069448200, "products_refund": [ { "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_end_time": "Tju5lJrbHp", "end_time_is_next_day": false, "use_start_time": "oGECt3hEoV" }, "deductible_amount": 7458969649770026000 } ], "dynamic_par_rule_desc": "WlIDDeOZvj", "dynamic_par_min_amount": 6668160740218439000, "dynamic_par_max_amount": 6381153331697774000 }, "voucher_par_type": 1 } }, "product_type": 426078164962026700, "out_id": "6PPGv2S0X8", "specs": [ { "value_type": 7379768392839450000, "value_metric": "QUI7agSlWc", "name": "6nuHh2zL6t", "value": "8U0H7rpGNf", "sku_id": "CwZOOx5ADq", "out_sku_id": "Mr88va9oLW" } ], "product_id": "vLGNB3nmmv", "ingredients": [ { "product_id": "IoI7S80mpS", "name": "R9PwFpCLPq", "count": 7974186678000372000, "out_id": "bcJ3f1zmIq" } ], "product_name": "1mETzmoJyD", "commodities": [ { "group_name": "vqFA417g6w", "total_count": 7716036426305175000, "option_count": 3222326956678363600, "item_list": [ { "out_sku_id": "BDAGXx7V8g", "weight_unit": "Kn4Gl8oNKs", "count": 3218382167162533000, "item_tag": "J5qKxbTssf", "product_id": "w7ih3jnmer", "name": "x3BtUZtBRr", "specs": [ { "value": "S077O8nm7Q", "sku_id": "kxaZX2lPE4", "out_sku_id": "AxOx1NhG2f", "value_type": 2122121526866492400, "value_metric": "Ukv6dXaIvi", "name": "9dvcMqLlNM" } ], "original_out_sku_id": "IUBJae0TMh", "price": 2771751902296196600, "sku_attr_list": [ { "group_key": "RdjDJe3XR3", "attr_name": "vu2dwmtjAY", "num": 7219440130033254000, "product_id": "bNj50nfbHW", "out_id": "4KHsYvLmQs", "upgrade_price": 3847240380699885000, "attr_key": "tERElSzuIV", "group_name": "BDN09LYyjp" } ], "weight_count": 6169705036050694000, "deduction_info_list": [ { "verify_id": 2703426691559461400, "certificate_id": 6818606649595685000, "amount": 2062745333599785500, "third_part_code": "MU2fkOGYtO" } ], "sku_id": "gZB335G2OF", "attr_list": [ "3M2AbKnC9L" ], "original_sku_id": "o7R4GgkwWb", "original_price": 889794606730963200, "out_id": "UEiGx4abQX", "ingredients": [ { "name": "CELyP7P2fc", "count": 3022972765122474500, "out_id": "CdNuaRSjyE", "product_id": "xmc7Ctqmfb" } ], "unit": "ZRouO0Murp", "desc": "bK1BCfb1lF", "attributes": [ { "name": "L8lu8dGPxK", "value": "0mdC66KbJx" } ] } ] } ], "origin_amount": 966262595473418000, "sku_id": "O2U8Akf1ct", "product_origin_amount": 2668270331669143600, "attributes": [ { "value": "dmxnLCzMTa", "name": "fieCXqb2jp" } ], "num": 5211078986462247000 } ] } ], "update_order_time": 5524005009734957000, "third_sku_id": "jCRxAW0OoX", "modified_infos": { "modified_receiver_infos": [ { "modified_time": 4396796561303928000, "old_receiver_info": { "location_address": "ZgslifHSRK", "location_name": "AFUui2w4jD", "receiver_name": "zZNthpZFF4", "lat": 0.3755924446283038, "door_plate_num": "A8kiqYi4VB", "receiver_real_phone": "jZvsEJsrbw", "receiver_phone": "wYbCU0SQpN", "town": "pZD8Ymj6R0", "secret_number": "r7dF1QxtgJ", "province": "tGRExpTiAg", "city": "i94Zx3VXMP", "district": "jfK79gS2pu", "lng": 0.7444064128352974 } } ] }, "discounts": [ { "platform_discount_amount": 1753279121892220400, "discount_type": 8722766144222872000, "discount_amount": 9032577561686887000, "merchant_discount_amount": 969517784101429800 } ], "open_id": "pjDjbCNnh9", "amount_info": { "discounts": [ { "merchant_discount_amount": 4514262853193294000, "platform_discount_amount": 1170953902500627500, "discount_type": 8072380419818528000, "discount_amount": 5009808378648070000 } ], "platform_discount_amount": 9188472145168690000, "freight_actual_pay_amount": 1416217285391398700, "pay_discount_amount": 8303996004970020000, "packing_price": 4990147302576335000, "merchant_discount_amount": 4290799610970222000, "sale_price": 1241081233573255400, "estimated_order_income": 5931946269370445000, "origin_amount": 2247141689118631400, "deduction_info_list": [ { "serial_num": 8436729028485587000, "sale_price": 6871299730531024000, "merchant_discount_amount": 8512262196853655000, "pay_amount": 2381721299958685000, "deduction_amount": 2445296132855232500, "deduction_type": 1, "certificate_id": 7110068901559222000 } ], "other_fee_amount": 7111958312197294000, "pay_amount": 5673481224198958000, "discount_amount": 1302482674467485200, "commission_amount": 3272316676294962700, "product_origin_amount": 7882493783151656000, "platform_deliver_freight_fee": 4171222746133647000, "freight_pay_amount": 2498410179141776000, "activities_fee_amount": 8395126581139997000, "merchant_deliver_freight_fee": 2591812545270352400 }, "is_multi_order": false, "sku_type_num": 8804049537940146000, "receiver_info": { "receiver_real_phone": "yZXkON70aH", "town": "DBDfKFZ9DR", "door_plate_num": "6fFPya8C7N", "receiver_phone": "Y8wSHIdL1S", "location_address": "s6tHPkOF5C", "lat": 0.18077021534425988, "city": "vDHLTGQzj6", "lng": 0.7851166923421186, "province": "GuI5M3RcRU", "location_name": "iMlg6sgFad", "receiver_name": "6ChwezEC8E", "secret_number": "bz2OVMtgto", "district": "VeN2euiID1" }, "count": 8132632526549973000, "certificate": [ { "refund_amount": 5633657029878100000, "refund_time": 8491929885867649000, "order_item_id": "rg4uJo7X9U", "certificate_id": "x1tF0MlXZf", "item_status": 1727005887141027300, "item_update_time": 4027121686929787400 } ], "products": [ { "attributes": [ { "name": "fZhjefqJLA", "value": "weyPR1Tx1l" } ], "num": 5809481751459066000, "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": "XT42B8fTLY", "use_end_time": "Zgcp20uDNM" }, "deductible_amount": 1692155573685286400, "day_of_week": [ 1 ] } ], "dynamic_par_rule_desc": "M6DhQp0akI", "dynamic_par_min_amount": 4305308654553534500, "dynamic_par_max_amount": 1090794393039654800 } } }, "sku_id": "MA8GX2hg5b", "commodities": [ { "option_count": 2380208722735194600, "item_list": [ { "name": "1JwQ5ZIiY4", "out_id": "vr5lk5hbHN", "attr_list": [ "qRQjLOoPNG" ], "product_id": "jh2WgK5OkQ", "sku_id": "Y8uFHMWxmm", "deduction_info_list": [ { "certificate_id": 8899513453986115000, "amount": 2166943705149965800, "third_part_code": "PAzUioO3Ne", "verify_id": 5812757410602377000 } ], "count": 8108194855525558000, "out_sku_id": "in942zPvfl", "price": 4137802210283259400, "item_tag": "sqpkSbGCwD", "ingredients": [ { "name": "XMEADo6JP4", "count": 6387112137823066000, "out_id": "63UbswMj2d", "product_id": "VKMSuhGs4G" } ], "original_out_sku_id": "dHQc231lz7", "desc": "mMSG7nTrzC", "sku_attr_list": [ { "attr_name": "t71bBaIP9k", "num": 8692792521312085000, "product_id": "pkZTtbxUpl", "out_id": "yfa3rK0Pb0", "upgrade_price": 6741673214783405000, "attr_key": "3HmovWerwq", "group_name": "Wkd0j7weiF", "group_key": "w02DRjLNIl" } ], "attributes": [ { "name": "SoRC0eMsq6", "value": "5k3AmKdzlr" } ], "original_sku_id": "meW0lAvbuq", "original_price": 3970363545387143700, "unit": "SOfGGdAh07", "weight_count": 3111936197947772400, "weight_unit": "EWVWdHoDTH", "specs": [ { "value_metric": "K8lrWsREYl", "name": "7LES9LR7Cs", "value": "oV2Qmx2yWX", "sku_id": "qb7GGv4Bx2", "out_sku_id": "uOV4Wlcese", "value_type": 1749496777908847400 } ] } ], "group_name": "YqLfFQe84a", "total_count": 5548863131649824000 } ], "product_origin_amount": 7802169166024426000, "ingredients": [ { "out_id": "6fi3G9QW56", "product_id": "hOa2lwoLlf", "name": "EK4zdwAUY2", "count": 8873887307873492000 } ], "specs": [ { "sku_id": "KlGa4NreT6", "out_sku_id": "onr3XQvTg7", "value_type": 6742428863905766000, "value_metric": "gYgXDG72lR", "name": "w8hFmqXGt8", "value": "bamAVTfkgH" } ], "product_name": "hsDPH9pvR9", "product_type": 4400224916263146500, "product_id": "fDlMAd03Q6", "origin_amount": 3900931657172839000, "out_id": "x0hNqwyDg4" } ], "contacts": [ { "phone": "rDA1V36Wy0", "phone_encrypt": "pEOimokXir", "name": "3TDjk8g1z4" } ], "sub_order_amount_infos": [ { "discounts": [ { "discount_type": 1190515319346928600, "discount_amount": 456172007925787300, "merchant_discount_amount": 5521411520922374000, "platform_discount_amount": 448364326024166300 } ], "sub_order_type": 6901913238024099000, "sub_order_id": "VLBJmo2LWt", "pay_amount": 3013231924524850000, "origin_amount": 2636141354857636000, "discount_amount": 4268153476804790000 } ], "sku_id": "KhUWyM3jiw", "create_order_time": 7287335264358697000, "payment_discount": 6811312974908494000, "order_type": 1670312934287057200, "delivery_info": { "is_book": false, "user_expect_time": "DrR2tD3leB", "sys_expect_time": "InAqnyGYFl", "remark": "OAjbdYJvdl", "table_ware": "qvasUyOtMu", "deliver_model": 3181805387991829000, "shop_number": "7aLPZYBNKk" }, "sku_num": 7629634662775982000, "pay_time": 8091629572542676000 } ], "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202508131143133A9FA47BDD3D86F28795", "now": 1755056601 } }
切换单列布局错误码
| 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 | 服务器打瞌睡了，请稍后再试。 |
