订单详情

作者 HDY | 9月 19, 2024

0 评论

3.获取订单详情

3.1应用场景

根据传入的订单id或sn获取订单详情。

3.2注意事项

调用接口按需调用；

订单所有状态：case -7 = “已换货”;case -6= “换货被拒绝”;case -5= “拒绝退换货”;case -4=“申请换货”;case -3 = “已申请退换货”;case -2 = “同意退换货”;case -1= “退款”;case 0 = “待付款”;case 1 = “已付款待确认”;case 2 = “已付款”;case 3= “配货中”;case 4= “未发货”;case 5= “已发货”;case 6= “已收货”;case 7= “已完成”;case 8= “已取消”;case 9 = “订单已生效”;case 10 = “拆单完成,待设置收货地址”;case 11= “海关审核中”;default= “错误状态”;

3.3API内容

基本信息（API接口）

API名称	/api/v2/order/orderDetail
功能描述	根据传入的订单id订单详情

基本信息（SDK接口）

名称	HDServiceProvider.class# orderDetail()
功能描述	根据传入的订单id订单详情

输入参数

*变量名*	含义	类型	备注
memberId	用户ID	string	必填
customOrder	第三方订单号	string	与订单SN，订单ID 3选1
orderSn	订单sn	string	与订单ID，第三方订单号 3选1
orderId	订单ID	string	与订单sn，第三方订单号 3选1
needAddress	是否需要返回地址信息	number	选填，默认不取，需要时参数=1
needStoreInfo	是否需要返回供应商信息	number	选填，默认不取，需要时参数=1
needPayment	是否需要返支付信息	number	选填，默认不取，需要时参数=1
needGoods	是否需要返回商品信息	number	选填，默认不取，需要时参数=1
needAbnormal	是否需要异常状态	number	选填，默认不取，需要时参数=1

返回结果

*变量名*	含义	类型	备注
needIDCardPhoto	是否需要完善信息	number	0 不用完善信息 1 需要完善信息
message		string	@mock=””
needIDCard	是否需要身份证号码	boolean	@mock=true
data		object
idcardPhoto	—身份证正面照片	string	@mock=http://mall.test.seatent.com/statics/attachment/store/goods/201707171550316978.jpg
abnormal	订单的状态	Integer	1：表示异常订单 0：表示正常订单
applyReason	异常状态原因	Integer	详细内容参考 3.5.2
shipName	—收件人姓名	string	@mock=“测试”
declareStatus	—报关状态	number	@mock=0
taxAmount	—税费	number	@mock=1
memberId	—用户ID	string	@mock=4185
tradeType	—贸易类型	number	保税：1101 一般贸易：2202 直邮：1303
orderId	—订单ID	string	@mock=532939
abnormalStatus	异常订单的处理状态	number	0:表示未处理 5：表示订单已处理
depotName	—仓库名称	string	@mock=诚淘测试仓库
paymentName	—支付名称	string	@mock=银行卡支付
shipZip	—收货人邮编	string	@mock=310006
shipStatus	—发货状态	number	@mock=2
shipMobile	—收件人手机号	string	@mock=18757106157
orderItemList\|1-3	—订单明细	array
lifeStr	——有效期	string	@mock=2017-05
unit	——单位	string	@mock=罐
goodsId	——商品ID	string	@mock=1110
tax	——税率	number	@mock=0
weight	——重量	number	@mock=0
productName	——规格名称	string	@mock=1件装
image	——商品图片	string	@mock=http://dev.seatent.com/statics/attachment/goods/201505041019304784_thumbnail.jpg
sn	——商品货号	string	@mock=321564564
num	——商品数量	number	@mock=1
name	——商品名称	string	@mock=荷兰牛栏5段800g
productNum	——规格数量	number	@mock=1
customOrder	—小B客户导入订单号	string	@mock=3474865960
paymoney	—支付金额	number	@mock=77
sn	—订单编号	string	@mock=20170424925336
createTime	—创建时间	number	@mock=1483954583
shippingAmount	—运费	number	@mock=10
weight	—重量	number	@mock=0
ships	物流信息	array
dlyCode	—快递公司代号	string	@mock=ems
shipNo	—运单号	string	@mock=1100011355006\|9769882836001
abnormal	—是否异常订单 0:表示正常订单， 1: 表示异常订单， 2:表示售后订单	number	@mock=@int(0,1,2)
tradeTypeName	—贸易类型名称	string	@mock=跨境贸易
completeTime	—订单完成时间	number	@mock=1483954583
remark	—备注	string	@mock=合并付款:(532937,532936)
status	—订单状态，状态请参照注意事项	number	sstatus为 -2 状态表示售后已完结，-1暂时没有用上该状态
saleCmplTime	—发货时间	number	@mock=0
cancelReason	—取消原因	string	@mock=拍重复了
paySuccessTime	—支付时间	number	@mock=1493018561
shipAddr	—收货地址	string	@mock=…ƒ“测试地址”
idNumber	—身份证号	string	@mock=330782198908230611
payStatus	—支付状态	number	@mock=2
goodsNum	—商品量	number	@mock=
payTradeNo	—交易号	string	@mock=000044526020
hasShipInfo	—是否有物流信息	number	@mock=0
idcardBackPhoto	—身份证背面照片	string	@mock=http://mall.test.seatent.com/statics/attachment/store/goods/201707171550316978.jpg
addressId	—客户地址ID	string	@mock=4583
shippingArea	—收货区域	string	@mock=浙江省-杭州市-下城区
code	错误码	string	@mock=
result		number	@mock=1
success		boolean	@mock=true

