发送订单
接口描述
需要供应商提供接口。入参、出参规则必须遵循文档接口描述。
API
由供应商提供- 参数格式
POST application/x-www-form-urlencoded- 入参
| 参数名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| token | String | yes | 授权时获取的 access token |
| orderCode | String | yes | 订单号 |
| orderType | String | yes | 订单类型，SALE: 销售单， PURCHASE: 采购单 |
| orderTime | String | no | 若值为空，会默认当前时间 |
| orderAmount | BigDecimal | yes | 订单金额=商品总销售金额+运费 |
| costAmount | BigDecimal | yes | 成本金额=商品总协议金额，不含运费 |
| freightAmount | BigDecimal | yes | 运费 |
| orderStatus | Integer | yes | 主订单状态（10 - 待审核、20 - 待付款、30 - 待发货、40 - 待收货、50 - 已完成、60 - 已取消、70 - 下单失败） |
| paymentWay | Integer | no | 支付方式（10 - 授信余额支付、20 - 微信支付、21 - app微信支付、30 - 银联支付、31 - app银联支付、40 - 积分支付、41 - 优惠支付、50 - 组合支付、60 - 支付宝支付、61 - app支付宝支付、70 - 转账、71 - 公司转账、72 - 内部转账、80 - 钱包支付、81 - 汇豆支付、90 - 平台承担） |
| recipientMan | String | yes | 收货人 |
| recipientPhone | String | yes | 收货人电话 |
| recipientRegion | String | yes | 收货行政区域，行政区域编号，用'_'连接省、市、区等 |
| recipientAddress | String | yes | 收货地址 |
| invoiceType | Integer | no | 发票类型（10 - 增值税专票、20 - 增值税普票） |
| invoiceState | Integer | no | 开票方式（10 - 集中开票、20 - 随单开票） |
| invoiceTitleType | Integer | no | 发票抬头类型（10 - 个人、20 - 企业） |
| invoiceTitle | String | no | 发票抬头 |
| invoiceContent | Integer | no | 发票内容（10 - 明细、100 - 大类） |
| taxpayerNumber | String | no | 纳税人识别号 |
| String | no | 开票邮箱 | |
| telephone | String | no | 开票电话 |
| address | String | no | 开票地址 |
| openBank | String | no | 开户银行 |
| bankAccount | String | no | 开户银行账户 |
| orderDetails | String | yes | 下单商品明细 |
| orderCoupons | String | no | 优惠券信息集合 |
下单商品明细
| 参数名称 | 类型 | 非空 | 描述 |
|---|---|---|---|
| skuCode | String | yes | 平台商品sku |
| supplierSku | String | yes | 商家商品sku |
| quantity | Integer | yes | 商品数量 |
| agreementPrice | BigDecimal | yes | 协议价 |
| ableRefund | Integer | yes | 是否可退货，0 - 否，1 - 是 |
| ableRefundQuantity | Integer | yes | 可退货数量 |
| needGift | Integer | yes | 是否需要赠品商品，0 - 否，1 - 是 |
| materialCode | String | no | 物料编码 |
优惠券信息集合
| 参数名称 | 类型 | 非空 | 描述 |
|---|---|---|---|
| couponType | Integer | yes | 优惠券类型（10 - 平台优惠券、20 - 商家优惠券） |
| couponCode | String | yes | 优惠券编号 |
| couponPrice | BigDecimal | yes | 优惠券面值 |
| quantity | Integer | yes | 数量 |
| couponDescription | String | yes | 优惠券描述 |
| skuCode | String | no | 当前优惠券关联的sku |
- 出参
| 参数名称 | 类型 | 非空 | 描述 |
|---|---|---|---|
| data | String | 是 | 供应商订单编码 |
- 入参示例
{
"token": "your_access_token",
"orderCode": "ORD123456",
"orderType": "SALE",
"orderTime": "2023-10-14T12:34:56",
"orderAmount": 1500.25,
"costAmount": 1200.50,
"freightAmount": 50.00,
"orderStatus": 30,
"paymentWay": 20,
"recipientMan": "张三",
"recipientPhone": "13800138000",
"recipientRegion": "110000_110100_110101",
"recipientAddress": "北京市东城区某某路123号1单元101室",
"invoiceType": 10,
"invoiceState": 20,
"invoiceTitleType": 20,
"invoiceTitle": "某某公司",
"invoiceContent": 10,
"taxpayerNumber": "1234567890",
"email": "zks@company.com",
"telephone": "010-12345678",
"address": "开票地址示例",
"openBank": "某某银行",
"bankAccount": "1234567890123456",
"orderDetails": [
{
"skuCode": "SKU12345",
"supplierSku": "SUPSK12345",
"quantity": 2,
"agreementPrice": 600.00,
"ableRefund": 1,
"ableRefundQuantity": 1,
"needGift": 0,
"materialCode": "MAT12345"
}
],
"orderCoupons": [
{
"couponType": 10,
"couponCode": "CPN123456",
"couponPrice": 100.00,
"quantity": 1,
"couponDescription": "平台优惠券描述",
"skuCode": "SKU12345"
}
]
}- 出参示例
{
"code": 200,
"data": "",
"message": "",
"success": true
}