晟湾跨境电商综合配置指南
概述
本文档提供晟湾跨境电商综合平台的对接配置说明，包括API接口配置、参数说明、数据格式和示例等。
适用范围
支持的贸易方式
- 9610：跨境电子商务
- 1210：保税跨境贸易电子商务
- 9710：跨境电子商务企业对企业直接出口
- 9810：跨境电子商务出口海外仓
方案配置指南
适配器配置
- 写入适配器:
Adapter\ShengWanCross\ShengWanCrossExecuteAdapter
- 暂存接口:
/cbec/v1/openapi/staging
接口参数说明
主要请求参数 (request)
| 序号 | 字段名 | 字段描述 | 类型 | 必填 | 说明 |
|---|
| 1 | currency | 币制 | C3 | 否 | 三位数字142/502 |
| 2 | country | 运抵国 | C3 | 否 | 三位数字 |
| 3 | goodsInfo | 主要货物信息 | C..200 | 否 | - |
| 4 | wrapType | 包装种类 | C1 | 否 | 1木箱，2纸箱，3桶装，4散装，5托盘，6包，7其他 |
| 5 | ebpCode | 电商平台代码 | C..18 | 是 | 填 “无” |
| 6 | ebpName | 电商平台名称 | C..100 | 是 | 境外电商平台名称 |
| 7 | ebcCode | 电商企业代码 | C..18 | 否 | - |
| 8 | ebcName | 电商企业名称 | C..100 | 否 | - |
| 9 | ebcTelephone | 电商企业电话 | C..50 | 是 | - |
| 10 | payCode | 支付企业代码 | C..18 | 是 | 支付企业的海关编码,国内企业必填 |
| 11 | payName | 支付企业名称 | C..100 | 是 | 支付企业名称,非线上支付填"现金支付" |
| 12 | ownerCode | 生产销售企业代码 | C..18 | 是 | 生产企业的海关注册登记编号或统一社会信用代码,未在海关登记的填NO |
| 13 | ownerName | 生产销售企业名称 | C..100 | 是 | - |
| 14 | copNo | 企业唯一编号 | C..30 | 是 | 出口：长度29位 SW1001E（平台分配）+YYYYMMDDhhmmssSSS+5位随机数；进口：长度20位 SW1001I+YYYYMMDD+5位随机数字或字母 |
| 15 | payNo | 支付交易编号 | C..60 | 否 | - |
| 16 | logisticsNo | 物流运单号 | C..80 | 否 | - |
| 17 | orderNo | 订单号 | C..60 | 否 | - |
| 18 | packNo | 件数 | N9 | 否 | - |
| 19 | charge | 支付金额 | N19.5 | 否 | - |
| 20 | goodsValue | 实际商品金额 | N19.5 | 否 | - |
| 21 | grossWeight | 毛重 | N19.5 | 否 | - |
| 22 | netWeight | 净重 | N19.5 | 否 | - |
| 23 | totalPackageNo | 总包号 | C..37 | 是 | 大包裹号(总包号) |
| 24 | iacCode | 区内企业代码 | C..18 | 是 | 特殊区域出口模式必填 |
| 25 | iacName | 区内企业名称 | C..100 | 是 | 特殊区域出口模式必填 |
| 26 | emsNo | 账册编号 | C..30 | 是 | - |
| 27 | freight | 运杂费 | N19.5 | 否 | 无则填写"0″ |
| 28 | fcurrency | 运费币制 | C3 | 否 | 3位币制数字 |
| 29 | fflag | 运费标志 | C1 | 否 | 1-率，2-单价，3-总价 (默认3) |
| 30 | insuredFee | 保费 | N19.5 | 否 | 无则填写"0″ |
| 31 | icurrency | 保费币制 | C3 | 否 | 3位币制数字 |
| 32 | iflag | 保费标志 | C1 | 否 | 1-率，2-单价，3-总价 (默认3) |
| 33 | licenseNo | 许可证号 | C..19 | 是 | - |
| 34 | consignee | 收货人姓名 | C..100 | 是 | - |
| 35 | consigneeAddress | 收货人地址 | C..200 | 是 | - |
| 36 | consigneeTelephone | 收货人电话 | C..50 | 是 | - |
| 37 | pod | 指运港代码 | C3..4 | 否 | - |
| 38 | accountingDate | 到账时间 | C14 | 否 | YYYYMMDDhhmmss |
| 39 | wayBillNo | 快递面单号 | C..80 | 是 | - |
| 40 | payMentOrgan | 收汇机构名称 | C..100 | 是 | - |
| 41 | payMentNo | 收汇机构申报单号 | C..80 | 是 | - |
| 42 | ext1 | 备用字段1 | C..200 | 是 | - |
| 43 | ext2 | 备用字段2 | C..200 | 是 | - |
| 44 | ext3 | 备用字段3 | C..200 | 是 | - |
| 45 | ext4 | 备用字段4 | C..200 | 是 | - |
| 46 | ext5 | 备用字段5 | C..200 | 是 | - |
| 47 | ext6 | 备用字段6 | C..200 | 是 | - |
| 48 | ext7 | 备用字段7 | C..200 | 是 | - |
商品信息参数 (goods)
| 序号 | 字段名 | 字段描述 | 类型 | 必填 | 说明 |
|---|
| 1 | gnum | 商品序号 | N5 | 否 | 从1开始的递增序号 |
| 2 | gcode | 商品HS编码 | C..10 | 否 | - |
| 3 | gname | 申报商品名称 | C..250 | 否 | - |
| 4 | gmodel | 规格型号 | C..250 | 否 | - |
| 5 | itemNo | 企业商品货号SKU | C..20 | 否 | - |
| 6 | itemRecordNo | 账册备案料号 | C..30 | 否 | 保税出口模式必填 |
| 7 | itemName | 企业商品名称 | C..250 | 是 | 企业自定义的商品名称，汇总后用于退税品名 |
| 8 | itemDescribe | 商品描述 | C..1000 | 是 | - |
| 9 | barcode | 条码 | C..50 | 是 | - |
| 10 | qty | 申报数量 | N19.5 | 否 | - |
| 11 | qty1 | 第一数量 | N19.5 | 否 | - |
| 12 | qty2 | 第二数量 | N19.5 | 否 | - |
| 13 | unit | 申报单位 | C3 | 否 | - |
| 14 | unit1 | 第一单位 | C3 | 否 | - |
| 15 | unit2 | 第二单位 | C3 | 否 | - |
| 16 | price | 单价 | N19.5 | 否 | - |
| 17 | totalPrice | 总价 | N19.5 | 否 | - |
| 18 | country | 目的国 | C3 | 否 | - |
| 19 | netWeight | 净重 | N19.5 | 否 | - |
| 20 | grossWeight | 毛重 | N19.5 | 否 | - |
| 21 | note | 备注 | C..1000 | 是 | - |
| 22 | countryCode | 境内货源地 | C..20 | 是 | - |
| 23 | producerName | 生产厂商 | C..100 | 是 | - |
| 24 | producerCode | 生产厂商代码 | C..18 | 是 | - |
| 25 | certNo | 鉴定证书编号 | C..64 | 是 | - |
| 26 | goodsLink | 商品链接 | C..250 | 是 | - |
| 27 | sellerId | 卖家ID | C..64 | 是 | - |
| 28 | ext1 | 备用字段1 | C..200 | 是 | - |
| 29 | ext2 | 备用字段2 | C..200 | 是 | - |
| 30 | ext3 | 备用字段3 | C..200 | 是 | - |
| 31 | ext4 | 备用字段4 | C..200 | 是 | - |
| 32 | ext5 | 备用字段5 | C..200 | 是 | - |
| 33 | ext6 | 备用字段6 | C..200 | 是 | - |
| 34 | ext7 | 备用字段7 | C..200 | 是 | - |
其他请求参数 (otherRequest)
提单数据 (bill)
| 字段名 | 字段描述 | 类型 | 必填 | 说明 |
|---|
| puid | 批次号 | C..32 | 否 | 同一批次下相同的唯一编号,可以理解同一个提单（一次申报）多次推送的编号相同 |
| billNo | 提运单号 | C32 | 是 | 无提单时可以置空 |
| voyageNo | 航班航次号 | - | 是 | 可以置空 |
| domesticTrafNo | 境内车牌 | - | 是 | 可以置空 |
| tradeMode | 贸易方式 | C4 | 否 | 9610、1210、9710、9810 |
| customsCode | 申报地海关 | C4 | 是 | 出口口岸 |
| loctNo | 监管场所代码 | C..10 | 是 | 同一申报地海关下有多个跨境电子商务的监管场所,需要填写区分 |
| portCode | 出口口岸代码 | C4 | 是 | 出口口岸代码 |
| orderType | 订单类型 | C1 | 是 | E-B2C出口订单；B-B2B出口订单；W-海外仓订仓单 |
| ieDate | 出口日期 | C8 | 是 | YYYYMMDD |
| leaveTime | 离境时间 | C14 | 是 | YYYYMMDDhhmmss |
| logisticsCode | 物流企业代码 | C..18 | 是 | - |
| logisticsName | 物流企业名称 | C..100 | 是 | - |
| note | 备注 | C..1000 | 是 | - |
| statisticsFlag | 申报业务类型 | C1 | 否 | A-简化申报;B-汇总申报 |
| agentCode | 申报企业代码 | C..18 | 是 | - |
| agentName | 申报企业名称 | C..100 | 是 | - |
| trafName | 运输工具名称 | C..100 | 是 | - |
| trafMode | 运输方式 | C1 | 是 | 4：陆运 5：空运 |
| operatorCode | 监管场所经营人代码 | C..18 | 是 | - |
| operatorName | 监管场所经营人名称 | C..100 | 是 | - |
metdata聚合写入。因为晟湾跨境电商综服平台单次是只支持100条数据。我们需要通过聚合写入，每天定时推送数据到中间平台
"operation": {
"rowsKey": "array",
"rows": 10000,
"method": "batchArraySave"
}
API接口配置接口回调配置
1. API路由地址
接口路径
{{API_PREFIX}}/api/open/shengwancross/shengwancross/{{strategyId}}
路径参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| strategyId | string | 是 | 方案ID，接收中间方案，UUID格式 |
请求示例
{{API_PREFIX}}/api/open/shengwancross/shengwancross/3ec116dc-1cae-3848-b479-93f4a8b27d97
2. 消息推送配置
配置结构
- bizCode: “RECEIPTALL” - 推送全部数据
- bizCode: “RECEIPT” - 推送单个数据
推送单个数据示例
{
"bizCode": "RECEIPT",
"appId": "SWXXXX",
"sign": "3feb679347fa0f36cfbd8479e830d6c757a51e27",
"appKey": "ni3ddTPblWPOQcIIROk78O69MJ7EQqOTyHzH",
"content": {
"puid": "20231221140321WZE",
"msgCount": "2",
"data": [
{
"logisticsNo": "10190441696",
"logisticsNoNew": "10190441696",
"inventoryNo": "53142023E5192920474",
"returnTime": "20231221140251918",
"returnStatus": "899",
"customerSysNo": "SW1001E20231220YZMCYUEGBMBCIB",
"items": [
{
"gno": 1,
"gcode": "9405429000",
"gname": "摄像灯",
"gmodel": "1|0|照明用|Yongnuo牌|||YN360 III PRO型",
"ext1": "ysyudyfua-11",
"itemNo": "FDS-23004",
"qty": 1,
"price": 74.81,
"totalPrice": "74.81000"
}
]
},
{
"logisticsNo": "9235990351032800159246",
"logisticsNoNew": "9235990351032800159246",
"inventoryNo": "53142023E5192921140",
"returnTime": "20231221140251918",
"returnStatus": "899",
"customerSysNo": "SW1001E20231220XAXXLJBITFNTTK",
"items": [
{
"gno": 1,
"gcode": "9405429000",
"gname": "摄像灯",
"gmodel": "1|0|照明用|Yongnuo牌|||YN360 III PRO型",
"ext1": "ysyudyfua-11",
"itemNo": "FDS-23004",
"qty": 1,
"price": 74.81,
"totalPrice": "74.81000"
}
]
}
]
},
"timestamp": "1703138601"
}
推送全部数据示例
{
"bizCode": "RECEIPTALL",
"appId": "SWSJHZ01",
"sign": "8717d1d04d3ae0eb1141e62dd96f190fb6ca6c39",
"appKey": "ni3ddTPblWPOQcIIROk78O69MJ7EQqOTyHzH",
"content": {
"wayBillHeadFromApiDto": {
"loctNo": "531496",
"trafMode": "4",
"trafName": "粤ZYZ98港",
"voyageNo": "粤ZYZ98港",
"billNo": "5100676119258",
"domesticTrafNo": "粤ZYZ98港",
"logisticsCode": "4403180007",
"logisticsName": "深圳市xxxx货运有限公司",
"tradeMode": "9610",
"batchNo": "FDS-231213-001",
"declareType": "B",
"note": "xxx#xxx",
"leaveTime": null,
"orderType": "E",
"operatorCode": "44031699DJ",
"operatorName": "深圳市机场国际快件监管中心有限公司",
"inventoryHeads": [
{
"customerSysNo": "SW1001E20231213THEOKGTTPHRIWF",
"payNo": "",
"appType": "1",
"appTime": "20231213223655",
"appStatus": "2",
"customsCode": "5314",
"ebpCode": "xxxxxxxxxx",
"ebpName": "Amazon",
"orderNo": "AS701-9138096-2795461",
"logisticsCode": "4403180007",
"logisticsName": "深圳市xxxx货运有限公司",
"logisticsNo": "ASNM031779436BR",
"copNo": "SW1001E20231213THEOKGTTPHRIWF",
"preNo": null,
"portCode": "5345",
"ieDate": "20231213",
"statisticsFlag": "B",
"agentCode": "4403960WC8",
"agentName": "晟湾宏达（深圳）科技服务有限公司",
"ebcCode": "4403960WC8",
"ebcName": "晟湾宏达（深圳）科技服务有限公司",
"ownerCode": "4403160FNV",
"ownerName": "深圳市xxxx有限公司",
"iacCode": null,
"iacName": null,
"emsNo": null,
"tradeMode": "9610",
"trafMode": "4",
"trafName": "粤ZYZ98港",
"voyageNo": "粤ZYZ98港",
"billNo": "5100676119258",
"totalPackageNo": "",
"loctNo": "531496",
"licenseNo": null,
"country": "410",
"pod": "1039",
"freight": "0.00000",
"insuredFee": "0.00000",
"wrapType": "2",
"packNo": 1,
"grossWeight": 0.82,
"netWeight": 0.8,
"note": null,
"fcurrency": "502",
"fflag": "3",
"icurrency": "502",
"iflag": "3",
"status": "800",
"invtNo": "",
"inventoryLists": [
{
"itemNo": "FDS-23004",
"itemRecordNo": "",
"itemName": "摄像灯",
"barCode": "无",
"country": "410",
"currency": "502",
"qty": 1,
"qty1": "0.80000",
"qty2": null,
"unit": "007",
"unit1": "035",
"unit2": null,
"price": 74.81,
"totalPrice": "74.81000",
"note": null,
"grossWeight": 0.82,
"netWeight": 0.8,
"gno": 1,
"gcode": "9405429000",
"gname": "摄像灯",
"gmodel": "1|0|照明用|Yongnuo牌|||YN360 III PRO型"
}
]
}
]
}
},
"timestamp": "1702478216"
}
注意事项
数据格式要求
- 时间格式: 统一使用
YYYYMMDDhhmmss 格式
- 编码格式: 使用UTF-8编码
- 必填字段: 请确保所有标记为"是"的必填字段都有值
- 数据类型: 严格按照表格中的类型要求传输数据
常见问题
企业唯一编号(copNo)生成规则:
- 出口: SW1001E + 时间戳 + 5位随机数
- 进口: SW1001I + 日期 + 5位随机数
币制代码:
贸易方式选择:
联系方式
如有疑问，请联系技术支持团队。
