电商订单 (交易接口)
申报电商订单
请求
- 接口路径:v1/dec-order/declare
- 请求方法:POST
- 请求头内容:
- Content-Type: application/json
- 请求Body内容
{
"requestId": "1",
"businessType": "B",
"data": {
"head": {},
"goodsList": []
// 详细字段请参考:报关单数据模型
}
}
| 属性 | 类型 | 是否必填 | 说明 |
| requestId | String | 非必填 | 请求ID: 确保幂等性,相同请求重发请用同一个请求ID 。空值代表不使用幂等 |
| businessType | String | 必填 | 业务类型: 看下文描述 |
| region | String | 非必填 | 申报通道 |
| data | DeclarationData | 必填 | 电商订单表单,请查看电商订单数据模型 |
响应
{
"success": true,
"message": null,
"result": "订单id",
"error": null
}
{
"success": false,
"message": "失败信息",
"result": null,
"error": null
}
| 属性 | 类型 | 说明 |
| success | Boolean | 创建是否成功 true成功 false 失败 |
| message | String | 创建失败返回错误消息 |
| result | String | 返回唯一内部编号 |
| error | String | 错误代码 |
附:数据模型
电商订单数据模型
{
"head": {
"appType": "1",
"businessType": null,
"declareName": null,
"declareCode": null,
"appTime": null,
"appStatus": null,
"orderType": "W",
"orderNo": "SZHTXXW246015475203102026076887",
"tradeCode": "1234567890",
"tradeScc": null,
"tradeName": "XXX公司",
"dxpId": null,
"ebpCode": "无",
"ebpName": "Abacus Electric",
"ebcCode": "1234567890",
"ebcName": "XXX公司",
"goodsValue": 1200,
"freight": 0,
"currency": "142",
"note": null
},
"goodsList": [
{
"gnum": 1,
"itemNo": "HX562120260310074752",
"itemName": "塑料玩具",
"itemDescribe": null,
"barCode": null,
"unit": "007",
"currency": "142",
"qty": 100,
"price": 12,
"totalPrice": 1200,
"note": null
}
]
}
字段说明
表头字段(head)
| 参数名称 | 参数含义 | 数据类型 | 参数说明 (或示例) | 必填 |
| appType | 报送类型 | String | | 否 |
| businessType | 业务类型 | String | B-B2B 出口订单,W-海外仓订仓单 | 是 |
| declareName | 申报企业名称 | String | | 否 |
| declareCode | 申报企业编号 | String | | 否 |
| appTime | 企业报送时间 | Date | | 否 |
| appStatus | 企业报送状态 | String | | 否 |
| orderType | 订单类型 | String | I-进口;E-B2C出口订单;B-B2B出口订单;W-海外仓订仓单 | 是 |
| orderNo | 订单编号 | String | 电商平台的唯一订单号(如:SZHTXXW246015475203102026076887) | 是 |
| tradeCode | 收发货人代码 | String | | 是 |
| tradeScc | 收发货人 18 位信用代码 | String | | 否 |
| tradeName | 收发货人名称 | String | | 是 |
| dxpId | dxpId | String | | 否 |
| ebpCode | 电商平台代码 | String | 电商平台在海关注册的代码(如无则填"无") | 是 |
| ebpName | 电商平台名称 | String | 电商平台企业全称 | 是 |
| ebcCode | 电商企业代码 | String | 电商企业的 10 位海关编码 | 否 |
| ebcName | 电商企业名称 | String | 电商企业全称 | 否 |
| goodsValue | 商品金额 | BigDecimal | 订单中所有商品的总金额(如:1200) | 是 |
| freight | 运杂费 | BigDecimal | 运费和杂费,无则填写"0" | 是 |
| currency | 币制 | String | 货币代码,数字类(如:142 代表人民币) | 是 |
| note | 备注 | String | 其他需要说明的信息 | 否 |
商品列表字段(goodsList)
| 参数名称 | 参数含义 | 数据类型 | 参数说明 (或示例) | 必填 |
| gnum | 序号 | Integer | 商品在列表中的顺序号(从 1 开始) | 是 |
| itemNo | 商品货号 | String | 企业内部的商品货号(C..30) | 是 |
| itemName | 商品名称 | String | 商品的中文名称(C..250) | 是 |
| itemDescribe | 商品描述 | String | 商品的详细描述信息(C..1000) | 否 |
| barCode | 条形码 | String | 商品的条形码或 EAN 码(C..50) | 否 |
| unit | 计量单位 | String | 商品的计量单位代码(C3,如:007 表示个) | 是 |
| currency | 币制 | String | 该商品的货币代码(如:142) | 是 |
| qty | 数量 | BigDecimal | 商品的购买数量(N19,5) | 是 |
| price | 单价 | BigDecimal | 商品的单价(N19,5) | 是 |
| totalPrice | 总价 | BigDecimal | 商品的总金额=单价×数量(N19,5) | 是 |
| note | 备注 | String | 该商品的特殊说明(C..1000) | 否 |