4. jiace开放平台订单管理

4.1. 创建订单

URL: https://open.jiacedata.com/v1/api/openapi/order/createOrder

Type: POST

Author: lones

Content-Type: application/json; charset=utf-8

Description: 创建订单

Body-parameters:

Parameter Type Description Required Since

tradeNo

string

交易订单号

true

-

addressParam

object

收货地址信息

true

-

└─fullName

string

收货人姓名

false

-

└─mobile

string

手机号

false

-

└─phone

string

电话号码

false

-

└─postCode

string

邮政编码

false

-

└─cityText

string

市

false

-

└─provinceText

string

省

false

-

└─areaText

string

区

false

-

└─townText

string

镇

false

-

└─address

string

街道地址

false

-

└─districtCode

string

地址编码

false

-

tradeAmount

int64

订单金额

true

-

orderGoodsInfo

array

订单商品信息

true

-

└─skuId

string

skuid

false

-

└─goodsId

int64

商品id

false

-

└─tradeAmount

int32

交易金额(分)

false

-

└─quantity

int32

商品数量

false

-

invice

object

发票信息

false

-

└─invoiceType

int32

发票类型 0：普通发票，1:增值税发票

false

-

└─provinceText

string

省份

false

-

└─cityText

string

城市

false

-

└─areaText

string

地区

false

-

└─townText

string

镇

false

-

└─postCode

string

邮编

false

-

└─address

string

街道

false

-

└─fullName

string

街道

false

-

└─phone

string

电话

false

-

└─mobile

string

手机

false

-

└─companyName

string

购货公司名（发票抬头）

false

-

└─taxpayerIdentifier

string

纳税识别码

false

-

└─bankAndAccount

string

开户行及帐号

false

-

└─localInvoiceId

string

增值税本地发票号

false

-

message

string

买家留言

false

-

Request-example: 

curl -X POST -H 'Content-Type: application/json; charset=utf-8' -i /openapi/order/createOrder --data '{
	"tradeNo": "gzcf06",
	"addressParam": {
		"fullName": "明.郭",
		"mobile": "15219325301",
		"phone": "17570268997",
		"postCode": "48034",
		"cityText": "fe0p0f",
		"provinceText": "3b20j5",
		"areaText": "j6xzs6",
		"townText": "vrbnvv",
		"address": "曾旁95号， 嘉兴， 闽 311587",
		"districtCode": "48034"
	},
	"tradeAmount": 314,
	"orderGoodsInfo": [
		{
			"skuId": "264543d1-1df5-4709-9a7f-3b194f028304",
			"goodsId": 145,
			"tradeAmount": 590,
			"quantity": 831
		}
	],
	"invice": {
		"invoiceType": 612,
		"provinceText": "d48hpl",
		"cityText": "p9imcf",
		"areaText": "dzlotd",
		"townText": "0s9gps",
		"postCode": "48034",
		"address": "曾旁95号， 嘉兴， 闽 311587",
		"fullName": "明.郭",
		"phone": "17570268997",
		"mobile": "15219325301",
		"companyName": "明.郭",
		"taxpayerIdentifier": "mmkfmo",
		"bankAndAccount": "p33pj8",
		"localInvoiceId": "121"
	},
	"message": "success"
}'

Response-fields:

Field Type Description Since

code

int64

No comments found.

-

message

string

No comments found.

-

data

object

No comments found.

-

└─totalSuccessAmount

number

下单成功的订单总金额，单位：分

-

└─tradeNo

string

订单号

-

└─tradeStatus

int32

订单状态，1.已取消,2.待付款,3.待发货买,4.待收货,5.已签收,6.已确认收货,7.交易成功

-

└─postFee

number

创建订单的邮费

-

└─failedOfferList

array

失败商品列表

-

     └─goodsId

string

商品id

-

     └─skuId

string

sku ID

-

     └─errorCode

string

错误编号

-

     └─errorMessage

string

错误编号

-

Response-example: 

{
	"code": 161,
	"message": "success",
	"data": {
		"totalSuccessAmount": 509,
		"tradeNo": "dryzq5",
		"tradeStatus": 1
		"postFee": 336,
		"failedOfferList": [
			{
				"goodsId": "121",
				"skuId": "264543d1-1df5-4709-9a7f-3b194f028304",
				"errorCode": "48034",
				"errorMessage": "success"
			}
		]
	}
}

