订单查询
收藏接口说明
- 服务商通过接口查询订单详情，支持三种查询方式：
（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=5713304493523401422&create_order_end_time=2166044588795225575&update_order_start_time=2559161360837826069&order_status=4076527904106686371&page_num=2227773126730621886&open_id=Kip7Sv4x0i&page_size=6298145337334771792&account_id=vqhMsgWyNl&get_secret_number=false&ext_order_id=3qGzmVvL8N&order_id=p2C3r9CAYQ&create_order_start_time=3766444372626174457' \ --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": "202507091450549F7BEDD8115E8E358F03", "now": 1752043854 }, "data": { "orders": [ { "payment_discount": 5489593826737505000, "discounts": [ { "discount_amount": 5566722526846577000, "merchant_discount_amount": 8773159227159250000, "platform_discount_amount": 2205729221474918400, "discount_type": 1991960581051428600 } ], "total_sku_num": 2138852539729900500, "user_id": 2614327718827314000, "sku_num": 914140082074193000, "is_deliver_later": false, "dish_sku_num": 3979070181105780700, "amount_info": { "pay_discount_amount": 5355821472848486000, "product_origin_amount": 6087001408477186000, "sale_price": 6003162130964283000, "platform_deliver_freight_fee": 2594125097635758600, "merchant_deliver_freight_fee": 5530498056083718000, "freight_actual_pay_amount": 7727005580328870000, "estimated_order_income": 1351132374883811600, "origin_amount": 4993002326159448000, "freight_pay_amount": 7971943212297454000, "discounts": [ { "platform_discount_amount": 829539216704978600, "discount_type": 5549187076493477000, "discount_amount": 3777386199262503000, "merchant_discount_amount": 4872818409882540000 } ], "platform_discount_amount": 6679790853549762000, "discount_amount": 6061287901967010000, "deduction_info_list": [ { "sale_price": 870882738926685000, "merchant_discount_amount": 7871393992783459000, "pay_amount": 5290865679664554000, "deduction_amount": 7594279044717564000, "deduction_type": 1, "certificate_id": 3643238311337996000, "serial_num": 6411660715716155000 } ], "merchant_discount_amount": 5854876675361302000, "other_fee_amount": 4221375585569996000, "pay_amount": 6764177344263303000, "packing_price": 2979177394229643000, "activities_fee_amount": 8909377226853939000, "commission_amount": 696506290016874600 }, "sku_id": "meHzWV7ZGj", "delivery_info": { "remark": "ZdIfZIr3ON", "table_ware": "8i1WDXXRNN", "deliver_model": 2652736094872110600, "shop_number": "ttNDG9qLoQ", "is_book": false, "user_expect_time": "e4Z6H9SobA", "sys_expect_time": "5GasgzsqMI" }, "sku_type_num": 9220115323612979000, "discount_amount": 297909743182148700, "receiver_info": { "district": "yliT2qcKtG", "receiver_real_phone": "k46FKCrYBs", "receiver_phone": "BV6LPJvC0T", "door_plate_num": "YCVtXBVlbG", "receiver_name": "6GIE8k9A14", "location_address": "GnoBJuGHnq", "town": "0PHAJ7wOQk", "location_name": "7uRW3dedqQ", "city": "RxD4IMhAfX", "province": "c7AcV7WRUu", "lng": 0.2515574197189708, "lat": 0.3064361096306281, "secret_number": "VsUf7hgrV4" }, "order_type": 901345939376788900, "sku_name": "EmWXCLIay6", "poi_id": "D0VokpyYnt", "total_sku_type_num": 4130826320656504000, "sub_order_amount_infos": [ { "discounts": [ { "merchant_discount_amount": 6963871650835139000, "platform_discount_amount": 8813785280329294000, "discount_type": 8268953438553831000, "discount_amount": 1671938160632725500 } ], "sub_order_type": 4289987175680435000, "sub_order_id": "H0AZhkzMC9", "pay_amount": 8511132449645233000, "origin_amount": 2407535216579350000, "discount_amount": 3619670468187069000 } ], "order_id": "p1EHAwhIA1", "order_status": 1827456911698678500, "pay_time": 6689308553737306000, "merchant_info": { "account_name": "K8PMyxhUCj", "account_id": "H9Ki9aYEU7" }, "poi": { "poi_id": "HJM6W99s2o", "poi_name": "Hb4QA2F47j" }, "third_sku_id": "nYn46rAtfd", "contacts": [ { "phone_encrypt": "sTsr3XOSzV", "name": "7mUbEh7iZ0", "phone": "Hmoglat5Xl" } ], "original_amount": 3216464338596411000, "open_id": "nC0yT84UMR", "count": 1711163122765220000, "products_after_refund": [ { "commodities": [ { "group_name": "4cheXwp9gX", "total_count": 4113701176127375000, "option_count": 1086845244099890300, "item_list": [ { "product_id": "Xggar4i34y", "sku_id": "owUmhW7qmT", "attributes": [ { "value": "iXoECCVaeg", "name": "OtXYjqRoVo" } ], "deduction_info_list": [ { "amount": 906997707642190200, "third_part_code": "btjazk7XaE", "verify_id": 2048101446227371300, "certificate_id": 7373379292503998000 } ], "unit": "hrp5NNiY92", "original_price": 1529698504502366500, "sku_attr_list": [ { "attr_name": "9J3VkXXKz5", "num": 6312723643508138000, "product_id": "fDHYy7MO5j", "out_id": "YC65yzAZD0", "upgrade_price": 3751899919537432000 } ], "attr_list": [ "QFHJtE6IS6" ], "original_sku_id": "AF5BeaRzG1", "out_id": "E1Ut50607v", "name": "2tzj783JvC", "weight_count": 4784039757294251000, "item_tag": "pr6OEPsUMF", "specs": [ { "sku_id": "eScrX9rNUV", "out_sku_id": "3uGMvuerI2", "value_type": 7121377216553714000, "value_metric": "7tFeInLQv0", "name": "OKSUrmT8gV", "value": "wkWpIx5Anz" } ], "original_out_sku_id": "46ZmPAW698", "count": 1176408700842237200, "price": 4136843222802841600, "desc": "MWC6QQ9pCg", "out_sku_id": "FoDpdfO1fp", "ingredients": [ { "product_id": "1qJ4yn2Jkw", "name": "CESrM6iiV0", "count": 7404520846199054000, "out_id": "KdAKXhJyzP" } ], "weight_unit": "pc3ljSNP5z" } ] } ], "product_origin_amount": 5418836221074942000, "specs": [ { "out_sku_id": "xRzhd6THjV", "value_type": 8519654952024963000, "value_metric": "HDQomzNliW", "name": "hgm6Ud5yIN", "value": "0NBOg6uSdk", "sku_id": "vtxPi3Hl8F" } ], "num": 6125012951920591000, "origin_amount": 9149458158740835000, "out_id": "8vkW2DRIlx", "snapshot_product": { "product_attr": { "dynamic_par_rule": { "dynamic_par_rule_item_list": [ { "time_period": { "use_start_time": "Quo4FQHcuh", "use_end_time": "TMAZppJija", "end_time_is_next_day": false }, "deductible_amount": 1709859275175123700, "day_of_week": [ 1 ] } ], "dynamic_par_rule_desc": "dzLAWNmpU6", "dynamic_par_min_amount": 2947229352839868000, "dynamic_par_max_amount": 8200501026123798000 }, "voucher_par_type": 1 } }, "product_id": "nhQ8gvHCo9", "sku_id": "YApjgTCaRx", "product_type": 6223915619247732000, "attributes": [ { "name": "FTkQrqry6c", "value": "IlCAYiom3Y" } ], "ingredients": [ { "name": "greeHpu5Kl", "count": 771907290837549300, "out_id": "UWCJC4QjKa", "product_id": "QIEKgusLfK" } ], "product_name": "llNsBKtyH6" } ], "products": [ { "commodities": [ { "option_count": 3131465085360297500, "item_list": [ { "sku_attr_list": [ { "out_id": "wDpo4oB4TS", "upgrade_price": 3321709179609992700, "attr_name": "eR9votXiOn", "num": 9200177728620141000, "product_id": "1kYy6G7nlR" } ], "price": 5684461676073174000, "product_id": "bY8F72H8Ib", "attributes": [ { "name": "CTgOmgdFHz", "value": "vyCYOkkQVE" } ], "unit": "bam72pxjlX", "specs": [ { "name": "teT1kL7UOh", "value": "Sha5S1NoI9", "sku_id": "f2en3P99WJ", "out_sku_id": "czrZLuE7pK", "value_type": 729978912822308200, "value_metric": "bbCXEkpVCX" } ], "weight_unit": "HG4OI5PWFQ", "out_id": "0AguKDK5Lz", "deduction_info_list": [ { "verify_id": 7775176692071404000, "certificate_id": 5918896893981343000, "amount": 3580185580247880000, "third_part_code": "faRCx2hJGX" } ], "original_price": 1147297002458134700, "count": 9002836320818037000, "sku_id": "thFLJA1acb", "item_tag": "Yn3170RTXU", "desc": "S539SddMSr", "original_out_sku_id": "jdnBwQQmnO", "original_sku_id": "Y02murnAun", "ingredients": [ { "out_id": "W2IIJeCYyh", "product_id": "z1YnmUKIi5", "name": "d9g3ucUUxD", "count": 9195314951538658000 } ], "weight_count": 1810981837802748400, "attr_list": [ "UtGuzTK6Ws" ], "name": "GwcmfcqhPk", "out_sku_id": "vkXRuxExJe" } ], "group_name": "tgLBXacSdH", "total_count": 4355806344269207600 } ], "product_type": 4895884770680891000, "sku_id": "dqjF0iSaSC", "num": 6388922267062006000, "product_name": "PcVSV6e1xp", "product_origin_amount": 3737918575647195000, "attributes": [ { "name": "IEI5joyXDg", "value": "i8HpInVOXV" } ], "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_desc": "5vQVN2MZrL", "dynamic_par_min_amount": 1585441084645203500, "dynamic_par_max_amount": 2922893064285038000, "dynamic_par_rule_item_list": [ { "deductible_amount": 3126491149892565000, "day_of_week": [ 1 ], "time_period": { "use_start_time": "pvYWMUn1WG", "use_end_time": "PW4uyPVlkT", "end_time_is_next_day": false } } ] } } }, "specs": [ { "name": "GDSNKy8GY0", "value": "oVSVr7VzQZ", "sku_id": "Zi7nzXhDQD", "out_sku_id": "TpDeWBpSAn", "value_type": 8339892448602628000, "value_metric": "lOszuEGLFR" } ], "ingredients": [ { "count": 4653430350249913000, "out_id": "jQCzojsIsu", "product_id": "BGwrThDXlF", "name": "6jWOUQdL9F" } ], "product_id": "Y4gEofNMGq", "origin_amount": 7530360706147752000, "out_id": "Bjn53tIvv5" } ], "certificate": [ { "item_status": 1006051002740910200, "item_update_time": 7486133566491955000, "refund_amount": 1530122473588012800, "refund_time": 7874546913291049000, "order_item_id": "GpxYuvLXUs", "certificate_id": "9NMFVBpeBH" } ], "buyer_info": { "buyer_secret_number": "cM6kCHHmsa", "buyer_real_phone": "YdbjMTR6I3", "buyer_phone": "BLOwkMso0X" }, "refund_infos": [ { "user_refund_amount": 8295185577648768000, "products_refund": [ { "ingredients": [ { "out_id": "AQvvTCbt6z", "product_id": "K2Fge74i3u", "name": "clHaGUKFKG", "count": 3487448004129878000 } ], "product_type": 5879724342284488000, "commodities": [ { "group_name": "lh6lUqndn5", "total_count": 5404321368043969000, "option_count": 6644287092997627000, "item_list": [ { "out_sku_id": "uv2lWIO7zh", "original_sku_id": "mJWvBmJI7B", "ingredients": [ { "out_id": "tLQVZmvpxd", "product_id": "OPsfzLgzv6", "name": "1IZxPX1iAo", "count": 4917290404234373000 } ], "product_id": "zn5qELvZmT", "price": 543744632863642000, "desc": "wDFcr2RRGn", "count": 1190292211479556600, "specs": [ { "value_metric": "W7knVWRAhG", "name": "uWWLikDYPV", "value": "SWFwFfcH2z", "sku_id": "mcfNiJBuUQ", "out_sku_id": "taSvliWCeI", "value_type": 7944906470061313000 } ], "sku_attr_list": [ { "attr_name": "bn1fe4UgWl", "num": 8196259263411526000, "product_id": "s3t22zRBNL", "out_id": "n7LKGx5rvl", "upgrade_price": 2297250897457579300 } ], "attributes": [ { "name": "40bzFEfnKn", "value": "sENEG4z1Xq" } ], "deduction_info_list": [ { "certificate_id": 7696961788526271000, "amount": 6119061272484111000, "third_part_code": "3m6JGKobdX", "verify_id": 6664802669231382000 } ], "weight_count": 1928818736778656300, "out_id": "UJP0N39eYi", "original_out_sku_id": "0BLlYJJNZf", "unit": "iutZfPb8ob", "attr_list": [ "oIEgfvpUKx" ], "original_price": 5432605359600903000, "name": "YNmUaA1FOu", "sku_id": "fxOJM5y0Vv", "weight_unit": "gWjvCz7uzF", "item_tag": "RPEamRYRRk" } ] } ], "specs": [ { "value_type": 8848127390909490000, "value_metric": "D8IROuXcv7", "name": "0C8xe2OMVh", "value": "pODOTqQH6T", "sku_id": "Yds6blExW3", "out_sku_id": "57dRfmzKMb" } ], "attributes": [ { "name": "cO757CUfXS", "value": "Bfg7JYMQxx" } ], "origin_amount": 3980857176731922400, "product_name": "5Wa2ImPrpb", "snapshot_product": { "product_attr": { "voucher_par_type": 1, "dynamic_par_rule": { "dynamic_par_rule_desc": "8G1133nnCh", "dynamic_par_min_amount": 5808309688680774000, "dynamic_par_max_amount": 8856559510425526000, "dynamic_par_rule_item_list": [ { "day_of_week": [ 1 ], "time_period": { "use_start_time": "D2qtaYkKS0", "use_end_time": "rxYvxf1fRr", "end_time_is_next_day": false }, "deductible_amount": 8921128155473955000 } ] } } }, "product_id": "TaMdbxrBet", "sku_id": "7GvwVuy4hK", "out_id": "lDe4yaPUHv", "product_origin_amount": 650396593370220400, "num": 2168701123616133600 } ], "after_sale_id": "vDBcmiEIsE", "refund_complete_time": 2393115018223572000 } ], "dish_sku_type_num": 3440479847542268000, "create_order_time": 1389665796842575400, "is_multi_order": false, "update_order_time": 22881331952685904, "pay_amount": 1295692664319075000 } ], "page": { "page_num": 6295794193290514000, "page_size": 4162678359374501000, "total": 9182511860108708000 }, "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 | 以实际错误信息为准 |