3.4返回json串示例

{
    "code": "",
    "data":
    {
        "abnormal": 1,
        "abnormalSource": 0,
        "abnormalStatus": 0,
        "abnormalType": 0,
        "addressId": 4583,
        "allocationTime": 0,
        "applyReason": "100",
        "cancelReason": "拍重复了",
        "commission": 0,
        "completeTime": 1483954583,
        "createTime": 1483954583,
        "customOrder": "3474865960",
        "declareStatus": 0,
        "depotName": "诚淘测试仓库",
        "dlyCode": "ems",
        "dlyName": "EMS邮政快递",
        "goodsAmount": 70,
        "goodsNum": 1,
        "hasShipInfo": 0,
        "idNumber": "330782198908230611",
        "idcardBackPhoto": "http://mall.test.seatent.com/statics/attachment/store/goods/201707171550316978.jpg",
        "idcardPhoto": "http://mall.test.seatent.com/statics/attachment/store/goods/201707171550316978.jpg",
        "memberId": 4185,
        "needPayMoney": 77,
        "needPayTax": 0,
        "orderAmount": 77,
        "orderId": 532939,
        "orderItemList": [
        {
            "goodsId": 1110,
            "image": "http://dev.seatent.com/statics/attachment/goods/201505041019304784_thumbnail.jpg",
            "lifeStr": "2017-05",
            "lockSn": "“sh3285825”",
            "name": "荷兰牛栏5段800g",
            "num": 1,
            "orderTagId": 0,
            "originPrice": 75,
            "preferential": 0,
            "price": 70,
            "productName": "1件装",
            "productNum": 1,
            "sn": "321564564",
            "tagId": 0,
            "tax": 0,
            "unit": "罐",
            "weight": 0
        }
        ,
        {
            "goodsId": 1110,
            "image": "http://dev.seatent.com/statics/attachment/goods/201505041019304784_thumbnail.jpg",
            "lifeStr": "2017-05",
            "lockSn": "“sh3285825”",
            "name": "荷兰牛栏5段800g",
            "num": 1,
            "orderTagId": 0,
            "originPrice": 75,
            "preferential": 0,
            "price": 70,
            "productName": "1件装",
            "productNum": 1,
            "sn": "321564564",
            "tagId": 0,
            "tax": 0,
            "unit": "罐",
            "weight": 0
        }
        ],
        "orderSource": 6,
        "orderSourceName": "分销",
        "orderStatus": "待付款",
        "payStatus": 2,
        "paySuccessTime": 1493018561,
        "payTradeNo": "000044526020",
        "paymentName": "银行卡支付",
        "paymoney": 77,
        "preferential": 30,
        "progress": 1,
        "remark": "合并付款:(532937,532936)",
        "returnDes": "商品破损",
        "saleCmplTime": 0,
        "shipAddr": "
“测试地址”",
        "shipMobile": "18757106157",
        "shipName": "“测试”",
        "shipNo": "1100011355006|9769882836001",
        "shipStatus": 2,
        "shipZip": "310006",
        "shippingAmount": 10,
        "shippingArea": "浙江省-杭州市-下城区",
        "sn": "20170424925336",
        "status": 0,
        "taxAmount": 1,
        "tradeType": 1101,
        "tradeTypeName": "跨境贸易",
        "weight": 0
    }
    ,
    "message": "",
    "needIDCard": true,
    "needIDCardPhoto": 83836,
    "result": 1,
    "success": true
}

3.5 异常类型(售后的状态)

3.5.1 获取接口 abnormalType

请求方式：GET
SITEID:要修改为环境的站点id pre 测试环境的 SITEID： 6b8b4690e7a727e3a330a308fe136a2e
pre 测试环境的连接地址： http://statics.pre.seatent.com
正式环境的连接地址： https://statics.seatent.com
code：表示 abnormalType 的状态值， name 为状态名称
请求连接

https://statics.seatent.com/statics/json/SITEID/datadict/afterSales_status.json?_allow_anonymous=true

返回值示例：