4.2. 查询物流单号

URL: https://open.jiacedata.com/v1/api/openapi/order/queryDeliveryNo

Type: POST

Author: lones

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 查询物流单号

Query-parameters:

Parameter Type Description Required Since

tradeNo

string

店铺订单号

true

-

Request-example: 

curl -X POST -i /openapi/order/queryDeliveryNo --data 'tradeNo=mib1po'

Response-fields:

Field Type Description Since

code

int64

No comments found.

-

message

string

No comments found.

-

data

object

No comments found.

-

└─logisticsBillNo

string

物流单号，运单号

-

└─logisticsCompanyName

string

物流公司

-

└─status

string

物流状态 物流状态。WAITACCEPT:未受理;CANCEL:已撤销;ACCEPT:已受理;TRANSPORT:运输中;NOGET:揽件失败;SIGN:已签收;UNSIGN:签收异常

-

└─logisticsSteps

string

物流跟踪步骤

-

└─tradeNo

int64

订单编号

-

Response-example: 

{
	"code": 5,
	"message": "success",
	"data": {
		"logisticsBillNo": "z8jnvn",
		"logisticsCompanyName": "明.郭",
		"status": "qawy2u",
		"logisticsSteps": [
			{
				"acceptTime":"2018-07-24 21:55:33",
				"remark":"在广东广州天河区天平架一公司进行揽件扫描"
			},
			{
				"acceptTime":"2018-07-24 22:10:50",
				"remark":"在广东广州天河区天平架一公司进行下级地点扫描，即将发往：浙江宁波分拨中心"
			},
			{
				"acceptTime":"2018-07-25 01:45:05",
				"remark":"在分拨中心广东广州分拨中心进行称重扫描"
			},
			{
				"acceptTime":"2018-07-25 01:47:42",
				"remark":"在广东广州分拨中心进行装车扫描，即将发往：浙江宁波分拨中心"
			},
			{
				"acceptTime":"2018-07-26 03:01:41",
				"remark":"在分拨中心浙江宁波分拨中心进行卸车扫描"
			},
			{
				"acceptTime":"2018-07-26 03:21:34",
				"remark":"从浙江宁波分拨中心发出，本次转运目的地：浙江宁波鄞州区邱隘公司"
			},
			{
				"acceptTime":"2018-07-26 07:06:21",
				"remark":"到达目的地网点浙江宁波鄞州区邱隘公司，快件将很快进行派送"
			},
			{
				"acceptTime":"2018-07-26 08:54:15",
				"remark":"在浙江宁波鄞州区邱隘公司进行派件扫描；派送业务员：徐洲；联系电话：xxxxx"
			},
			{
				"acceptTime":"2018-07-26 13:33:11",
				"remark":"快件已被 已签收 签收"
			}
		],
		"tradeNo": 727
	}
}

4.3. 订单售后申请

URL: https://open.jiacedata.com/v1/api/openapi/order/orderRefund

Type: POST

Author: lones

Content-Type: application/json; charset=utf-8

Description: 订单售后申请

Body-parameters:

Parameter Type Description Required Since

tradeNo

int64

店铺订单号

true

-

refundType

int32

退款类型，1：仅退款，2：退货退款 3：售后取消

true

-

refundAmount

int64

退款金额

true

-

refundCarriage

int64

退运费金额

false

-

refundReason

string

售后原因
描述:
20006 不想买了
20002 卖家缺货
20003 卖家不支持在线交易
20005 卖家调价
27060 等不及
27061 订单信息拍错（规格/尺码/颜色等
27063 地址/电话信息填写错误
20010 快递/物流一直未送到
20011 快递/物流无有效跟踪记录
20012 因未按约定时间发货拒签
20013 验货货品有问题拒签
20014 运费与约定不符拒签
20004 未按约定时间发货
20078 印刷问题
20028 不想买了，已与卖家协商一致
20015 拒签未收到退款
20030 无理由退货
20023 少货（含少配件）
20027 假冒品牌
20032 包换服务
20034 发票、赠品、折扣
20035 运费差价
21067 七天无理由退换货
24000 破损/污渍/划痕/变形
24001 尺寸/型号/规格与描述不符
24002 颜色/款式与描述不符
24003 材质/成分与描述不符
24006 材质硬度/承重与描述不符
24011 脱胶/配件不匹配做工问题
27062 与卖家协商一致
28006 做工/瑕疵问题

