晟湾跨境电商综合配置指南

概述

本文档提供晟湾跨境电商综合平台的对接配置说明，包括API接口配置、参数说明、数据格式和示例等。

适用范围

跨境电商企业
物流服务商
系统集成商

支持的贸易方式

9610：跨境电子商务
1210：保税跨境贸易电子商务
9710：跨境电子商务企业对企业直接出口
9810：跨境电子商务出口海外仓

方案配置指南

适配器配置

写入适配器: Adapter\ShengWanCross\ShengWanCrossExecuteAdapter
暂存接口: /cbec/v1/openapi/staging

接口参数说明

主要请求参数 (request)

相当于存放msg中invt清单数据的集合List

序号	字段名	字段描述	类型	必填	说明
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)

商品集合List

序号	字段名	字段描述	类型	必填	说明
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位随机数
币制代码:
- 142: 人民币
- 502: 美元
贸易方式选择:
- 根据实际业务场景选择对应的贸易方式代码

联系方式

如有疑问，请联系技术支持团队。