{
    "0":{
        "code":"0",
        "name":"待审核",
        "sort":0
    },
    "1":{
        "code":"1",
        "name":"待补齐资料",
        "sort":0
    },
    "2":{
        "code":"2",
        "name":"待主管审核",
        "sort":0
    },
    "3":{
        "code":"3",
        "name":"待打款",
        "sort":0
    },
    "4":{
        "code":"4",
        "name":"退款中",
        "sort":0
    },
    "5":{
        "code":"5",
        "name":"已完成",
        "sort":0
    },
    "6":{
        "code":"6",
        "name":"已拒绝",
        "sort":0
    },
    "7":{
        "code":"7",
        "name":"主管拒绝",
        "sort":0
    },
    "8":{
        "code":"8",
        "name":"待确认收货",
        "sort":0
    },
    "9":{
        "code":"9",
        "name":"待客户退货",
        "sort":0
    },
    "10":{
        "code":"10",
        "name":"已取消",
        "sort":0
    },
    "11":{
        "code":"11",
        "name":"待供应商确认",
        "sort":0
    },
    "15":{
        "code":"15",
        "name":"待处理",
        "sort":0
    },
    "16":{
        "code":"16",
        "name":"已处理",
        "sort":0
    },
    "17":{
        "code":"17",
        "name":"待商家处理",
        "sort":0
    }
}

3.5.2 异常原因类型值 applyReason

请求方式：GET
SITEID:要修改为环境的站点id pre 测试环境的 SITEID： 6b8b4690e7a727e3a330a308fe136a2e
pre 测试环境的连接地址： http://statics.pre.seatent.com
正式环境的连接地址： https://statics.seatent.com
code：表示 applyReason的状态值， name 为状态名称
请求连接

https://statics.seatent.com/statics/json/SITEID/datadict/abnormal_reason_show.json?_allow_anonymous=true

返回值示例：

{
    "0":{
        "code":"0",
        "name":"其他（详细说明请备注）",
        "sort":0
    },
    "1":{
        "code":"1",
        "name":"身份证重复",
        "sort":0
    },
    "2":{
        "code":"2",
        "name":"地址异常：地址中不能出现关于超市、母婴店、药店等类似的字眼",
        "sort":0
    },
    "3":{
        "code":"3",
        "name":"地址超过购买限额",
        "sort":0
    },
    "4":{
        "code":"4",
        "name":"联系方式有误",
        "sort":0
    },
    "5":{
        "code":"5",
        "name":"报关失败",
        "sort":0
    },
    "6":{
        "code":"6",
        "name":"收件人信息重复",
        "sort":0
    },
    "7":{
        "code":"7",
        "name":"单证审核不通过",
        "sort":0
    },
    "8":{
        "code":"8",
        "name":"身份证海关封号",
        "sort":0
    },
    "9":{
        "code":"9",
        "name":"春节期间发货",
        "sort":0
    },
    "10":{
        "code":"10",
        "name":"身份证号码错误",
        "sort":0
    },
    "11":{
        "code":"11",
        "name":"支付人与收件人信息不一致",
        "sort":0
    },
    "12":{
        "code":"12",
        "name":"支付人与收件人信息不一致",
        "sort":0
    },
    "13":{
        "code":"13",
        "name":"湖北区域受疫情影响无法发货",
        "sort":0
    },
    "14":{
        "code":"14",
        "name":"客户要求取消",
        "sort":0
    },
    "15":{
        "code":"15",
        "name":"海关清关中，超15天清关未更新失败",
        "sort":0
    },
    "16":{
        "code":"16",
        "name":"仓库商品价格上错",
        "sort":16
    },
    "20":{
        "code":"20",
        "name":"身份证号码与姓名不对应",
        "sort":0
    },
    "21":{
        "code":"21",
        "name":"客户不想要了",
        "sort":0
    },
    "22":{
        "code":"22",
        "name":"价格填写错误",
        "sort":0
    },
    "30":{
        "code":"30",
        "name":"身份验证失败",
        "sort":0
    },
    "40":{
        "code":"40",
        "name":"地址不详",
        "sort":0
    },
    "50":{
        "code":"50",
        "name":"地址重复",
        "sort":0
    },
    "60":{
        "code":"60",
        "name":"联系方式超过购买限额",
        "sort":0
    },
    "70":{
        "code":"70",
        "name":"身份信息超过购买限额",
        "sort":0
    },
    "80":{
        "code":"80",
        "name":"订单商品缺货",
        "sort":0
    },
    "90":{
        "code":"90",
        "name":"物流配送无法联系到收货人",
        "sort":0
    },
    "95":{
        "code":"95",
        "name":"其它",
        "sort":0
    },
    "96":{
        "code":"96",
        "name":"未上传身份证照片",
        "sort":0
    },
    "100":{
        "code":"100",
        "name":"推单失败",
        "sort":0
    },
    "110":{
        "code":"110",
        "name":"平台报关失败",
        "sort":0
    },
    "120":{
        "code":"120",
        "name":"API接单失败",
        "sort":0
    },
    "130":{
        "code":"130",
        "name":"盛付通支付失败",
        "sort":0
    },
    "140":{
        "code":"140",
        "name":"原仓库疫情管制无法发货，正为您调新仓发货",
        "sort":0
    },
    "141":{
        "code":"141",
        "name":"其他异常原因",
        "sort":0
    },
    "150":{
        "code":"150",
        "name":"海关人工查验",
        "sort":0
    }
}

发表评论取消回复