晟湾跨境电商综合配置指南
4 条评论
晟湾跨境电商综合配置指南
概述
本文档提供晟湾跨境电商综合平台的对接配置说明，包括API接口配置、参数说明、数据格式和示例等。
适用范围
- 跨境电商企业
- 物流服务商
- 系统集成商
支持的贸易方式
- 9610：跨境电子商务
- 1210：保税跨境贸易电子商务
- 9710：跨境电子商务企业对企业直接出口
- 9810：跨境电子商务出口海外仓
方案配置指南
适配器配置
- 写入适配器:
Adapter\ShengWanCross\ShengWanCrossExecuteAdapter - 暂存接口:
/cbec/v1/openapi/staging
接口参数说明
主要请求参数 (request)
序号字段名字段描述类型必填说明 1currency币制C3否三位数字142/502 2country运抵国C3否三位数字 3goodsInfo主要货物信息C..200否- 4wrapType包装种类C1否1木箱，2纸箱，3桶装，4散装，5托盘，6包，7其他 5ebpCode电商平台代码C..18是填 "无" 6ebpName电商平台名称C..100是境外电商平台名称 7ebcCode电商企业代码C..18否- 8ebcName电商企业名称C..100否- 9ebcTelephone电商企业电话C..50是- 10payCode支付企业代码C..18是支付企业的海关编码,国内企业必填 11payName支付企业名称C..100是支付企业名称,非线上支付填"现金支付" 12ownerCode生产销售企业代码C..18是生产企业的海关注册登记编号或统一社会信用代码,未在海关登记的填NO 13ownerName生产销售企业名称C..100是- 14copNo企业唯一编号C..30是出口：长度29位 SW1001E（平台分配）+YYYYMMDDhhmmssSSS+5位随机数；进口：长度20位 SW1001I+YYYYMMDD+5位随机数字或字母 15payNo支付交易编号C..60否- 16logisticsNo物流运单号C..80否- 17orderNo订单号C..60否- 18packNo件数N9否- 19charge支付金额N19.5否- 20goodsValue实际商品金额N19.5否- 21grossWeight毛重N19.5否- 22netWeight净重N19.5否- 23totalPackageNo总包号C..37是大包裹号(总包号) 24iacCode区内企业代码C..18是特殊区域出口模式必填 25iacName区内企业名称C..100是特殊区域出口模式必填 26emsNo账册编号C..30是- 27freight运杂费N19.5否无则填写"0" 28fcurrency运费币制C3否3位币制数字 29fflag运费标志C1否1-率，2-单价，3-总价 (默认3) 30insuredFee保费N19.5否无则填写"0" 31icurrency保费币制C3否3位币制数字 32iflag保费标志C1否1-率，2-单价，3-总价 (默认3) 33licenseNo许可证号C..19是- 34consignee收货人姓名C..100是- 35consigneeAddress收货人地址C..200是- 36consigneeTelephone收货人电话C..50是- 37pod指运港代码C3..4否- 38accountingDate到账时间C14否YYYYMMDDhhmmss 39wayBillNo快递面单号C..80是- 40payMentOrgan收汇机构名称C..100是- 41payMentNo收汇机构申报单号C..80是- 42ext1备用字段1C..200是- 43ext2备用字段2C..200是- 44ext3备用字段3C..200是- 45ext4备用字段4C..200是- 46ext5备用字段5C..200是- 47ext6备用字段6C..200是- 48ext7备用字段7C..200是-相当于存放msg中invt清单数据的集合List
商品信息参数 (goods)
序号字段名字段描述类型必填说明 1gnum商品序号N5否从1开始的递增序号 2gcode商品HS编码C..10否- 3gname申报商品名称C..250否- 4gmodel规格型号C..250否- 5itemNo企业商品货号SKUC..20否- 6itemRecordNo账册备案料号C..30否保税出口模式必填 7itemName企业商品名称C..250是企业自定义的商品名称，汇总后用于退税品名 8itemDescribe商品描述C..1000是- 9barcode条码C..50是- 10qty申报数量N19.5否- 11qty1第一数量N19.5否- 12qty2第二数量N19.5否- 13unit申报单位C3否- 14unit1第一单位C3否- 15unit2第二单位C3否- 16price单价N19.5否- 17totalPrice总价N19.5否- 18country目的国C3否- 19netWeight净重N19.5否- 20grossWeight毛重N19.5否- 21note备注C..1000是- 22countryCode境内货源地C..20是- 23producerName生产厂商C..100是- 24producerCode生产厂商代码C..18是- 25certNo鉴定证书编号C..64是- 26goodsLink商品链接C..250是- 27sellerId卖家IDC..64是- 28ext1备用字段1C..200是- 29ext2备用字段2C..200是- 30ext3备用字段3C..200是- 31ext4备用字段4C..200是- 32ext5备用字段5C..200是- 33ext6备用字段6C..200是- 34ext7备用字段7C..200是-商品集合List
其他请求参数 (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}}路径参数
参数名类型必填说明 strategyIdstring是方案ID，接收中间方案，UUID格式请求示例
{{API_PREFIX}}/api/open/shengwancross/shengwancross/3ec116dc-1cae-3848-b479-93f4a8b27d972. 消息推送配置
配置结构
- 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位随机数
币制代码:
- 142: 人民币
- 502: 美元
贸易方式选择:
- 根据实际业务场景选择对应的贸易方式代码
联系方式
如有疑问，请联系技术支持团队。
论坛热帖
- 电商多平台财务自动对账：从手工核数到智能闭环的完整落地指南2026-07-15
- 主流AI深度评测合集：轻易云全场景异构系统对接硬核技术资源大全2026-07-04
- ### 2026年企业级数据集成平台与AI模型实战图谱2026-06-26
- 打破数据高墙：从“轻易云”实践看企业异构系统集成的技术范式革命2026-06-26
- 境内外电商平台对账的技术挑战与智能化解决方案2026-06-25