true

-

refunddDesc

string

售后描述

false

-

vouchers

string

凭证图片URLs。1-5张，图片域名/相对路径”
[https://cbu01.alicdn.com/img/ibank/2019/901/930/11848039109.jpg]

false

-

Request-example: 

curl -X POST -H 'Content-Type: application/json; charset=utf-8' -i /openapi/order/orderRefund --data '{
	"tradeNo": 147,
	"refundType": 741,
	"refundAmount": 521,
	"refundCarriage": 883,
	"refundReason": "xgkn9i",
	"refunddDesc": "x3i3qv",
	"vouchers": "0oxe4f"
}'

Response-fields:

Field Type Description Since

code

int64

No comments found.

-

message

string

No comments found.

-

data

object

No comments found.

-

└─refundId

string

退款单号

-

└─refundStatus

int32

退款状态,1：已取消,2:退货中,3:退款中,4：退款成功，5：退款关闭，6：退款拒绝

-

└─refundAmount

int64

退款金额

-

Response-example: 

{
	"code": 202,
	"message": "success",
	"data": {
		"refundId": "6713122512",
		"refundStatus": 1
		"refundAmount": 6139.99
	}
}

4.4. 售后原因查询

URL: https://open.jiacedata.com/v1/api/openapi/order/getRefundReason

Type: POST

Author: lones

Content-Type: application/x-www-form-urlencoded;charset=utf-8

Description: 售后原因查询

Request-example: 

curl -X POST -i /openapi/order/getRefundReason

Response-fields:

Field Type Description Since

code

int64

No comments found.

-

message

string

No comments found.

-

data

array

No comments found.

-

└─reasonId

int32

售后原因id,描述
20006 不想买了
20002 卖家缺货
20003 卖家不支持在线交易
20005 卖家调价
27060 等不及
27061 订单信息拍错（规格/尺码/颜色等
27063 地址/电话信息填写错误
20010 快递/物流一直未送到
20011 快递/物流无有效跟踪记录
20012 因未按约定时间发货拒签
20013 验货货品有问题拒签
20014 运费与约定不符拒签
20004 未按约定时间发货
20078 印刷问题
20028 不想买了，已与卖家协商一致
20015 拒签未收到退款
20030 无理由退货
20023 少货（含少配件）
20027 假冒品牌
20032 包换服务
20034 发票、赠品、折扣
20035 运费差价
21067 七天无理由退换货
24000 破损/污渍/划痕/变形
24001 尺寸/型号/规格与描述不符
24002 颜色/款式与描述不符
24003 材质/成分与描述不符
24006 材质硬度/承重与描述不符
24011 脱胶/配件不匹配做工问题
27062 与卖家协商一致
28006 做工/瑕疵问题

-

└─reasonDesc

string

售后原因描述

-

Response-example: 

{
	"code": 404,
	"message": "success",
	"data": [
		{
			"reasonId": 511,
			"reasonDesc": "a4dwn8"
		}
	]
}

4.5. 提交订单退货信息

URL:  https://open.jiacedata.com/v1/api/openapi/order/returnGoods

Type: POST

Author: lones

Content-Type: application/json; charset=utf-8

Description: 订单列表查询

Body-parameters:

Parameter Type Description Required Since

refundId

string

售后id

true

-

logisticsCompanyName

string

物流公司名称

true

-

freightBill

string

快递单号

true

-

description

string

退货描述

false

-

Request-example: 

curl -X POST -H 'Content-Type: application/json; charset=utf-8' -i /openapi/order/returnGoods --data '{
	"refundId": "20",
	"logisticsCompanyName": "明轩.苏",
	"freightBill": "5dboj7",
	"description": "2ex212"
}'

Response-fields:

Field Type Description Since

code

int64

No comments found.

-

message

string

No comments found.

-

data

object

No comments found.

-

Response-example: 

{
	"code": 359,
	"message": "success",
	"data": {
		"waring": "You may have used non-display generics."
	}
}