电商订单 (交易接口)


申报电商订单

请求

  • 接口路径: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 必填 电商订单表单,请查看电商订单数据模型
  • 业务类型:
    • B - B2B出口订单
    • W - 海外仓订仓单

响应

  • HTTP状态: 200 代表调用成功

  • 响应正文:

{
  "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)