接口说明 - 友米SCRM

接口地址: https://api2.yunshouzhi.net/jqthirdapi/notify/order/custom/{appId}?sign=

签名参数:

appId: 用户在金桥-店铺管理添加店铺时填写的店铺标识

appSecret:y3提供

sign: sign=MD5(appId+data+appSecrect) 32位小写
开发时向y3技术人员索要联调账号

请求方式:POST
公共参数:

参数名称	参数说明	是否必须	类型	示例
msgId	消息唯一id	是	string	-
eventType	事件标识	是	string	TradeCreate
msgTime	消息产生时间 13位时间戳	是	long	1644995394273
data	消息体序列化后json字符串	是	string	-

示例:

完整订单消息字段:

参数名称	参数说明	是否必须	数据类型
orderNumber	订单号	true	string
orderAmount	订单金额（分）包含运费应付金额	true	integer(int64)
payAmount	支付金额（分）	false	integer(int64)
postAmount	邮费（分）	false	integer(int64)
payType	支付类型货到付款 = 0, 线上支付 = 1	false	integer(int32)
orderStatus	订单正向状态待支付或待确认 = 1, 备货中 = 2, 已发货 = 3, 已关闭 = 4, 已完成 = 5,	false	integer(int32)
tpState	下单state，如果是带参下单页面，打开下单页面时url中携带的state	false	string
receiverName	收货人	false	string
receiverMobile	收件人手机号码	false	string
receiverProvince	省	false	string
receiverCity	市	false	string
receiverDistrict	区	false	string
receiverStreet	街道	false	string
receiverAddress	收货地址	false	string
buyerWords	买家备注	false	string
sellerWords	卖家备注	false	string
cancelReason	订单取消原因	false	string
skuOrders	产品信息	true	array
skuOrderNumber	sku订单(子订单)号如果没有父子订单结构与父订单号相同	false	string
productCode	商品编码商家填写同y3款号	true	string
productId	商品ID	false	string
skuId	商品skuid	false	string
skuHash	规格组合如商品名+sku1+sku2 唯一sku的标识	true	string
productBarcode	商品条形码	false	string
productName	商品名称	false	string
productPicture	商品图片	false	string
productPrice	商品单价（分）	true	integer(int64)
cancelReason	订单取消原因	false	string
productNum	商品数量	true	integer(int32)
skuOrderAmount	商品订单应付金额	true	integer(int64)
orderStatus	子订单正向状态待支付或待确认 = 1, 备货中 = 2, 已发货 = 3, 已关闭 = 4, 已完成 = 5, 如果平台没有则以父订单状态为准	true	integer(int32)
attrs	其他属性 key-value 如 {"是否处方单":"是"}	false	object
logistics	发货信息	false	array
skuOrderIds	子订单id	false	array
logisticsName		false	string
logisticsCode		false	string
logisticsNo	快递单号	false	string
deliveryTime	发货时间 13位时间戳 0 表示未设置	false	integer(int64)
expDeliveryTime	买家预设的发货时间 13位时间戳	false	integer(int64)
receiptTime	收货时间 13位时间戳	false	integer(int64)
payTime	支付时间 13位时间戳	false	integer(int64)
createTime	下单时间 13位时间戳	false	integer(int64)
updateTime	订单最后修改时间 13位时间戳	false	integer(int64)
customer		false
code	客户编码	false	string
mobile	客户手机号没有默认使用收货人手机号	false	string

示例: