推单接口

作者 HDY | 6月 26, 2023

0 评论

1.推单接口

1.1接口信息

*地址：*	以供应商提供的url为准
*描述：*	海带这边创建订单成功后，推送给供应商 sum(item.salePrice*item.Num)-main.preferential=main.buyAmount-main.shippingAmount-main.taxAmount
*输出参数*
*字段名*	*字段类型*	*是否必选*	说明
*Price*	*number*	Y	*订单成本价（用于和供应商结算的金额）*
*preferential*	*number*	Y	*优惠金额（具体值计算参考接口描述，只有保税订单才会出现不为0，其他情况都为0）*
*Tax*	*number*	Y	*税费金额*
*thirdOrder*	*string*	N	*拼多多第三方订单号*
*shippingAmount*	*number*	Y	*运费金额*
*orderSn*	*string*	Y	*海带订单号*
*createTime*	*date*	Y	*下单时间**(yyyy-MM-dd HH:mm:ss)*
*paySuccessTime*	*date*	Y	*支付时间（yyyy-MM-dd HH:mm:ss）*
*payTradeNo*	*string*	N	*支付单号（保税订单必传）*
*remark*	*string*	Y	*订单备注*
*buyAmount*	*number*	N	*代购价**(实付款，保税订单专用)*
commercePlatform RecordCode	*string*	N	*电商平台备案号，保税商品必填*
commercePlatform RecordName	*string*	N	*电商平台备案名称，保税商品必填*
paymentCompany CustomsRecordCode	*string*	N	*支付公司海关备案编号，保税商品必填*
paymentCompany CustomsRecordName	*string*	N	*支付公司海关备案名称，保税商品必填*
*shipInfo*	*object*	Y	*收件信息*
*orderItems*	*array*	Y	*订单商品项*
*depotId*	*string*	Y	*供应商仓库id（可用于供应商多仓区分订单）*

详细信息

*字段名*	*字段类型*	*是否必选*	说明
*address*	*string*	Y	*收件地址*
*province*	*string*	Y	省
*City*	*string*	Y	市
*region*	*string*	Y	区
*identification*	*string*	Y	*报关人身份证号*
*name*	*string*	Y	*报关人姓名*
*phone*	*string*	Y	*收件人手机号*
*receiverIdNum*	*string*	Y	*收货人身份证*
*receiverName*	*String*	Y	*收货人名称*

orderItems详细信息

*字段名*	*字段类型*	*是否必选*	说明
*productNum*	*number*	Y	*规格数量，2代表2件装*
*Name*	*string*	Y	*商品名称*
*Num*	*number*	Y	*规格购买数量*
*Price*	*number*	Y	*规格成本价格（规格级别）*
*salePrice*	*number*	Y	*规格售价（规格级别）*
*productName*	*string*	Y	*规格名称*
*Psn*	*string*	Y	*供货商商品货号*
*shippingAmount*	*number*	Y	运费*（商品级别）*
*Tax*	*number*	Y	税费*（商品级别）*

1.2请求示例

http://oms.gongyings.cn/api/hdpac?appkey=93029941&buyAmount=1320.00&commercePlatformRecordCode=3302462179&commercePlatformRecordName=宁波诚淘电子商务有限公司&createTime=2019-02-28 09:51:31&depotId=39713fdd64fc11e8be487cd30adbc118&orderItems=[{"productName":"6罐装","productNum":6,"num":1,"name":"(全新包装）澳大利亚a2白金婴儿奶粉3段900g","price":1093.76,"hdGoodsSn":"310516625460005172","psn":"310516625460005172","shippingAmount":0.00,"tax":132.95}]&orderSn=201902280120594767&paySuccessTime=2019-02-28 10:27:10&payTradeNo=4200000280201902287089746833&paymentCompanyCustomsRecordCode=440316T004&paymentCompanyCustomsRecordName=财付通支付科技有限公司&preferential=0.00&price=1226.71&remark=空&shipInfo={"name":"韦年","identification":"450121112345126343","phone":"18112345663","address":"广西南宁市良庆区大沙田大龙街一巷55号","province":"广西壮族自治区","region":"良庆区","city":"南宁市"}&shippingAmount=0.00&tax=132.95&timestamp=1551321072039&topSign=321D0C06A9FCA5F4C2596C3C22F22D6EEF483146

需要URLEncode编码

http://oms.gongyings.cn/api/hdpac?appkey=93029941&buyAmount=1320.00&commercePlatformRecord-Code=3302462179&commercePlatformRecordName=%E5%AE%81%E6%B3%A2%E8%AF%9A%E6%B7%98%E7%94%B5%E5%AD%90%E5%95%86%E5%8A%A1%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8&createTime=2019-02-28+09%3A51%3A31&depotId=39713fdd64fc11e8be487cd30adbc118&orderItems=%5B%7B%22productName%22%3A%226%E7%BD%90%E8%A3%85%22%2C%22product-Num%22%3A6%2C%22num%22%3A1%2C%22name%22%3A%22%28%E5%85%A8%E6%96%B0%E5%8C%85%E8%A3%85%EF%BC%89%E6%BE%B3%E5%A4%A7%E5%88%A9%E4%BA%9Aa2%E7%99%BD%E9%87%91%E5%A9%B4%E5%84%BF%E5%A5%B6%E7%B2%893%E6%AE%B5900g%22%2C%22price%22%3A1093.76%2C%22hdGoodsSn%22%3A%22310516625460005172%22%2C%22psn%22%3A%22310516625460005172%22%2C%22shippingAmount%22%3A0.00%2C%22tax%22%3A132.95%7D%5D&orderSn=201902280120594767&paySuccessTime=2019-02-28+10%3A27%3A10&payTradeNo=4200000280201902287089746833&paymentCompanyCustomsRecord-Code=440316T004&paymentCompanyCustomsRecordName=%E8%B4%A2%E4%BB%98%E9%80%9A%E6%94%AF%E4%BB%98%E7%A7%91%E6%8A%80%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8&preferential=0.00&price=1226.71&remark=%E7%A9%BA&shipInfo=%7B%22name%22%3A%22%E9%9F%A6%E7%BE%8E%E5%B9%B4%22%2C%22identification%22%3A%22450121199406126343%22%2C%22phone%22%3A%2218176268663%22%2C%22address%22%3A%22%E5%B9%BF%E8%A5%BF%E5%8D%97%E5%AE%81%E5%B8%82%E8%89%AF%E5%BA%86%E5%8C%BA%E5%A4%A7%E6%B2%99%E7%94%B0%E9%A1%BA%E9%A3%8E%E8%A1%97%E4%B8%80%E5%B7%B755%E5%8F%B7%22%2C%22province%22%3A%22%E5%B9%BF%E8%A5%BF%E5%A3%AE%E6%97%8F%E8%87%AA%E6%B2%BB%E5%8C%BA%22%2C%22region%22%3A%22%E8%89%AF%E5%BA%86%E5%8C%BA%22%2C%22city%22%3A%22%E5%8D%97%E5%AE%81%E5%B8%82%22%7D&shippingAmount=0.00&tax=132.95&timestamp=1551321072039&topSign=321D0C06A9FCA5F4C2596C3C22F22D6EEF483146

1.3返回json示例

成功返回

返回内容说明

{
	"code": "",
	"data": {
		"depotOrderSn": “20180416123"（供应商创建成功的订单号）
	},
	"message": "",
	"result": 1,
	"success": true
}

失败返回

返回内容说明

{
	"code": "",（错误编码）
	"data": "",
	"message": ""（消息）,
	"result": 0（结果：1：成功；0：失败）,
	"success": false（是否成功）
}

发表评论取消回复