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×tamp=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×tamp=1551321072039&topSign=321D0C06A9FCA5F4C2596C3C22F22D6EEF483146
1.3返回json示例
成功返回
返回内容说明
{
"code": "",
"data": {
"depotOrderSn": “20180416123"(供应商创建成功的订单号)
},
"message": "",
"result": 1,
"success": true
}
失败返回
返回内容说明
{
"code": "",(错误编码)
"data": "",
"message": ""(消息),
"result": 0(结果:1:成功;0:失败),
"success": false(是否成功)
}