开放文档-SiC B2B2C Shop v2.0 : 接口设计-订单、购物车、咨询、评价、发票

编号

类型

接口名

所在controller

参数

参数类型

参数默认值

参数备注

接口返回值

映射地址

接口备注

1

咨询





tradeConsultationList

TradeConsultationController





consultationIds

String

多个咨询ids

{status:0、1、2,

msg:xxx,

data:List<TradeConsultation>,

page:null

}

/{version}/trade/consultation/list

查询我的商品咨询信息(不分页)

type

String

类别,0咨询、1回复

category

String

咨询类型

isReply

String

是否回复

limit

int

10

数量

2

咨询





tradeConsultationPage

TradeConsultationController





consultationIds

String

多个咨询ids

{status:0、1、2,

msg:xxx,

data:List<TradeConsultation>,

page:page

}

/{version}/trade/consultation/page

查询我的商品咨询信息(分页)

type

String

类别,0咨询、1回复

category

String

咨询类型

isReply

String

是否回复

pageNoe

String

页码

pageSize

String

每页大小

3

咨询

tradeConsultationSave

TradeConsultationController



pid

Long

商品id

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/consultation/save

提交商品咨询

category

String

咨询类型

content

String

咨询内容

4

评价

tradeCommentPage

TradeCommentController





replyIds

String

回复的评价id

{status:0、1、2,

msg:xxx,

data:List<TradeComment>,

page:page

}


/{version}/trade/comment/page

获取商品评价信息

type

String

评价类型(0评论、1追评、2回复)

grade

String

评价等级(1好评,2中评,3差评)

pageNo

String

页码,取第几页

pageSize

String

20

每页大小

pageCount

String

总记录数

5

评价

tradeCommentSave

TradeCommentController










orderId

String

订单id

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/comment/save

提交评价

isAddComment String 是否追评

serviceAttitudeScore

String

卖家服务态度评分

content String 评论内容

pid

String

商品id( 多个商品id用逗号分割 )

skuId

String

skuId ( 多个skuId用逗号分割 )

productScore String 商品评分(多个评分有逗号分割)

grade

String

评价等级(多个等级用逗号分割)

imgPath

String

图片地址(多个图片地址用逗号分割)

6

评价

tradeCommentImageList

TradeCommentController

commentIds

String

评价id

{status:0、1、2,

msg:xxx,

data:List<TradeCommentImage>,

page:page

}

/{version}/trade/comment/image/list

根据多个评价id获取评价的图片

7

评价

tradeCommentHide

TradeCommentController

commentId

String

评价id

{status:0、1、2,

msg:xxx,

data:null,

page:page

}

/{version}/trade/comment/hide

隐藏\显示评价

isShow

String

是否显示(0否、1是)

8

获取发票列表

tradeDeliverList

TradeDeliverController

limit

String

10

数量

{status:0、1、2,

msg:xxx,

data:TradeDeliverList,

page:null

}

/{version}/trade/deliver/list

获取发票列表

9

查询发票信息(单个)

tradeDeliverOne

TradeDeliverController

deliverId

String

发票id

{status:0、1、2,

msg:xxx,

data:TradeDeliver,

page:null

}

/{version}/trade/deliver/one

查询发票信息(单个)

10

新增发票

tradeDeliverSave

TradeDeliverController

deliverType

String

发票类型:1普通发票,2增值税普通发票,3增值税专用发票

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/deliver/Save

新增发票信息

companyName

String

公司名称

axpayerIdentityNumber

String

纳税人识别号

openingBank

String

开户行

accountNumber

String

账号

address

String

地址

phone

String

手机号

hbjbuyer String 默认,0否、1是

11

编辑发票

tradeDeliverEdit

TradeDeliverController

deliverId

String

发票id

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/deliver/Save

新增发票信息

deliverType

String

发票类型:1普通发票,2增值税普通发票,3增值税专用发票

companyName

String

公司名称

axpayerIdentityNumber

String

纳税人识别号

openingBank

String

开户行

accountNumber

String

账号

address

String

地址

phone

String

电话

hbjbuyer String 默认,0否、1是

12

删除发票

tradeDeliverDelete

TradeDeliverController

deliverId

String

发票id

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/deliver/delete

删除发票信息

13

发票信息设为默认

tradeDeliverDefault

TradeDeliverController

deliverId

String

发票id

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/deliver/default

发票信息设为默认

hbjbuyer

String

默认,0否、1是

14

查看物流信息

trderLogisticsInfo

TradeOrderController

orderId

String

订单号

{status:0、1、2,

msg:xxx,

data:Map<String,Object>,

page:null

}

