查询订单列表(旧)
REST API
客户购买包年/包月资源后,可以在伙伴销售平台查看待审核、处理中、已取消、已完成和待支付等状态的订单。
- 该接口既可以使用合作伙伴AK/SK或者Token调用,也可以使用客户AK/SK或者Token调用。用合作伙伴自身的AK/SK或者Token调用的情况下,只能查询伙伴的转售类客户支付的订单。
- 如果想查询某条订单下的资源信息,在调用本接口获取订单ID后,请调用“查询客户包年/包月资源列表(旧)”接口在请求参数输入订单号进行查询。
- URI
GET /v1.0/{domain_id}/common/order-mgr/orders/detail
参数说明请参见下表。
表1 路径参数 参数
是否必选
取值范围
描述
domain_id
是
最大长度:64
- 如果使用合作伙伴AK/SK或者Token,此处为合作伙伴ID,获取方法请参见如何获取合作伙伴ID(partner_id)。
- 如果使用客户AK/SK或者Token,此处为客户账号ID,获取方法请参见如何获取客户的customer_id/domain_id。
表2 查询参数 参数
是否必选
参数类型
取值范围
描述
order_id
否
String
最大长度:64
订单ID。
此参数不携带或携带值为空时,不作为筛选条件;携带值为空串或携带值为null时,作为筛选条件。
customer_id
否
String
最大长度:64
客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。
此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串和携带值为null。
create_time_begin
否
String
最大长度:64
订单创建开始时间。
UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。
其中,HH范围是0~23,mm和ss范围是0~59。
订单创建开始时间与订单创建结束时间间隔不能超过1年。
此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串和携带值为null。
create_time_end
否
String
最大长度:64
订单创建结束时间。
UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。
其中,HH范围是0~23,mm和ss范围是0~59。
订单创建开始时间与订单创建结束时间间隔不能超过1年。
此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串和携带值为null。
service_type
否
String
最大长度:64
云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。
此参数不携带或携带值为空时,不作为筛选条件;携带值为空串或携带值为null时,作为筛选条件。
status
否
String
最大长度:64
订单状态。
- 1:待审核
- 3:处理中
- 4:已取消
- 5:已完成
- 6:待支付
- 9:待确认
此参数不携带或携带值为空或携带值为null时,不作为筛选条件;不支持携带值为空串。
order_type
否
String
最大长度:64
订单类型。
- 1:开通
- 2:续订
- 3:变更
- 4:退订
- 10:包年/包月转按需
- 11:按需转包年/包月
- 13:试用
- 14:转商用
- 15:费用调整
此参数不携带或携带值为空或携带值为null时,不作为筛选条件;不支持携带值为空串。
page_size
是
Integer
[1-100]
单页行数。
page_index
是
Integer
[1-最大整数]
当前查询页码。此参数值超100万,取默认值1。
sort
否
String
最大长度:36
查询的订单列表排序。
支持按照创建时间进行排序,带-表示倒序。
创建时间:升序为createTime,倒序为-createTime。
此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串和携带值为null。
payment_time_begin
否
String
最大长度:64
订单支付开始时间。
UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。
其中,HH范围是0~23,mm和ss范围是0~59。
订单支付开始时间与订单支付结束时间间隔不能超过1年。
此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串和携带值为null。
payment_time_end
否
String
最大长度:64
订单支付结束时间。
UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。
其中,HH范围是0~23,mm和ss范围是0~59。
订单支付开始时间与订单支付结束时间间隔不能超过1年。
此参数不携带或携带值为空时,不作为筛选条件;不支持携带值为空串和携带值为null。
method
否
String
最大长度:64
查询方式。
- oneself:客户自己订单
- sub_customer:客户给企业子代付订单
此参数不携带或携带值为空串或携带值为null时,默认值为“oneself”。
- 请求消息
无。
请求示例
GET https://bss-intl.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/orders/detail?page_size=5&page_index=1 HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
- 响应消息
表3 Result 参数
参数类型
描述
pageSize
Integer
单页行数。
pageIndex
Integer
当前查询页码。
totalSize
Integer
符合条件的记录总数。
orderInfos
List<CustomerOrder>
客户订单详情信息。
具体请参见表4
表4 CustomerOrder 参数
参数类型
描述
orderId
String
订单ID。
baseOrderId
String
父订单ID(拆分前的订单ID)。
当云服务资源进行续订、变更或退订会产生新的订单ID(“orderId”的取值),此时“baseOrderId”为进行续订、变更或退订前的ID。
该字段已废弃。
beId
String
合作伙伴运营实体ID。
customerId
String
客户ID。
sourceType
Integer
客户订单订单来源类型:
- 1:客户
- 2:代理
- 3:合同
- 4:分销商
status
Integer
订单状态:
- 1:待审核
- 3:处理中
- 4:已取消
- 5:已完成
- 6:待支付
- 9:待确认
orderType
Integer
订单类型:
- 1:开通
- 2:续订
- 3:变更
- 4:退订
- 10:包年/包月转按需
- 11:按需转包年/包月
- 13:试用
- 14:转商用
- 15:费用调整
currency
Double
订单金额(原价)。
退订订单中,该金额等于currencyAfterDiscount。
currencyAfterDiscount
Double
订单优惠后金额(实付价格,不含券不含卡)。
measureId
Integer
订单金额度量单位:
- 1:元
- 2:角
- 3:分
measureName
String
金额单位名称。
createTime
String
创建时间 。
UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。
其中,HH范围是0~23,mm和ss范围是0~59。
paymentTime
String
支付时间。
UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。
其中,HH范围是0~23,mm和ss范围是0~59。
lastUpdateTime
String
最后更新状态时间。
UTC时间,格式:yyyy-MM-dd'T'HH:mm:ss'Z',如“2019-05-06T08:05:01Z”。
其中,HH范围是0~23,mm和ss范围是0~59。
needAudit
Boolean
是否需要审核。
currencyType
String
货币编码。
contractId
String
合同ID。
currencyOfficial
Double
订单金额(官网价)。
退订订单中,该金额等于currencyAfterDiscount。
amountInfo
AmountInfo
订单扣费详情。
具体请参见表5。
serviceType
String
云服务类型编码,例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。
表5 AmountInfo 参数
参数类型
描述
discountList
List<DiscountItem>
费用项。
具体请参见表6。
cashcouponAmount
Double
现金券金额,预留。
couponAmount
Double
代金券金额。
cardAmount
Double
储值卡金额,预留。
commissionAmount
Double
手续费(仅退订订单存在)。
consumedAmount
Double
消费金额(仅退订订单存在)。
表6 DiscountItem 参数
参数类型
描述
discountType
String
折扣类型:
200:促销产品折扣;
300:促销折扣券;
301:促销代金券;
302:促销现金券;
500:代理订购指定折扣;
501:代理订购指定减免;
502:代理订购指定一口价;
600:折扣返利合同;
601:渠道框架合同;
602:专款专用合同;
603:线下直签合同;
604:电销授权合同;
605:商务合同折扣;
606:渠道商务合同折扣;
607:合作伙伴授权折扣;
609:订单调价折扣;
610:免单金额
700:促销折扣;
800:充值帐户折扣;
discountAmount
Double
折扣金额。
响应示例:
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "CBC.0000", "error_msg": "success", "data": { "pageSize": 10, "pageIndex": 1, "totalSize": 1, "orderInfos": [{ "orderId": "9Lw9b*****mqK5k", "baseOrderId": null, "beId": "0", "customerId": "L3BnG*****jBdD", "sourceType": 1, "status": 4, "orderType": 1, "currency": 30, "currencyAfterDiscount": 30, "measureId": 1, "measureName": null, "createTime": "2019-04-01T11:28:20Z", "paymentTime": null, "lastUpdateTime": "2019-04-02T11:29:42Z", "needAudit": false, "currencyType": "USD", "contractId": null, "currencyOfficial": 30, "amountInfo": { "discountList": [{ "discountType": "901", "discountAmount": 100 }], "cashcouponAmount": 1, "couponAmount": null, "cardAmount": null, "commissionAmount": 4, "consumedAmount": 5 }, "serviceType": "hws.service.type.ebs" }] } }