订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（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/?open_id=wusfVUHM5f&order_status=6751788274416462196&get_secret_number=false&account_id=Y6KvvKObdK&ext_order_id=YDdIGy3RhK&page_size=9005629188540682299&create_order_start_time=2195666277603344269&create_order_end_time=1119567008701826315&order_id=hTkiO046tO&update_order_end_time=5029845199699548493&page_num=4217621148886161429&update_order_start_time=5515586138822317511' \ --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": "20261104111518C7A7E3CDFC34AD085A27", "now": 1793762124 }, "data": { "orders": [ { "discounts": [ { "discount_amount": 2046831076447740700, "merchant_discount_amount": 4028152771100090400, "platform_discount_amount": 2580191646404190700, "discount_subject": 6008265307904169000, "discount_type": 8280368558431825000 } ], "total_sku_type_num": 650470234320846100, "user_id": 1333328494293592600, "certificate": [ { "certificate_id": "jabzZiBfcv", "item_status": 3967484070126981600, "item_update_time": 625655403393620700, "refund_amount": 9062639600252487000, "refund_time": 3798336160599187500, "order_item_id": "M2Lz0simIM" } ], "pay_time": 6538168138169817000, "dish_sku_type_num": 7383343166596842000, "order_type": 4231399270197552000, "poi_id": "Umc1z39V8K", "products_after_refund": [ { "ingredients": [ { "product_id": "dgHVEV9hiZ", "name": "G7aNHT0Bw1", "count": 3715475116680891400, "out_id": "4sOz1taX3Z" } ], "product_type": 929316903446644500, "product_id": "fTpig7OGXZ", "num": 5700423118186921000, "commodities": [ { "option_count": 8546859383986009000, "item_list": [ { "specs": [ { "sku_id": "f4Q0Xl7Q4T", "out_sku_id": "Hld7yZLXwW", "value_type": 4715895528715649000, "value_metric": "Pm3F6epQKA", "name": "rwgg2A0QBQ", "value": "3dyIeWOK8A" } ], "out_id": "zbNuVqKe1i", "sku_id": "57aTAyHddt", "original_price": 365854769468859900, "deduction_info_list": [ { "certificate_id": 96553419187359520, "amount": 4534291061152541000, "third_part_code": "8FCnK4p6Zd", "verify_id": 5628318349820934000, "deduction_type": 7901001048100264000, "serial_num": 1808363673993759500 } ], "original_sku_id": "nUlWWSUV7g", "out_sku_id": "3goHxRI5lT", "ingredients": [ { "name": "SBgnvhDxct", "count": 3995916834270970400, "out_id": "JOJ5dmoN3n", "product_id": "Jr8cwD2fob" } ], "product_id": "WMX0q0TGwb", "item_tag": "HetNOCwFkA", "weight_count": 5446307023248155000, "attributes": [ { "name": "XGL8Udl4CX", "value": "C5IszKSQ1I" } ], "count": 1252346428852578000, "unit": "hSXq5ppWXc", "name": "ejKFjlsC5M", "weight_unit": "yOFHTmLk5B", "sku_attr_list": [ { "out_id": "qhzxzOKKs5", "upgrade_price": 8845375709859767000, "group_key": "Tf16xo9NOP", "group_name": "YYP2mHdyJC", "is_refunded": false, "attr_name": "drkiP2odvc", "num": 279385071227182980, "product_id": "fUwrA1N9Ge", "attr_key": "DZucZnrUUs" } ], "desc": "flciMpxhxg", "is_refunded": false, "price": 476924100482980030, "attr_list": [ "pxiC1v4pKj" ], "original_out_sku_id": "Ktd3K5y5xL" } ], "group_name": "ffbQq6Ebup", "total_count": 751523439276352500 } ], "origin_amount": 8544735713862005000, "out_id": "ZtqoA9RVxU", "product_name": "Itm4cLW4wO", "attributes": [ { "value": "90PnML5RCR", "name": "O2qmODwSNo" } ], "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_end_time": "lJgfmD7cxO", "end_time_is_next_day": false, "use_start_time": "uhdRUdqucx" }, "deductible_amount": 625629425478811500 } ], "dynamic_par_rule_desc": "cmS4Y5uX17", "dynamic_par_min_amount": 3876401649566305000, "dynamic_par_max_amount": 170396031343284200 }, "voucher_par_type": 1 } }, "product_origin_amount": 784101843473683200, "specs": [ { "sku_id": "a2jUYIXF1U", "out_sku_id": "52DsWlQqcR", "value_type": 7630106484651880000, "value_metric": "D0LVaOJm7D", "name": "bF4MYQCME5", "value": "BXayLa0hjA" } ], "order_item_id": "CDTuhpgxfe", "sku_id": "idk0r45ZiI" } ], "sku_id": "7Zzj9rUKM9", "order_status": 5356815560464395000, "payment_discount": 1419124089875225000, "receiver_info": { "receiver_real_phone": "v4w9ZXfQ8W", "city": "StENjOyW8R", "district": "CegJ3PjtZM", "secret_number": "ajLfWLIrsL", "town": "84VxGoEZLX", "lng": 0.4181129945947065, "enc_door_plate_num": "k9jMdl6z0k", "location_name": "rcgtc2fiju", "province": "RJdTT9oeJs", "enc_receiver_phone": "lXzphqAfJD", "receiver_name": "lGsHvlQLX8", "enc_receiver_name": "8cQcLtDTLu", "location_address": "Nxwb14MGzI", "enc_location_address": "S5FRvNGt0t", "lat": 0.4176439187377758, "enc_receiver_real_phone": "rBQgFyP9Oi", "door_plate_num": "Iwyc2XLK6t", "receiver_phone": "WuSHFcufgi" }, "sku_name": "BHSNH0u5Wb", "products": [ { "commodities": [ { "total_count": 2351744767022538000, "option_count": 5002220257560812000, "item_list": [ { "desc": "armuFRvFxt", "original_out_sku_id": "PO6pwE9uU2", "name": "RV9L7pvV6F", "weight_count": 6913117563200286000, "weight_unit": "1EcXKrnvjy", "ingredients": [ { "out_id": "SFokSV8QTF", "product_id": "QuRmp5xw8X", "name": "ah7tMXs0Cg", "count": 8800175971238650000 } ], "product_id": "T8t9311xGZ", "attr_list": [ "IsiTLMLNkV" ], "original_sku_id": "PTyxZfBIvL", "price": 7398273918446253000, "sku_attr_list": [ { "attr_key": "EldC8xieJX", "group_key": "6VN2PLUvQL", "attr_name": "tq8mVHnpPo", "product_id": "1IWzXginYz", "out_id": "egIX4TNN07", "group_name": "A6BBrPrvkc", "is_refunded": false, "num": 4741163072736069000, "upgrade_price": 1004069659733304000 } ], "sku_id": "lUQaLKYkA5", "item_tag": "h1rMTBV4Mq", "specs": [ { "out_sku_id": "zgerAXICwM", "value_type": 6055495631542327000, "value_metric": "fIHxg1JPWh", "name": "8bJu1Vcups", "value": "pqb5umT7Ql", "sku_id": "fNHXEuQ0sH" } ], "deduction_info_list": [ { "certificate_id": 4956343832441043000, "amount": 3313244510733562000, "third_part_code": "nxJbsI2AXI", "verify_id": 5842091873702308000, "deduction_type": 7926390187985136000, "serial_num": 2050216847272520400 } ], "original_price": 7736901700692812000, "count": 3593361828378751500, "out_sku_id": "35KcQdXiF5", "attributes": [ { "value": "6gIk9JTum9", "name": "aN3Z6cGigT" } ], "is_refunded": false, "out_id": "a8kUW0pMHr", "unit": "J1zomAqosC" } ], "group_name": "WSBuZUynlU" } ], "product_type": 3970866462949692000, "product_id": "5qmD4WRF4y", "sku_id": "aP8czSi2xs", "ingredients": [ { "name": "ECcJ15WWWF", "count": 3503015444404836000, "out_id": "b4hCgM6QW4", "product_id": "huSAaXjbHo" } ], "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_rule_desc": "FIPn6L3bQu", "dynamic_par_min_amount": 9029393544976502000, "dynamic_par_max_amount": 287695791404054080, "dynamic_par_rule_item_list": [ { "time_period": { "end_time_is_next_day": false, "use_start_time": "Fhho57C9pG", "use_end_time": "v5JqhJnDnf" }, "deductible_amount": 729302630262709200, "day_of_week": [ 1 ] } ] }, "voucher_par_type": 1 } }, "origin_amount": 3857297000135871500, "attributes": [ { "name": "XpfPjhUgWx", "value": "sTIW3CJNAY" } ], "specs": [ { "out_sku_id": "Tar3SAm7ez", "value_type": 3552633235455131000, "value_metric": "YpJjUy6cCt", "name": "tu7uZKPtrM", "value": "LW4y8rV1N4", "sku_id": "cFiJGSuGi2" } ], "num": 4809068346504841000, "order_item_id": "e19RHwXQ7K", "product_origin_amount": 8108924362283099000, "out_id": "Rx6hoWa0pB", "product_name": "X1Mn4yEI21" } ], "sku_num": 8836162810264510000, "order_id": "7fVmO8QXsC", "modified_infos": { "modified_receiver_infos": [ { "modified_time": 3215925383173321700, "old_receiver_info": { "receiver_real_phone": "HEh62cHCKO", "receiver_name": "BlHQDD2GW1", "enc_location_address": "v9sPciwjOq", "city": "f4xqktdYV5", "town": "A4QSmIoTj5", "location_address": "NmdtLwPdLS", "receiver_phone": "kKTHFzgFbP", "secret_number": "uFy17YSojW", "door_plate_num": "D0YobMaXEr", "enc_door_plate_num": "pZ2id28znz", "lng": 0.7455931489683044, "location_name": "FVlFgYh2Jf", "lat": 0.9463615551593944, "district": "kXT8AYVDF2", "enc_receiver_real_phone": "be8Xx5texq", "province": "WgQOmPWB1r", "enc_receiver_name": "qum89PEINs", "enc_receiver_phone": "AeteIlB1V4" } } ], "modified_book_infos": [ { "modified_time": 3157899631655123500, "old_book_info": { "shop_number": "4Anzd2z7GQ", "is_book": false } } ] }, "count": 7963890519739130000, "original_amount": 465961852946306050, "contacts": [ { "phone": "3VkRFdKMaO", "phone_encrypt": "Tlj82KZaYh", "enc_name": "9FJua8lrJJ", "enc_phone_encrypt": "DkRLqJ5ElE", "name": "bXagmVH6bN" } ], "refund_infos": [ { "refund_complete_time": 1770615428973802000, "user_refund_amount": 1900109351756248300, "products_refund": [ { "product_type": 2743763401494831600, "specs": [ { "out_sku_id": "csPK6VzBTh", "value_type": 6912403536871908000, "value_metric": "sh9hY2nYO8", "name": "TPH6Nx0kEl", "value": "2n2p2spUA9", "sku_id": "Na958A73US" } ], "num": 1922925163057772000, "attributes": [ { "value": "xewL75KIxC", "name": "TLuLUIHJ6Z" } ], "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_rule_desc": "4MoaZsbzdk", "dynamic_par_min_amount": 5077982938850041000, "dynamic_par_max_amount": 8243835321020570000, "dynamic_par_rule_item_list": [ { "time_period": { "use_start_time": "ZfDaI0gtel", "use_end_time": "zhykOEZs5D", "end_time_is_next_day": false }, "deductible_amount": 7758674821017541000, "day_of_week": [ 1 ] } ] }, "voucher_par_type": 1 } }, "commodities": [ { "group_name": "CRU8U2qORz", "total_count": 6032719215969032000, "option_count": 3060552145689386500, "item_list": [ { "count": 3461808401878195700, "deduction_info_list": [ { "amount": 7417937213310171000, "third_part_code": "MDaROn4vua", "verify_id": 1863802819690104300, "deduction_type": 9115611410459067000, "serial_num": 4788624707590905000, "certificate_id": 5499360669125054000 } ], "sku_id": "FdqR2jZYjx", "product_id": "2223CQlNH0", "out_id": "ngBVI0e6uW", "ingredients": [ { "name": "UX08ErpfaR", "count": 730194597982301800, "out_id": "IPGI45UJi8", "product_id": "8ftfTwwGuZ" } ], "original_sku_id": "wGzuE0JyFF", "original_price": 5945541539721554000, "is_refunded": false, "desc": "uGXIOum7r6", "attributes": [ { "name": "HTu8JRzbi4", "value": "ffXpxuKHmo" } ], "price": 4587570865088756700, "original_out_sku_id": "iR1DgwuXHs", "weight_count": 3251630027715730400, "out_sku_id": "if94Hzld9p", "specs": [ { "value_type": 9157582723400800000, "value_metric": "7D9EMSMRe4", "name": "f2LNu9mxhI", "value": "kWWCUNvude", "sku_id": "ouYKxySjxP", "out_sku_id": "EBrEPyiCOR" } ], "weight_unit": "nmJSIyuc5v", "item_tag": "8UnWdVmfZG", "name": "kWeNYWoL7z", "attr_list": [ "VBt4NN3t0X" ], "sku_attr_list": [ { "attr_name": "2qrwLzryyl", "upgrade_price": 3789053673261560000, "group_key": "RpUW9etHxL", "out_id": "WyIVukQxpx", "product_id": "KpSz5huUdC", "attr_key": "S5iO9BZJNR", "group_name": "8htqOXFMiS", "is_refunded": false, "num": 3106354814328657400 } ], "unit": "9wQ6FK2MUn" } ] } ], "product_origin_amount": 1217753508802016300, "order_item_id": "1TFOCPpE2J", "product_id": "hgfePL5IsO", "sku_id": "Opji8Zf3Hl", "ingredients": [ { "product_id": "LHng4IhB3M", "name": "jZreFnp4be", "count": 8956644170333494000, "out_id": "fBj0ZCKG87" } ], "product_name": "YOsVGB3LsJ", "out_id": "7cwGoMBHkl", "origin_amount": 5898268771841828000 } ], "after_sale_id": "pk0Q8j43sG" } ], "poi": { "poi_name": "3VeqxH7NSs", "poi_id": "8p0FvMkTXv" }, "open_id": "w47WAkXekt", "sub_order_amount_infos": [ { "pay_amount": 4715287809306745000, "origin_amount": 1561125855461549800, "discount_amount": 4685494247633025000, "discounts": [ { "discount_subject": 4790054396101990000, "discount_type": 1574857698196636700, "discount_amount": 5413517506921026000, "merchant_discount_amount": 1285541907588355600, "platform_discount_amount": 2973156911042980400 } ], "sub_order_seq": "Dz4Kk51PjL", "sub_order_type": 1481595475797836000, "sub_order_id": "5MRg8jSRvA" } ], "dish_sku_num": 2507879501207798300, "return_info": { "details": [ { "freight_amount": 4013509826496483300, "after_sale_id": "L2DFLSbbX2", "return_goods_service_order_id": "EylaZ4MMqA", "delivery_type": 1, "freight_payer": 1 } ] }, "delivery_info": { "latest_start_cooking_time": 720322766173626500, "is_book": false, "sys_expect_time": "XVgfCxIyfW", "remark": "zd91tnIuZ4", "create_delivery_channel": 8275614151467248000, "table_ware": "7rVaQIqiPG", "user_expect_time": "66Kwfr0aBt", "estimated_finish_cooking_time": 1199019515615134200, "deliver_model": 3173014046970668000, "estimated_call_rider_time": 3027366437171437600, "shop_number": "IaIfeAh1Fi" }, "update_order_time": 5931126450545118000, "third_sku_id": "2UGtHiZSMw", "total_sku_num": 909756135703274900, "create_order_time": 2618386288237055500, "amount_info": { "platform_reverse_deliver_freight_fee": 1578012690499459800, "platform_discount_amount": 8878561157029061000, "deduction_info_list": [ { "certificate_id": 8427028083846636000, "deduction_amount": 4412679834802909700, "deduction_type": 1, "pay_amount": 7117870409325937000, "pay_discount_amount": 2495678126699407400, "serial_num": 2924819521326297000, "platform_discount_amount": 4884527640866162000, "sale_price": 5740356131635451000, "merchant_discount_amount": 6043012456174079000 } ], "merchant_deliver_freight_fee": 9038285578274875000, "freight_actual_pay_amount": 8123451129894008000, "discount_amount": 2838820752590704600, "product_origin_amount": 7396814155770658000, "freight_pay_amount": 7435154617285943000, "discounts": [ { "discount_type": 1688011888679319600, "discount_amount": 8995920335343176000, "merchant_discount_amount": 1917957366102881800, "platform_discount_amount": 4513181926156399600, "discount_subject": 7547188651457286000 } ], "pay_amount": 5353238850203050000, "reverse_freight_actual_pay_amount": 2659796869090975000, "other_fee_amount": 253489343460770020, "packing_price": 3040791025452208000, "reverse_freight_handling_fee": 32861762729896710, "sale_price": 9117017778894752000, "commission_amount": 7878736260267878000, "pay_discount_amount": 8663768318877653000, "estimated_order_income": 1864309249089599200, "platform_deliver_freight_fee": 8115128514079000000, "origin_amount": 2075800637911176200, "merchant_discount_amount": 4147908556254439000, "activities_fee_amount": 6037348560138153000 }, "pay_amount": 3325606172006609400, "merchant_info": { "account_id": "0prmPaGQzl", "account_name": "Aq8iwJXzVw" }, "is_multi_order": false, "sku_type_num": 5575579700396238000, "buyer_info": { "buyer_phone": "8DSm8iaM3V", "buyer_secret_number": "RIJzF2230e", "buyer_real_phone": "W9gLu0Ek73", "enc_buyer_real_phone": "LLCVJfBCCL" }, "is_deliver_later": false, "discount_amount": 5351729539536434000, "degradation_status": { "is_degraded": false, "affected_scopes": [ { "param_type": 1, "param_name": "CCdaLN0lNf" } ], "current_level": 1 } } ], "page": { "page_num": 823345269488125200, "page_size": 8182159434137108000, "total": 8373685773071158000 }, "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 | 以实际错误信息为准 |