/{version}/trade/logistics/info

可以查看当前订单的物流信息

15

购物车

tradeCartSave

TradeCartController

pid

String

商品id

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/cart/save

加入购物车

skuMsg

String

sku信息(skuId-数量,shuId-数量,...)

type

String

商品类型(1零售,2批发)

16

购物车

tradeCartList

TradeCartController

{status:0、1、2,

msg:xxx,

data:List<TradeCart>,

page:null

}

/{version}/trade/cart/list

获取购物车数据

17

购物车

tradeCartDelete

TradeCartController

isAll

String

是否是全部

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/cart/delete

删除购物车数据

cartIds

String

多个购物车ids

18

购物车

tradeCartUpdateCount

TradeCartController

count

String

数量

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/cart/updateCount

更新购物车的商品数量

cartId

String

购物车id

19

订单

tradeConfirmOrderValidate

TradeOrderController

pid

String

商品id

{status:0、1、2,

msg:xxx,

data:{true/false},

page:null}

/{version}/trade/order/confimOrder/validate

验证确认订单页数据接口

skuMsg

String

skuMsg sku信息(skuId-数量,shuId-数量,...)

type

String

商品类型(1零售,2批发)

totalNum

String

购买数量

purchasingAmount

String

起购量

stat

String

下单入口,1从购物车下单,0从订单详情页下单

ids

String

购物车的多个id

priceSum

String

总价格

20

订单

tradeConfirmOrder

TradeOrderController

pid

String

商品id

{status:0、1、2,

msg:xxx,

data:{"cartmap":"",

"priceSum":"",

},

page:null

}

/{version}/trade/order/confimOrder

获取确认订单页的数据

skuMsg

String

skuMsg sku信息(skuId-数量,shuId-数量,...)

type

String

商品类型(1零售,2批发)

totalNum

String

购买数量

purchasingAmount

String

起购量

stat

String

下单入口,1从购物车下单,0从订单详情页下单

ids

String

购物车的多个id

priceSum

String

总价格

21

订单

tradeOrderSave

TradeOrderController

keyss

String

map的键:店铺名-店铺id

{status:0、1、2,

msg:xxxx,

data:Map<String,Object>,

page:null

}

/{version}/trade/order/save

提交订单,返还参数是map,有2个键值对。

1.tradeOrderList:存储的数据是订单数据列表

2.paySwitch:在线支付的开启与关闭:0关闭、1开启


ids

String

购物车ids

addressId

String

收货地址id

deliverId

String

发票id

orderPrice

String

订单总额

22

订单



tradeOrderPage



TradeOrderController



status

String

根据状态查询订单

{status:0、1、2,

msg:xxx,

data:List<TradeOrder>,

page:page

}

/{version}/trade/order/page

查询订单数据

pageNo

String

页码

pageSize

String

每页大小

23

订单

tradeOrderOne

TradeOrderController

orderId

String

根据订单编号查询订单

{status:0、1、2,

msg:xxx,

data:TradeOrder,

page:null

}

/{version}/trade/order/one

订单

24

订单详情

tradeOrderItemList

TradeOrderController

orderIds

String

根据多个订单编号查询订单

{status:0、1、2,

msg:xxx,

data:List<TradeOrderItem>,

page:null

}

/{version}/trade/orderItem/list

订单详情

count

String

返回数量

1.查看详情返回1个

2.订单详情返回所有

25

订单

tradeCancelOrder

TradeOrderController

orderId

String

根据订单编号取消订单

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/order/cancelOrder

取消订单

reason

String

取消订单理由

26

订单

tradeConfirmReceipt

TradeOrderController

orderId

String

根据订单编号确认收货

{status:0、1、2,

msg:xxx,

data:null,

page:null

}

/{version}/trade/order/confirmReceipt

确认收货

27

订单

tradeCalculateFreight

TradeOrderController

pids

String

多个商品id(逗号分割)

{status:0、1、2,

msg:xxx,

data:freight,

page:null

}

/{version}/trade/order/calculateFreight

计算运费

addressIds

String

多个收货地址id (逗号分割)

counts

String

多个商品数量 (逗号分割)

28

微信支付

weiXinPay

WeiXinController




total_fee

String

支付金额

{status:0、1、2,

msg:xxx,

data:{status:"",code:""},

page:null

}

/{version}/weixin/pay



微信支付



orderId

String

订单id

body

String

商品名

29 获取微信信息 weixinInfo WeiXinController url String 当页面的url

{status:0、1、2,

msg:xxx,

data:Map<String,Object>,

page:null

}

/{version}/weixin/info 获取微信信息(access_token,signature,timestamp,noncestr,appId)