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

概述

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

适用范围

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

支持的贸易方式

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

方案配置指南

适配器配置

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

接口参数说明

主要请求参数 (request)

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

商品信息参数 (goods)

商品集合List

其他请求参数 (otherRequest)

提单数据 (bill)

metdata聚合写入。因为晟湾跨境电商综服平台单次是只支持100条数据。我们需要通过聚合写入，每天定时推送数据到中间平台

"operation": {
    "rowsKey": "array",
    "rows": 10000,
    "method": "batchArraySave"
  }

API接口配置接口回调配置

1. API路由地址

接口路径

{{API_PREFIX}}/api/open/shengwancross/shengwancross/{{strategyId}}

路径参数

请求示例

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

注意事项

数据格式要求

1. 时间格式: 统一使用 YYYYMMDDhhmmss 格式
2. 编码格式: 使用UTF-8编码
3. 必填字段: 请确保所有标记为"是"的必填字段都有值
4. 数据类型: 严格按照表格中的类型要求传输数据

常见问题

1. 企业唯一编号(copNo)生成规则:

   • 出口: SW1001E + 时间戳 + 5位随机数
   • 进口: SW1001I + 日期 + 5位随机数

2. 币制代码:

   • 142: 人民币
   • 502: 美元

3. 贸易方式选择:

   • 根据实际业务场景选择对应的贸易方式代码

联系方式

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