临港新片区一体化服务平台帮助文档

# 业务单证对接接口规范

变更历史

版本 变更时间 性质 变更内容 修改人
V1.0 2020.12.16 N 项目组
V1.1 2021.08.12 M 1、增加便捷进出区接口信息 项目组
V1.2 2022.03.11 M 1、提发货凭证增加必填字段、卡口验放凭证增加必填校验 项目组
V1.3 2022.04.22 A 1、新增装车单作废申报接口 项目组
V1.4 2022.06.06 M 1、料件、成品标志类型补充说明 项目组
V1.5 2022.07.26 M 1、卡口验放凭证 增加业务类型：24（便捷汽车出口） 项目组
V1.6 2022.08.04 M 1、进境径予新增字段 项目组
V1.7 2022.08.26 M 1、修改一司两地类型卡口验放单证时，出区方向的关联单证编号必填 项目组
V1.8 2022.09.05 M 1、子账户新增、子账户修改接口入参 项目组
V1.9 2022.09.22 A 1、新增业务申报延期接口 项目组
V2.0 2022.09.26 M 1、便捷进出区暂存与修改接口变更 项目组
V2.1 2022.10.28 M 1、径予进出境暂存接口表头新增进出口岸字段
2、卡口验放凭证增加分送集报退运暂存与修改接口		 项目组
V2.2 2022.11.08 A 1、新增进出区提发货中报关单相关功能接口 项目组
V2.3 2023.01.31 M 1、进境径予危禁品确认标志改为必填
2、新增进出区提发货表体危化品字段		 项目组
V2.4 2023.02.20 M 1、卡口验放凭证查询列表接口字段名称更正
2、场地备案查询列表接口多余字段去除		 项目组
V2.5 2023.04.27 M 1、生产接口环境地址变更
2、增加注释进出区提发货表头字段子账户ID修改必填		 项目组
V2.6 2023.07.13 M 1、增加便捷进出区信息列表增加字段长度说明
2、增加便捷进出区暂存接口入参说明		 项目组
V2.7 2023.12.06 M 1、增加装车单暂存、修改接口入参说明
2、装车单暂存、修改绑定单证逻辑修改
3、装车单列表查询接口新增子账户多选查询条件，不传和之前查询保持一致		 项目组
V2.8 2024.03.22 M 1、增加提发货凭证列表查询入参，增加查询结果返参字段
2、提发货凭证详情查询字段返参
3、增加子账户账号类型，29-保税展品，30-保税国际中转		 项目组
V2.9 2024.05.30 M 1、卡口验放凭证表头新增字段goodsArrived（已进入待检区域）
2、卡口验放凭证表头新增inExpType（出入库类型）字段枚举值11-配套货物、13-保税区内直转
3、卡口验放凭证 暂存/修改 接口/portRelease/save新增入参goodsArrived字段
4、提发货凭证表头新增inExpType（出入库类型）字段枚举值11-配套货物、12-配套货物区内直转、13-保税区内直转。		 项目组

注：性质可以为 N-新建、A-增加、M-更改、D-删除

# 1、概述

本系统开放的接口服务是通过springcloud搭建的RESTful http 服务,采用的HTTP的通讯协议。本文简单的描述了接口调用方式以及示例，以供参考。

# 2、接口地址

测试环境IP地址：http://180.166.132.100/custom-server/ (opens new window)

生产环境IP地址：

原：https://newportal.lgxc.gov.cn/custom-server/ (opens new window)

新：https://newportal.lingang.gov.cn:2443/custom-server/ (opens new window)

# 3、用户认证

为了系统安全，调用功能接口前都需要进行用户认证，采用大数据授权码方式进行用户认证，一个授权码对应一个用户即是一个企业一个组织，用户授权码由亿通大数据提供

# 4、授权码认证调用方式

在每次对功能接口调用时都需要添加此授权码表明合法身份，添加方式为放在请求头中，即request的head中，key为userAuthCode，不需要进行数据加签

名称 是否必填 参数类型 备注
userAuthCode 是 String 授权码
Content-Type 否 String 请求类型（application/json）

# 5、接口 Return 信息

# 5.1、ReturnInfo

ReturnInfo 结构

结构标志 结构说明
ReturnInfo 接口返回信息

ReturnInfo 详情

序号 中文名称 字段名称 数据类型 注释 标记
1 状态 status String 1-成功 0-失败
2 记录 note String
3 描述 description String
4 Map Map 返回数据

分页字段说明

序号 中文名称 字段名称 数据类型 注释 标记
1 当前页记录数 numberOfElements Int
2 总页数 totalPages Int
3 总记录数 totalElements Int
4 每页条数 size Int
5 查询的数据内容 content 数组对象
6 当前页 number Int
7 分页对象 pageable Object
8 每页条数 pageSize
9 当前页 pageNumber
10 起始页 offset

# 6、进境径予自主申报接口信息列表

进境径予基本结构

结构标志 结构说明 备注
BillDirBsc 进境径予自主申报基本信息 1..n
BillDirDt 进境径予自主申报表体信息 0..n
BillDirWh 进境径予自主申报出入库信息 0..n

# 6.1、进境径予自主申报基本信息

序号 中文名称 字段名称 数据类型 长度 注释 标记(是否必填)
1 ID 号 id string 10 系统自动生成，修改时必填
2 组织 ID orgId string 10 系统自动生成
3 提货通知书编号 billNo string 18 系统自动生成
4 提货申请单编号 orderNo string 20 系统自动生成
5 主管地海关 masterCuscd string 4 系统自动获取
6 提运单号 billLodNo string 64 用户填写 M
7 英文船名 shipNameEn string 150 用户填写，运输方式为2-海运必填 M
8 航次 voyageNo string 20 用户填写，运输方式为2-海运必填 M
9 毛重 grossWt string 19,5 用户填写，货物毛重 M
10 数量 dclQty string 19,5 用户填写，货物件数
11 运输方式代码 trspModecd string 6 2 海运 5 空运 M
12 申报时间 dclTime string 系统自动生成，申报操作时
13 过卡时间 passTime string 系统自动生成，核放单过卡回执通知回填
14 申报类型 type string 2 0 自主申报 1 委托申报 M
15 单证状态 optStatus string 10 系统自动生成，见操作状态表
16 危禁品确认标志 hazardousConfirm string 10 1 是 2 否 M
17 危禁品 hazardous string 10 保留字段，非必填
18 监管方式 supvModecd string 6 保留字段，非必填
19 代理组织 ID proxyOrgId string 保留字段，非必填
20 备注 rmk string 4000 用户填写
21 待审批标志代码 emapvMarkcd string 1 判断是否需要轮询服务(V),主要海关端用，非必填
22 是否涉证涉检 involveConfirm string 1 1 涉证（涉及禁限管制）, 2 涉检（涉及检疫检疫）, 3 涉证涉检（均涉及）,0 均不涉 M
23 是否承诺货物 符合径予放行条件 agreeConfirm string 1 1 是 2 否 M
24 核放单绑定标志 passportUsedTypecd string 1 系统自动生成，0：未生成、1：已生成，核放单生成时系统返填、 2：部分生成
25 col1 col1 string 255 保留字段
26 col2 col2 string 255 保留字段
27 col3 col3 string 255 保留字段
28 col4 col4 string 255 用来标志是否为拖拽入库 1：是 0：否 系统默为 0
29 经营企业编号 bizopEtpsNo string 10 用户填写 M
30 经营单位名称 bizopEtpsNm string 768 用户填写 M
31 经营单位社会信用代码 bizopEtpsSccd string 18 用户填写 M
32 出入库单申报标识 inexpRltType string 1 系统自动生成，标识出入库单是否被申报 1：已申报 0：未申报
33 是否关联出入库 isRltInexp string 1 系统自动生成，是否关联出入库 1：已关联 0：未关联
34 料件、成品标志 mtpckEndprdTypecd string 10 I-料件,E-成品, S-设备,L-边角料,D-残次品,F-待维修件,G-已维修件,H-维修边角料,J-维修坏件，B-半成品
35 企业内部编号 enterNumber string 64 企业内部编号
36 申报类型编码 dclTypecd string 20 1 备案 2 变更 3 作废
37 是否是木质包装 isWp string 1 1-是 0-否
38 进出口岸 impexpPortcd string 4 不填写默认是2248

# 6.2、进境径予自主申报表体信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id string 10 系统自动生成
2 表头 id pid string 10 系统自动生成
3 径予放行自主声明编号 billNo string 18 系统自动生成
4 商品编号 gdecd string 10 用户填写
5 商品名称 gdsNm string 768 用户填写 M
6 申报数量 dclQty string 19,5 用户填写
7 申报单位 dclUnitcd string 3 用户填写
8 总价 dclTotalAmt string 25,5 用户填写
9 原产国 dclCurrcd string 3 用户填写
10 备注 rmk string 4000 用户填写
11 商品列表序号 gdsSeqno string 19 系统自动生成

# 6.3、进境径予自主申报出入库信息

注：暂存阶段无须填写，审核通过后按照实际情况填写

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id string 10 系统自动生成
2 表头 id pid string 10 系统自动生成
3 径予放行自主声明编号 billNo string 18 系统自动生成
4 ERP/WMS 出入库编号 inExpWhNo string 10 用户填写 M
5 ERP/WMS 出入库日期 inExpTime string 768 用户填写 M
6 备注 RMK string 19,5 用户填写
7 出入库标记 whType string 10 1 预出入库 0 实际出入库

# 6.4、进境径予状态记录

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id string 10 M
2 pid pid string 10 M
3 创建时间 createTime string M
4 操作状态 optStatus string 50
5 操作人 id optUserId string 50 M
6 操作时间 optTime string M
7 备注 remark string 1000
8 报文名 fileName string 500

# 6.5、暂存/修改接口

接口名称 进境径予暂存、修改
接口功能 通过接口新增或者修改进境径予信息
接口协议 HTTP
请求地址 /billDirBsc/save
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String 修改时必填
提运单号 billLodNo String M
英文船名 shipNameEn String M 运输方式为2-海运必填
航次 voyageNo String M 运输方式为2-海运必填
毛重 grossWt String M
数量 dclQty String
运输方式代码 trspModecd String M 2-海运 5-空运
危禁品确认标志 hazardousConfirm String M 1-是 2-否
是否涉证涉检 involveConfirm String M 0-均不涉 1-涉证（涉及禁限管制） 2-涉检（涉及检疫检疫） 3-涉证涉检（均涉）
是否承诺货物符合径予放行条件 agreeConfirm String M 1-是 2-否
经营企业编号 bizopEtpsNo String M
经营单位名称 bizopEtpsNm String M
经营单位社会信用代码 bizopEtpsSccd String M
料件、成品标志 mtpckEndprdTypecd String M I-料件,E-成品, S-设备,L-边角料,D-残次品,F-待维修件,G-已维修件,H-维修边角料,J-维修坏件，B-半成品
申报类型编码 dclTypecd String M 1-备案 2-变更 3-作废
申报类型 type String M 0-自主申报 1-委托申报
备注 rmk String
是否是木质包装 isWp String 1-是 0-否
进出口岸 impexpPortcd String 不填写默认2248
申报表体信息对象 billDirDt Object
商品编号 gdecd String
商品名称 gdsNm String M
申报数量 dclQty String
申报单位 dclUnitcd String
总价 dclTotalAmt String
原产国 dclCurrcd String
备注 rmk String
商品列表序号 gdsSeqno String
代码示例
详细ReturnInfo示例如下，"billDirDt"为申报表体信息对象 


            {
              "id":null,
              "dclTypecd":"1",
              "billLodNo":"test-TIYUN",
              "shipNameEn":"SHIPNAME",
              "voyageNo":"VOYAGE_NO",
              "grossWt":"1000.00000",
              "dclQty":null,
              "trspModecd":"2",
              "type":"0",
              "hazardousConfirm":"2",
              "rmk":null,
              "involveConfirm":"0",
              "agreeConfirm":1,
              "bizopEtpsNo":"0000000011",
              "bizopEtpsNm":"上海嘉盛有限公司",
              "bizopEtpsSccd":"329281299407255493",
              "mtpckEndprdTypecd":null,
              "isWp":"0",
              "impexpPortcd":"2248",
              "billDirDt":[
                  {
                      "gdecd":null,
                      "gdsNm":"轮胎",
                      "dclQty":null,
                      "dclUnitcd":null,
                      "dclTotalAmt":null,
                      "dclCurrcd":null,
                      "rmk":null,
                  }
              ]
          }
显示代码
出参
代码示例


          {
            "status" : "1",
            "note" : "暂存成功",
            "description" : null,
            "map" : {
              "id" : "3451"
            }
          }
显示代码

# 6.6、删除接口

接口名称 进境径予删除
接口功能 根据业务id删除径予单证
接口协议 HTTP
请求地址 /billDirBsc/delete
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
进境径予id集合 bscIds String[] M
代码示例


            {
              bscIds": ['1163']
            }
显示代码
出参
代码示例


            {
              "status": "1",
              "note": "删除成功！",
              "description": null
            }
显示代码

# 6.7、列表查询接口

接口名称 进境径予列表查询
接口功能 企业通过该接口查询本组织下所有的径予单证列表信息
接口协议 HTTP
请求地址 /billDirBsc/getBillDirBscList
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
当前页 page Number M
显示条数 size Number M
径予放行自主声明编号 billNo String
自主声明申请单编号 orderNo String
提运单号 billLodNo String
英文船名 shipNameEn String
航次 voyageNo String
运输方式 trspModecd String 2-海运 5-空运
申报时间 dclTime String 逗号拼接时间范围
状态 optStatus String 详情状态列表
代码示例


          {
            "trspModecd":"2",
            "billNo":"49I202108120003184",
            "optStatus":"5",
            "voyageNo":"SH015E--009",
            "billLodNo":"a01OOLU400011",
            "orderNo":"102305IV2108123327",
            "shipNameEn":"COSCO SHIPPING SOLAR",
            "dclTime":"2021-08-10,2021-09-12",
            "size":10,
            "page":1
          }
显示代码
代码示例
详见进境自主声明基本信息、进境自主声明表体信息、进境自主声明出入库信息、径行提货单状态记录 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
              "data": {
                "content": [{
                  "id": "3327",
                  "orgId": "102305",
                  "billNo": "49I202108120003184",
                  "orderNo": "102305IV2108123327",
                  "dclTypecd": "1",
                  "masterCuscd": "2249",
                  "billLodNo": "a01OOLU400011",
                  "shipNameEn": "COSCO SHIPPING SOLAR",
                  "voyageNo": "SH015E--009",
                  "grossWt": "5000",
                  "dclQty": null,
                  "trspModecd": "2",
                  "dclTime": "2021-08-12 14:02:04",
                  "passTime": null,
                  "type": "0",
                  "optStatus": "5",
                  "hazardousConfirm": "2",
                  "hazardous": null,
                  "supvModecd": null,
                  "proxyOrgId": null,
                  "rmk": "1",
                  "emapvMarkcd": null,
                  "involveConfirm": "0",
                  "agreeConfirm": "1",
                  "passportUsedTypecd": "1",
                  "col1": null,
                  "col2": null,
                  "col3": null,
                  "col4": "0",
                  "bizopEtpsNo": "0000000011",
                  "bizopEtpsNm": "上海嘉盛有限公司",
                  "bizopEtpsSccd": "329281299407255493",
                  "bizopEtpsNoAttr": null,
                  "bizopEtpsNmAttr": null,
                  "bizopEtpsSccdAttr": null,
                  "inexpRltType": null,
                  "isRltInexp": "0",
                  "boundTypecd": "0",
                  "invtIochkptStucd": "1",
                  "vrfdedMarkcd": "1",
                  "passportUsedWt": "5000",
                  "actlPassWt": null,
                  "remainWt": "0",
                  "mtpckEndprdTypecd": null,
                  "enterNumber": "00010",
                  "isAuto": null,
                  "cgNums": "0",
                  "tradeGrade": null,
                  "recordNums": "1",
                  "billDirDt": [{
                    "id": "8434",
                    "pid": "3327",
                    "billNo": "49I202108120003184",
                    "gdecd": null,
                    "gdsNm": "鲜果",
                    "dclQty": null,
                    "dclUnitcd": null,
                    "dclTotalAmt": null,
                    "dclCurrcd": null,
                    "rmk": null
                  }],
                  "billDirStatus": [],
                  "billDirWh": []
                }],
                "pageable": {
                  "sort": {
                    "sorted": false,
                    "unsorted": true
                  },
                  "pageSize": 10,
                  "pageNumber": 0,
                  "offset": 0,
                  "unpaged": false,
                  "paged": true
                },
                "totalPages": 1,
                "totalElements": 1,
                "last": true,
                "first": true,
                "sort": {
                  "sorted": false,
                  "unsorted": true
                },
                "size": 10,
                "number": 0,
                "numberOfElements": 1
              }
            }
          }
显示代码

# 6.8、明细查询接口

接口名称 进境径予明细查询
接口功能 根据业务id查询径予单证详细
接口协议 HTTP
请求地址 /billDirBsc/getDetail
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
进境径予id id String M
代码示例


          {
            bscIds": ['1163']
          }
显示代码
出参
代码示例
详见进境自主声明基本信息、进境自主声明表体信息、进境自主声明出入库信息、径行提货单状态记录 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
              "data": {
                "id": "3451",
                "orgId": "102305",
                "billNo": null,
                "orderNo": "102305IV2108313451",
                "dclTypecd": "1",
                "masterCuscd": "2249",
                "billLodNo": "test-TIYUN",
                "shipNameEn": "SHIPNAME",
                "voyageNo": "VOYAGE_NO",
                "grossWt": "1000.00000",
                "dclQty": null,
                "trspModecd": "2",
                "dclTime": null,
                "passTime": null,
                "type": "0",
                "optStatus": "1",
                "hazardousConfirm": "2",
                "hazardous": null,
                "supvModecd": null,
                "proxyOrgId": null,
                "rmk": null,
                "emapvMarkcd": null,
                "involveConfirm": "0",
                "agreeConfirm": "1",
                "passportUsedTypecd": "0",
                "col1": null,
                "col2": null,
                "col3": null,
                "col4": "1",
                "bizopEtpsNo": "0000000011",
                "bizopEtpsNm": "上海嘉盛有限公司",
                "bizopEtpsSccd": "329281299407255493",
                "bizopEtpsNoAttr": "0000000011",
                "bizopEtpsNmAttr": "上海嘉盛有限公司",
                "bizopEtpsSccdAttr": "329281299407255493",
                "inexpRltType": null,
                "isRltInexp": "0",
                "boundTypecd": "0",
                "invtIochkptStucd": "1",
                "vrfdedMarkcd": "0",
                "passportUsedWt": null,
                "actlPassWt": null,
                "remainWt": null,
                "mtpckEndprdTypecd": null,
                "enterNumber": null,
                "isAuto": null,
                "cgNums": "0",
                "tradeGrade": null,
                "recordNums": "1",
                "billDirDt": [{
                    "id": "8701",
                    "pid": "3451",
                    "billNo": null,
                    "gdecd": null,
                    "gdsNm": "轮胎\t",
                    "dclQty": null,
                    "dclUnitcd": null,
                    "dclTotalAmt": null,
                    "dclCurrcd": null,
                    "rmk": null
                }],
                "billDirStatus": [{
                  "id": "140101",
                  "pid": "3451",
                  "createTime": "2021-09-13 20:44:10",
                  "optStatus": "1",
                  "optUserId": "zcfan01",
                  "optTime": "2021-09-13 20:44:10",
                  "remark": "暂存成功",
                  "fileName": null
                }],
                "billDirWh": [{
                  "id": "2082",
                  "pid": "3451",
                  "billNo": null,
                  "inExpWhNo": "LGR2021081310009",
                  "inExpTime": "2020-07-06 00:00:00",
                  "whType": "1",
                  "cgNums": null,
                  "modfMarkcd": "0",
                  "detailNo": null,
                  "rmk": null
                }]
              }
            }
          }
显示代码

# 6.9、表体查询接口

接口名称 进境径予表体查询
接口功能 通过单证编号分页查询该单证下表体明细
接口协议 HTTP
请求地址 /billDirBsc/getDirDetailPage
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
径予放行自主声明编号 billNo String M
进出境标识 ieTypecd String M I-进,E-出
页数 page int M
每页条数 size int M
代码示例


          {
            "billNo":   "49I202012160001810",
            "ieTypecd":   "I",
            "page":  1,
            "size":  10
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
              "data": {
                "first": true,
                "sort": {
                  "sorted": true,
                  "unsorted": false
                },
                "numberOfElements": 1,
                "totalElements": 1,
                "totalPages": 1,
                "last": true,
                "size": 10,
                "content": [{
                  "id": "6013",
                  "pid": "2050",
                  "billNo": "49I202012160001810",
                  "gdecd": null,
                  "gdsNm": "鲜果",
                  "dclQty": null,
                  "dclUnitcd": null,
                  "dclTotalAmt": null,
                  "dclCurrcd": null,
                  "rmk": null
                }],
                "number": 0,
                "pageable": {
                  "sort": {
                    "sorted": true,
                    "unsorted": false
                  },
                  "pageSize": 10,
                  "pageNumber": 0,
                  "offset": 0,
                  "unpaged": false,
                  "paged": true
                }
              }
            }
          }
显示代码

# 6.10、申报确认接口

接口名称 进境径予申报确认
接口功能 根据业务id值向海关申报径予单证，等待回执
接口协议 HTTP
请求地址 /billDirBsc/declare
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
进境径予id ids String[] M
代码示例


          {
            "ids": [
                  "2059"
              ]
          }
显示代码
出参
代码示例


          {
            "status": "1",
            "note": "确认成功",
            "description": null,
            "map": null
          }
显示代码

# 6.11、作废接口

接口名称 进境径予作废
接口功能 根据业务id值向海关申请作废径予单证，等待回执
接口协议 HTTP
接口方向 企业调用新片区海关监管系统
请求地址 /billDirBsc/billDirDtInvalid
请求方式 POST
入参 字段名 字段类型 是否必填 备注
进境径予id id String M
代码示例


          {
              "id": [
                  "1110"
              ]
          }
显示代码
出参
代码示例


          {
            "status" : "1",
            "note" : "作废申报成功",
            "description" : null,
            "map" : null
          }
显示代码

# 6.12、关联实际出入库新增

接口名称 进境径予关联出入库新增
接口功能 进境径予关联出入库保存
接口协议 HTTP
请求地址 /billDirBsc/billDirWhSave
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
进境径予id pid String M
径予放行自主声明编号 billNo String M
出入库编号 inExpWhNo String M
出入库日期 inExpTime String M
代码示例


          {
              "pid" : "638",
              "billNo" : "49E202004170000638",
              "inExpWhNo" : "SHWS20020827",
              "inExpTime" : "2020-07-08 16:12:28"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": "新增成功",
              "description": null,
              "map": null
          }
显示代码

# 6.13、关联实际出入库删除

接口名称 进境径予出入库删除
接口功能 通过出入库id删除进境径予关联出入库
接口协议 HTTP
请求地址 /billDirBsc/deleteInAndOut
请求方式 POST
入参 字段名 字段类型 是否必填 备注
进境径予出入库id集合 ids String[] M
代码示例


          {
              "ids": ["1110"]
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": "删除成功",
              "description": null,
              "map": null
          }
显示代码

# 6.14、关联实际出入库确认

接口名称 进境径予关联出入库确认
接口功能 企业向海关同步进境径予出入库信息
接口协议 HTTP
请求地址 /billDirBsc/modifyBillDirWh
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
进境径予关联出入库id集合 ids String[] M
进境径予id pid M
经营单位社会信用代码 orgCode M
代码示例
详细ReturnInfo，实例如下： 


          {
              "ids": ["361"],
              "orgCode": "913100006929421297",
              "pid": "908",
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": "发送成功",
              "description": null,
              "map": null
          }
显示代码

# 6.15、实际出入库明细查询

接口名称 进境径予出入库明细查询
接口功能 查询企业出入库信息
接口协议 HTTP
请求地址 /billDirBsc/getStockDtDetails
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
出入库编号 inExpWhNo String M
经营单位社会信用代码 orgCode String M
页数 page Number M
行数 size Number M
代码示例


          {
              "inExpWhNo": "1",
              "page": "1",
              "size": "10",
              "orgCode": "329281299407255493"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
              "data": {
                "content": [{
                  "entSccd": "913100006929421297",
                  "enterpriseName": "上海元初供应链管理有限公司",
                  "stockBillTypeName": "出库",
                  "stockBillType": "2",
                  "stockBillNo": "SHWS20031126",
                  "stockTypeName": "保税",
                  "stockType": "1",
                  "inOutBondedTypeName": "一线",
                  "inOutBondedType": "1",
                  "tradeCode": "3116660010",
                  "tradeName": "上海元初供应链管理有限公司",
                  "ownerName": "上海施狄贸易有限公司",
                  "businessTypeName": "交易",
                  "businessType": "5",
                  "declStockDate": "2020-03-20 15:30:44",
                  "actrualStockDate": "2020-06-16 13:00:15",
                  "presentStockStatus": null,
                  "gTypeName": "料件",
                  "gType": "I",
                  "tradeMode": "5000",
                  "trafMode": "2",
                  "iEPort": "2249",
                  "customMaster": "2249",
                  "declTypeName": "非报关",
                  "declType": "2",
                  "entryNo": null,
                  "rltEntryNo": "224920201000013928",
                  "cusLetpasTime": "2020-03-27 12:14:58",
                  "rltInvtNo": "QD224920E000615418",
                  "transitTime": "2020-03-27 12:14:58",
                  "inOutBondedNo": "110278",
                  "copGNo": "301394767",
                  "gNo": null,
                  "codeTs": "1904100000",
                  "ciqCode": "102",
                  "gName": "卡萨吉斯普特玉米球",
                  "gModel": null,
                  "gQty": "40.0000",
                  "gUnit": "122",
                  "qty1": "2.8000",
                  "unit1": "035",
                  "qty2": "0.0000",
                  "unit2": null,
                  "tradeCurr": "EUR",
                  "declPrice": "2.3800",
                  "declTotal": "95.2000",
                  "transMode": "1",
                  "originCountry": "312",
                  "destinationCountry": "142",
                  "tradeCountry": "142",
                  "tradeAreaCode": "142",
                  "districtCode": "31222",
                  "netWt": "2.800",
                  "grossWt": "3.718",
                  "warehouseNo": "洋山保税仓",
                  "warehouseLoc": "04B",
                  "orderNo": "SHWS20031126",
                  "billNo": null
                }],
                "last": true,
                "totalElements": 10,
                "totalPages": 1,
                "numberOfElements": 10,
                "sort": null,
                "first": true,
                "size": 10,
                "number": 0
              }
            }
          }
显示代码
出参字段说明 字段 名称 类型 说明
entSccd 社会信用统一代码 String
enterpriseName 企业名称 String
stockBillTypeName 出入库单进出类型名称 String
stockBillType 出入库单进出类型 String
stockBillNo ERP/WMS出入库单编号 String
stockTypeName 库存类型名称 String
stockType 库存类型 String
inOutBondedTypeName 出入库类型名称 String
inOutBondedType 出入库类型 String
tradeCode 经营企业单位编码 String
tradeName 经营企业名称 String
ownerName 货主名称 String
businessTypeName 业务类别名称 String
businessType 业务类别 String
declStockDate 出入库申报时间 String
actrualStockDate 实际出入库时间 String
presentStockStatus 当前记录出入库状态 String
gTypeName 料件成品标志名称 String
gType 料件成品标志 String
tradeMode 监管方式 String
trafMode 运输方式 String
iEPort 进出境关别 String
customMaster 主管海关 String
declTypeName 报关标志名称 String
declType 报关标志 String
entryNo 报关单号 String
rltEntryNo 关联报关单（备案清单、简易申报单）编号 String
cusLetpasTime 放行时间 String
rltInvtNo 关联保税核注清单编号 String
transitTime 核放时间 String
inOutBondedNo 出入库单明细序号 String
copGNo 商品料号 String
gNo 关联报关单（备案清单、简易申报单）商品序号 String
codeTs 商品编码 String
ciqCode 商检编码 String
gName 商品名称 String
gModel 商品规格型号 String
gQty 数量 String
gUnit 数量单位 String
qty1 法定数量 String
unit1 法定单位 String
qty2 法定第二数量 String
unit2 法定第二计量单位 String
tradeCurr 币制 String
declPrice 单价 String
declTotal 总价 String
transMode 成交方式 String
originCountry 原产国 String
destinationCountry 最终目的国代码（地区） String 参考《国别(地区)代码表》
tradeCountry 启运国/运抵国代码（地区） String 参考《国别(地区)代码表》
tradeAreaCode 贸易国代码（地区） String 参考《国别(地区)代码表》
districtCode 境内目的地/货源地代码 String
netWt 净重 String
grossWt 毛重 String
warehouseNo 仓库号 String
warehouseLoc 库位 String
orderNo 客户订单号 String
billNo 提单号 String

# 7、出境径予自主申报接口信息列表

出境径予基本结构

结构标志 结构说明 备注
BillDirExpBsc 出境径予基本信息 1..n
BillDirExpDt 出境径予表体信息 0..n
BillDirExpCon 出境径予集装箱信息
BillDirExpWh 出境径予出入库信息 0..n

# 7.1、出境径予申报基本信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 ID号 Id String 10 修改时必填
2 组织ID orgId String 10 系统自动生成
3 发货通知书编号 billExpNo String 18 系统自动生成
4 发货申请单编号 orderNo String 20 系统自动生成
5 主管地海关 masterCuscd String 4 系统自动获取
6 提运单号 billLodNo String 64 用户填写 M
7 英文船名 shipNameEn String 150 用户填写，运输方式为2-海运必填 M
8 航次 voyageNo String 20 用户填写，运输方式为2-海运必填 M
9 毛重 grossWt String 19,5 用户填写，货物毛重 M
10 数量 dclQty String 19,5 用户填写，货物件数
11 运输方式代码 trspModecd String 6 2-海运 5-空运 M
12 申报时间 dclTime String 系统自动生成，申报操作时
13 过卡时间 passTime String 系统自动生成，核放单过卡回执通知回填
14 申报类型 type String 2 0-自主申报 1-委托申报 M
15 状态 optStatus String 10 系统自动生成，见操作状态表
16 危禁品确认标志 hazardousConfirm String 10 1是 2否 M
17 危禁品 hazardous String 10 保留字段
18 监管方式 supvModecd String 6 保留字段
19 代理组织ID proxyOrgId String 保留字段
20 备注 rmk String 4000 用户填写
21 待审批标志代码 emapvMarkcd String 1 判断是否需要轮询服务(V),主要海关端用，非必填
22 是否涉政涉检 involveConfirm String 1 1-涉政（涉及禁限管制）, 2-涉检（涉及检疫检疫）,3-涉政涉检（均涉及）,0-均不涉
23 是否承诺货物符合径予放行条件 agreeConfirm String 1 1-是 2-否 M
24 核放单绑定标志 passportUsedTypecd String 1 系统自动生成，0-未生成、1-已生成，核放单生成时系统返填、2-部分生成
25 col1 col1 String 20 系统自动生成，出运状态，24-放行未运抵 20-已运抵待出运 21-舱单已核销待出运 22-已出运
26 col2 col2 String 20 备用字段
27 col3 col3 String 20 备用字段
28 col4 col4 String 20 备用字段
29 经营企业编号 bizopEtpsNo String 10 M
30 经营单位名称 bizopEtpsNm String 768 M
31 经营单位社会信用代码 bizopEtpsSccd String 18 M
32 出入库单申报标识 inexpRltType String 1 系统自动生成，标识出入库单是否被申报
33 是否关联出入库 isRltInexp String 1 是否关联出入库
34 料件、成品标志 mtpckEndprdTypecd String 10 I-料件, E-成品, S-设备, L-边角料, D-残次品, F-待维修件, G-已维修件, H-维修边角料, J-维修坏件, B-半成品
35 企业内部编号 enterNumber String 64 企业内部编号
36 申报类型编码 dclTypecd string 20 1-备案 2-变更 3-作废 4-落货退关
37 进出口岸 impexpPortcd string 4 不填写默是2248

# 7.2、出境径予自主申报表体信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 10 系统自动生成
2 表头id pid String 10 系统自动生成
3 发货通知书编号 billNo String 18 系统自动生成
4 商品编号 gdecd String 10 用户填写
5 商品名称 gdsNm String 768 用户填写 M
6 申报数量 dclQty String 19,5 用户填写 M
7 申报单位 dclUnitcd String 3 用户填写 M
8 总价 dclTotalAmt String 25,5 用户填写
9 币制 dclCurrcd String 3 用户填写
10 备注 rmk String 4000 用户填写
11 料号 gdsMtno String 30 用户填写 M
12 明细序号 gdsSeqno String 10 系统生成

# 7.3、出境径予集装箱号表信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id ID String 10
2 表头id PID String 10
3 发货通知书编号 billNo String 18
4 集装箱号 container String 10 用户填写 M
5 备用字段1 col1 String 768
6 备用字段2 col2 String 19,5
7 备用字段3 col3 String 3

# 7.4、出境径予出入库表信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 10
2 表头id pid String 10
3 提货通知书编号 billNo String 18
4 ERP/WMS出入库编号 inExpWhNo String 64 用户填写
5 ERP/WMS出入库日期 inExpTime String 用户填写
6 备注 rmk String 4000
7 出入库标记 whType String 10 1-预出入库 0-实际出入库1

# 7.5、出境径予状态记录表

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 10 系统自动生成
2 pid pid String 10 系统自动生成
3 创建时间 createTime String 系统自动生成
4 操作状态 optStatus String 50 系统自动生成
5 操作人id optUserId String 50 系统自动生成
6 操作时间 optTime String 系统自动生成
7 备注 remark String 1000 系统自动生成
8 报文名 fileName String 500 系统自动生成

# 7.6、暂存/修改接口

接口名称 出境径予暂存、修改
接口功能 通过接口新增或者修改出境径予信息
接口协议 HTTP
请求地址 /billDirBsc/saveExp
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String M
提运单号 billLodNo String M
英文船名 shipNameEn String M 运输方式为2-海运必填
航次 voyageNo String M 运输方式为2-海运必填
毛重 grossWt String M
数量 dclQty String M
运输方式代码 trspModecd String M 2-海运 5-空运
危禁品确认标志 hazardousConfirm String M 1-是 2-否
是否涉证涉检 involveConfirm String M 0-均不涉 1-涉证（涉及禁限管制） 2-涉检（涉及检疫检疫） 3-涉证涉检（均涉）
是否承诺货物符合径予放行条件 agreeConfirm String M 1-是 2-否
经营企业编号 bizopEtpsNo String M
经营单位名称 bizopEtpsNm String M
经营单位社会信用代码 bizopEtpsSccd String M
料件、成品标志 mtpckEndprdTypecd String M I-料件, E-成品, S-设备, L-边角料, D-残次品, F-待维修件, G-已维修件, H-维修边角料, J-维修坏件，B-半成品
申报类型编码 dclTypecd String M 1-备案 2-变更 3-作废
申报类型 type String M 0-自主申报 1-委托申报
备注 rmk String
进出口岸 impexpPortcd String 不填写默认 2248
申报表体信息对象 billDirExpDt String
商品编号 gdecd String
商品名称 gdsNm String M
申报数量 dclQty String
申报单位 String
总价 dclTotalAmt String
原产国 dclCurrcd String
商品列表序号 gdsSeqno String
集装箱信息对象 billDirExpCon String
集装箱号 container String
代码示例


            {
              "id": null,
              "dclTypecd": "1",
              "billLodNo": "lqf008",
              "shipNameEn": "YM WELCOME",
              "voyageNo": "020E",
              "grossWt": "5000.00000",
              "dclQty": "1000.00000",
              "trspModecd": "2",
              "type": "0",
              "hazardousConfirm": "2",
              "rmk": null,
              "involveConfirm": "0",
              "agreeConfirm": 1,
              "bizopEtpsNo": "0000000011",
              "bizopEtpsNm": "上海嘉盛有限公司",
              "bizopEtpsSccd": "329281299407255493",
              "mtpckEndprdTypecd": "I",
              "impexpPortcd": ”2248”,
              "billDirExpDt": [{
                "gdecd": "0804503000",
                "gdsNm": "鲜果",
                "dclQty": "1.00000",
                "dclUnitcd": "001",
                "dclTotalAmt": "20000.00000",
                "dclCurrcd": null,
                "rmk": "备注",
                "gdsMtno": "A009",
                "gdsSeqno": "1"
              }]
              "billDirExpCon": [{
                "container": "LT1200121"
              }]
            }
显示代码
出参
代码示例


                {
                  "status" : "1",
                  "note" : "暂存成功",
                  "description" : null,
                  "map" : {
                    "id" : "3451"
                  }
                }
显示代码

# 7.7、删除接口

接口名称 出境径予删除
接口功能 根据业务id删除径予单证
接口协议 HTTP
请求地址 /billDirBsc/deleteExp
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
出境径予id集合 bscIds String[] M
代码示例


          {
              "bscIds": [
                  "2062"
              ]
          }
显示代码
出参
代码示例


          {
            "status": "1",
            "note": "删除成功！",
            "description": null
          }
显示代码

# 7.8、列表查询接口

接口名称 出境径予列表查询
接口功能 通过该接口查询本组织下所有的径予单证列表信息
接口协议 HTTP
请求地址 /billDirBsc/getBillDirExpBscList
请求方式 POST
入参 字段名 字段类型 是否必填 备注
当前页 page Number M
显示条数 size Number M
出境径予放行货物自主声明编号 billExpNo String
自主声明预录入编号 orderNo String
提运单号 billLodNo String
英文船名 shipNameEn String
航次 voyageNo String
运输方式 trspModecd String 2-海运 5-空运
申报时间 dclTime String 逗号拼接时间范围
状态 optStatus String 详情状态列表
代码示例


          {
              "billExpNo": "49E202012160001328",
              "size":  "1",
              "page":  "10"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
                "data": {
                    "first": true,
                    "sort": {
                        "sorted": true,
                        "unsorted": false
                    },
                    "numberOfElements": 1,
                    "totalElements": 1,
                    "totalPages": 1,
                    "last": true,
                    "size": 10,
                    "content": [
                        {
                            "id": "1812",
                            "orgId": "102305",
                            "billExpNo": "49E202012160001328",
                            "orderNo": "102305EV2012161812",
                            "dclTypecd": "1",
                            "masterCuscd": "2249",
                            "billLodNo": "lqf006",
                            "shipNameEn": "YM WELCOME",
                            "voyageNo": "020E",
                            "grossWt": "5000.00000",
                            "dclQty": "1000.00000",
                            "trspModecd": "2",
                            "dclTime": "2020-12-16 21:49:54",
                            "passTime": null,
                            "type": "0",
                            "optStatus": "7",
                            "hazardousConfirm": "2",
                            "hazardous": null,
                            "supvModecd": null,
                            "proxyOrgId": null,
                            "rmk": null,
                            "emapvMarkcd": null,
                            "involveConfirm": "0",
                            "agreeConfirm": "1",
                            "passportUsedTypecd": "0",
                            "col1": null,
                            "col2": null,
                            "col3": null,
                            "col4": "0",
                            "bizopEtpsNo": "0000000011",
                            "bizopEtpsNm": "上海嘉盛有限公司",
                            "bizopEtpsSccd": "329281299407255493",
                            "bizopEtpsNoAttr": null,
                            "bizopEtpsNmAttr": null,
                            "bizopEtpsSccdAttr": null,
                            "inexpRltType": null,
                            "isRltInexp": "0",
                            "boundTypecd": "0",
                            "invtIochkptStucd": "1",
                            "vrfdedMarkcd": "0",
                            "mtpckEndprdTypecd": "I",
                            "enterNumber": "2312312",
                            "billDirExpDt": [],
                            "billDirExpStatus": [],
                            "billDirExpCon": [],
                            "billDirExpWh": []
                        }
                    ],
                    "number": 0,
                    "pageable": {
                        "sort": {
                            "sorted": true,
                            "unsorted": false
                        },
                        "pageSize": 10,
                        "pageNumber": 0,
                        "offset": 0,
                        "unpaged": false,
                        "paged": true
                    }
                }
            }
        }
显示代码

# 7.9、明细查询接口

接口名称 出境径予明细查询
接口功能 根据业务id查询径予单证详细
接口协议 HTTP
请求地址 /billDirBsc/getDetailExp
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
出境径予Id id String M
代码示例


          {
              "id": "1812"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
              "data": {
                "id": "1812",
                "orgId": "102305",
                "billExpNo": "49E202012160001328",
                "orderNo": "102305EV2012161812",
                "dclTypecd": "1",
                "masterCuscd": "2249",
                "billLodNo": "lqf006",
                "shipNameEn": "YM WELCOME",
                "voyageNo": "020E",
                "grossWt": "5000.00000",
                "dclQty": "1000.00000",
                "trspModecd": "2",
                "dclTime": "2020-12-16 21:49:54",
                "passTime": null,
                "type": "0",
                "optStatus": "7",
                "hazardousConfirm": "2",
                "hazardous": null,
                "supvModecd": null,
                "proxyOrgId": null,
                "rmk": null,
                "emapvMarkcd": null,
                "involveConfirm": "0",
                "agreeConfirm": "1",
                "passportUsedTypecd": "0",
                "col1": null,
                "col2": null,
                "col3": null,
                "col4": "0",
                "bizopEtpsNo": "0000000011",
                "bizopEtpsNm": "上海嘉盛有限公司",
                "bizopEtpsSccd": "329281299407255493",
                "bizopEtpsNoAttr": "0000000011",
                "bizopEtpsNmAttr": "上海嘉盛有限公司",
                "bizopEtpsSccdAttr": "329281299407255493",
                "inexpRltType": null,
                "isRltInexp": "0",
                "boundTypecd": "0",
                "invtIochkptStucd": "1",
                "vrfdedMarkcd": "0",
                "mtpckEndprdTypecd": "I",
                "enterNumber": "2312312",
                "billDirExpDt": [{
                  "id": "6243",
                  "pid": "1812",
                  "billNo": "49E202012160001328",
                  "gdecd": "0804503000",
                  "gdsNm": "鲜果",
                  "dclQty": "1.00000",
                  "dclUnitcd": "001",
                  "dclTotalAmt": "20000.00000",
                  "dclCurrcd": null,
                  "rmk": "备注",
                  "gdsMtno": "A009",
                  "gdsSeqno": "1",
                  "passportUsedQty": "0.00000",
                  "actlPassQty": "0.00000",
                  "remainQty": "1.00000"
                }],
                "billDirExpStatus": [{
                  "id": "62994",
                  "pid": "1812",
                  "createTime": "2020-12-16 21:49:47",
                  "optStatus": "1",
                  "optUserId": "zcfan01",
                  "optTime": "2020-12-16 21:49:47",
                  "remark": "暂存成功",
                  "fileName": null
                }],
                "billDirExpCon": [{
                  "id": "3241",
                  "pid": "1812",
                  "billNo": "49E202012160001328",
                  "container": "LT1200121",
                  "col1": null,
                  "col2": null,
                  "col3": null
                }],
                "billDirExpWh": []
              }
            }
          }
显示代码

# 7.10、表体查询接口

接口名称 出境径予表体查询
接口功能 通过单证编号分页查询该单证下表体明细
接口协议 HTTP
接口方向 企业调用新片区海关监管系统
请求地址 /billDirBsc/getDirDetailPage
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
提货通知书编号 billNo String M
进出境标识 ieTypecd String M I-进, E-出
页数 page Number M
每页条数 size Number M
代码示例


          {
            "billNo": "49E202007130001430",
            "ieTypecd": "E",
            "page": 1,
            "size": 10
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


          {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                  "data": {
                      "last": true,
                      "first": true,
                      "sort": [
                          {
                              "direction": "DESC",
                              "property": "id",
                              "ignoreCase": false,
                              "nullHandling": "NATIVE",
                              "ascending": false,
                              "descending": true
                          }
                      ],
                      "totalElements": 1,
                      "totalPages": 1,
                      "numberOfElements": 1,
                      "size": 10,
                      "content": [
                          {
                              "id": "2282",
                              "pid": "1807",
                              "billNo": "49I202007130001430",
                              "gdecd": null,
                              "gdsNm": "123",
                              "dclQty": null,
                              "dclUnitcd": null,
                              "dclTotalAmt": null,
                              "dclCurrcd": null,
                              "rmk": null
                          }
                      ],
                      "number": 0
                  }
              }
          }
显示代码

# 7.11、申报确认接口

接口名称 出境径予申报确认
接口功能 根据业务id值向海关申报径予单证，等待回执
接口协议 HTTP
请求地址 /billDirBsc/declareExp
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
出境径予id集合 ids String[] M
代码示例


          {
              "ids": [
                  "141","229"
              ]
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status" : "1",
            "note" : "申报成功",
            "description" : null,
            "map" : null
          }
显示代码

# 7.12、作废接口

接口名称 出境径予作废
接口功能 根据业务id值向海关申请作废径予单证，等待回执
接口协议 HTTP
请求地址 /billDirBsc/billDirExpDtInvalid
请求方式 POST
入参 字段名 字段类型 是否必填 备注
出境径予id id String M
代码示例


          {
              "id": [
                  "111"
              ]
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": "作废申报成功",
            "description": null,
            "map": null
          }
显示代码

# 7.13、关联实际出入库新增

接口名称 出境径予关联出入库新增
接口功能 出境径予关联出入库保存
接口协议 HTTP
请求地址 /billDirBsc/billDirWhSaveExp
请求方式 POST
入参 字段名 字段类型 是否必填 备注
出境径予id pid String M
提货通知书编号 billNo String M
出入库编号 inExpWhNo String M
出入库日期 inExpTime String M
代码示例


          {
            "pid" : "638",
            "billNo" : "49E202004170000638",
            "inExpWhNo" : "SHWS20020827",
            "inExpTime" : "2020-07-08 16:12:28"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status" : "1",
            "note" : "新增成功",
            "description" : null,
            "map" : null
          }
显示代码

# 7.14、关联实际出入库删除

接口名称 出境径予出入库删除
接口功能 通过出入库id删除出境径予关联出入库
接口协议 HTTP
请求地址 /billDirBsc/deleteInAndOutExp
请求方式 POST
入参 字段名 字段类型 是否必填 备注
出境径予出入库id集合 ids String[] M
代码示例


          {
            "ids": ["425"]
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": "删除成功",
              "description": null,
              "map": null
          }
显示代码

# 7.15、关联实际出入库确认

接口名称 出境径予关联出入库确认
接口功能 企业向海关同步出境径予出入库信息
接口协议 HTTP
请求地址 /billDirBsc/modifyBillDirExpWh
请求方式 POST
入参 字段名 字段类型 是否必填 备注
出境径予出入库id集合 ids String[] M
出境径予id pid M
经营单位社会信用代码 orgCode M
代码示例


          {
            "ids": ["361"],
            "orgCode": "913100006929421297",
            "pid": "908"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": "发送成功",
              "description": null,
              "map": null
          }
显示代码

# 7.16、实际出入库明细查询

接口名称 出境径予出入库明细查询
接口功能 查询企业出入库信息
接口协议 HTTP
请求地址 /billDirBsc/getStockDtDetails
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
出入库编号 inExpWhNo String M
经营单位社会信用代码 orgCode String M
页数 page Number M
每页条数 size Number M
代码示例


          {
              "inExpWhNo": "1",
              "page": "1",
              "size": "10",
              "orgCode": "329281299407255493"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
              "data": {
                "content": [{
                  "entSccd": "913100006929421297",
                  "enterpriseName": "上海元初供应链管理有限公司",
                  "stockBillTypeName": "出库",
                  "stockBillType": "2",
                  "stockBillNo": "SHWS20031126",
                  "stockTypeName": "保税",
                  "stockType": "1",
                  "inOutBondedTypeName": "一线",
                  "inOutBondedType": "1",
                  "tradeCode": "3116660010",
                  "tradeName": "上海元初供应链管理有限公司",
                  "ownerName": "上海施狄贸易有限公司",
                  "businessTypeName": "交易",
                  "businessType": "5",
                  "declStockDate": "2020-03-20 15:30:44",
                  "actrualStockDate": "2020-06-16 13:00:15",
                  "presentStockStatus": null,
                  "gTypeName": "料件",
                  "gType": "I",
                  "tradeMode": "5000",
                  "trafMode": "2",
                  "iEPort": "2249",
                  "customMaster": "2249",
                  "declTypeName": "非报关",
                  "declType": "2",
                  "entryNo": null,
                  "rltEntryNo": "224920201000013928",
                  "cusLetpasTime": "2020-03-27 12:14:58",
                  "rltInvtNo": "QD224920E000615418",
                  "transitTime": "2020-03-27 12:14:58",
                  "inOutBondedNo": "110278",
                  "copGNo": "301394767",
                  "gNo": null,
                  "codeTs": "1904100000",
                  "ciqCode": "102",
                  "gName": "卡萨吉斯普特玉米球",
                  "gModel": null,
                  "gQty": "40.0000",
                  "gUnit": "122",
                  "qty1": "2.8000",
                  "unit1": "035",
                  "qty2": "0.0000",
                  "unit2": null,
                  "tradeCurr": "EUR",
                  "declPrice": "2.3800",
                  "declTotal": "95.2000",
                  "transMode": "1",
                  "originCountry": "312",
                  "destinationCountry": "142",
                  "tradeCountry": "142",
                  "tradeAreaCode": "142",
                  "districtCode": "31222",
                  "netWt": "2.800",
                  "grossWt": "3.718",
                  "warehouseNo": "洋山保税仓",
                  "warehouseLoc": "04B",
                  "orderNo": "SHWS20031126",
                  "billNo": null
                }],
                "last": true,
                "totalElements": 10,
                "totalPages": 1,
                "numberOfElements": 10,
                "sort": null,
                "first": true,
                "size": 10,
                "number": 0
              }
            }
          }
显示代码
出参字段说明 字段 名称 类型 说明
entSccd 社会信用统一代码 String
enterpriseName 企业名称 String
stockBillTypeName 出入库单进出类型名称 String
stockBillType 出入库单进出类型 String 1-入库 2-出库
stockBillNo ERP/WMS出入库单编号 String
stockTypeName 库存类型名称 String
stockType 库存类型 String
inOutBondedTypeName 出入库类型名称 String
inOutBondedType 出入库类型 String
tradeCode 经营企业单位编码 String
tradeName 经营企业名称 String
ownerName 货主名称 String
businessTypeName 业务类别名称 String
businessType 业务类别 String
declStockDate 出入库申报时间 String
actrualStockDate 实际出入库时间 String
presentStockStatus 当前记录出入库状态 String
gTypeName 料件成品标志名称 String
gType 料件成品标志 String
tradeMode 监管方式 String
trafMode 运输方式 String
iEPort 进出境关别 String
customMaster 主管海关 String
declTypeName 报关标志名称 String
declType 报关标志 String
entryNo 报关单号 String
rltEntryNo 关联报关单（备案清单、简易申报单）编号 String
cusLetpasTime 放行时间 String
rltInvtNo 关联保税核注清单编号 String
transitTime 核放时间 String
inOutBondedNo 出入库单明细序号 String
copGNo 商品料号 String
gNo 关联报关单（备案清单、简易申报单）商品序号 String
codeTs 商品编码 String
ciqCode 商检编码 String
gName 商品名称 String
gModel 商品规格型号 String
gQty 数量 String
gUnit 数量单位 String
qty1 法定数量 String
unit1 法定单位 String
qty2 法定第二数量 String
unit2 法定第二计量单位 String
tradeCurr 币制 String
declPrice 单价 String
declTotal 总价 String
transMode 成交方式 String
originCountry 原产国 String
destinationCountry 最终目的国代码（地区） String 参考《国别(地区)代码表》
tradeCountry 启运国/运抵国代码（地区） String 参考《国别(地区)代码表》
tradeAreaCode 贸易国代码（地区） String 参考《国别(地区)代码表》
districtCode 境内目的地/货源地代码 String
netWt 净重 String
grossWt 毛重 String
warehouseNo 仓库号 String
warehouseLoc 库位 String
orderNo 客户订单号 String
billNo 提单号 String

# 8、进出区提发货凭证接口信息列表

进出区提发货基本结构

结构标志 结构说明 备注
WareHouseBsc 进出区提发货基本信息 1..n
WarehouseReceiptDt 进出区提发货表体信息 0..n
WarehousePort 进出区提发货关联单证信息 0..n
WarehouseInExp 进出区提发货出入库信息 0..n

# 8.1、进出区提发货凭证基本信息

序号 中文名称 字段名称 字段类型 长度 说明 是否必填
1 id id String 10 暂存时系统自动生成 修改必填
2 子账户id orgId String 10 暂存时系统自动生成成 修改必填
3 进出区提发货编号 whRecPreentNo String 64 暂存时系统自动生成，生成规则：组织编号6位+单证类型2位("WH")+年月日6位+6位流水号 修改必填
4 出入库类型 inExpType String 1 1-一线进出 2-先报后送 3-分送集报 4-区内流转 5-区间流转 7-二线进出 8-调整类 9-一单多车B 11-配套货物 12-配套货物区内直转 13-保税区内直转 M
5 经营企业 bizopEtpsNm String 768 M
6 经营企业编码 bizopEtpsno String 10 M
7 经营企业社会信用代码 bizopEtpsSccd String 18 M
8 业务类型 businessTypecd String 2 1-自用设备、2-简单加工、3-保税加工、4-保税仓储、5-转口贸易、6-跨境电商、7-汽车平行进口、8-融资租赁、9-期货保税交割、10-保税维修、11-进口汽车保税存储、12-保税研发、13-委托加工、14-大宗商品现货保税交易、15-临时进出区、16-设备出区、17-模具外发、18-外发加工、19-境内维修、20-境外维修、21-飞机试飞、22-保税展示 M
9 料件、成品标志 mtpckEndprdTypecd String 1 I-料件,E-成品, S-设备,L-边角料,D-残次品,F-待维修件,G-已维修件,H-维修边角料,J-维修坏件，B-半成品 M
10 监管方式 supvModecd String 6 参考对应码表 M
11 运输方式 trspModecd String 6 参考对应码表 M
12 进出境关别 impexpPortcd String 4 参考对应码表 M
13 主管海关 masterCuscd String 1 系统自动生成 修改必填
14 关联报关单编号 rltEntryNo String 64 系统自动生成
15 关联编号 rltWhRecNo String 64 1.出入库类型为二线进出且业务类型为飞机试飞、外发加工时填写对应的业务申报编号
2.出入库类型为区内流转且进出方向为出区时须关联对应出入库类型为区内流转且进出方向为入区的提发货编号
3.设备子账户下出区提发货单证关联该子账户下入区提发货单证编号
16 申报日期 dclTime String 系统自动生成
17 是否报关 dclcusFlag String 1 1-否，2-是除出入库类型为区内流转、调整类外其余均是2-是 M
18 报关类型 dclcusTypecd String 25 1-关联报关；2-对应报关 M
19 进出卡口状态 invtIochkptStucd String 1 系统自动生成 1-未过卡 2-部分过卡 3-完全过卡
20 核扣标记 vrfdedMarkcd String 1 系统自动生成 0-未核扣 1-预核扣 2-已核扣 3-已核销
21 备注 rmk String 4000
22 操作状态 optStatus String 10 系统自动生成见操作状态表
23 最终目的国 destinationNatcd String 3 参考对应码表 M
24 启运国/运抵国 tradeCountry String 3 参考对应码表 M
25 贸易国（地区） tradingRegion String 3 参考对应码表 M
26 境内目的地、境内货源地 districtCode String 10 参考对应码表 M
27 毛重 grossWt String 19,5 M
28 成交方式 transMode String 3 参考对应码表 M
29 进出标志 ieTypecd String 2 I-进区，E-出区 M
30 绑定标志 passportUsedTypecd String 2 系统自动生成 1-未绑定 2-部分绑定 3已绑定
31 申报类型 dclTypecd String 1 1-备案 2-变更 3-作废 M
32 变更次数 chgTmsCnt String 10 系统自动生成
33 是否拖拽录入 isDrag String 10 系统自动生成 0-非拖拽生成 1-拖住生成
34 企业内部编号 enterNumber String 64
35 特殊业务 specialBusiness String 2 1-特殊类 2-涉证商品 3-海运拼箱
36 调拨模式 allocationMode String 2 1-围网内，2-跨围网 出入库类型为4-区内流转时必填，其余不填
37 出区绑定标识 whpassportUsedTypecd String 64 系统自动生成设备子账户下出区单证可以进行展示，其余情况不显示
38 报关行企业名称 declareCustomeName String 50
39 报关行企业编码 declareTradeCode String 20

# 8.2、进出区提发货凭证表体信息

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 系统自动生成 修改必填
2 提发货id pid String 10 系统自动生成 修改必填
3 子账户id orgId String 10 系统自动生成 修改必填
4 明细序号 gdsSeqno String 10 系统自动生成 修改必填
5 关联单证编号 portNo String 64 出入库类型为分送集报时必填
6 关联单证表体序号 rltPortSeqno String 64 出入库类型为分送集报时必填
7 商品料号 gdsMtno String 32 M
8 报关单商品序号 entryGdsSeqno String 10 先报后送出区时为必填项，但不会校验正确性
9 商品编码 gdecd String 10 M
10 商品名称 gdsNm String 768 M
11 规格型号 gdsSpcfModelDesc String 768
12 币制 dclCurrcd String 3 M
13 数量 dclQty String 19,5 M
14 单位 dclUnitcd String 3 M
15 单价 dclUprcAmt String 25,5
16 总价 dclTotalAmt String 25,5 M
17 统计人民币值 sumRmbVal String 25,5
18 统计美元值 sumUsaVal String 25,5
19 原产国（地区） natcd String 3 M
20 净重 netWt String 19,5 M
21 提发货编号 whRecPreentNo String 64 系统自动生成
22 修改标志代码 modfMarkcd String 4 0-未修改 1-修改 2-删除 3-增加 申报类型为变更且需要变更表体需要填写
23 法定单位 unit1 String 3 M
24 法定数量 qty1 String 19,5 M
25 危化品标志 productCharCode String 2 0-否，1-是 单证确认时，校验：调整类单证不能填写该字段；若危化品开关开启，对非调整类单证做必填校验

# 8.3、进出区提发货关联单证表

注：出入库类型为分送集报、设备管理子账户下的出区单证需要填写关联单证

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 系统自动生成 修改必填
2 子账户id orgId String 10 系统自动生成 修改必填
3 提发货id pid String 10 系统自动生成 修改必填
4 关联单证编号 portNo String 50 1. 出入库类型为分送集报的时候关联单证编号为对应的卡口验放凭证
2.设备管理子账户下的出区单证关联单证编号为对应的进区提发货凭证		 M
5 关联总担保编号 rtlTypecd String 50 出入库类型为分送集报并且是出区的时候需要填写
6 修改标志代码 modfMarkcd String 4 0-未修改 1-修改 2-删除 3-增加 申报类型为变更且需要变更关联单证需要填写

# 8.4、进出区提发货出入库表

注：暂存阶段无须填写，审核通过后按照实际情况填写

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 系统自动生成
2 子账户id orgId String 10 系统自动生成
3 提发货id pid String 10 系统自动生成
4 ERP/WMS出入库编号 inExpWhNo String 64 M
5 ERP/WMS出入库日期 inExpTime String date yyyy-MM-dd HH:mm:ss M
6 仓单编号 whRecPreentNo String 64 系统自动生成
7 备注 rmk String 4000

# 8.5、进出区提发货操作记录

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 系统自动生成
2 提发货的id pid String 10 系统自动生成
3 创建时间 createTime String date 系统自动生成
4 操作状态 optStatus String 50 系统自动生成
5 操作人名称 optUserName String 50 系统自动生成
6 操作时间 optTime String date 系统自动生成
7 备注 remark String 1000 系统自动生成

# 8.6、仓库库位表

注：出入库类型为9-一单多车B的时候必填

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id Id String 10 系统自动生成 修改必填
2 提发货表体的id pid String 10 系统自动生成 修改必填
3 进出区提发货id whtId String 10 系统自动生成 修改必填
4 进出区提发货编号 whRecPreentNo String 64 系统自动生成 修改必填
5 仓库号 whtNumber String 1000 有值的情况下修改必填
6 库位号 storeNumber String 1000 M
7 数量 dclQty String 19,5 M
8 备注 remark String 1000

# 8.7、报关行关系表

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 系统自动生成
2 企业编码 tradeCode String 10
3 报关行企业名称 declareCustomeName String 50
4 报关行企业编码 declareTradeCode String 20

# 8.8、暂存/修改接口

接口名称 用于进出区提发货单证暂存与修改
接口功能 通过接口新增或者暂存进出区提发货凭证信息
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/saveBsc
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String 修改必填 暂存系统自动生成
子账户id orgId String 修改必填 暂存系统自动生成
进出区提发货编号 whRecPreentNo String 修改必填 暂存系统自动生成，生成规则：组织编号6位+单证类型2位("WH")+年月日6位+6位流水号
出入库类型 inExpType String M 参考进出区提发货基本信息的出入库类型码表
经营企业 bizopEtpsNm String M
经营企业编码 bizopEtpsno String M
经营企业社会信用代码 bizopEtpsSccd String M
业务类型 businessTypecd String M 参考进出区提发货基本信息的业务类型码表
料件、成品标志 mtpckEndprdTypecd String M 参考进出区提发货基本信息的料件、成品标志码表
监管方式 supvModecd String M 参考对应码表
运输方式 trspModecd String M 参考对应码表
进出境关别 impexpPortcd String M 参考对应码表
主管海关 masterCuscd String 修改必填 系统自动生成
关联报关单编号 rltEntryNo String M 系统自动生成
关联编号 rltWhRecNo String M 1.出入库类型为二线进出且业务类型为飞机试飞、外发加工时填写对应的业务申报编号
2.出入库类型为区内流转且进出方向为出区时须关联对应出入库类型为区内流转且进出方向为入区的提发货编号
3.设备子账户下出区提发货单证关联该子账户下入区提发货单证编号
申报日期 dclTime String 系统自动生成
是否报关 dclcusFlag String M 1-否，2-是除出入库类型为区内流转、调整类外其余均是2-是
报关类型 dclcusTypecd String M 1-关联报关；2-对应报关
进出卡口状态 invtIochkptStucd String 系统自动生成 1-未过卡 2-部分过卡 3-完全过卡
核扣标记 vrfdedMarkcd String M 系统自动生成 0-未核扣 1-预核扣 2-已核扣 3-已核销
备注 rmk String
操作状态 optStatus String 系统自动生成 见操作状态表
最终目的国 destinationNatcd String M 参考对应码表
启运国/运抵国 tradeCountry String M 参考对应码表
贸易国（地区） tradingRegion String M 参考对应码表
境内目的地、境内货源地 districtCode String M 参考对应码表
毛重 grossWt String M
成交方式 transMode String M 参考对应码表
进出标志 ieTypecd String M I-进区，E-出区
绑定标志 passportUsedTypecd String 系统自动生成 1-未绑定 2-部分绑定 3已绑定
申报类型 dclTypecd String M 1-备案，2-变更，3-作废
变更次数 chgTmsCnt String 系统自动生成
是否拖拽录入 isDrag String 系统自动生成 0-非拖拽生成 1-拖住生成
企业内部编号 enterNumber String
特殊业务 specialBusiness String 1-特殊类，2-涉政商品，3-海运拼箱
调拨模式 allocationMode String 出入库类型为4-区内流转时必填 1-围网内 2-跨围网
出区绑定标识 whpassportUsedTypecd String 系统自动生成
报关行企业编码 declareTradeCode String
报关行企业名称 declareCustomeName String
进出区提发货表体 warehouseReceiptDt json对象
id id String 修改必填 系统自动生成
提发货id pid String 修改必填 系统自动生成
子账户id orgId String 修改必填 系统自动生成
明细序号 gdsSeqno String 修改必填 系统自动生成
关联单证编号 portNo String 出入库类型为分送集报时必填
关联单证表体序号 rltPortSeqno String 出入库类型为分送集报时必填
商品料号 gdsMtno String M
报关单商品序号 entryGdsSeqno String M 需报关的清单，为必填项，但不会校验正确性
商品编码 gdecd String M
商品名称 gdsNm String M
规格型号 gdsSpcfModelDesc String M
币制 dclCurrcd String M
数量 dclQty String M
单位 dclUnitcd String M
单价 dclUprcAmt String
总价 dclTotalAmt String M
统计人民币值 sumRmbVal String
统计美元值 sumUsaVal String M
原产国（地区） natcd String M
净重 netWt String M
提发货编号 whRecPreentNo String 系统自动生成
修改标志代码 modfMarkcd String 申报类型为变更且需要变更表体需要填写 0-未修改 1-修改 2-删除 3-增加
法定数量 qty1 String M
法定单位 unit1 String M
危化品标志 productCharCode String 单证确认时，校验：调整类单证不能填写该字段；若危化品开关开启，对非调整类单证做必填校验 0-否 1-是
进出区提发货关联单证 warehousePort json对象 M 出入库类型为分送集报、设备管理子账户下的出区单证需要填写关联单证
id id String 修改必填 系统自动生成
子账户id orgId String 修改必填 系统自动生成
提发货id pid String 修改必填 系统自动生成
关联单证编号 portNo String M 1. 出入库类型为分送集报的时候关联单证编号为对应的卡口验放凭证
2. 设备管理子账户下的出区单证关联单证编号为对应的进区提发货凭证
关联总担保编号 rtlTypecd String 出入库类型为分送集报并且是出区的时候需要填写
修改标志代码 modfMarkcd String 申报类型为变更且需要变更关联单证需要填写 0-未修改 1-修改 2-删除 3-增加
仓库库位信息 warehouseStore 作为每个warehouseReceiptDt对象中的json对象 出入库类型为9-一单多车B的时候必填
id id String 修改必填 系统自动生成
提发货表体的id pid String 修改必填 系统自动生成
进出区提发货id whtId String 修改必填 系统自动生成
进出区提发货编号 whRecPreentNo String 修改必填 系统自动生成
仓库号 whtNumber String 必填
数量 dclQty String 必填
备注 remark String
代码示例
详情参考进出区提发货基本信息、进出区提发货表体信息、进出区提发货关联单证信息、进出区仓库库位表 


            {    
                  "id":   "",
                  "inExpType":   "2",
                  "bizopEtpsno":   "0000000009",
                  "bizopEtpsNm":   "上海优选",
                  "bizopEtpsSccd":   "123450000000009123",
                  "businessTypecd":   "1",
                  "mtpckEndprdTypecd":   "I",
                  "supvModecd":   "0214",
                  "trspModecd":   "4",
                  "impexpPortcd":   "2249",
                  "rltWhRecNo":  null,
                  "relDclcusFlag":   "1",
                  "dclcusFlag":   "2",
                  "dclcusTypecd":   "1",
                  "rmk":   "CS",
                  "destinationNatcd":   "102",
                  "tradeCountry":   "101",
                  "tradingRegion":   "101",
                  "districtCode":   "37019",
                  "grossWt":   "1",
                  "transMode":   "5",
                  "ieTypecd":   "E",
                  "grtNo":   "1",
                  "dclTypecd":   "1",
                  "enterNumber":   "123",
                  "allocationMode":  null,
                  "specialBusiness":  null,
                  "declareTradeCode": " 3118540084 " ,
                  "declareCustomeName": "报关行",
                  "warehouseReceiptDt":  [{            
                      "id":   "",
                      "pid":   "",
                      "orgId":   "",
                      "gdsSeqno":   "",
                      "portNo":  null,
                      "rltPortSeqno":  null,
                      "gdsMtno":   "LH001",
                      "entryGdsSeqno":   "1",
                      "gdecd":   "0809400090",
                      "gdsNm":   "冻去骨牛肉腱子肉(谷饲)",
                      "gdsSpcfModelDesc":  null,
                      "dclCurrcd":   "110",
                      "dclQty":   "1",
                      "dclUnitcd":   "001",
                      "dclUprcAmt":   "24996.8",
                      "dclTotalAmt":   "24996.8",
                      "sumRmbVal":  null,
                      "sumUsaVal":  null,
                      "natcd":   "101",
                      "netWt":   "101",
                      "qty1":   "1",
                      "unit1":   "001",
                      "whRecPreentNo":   "102031WH210708020001",
                      "modfMarkcd":   "0",
                      "leadId":  0        
                  }],
                  "warehousePort":  []
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


                {
                    "status": "1",
                    "note": "暂存成功",
                    "description": null,
                    "map": {
                        "data": 715795
                    }
                }
显示代码

# 8.9、删除接口

接口名称 进出区提发货删除
接口功能 根据业务id删除提发货凭证
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/delete
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 说明
进出区提发货id集合 ids Int[] M
代码示例


          {
              "ids": [
                  715795
              ]
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status" : "1",
            "note" : "删除成功",
            "description" : null,
            "map" : null
          }
显示代码

# 8.10、列表查询接口

接口名称 进出区提发货列表查询
接口功能 企业通过该接口查询本组织下所有的提发货凭证列表信息
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/getList
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
当前页 page int M
显示条数 size int M
进出区提发货凭证编号 like_whRecPreentNo String 支持模糊查询
业务类型 businessTypecd String 详情进出区提发货基本信息
ERP/WMS出入库类型 inExpType String 详情进出区提发货基本信息
进出标志 ieTypecd String I-进，E-出
进出卡口状态 invtIochkptStucd String 1-未过卡，2-部分过卡，3-全部过卡
状态 optStatus String 详情状态列表
开始确认时间 after_dclTime String 确认时间范围（前）
结束确认时间 before_dclTime String 确认时间范围（后）
凭证流水号 whSeqNo String 支持模糊查询
代码示例
详细ReturnInfo，实例如下： 


          {
              "like_whRecPreentNo": "102305WH201222715795",
              "size": 10,
              "page": 1
          }
显示代码
出参
代码示例
详细ReturnInfo，请参考进出区提发货基本信息

提示：出参不包含在进出区提发货基本信息中的字段均可忽略。



          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
                "data": {
                    "content": [
                        {
                            "id": 715795,
                            "orgId": 102305,
                            "whRecPreentNo": "102305WH201222715795",
                            "inExpWhNo": null,
                            "inExpType": "2",
                            "bizopEtpsno": "0000000011",
                            "bizopEtpsNm": "上海嘉盛有限公司",
                            "bizopEtpsSccd": "329281299407255493",
                            "businessTypecd": "1",
                            "inExpTime": null,
                            "mtpckEndprdTypecd": "I",
                            "supvModecd": "1371",
                            "trspModecd": "1",
                            "impexpPortcd": "2200",
                            "masterCuscd": "2249",
                            "rltEntryNo": "221820200000017163",
                            "rltWhRecNo": null,
                            "whRecNo": null,
                            "dclTime": null,
                            "dclcusFlag": "2",
                            "dclcusTypecd": "1",
                            "preRecAccountTime": null,
                            "recAccountTime": null,
                            "invtIochkptStucd": "1",
                            "vrfdedMarkcd": "0",
                            "rmk": null,
                            "entryStucd": null,
                            "optStatus": "99",
                            "destinationNatcd": "101",
                            "tradeCountry": "101",
                            "tradingRegion": "101",
                            "districtCode": "34142",
                            "grossWt": "10",
                            "transMode": "1",
                            "ieTypecd": "E",
                            "passportUsedTypecd": "1",
                            "relDclcusFlag": "1",
                            "inexpRltType": null,
                            "grtNo": "1",
                            "isDrag": "0",
                            "dclTypecd": "1",
                            "chgTmsCnt": "0",
                            "enterNumber": null,
                            "whSeqNo": "492403I00000000001"
                        }
                    ],
                    "pageable": {
                        "sort": {
                            "sorted": false,
                            "unsorted": true
                        },
                        "pageSize": 10,
                        "pageNumber": 0,
                        "offset": 0,
                        "unpaged": false,
                        "paged": true
                    },
                    "totalElements": 1,
                    "last": true,
                    "totalPages": 1,
                    "first": true,
                    "sort": {
                        "sorted": false,
                        "unsorted": true
                    },
                    "numberOfElements": 1,
                    "size": 10,
                    "number": 0
                }
            }
        }
显示代码

# 8.11、明细查询接口

接口名称 进出区提发货明细查询
接口功能 根据业务id查询提发货凭证详细
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/getBscDetails
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
进出区提发货id id int M
代码示例


          {
              "id": 715795
          }
显示代码
出参
代码示例
详细ReturnInfo，请参考进出区提发货基本信息、进出区提发货表体信息、进出区提发货关联单证信息、进出区提发货操作记录、仓库库位表

提示：出参不包含在进出区提发货基本信息、进出区提发货表体信息、进出区提发货关联单证信息、进出区提发货操作记录、仓库库位表中的字段均可忽略。



          {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                  "data": {
                      "id": "720001",
                      "orgId": "102031",
                      "whRecPreentNo": "102031WH210708020001",
                      "inExpWhNo": null,
                      "inExpType": "2",
                      "bizopEtpsno": "0000000009",
                      "bizopEtpsNm": "上海优选",
                      "bizopEtpsSccd": "123450000000009123",
                      "businessTypecd": "1",
                      "inExpTime": null,
                      "mtpckEndprdTypecd": "I",
                      "supvModecd": "0214",
                      "trspModecd": "4",
                      "impexpPortcd": "2249",
                      "masterCuscd": "2249",
                      "rltEntryNo": null,
                      "rltWhRecNo": null,
                      "whRecNo": null,
                      "dclTime": null,
                      "relDclcusFlag": "1",
                      "dclcusFlag": "2",
                      "dclcusTypecd": "1",
                      "preRecAccountTime": null,
                      "recAccountTime": null,
                      "invtIochkptStucd": "1",
                      "vrfdedMarkcd": "0",
                      "rmk": "CS",
                      "entryStucd": null,
                      "optStatus": "1",
                      "destinationNatcd": "102",
                      "tradeCountry": "101",
                      "tradingRegion": "101",
                      "districtCode": "37019",
                      "grossWt": "1",
                      "transMode": "5",
                      "ieTypecd": "E",
                      "grtNo": "1",
                      "grtNumber": null,
                      "dclTypecd": "1",
                      "chgTmsCnt": "0",
                      "isDrag": "0",
                      "passportUsedTypecd": "1",
                      "inexpRltType": null,
                      "type": null,
                      "enterNumber": null,
                      "allocationMode": null,
                      "specialBusiness": null,
                      "releasePassDate": null,
                      "whpassportUsedTypecd": null,
                      "whSeqNo": "492403I00000000001",
                      "warehouseReceiptDt": [
                          {
                            "id": "2659671",
                            "pid": "733001",
                            "orgId": "103240",
                            "gdsSeqno": "1",
                            "portNo": "1",
                            "rltPortSeqno": "1",
                            "gdsMtno": "YT002",
                            "entryGdsSeqno": null,
                            "gdecd": "9022130000",
                            "gdsNm": "集成电路(含客供料件)",
                            "gdsSpcfModelDesc": null,
                            "dclCurrcd": "110",
                            "dclQty": "20",
                            "dclUnitcd": "001",
                            "dclUprcAmt": "50",
                            "dclTotalAmt": "1000",
                            "sumRmbVal": null,
                            "sumUsaVal": null,
                            "natcd": "101",
                            "netWt": "101",
                            "whRecPreentNo": "103240WH230307033001",
                            "stockDtId": null,
                            "modfMarkcd": "0",
                            "whPassportUsedQty": "0",
                            "whRemainQty": "20",
                            "passportUsedQty": "0",
                            "actlPassQty": "0",
                            "remainQty": "20",
                            "unit1": "035",
                            "qty1": "100",
                            "productCharCode": "1",
                            "warehouseStore": []
                          }
                      ],
                      "warehousePort": [],
                      "warehouseStatus": [
                          {
                              "id": "951251",
                              "pid": "720001",
                              "createTime": "2021-07-13 10:52:05",
                              "optStatus": "1",
                              "optUserName": "zzwang001",
                              "optTime": "2021-07-13 10:52:05",
                              "remark": "进出区提发货暂存",
                              "fileName": "1"
                          },
                          {
                              "id": "951001",
                              "pid": "720001",
                              "createTime": "2021-07-08 16:09:06",
                              "optStatus": "1",
                              "optUserName": "zzwang001",
                              "optTime": "2021-07-08 16:09:06",
                              "remark": "进出区提发货暂存",
                              "fileName": "1"
                          }
                      ],
                      "warehouseInExp": []
                  }
              }
          }
显示代码

# 8.12、表体查询接口

接口名称 进出区提发货表体查询
接口功能 通过单证ID分页查询该单证下表体明细
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/getDtList
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
当前页 page Number M
显示条数 size Number M
进出区提发货id pid String M
代码示例


          {
              "pid": 4612,
              "page": 1,
              "size": 10
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                  "data": {
                      "content": [
                          {
                              "id": "2658506",
                              "pid": "732958",
                              "orgId": "103240",
                              "gdsSeqno": "1",
                              "portNo": "103240ZV230303325680",
                              "rltPortSeqno": "1",
                              "gdsMtno": "YT001",
                              "entryGdsSeqno": "1",
                              "gdecd": "0804503000",
                              "gdsNm": "集成电路(含客供料件)",
                              "gdsSpcfModelDesc": null,
                              "dclCurrcd": "110",
                              "dclQty": "40",
                              "dclUnitcd": "035",
                              "dclUprcAmt": "25",
                              "dclTotalAmt": "1000",
                              "sumRmbVal": null,
                              "sumUsaVal": null,
                              "natcd": "101",
                              "netWt": "101",
                              "whRecPreentNo": "103240WH230228032958",
                              "stockDtId": null,
                              "modfMarkcd": "0",
                              "whPassportUsedQty": "0",
                              "whRemainQty": "40",
                              "passportUsedQty": "0",
                              "actlPassQty": "0",
                              "remainQty": "40",
                              "unit1": "035",
                              "qty1": "100",
                              "productCharCode": null
                          }
                      ],
                      "last": true,
                      "totalElements": 1,
                      "totalPages": 1,
                      "sort": null,
                      "first": true,
                      "numberOfElements": 1,
                      "size": 10,
                      "number": 0
                  }
              }
          }
显示代码

# 8.13、申报确认接口

接口名称 进出区提发货申报确认
接口功能 根据业务id值向海关申报提发货单证，等待回执
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/submit
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
进出区提发货id集合 bscIds Int[] M
代码示例


          {
              "bscIds": [
                  715799
              ]
          }
显示代码
出参
代码示例


          {
            "status" : "1",
            "note" : "确认成功",
            "description" : null,
            "map" : null
          }
显示代码

# 8.14、作废接口

接口名称 进出区提发货作废
接口功能 根据业务id值向海关申请作废提发货凭证，等待回执
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/whCancel
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
进出区提发货id集合 bscIds Int[] M
代码示例


          {
              "bscIds": [
                  713190
              ]
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status" : "1",
            "note" : "操作成功",
            "description" : null,
            "map" : null
          }
显示代码

# 8.15、关联出入库新增接口

接口名称 进出区提发货关联出入库新增
接口功能 提发货凭证关联出入库保存
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/addInExp
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
进出区提发货ID pid String M
进出区提发货关联出入库编号 inExpWhNo String M
出入库日期 inExpTime String M
提发货凭证编号 whRecPreentNo String M
备注 rmk String M
代码示例


          {
              "pid": "715793",
              "inExpWhNo": "WS123456",
              "inExpTime": "2020-12-23 13:41:53",
              "whRecPreentNo": "102305WH201222715793",
              "rmk": ""
          }
显示代码
出参
代码示例


          {
            "status": "1",
            "note": "添加成功",
            "description": null,
            "map": null
          }
显示代码

# 8.16、关联出入库删除接口

接口名称 进出区提发货关联出入库删除
接口功能 通过出入库id删除提发货凭证关联出入库
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/delInExp
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
进出区提发货关联出入库id集合 id String[] M
代码示例


          {
              "ids": [
                  "549381"
              ]
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status" : "1",
            "note" : "删除成功",
            "description" : null,
            "map" : null
          }
显示代码

# 8.17、关联出入库确认接口

接口名称 进出区提发货关联出入库确认
接口功能 企业向海关同步提发货凭证出入库信息
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/submitInExp
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
进出区提发货关联出入库id pid String M
进出区提发货编号 whRecPreentNo String M
代码示例


          {
              "pid": "715793",
              "whRecPreentNo": "102305WH201222715793"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


          {
            "status" : "1",
            "note" : "确认成功",
            "description" : null,
            "map" : {
              "inexpRltType" : "1"
            }
          }
显示代码

# 8.18、确认收货接口

接口名称 进出区提发货确认收货
接口功能 进出区提发货凭证区内流转业务确认收货
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/confirmReceipt
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
进出区提发货id集合 bscIds Int[] M
代码示例


          {
              "bscIds": [
                  715799
              ]
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


          {
            "status" : "1",
            "note" : "确认收货成功",
            "description" : null,
            "map" : null
          }
显示代码

# 8.19、报关行比对接口

接口名称 报关行比对接口
接口功能 报关行比对接口
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/xtwYTCheckCompare
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
进出区提发货编号 whno String M
代码示例


          {
              "whno": "103240WH221104338380"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


          {
            "status" : "1",
            "note" : "校验成功",
            "description" : null,
            "map" : null
          }
显示代码

# 8.20、报关行关系暂存接口

接口名称 报关行关系暂存接口
接口功能 报关行关系暂存接口
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/dclSave
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
Id id String 新增无须填写，修改需要填写
企业编码 tradeCode String M
报关行企业名称 declareCustomeName String M
报关行企业编码 declareTradeCode String M
代码示例


          {
              "id": "",
              "tradeCode": "1070S21113",
              "declareCustomeName": "1",
              "declareTradeCode": "1"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


          {
            "status" : "1",
            "note" : "操作成功",
            "description" : null,
            "map" : null
          }
显示代码

# 8.21、报关行关系删除接口

接口名称 报关行关系删除接口
接口功能 报关行关系删除接口
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/delDclInfo
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
ids ids String M 批量删除的id以逗号分割
代码示例


          {
              "ids":"63,62"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


          {
            "status" : "1",
            "note" : "操作成功",
            "description" : null,
            "map" : null
          }
显示代码

# 8.22、报关行关系查询接口

接口名称 报关行关系查询接口
接口功能 报关行关系查询接口
接口协议 HTTP、Content-Type：application/json
请求地址 /wareHouse/quyDcl
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
企业编码 tradeCode String
显示条数 size int
当前页 page int
代码示例


          {
              "tradeCode": "1070S21113",
              "size": 10,
              "page": 1
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


          {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                  "data": {
                      "content": [
                          {
                              "id": 64,
                              "tradeCode": "1070S21113",
                              "declareCustomeName": "1",
                              "declareTradeCode": "1"
                          }
                      ],
                      "pageable": {
                          "sort": {
                              "unsorted": true,
                              "sorted": false
                          },
                          "pageSize": 10,
                          "pageNumber": 0,
                          "offset": 0,
                          "unpaged": false,
                          "paged": true
                      },
                      "last": true,
                      "totalElements": 1,
                      "totalPages": 1,
                      "first": true,
                      "sort": {
                          "unsorted": true,
                          "sorted": false
                      },
                      "numberOfElements": 1,
                      "size": 10,
                      "number": 0
                  }
              }
          }
显示代码

# 9、卡口验放凭证接口信息列表

卡口验放凭证基本结构

结构标志 结构说明 备注
PortReleaseBsc 卡口验放凭证本信息 1..n
PortReleaseDt 卡口验放凭证表体信息 0..n
PortReleaseRlt 卡口验放凭证关联单证信息 0..n
PortReleaseInexpRlt 卡口验放凭证出入库信息 0..n
PortStore 卡口验放凭证仓库库位表 0..n
PortReleaseVin 卡口验放凭证VIN码汇总表 0..n

# 9.1、卡口验放凭证基本信息

序号 字段名称 字段值 数据类型 长度 注释 是否必填
1 id id String 10 系统自动生成 修改必填
2 子账户id orgId String 10 系统自动生成
3 凭证编号 preentNo String 64 系统自动生成
4 出入库类型 inExpType String 1 0-空车进出区 1-非径予放行货物 2-先报后送 3-分送集报 4-区内流转 5-区间流转 6-进出境径予放行 7-二线进出 8-便捷进出区 9-一单多车B 10-分送集报退运 11-配套货物 13-保税区内直转 M
5 经营企业编号 bizopEtpsNo String 10 M
6 经营单位名称 bizopEtpsNm String 768 M
7 经营单位社会信用代码 bizopEtpsSccd String 18 M
8 进出标志 ieTypecd String 2 I-进区；E-出区 M
9 料件、成品标志 mtpckEndprdTypecd String 1 I-料件，E-成品，S-设备，L-边角料，D-残次品，F-待维修件，G-已维修件，H-维修边角料，J-维修坏件，B-半成品 空车进出区不填写,其余必填
10 进出境关别 impexpPortcd String 4 关区代码 M
11 主管海关 masterCuscd String 4 yyyy-MM-dd HH:mm:ss M
12 申报日期 dclTime String 系统反填
13 进出卡口状态 portIochkptStucd String 1 系统反填1-未过卡 2-已过卡
14 是否记入企业账户标记 recAccountFlag String 1 0-不计入；1-计入
15 境内收发货企业名称 rcvgdEtpsNm String 768 M
16 境内收发货企业编码 rcvgdEtpsNo String 10 M
17 境内收发货企业社会信用代码 rcvgdEtpsSccd String 18 M
18 承运车车牌号 vehicleNo String 128 当业务类型为24-便捷汽车出口可以为空 M
19 IC卡号(电子车牌） vehicleIcNo String 128
20 集装箱号 containerNo String 12
21 车自重 vehicleWt String 19,5 当业务类型为24-便捷汽车出口可以为空 M
22 车架号 vehicleFrameNo String 256
23 车架重 vehicleFrameWt String 19,5 当业务类型为24-便捷汽车出口可以为空 M
24 集装箱箱型 containerType String 256
25 集装箱重 containerWt String 19,5
26 总重量 totalWt String 19,5 当业务类型为24-便捷汽车出口可以为空 M
27 卡口地磅采集重量 passCollectWt String 19,5
28 重量比对误差 wtError String 19,5
29 货物总毛重 totalGrossWt String 19,5 当业务类型为24-便捷汽车出口可以为空 M
30 货物总净重 totalNetWt String 19,5
31 过卡时间1 passTime String 系统自动生成
32 过卡时间2 secdPassTime String 系统自动生成
33 绑定类型 bindTypecd String 1 1-一车多票；2-一车一票；3-一票多车 出入库类型为分送集报及空车进出不填
34 委托标识 entrustSign String 1 0-未委托；1-委托
35 备注 rmk String 4000
36 操作状态 optStatus String 10 见操作状态表 M
37 申报类型 dclTypecd String 1 1-备案 2-变更 3-作废 M
38 关联单证编号 rltPortRecNo String 64 必填的情况：
1、临时进出区（进）关联临时进出区（出）
2、设备出区（进）关联设备出区（出）
3、模具外发（进）关联模具外发（出）
4、外发加工、飞机试飞、保税展示 关联 业务申报表
5、一司两地类型（出区）关联 一司两地类型（进区）
39 是否回区 isReturnArea String 1 系统反填 1-未回区，2-部分回区，3-全部回区
40 是否绑定 isBandPlane String 1 系统反填 1-未绑定，2-部分绑定，3已绑定
41 业务类型 businessTypecd String 10 出入库类型为7-二线进出的时候必填 6-跨境电商 15-临时进出区 16-设备出区 17-模具外发 18-外发加工 21-飞机试飞 22-保税展示 23-一司两地流转 24-便捷汽车出口
42 总担保编号 grtNo String 64 出入库类型为分送集报出区且非免担保时必填
43 回区期限 backTime String 加工业务回区时间期限
44 成交方式 transMode String 10 参见成交方式码表
45 企业内部编号 enterNumber String 64 企业内部编号
46 特殊业务类型 specialBusiness String 1 1-退单，2-海运拼箱
47 是否免担保 isGrt String 10 1-免担保，0-担保
48 预记入企业账户时间 preRecAccountTime String 20 yyyy-MM-dd HH:mm:ss
49 正式记入企业账户时间 preAccountTime String 20 yyyy-MM-dd HH:mm:ss
50 变更次数 chgTmsCnt String 10 系统自动生成
51 出境数量 exitQuantity String 19 业务类型为24-便捷汽车出口必填
52 分送集报退运标识 returnBackStatus String 2 系统自动生成0-未退运；1-退运未过卡；2-部分退运完成；3-全部退运完成；
53 货物已进入待检区 goodsArrived String 2 1-已进入成；

# 9.2、卡口验放凭证表体信息

序号 中文名称 字段名称 数据类型 长度 注释 是否必填
1 id id String 暂存时系统自动生成 修改必填
2 表头id pid String 暂存时系统自动生成 修改必填
3 子账户id orgId String 暂存时系统自动生成 修改必填
4 凭证编号 portNo String 64 暂存时系统自动生成 修改必填
5 关联单证编号 rltNo String 64 出入库类型为：1、2、4、5、9类型必填 出入库类型为：1、2、4、5、9类型
6 关联表体序号 rltSeqno String 10 1.出入库类型为：1、2、4、5、9类型，绑定类型为3-一票多车时要填写关联明细序号；2.出入库类型为3-分送集报时，表体不可填写关联明细序号 出入库类型为：1、2、4、5、9类型，绑定类型为3-一票多车时要填写关联明细序号；
7 明细序号 gdsSeqno String 10 暂存时系统自动生成 修改必填
8 商品料号 gdsMtno String 32 M
9 商品编码 gdecd String 10 M
10 商品名称 gdsNm String 768 M
11 规格型号 gdsSpcfModelDesc String 768
12 币制 dclCurrcd String 3 M
13 申报数量 dclQty String 19,5 M
14 申报计量单位 dclUnitcd String 3 M
15 原产国（地区） natcd String 3 参见原产国码表 M
16 净重 netWt String 19,5
17 总价 dclTotalAmt String 19,5 M
18 修改标志代码 modfMarkcd String 4 申报类型为变更的时候需要填写1-修改，2-删除，3-新增
19 法定数量 qty1 String 19,5 出入库类型为分送集报必填
20 法定单位 unit1 String 3 出入库类型为分送集报必填

# 9.3、卡口验放凭证关联单证表信息

注：出入库类型为空车进出区和分送集报不需要填写，其余类型都需要填写

序号 中文名称 字段名称 数据类型 长度 注释 是否必填
1 id id String 10 暂存时系统自动生成 修改必填
2 表头id pid String 10 暂存时系统自动生成 修改必填
3 子账户id orgId String 10 暂存时系统自动生成 修改必填
4 卡口验放凭证编号 portNo String 64 暂存时系统自动生成 修改必填
5 关联单证类型 rltTbTypecd String 1 1-进出区提发货；2-径予提货单；3-径予发货单; 4-临时进出区;5-设备出区;6-模具外发; 7-个人申报清单；8-便捷进出区 M
6 关联单证编号 rltNo String 64 进出区提发货编号/径予单证编号/个人申报清单编号 M

# 9.4、卡口验放凭证出入库关联表信息

注：暂存阶段无须填写，审核通过后按照实际情况填写

序号 中文名称 字段名称 数据类型 长度 注释 是否必填
1 id Id String 10 系统自动生成
2 表头id pid String 10 系统自动生成
3 子账户id orgId String 10 系统自动生成
4 卡口验放凭证编号 preentNo String 64 系统自动生成
5 出入库单编号 inExpWhNo String 64 M
6 出入库时间 inExpTime String M

# 9.5、卡口验放凭证操作状态表

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 系统自动生成
2 提发货的id pid String 10 系统自动生成
3 创建时间 createTime String 系统自动生成
4 操作状态 optStatus String 50 系统自动生成
5 操作人名称 optUserName String 50 系统自动生成
6 操作时间 optTime String 系统自动生成
7 备注 remark String 1000 系统自动生成

# 9.6、卡口验放凭证仓库库位表

注：出入库类型为9-一单多车B的时候必填

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 修改必填 系统自动生成
2 关联表体id pid String 10 修改必填 系统自动生成
3 卡口验放凭证id portId String 修改必填 系统自动生成
4 对应进出区提发货库位表id whtStoreId String 50 修改必填 系统自动生成
5 卡口验放凭证编号 preentNo String 50 修改必填 系统自动生成
6 仓库号 whtNumber String 1000
7 库位号 storeNumber String 1000 必填
8 数量 dclQty String 19,5 必填

# 9.7、卡口验放凭证VIN码汇总表

注：业务类型为24（便捷汽车出口）的时候必填

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 修改必填 系统自动生成
2 卡口验放表头主键ID PID String 11 系统自动生成
3 卡口验放凭证编号 PREENT_NO String 64 系统自动生成
5 关联单证编号 RLT_NO String 64 必填（对应提发货凭证编号）
6 对应明细序号 VIN_GDS_SEQNO String 10 必填（对应提发货凭证的表体明细序号）
7 VIN码 VIN String 17 必填
8 状态 OPT_STATUS String 10
9 过卡时间 PASS_TIME String
10 备注 RMK String 500

# 9.7、暂存/修改接口

接口名称 卡口核放凭证暂存接口与修改
接口功能 通过接口新增或修改卡口核放凭证信息
接口协议 HTTP、Content-Type：application/json
请求地址 /portRelease/save
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String 修改必填 暂存系统自动生成
子账户id orgId String 系统自动生成
凭证编号 preentNo String 修改必填 暂存系统自动生成
出入库类型 inExpType String M 0：空车进出区
1：非径予放行货物
2：先报后送
3：分送集报
4：区内流转
5：区间流转
6：进出境径予放行
7：二线进出
8：便捷进出区
9：一单多车B
10：分送集报退运
11：配套货物
13：保税区内直转
经营企业编码 bizopEtpsNo String M
经营单位名称 bizopEtpsNm String M
经营企业社会信用代码 bizopEtpsSccd String M
进出标志 ieTypecd String M I-进区；E-出区
料件、成品标志 mtpckEndprdTypecd String 空车进出区不填写,其余必填 I-料件,E-成品, S-设备,L-边角料,D-残次品,F-待维修件,G-已维修件,H-维修边角料,J-维修坏件，B-半成品（空车进出区不填写）
进出境关别 impexpPortcd String M 关区代码
主管海关 masterCuscd String M
申报日期 dclTime String 系统自动生成
进出卡口状态 portIochkptStucd String 系统自动生成 1-未过卡 2-已过卡
是否记入企业账户标记 recAccountFlag String 0-不计入；1-计入
境内收发货企业名称 rcvgdEtpsNm String
境内收发货企业编码 rcvgdEtpsNo String M
境内收发货企业社会信用代码 rcvgdEtpsSccd String M
承运车车牌号 vehicleNo String M 当业务类型为24-便捷汽车出口可以为空
IC卡号(电子车牌） vehicleIcNo String
集装箱号 containerNo String
车自重 vehicleWt String M 当业务类型为24-便捷汽车出口可以为空
车架号 vehicleFrameNo String 当业务类型为24-便捷汽车出口可以为空
车架重 vehicleFrameWt String M
集装箱箱型 containerType String
集装箱重 containerWt String
总重量 totalWt String M 当业务类型为24-便捷汽车出口可以为空
卡口地磅采集重量 passCollectWt String
重量比对误差 wtError String
货物总毛重 totalGrossWt String M 当业务类型为24-便捷汽车出口可以为空
货物总净重 totalNetWt String
过卡时间1 passTime String 系统自动生成 yyyy-MM-dd HH:mm:ss
过卡时间2 secdPassTime String 系统自动生成 yyyy-MM-dd HH:mm:ss
绑定类型 bindTypecd String 出入库类型为分送集报及空车进出不填， 1-一车多票；2-一车一票；3-一票多车
委托标识 entrustSign String 0-未委托；1-委托
备注 rmk String
操作状态 optStatus String M 见操作状态表
申报类型 dclTypecd String 1：备案 2：变更 3：作废
关联单证编号 rltPortRecNo String 必填的情况：
1、临时进出区（进）关联临时进出区（出）
2、设备出区（进）关联设备出区（出）
3、模具外发（进）关联模具外发（出）
4、外发加工、飞机试飞、保税展示 关联 业务申报表
5、一司两地类型（出区）关联 一司两地类型（进区）
是否回区 isReturnArea String 系统自动生成 1：未回区 2：部分回区 3：全部回区
是否绑定 isBandPlane String 修改必填 系统自动生成 1-未绑定，2-部分绑定，3已绑定
业务类型 businessTypecd String 出入库类型为7-二线进出的时候必填 出入库类型为7-二线进出的时候必填，其余类型不需要填写
6：跨境电商
15：临时进出区
16：设备出区
17：模具外发
18：外发加工
21：飞机试飞
22：保税展示
总担保编号 grtNo String 出入库类型为分送集报出区且非免担保时必填 出入库类型为分送集报出区且非免担保时必填
回区期限 backTime String 加工业务回区时间期限
成交方式 transMode String 参见成交方式码表
企业内部编号 enterNumber String 企业内部编号
特殊业务类型 specialBusiness String 1-退单，2-海运拼箱
是否免担保 isGrt String M 1-免担保，0-担保
预记入企业账户时间 preRecAccountTime String M
正式记入企业账户时间 preAccountTime String
变更次数 chgTmsCnt String 系统自动生成
出境数量 exitQuantity String 必填（数字类型，不能有小数）
货物已进入待检区 goodsArrived String
卡口验放凭证表体 portReleaseDt String json对象
id id String 修改必填 暂存系统自动生成
表头id pid String 修改必填 暂存系统自动生成
子账户id orgId String 修改必填 暂存系统自动生成
凭证编号 portNo String 修改必填 暂存系统自动生成
关联单证编号 rltNo String 出入库类型为：1、2、4、5、9类型必填 出入库类型为：1、2、4、5、9类型必填
关联表体序号 rltSeqno String 出入库类型为：1、2、4、5、9类型，绑定类型为3-一票多车时要填写关联明细序号； 1.出入库类型为：1、2、4、5、9类型，绑定类型为3-一票多车时要填写关联明细序号；
2.出入库类型为3-分送集报时，表体不可填写关联明细序号
明细序号 gdsSeqno String 修改必填 暂存系统自动生成
商品料号 gdsMtno String M
商品编码 gdecd String M
商品名称 gdsNm String M
规格型号 gdsSpcfModelDesc String
币制 dclCurrcd String M
申报数量 dclQty String M
申报计量单位 dclUnitcd String M
原产国（地区） natcd String M 参见原产国码表
净重 netWt String
总价 dclTotalAmt String M
修改标志代码 modfMarkcd String 申报类型为变更且需要变更关联单证需要填写 0-未修改 1-修改2-删除 3-增加
法定数量 qty1 String 出入库类型为分送集报必填
法定单位 unit1 String 出入库类型为分送集报必填
卡口验放凭证关联单证 portReleaseRlt json对象 出入库类型为空车进出区和分送集报不需要填写，其余类型都需要填写
id id String 修改必填 暂存系统自动生成
表头id pid String 修改必填 暂存系统自动生成
子账户id orgId String 修改必填 暂存系统自动生成
卡口验放凭证编号 portNo String 修改必填 暂存系统自动生成
关联单证类型 rltTbTypecd String M 1-进出区提发货凭证；
2-径予提货单；
3-径予发货单；
4-临时进出区；
5-设备出区；
6-模具外发；
7-个人申报清单；
8-便捷进出区
关联单证编号 rltNo String M 进出区提发货编号/径予提发货单证编号/个人申报清单/便捷进出区编号
仓库库位信息 portStore 作为每个portReleaseDt对象中的json对象 出入库类型为9-一单多车B的时候必填
id id String 修改必填 系统自动生成
关联表体id pid String 修改必填 系统自动生成
卡口验放凭证id portId String 修改必填 系统自动生成
对应进出区提发货库位表id whtStoreId String 修改必填 系统自动生成
卡口验放凭证编号 preentNo String 修改必填 系统自动生成
仓库号 whtNumber String
库位号 storeNumber String 必填
数量 dclQty String 必填
VIN码汇总信息 portReleaseVin json对象 业务类型为24-便捷汽车出口 必填
id id String 修改必填 系统自动生成
关联表头id pid String 修改必填 系统自动生成
卡口验放凭证编号 preentNo String 修改必填 系统自动生成
对应明细序号 vinGdsSeqno String 必填
VIN码 vin String 必填
状态 optStatus String 必填
过卡时间 passTime String
关联单证编号 rltNo String 必填
备注 rmk String
代码示例
详细信息请参考卡口验放凭证基本信息、卡口验放凭证表体信息、卡口验放凭证关联单证信息、卡口验放凭证仓库库位表。

提示：1.新增id为空，修改id不能为空，id为""且dclTypecd为2表示第一次变更暂存。



          {
              "id": "",
              "orgId": "",
              "preentNo": "",
              "inExpType": "3",
              "bizopEtpsNo": "0000000009",
              "bizopEtpsNm": "上海优选",
              "bizopEtpsSccd": "123450000000009123",
              "inExpTime": "2021-03-23 00:00:00",
              "ieTypecd": "E",
              "mtpckEndprdTypecd": "I",
              "impexpPortcd": "2249",
              "masterCuscd": "2249",
              "dclTime": null,
              "preRecAccountTime": null,
              "recAccountTime": null,
              "rcvgdEtpsNo": "0000000009",
              "rcvgdEtpsNm": "上海优选",
              "rcvgdEtpsSccd": "123450000000009123",
              "vehicleNo": "沪K99084",
              "vehicleIcNo": null,
              "containerNo": null,
              "vehicleWt": "123.00000",
              "vehicleFrameNo": null,
              "vehicleFrameWt": "123.00000",
              "containerType": null,
              "containerWt": "",
              "totalWt": "369.00000",
              "passCollectWt": null,
              "wtError": null,
              "totalGrossWt": "123.00000",
              "totalNetWt": "",
              "bindTypecd": "",
              "rmk": null,
              "optStatus": "1",
              "grtNo": "102848RT210226000722",
              "entrustSign": "0",
              "dclTypecd": "1",
              "inexpRltType": "0",
              "isRltInexp": null,
              "rltPortRecNo": null,
              "businessTypecd": "",
              "backTime": "",
              "transMode": "1",
              "enterNumber": null,
              "amountOfTax": null,
              "specialBusiness": null,
              "isGrt": "0",
              "goodsArrived": "",
              "portReleaseDt": [{
                "id": "",
                "pid": "",
                "orgId": "",
                "portNo": "",
                "rltNo": null,
                "rltSeqno": null,
                "gdsSeqno": "1",
                "gdsMtno": "LH001",
                "gdecd": "0809400090",
                "gdsNm": "发动机",
                "gdsSpcfModelDesc": "4|2|发动机",
                "dclCurrcd": "142",
                "dclQty": "80.00000",
                "dclUnitcd": "001",
                "natcd": "142",
                "netWt": "200.00000",
                "dclTotalAmt": "16000.00000",
                "qty1": "1",
                "unit1": "001",
                "modfMarkcd": null,
                "portStore": []
              }],
              "portReleaseRlt": [{
                "id": "",
                "orgId": "104370",
                "pid": "194898",
                "portNo": "104370JY221108194898",
                "rltNo": "18I202211081004148",
                "rltTbTypecd": "2",
              }],
              "portReleaseVin": [{
                "id": "",
                "pid": "",
                "preentNo": "",
                "vinGdsSeqno": "1",
                "vin": "LRW20220720000134",
                "optStatus": null,
                "passTime": null,
                "rmk": null,
                "rltNo": "103903WH220722026834"
              }]
            }
显示代码
出参
代码示例
提示：map里面的出参可以忽略 


          {
              "status": "1",
              "note": "暂存成功",
              "description": null,
              "map": {
                  "rltList": [

              ],
              "data": 84581,
              "dtList": [
                  {
                      "id": 6157648,
                      "pid": 84581,
                      "orgId": 102031,
                      "portNo": "102031ZV210906084581",
                      "rltNo": null,
                      "rltSeqno": null,
                      "gdsSeqno": 1,
                      "gdsMtno": "LH001",
                      "gdecd": "0809400090",
                      "gdsNm": "发动机",
                      "gdsSpcfModelDesc": "4|2|发动机",
                      "dclCurrcd": "142",
                      "dclQty": 80.0,
                      "dclUnitcd": "001",
                      "natcd": "142",
                      "netWt": 200.0,
                      "stockDtId": "21",
                      "dclTotalAmt": 16000.0,
                      "passportUsedQty": 0,
                      "actlPassQty": 0,
                      "remainQty": 80.0,
                      "classifyType": "I",
                      "qty1": 1.0,
                      "unit1": "001",
                      "dutyMode": null,
                      "modfMarkcd": null
                  }
              ]
          }
      }
显示代码

# 9.8、删除接口

接口名称 卡口核放凭证删除接口
接口功能 根据业务id删除卡口验放凭证
接口协议 HTTP、Content-Type：application/json
请求地址 /portRelease/delete
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
卡口核放凭证表头id集合 ids String[] M
代码示例


          {
              "ids":["82778"]
          }
显示代码
出参
代码示例
提示：map里面的出参可以忽略 


          {
              "status": "1",
              "note": "删除成功",
              "description": null,
              "map": {
                "data": {
                  "id": "102031",
                  "tradeId": "2101137",
                  "tradeCode": "0000000009",
                  "type": "22",
                  "orgCode": "102031",
                  "status": "5",
                  "dclTypecd": "1",
                  "sysCode": null,
                  "source": null,
                  "customId": "2249",
                  "customCode": "2249",
                  "angencyScope": null,
                  "customName": "洋山保税",
                  "icCard": null,
                  "tradeName": null,
                  "organizationE": {
                    "id": "100019",
                    "orgId": "102031",
                    "address": null,
                    "zip": null,
                    "person": null,
                    "tel": null,
                    "email": null,
                    "area": null,
                    "remark": null,
                    "organization": []
                  },
                  "orgrelation": null,
                  "accountBookModel": []
                }
              }
            }
显示代码

# 9.9、列表查询接口

接口名称 卡口核放凭证查询列表接口
接口功能 企业通过该接口查询本组织下所有的卡口验放凭证列表信息
接口协议 HTTP、Content-Type：application/json
请求地址 /portRelease/getList
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
每页信息数 size Number M
页数 page Number M
凭证编号 preentNo String
单证状态 optStatus String 详情状态列表
EPR/WMS出入库类型 inExpType String 详情卡口验放凭证基本信息
进出标志 ieTypecd String I-进，E-出
关联单证编号 rltNo String
承运车车牌号 vehicleNo String
VIN码 VIN String VIN码字段查询时都为大写字母
代码示例


          {
              "ieTypecd": "E",
              "inExpType": "1",
              "optStatus": "18",
              "page": 1,
              "preentNo": "000621ZV200410000664",
              "rltNo": "234243",
              "size": 10,
              "vehicleNo": "沪A11111",
              "VIN": "LSK231624KL124532"
          }
显示代码
出参
代码示例
详情参考卡口验放凭证基本信息。

提示：出参不包含在卡口验放凭证基本信息中的字段均可忽略。



          {
              "status": "1",
              "note": "卡口核放凭证查询列表",
              "description": null,
              "map": {
                "data": {
                  "sort": [{
                    "direction": "DESC",
                    "property": "id",
                    "ignoreCase": false,
                    "nullHandling": "NATIVE",
                    "ascending": false,
                    "descending": true
                  }],
                  "first": true,
                  "last": true,
                  "numberOfElements": 0,
                  "totalPages": 1,
                  "totalElements": 1,
                  "size": 10,
                  "content": [{
                    "id": "664",
                    "orgId": "621",
                    "portNo": null,
                    "preentNo": "000621ZV200410000664",
                    "inExpWhNo": null,
                    "inExpType": "3",
                    "bizopEtpsNo": "1100696075",
                    "bizopEtpsNm": "陈大哥企业联盟11",
                    "bizopEtpsSccd": "123456789012345678",
                    "inExpTime": null,
                    "ieTypecd": "E",
                    "mtpckEndprdTypecd": "S",
                    "impexpPortcd": "2201",
                    "masterCuscd": "2249",
                    "dclTime": null,
                    "preRecAccountTime": null,
                    "recAccountTime": null,
                    "portIochkptStucd": null,
                    "recAccountFlag": null,
                    "rcvgdEtpsNo": "2344",
                    "rcvgdEtpsNm": "翎菱羚",
                    "rcvgdEtpsSccd": null,
                    "vehicleNo": "泽A15355",
                    "vehicleIcNo": "000621ZV200410000664",
                    "containerNo": null,
                    "vehicleWt": "33",
                    "vehicleFrameNo": null,
                    "vehicleFrameWt": "4",
                    "containerType": null,
                    "containerWt": null,
                    "totalWt": "37",
                    "passCollectWt": null,
                    "wtError": null,
                    "totalGrossWt": null,
                    "totalNetWt": "0",
                    "passTime": null,
                    "secdPassTime": null,
                    "bindUsedTypecd": "1",
                    "bindTypecd": null,
                    "rmk": null,
                    "optStatus": "1",
                    "portReleaseDt": [],
                    "portReleaseRlt": [],
                    "portReleaseStatus": [],
                    "portReleaseInexpRlt": [],
                    "portReleaseVin": []
                  }],
                  "number": 0
                }
              }
            }
显示代码

# 9.10、列表明细接口

接口名称 卡口核放凭证查询明细接口
接口功能 根据业务id查询卡口验放凭证详细
接口协议 HTTP、Content-Type：application/json
请求地址 /portRelease/getDetail
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
id id String M
代码示例


          {
              "id": "664
          }
显示代码
出参
代码示例
详情请参考卡口验放凭证基本信息、卡口验放凭证表体信息、卡口验放凭证关联单证信息、卡口验放凭证出入库信息

提示：出参不包含在卡口验放凭证基本信息、卡口验放凭证表体信息、卡口验放凭证关联单证信息、卡口验放凭证出入库信息中的字段均可忽略。



          {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                "data": {
                  "id": "664",
                  "orgId": "621",
                  "portNo": null,
                  "preentNo": "000621ZV200410000664",
                  "inExpWhNo": null,
                  "inExpType": "3",
                  "bizopEtpsNo": "1100696075",
                  "bizopEtpsNm": "陈大哥企业联盟11",
                  "bizopEtpsSccd": "123456789012345678",
                  "inExpTime": null,
                  "ieTypecd": "E",
                  "mtpckEndprdTypecd": "S",
                  "impexpPortcd": "2201",
                  "masterCuscd": "2249",
                  "dclTime": null,
                  "preRecAccountTime": null,
                  "recAccountTime": null,
                  "portIochkptStucd": null,
                  "recAccountFlag": null,
                  "rcvgdEtpsNo": "2344",
                  "rcvgdEtpsNm": "翎菱羚",
                  "rcvgdEtpsSccd": null,
                  "vehicleNo": "泽A15355",
                  "vehicleIcNo": "000621ZV200410000664",
                  "containerNo": null,
                  "vehicleWt": "33.00000",
                  "vehicleFrameNo": null,
                  "vehicleFrameWt": "4.00000",
                  "containerType": null,
                  "containerWt": null,
                  "totalWt": "37.00000",
                  "passCollectWt": null,
                  "wtError": null,
                  "totalGrossWt": null,
                  "totalNetWt": "0.00000",
                  "passTime": null,
                  "secdPassTime": null,
                  "bindUsedTypecd": "1",
                  "bindTypecd": null,
                  "rmk": null,
                  "optStatus": "1",
                  "portReleaseDt": [],
                  "portReleaseRlt": [],
                  "portReleaseStatus": [{
                    "id": "1748",
                    "pid": "664",
                    "createTime": "2020-04-10 14:24:23",
                    "optStatus": "1",
                    "optUserId": "8",
                    "optUserName": "liyingze001",
                    "optTime": "2020-04-10 14:24:23",
                    "remark": "暂存成功",
                    "fileName": null
                  }, {
                    "id": "1736",
                    "pid": "664",
                    "createTime": "2020-04-10 14:02:38",
                    "optStatus": "1",
                    "optUserId": "1149",
                    "optUserName": "shenxiaohui001",
                    "optTime": "2020-04-10 14:02:38",
                    "remark": "暂存成功",
                    "fileName": null
                  }, {
                    "id": "1734",
                    "pid": "664",
                    "createTime": "2020-04-10 13:59:56",
                    "optStatus": "1",
                    "optUserId": "8",
                    "optUserName": "liyingze001",
                    "optTime": "2020-04-10 13:59:56",
                    "remark": "暂存成功",
                    "fileName": null
                  }],
                  "portReleaseInexpRlt": [],
                  "portReleaseVin": []
                }
              }
            }
显示代码

# 9.11、确认接口

接口名称 卡口核放申报接口
接口功能 根据业务id值向海关申报卡口验放凭证单证，等待回执
接口协议 HTTP、Content-Type：application/json
请求地址 /portRelease/declare
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
卡口核放凭证id集合 bscIds Int[] M
代码示例


          {
              "bscIds": [661]
          }
显示代码
出参
代码示例


          {
            "status" : "1",
            "note" : "确认成功",
            "description" : null,
            "map" : null
          }
显示代码

# 9.12、作废接口

接口名称 卡口核放凭证作废
接口功能 根据业务id值向海关申请作废卡口验放凭证，等待回执
接口协议 HTTP、Content-Type：application/json
接口方向 企业调用新片区海关监管系统
请求地址 /portRelease/useless
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
卡口核放凭证id集合 bscIds String[] M
代码示例


          {
              "bscIds": ["1768"]
          }
显示代码
出参
代码示例


          {
            "status" : "1",
            "note" : "申报成功",
            "description" : null,
            "map" : null
          }
显示代码

# 9.13、关联出入库新增接口

接口名称 卡口核放出入库单证新增接口
接口功能 卡口验放凭证关联出入库保存
接口协议 HTTP、Content-Type：application/json
请求地址 /portRelease/saveInexpRlt
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
出入库单证表id id String
凭证编号 preentNo String M
ERP/WMS出入库编号 inExpTime String M
表头id pid String M
子账户id orgId String M
代码示例


            {
                "id": "",
                "pid": "1771",
                "orgId": "61",
                "preentNo": "000061ZV200720001771",
                "inExpWhNo": "1",
                "inExpTime": "2020-07-20 13:24:09",
                "rmk": "1"
            }
显示代码
出参
代码示例


            {
              "status" : "1",
              "note" : "inexpRlt新增成功",
              "description" : null,
              "map" : null
            }
显示代码

# 9.14、关联出入库删除接口

接口名称 卡口核放出入库单证删除接口
接口功能 通过出入库id删除卡口验放凭证关联出入库
接口协议 HTTP、Content-Type：application/json
接口方向 企业调用新片区海关监管系统
请求地址 /portRelease/delInexpRlt
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
关联单证编号id ids String M
代码示例


            {
                "ids": "1354"
            }
显示代码
出参
代码示例


            {
              "status" : "1",
              "note" : "删除成功",
              "description" : null,
              "map" : null
            }
显示代码

# 9.15、关联出入库确认接口

接口名称 出入库确认接口
接口功能 企业向海关同步卡口验放凭证出入库信息
接口协议 HTTP、Content-Type：application/json
接口方向 企业调用新片区海关监管系统
请求地址 /portRelease/declareInexpRlt
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
卡口核放凭证表头id bscId String M
代码示例


            {
                 "bscId": "1771"
            }
显示代码
出参
代码示例


          {
            "status" : "1",
            "note" : "确认成功",
            "description" : null,
            "map" : null
          }
显示代码

# 9.16、分送集报退运暂存/修改接口

接口名称 卡口核放凭证退运暂存与修改接口
接口功能 企业可以对进区/出区、分送集报、已过卡、未集报、未退运或者部分退完成 的单证进行退运
接口说明 表头：
1.退运单证和原分送集报单证的方向必须互斥（例：进区的分送集报单证只能对应出区的分送集报退运单证）
2.退运单证表头的关联单证编号填写原分送集报单证编号
表体：
1.退运单证表体必须沿用原分送集报单证的表体；
2.表体的关联单证编号必须是原分送集报单证的编号，关联表体序号必须是原分送集报单证的明细序号；
3.表体仅可修改数量、总价、净重、法定第一数量四个字段
关联单证：
1.填写原分送集报单证编号
接口协议 HTTP、Content-Type：application/json
请求地址 /portRelease/save
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String 修改必填 暂存系统自动生成
子账户id orgId String 系统自动生成
凭证编号 preentNo String 修改必填 暂存系统自动生成
出入库类型 inExpType String M 10-分送集报退运
经营企业编码 bizopEtpsNo String M
经营单位名称 bizopEtpsNm String M
经营企业社会信用代码 bizopEtpsSccd String M
进出标志 ieTypecd String M I-进区；E-出区
料件、成品标志 mtpckEndprdTypecd String 空车进出区不填写,其余必填 I-料件,E-成品, S-设备,L-边角料,D-残次品,F-待维修件,G-已维修件,H-维修边角料,J-维修坏件，B-半成品（空车进出区不填写）
进出境关别 impexpPortcd String M 关区代码
主管海关 masterCuscd String M
申报日期 dclTime String 系统自动生成
进出卡口状态 portIochkptStucd String 系统自动生成 1-未过卡 2-已过卡
是否记入企业账户标记 recAccountFlag String 0-不计入；1-计入
境内收发货企业名称 rcvgdEtpsNm String
境内收发货企业编码 rcvgdEtpsNo String M
境内收发货企业社会信用代码 rcvgdEtpsSccd String M
承运车车牌号 vehicleNo String M 当业务类型为24-便捷汽车出口可以为空
IC卡号(电子车牌） vehicleIcNo String
集装箱号 containerNo String
车自重 vehicleWt String M 当业务类型为24-便捷汽车出口可以为空
车架号 vehicleFrameNo String 当业务类型为24-便捷汽车出口可以为空
车架重 vehicleFrameWt String M
集装箱箱型 containerType String
集装箱重 containerWt String
总重量 totalWt String M 当业务类型为24-便捷汽车出口可以为空
卡口地磅采集重量 passCollectWt String
重量比对误差 wtError String
货物总毛重 totalGrossWt String M 当业务类型为24-便捷汽车出口可以为空
货物总净重 totalNetWt String
过卡时间1 passTime String 系统自动生成 yyyy-MM-dd HH:mm:ss
过卡时间2 secdPassTime String 系统自动生成 yyyy-MM-dd HH:mm:ss
绑定类型 bindTypecd String 出入库类型为分送集报及空车进出不填， 1-一车多票；2-一车一票；3-一票多车
委托标识 entrustSign String 0-未委托；1-委托
备注 rmk String
操作状态 optStatus String M 见操作状态表
申报类型 dclTypecd String 1-备案 2-变更 3-作废
关联单证编号 rltPortRecNo String 分送集报退运时必填，需要退运的单证编号
是否回区 isReturnArea String 系统自动生成 1：未回区 2：部分回区 3：全部回区
是否绑定 isBandPlane String 修改必填 系统自动生成 1-未绑定，2-部分绑定，3已绑定
业务类型 businessTypecd String 出入库类型为7-二线进出的时候必填 出入库类型为7-二线进出的时候必填，其余类型不需要填写
6：跨境电商
15：临时进出区
16：设备出区
17：模具外发
18：外发加工
21：飞机试飞
22：保税展示
总担保编号 grtNo String 出入库类型为分送集报出区且非免担保时必填
回区期限 backTime String 加工业务回区时间期限
成交方式 transMode String 参见成交方式码表
企业内部编号 enterNumber String 企业内部编号
特殊业务类型 specialBusiness String 1-退单，2-海运拼箱
是否免担保 isGrt String M 1-免担保，0-担保
预记入企业账户时间 preRecAccountTime String M
正式记入企业账户时间 preAccountTime String
变更次数 chgTmsCnt String 系统自动生成
出境数量 exitQuantity String 必填（数字类型，不能有小数）
分送集报退运标识 returnBackStatus String 分送集报类型单证：接口内部默认设为0-未退运
已进入待检区域 goodsArrived String
卡口验放凭证表体 portReleaseDt String json对象
id id String 修改必填 暂存系统自动生成
表头id pid String 修改必填 暂存系统自动生成
子账户id orgId String 修改必填 暂存系统自动生成
凭证编号 portNo String 修改必填 暂存系统自动生成
关联单证编号 rltNo String 出入库类型为：1、2、4、5、9类型必填
关联表体序号 rltSeqno String 出入库类型为：1、2、4、5、9类型，绑定类型为3-一票多车时要填写关联明细序号； 1.出入库类型为3-分送集报时，表体不可填写关联明细序号
明细序号 gdsSeqno String 修改必填 暂存系统自动生成
商品料号 gdsMtno String M
商品编码 gdecd String M
商品名称 gdsNm String M
规格型号 gdsSpcfModelDesc String
币制 dclCurrcd String M
申报数量 dclQty String M
申报计量单位 dclUnitcd String M
原产国（地区） natcd String M 参见原产国码表
净重 netWt String
总价 dclTotalAmt String M
修改标志代码 modfMarkcd String 申报类型为变更且需要变更关联单证需要填写 0-未修改 1-修改2-删除 3-增加
法定数量 qty1 String 出入库类型为分送集报必填
法定单位 unit1 String 出入库类型为分送集报必填
卡口验放凭证关联单证 portReleaseRlt json对象 出入库类型为空车进出区和分送集报不需要填写，其余类型都需要填写
id id String 修改必填 暂存系统自动生成
表头id pid String 修改必填 暂存系统自动生成
子账户id orgId String 修改必填 暂存系统自动生成
卡口验放凭证编号 portNo String 修改必填 暂存系统自动生成
关联单证类型 rltTbTypecd String M 1-进出区提发货凭证；
2-径予提货单；
3-径予发货单；
4-临时进出区；
5-设备出区；
6-模具外发；
7-个人申报清单；
8-便捷进出区
关联单证编号 rltNo String M 进出区提发货编号/径予提发货单证编号/个人申报清单/便捷进出区编号
仓库库位信息 portStore 作为每个portReleaseDt对象中的json对象 出入库类型为9-一单多车B的时候必填
id id String 修改必填 系统自动生成
关联表体id pid String 修改必填 系统自动生成
卡口验放凭证id portId String 修改必填 系统自动生成
对应进出区提发货库位表id whtStoreId String 修改必填 系统自动生成
卡口验放凭证编号 preentNo String 修改必填 系统自动生成
仓库号 whtNumber String
库位号 storeNumber String 必填
数量 dclQty String 必填
VIN码汇总信息 portReleaseVin json对象 业务类型为24-便捷汽车出口 必填
id id String 修改必填 系统自动生成
关联表头id pid String 修改必填 系统自动生成
卡口验放凭证编号 preentNo String 修改必填 系统自动生成
对应明细序号 vinGdsSeqno String 必填
VIN码 vin String 必填
状态 optStatus String 必填
过卡时间 passTime String
关联单证编号 rltNo String 必填
备注 rmk String
代码示例
详细信息请参考卡口验放凭证基本信息、卡口验放凭证表体信息、卡口验放凭证关联单证信息、卡口验放凭证仓库库位表。

提示：1.新增id为空，修改id不能为空，id为""且dclTypecd为2表示第一次变更暂存。



          {
              "id": "",
              "orgId": "103240",
              "portNo": null,
              "preentNo": "",
              "inExpWhNo": null,
              "inExpType": "10",
              "bizopEtpsNo": "1070S21113",
              "bizopEtpsNm": "上海怡亚通临港供应链有限公司",
              "bizopEtpsSccd": "22490202107021113G",
              "inExpTime": null,
              "ieTypecd": "E",
              "mtpckEndprdTypecd": "I",
              "impexpPortcd": "2249",
              "masterCuscd": "2249",
              "dclTime": "2022-10-22 19:02:36",
              "preRecAccountTime": null,
              "recAccountTime": null,
              "portIochkptStucd": "2",
              "recAccountFlag": null,
              "rcvgdEtpsNo": "1070S21113",
              "rcvgdEtpsNm": "上海怡亚通临港供应链有限公司",
              "rcvgdEtpsSccd": "22490202107021113G",
              "vehicleNo": "沪BCK232",
              "vehicleIcNo": null,
              "containerNo": null,
              "vehicleWt": "2048.00000",
              "vehicleFrameNo": null,
              "vehicleFrameWt": "1.00000",
              "containerType": null,
              "containerWt": "",
              "totalWt": "2051.04600",
              "passCollectWt": null,
              "wtError": null,
              "totalGrossWt": "2.04600",
              "totalNetWt": "0.82960",
              "passTime": "2022-10-22 19:03:19",
              "secdPassTime": null,
              "bindUsedTypecd": "1",
              "bindTypecd": "",
              "rmk": null,
              "optStatus": "51",
              "grtNo": "",
              "entrustSign": "0",
              "dclTypecd": "1",
              "dragType": "0",
              "inexpRltType": "0",
              "isRltInexp": null,
              "rltPortRecNo": "103240ZV221010394266",
              "isReturnArea": null,
              "isBandPlane": null,
              "businessTypecd": "",
              "backTime": "",
              "tradeMode": "5000",
              "cutMode": "101",
              "transMode": "1",
              "crossBorderType": "2",
              "enterNumber": "T220705949507",
              "amountOfTax": null,
              "specialBusiness": null,
              "isGrt": "",
              "chgTmsCnt": "0",
              "tradeGrade": null,
              "isCancelDcl": "0",
              "area": "D",
              "inOrgId": null,
              "exitQuantity": null,
              "vin": null,
              "returnBackStatus": "0",
              "goodsArrived": "",
              "portReleaseDt": [{
                "id": "6921641",
                "pid": "194266",
                "orgId": "103240",
                "portNo": "103240ZV221010394266",
                "rltNo": "103240ZV221010394266",
                "rltSeqno": "10",
                "gdsSeqno": "",
                "gdsMtno": "xhan221020006",
                "gdecd": "3506100090",
                "gdsNm": "导电密封剂",
                "gdsSpcfModelDesc": "CMS-SL-110 B类 2级 Ⅱ型",
                "dclCurrcd": "142",
                "dclQty": "497",
                "dclUnitcd": "096",
                "natcd": "502",
                "netWt": "0.8296",
                "stockDtId": null,
                "dclTotalAmt": "19313.42",
                "passportUsedQty": "0",
                "actlPassQty": "0",
                "remainQty": "497",
                "classifyType": "I",
                "qty1": "0.8296",
                "unit1": "035",
                "dutyMode": "7",
                "modfMarkcd": null,
                "dclUprcAmt": "38.86",
                "vinGdsSeqno": null,
                "portStore": [],
                "leadId": 0
              }],
              "portReleaseDetail": [],
              "portReleaseRlt": [{
                "rltTbTypecd": "9",
                "rltNo": "103240ZV221010394266"
              }],
              "portReleaseInexpRlt": []
            }
显示代码
出参
代码示例
提示：map里面的出参可以忽略 


          {
              "status": "1",
              "note": "暂存成功",
              "description": null,
              "map": {
                "rltList": [{
                  "id": 1365400,
                  "pid": 194687,
                  "orgId": 103240,
                  "portNo": "103240ZV221227394687",
                  "rltTbTypecd": "9",
                  "rltNo": "103240ZV221010394266"
                }],
                "data": 194687,
                "dtList": [{
                  "id": 6922359,
                  "pid": 194687,
                  "orgId": 103240,
                  "portNo": "103240ZV221227394687",
                  "rltNo": "103240ZV221010394266",
                  "rltSeqno": 10,
                  "gdsSeqno": 1,
                  "gdsMtno": "xhan221020006",
                  "gdecd": "3506100090",
                  "gdsNm": "导电密封剂",
                  "gdsSpcfModelDesc": "CMS-SL-110 B类 2级 Ⅱ型",
                  "dclCurrcd": "142",
                  "dclQty": 497.0,
                  "dclUnitcd": "096",
                  "natcd": "502",
                  "netWt": 0.8296,
                  "stockDtId": null,
                  "dclUprcAmt": 38.86,
                  "dclTotalAmt": 19313.42,
                  "passportUsedQty": 0,
                  "actlPassQty": 0,
                  "remainQty": 497.0,
                  "classifyType": "I",
                  "qty1": 0.8296,
                  "unit1": "035",
                  "dutyMode": "7",
                  "modfMarkcd": null,
                  "portStore": null
                }]
              }
            }
显示代码

# 10、业务申报接口信息列表

业务申报基本结构

结构标志 结构说明 备注
BusinessDeclareBsc 业务申报基本信息 1..n
BusinessDeclareDt 业务申报表体信息 0..n
BusinessDeclareSum 业务申报汇总表体信息 0..n

# 10.1、业务申报基本信息

序号 中文名稱 字段名称 数据类型 长度 注释 标记
1 id id String 暂存系统自动生成 修改必填
2 子账户id orgId String 暂存系统自动生成 修改必填
3 业务申报编号 businessDeclareNo String 64 暂存系统自动生成 修改必填
4 加工合同编号 contractNo String 64 M
5 业务类型 type String 1 1-外发加工2-飞机试飞3-保税展示 M
6 操作状态 optStatus String 系统自动生成 修改必填
7 经营企业名称 bizopEtpsNm String 768 M
8 经营企业编码 bizopEtpsNo String 768 M
9 申报时间 dclTime String 系统自动生成
10 申报类型 dclTypecd String 1 1-备案、2-变更、3-作废、4-结案 M
11 变更次数 chgTmsCnt String 10 系统自动生成
12 承揽企业名称 outsourceEtpsNm String 768 M
13 地址 address String 768 M
14 开始时间 createTime String 20 yyyy-MM-dd HH:mm:ss M
15 结束时间 endTime String 20 yyyy-MM-dd HH:mm:ss M
16 备注 rmk String 4000
17 场地备案编码 placeNo String 18 M
18 主管海关 masterCuscd String 10 M

# 10.2、业务申报表体信息

注：暂存不用填写表体信息，表体信息为系统自动生成

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 11 系统自动生成
2 子账户id orgId String 11 系统自动生成
3 表头id pid String 11 系统自动生成
4 凭证编号 businessDeclareNo String 64 系统自动生成
5 关联凭证类型 rltTypecd String 10 系统自动生成 1-出区，2-进区，3-耗用，4-产出，5-内销，6-增料，7-增料已报关
6 关联凭证编号 rltNo String 64 系统自动生成
7 业务类型 businessTypecd String 10 系统自动生成
8 进出区标志 ieTypecd String 2 系统自动生成
9 料件、成品标志 mtpckEndprdTypecd String 1 系统自动生成
10 商品料号 gdsMtno String 32 系统自动生成
11 商品编码 gdecd String 10 系统自动生成
12 商品名称 gdsNm String 768 系统自动生成
13 规格型号 gdsSpcfModelDesc String 768 系统自动生成
14 币制 dclCurrcd String 3 系统自动生成
15 申报数量 dclQty String 19, 5 系统自动生成
16 申报单位 dclUnitcd String 3 系统自动生成
17 法定第一计量单位 unit1 String 10 系统自动生成
18 法定第二计量单位 unit2 String 10 系统自动生成
19 单价 dclUprcAmt String 25, 5 系统自动生成
20 总价 dclTotalAmt String 25, 5 系统自动生成
21 统计人民币值 sumRmbVal String 25, 5 系统自动生成
22 统计美元值 sumUsaVal String 25, 5 系统自动生成
23 原产国(地区) natcd String 系统自动生成
24 净重 netWt String 19, 5 系统自动生成
25 进出数量 iqty String 19, 5 系统自动生成
26 内销数量 materialReturnQty String 19, 5 系统自动生成
27 预扣数量 passportUsedQty String 19, 5 系统自动生成
28 剩余数量 remainQty String 19, 5 系统自动生成

# 10.3、业务申报汇总表体信息

注：暂存不用填写汇总表体信息，汇总表体信息为系统自动生成

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 11 系统自动生成
2 子账户id orgId String 11 系统自动生成
3 表头id pid String 11 系统自动生成
4 凭证编号 businessDeclareNo String 64 系统自动生成
5 商品料号 gdsMtno String 32 系统自动生成
6 料件、成品标志 mtpckEndprdTypecd String 1 系统自动生成
7 单位 dclUnitcd String 3 系统自动生成
8 进区数量 iQty String 19, 5 系统自动生成
9 出区数量 eQty String 19, 5 系统自动生成
10 增料数量 materialAddQty String 19, 5 系统自动生成
11 内销数量 materialReturnQty String 19, 5 系统自动生成
12 产出数量 produceAddQty String 19, 5 系统自动生成
13 耗用数量 produceReturnQty String 19, 5 系统自动生成
14 剩余数量 remainQty String 19, 5 系统自动生成
15 进区预扣数量 passportUsedQty String 19, 5 系统自动生成
16 内销预扣数量 passportUsedReturnqty String 19, 5 系统自动生成
17 增料预扣数量 passportUsedAddqty String 19, 5 系统自动生成
18 耗用预扣数量 passportUsedConsumerQty String 19, 5 系统自动生成
19 增料已报关 addCustomsDeclaration String 19, 5 系统自动生成
20 内销已报关 returnCustomsDeclaration String 19, 5 系统自动生成

# 10.4、业务申报操作状态表

序号 字段名称 数据类型 长度 注释 标记
1 id id String 10 系统自动生成 M
2 pid pid String 10 系统自动生成 M
3 创建时间 createTime String 系统自动生成 M
4 操作状态 optStatus String 50 系统自动生成
5 操作人 optUserName String 50 系统自动生成 M
6 操作时间 optTime String yyyy-MM-dd hh:mm:ss 系统自动生成 M
7 备注 remark String 1000 系统自动生成
8 报文名 fileName String 500 系统自动生成

# 10.5、暂存/修改接口

接口名称 业务申报暂存与修改
接口功能 用于业务申报暂存与修改
接口协议 HTTP、Content-Type：application/json
请求地址 /sasDeclares/save
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String 修改必填 暂存系统自动生成
子账户id orgId String 修改必填 系统自动生成
业务申报编号 businessDeclareNo String 修改必填 暂存系统自动生成
加工合同编号 contractNo String M
业务类型 type String M 1-外发加工 2-飞机试飞 3-保税展示
操作状态 optStatus String M 修改必填
经营企业名称 bizopEtpsNm String M
经营企业编码 bizopEtpsNo String M
申报时间 dclTime String M 系统自动生成
申报类型 dclTypecd String M 1-备案、2-变更、3-作废、4-结案
变更次数 chgTmsCnt String M 系统自动生成
承揽企业名称 outsourceEtpsNm String
地址 address String
开始时间 createTime String yyyy-MM-dd HH:mm:ss
结束时间 endTime String yyyy-MM-dd HH:mm:ss
备注 rmk String M
场地备案编码 placeNo String M
主管海关 masterCuscd String M
代码示例
详情请参考业务申报基本信息

提示：新增id为空



            {
                "id": "",
                "orgId": "102848",
                "businessDeclareNo": "",
                "contractNo": "1111",
                "type": "2",
                "optStatus": "",
                "bizopEtpsNo": "3122260WGC",
                "bizopEtpsNm": "上海飞机制造有限公司",
                "passportUsedTypecd": "",
                "dclTypecd": "1",
                "outsourceEtpsNm": "上海飞机制造有限公司",
                "createTime": "2021-01-12",
                "endTime": "2021-02-06",
                "address": "上海浦东国际机场",
                "masterCuscd": "2249",
                "placeNo": "EP1028482101120665"
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status" : "1",
              "note" : "暂存成功",
              "description" : null,
              "map" : null
            }
显示代码

# 10.6、删除接口

接口名称 业务申报删除
接口功能 业务申报删除
接口协议 HTTP
请求地址 /sasDeclares/deleteBsc
请求方式 POST
入参 字段名 字段类型 是否必填 备注
id id int M
代码示例


            {
              id: 101
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


          {
            "status" : "1",
            "note" : "删除成功！",
            "description" : null,
            "map" : null
          }
显示代码

# 10.7、列表查询接口

接口名称 列表查询
接口功能 业务申报列表查询
接口协议 HTTP
请求地址 /sasDeclares/selectBsc
请求方式 POST
入参 字段名 字段类型 是否必填 备注
页数 page Number M
条数 size Number M
业务申报编号 businessDeclareNo String 支持模糊查询
申报类型 dclTypecd String 详情业务申报基本信息
状态 optStatus String 详情状态列表
业务类型 type String 详情业务申报基本信息
代码示例


          {
             "size": 10,
             "page": 1
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


          {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                  "data": {
                      "content": [
                          {
                              "id": 97,
                              "orgId": 2406,
                              "businessDeclareNo": "002406BD200810000096",
                              "contractNo": "1",
                              "type": "1",
                              "optStatus": "5",
                              "bizopEtpsNm": "钢铁烈阳",
                              "bizopEtpsNo": "4523662145",
                              "dclTypecd": "4",
                              "chgTmsCnt": "0",
                              "outsourceEtpsNm": "1",
                              "address": "1",
                              "rmk": "1",
                              "passportUsedTypecd": "1",
                              "dclTime": "2020-08-10 14:07:49",
                              "createTime": "2020-08-10 00:00:00",
                              "endTime": "2020-08-10 00:00:00",
                              "isChange": "0"
                          }
                      ],
                      "last": false,
                      "totalPages": 4,
                      "totalElements": 37,
                      "first": true,
                      "sort": null,
                      "numberOfElements": 10,
                      "size": 10,
                      "number": 0
                  }
              }
          }
显示代码

# 10.8、列表明细接口

接口名称 列表明细
接口功能 业务申报列表明细
接口协议 HTTP
请求地址 /sasDeclares/selectDetail
请求方式 POST
入参 字段名 字段类型 是否必填 备注
业务申报id id Number M
代码示例


          {
             "id":984
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                "businessDeclareBsc": {
                  "id": "984",
                  "orgId": "102848",
                  "businessDeclareNo": "102848BD210112000984",
                  "contractNo": "1111",
                  "type": "2",
                  "optStatus": "1",
                  "bizopEtpsNm": "上海飞机制造有限公司",
                  "bizopEtpsNo": "3122260WGC",
                  "dclTypecd": "1",
                  "chgTmsCnt": "0",
                  "outsourceEtpsNm": "上海飞机制造有限公司",
                  "address": "上海浦东国际机场",
                  "createTime": "2021-01-12 00:00:00",
                  "endTime": "2021-02-06 00:00:00",
                  "rmk": null,
                  "dclTime": null,
                  "masterCuscd": "2249",
                  "passportUsedTypecd": "1",
                  "businessDeclareDt": [],
                  "businessDeclareSum": [],
                  "businessDeclareStatus": [{
                    "id": "4034",
                    "pid": "984",
                    "createTime": "2021-01-12 19:45:09",
                    "optStatus": "1",
                    "optUserName": "shfjzz",
                    "optTime": "2021-01-12 19:42:31",
                    "remark": "暂存成功",
                    "fileName": null
                  }],
                  "isChange": "0",
                  "placeNo": "EP1028482101120665"
                  },
                  "businessDeclareStatuses": [{
                    "id": "4034",
                    "pid": "984",
                    "createTime": "2021-01-12 19:45:09",
                    "optStatus": "1",
                    "optUserName": "shfjzz",
                    "optTime": "2021-01-12 19:42:31",
                    "remark": "暂存成功",
                    "fileName": null
                  }]
              }
            }
显示代码

# 10.9、表体查询接口

接口名称 业务申报表表体查询接口
接口功能 业务申报表表体查询
接口协议 HTTP
请求地址 /sasDeclares/getDtList
请求方式 POST
入参 字段名 字段类型 是否必填 备注
页数 page Number M
每页条数 size Number M
业务申报编号 businessDeclareNo String M
关联凭证类型 rltTypecd String M 1-出区， 2-进区， 3-耗用， 4-产出， 5-内销，6-增料， 7-增料已报关
代码示例


          {
              "businessDeclareNo": "102306BD201021000645",
              "size": 10,
              "page": 1
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                "data": {
                  "first": false,
                  "sort": null,
                  "size": 10,
                  "content": [{
                    "id": "817",
                    "pid": "645",
                    "orgId": "102306",
                    "businessDeclareNo": "102306BD201021000645",
                    "rltTypecd": "rltTypecd1",
                    "rltPortNo": null,
                    "rltNo": "102306ZV201021018377",
                    "businessTypecd": null,
                    "ieTypecd": "E",
                    "mtpckEndprdTypecd": "I",
                    "gdsMtno": "han029",
                    "gdecd": "0804503000",
                    "gdsNm": "123",
                    "gdsSpcfModelDesc": null,
                    "dclCurrcd": "110",
                    "dclQty": "100",
                    "dclUnitcd": "007",
                    "unit1": null,
                    "unit2": null,
                    "dclUprcAmt": null,
                    "dclTotalAmt": "123",
                    "sumRmbVal": null,
                    "sumUsaVal": null,
                    "natcd": "101",
                    "netWt": null,
                    "seq": "1",
                    "rltSeq": null,
                    "materialReturnQty": null,
                    "passportUsedQty": null,
                    "remainQty": null,
                    "iqty": null
                  }],
                  "number": 0,
                  "numberOfElements": 2,
                  "totalElements": 2,
                  "last": false,
                  "totalPages": 1,
                  "pageable": {
                    "sort": null,
                    "pageSize": 10,
                    "pageNumber": 0,
                    "offset": 0,
                    "unpaged": false,
                    "paged": true
                  }
                }
              }
            }
显示代码

# 10.10、汇总表体查询接口

接口名称 业务申报表汇总表体查询接口
接口功能 汇总表体查询
接口协议 HTTP
请求地址 /sasDeclares/getListSum
请求方式 POST
入参 字段名 字段类型 是否必填 备注
页数 page Number M
每页条数 size Number M
业务申报编号 businessDeclareNo String M
代码示例


          {
            "page": 1,
            "size": 10,
            "businessDeclareNo": "102305BD201023000672"
          }
显示代码
出参
代码示例
详细ReturnInfo,实例如下： 


          {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                "data": {
                  "first": false,
                  "size": 10,
                  "content": [{
                    "id": "464",
                    "pid": "861",
                    "orgId": "102306",
                    "businessDeclareNo": "102306BD201206000861",
                    "gdsMtno": "L91551",
                    "mtpckEndprdTypecd": "I",
                    "dclUnitcd": "007",
                    "materialAddQty": "0",
                    "materialReturnQty": "0",
                    "produceAddQty": "0",
                    "produceReturnQty": "0",
                    "passportUsedQty": "0",
                    "remainQty": null,
                    "addCustomsDeclaration": "0",
                    "returnCustomsDeclaration": "0",
                    "eqty": "14607",
                    "iqty": "0"
                  }],
                  "number": 0,
                  "sort": null,
                  "totalElements": 372,
                  "numberOfElements": 10,
                  "last": false,
                  "totalPages": 38,
                  "pageable": {
                    "sort": null,
                    "pageSize": 10,
                    "pageNumber": 0,
                    "offset": 0,
                    "paged": true,
                    "unpaged": false
                  }
                }
              }
            }
显示代码

# 10.11、确认接口

接口名称 业务申报确认
接口功能 务申报确认
接口协议 HTTP
接口方向 企业调用新片区海关监管系统
请求地址 /sasDeclares/declare
请求方式 POST
入参 字段名 字段类型 是否必填 备注
业务申报id id int M
代码示例


          {
            id: 11
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": "申报成功！",
              "description": null,
              "map": null
          }
显示代码

# 10.12、作废接口

接口名称 业务申报作废
接口功能 业务申报作废
接口协议 HTTP
请求地址 /sasDeclares/cancel
请求方式 POST
入参 字段名 字段类型 是否必填 备注
业务申报id id Number M
代码示例


          {
            id: 112
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status" : "1",
            "note" : "作废成功！",
            "description" : null,
            "map" : null
          }
显示代码

# 10.13、结案接口

接口名称 业务申报结案
接口功能 业务申报结案
接口协议 HTTP
请求地址 /sasDeclares/endCase
请求方式 POST
入参 字段名 字段类型 是否必填 备注
id id Number M
代码示例


          {
            id: 112
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status" : "1",
            "note" : "发送成功！",
            "description" : null,
            "map" : null
          }
显示代码

# 10.14、延期接口

接口名称 业务申报延期
接口功能 业务申报延期
接口协议 HTTP
请求地址 /sasDeclares/delaySas
请求方式 POST
入参 字段名 字段类型 是否必填 备注
ID id Number M
延期时间 delayTime String M
代码示例


          {
            "id": 112,
            "delayTime":"2024-09-15 00:00:00"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status" : "1",
            "note" : "发送成功！",
            "description" : null,
            "map" : null
          }
显示代码

# 11、耗料单接口信息列表

耗料单基本结构

结构标志 结构说明 备注
MaterialUseBsc 耗料清单基本信息 1..n
ConsumDt 耗料清单耗用表体信息 0..n
ProduceDt 耗料清单产出表体信息 0..n

# 11.1、耗料清单基本信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 系统自动生成,新增不用传，修改要传
2 子账户id orgId String 系统自动生成
3 耗料清单编号 consumptionNo String 64 系统自动生成，组织编号6位+单证类型2位("MU")+年月日6位+6位流水号
4 申报类型 dclTypecd String 1 1-备案，3-作废 M
5 申报时间 dclData String 系统自动生成
6 操作状态 optStatus String 10 系统自动生成
7 变更次数 chgTmsCnt String 10 系统自动生成
8 业务类型 businessTypecd String 1 1-外发加工，2-委托加工，3-一般加工，4-境内维修，5-境外维修 M
9 开始时间 createTime String
10 结束时间 endTime String
14 经营企业编码 bizopEtpsNo String 768 M
15 经营企业名称 bizopEtpsNm String 768 M
16 绑定状态 passportUsedTypecd String 2 系统自动生成 1-未绑定，2-部分绑定，3-已绑定
17 经营单位社会信用代码 bizopEtpsSccd String 18 M
18 业务申报编号 businessDeclareNo String 64 业务类型为外发加工、飞机试飞的时候需要填写

# 11.2、耗料清单耗用表体信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 系统自动生成
2 子账户id orgId String 系统自动生成
3 PID pid String 系统自动生成
4 料件成品标志 classifyType String 10 I-料件,E-成品, S-设备,L-边角料,D-残次品,F-待维修件,G-已维修件,H-维修边角料,J-维修坏件，B-半成品 M
5 商品料号 gdsMtno String 32 M
6 商品编码 gdecd String 10 M
7 商品名称 gdsNm String 768 M
8 商品规格型号 gdsSpcfModelDesc String 768
9 申报数量 dclQty String 19，5 M
10 法定单位 unit1 String 10 M
11 法定第二计量单位 unit2 String 10
12 申报计量单位 bizopEtpsNo String 10 M
13 币制 dclCurrcd String 3 参照币制码表 M
14 原产国 natcd String 3 参照国家码表 M
15 明细序号 gdsSeqno String 10 系统自动生成
16 法定数量 qty1 String 19，5
17 第二法定数量 qty2 String 19，5
18 备注 remark String 2000
19 耗料清单编号 consumptionNo String 64 系统自动生成
20 是否增料 isAddMaterial String 1 业务类型为外发加工时需要填写 1-否，2-是

# 11.3、耗料清单产出表体信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 系统自动生成
2 子账户id orgId String 系统自动生成
3 PID pid String 系统自动生成
4 料件成品标志 classifyType String 10 I-料件,E-成品, S-设备,L-边角料,D-残次品,F-待维修件,G-已维修件,H-维修边角料,J-维修坏件，B-半成品 M
5 商品料号 gdsMtno String 32 M
6 商品编码 gdecd String 10 M
7 商品名称 gdsNm String 768 M
8 商品规格型号 gdsSpcfModelDesc String 768
9 申报数量 dclQty String M
13 法定单位 unit1 String 10
14 法定第二计量单位 unit2 String 10
15 申报计量单位 bizopEtpsNo String 768 M
16 币制 dclCurrcd String 3 参照币制码表 M
17 原产国 natcd String 3 参照国家码表 M
19 明细序号 gdsSeqno String 系统自动生成
20 法定数量 qty1 String 19，5
21 第二法定数量 qty2 String 19，5
22 备注 remark String 2000
24 耗料清单编号 consumptionNo String 64 系统自动生成

# 11.4、耗料单操作记录

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 系统自动生成
2 提发货的id pid String 10 系统自动生成
3 创建时间 createTime String date 系统自动生成
4 操作状态 optStatus String 50 系统自动生成
5 操作人名称 optUserName String 50 系统自动生成
6 操作时间 optTime String date 系统自动生成
7 备注 remark String 1000 系统自动生成

# 11.5、耗料单关联工单

注：耗料单关联工单整体为非必填项

序号 中文名称 字段名称 数据类型 长度 说明 是否必填
1 id id String 10 系统自动生成
2 pid pid String 10 系统自动生成
3 工单日期 orderDate String M
4 工单编号 orderNo String 50 M

# 11.6、暂存接口

接口名称 耗料单暂存与修改
接口功能 耗料单暂存与修改
接口协议 HTTP、Content-Type：application/json
请求地址 /expends/save
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String 修改必填 系统自动生成
子账户id orgId String 修改必填 系统自动生成
主管关区代码 masterCuscd String 修改必填 系统自动生成
耗料清单编号 consumptionNo String M 系统自动生成,组织编号6位+单证类型2位("MU")+年月日6位+6位流水号
申报类型 dclTypecd String M 1-备案，3-作废
申报时间 dclData String 系统自动生成
操作状态 optStatus String 修改必填 系统自动生成
变更次数 chgTmsCnt String 系统自动生成
业务类型 businessTypecd String M 1-外发加工，2-委托加工，3-一般加工，4-境内维修，5-境外维修
开始时间 createTime String yyyy-MM-dd hh:mm:ss
结束时间 endTime String yyyy-MM-dd hh:mm:ss
经营企业编码 bizopEtpsNo String M
经营企业名称 bizopEtpsNm String M
绑定状态 passportUsedTypecd String 系统自动生成,1-未绑定，2-部分绑定，3已绑定
经营单位社会信用代码 bizopEtpsSccd String M
业务申报编号 businessDeclareNo String 业务类型为外发加工、飞机试飞的时候需要填写
备注 rmk String
耗用表体信息 consumDt json对象
id id String 修改必填 系统自动生成
子账户id orgId String 修改必填 系统自动生成
PID pid String 修改必填 系统自动生成
料件成品标志 classifyType String 修改必填 I-料件,E-成品, S-设备,L-边角料,D-残次品,F-待维修件,G-已维修件,H-维修边角料,J-维修坏件，B-半成品
商品料号 gdsMtno String M
商品编码 gdecd String M
商品名称 gdsNm String M
商品规格型号 gdsSpcfModelDesc String M
申报数量 dclQty String M
法定单位 unit1 String M
法定第二计量单位 unit2 String M
申报计量单位 bizopEtpsNo String M
币制 dclCurrcd String M 参照币制表
原产国 natcd String M 参照国家码表
明细序号 gdsSeqno String 修改必填 系统自动生成
法定数量 qty1 String
第二法定数量 qty2 String
备注 remark String
耗料清单编号 consumptionNo String 修改必填 系统自动生成
是否增料 isAddMaterial String 业务类型为外发加工时需要填写,1-否，2-是
产出表体信息 produceDt json对象
id id String 修改必填 系统自动生成
子账户id orgId String 修改必填 系统自动生成
PID pid String 修改必填 系统自动生成
料件成品标志 classifyType String M I-料件,E-成品, S-设备,L-边角料,D-残次品,F-待维修件,G-已维修件,H-维修边角料,J-维修坏件，B-半成品
商品料号 gdsMtno String M
商品编码 gdecd String M
商品名称 gdsNm String M
商品规格型号 gdsSpcfModelDesc String
申报数量 dclQty String M
法定单位 unit1 String
法定第二计量单位 unit2 String
申报计量单位 bizopEtpsNo String M
币制 dclCurrcd String M 参照币制码表
原产国 natcd String M 参照国家码表
明细序号 gdsSeqno String 修改必填 系统自动生成
法定数量 qty1 String
第二法定数量 qty2 String
备注 remark String
耗料清单编号 consumptionNo String 修改必填 系统自动生成
关联工单信息 workOrder json对象
id id String M 系统自动生成
pid pid String M 系统自动生成
orderDate orderDate String yyyy-MM-dd hh:mm:ss
orderNo orderNo String M 系统自动生成
代码示例
详情请参考耗料清单基本信息、耗料清单耗用表体信息、耗料清单产出表体信息

提示：新增id为空,修改id非空



            {
                "id": "",
                "orgId": "",
                "consumptionNo": "",
                "optStatus": "",
                "chgTmsCnt": "",
                "businessTypecd": "1",
                "bizopEtpsNm": "上海优选",
                "bizopEtpsNo": "0000000009",
                "bizopEtpsSccd": "123450000000009123",
                "dclTypecd": "1",
                "businessDeclareNo": "100001BD210603001207",
                "rmk": null,
                "masterCuscd": "2249",
                "createTime": null,
                "endTime": null,
                "consumDt": [
                    {
                        "id": "",
                        "pid": "",
                        "orgId": "",
                        "gdsSeqno": "",
                        "classifyType": "I",
                        "gdsMtno": "3534534535345",
                        "gdecd": "0804503000",
                        "gdsNm": "123123",
                        "gdsSpcfModelDesc": "",
                        "dclQty": "11",
                        "unit1": "003",
                        "unit2": "003",
                        "bizopEtpsNo": "001",
                        "dclCurrcd": "110",
                        "natcd": "101",
                        "consumptionNo": "",
                        "qty1": "123",
                        "qty2": null,
                        "remark": null,
                        "isAddMaterial": "1"
                    }
                ],
                "produceDt": [
                    {
                        "id": "",
                        "pid": "",
                        "orgId": "",
                        "gdsSeqno": "",
                        "classifyType": "E",
                        "gdsMtno": "12313123123",
                        "gdecd": "0804503000",
                        "gdsNm": "12312",
                        "gdsSpcfModelDesc": "",
                        "dclQty": "12313123",
                        "unit1": "003",
                        "unit2": "003",
                        "bizopEtpsNo": "001",
                        "dclCurrcd": "110",
                        "natcd": "101",
                        "consumptionNo": "",
                        "qty1": "12312",
                        "qty2": null,
                        "remark": null
                    }
                ],
                "workOrder": [
                    {
                        "id": "",
                        "orderNo": "1",
                        "orderDate": "2021-09-06 10:25:06",
                        "remark": "111"
                    }
                ]
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status" : "1",
              "note" : "暂存成功",
              "description" : null,
              "map" : null
            }
显示代码

# 11.7、删除接口

接口名称 耗料单删除
接口功能 根据业务id删除耗料单
接口协议 HTTP、Content-Type：application/json
请求地址 /expends/deleteBsc
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 说明
耗料单id id number M
代码示例


            {
              "id": 1163
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "删除成功！",
              "description": null
            }
显示代码

# 11.7、确认接口

接口名称 耗料单确认
接口功能 根据业务id值向海关申报耗料单，等待回执
接口协议 HTTP、Content-Type：application/json
请求地址 /expends/declare
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 说明
耗料单id id number M
代码示例


            {
              "id": 1162
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "申报成功！",
              "description": null
            }
显示代码

# 11.8、作废接口

接口名称 耗料单申报作废
接口功能 根据业务id值向海关申请作废耗料单，等待回执
接口协议 HTTP、Content-Type：application/json
请求地址 /expends/cancel
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填
耗料单id id String M
代码示例


              {
                "id":"141"
              }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status" : "1",
              "note" : "作废成功！",
              "description" : null,
              "map" : null
            }
显示代码

# 11.9、列表查询接口

接口名称 耗料单列表查询
接口功能 企业通过该接口查询本组织下所有的耗料单信息
接口协议 HTTP、Content-Type：application/json
请求地址 /expends/selectBsc
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填
每页信息数 size Number M
页数 page Number M
耗料清单编号 consumptionNo String 支持模糊查询
业务类型 businessTypecd String 详情耗料单基本信息
操作状态 optStatus String 详情状态列表
申报类型 dclTypecd String 详情耗料单基本信息
开始确认时间 before_dclTime String 确认时间范围（前）
结束确认时间 after_dclTime String 确认时间范围（后）
代码示例


              {
                  "optStatus": 5,
                  "size": 10,
                  "page": 1
              }
显示代码
出参
代码示例
详细ReturnInfo，实例如下：

提示：出参不包含在耗料清单基本信息中的字段均可忽略。



            {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                  "data": {
                      "content": [
                          {
                              "id": 1167,
                              "orgId": 102306,
                              "consumptionNo": "102306MU201223001167",
                              "dclTypecd": "1",
                              "dclData": null,
                              "optStatus": "1",
                              "chgTmsCnt": "0",
                              "businessTypecd": "3",
                              "bizopEtpsNm": "上海嘉盛有限公司",
                              "bizopEtpsNo": "0000000011",
                              "passportUsedTypecd": "1",
                              "bizopEtpsSccd": "329281299407255493",
                              "businessDeclareNo": null,
                              "isChange": "0",
                              "rmk": null,
                              "masterCuscd": "2249",
                              "createTime": null,
                              "endTime": "2020-12-23 13:59:26"
                          }
                      ],
                      "pageable": {
                          "sort": {
                              "sorted": false,
                              "unsorted": true
                          },
                          "pageSize": 10,
                          "pageNumber": 0,
                          "offset": 0,
                          "paged": true,
                          "unpaged": false
                      },
                      "totalElements": 1,
                      "totalPages": 1,
                      "last": true,
                      "first": true,
                      "sort": {
                          "sorted": false,
                          "unsorted": true
                      },
                      "numberOfElements": 1,
                      "size": 10,
                      "number": 0
                  }
              }
          }
显示代码

# 11.10、列表明细接口

接口名称 业务申报表查询明细接口
接口功能 根据业务id查询耗料清单明细细息
接口协议 HTTP、Content-Type：application/json
请求地址 /expends/selectDetail
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
耗料单id id number M
代码示例


            {
                "id": 1058
            }
显示代码
出参
代码示例
详情请参考耗料清单基本信息、耗料清单耗用表体信息、耗料清单产出表体信息、耗料单关联工单信息

提示：出参不包含在耗料清单基本信息、耗料清单耗用表体信息、耗料清单产出表体信息、耗料单关联工单信息中的字段均可忽略。



            {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                "data": {
                  "id": "1058",
                  "orgId": "102306",
                  "consumptionNo": "102306MU201117001058",
                  "contractNo": null,
                  "optStatus": "5",
                  "chgTmsCnt": "0",
                  "businessTypecd": "3",
                  "bizopEtpsNm": "上海嘉盛有限公司",
                  "bizopEtpsNo": "0000000011",
                  "bizopEtpsSccd": "329281299407255493",
                  "passportUsedTypecd": "1",
                  "dclData": "2020-11-17 15:56:06",
                  "dclTypecd": "1",
                  "isChange": "1",
                  "businessDeclareNo": null,
                  "rmk": null,
                  "masterCuscd": "2249",
                  "createTime": null,
                  "endTime": null,
                  "consumDt": [{
                    "id": "2220",
                    "pid": "1058",
                    "orgId": "102306",
                    "gdsSeqno": "1",
                    "classifyType": "I",
                    "gdsMtno": "han001",
                    "gdecd": "0804503000",
                    "gdsNm": "123",
                    "gdsSpcfModelDesc": null,
                    "dclQty": "10",
                    "passportUserdQty": "0",
                    "remainQty": "10",
                    "actlPassQty": "0",
                    "lawfQty": null,
                    "secdLawfQty": null,
                    "unit1": "003",
                    "unit2": "003",
                    "bizopEtpsNo": "007",
                    "modfMarkcd": "0",
                    "goodsType": null,
                    "dclCurrcd": "110",
                    "natcd": "101",
                    "consumptionNo": "102306MU201117001058",
                    "qty1": null,
                    "qty2": null,
                    "remark": null,
                    "isAddMaterial": "1"
                  }],
                  "produceDt": [{
                    "id": "2049",
                    "pid": "1058",
                    "orgId": "102306",
                    "gdsSeqno": "1",
                    "classifyType": "E",
                    "gdsMtno": "s",
                    "gdecd": "0804503000",
                    "gdsNm": "123",
                    "gdsSpcfModelDesc": null,
                    "dclQty": "10",
                    "passportUserdQty": "0",
                    "remainQty": "10",
                    "actlPassQty": "0",
                    "lawfQty": null,
                    "secdLawfQty": null,
                    "unit1": "003",
                    "unit2": "003",
                    "bizopEtpsNo": "007",
                    "modfMarkcd": "0",
                    "goodsType": null,
                    "dclCurrcd": "110",
                    "natcd": "101",
                    "consumptionNo": "102306MU201117001058",
                    "qty1": null,
                    "qty2": null,
                    "remark": null
                  }],
                  "materialUseStatus": [{
                      "id": "4853",
                      "pid": "1058",
                      "createTime": "2020-11-17 15:56:29",
                      "optStatus": "5",
                      "optUserName": "海关回执",
                      "optTime": "2020-11-17 15:56:29",
                      "remark": "审核通过",
                      "fileName": "com.easipass.lgsa.CSB201.queue"
                    },
                    {
                      "id": "4852",
                      "pid": "1058",
                      "createTime": "2020-11-17 15:56:14",
                      "optStatus": "17",
                      "optUserName": "海关回执",
                      "optTime": "2020-11-17 15:56:14",
                      "remark": "待审核",
                      "fileName": "com.easipass.lgsa.CSB201.queue"
                    },
                    {
                      "id": "4851",
                      "pid": "1058",
                      "createTime": "2020-11-17 15:56:14",
                      "optStatus": "3",
                      "optUserName": "海关回执",
                      "optTime": "2020-11-17 15:56:14",
                      "remark": "入库成功",
                      "fileName": "com.easipass.lgsa.CSB201.queue"
                    },
                    {
                      "id": "4850",
                      "pid": "1058",
                      "createTime": "2020-11-17 15:56:06",
                      "optStatus": "18",
                      "optUserName": "zcfan",
                      "optTime": "2020-11-17 15:56:06",
                      "remark": "确认成功",
                      "fileName": null
                    },
                    {
                      "id": "4849",
                      "pid": "1058",
                      "createTime": "2020-11-17 15:56:06",
                      "optStatus": "1",
                      "optUserName": "zcfan",
                      "optTime": "2020-11-17 15:56:06",
                      "remark": "暂存成功",
                      "fileName": null
                    },
                    {
                      "id": "4848",
                      "pid": "1058",
                      "createTime": "2020-11-17 15:56:05",
                      "optStatus": "1",
                      "optUserName": "zcfan",
                      "optTime": "2020-11-17 15:56:05",
                      "remark": "暂存成功",
                      "fileName": null
                    }
                  ],
                  "workOrder": []
                }
              }
            }
显示代码

# 12、总担保接口信息列表

总担保基本结构

结构标志 结构说明 备注
GrtBsc 总担保基本信息 1..n
LevyInv 保证金信息 0..n
GrtInv 总担保关联单证信息 0..n
GrtLevy 总担保关联保证金信息

# 12.1、保证金清单基本信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 Id id String 11 系统自动生成
2 子账户id orgId String 11 系统自动生成
3 清单编号 dpstLevyBlNo String 50 系统自动生成
4 申报时间 dclData String 系统自动生成
5 保函（保证金）编号 ltguaNo String 100 M
6 保函类型 ltguaType String 2 1-保证金；2-保函 M
7 有效时间开始 validDateStart String M
8 有效时间结束 validDateEnd String M
9 申报类型 dclTypecd String 2 0-备案；1-变更 M
10 金额 grtAmt String 25,5 M
11 保函状态 ltguaStatus String 2 0-无效；1-有效
12 绑定状态 passportUsedTypecd String 2 0-未绑定；1-已绑定
13 被担保企业编码 assuredEtpsno String 10
14 被担保企业名称 assuredEtpsNm String 500
15 被担保企业信用代码 assuredEtpsSccd String 18
16 收款单位名称 mkclUnitNm String 500
17 收款单位开户银行 mkclUnitOpaccBankNm String 500
18 缴款企业名称 pmnEtpsNm String 500
19 缴款企业信用代码 pmnEtpsSccd String 18
20 缴款企业开户银行 pmnEtpsOpaccBankNm String 500
21 缴款企业银行开户账号 pmnEtpsBankAcctnum String 500
22 状态 status String 2 系统自动生成
23 备注 rmk String 1000
24 主管关区 masterCuscd String 4
25 企业编码 tradeCode String 10

# 12.2、总担保基本信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 Id id String 11 系统自动生成
2 子账户id orgId String 11 系统自动生成
3 总担保编号 gsarNo String 50 系统自动生成 M
4 金额 grtAmt String 25,5 M
5 可用金额 usableAmt String 25,5 M
6 锁定金额 lockAmt String 25,5 M
7 申报类型 dclTypecd String 2 0-备案；1-变更 M
8 申报时间 dclData String
9 状态 status String 2 M
10 备注 rmk String 1000
11 主管关区 masterCuscd String 4 M
12 企业编码 tradeCode String 10 M
13 失效金额 invalidAmt String 25,5

# 12.3、总担保关联单证信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 11 系统自动生成 M
2 总担保编号 gsarNo String 50 M
3 单证编号 businessNo String 50 M
4 单证类型 businessType String 50 port-卡口验放，wareHouse-进出区提发货，bill-进境径予，billExp-出境径予 M
5 金额 businessAmt String 25,5 M
6 类型 payType String 2 0-使用；1-收回 M
7 创建时间 createTime String M

# 12.4、总担保关联保证金信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String 11 系统自动生成
2 pid pid String 11 系统自动生成
3 保证金清单编号 dpstLevyBlNo String 50 M
4 保函状态 ltguaStatus String 2 0-无效；1-有效 M
5 创建时间 createTime String 系统自动生成 M
6 有效结束时间 validDateEnd String
7 金额 grtAmt String 25,5

# 12.5、总担保及担保金操作状态表

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id String M
2 pid pid String M
3 创建时间 createTime String M
4 操作状态 optStatus String 10 M
5 操作人id optUserName String 20 M
6 操作时间 optTime String 20 M
7 备注 rmk String 4000
8 报文名 fileName String 255

# 12.6、保证金暂存接口

接口名称 保证金暂存与修改
接口功能 保证金暂存与修改
接口协议 HTTP
请求地址 /grtlgsa/saveLevyInv
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String 修改必填 系统自动生成
保函（保证金）编号 ltguaNo String M
保函类型 ltguaType String M 1-保证金；2-保函
有效时间开始 validDateStart String M
有效时间结束 validDateEnd String M
申报类型 dclTypecd String M 0-备案；1-变更
金额 grtAmt String M
被担保企业编码 assuredEtpsno String
被担保企业名称 assuredEtpsNm String
被担保企业信用代码 assuredEtpsSccd String
收款单位名称 mkclUnitNm String yyyy-MM-dd hh:mm:ss
收款单位开户银行 mkclUnitOpaccBankNm String
缴款企业名称 pmnEtpsNm String
缴款企业信用代码 pmnEtpsSccd String
缴款企业开户银行 pmnEtpsOpaccBankNm String
缴款企业银行开户账号 pmnEtpsBankAcctnum String
代码示例


            {
              "id": "",
              "orgId": "102848",
              "orgCode": "102028",
              "dclTypecd": "0",
              "masterCuscd": "2249",
              "assuredEtpsno": "2578412684",
              "assuredEtpsNm": "上海优选",
              "assuredEtpsSccd": "913100006929421001",
              "mkclUnitNm": "",
              "mkclUnitOpaccBankNm": "",
              "pmnEtpsNm": "",
              "pmnEtpsSccd": "",
              "pmnEtpsno": "",
              "pmnEtpsOpaccBankNm": "",
              "pmnEtpsBankAcctnum": "",
              "grtAmt": "500000",
              "ltguaNo": "8888",
              "dclTime": "",
              "rmk": "",
              "validDateEnd": "2021-12-23 13:28:37",
              "validDateStart": "2020-12-23 13:28:37",
              "ltguaType": "1",
              "tradeCode": "0000000009",
              "totalWt": "0.00000"
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下 


            {
              "status" : "1",
              "note" : "暂存成功",
              "description" : null,
              "map" : {
                "data" : 662
              }
            }
显示代码

# 12.7、总担保暂存接口

接口名称 总担保暂存修改
接口功能 总担保暂存修改
接口协议 HTTP
请求地址 /grtlgsa/grtSaving
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String 修改必填
子账户id orgId String 系统自动生成
申报类型 dclTypecd String M
企业编码 tradeCode String M
备注 rmk String
保函（保证金）信息 grtLevy List
保证金清单编号 dpstLevyBlNo String M
保函（保证金）编号 ltguaNo String
保函类型 ltguaType String
有效时间开始 validDateStart String
有效时间结束 validDateEnd String
申报类型 dclTypecd String M 0-备案；1-变更
金额 grtAmt String M
被担保企业编码 assuredEtpsno String
被担保企业名称 assuredEtpsNm String
被担保企业信用代码 assuredEtpsSccd String
收款单位名称 mkclUnitNm String
收款单位开户银行 mkclUnitOpaccBankNm String
缴款企业名称 pmnEtpsNm String
缴款企业信用代码 pmnEtpsSccd String
缴款企业开户银行 pmnEtpsOpaccBankNm String
缴款企业银行开户账号 pmnEtpsBankAcctnum String
代码示例


            {
              "id": "",
              "orgId": "",
              "dclTypecd": "0",
              "tradeCode": "0000000009",
              "grtLevy": [{
                "id": 662,
                "orgId": 102028,
                "dpstLevyBlNo": "102028GR201223000662",
                "dclData": "2020-12-23 13:48:47",
                "ltguaNo": "8888",
                "ltguaType": "1",
                "validDateStart": "2020-12-23 13:28:37",
                "validDateEnd": "2021-12-23 13:28:37",
                "dclTypecd": "0",
                "grtAmt": 500000,
                "ltguaStatus": "1",
                "passportUsedTypecd": "0",
                "assuredEtpsno": "2578412684",
                "assuredEtpsNm": "上海优选",
                "assuredEtpsSccd": "913100006929421001",
                "mkclUnitNm": null,
                "mkclUnitOpaccBankNm": null,
                "pmnEtpsNm": null,
                "pmnEtpsSccd": null,
                "pmnEtpsOpaccBankNm": null,
                "pmnEtpsBankAcctnum": null,
                "status": "5",
                "optStatus": "5",
                "masterCuscd": "2249",
                "rmk": null
              }]
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "总担保暂存成功",
              "description": null,
              "map": {
                "id": 621,
                "gsarNo": "102028RT201223000621"
              }
            }
显示代码

# 12.8、保证金确认接口

接口名称 担保金确认
接口功能 担保金确认
接口协议 HTTP
请求地址 /grtlgsa/declare
请求方式 POST
入参 字段名 字段类型 是否必填 备注
担保金id集合 ids int[] M
代码示例


            {
              "ids": [662]
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "确认成功",
              "description": null,
              "map": null
            }
显示代码

# 12.9、总担保确认接口

接口名称 总担保确认接口
接口功能 总担保确认
接口协议 HTTP
接口方向 企业调用新片区海关监管系统
请求地址 /grtlgsa/grtDeclare
请求方式 POST
入参 字段名 字段类型 是否必填 备注
Ids ids int[] M
代码示例


            {
              "ids": [662]
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "确认成功",
              "description": null,
              "map": null
            }
显示代码

# 12.10、保证金删除接口

接口名称 保证金删除
接口功能 保证金删除
接口协议 HTTP
接口方向 企业调用新片区海关监管系统
请求地址 /grtlgsa/delLevyInv
请求方式 POST
入参 字段名 字段类型 是否必填 备注
保证金id集合 ids int[] M
代码示例


            {
              "ids": [662]
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "删除成功",
              "description": null,
              "map": null
            }
显示代码

# 12.11、总担保删除接口

接口名称 总担保删除
接口功能 总担保删除
接口协议 HTTP
请求地址 /grtlgsa/grtDelete
请求方式 POST
入参 字段名 字段类型 是否必填 备注
ids ids int[] M
代码示例


          {
            "ids": [12]
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "删除成功",
              "description": null,
              "map": null
            }
显示代码

# 12.12、保证金列表查询接口

接口名称 保证金列表查询
接口功能 保证金列表查询
接口协议 HTTP
请求地址 /grtlgsa/getList
请求方式 POST
入参 字段名 字段类型 是否必填 备注
企业编码 tradeCode String M
条数 size Int M
页数 page Int M
清单编号 dpstLevyBlNo String 支持模糊查询
保证金编码 ltguaNo String 支持模糊查询
保函类型 ltguaType String 详情担保金清单基本信息
状态 status String 详情状态列表
代码示例


          {
            "tradeCode": "0000000009",
            "size": 10,
            "page": 1
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
              "data": {
                "content": [{
                  "id": 662,
                  "orgId": 102028,
                  "dpstLevyBlNo": "102028GR201223000662",
                  "dclData": "2020-12-23 13:48:47",
                  "ltguaNo": "8888",
                  "ltguaType": "1",
                  "validDateStart": "2020-12-23 13:28:37",
                  "validDateEnd": "2021-12-23 13:28:37",
                  "dclTypecd": "0",
                  "grtAmt": 500000,
                  "ltguaStatus": "1",
                  "passportUsedTypecd": "0",
                  "assuredEtpsno": "2578412684",
                  "assuredEtpsNm": "上海优选",
                  "assuredEtpsSccd": "913100006929421001",
                  "mkclUnitNm": null,
                  "mkclUnitOpaccBankNm": null,
                  "pmnEtpsNm": null,
                  "pmnEtpsSccd": null,
                  "pmnEtpsOpaccBankNm": null,
                  "pmnEtpsBankAcctnum": null,
                  "status": "5",
                  "optStatus": "5",
                  "masterCuscd": "2249",
                  "rmk": null
                }],
                "pageable": {
                  "sort": {
                    "sorted": false,
                    "unsorted": true
                  },
                  "pageSize": 10,
                  "pageNumber": 0,
                  "offset": 0,
                  "paged": true,
                  "unpaged": false
                },
                "totalPages": 1,
                "totalElements": 1,
                "last": true,
                "first": true,
                "size": 1,
                "number": 0,
                "sort": {
                  "sorted": false,
                  "unsorted": true
                },
                "numberOfElements": 1
              }
            }
          }
显示代码

# 12.13、总担保列表查询接口

接口名称 总担保列表查询
接口功能 总担保列表查询
接口协议 HTTP
请求地址 /grtlgsa/grtGetList
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
企业编码 tradeCode String M
状态 status String 详情状态列表
条数 size Number M
页数 page Number M
代码示例


          {
            "tradeCode": "0000000009",
            "size": 10,
            "page": 1
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
              "data": {
                "content": [{
                  "id": 622,
                  "orgId": 102028,
                  "gsarNo": "102028RT201223000622",
                  "grtAmt": 500000,
                  "usableAmt": 500000,
                  "lockAmt": 0,
                  "dclTypecd": "0",
                  "dclData": "2020-12-23 14:12:56",
                  "masterCuscd": "2249",
                  "status": "17",
                  "optStatus": "17",
                  "tradeCode": "0000000009",
                  "rmk": null,
                  "invalidAmt": 0
                }],
                "pageable": {
                  "sort": {
                    "sorted": false,
                    "unsorted": true
                  },
                  "pageSize": 10,
                  "pageNumber": 0,
                  "offset": 0,
                  "paged": true,
                  "unpaged": false
                },
                "totalPages": 1,
                "totalElements": 7,
                "last": true,
                "first": true,
                "size": 10,
                "number": 0,
                "sort": {
                  "sorted": false,
                  "unsorted": true
                },
                "numberOfElements": 7
              }
            }
          }
显示代码

# 12.14、保证金明细查询接口

接口名称 保证金明细查询
接口功能 保证金明细查询
接口协议 HTTP
请求地址 /grtlgsa/getLevyInvDetails
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
保证金id id number M
代码示例


          {
            "id": 662
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
              "data": {
                "id": "662",
                "orgId": "102028",
                "dpstLevyBlNo": "102028GR201223000662",
                "dclData": "2020-12-23 13:48:47",
                "ltguaNo": "8888",
                "ltguaType": "1",
                "validDateStart": "2020-12-23 13:28:37",
                "validDateEnd": "2021-12-23 13:28:37",
                "dclTypecd": "0",
                "grtAmt": "500000",
                "ltguaStatus": "1",
                "passportUsedTypecd": "0",
                "assuredEtpsno": "2578412684",
                "assuredEtpsNm": "上海优选",
                "assuredEtpsSccd": "913100006929421001",
                "mkclUnitNm": null,
                "mkclUnitOpaccBankNm": null,
                "pmnEtpsNm": null,
                "pmnEtpsSccd": null,
                "pmnEtpsOpaccBankNm": null,
                "pmnEtpsBankAcctnum": null,
                "status": "5",
                "rmk": null,
                "masterCuscd": "2249",
                "tradeCode": "0000000009",
                "levyInvStatus": [{
                  "id": "1727",
                  "pid": "662",
                  "createTime": "2020-12-23 13:49:01",
                  "optTime": "2020-12-23 13:49:01",
                  "optUserName": "海关回执",
                  "optStatus": "5",
                  "rmk": "审核通过",
                  "remark": "审核通过",
                  "fileName": "com.easipass.lgsa.GRT231.queue"
                }, {
                  "id": "1726",
                  "pid": "662",
                  "createTime": "2020-12-23 13:48:57",
                  "optTime": "2020-12-23 13:48:57",
                  "optUserName": "海关回执",
                  "optStatus": "3",
                  "rmk": "入库成功",
                  "remark": "入库成功",
                  "fileName": "com.easipass.lgsa.GRT231.queue"
                }, {
                  "id": "1725",
                  "pid": "662",
                  "createTime": "2020-12-23 13:48:47",
                  "optTime": "2020-12-23 13:48:47",
                  "optUserName": "zzwang001",
                  "optStatus": "18",
                  "rmk": "确认成功",
                  "remark": "确认成功",
                  "fileName": null
                }, {
                  "id": "1724",
                  "pid": "662",
                  "createTime": "2020-12-23 13:29:02",
                  "optTime": "2020-12-23 13:29:02",
                  "optUserName": "zzwang001",
                  "optStatus": "1",
                  "rmk": "保证金暂存",
                  "remark": "保证金暂存",
                  "fileName": null
                }]
              }
            }
          }
显示代码

# 12.15、总担保明细查询接口

接口名称 总担保明细查询
接口功能 总担保明细查询
接口协议 HTTP
请求地址 /grtlgsa/selectGrtBsc
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
总担保id id number M
代码示例


          {
            "id": 550
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": null,
            "description": null,
            "map": {
                "data": {
                    "id": "550",
                    "orgId": "102306",
                    "gsarNo": "102306RT201103000550",
                    "grtAmt": "124",
                    "usableAmt": "0",
                    "lockAmt": "0",
                    "dclTypecd": "0",
                    "dclData": "2020-11-03 13:27:44",
                    "status": "5",
                    "rmk": null,
                    "invalidAmt": "124",
                    "grtLevy": [
                        {
                            "id": "878",
                            "pid": "550",
                            "ltguaStatus": "0",
                            "dpstLevyBlNo": "102306GR201103000590",
                            "validDateEnd": "2020-11-13",
                            "grtAmt": "124",
                            "createTime": "2020-11-03 13:27:43"
                        }
                    ],
                    "grtInv": [],
                    "grtStatus": [
                        {
                            "id": "1304",
                            "pid": "550",
                            "createTime": "2020-11-03 13:27:54",
                            "optTime": "2020-11-03 13:27:54",
                            "optUserName": "海关回执",
                            "optStatus": "3",
                            "rmk": "入库成功",
                            "remark": "入库成功",
                            "fileName": "com.easipass.lgsa.GRT232.queue"
                        },
                        {
                            "id": "1305",
                            "pid": "550",
                            "createTime": "2020-11-03 13:27:54",
                            "optTime": "2020-11-03 13:27:54",
                            "optUserName": "海关回执",
                            "optStatus": "5",
                            "rmk": "审核通过",
                            "remark": "审核通过",
                            "fileName": "com.easipass.lgsa.GRT232.queue"
                        },
                        {
                            "id": "1303",
                            "pid": "550",
                            "createTime": "2020-11-03 13:27:44",
                            "optTime": "2020-11-03 13:27:44",
                            "optUserName": "zcfan",
                            "optStatus": "18",
                            "rmk": "确认成功",
                            "remark": "确认成功",
                            "fileName": null
                        },
                        {
                            "id": "1302",
                            "pid": "550",
                            "createTime": "2020-11-03 13:27:43",
                            "optTime": "2020-11-03 13:27:43",
                            "optUserName": "zcfan",
                            "optStatus": "1",
                            "rmk": "总担保修改",
                            "remark": "总担保修改",
                            "fileName": null
                        },
                        {
                            "id": "1301",
                            "pid": "550",
                            "createTime": "2020-11-03 13:27:40",
                            "optTime": "2020-11-03 13:27:40",
                            "optUserName": "zcfan",
                            "optStatus": "1",
                            "rmk": "总担保暂存",
                            "remark": "总担保暂存",
                            "fileName": null
                        }
                    ],
                    "masterCuscd": "2249",
                    "tradeCode": "0000000011"
                }
            }
        }
显示代码

# 13、场地备案接口信息列表

# 13.1、场所基本信息

序号 中文名称 字段名称 数据类型 长度 注释 标记
1 id id Int 10 系统自动生成 新增不用填写，修改需要填写
2 子账户id orgId Int 10 系统自动生成
3 企业编码 tradeCode String 20 系统自动生成
4 备案编号 placeNo String 18 系统自动生成
5 场所地址 address Int 256 M
6 场所面积 area String 10 单位：平方米
7 场所类型 placeType String 4 1-保税展示；2-外发加工场所；3-飞机试飞场所
8 场所所属企业编码 placeEtpsNo String 10
9 场所所属企业名称 placeEtpsNm String 256 M
10 场所所属企业社会信用代码 placeEtpsSccd String 18 M
11 申报企业编码 dclEtpsNo String 10 M
12 申报企业名称 dclEtpsNm String 256 M
13 申报企业社会信用代码 dclEtpsSccd String 18 M
14 联系人 contactor String 20 M
15 联系电话 telephone String 20 M
16 有效期 validTime String yyyy-MM-dd HH:mm:ss M
17 状态 optStatus String 10 系统自动生成
18 备注 rmk String 4000

# 13.2、场所操作记录

序号 中文名称 字段名称 数据类型 长度 标记 备注
1 id id String 10 系统自动生成
2 pid pid String 10 系统自动生成
3 创建时间 createTime String 系统自动生成 yyyy-MM-dd HH:mm:ss
4 操作人 optUserId String 255 系统自动生成
5 备注 rmk String 255 系统自动生成

# 13.3、场所备案暂存

接口名称 场所备案暂存
接口功能 场所备案暂存
接口协议 HTTP、Content-Type：application/json
请求地址 /tradeQualify/exhibitionPlace/save
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
address 场所地址 String M
area 场所面积（平方米） String M
contactor 联系人 String M
dclEtpsNm 申报企业名称 String M
dclEtpsNo 申报企业编码 String M
dclEtpsSccd 申报企业信用代码 String M
placeEtpsNm 场所所属企业名称 String M
placeEtpsNo 场所所属企业编码 String M
placeEtpsSccd 社会信用带代码 String M
placeType 场所类型 String M 1-保税展示；2-外发加工场所；3-飞机试飞场所
rmk 备注 String
telephone 联系人电话 String M
validTime 有效期 String M yyyy-MM-dd HH:mm:ss
id 主键id Int 有主键id修改，没有暂存
代码示例
详情场所基本信息注意：新增id为空 


          { 
            "address": "string",
             "area": 0,
             "contactor": "string",
             "dclEtpsNm": "string",
              "dclEtpsNo": "string",
             "dclEtpsSccd": "string",
             "id": 0,
             "optStatus": "string",
             "orgId": 0,
             "placeEtpsNm": "string",
             "placeEtpsNo": "string",
             "placeEtpsSccd": "string",
             "placeNo": "string",
             "placeType": "string",
             "rmk": "string",
             "telephone": "string",
             "validTime": " yyyy-MM-dd HH:mm:ss"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
              "status": "1",
              "note": "暂存成功",
              "description": null,
              "map": {
                "data": {
                  "id": 244,
                  "orgId": 7705,
                  "tradeCode": "3116660056",
                  "placeNo": "EP0077052010220244",
                  "address": "11",
                  "area": 11,
                  "placeType": "2",
                  "placeEtpsNo": "1",
                  "placeEtpsNm": "11",
                  "placeEtpsSccd": "1",
                  "dclEtpsNo": "1",
                  "dclEtpsNm": "1",
                  "dclEtpsSccd": "1",
                  "contactor": "1",
                  "telephone": "1",
                  "validTime": "2020-12-25 12:30:00",
                  "optStatus": "1",
                  "rmk": "1"
                }
              }
            }
显示代码

# 13.4、场所备案删除

接口名称 场所备案删除
接口功能 根据id删除暂存,入库失败和审核拒绝下的备案，可批量删除，参数id以逗号分隔
接口协议 HTTP、Content-Type：application/json
接口方向 企业调用新片区海关监管系统
请求地址 /tradeQualify/exhibitionPlace/del
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填
id id String M
代码示例


          {
            "id": "12,34"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": "删除成功！",
            "description": null
          }
显示代码

# 13.5、场所备案分页查询列表

接口名称 分页查询列表
接口功能 企业查询本组织下的所有场地，海关查询所有场地信息
接口协议 HTTP、Content-Type：application/json
请求地址 /tradeQualify/exhibitionPlace/findPage
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填
address 地址 String
optStatus 单证状态 String
placeEtpsNm 场所所属企业名称 String
size 每页展示的条数 Int M
page 当前页 Int M
placeNo 备案编码 String
placeType 场地类型 String
validTime 有效期 String 开始时间，结束时间yyyy-MM-dd HH:mm:ss,yyyy-MM-dd HH:mm:ss
代码示例


          {
            "address": "",
            "optStatus": "1",
            "page": 1,
            "placeEtpsNm": "",
            "placeNo": "",
            "placeType": "",
            "size": 10,
            "validTime": "2020-01-5 01:30:00,2021-01-5 01:30:00"
          }
显示代码
出参
代码示例
详细场所基本信息，实例如下： 


          {
            "status": "1",
            "note": "查询成功",
            "description": null,
            "map": {
                "data": {
                    "first": false,
                    "sort": null,
                    "numberOfElements": 2,
                    "totalElements": 2,
                    "totalPages": 1,
                    "last": false,
                    "size": 10,
                    "content": [
                        {
                            "id": "8",
                            "orgId": "100042",
                            "placeNo": "EP200824000008",
                            "address": "lvzhou",
                            "area": "0",
                            "placeType": "1",
                            "placeEtpsNo": "string",
                            "placeEtpsNm": "string",
                            "placeEtpsSccd": "string",
                            "dclEtpsNo": "string",
                            "dclEtpsNm": "string",
                            "dclEtpsSccd": "string",
                            "contactor": "string",
                            "telephone": "string",
                            "validTime": "2020-08-28 12:16:50",
                            "optStatus": "1",
                            "rmk": "string"
                        },
                        {
                            "id": "4",
                            "orgId": "7516",
                            "placeNo": "EP200824000004",
                            "address": "string",
                            "area": "0",
                            "placeType": "1",
                            "placeEtpsNo": "lczh",
                            "placeEtpsNm": "lvzhou",
                            "placeEtpsSccd": "string",
                            "dclEtpsNo": "string",
                            "dclEtpsNm": "string",
                            "dclEtpsSccd": "string",
                            "contactor": "string",
                            "telephone": "string",
                            "validTime": "2020-08-28 12:16:50",
                            "optStatus": "1",
                            "rmk": "string"
                        }
                    ],
                    "number": 0,
                    "pageable": {
                        "sort": null,
                        "pageSize": 10,
                        "pageNumber": 0,
                        "offset": 0,
                        "paged": true,
                        "unpaged": false
                    }
                }
            }
        }
显示代码

# 13.6、场所备案申报

接口名称 场所备案申报
接口功能 场所备案申报
接口协议 HTTP、Content-Type：application/json
请求地址 /tradeQualify/exhibitionPlace/declare
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填
id id String M
代码示例


          {
            "id": "6,7"
          }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


          {
            "status": "1",
            "note": "申报成功",
            "description": null,
            "map": null
          }
显示代码

# 13.7、根据备案id查看保税场所详情

接口名称 根据备案编码查看场地详情
接口功能 根据备案编码查看场地详情
接口协议 HTTP、Content-Type：application/json
请求地址 /tradeQualify/exhibitionPlace/findDetails
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填 备注
id 场所备案id String M
代码示例


          {
            "placeNo": "EP0076962009090132",
            "tradeCode": "4523662145"
          }
显示代码
出参
代码示例
详情请参考场所基本信息、场所操作记录 


          {
              "status": "1",
              "note": "查询成功",
              "description": null,
              "map": {
                  "data": {
                      "id": "4",
                      "orgId": "7516",
                      "placeNo": "EP200824000004",
                      "address": "string",
                      "area": "0",
                      "placeType": "1",
                      "placeEtpsNo": "lczh",
                      "placeEtpsNm": "lvzhou",
                      "placeEtpsSccd": "string",
                      "dclEtpsNo": "string",
                      "dclEtpsNm": "string",
                      "dclEtpsSccd": "string",
                      "contactor": "string",
                      "telephone": "string",
                      "validTime": "2020-08-28 12:16:50",
                      "optStatus": "1",
                      "rmk": "string"
                  },
                  "status": [
                      {
                          "id": "3",
                          "pid": "4",
                          "createTime": "2020-08-24 10:33:41",
                          "optUserId": "3131asdasd",
                          "rmk": "暂存"
                      },
                      {
                          "id": "8",
                          "pid": "4",
                          "createTime": "2020-08-24 12:33:59",
                          "optUserId": "1144",
                          "rmk": "修改"
                      },
                      {
                          "id": "9",
                          "pid": "4",
                          "createTime": "2020-08-24 13:20:57",
                          "optUserId": "1144",
                          "rmk": "修改"
                      }
                  ]
              }
          }
显示代码

# 14、装车单申请接口信息表

# 14.1、装车单基本信息

序号 中文名称 字段名称 字段类型 长度 是否必填标记 注释
1 装车单信息基本表ID id Integer 0 系统自动生成，修改时必填
2 装车单车队子账户id orgId String 64 系统自动生成，修改时必填
3 装车单单证号 packageListNo String 64 系统自动生成，(SA+关区代码4位+LG+年月日6位+5位流水号)修改时必填
4 车牌号 vehicleNo String 64 M
5 关区编码(2249) customCode String 4 M
6 进出区标志 iePack String 1 M I-进区，E-出区
7 装车单操作状态 optStatus String 10 见操作状态表
8 申报类型代码 dclTypecd String 1 1、备案 3、作废
9 企业中文名称 tradeName String 64
10 总重量 weight Integer 19 M
11 是否已装车 isConfirm String 10 0-未装车，1-已装车

# 14.2、装车单表体信息

序号 中文名称 字段名称 字段类型 长度 备注 是否必填标记
1 ID id Integer 0 系统反填
2 装车单ID pid Integer 0 系统反填
3 关联单证编号 sasPassportPreentNo String 64 卡口验放凭证编号 M
4 单证状态 sasOptStatus String 10 系统反填 M
5 卡口验放凭证出入库类型 passportTypecd String 1 0-空车进出区 1-非径予放行货物 2-先报后送 3-分送集报 4-区内流转 5-区间流转 6-进出境径予放行 7-二线进出 8-便捷进出区 9-一单多车B 10-分送集报退运 M
6 进出标志代码 ioTypecd String 1 M
7 关区代码 customCode String 4 M
8 备注（存放卡口验放凭证id） rmk String 4000 M
9 查验状态 isInspection String 10 1-需要查验，0-不需查验 M
10 卸货状态 isDischarge String 10 0-未卸货，1-已卸货 M

# 14.3、装车单操作记录

序号 中文名称 字段名称 字段类型 长度 是否必填标记 备注
1 ID id Integer 10 系统自动生成
2 装车单ID pid Integer 10 系统自动生成
3 操作状态 optStatus String 10 系统自动生成，见操作状态表
4 操作人员id optUserId String 20 系统自动生成
5 操作时间 optTime String 7 系统自动生成
6 报文名 fileName String 4000 系统自动生成
7 备注 remark String 4000 系统自动生成

# 14.4、装车单暂存

接口名称 装车单暂存接口
接口功能 装车单暂存接口
接口协议 HTTP、Content-Type：application/json
请求地址 /pickRide/insertPackageList
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
id id String 系统返填
子账户id orgId String 系统返填
装车单单证号 packageListNo String 系统返填
车牌号 vehicleNo String M
关区编码(2249) customCode String M
进出区标志 iePack String M
装车单操作状态 optStatus String 系统返填
申报类型代码 dclTypecd String M 系统返填
企业中文名称 tradeName String 系统返填
总重量 weight Integer(19,5) M
是否已装车 isConfirm String 系统返填
装车单表体信息 packageSaspassport json对象
装车单表体信息 packageSaspassport json对象
id id String 系统返填
装车单id pid String 系统返填
关联单证编号 sasPassportPreentNo String M
单证状态 sasOptStatus String M
卡口验放凭证出入库类型 passportTypecd String M
进出标志代码 ioTypecd String M
关区代码 customCode String M
卡口验放凭证id rmk String M
查验状态 isInspection String 系统返填
卸货状态 isDischarge String 系统返填
代码示例
详情装车单基本信息、装车单表体信息，注意：新增id为空

装车单暂存时同一车牌号的卡口验放凭证：



            {
              "customCode": "2249",
              "dclTypecd": "1",
              "id": "",
              "iePack": "I",
              "optStatus": "1",
              "orgId": "2406",
              "packageListNo": "",
              "packageSaspassport": [{
                "customCode": "2249",
                "ioTypecd": "I",
                "passportTypecd": "2",
                "rmk": "16465",
                "sasOptStatus": "5",
                "sasPassportPreentNo": "002406ZV200821016465"
              }],
              "tradeName": "德玛西亚",
              "vehicleNo": "川O80356",
              "weight": "100"
            }
显示代码
出参
代码示例
详见ReturnInfo：实例如下： 


            {  
              "status": "1",
                "note": "暂存成功",
                "description": null,
                "map": {    
                "packageListNo": "SA2249LG21011501108",
                    "id": 1108  
              }
            }
显示代码

# 14.5、装车单修改

接口名称 装车单修改接口
请求地址 /pickRide/updatePackageList
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 属性名 字段类型 是否必填 备注
id id String 系统返填
子账户id orgId String 系统返填
装车单单证号 packageListNo String 系统返填
车牌号 vehicleNo String M
关区编码(2249) customCode String M
进出区标志 iePack String M
装车单操作状态 optStatus String 系统返填
申报类型代码 dclTypecd String M 系统返填
企业中文名称 tradeName String 系统返填
总重量 weight Integer(19,5) M
是否已装车 isConfirm String 系统返填
装车单表体信息 packageSaspassport json对象
装车单表体信息 packageSaspassport json对象
id id String 系统返填
装车单id pid String 系统返填
关联单证编号 sasPassportPreentNo String M
单证状态 sasOptStatus String M
卡口验放凭证出入库类型 passportTypecd String M
进出标志代码 ioTypecd String M
关区代码 customCode String M
卡口验放凭证id rmk String M
查验状态 isInspection String 系统返填
卸货状态 isDischarge String 系统返填
代码示例

备注：字段详情说明请看数据字典，

修改需要传入记录id，修改绑定单证逻辑同暂存



            {
              "customCode": "2249",
              "dclTypecd": "1",
              "id": "108",
              "iePack": "I",
              "optStatus": "1",
              "orgId": "2406",
              "packageListNo": "",
              "packageSaspassport": [{       
                "id": "112",
                "customCode": "2249",
                "ioTypecd": "I",
                "passportTypecd": "2",
                "rmk": "16465",
                "sasOptStatus": "5",
                "sasPassportPreentNo": "002406ZV200821016465"
              }],
              "tradeName": "德玛西亚",
              "vehicleNo": "川O80356",
              "weight": "100"
            }
显示代码
出参
代码示例


            {
              "status" : "1",
              "note" : "修改成功",
              "description" : null,
              "map" : null
            }
显示代码

# 14.6、装车单删除

接口名称 装车单删除接口
请求地址 /pickRide/deletePackageListBsc
请求方式 POST
请求头入参 字段名 字段类型 是否必填
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填
bscIds Integer Y
代码示例


            {
              "bscIds":[84,85]
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status" : "1",
              "note" : "删除成功",
              "description" : null,
              "map" : null
            }
显示代码

# 14.7、装车单申报

接口名称 装车单申报
请求地址 /pickRide/packageListDeclare
请求方式 POST
入参 字段名 字段类型 是否必填
bscIds Id Integer Y(可多个同时申报)
bscIds为装车单信息基本表id，支持多个
样例如下：
代码示例


            {
              "bscIds":[185]
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status" : "1",
              "note" : "申报成功",
              "description" : null,
              "map" : null
            }
显示代码

# 14.8、装车单列表查询

接口名称 装车单查询-所有
请求地址 /pickRide/packageListAll
请求方式 POST
入参 字段名 字段类型 是否必填
页码 page Number Y
条数 size Number Y
装车单证号 packageListNo String
企业名称 tradeName String Y
车牌号 vehicleNo String
进出区标志 iePack String
关联单证编号 sasPassportPreentNo String
多选子账户编号 orgIdList String数组 不传默认查询当前选中子账
代码示例


            {
                "iePack": "I",
                "optStatus": "1",
                "packageListNo": "SA2249LG21011501108",
                "page": 1,
                "size": 10,
                "tradeName": "德玛西亚",
                "vehicleNo": "川O80356",
                "sasPassportPreentNo": "",
            }
显示代码
出参
代码示例
详细场所基本信息，实例如下： 


            {
              "status": "1",
              "note": "查询成功",
              "description": null,
              "map": {
                  "data": {
                      "numberOfElements": 10,
                      "size": 10,
                      "last": false,
                      "num": 0,
                      "totalPages": 5,
                      "content": [
                          {
                              "id": "1110",
                              "orgId": "2406",
                              "packageListNo": "SA2249LG21011501110",
                              "vehicleNo": "京J18854",
                              "customCode": "2249",
                              "iePack": "I",
                              "optStatus": "1",
                              "dclTypecd": "1",
                              "vehicleId": null,
                              "vehicleName": null,
                              "tradeName": "德玛西亚",
                              "totalWt": null,
                              "weight": "13412",
                              "isConfirm": "0",
                              "packageListNoFrom": null,
                              "packageSaspassport": [],
                              "packageListStatus": [],
                              "packageSaspassportRlt": []
                          }
                      ],
                      "first": true,
                      "totalElements": 43
                  }
              }
          }
显示代码

# 14.9、装车单查询单条明细

接口名称 装车单查询单条明细
请求地址 /pickRide/packageListInfo
请求方式 POST
入参 字段名 字段类型 是否必填
id String Y
代码示例


            {
                id: "1104"
            }
显示代码
出参
代码示例


            {
                "status": "1",
                "note": "查询成功",
                "description": null,
                "map": {
                    "data": {
                        "id": "1110",
                        "orgId": "2406",
                        "packageListNo": "SA2249LG21011501110",
                        "vehicleNo": "京J18854",
                        "customCode": "2249",
                        "iePack": "I",
                        "optStatus": "1",
                        "dclTypecd": "1",
                        "vehicleId": null,
                        "vehicleName": null,
                        "tradeName": "德玛西亚",
                        "totalWt": null,
                        "weight": "13412",
                        "isConfirm": "0",
                        "packageListNoFrom": null,
                        "packageSaspassport": [
                            {
                                "id": "3213",
                                "pid": "1110",
                                "sasPassportPreentNo": "002406ZV200821016464",
                                "sasOptStatus": "5",
                                "passportTypecd": "2",
                                "customCode": "2249",
                                "ioTypecd": "I",
                                "rmk": "16464",
                                "isInspection": "0",
                                "isDischarge": null,
                                "cargoSasPassportRlt": []
                            }
                        ],
                        "packageListStatus": [
                            {
                                "id": "2766",
                                "pid": "1110",
                                "createTime": null,
                                "optStatus": "1",
                                "optUserId": "zhouchangjie123",
                                "optUserName": "zhouchangjie123",
                                "optTime": "2021-01-15 20:35:43",
                                "remark": "装车单暂存",
                                "fileName": null
                            }
                        ],
                        "packageSaspassportRlt": []
                    }
                }
            }
显示代码

# 14.10、装车单作废申报

接口名称 装车单作废申报
接口功能 根据业务id值向海关申请作废装车单，等待回执
接口协议 HTTP、Content-Type：application/json
请求地址 /pickRide/packageListAbolished
请求方式 POST
请求头入参 中文名 字段名 类型 必填 说明
授权码 userAuthCode String M
入参 字段名 字段类型 是否必填
装车单id bscIds Integer M
代码示例


            {
              "bscIds":[11,13,14]
            }
显示代码
出参 详细ReturnInfo，实例如下：
代码示例


            {
              "status" : "1",
              "note" : "作废成功",
              "description" : null,
              "map" : null
            }
显示代码

# 15、资质申请接口信息列表

# 15.1、资质基本信息

序号 中文名称 字段名称 数据类型 长度 标记 备注
1 id id String 10 M 系统自动生成
2 企业编码 TradeCode String 50 M
3 关区代码 masterCuscd String 4 M
4 资质类型 qualifyType String 2 M 根据资质类型接口进行查询,对应switchKeyName字段
5 状态 dclTbStucd String 1 1-正常、2-暂停
6 申请时间 dclTime String yyyy-MM-dd HH:mm:ss
7 有效期 validTime String
8 申请说明 applyDesc String 4000
9 操作状态 optStatus String 10 M 系统自动生成
10 资质类型代码 switchKey String 255 M 根据资质类型接口进行查询
11 企业名称 tradeName String 255 M

# 15.2、资质操作记录

序号 中文名称 字段名称 数据类型 长度 标记 备注
1 id id String M
2 pid pid String M
3 创建时间 createTime String M 写数据库时间
4 操作状态 optStatus String 10 M 详见状态页面
5 操作人id optUserId String 20 M
6 操作时间 optTime String 20 M
7 备注 remark String 4000
8 报文名 fileName String 255

# 15.3、企业资质暂存接口

接口名称 企业资质暂存
接口功能 企业资质暂存
接口协议 HTTP
请求地址 /tradeQualify/tradeQualify/save
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
关区代码 masterCuscd String M
资质类型 qualifyType String M
企业名称 tradeName String M
申请说明 applyDesc String
资质类型代码 switchKey String M
代码示例
详情资质基本信息，提示：新增id为空 


            {
                "id":"",
                "masterCuscd":"2249",
                "qualifyType":"保税加工",
                "applyDesc":"申请资质",
                "tradeName":"上海优选",
                "switchKey":"qualify_A"
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
                "status": "1",
                "note": "暂存成功",
                "description": null,
                "map": {
                  "data": {
                    "id": 1201,
                    "tradeCode": "0000000009",
                    "masterCuscd": "2249",
                    "qualifyType": "保税加工",
                    "dclTbStucd": "1",
                    "dclTime": "2021-05-16 10:22:05",
                    "validTime": null,
                    "applyDesc": "aa",
                    "optStatus": "1",
                    "switchKey": "qualify_A",
                    "orgId": 0,
                    "tradeName": "上海优选"
                  }
                }
              }
显示代码

# 15.4、企业资质修改接口

接口名称 企业资质修改
接口功能 企业资质修改
接口协议 HTTP
请求地址 /tradeQualify/tradeQualify/update
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String M id
关区代码 masterCuscd String M 关区代码
资质类型 qualifyType String M 资质类型
有效期 validTime String 有效期
企业编码 tradeCode String M 企业编码
操作状态 optStatus String M 操作状态
申请时间 dclTime String M 申请时间
状态 dclTbStucd String M 状态
申请说明 applyDesc String M 申请说明
代码示例
详情资质基本信息，提示：修改id必填 


            {
              "id": "1201",
              "tradeCode": "0000000009",
              "masterCuscd": "2249",
              "qualifyType": "保税加工",
              "dclTbStucd": "1",
              "dclTime": "2021-09-16 10:22:05",
              "validTime": null,
              "applyDesc": "aa",
              "optStatus": "1",
              "description": "保税加工",
              "switchKey": "qualify_F",
              "orgId": "0",
              "tradeName": "上海优选"
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "note":"企业资质修改成功",
              "status":"1"
            }
显示代码

# 15.5、企业资质删除接口

接口名称 企业资质删除
接口功能 企业资质删除
接口协议 HTTP
请求地址 /tradeQualify/tradeQualify/delete
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String M id
代码示例


            {
              "id":"1"
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "note":"企业资质删除成功",
              "status":"1"
            }
显示代码

# 15.6、企业资质查询

接口名称 服务端查询企业资质申请
接口功能 服务端查询企业资质申请
接口协议 HTTP
请求地址 /tradeQualify/tradeQualify/findList
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
页数 page String M 页数
页数 page Number M 页数
每页条数 size Number M 行数
关区 masterCuscd String M 关区
资质类型 qualifyType String M 资质类型
代码示例
详情资质基本信息，提示：新增id为空 


            {
              "qualifyType": "保税加工",
              "masterCuscd": "2249",
              "size": 10,
              "page": 1
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
                "status": "1",
                "note": "查询成功",
                "description": null,
                "map": {
                    "data": {
                        "numberOfElements": 10,
                        "size": 10,
                        "last": true,
                        "num": 0,
                        "totalPages": 1,
                        "content": [
                            {
                                "id": "111",
                                "tradeCode": "3118541111",
                                "masterCuscd": "2249",
                                "qualifyType": "保税加工",
                                "dclTbStucd": "1",
                                "dclTime": "2020-04-07 10:44:30",
                                "validTime": "2020-04-30 09:43:12",
                                "applyDesc": "aa",
                                "optStatus": "5",
                                "description": "444"
                            }
                        ],
                        "first": true,
                        "totalElements": 4
                    }
                }
            }
显示代码

# 15.7、企业资质申报

接口名称 企业资质申报
接口功能 企业资质申报
接口协议 HTTP
接口方向 企业调用新片区海关监管系统
请求地址 /tradeQualify/tradeQualify/declare
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
资质id idList String [] M 资质id
代码示例
详情资质基本信息，提示：新增id为空 


            {
              "idList":["1"，"2"]
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "note":"企业资质申报成功",
              "status":"1"
            }
显示代码

# 15.8、资质申请操作记录查询

接口名称 查询企业资质操作记录
接口功能 查询企业资质操作记录
接口协议 HTTP
接口方向 企业调用新片区海关监管系统
请求地址 /tradeQualify/tradeQualify/findOperationLog
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
企业资质id pid String M 企业资质id
代码示例


            {
              "pid": "11"
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
                "status": "1",
                "note": "查询企业资质操作记录",
                "description": null,
                "map": {
                    "data": {
                        "content": [
                            {
                                "id": "184",
                                "pid": "104",
                                "createTime": "2020-04-04 17:46:17",
                                "optStatus": "1",
                                "optUserId": "goldencustomstester",
                                "optTime": "2020-04-04 17:46:17",
                                "remark": "企业资质申请",
                                "fileName": null
                            }
                        ]
                    }
                }
            }
显示代码

# 15.9、资质类型查询

接口名称 查询企业资质操作记录
接口功能 查询企业资质操作记录
接口协议 HTTP
接口方向 企业调用新片区海关监管系统
请求地址 /tradeQualify/switch/typeList
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
开关类型 switchType String M 1-资质开关
代码示例


            {
              "page": 1,
              "size": 1000,
              "switchType": "1"
            }
显示代码
出参
代码示例
详细ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                "data": {
                  "content": [{
                    "rmk": "进境径予放行货物木质包装",
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "进境径予放行-木质包装",
                    "switchKey": "qualify_P",
                    "id": 1365
                  }, {
                    "rmk": "一单多车B业务资质",
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "一单多车B",
                    "switchKey": "qualify_O",
                    "id": 1141
                  }, {
                    "rmk": null,
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "径予放行",
                    "switchKey": "qualify_L",
                    "id": 1103
                  }, {
                    "rmk": null,
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "Y",
                    "switchKeyName": "分送集报",
                    "switchKey": "qualify_K",
                    "id": 1041
                  }, {
                    "rmk": "申请外发加工（增料、内销）",
                    "sysCode": null,
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "外发加工（增料、内销）",
                    "switchKey": "qualify_J_S",
                    "id": 762
                  }, {
                    "rmk": "一般加工",
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "保税加工",
                    "switchKey": "qualify_A",
                    "id": 761
                  }, {
                    "rmk": "保税展示交易",
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "保税展示交易",
                    "switchKey": "qualify_N",
                    "id": 656
                  }, {
                    "rmk": "飞机试飞",
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "飞机试飞",
                    "switchKey": "qualify_M",
                    "id": 655
                  }, {
                    "rmk": "外发加工",
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "外发加工",
                    "switchKey": "qualify_J",
                    "id": 652
                  }, {
                    "rmk": "委托加工",
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "委托加工",
                    "switchKey": "qualify_I",
                    "id": 651
                  }, {
                    "rmk": "跨境电商",
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "Y",
                    "switchKeyName": "跨境电商",
                    "switchKey": "qualify_H",
                    "id": 650
                  }, {
                    "rmk": "临时出区",
                    "sysCode": null,
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "临时出区",
                    "switchKey": "qualify_G",
                    "id": 649
                  }, {
                    "rmk": "模具外发",
                    "sysCode": null,
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "模具外发",
                    "switchKey": "qualify_F",
                    "id": 648
                  }, {
                    "rmk": "设备出区",
                    "sysCode": null,
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "设备出区",
                    "switchKey": "qualify_E",
                    "id": 647
                  }, {
                    "rmk": "境外维修",
                    "sysCode": "lgsa",
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "境外维修",
                    "switchKey": "qualify_D",
                    "id": 646
                  }, {
                    "rmk": "境内维修",
                    "sysCode": null,
                    "switchType": "1",
                    "defaultVal": "N",
                    "switchKeyName": "境内维修",
                    "switchKey": "qualify_C",
                    "id": 645
                  }],
                  "pageable": {
                    "sort": {
                      "sorted": false,
                      "unsorted": true
                    },
                    "pageSize": 1000,
                    "pageNumber": 0,
                    "offset": 0,
                    "paged": true,
                    "unpaged": false
                  },
                  "totalElements": 16,
                  "totalPages": 1,
                  "last": true,
                  "first": true,
                  "sort": {
                    "sorted": false,
                    "unsorted": true
                  },
                  "numberOfElements": 16,
                  "size": 1000,
                  "number": 0
                }
              }
            }
显示代码

# 16、子账户接口信息列表

# 16.1、子账户基本信息

序号 中文名称 字段名称 类型 长度 注释 是否必填
1 子账户id id String 系统自动生成 修改必填
2 企业id tradeId String 企业信息的id M
3 账号类型 type String 4 21-保税物流
22-保税加工
23-委托加工
24-跨境电商
25-境内维修
26-境外维修
27-设备管理
28-跨境电商出口海外仓
29-保税展品
30-保税国际中转		 M
4 组织编号 orgCode String 20 系统自动生成
5 状态 status String 3 系统自动生成
6 所在关区id customId String 4 M
7 IC卡号 icCard String 50
8 申报类型 dclTypecd String 1 1-备案 M
9 来源 source String 1 2-新片区（新增时不填）

# 16.2、子账户扩展信息

序号 中文名称 字段名称 类型 长度 注释 是否必填
1 id id String 系统生成
2 地址 address String 150
3 仓储面积 area String 50 21-保税物流
必填
4 电子邮件 email String 50
5 子账户id orgId String 修改必填
6 联系人 person String 50
7 备注 remake String 255
8 电话 tel String 50
9 邮编 zip String 50

# 16.3、子账户操作记录

序号 中文名称 字段名称 类型 长度 备注 是否必填
1 id id String
2 pid pid String
3 创建时间 createtime String
4 操作类型 optStatus String 10
5 操作人id optUserId String 20
6 操作时间 optTime String 20
7 备注 remark String 255
8 报文名 filename String 255

# 16.4、用户子账户关系

序号 中文名称 字段名称 类型 长度 注释 是否必填
1 id id String 系统生成
2 企业编码 tradeCode String M
3 登录名 loginName String M
4 默认子账户id defaultOrgId String 10 M
5 可选子账户id authorizedOrgId String 20 多个id逗号拼接 M
6 子账户类型 type String 20 M

# 16.5、子账户新增接口

接口名称 子账户新增
接口功能 子账户新增
接口协议 HTTP
请求地址 /org/saveOrg
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
企业id tradeId String M 企业信息的id
账号类型 type String M 21—保税物流
22—保税加工
23—委托加工
24—跨境电商
25—境内维修
26—境外维修
27—设备管理
28—跨境电商出口海外仓
29—保税展品
30—保税国际中转
所在关区id customId String M 参考《国家关区码表》
IC卡号 icCard String
申报类型 dclTypecd String M 1-备案
来源 source String
区域 area String M L-芦潮港；J-机场南侧；D-大场区域
扩展信息 organizationE Object
地址 address String
仓储面积 area String 账号类型为21-保税物流必填
电子邮件 email String
子账户id orgId String 新增时不填
联系人 person String
备注 remake String
电话 tel String
邮编 zip String
代码示例


            {
              "tradeId": "27",
              "tradeCode": "85051x1014",
              "dclTyoecd": "1",
              "type": "21",
              "orgCode": "",
              "status": "",
              "customId": "2",
              "icCard": "2222222222222",
              "area": "L",
              "organizationE": {
                  "address": "",
                  "orgId": "",
                  "zip": "",
                  "person": "",
                  "tel": "",
                  "email": "",
                  "area": "",
                  "remark": ""
              }
          }
显示代码
出参
代码示例


            {
                "status": "1",
                "note": "子账户信息全部保存成功！！",
                "description": null,
                "map": {
                    "id": 44
                }
            }
显示代码

# 16.6、子账户修改接口

接口名称 子账户修改接口
接口功能 子账户修改接口
接口协议 HTTP
请求地址 /org/updateOrg
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String M
企业id tradeId String M 企业信息的id
账号类型 type String M 21—保税物流
22—保税加工
23—委托加工
24—跨境电商
25—境内维修
26—境外维修
27—设备管理
28—跨境电商出口海外仓
29—保税展品
30—保税国际中转
所在关区id customId String M 参考《国家关区码表》
IC卡号 icCard String
申报类型 dclTypecd String M 1-备案
来源 source String 2-新片区
区域 area String M L-芦潮港；J-机场南侧；D-大场区域
扩展信息对象 organizationE Object
地址 address String
仓储面积 area String
电子邮件 email String
子账户id orgId String M
联系人 person String
备注 remake String
电话 tel String
邮编 zip String
代码示例


            {
              "id": "1",
              "tradeId": "27",
              "tradeCode": "85051x1014",
              "dclTyoecd": "1",
              "type": "21",
              "orgCode": "",
              "status": "",
              "customId": "2",
              "icCard": "2222222222222",
              "area": "L",
              "organizationE": {
                  "address": "",
                  "orgId": "1",
                  "zip": "",
                  "person": "",
                  "tel": "",
                  "email": "",
                  "area": "",
                  "remark": ""
              }
          }
显示代码
出参
代码示例


            {
                "status" : "1",
                "note" : "子账户信息全部修改并保存成功！！",
                "description" : null,
                "map" : null
            }
显示代码

# 16.7、子账户确认

接口名称 子账户申报
接口功能 子账户申报
接口协议 HTTP
请求地址 /org/declareOrg
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
子账户id id String M
代码示例


            {
                "id": "103560"
            }
显示代码
出参
代码示例
ReturnInfo，实例如下： 


            {
                "status" : "1",
                "note" : "子账户信息成功申报",
                "description" : null,
                "map" : null
            }
显示代码

# 16.8、子账户查询列表

接口名称 子账户查询列表
请求地址 /org/getOrgByPage
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
页数 page Int M
每页条数 size Int M
企业编码 tradeCode String M
代码示例


            {
              "tradeCode": "1212000000",
              "size": 10,
              "page": 1
            }
显示代码
出参
代码示例
ReturnInfo实例如下： 


            {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                  "data": {
                      "first": true,
                      "sort": {
                          "sorted": true,
                          "unsorted": false
                      },
                      "numberOfElements": 1,
                      "totalPages": 1,
                      "totalElements": 1,
                      "last": true,
                      "pageable": null,
                      "size": 10,
                      "content": [
                          {
                              "id": "102042",
                              "tradeId": "2101142",
                              "tradeCode": null,
                              "type": "21",
                              "orgCode": "102042",
                              "status": "5",
                              "dclTypecd": "1",
                              "sysCode": null,
                              "source": "2",
                              "customId": "2249",
                              "customCode": null,
                              "angencyScope": null,
                              "customName": null,
                              "icCard": null,
                              "tradeName": null,
                              "organizationE": null,
                              "orgrelation": null,
                              "accountBookModel": []
                          }
                      ],
                      "number": 0
                  }
              }
          }
显示代码

# 16.9、子账户查询详情

接口名称 子账户查询详情
接口功能 子账户查询详情
接口协议 HTTP
请求地址 /org/getOrgDetail
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
id id String M
代码示例


            {
              "id":"103680"
            }
显示代码
出参
代码示例
ReturnInfo实例如下： 


            {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                "data": {
                  "id": "103680",
                  "tradeId": "2101801",
                  "tradeCode": "1212000000",
                  "type": "21",
                  "orgCode": "103680",
                  "status": "5",
                  "dclTypecd": "1",
                  "sysCode": null,
                  "source": "2",
                  "area": "L",
                  "customId": "2249",
                  "customCode": "2249",
                  "angencyScope": null,
                  "customName": "洋山保税",
                  "icCard": null,
                  "tradeName": null,
                  "organizationE": {
                    "id": "101600",
                    "orgId": "103680",
                    "address": null,
                    "zip": null,
                    "person": null,
                    "tel": null,
                    "email": null,
                    "area": null,
                    "remark": null,
                    "organization": []
                  },
                  "orgrelation": null,
                  "accountBookModel": []
                }
              }
            }
显示代码

# 16.10、子账户查询操作记录

接口名称 子账户查询操作记录
接口功能 子账户查询操作记录
接口协议 HTTP
请求地址 /org/getOrgStatus
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
子账户id pid String M
代码示例


            {
              "pid": "1"
            }
显示代码
出参
代码示例
ReturnInfo实例如下： 


            {
                "status": "1",
                "note": null,
                "description": null,
                "map": {
                    "data": [
                        {
                            "id": 7737,
                            "pid": 102042,
                            "createtime": "2020-09-28 00:08:25",
                            "optStatus": "5",
                            "optUserId": "审核回执",
                            "optTime": "2020-09-28 00:08:25",
                            "remark": "审核回执：审核通过,组织代码：102042",
                            "filename": null
                        }
                    ]
                }
            }
显示代码

# 16.11、查询所有可用子账户

接口名称 查询所有可用子账户
接口功能 查询所有可用子账户
接口协议 HTTP
请求地址 /org/queryOrgList
请求方式 POST
入参 无
出参
代码示例
ReturnInfo实例如下： 


            {
                "status": "1",
                "note": "查询成功",
                "description": null,
                "map": {
                    "data": [
                        {
                            "id": 102042,
                            "tradeId": 2101142,
                            "type": "21",
                            "orgCode": "102042",
                            "status": "5",
                            "source": "2",
                            "icCard": null,
                            "customId": "2249",
                            "dclTypecd": "1",
                            "customCode": null,
                            "customName": null,
                            "tradeName": null,
                            "tradeCode": null
                        }
                    ]
                }
            }
显示代码

# 16.12、根据登录名查询当前及可选子账户

接口名称 根据登录名查询当前及可选子账户
接口功能 根据登录名查询当前及可选子账户
接口协议 HTTP
请求地址 /org/queryAuthorizedOrgId
请求方式 GET
入参 字段名 属性名 字段类型 是否必填
登录名 loginName String M
代码示例


            queryAuthorizedOrgId?loginName=zhujiahao005
显示代码
出参
代码示例
ReturnInfo实例如下

注：defaultOrgId即为当前登录的子账户id



            {
                "status": "1",
                "note": "查询成功",
                "description": null,
                "map": {
                    "data": {
                        "id": "447",
                        "tradeCode": "8686886668",
                        "loginName": "zhujiahao005",
                        "defultOrgId": "102042",
                        "authorizedOrgId": "102042",
                        "type": "21",
                        "col1": null,
                        "name": "保税物流",
                        "authorizedOrgIdList": [
                            {
                                "orgId": "102042",
                                "type": "21",
                                "name": "保税物流"
                            }
                        ]
                    }
                }
            }
显示代码

# 16.13、修改当前用户登录的子账户

接口名称 修改当前用户登录的子账户
接口功能 修改当前用户登录的子账户
接口协议 HTTP
请求地址 /org/modifiOrgId
请求方式 Post
入参 字段名 属性名 字段类型 是否必填
子账户id orgId String M
代码示例
ReturnInfo实例如下 


            {
              "orgId": "2"
            }
显示代码
出参
代码示例
ReturnInfo实例如下

注：defaultOrgId即为当前登录的子账户id



          {
            "status": "1",
            "note": "保存成功",
            "description": null,
            "map": {
                "data": {
                    "id": "301",
                    "tradeCode": "8686886668",
                    "loginName": "zhujiahao006",
                    "defultOrgId": "100003",
                    "authorizedOrgId": "100003",
                    "type": "1",
                    "col1": null,
                    "name": null,
                    "authorizedOrgIdList": [

                ]
            }
        }
    }
显示代码

# 16.14、根据用户信息查询企业组织信息

接口名称 根据用户信息查询企业组织信息
接口功能 查询企业组织信息
接口协议 HTTP
请求地址 org/getTrade
请求方式 Post
请求头 字段名 属性名 字段类型 是否必填 备注
epToken Token信息 String M
入参 无入参
出参
代码示例
ReturnInfo实例如下 


            {
                "status": "1",
                "note": null,
                "description": null,
                "map": {
                    "trade": {
                        "id": "2101137",
                        "tradeCode": "0000000009",
                        "tradeName": "上海优选",
                        "customId": "2249",
                        "customCode": null,
                        "customName": null,
                        "status": "5",
                        "orgNo": "0000000009",
                        "creditCode": "123450000000009123",
                        "dclTypecd": "1",
                        "ediCode": null,
                        "source": null,
                        "tradeE": null,
                        "tradeGrade": null,
                        "col1": null,
                        "col2": null,
                        "col3": null
                    },
                    "organization": {
                        "id": "102031",
                        "tradeId": "2101137",
                        "tradeCode": null,
                        "type": "22",
                        "orgCode": "102031",
                        "status": "5",
                        "dclTypecd": "1",
                        "sysCode": null,
                        "source": null,
                        "customId": "2249",
                        "customCode": null,
                        "angencyScope": null,
                        "customName": null,
                        "icCard": null,
                        "tradeName": null,
                        "organizationE": null,
                        "orgrelation": null,
                        "accountBookModel": []
                    },
                    "userName": "zzwang001",
                    "userId": "zzwang001"
                }
            }
显示代码

# 17、便捷进出区接口信息列表

# 17.1、登记单表头

序号 字段名称 属性名称 字段类型 长度 注释 是否必填
1 id id String 系统生成 M
2 子账户id orgId String 请求头自取 M
3 登记单编号 passportNo String 系统生成 M
4 变更次数 chgTmsCnt String 10 系统默认0 M
5 申报类型 dclTypecd String 1 1-备案；3-作废 M
6 进出标志 ioTypecd String 1 M
7 关区代码 masterCuscd String 4 M
8 区内企业编码 areainEtpsno String 10 M
9 区内企业名称 areainEtpsNm String 768 M
10 区内企业社会信用代码 areainEtpsSccd String 18
11 货物类型 gdsTypecd String 20
12 申报时间 dclTime String 系统生成
13 备案审批时间 putrecEmapvTime String 系统返填
14 失效时间 faliureTime String 系统生成
15 车牌号 vehicleNo String 128 M
16 过卡时间1 passTime String 系统返填
17 过卡时间2 secdPassTime String 系统返填
18 状态代码 stucd String 1 系统生成
0：已申请，
1：已审批，
2：已过卡，
3：已过一卡，4：已过二卡，5：已删除，
6：已作废。
19 审批标志代码 emapvMarkcd String 1 系统生成
1：通过，
2：转岗，
3：退单
20 布控指令号 ctrlNo String 系统生成
21 查验结果 optResult String 系统生成
1-正常；2-异常
22 备注 rmk String 4000 备注
23 操作状态 optStatus String 10 详见状态页面 M
24 绑定标志 passportUsedTypecd String 4 系统生成
1-未绑定，
2-部分绑定，
3-已绑定		 M
25 区域 area String 2
26 关联入区登记单编号 associatedIntoPassportNo String 64
27 完全被关联状态 completelyAssociatedStatus String 2 Y-完全被关联，
N-未完全被关联

# 17.2、登记单表体

序号 字段名称 属性名称 字段类型 长度 备注 是否必填
1 id Id String 系统生成 M
2 表头id pid String 系统生成 M
3 子账户id orgId String 请求头自取 M
4 登记单编号 passportNo String 系统生成 M
5 变更次数 chgTmsCnt String 系统生成，默认0 M
6 明细序号 gdsSeqno String 系统生成，默认1 M
7 货物名称 gdsNm String 768 当是出区登记单，并且关联了入区登记单，并且货物类型是（2/4/6/7）时，进出区的货物名称必须一致 M
8 货物数量 dclQty String 19,5 当是出区登记单，并且关联了入区登记单，并且货物类型是（2/4/6/7）时，货物数量必须小于或等于入区的剩余数量 M
9 计量单位 dclUnitcd String 3 当是出区登记单，并且关联了入区登记单，并且货物类型是（2/4/6/7）时，进出区的计量单位必须一致 M
10 货物、物品类型 gdsTypecd String 3 1-区内的基础设施、生产厂房、仓储设施建设过程中所需的机器、设备、基建物资；
2-区内企业和行政管理机构自用的办公用品；
3-区内企业所需的劳保用品；
4-区内企业用于生产加工及设备维护的少量、急用物料；
5-区内企业使用的包装物料；
6-区内企业使用的样品；
7-区内企业生产经营使用的仪器、工具、机器、设备；
8-区内人员所需的生活消费品。		 M
11 规格型号 gdsSpcfModelDesc String 768 货物类型选择为第4，7类时，为必填项
12 备注 rmk String 4000
13 关联入区明细序号 associatedIntoGdsSeqno String 64 出区单证关联了入区单证时必填
14 预扣数量 passportUsedQty String 19,5
15 实扣数量 actlPassQty String 19,5
16 剩余数量 remainQty String 19,5
17 关联入区的自增长ID associatedIntoId String 10

# 17.3、登记单操作记录表

序号 字段名称 属性名称 字段类型 长度 备注 是否必填
1 id id String
2 pid pid String
3 创建时间 createTime String
4 操作状态 optStatus String 10
5 操作人id optUserName String 50
6 操作时间 optTime String
7 备注 remark String 4000
8 报文名 fileName String 255

# 17.4、登记单暂存

接口名称 登记单暂存
请求地址 /passport/pass/save
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
申报类型 dclTypecd String M 1：备案；3：作废
进出标志 ioTypecd String M I：进 E：出
关区代码 masterCuscd String M
区内企业编码 areainEtpsno String M
区内企业名称 areainEtpsNm String M
区内企业社会信用代码 areainEtpsSccd String
关联入区登记单编号 associatedIntoPassportNo String 当出区登记单关联了入区登记单时，该字段必填
登记单表体对象 easyPassportDt Object
货物名称 gdsNm String M 当是出区登记单，并且关联了入区登记单，并且货物类型是（2/4/6/7）时，进出区的货物名称必须一致
货物数量 dclQty String M 当是出区登记单，并且关联了入区登记单，并且货物类型是（2/4/6/7）时，货物数量必须小于入区的剩余数量必须一致
计量单位 dclUnitcd String M 当是出区登记单，并且关联了入区登记单，并且货物类型是（2/4/6/7）时，进出区的计量单位必须一致
货物、物品类型 gdsTypecd String M 1：区内的基础设施、生产厂房、仓储设施建设过程中所需的机器、设备、基建物资；
2：区内企业和行政管理机构自用的办公用品；
3：区内企业所需的劳保用品；
4：区内企业用于生产加工及设备维护的少量、急用物料；
5：区内企业使用的包装物料；
6：区内企业使用的样品；
7：区内企业生产经营使用的仪器、工具、机器、设备；
8：区内人员所需的生活消费品。
规格型号 gdsSpcfModelDesc String M 货物类型选择为第4，7类时，为必填项
备注 rmk String
关联入区的ID associatedIntoId String 出区的登记单所对应的入区表体的明细数据
代码示例


          {
            "id": "",
            "orgId": "",
            "passportNo": "",
            "chgTmsCnt": "",
            "dclTypecd": "",
            "masterCuscd": "2249",
            "vehicleNo": "",
            "ioTypecd": "E",
            "associatedIntoPassportNo": "YS224922040600789",
            "areainEtpsno": "1070S21113",
            "areainEtpsNm": "上海怡亚通临港供应链有限公司",
            "areainEtpsSccd": "22490202107021113G",
            "rmk": "",
            "easyPassportDt": [
                {
                    "id": "846",
                    "pid": "789",
                    "orgId": "103240",
                    "passportNo": "YS224922040600789",
                    "chgTmsCnt": "0",
                    "gdsSeqno": "2",
                    "gdsNm": "2",
                    "dclQty": "5",
                    "dclUnitcd": "001",
                    "unitName": null,
                    "gdsTypecd": "2",
                    "gdsSpcfModelDesc": null,
                    "rmk": null,
                    "associatedIntoGdsSeqno": "2",
                    "passportUsedQty": "4",
                    "actlPassQty": null,
                    "remainQty": "5",
                    "associatedIntoId": null,
                    "seqNo": "2"
                }
            ]
        }
显示代码
出参
代码示例
详见ReturnInfo：实例如下： 


          {
              "status": "1",
              "note": "登记单暂存成功",
              "description": null,
              "map": {
                  "id": "14"
              }
          }
显示代码

# 17.5、登记单修改接口

接口名称 登记单修改
请求地址 /passport/pass/update
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
id id String M
子账户id orgId String M
登记单编号 passportNo String M
变更次数 chgTmsCnt String
申报类型 dclTypecd String M 1：备案；3：作废
进出标志 ioTypecd String M I：进 E：出
关区代码 masterCuscd String M
区内企业编码 areainEtpsno String M
区内企业名称 areainEtpsNm String M
区内企业社会信用代码 areainEtpsSccd String
车牌号 vehicleNo String M
备注 rmk String M 备注
登记单表体对象 easyPassportDt Object
货物名称 gdsNm String M 当是出区登记单，并且关联了入区登记单，并且货物类型是（2/4/6/7）时，进出区的货物名称必须一致
货物数量 dclQty String M 当是出区登记单，并且关联了入区登记单，并且货物类型是（2/4/6/7）时，货物数量必须小于入区的剩余数量必须一致
计量单位 dclUnitcd String M 当是出区登记单，并且关联了入区登记单，并且货物类型是（2/4/6/7）时，货物数量必须小于入区的剩余数量必须一致
货物、物品类型 gdsTypecd String M 1：区内的基础设施、生产厂房、仓储设施建设过程中所需的机器、设备、基建物资；
2：区内企业和行政管理机构自用的办公用品；
3：区内企业所需的劳保用品；
4：区内企业用于生产加工及设备维护的少量、急用物料；
5：区内企业使用的包装物料；
6：区内企业使用的样品；
7：区内企业生产经营使用的仪器、工具、机器、设备；
8：区内人员所需的生活消费品。
规格型号 gdsSpcfModelDesc String 货物类型选择为第4，7类时，为必填项
备注 rmk String
代码示例


          {
              "id": "181",
              "orgId": "241",
              "passportNo": "ES224919110700181",
              "chgTmsCnt": "0",
              "dclTypecd": "1",
              "ioTypecd": "I",
              "masterCuscd": "2249",
              "areainEtpsno": "2235636794",
              "areainEtpsNm": "东东娱乐有限公司（浦东分公司）",
              "areainEtpsSccd": "123456789012345658",
              "gdsTypecd": "2",
              "dclTime": null,
              "putrecEmapvTime": null,
              "faliureTime": null,
              "vehicleNo": "沪A11101",
              "passTime": null,
              "secdPassTime": null,
              "stucd": null,
              "emapvMarkcd": null,
              "ctrlNo": null,
              "optResult": null,
              "rmk": null,
              "optStatus": "1",
              "customName": "洋山保税",
              "easyPassportDt": [
                  {
                      "id": "241",
                      "pid": "181",
                      "orgId": "241",
                      "passportNo": "ES224919110700181",
                      "chgTmsCnt": "0",
                      "gdsSeqno": "1",
                      "gdsNm": "中性笔",
                      "dclQty": "100.00000",
                      "dclUnitcd": "001",
                      "unitName": null,
                      "gdsTypecd": "2",
                      "gdsSpcfModelDesc": "A-101",
                      "rmk": null
                  }
              ]
          }
显示代码
出参
代码示例
详见ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "登记单修改成功",
              "description": null,
              "map": {
                "id": "14"
              }
            }
显示代码

# 17.6、登记单删除接口

接口名称 登记单删除
请求地址 /passport/pass/delete
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
登记单id bscIds· String M
代码示例


            {
              "bscIds": ["1","2"]
            }
显示代码
出参
代码示例
详见ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "登记单删除成功",
              "description": null,
              "map": {}
            }
显示代码

# 17.7、登记单申报接口

接口名称 登记单确认
请求地址 /passport/pass/declare
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
登记单id bscIds· String M
代码示例


          {
            "bscIds": ["1","2"]
          }
显示代码
出参
代码示例
详见ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": "申报成功",
              "description": null,
              "map": {}
            }
显示代码

# 17.8、登记单作废接口

接口名称 登记单作废
请求地址 /passport/pass/useless
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
登记单id bscIds· String M
代码示例


            {
              "bscIds": ["1","2"]
            }
显示代码
出参
代码示例
详见ReturnInfo，实例如下： 


              {
                "status": "1",
                "note": "作废成功",
                "description": null,
                "map": {}
              }
显示代码

# 17.9、登记单查询列表接口

接口名称 登记单查询列表
请求地址 /passport/pass/getList
请求方式 POST
入参 字段名 属性名 字段类型 是否必填 备注
page page Number M
size size Number M
登记单编号 passportNo String M
进出区方向 ioTypecd String I：进 E：出
操作状态 optStatus String
代码示例


            {
              "page": "1",
              "size":"10",
              "passportNo":"ES224919110700181",
              "ioTypecd":"I",
              "optStatus":"1"
            }
显示代码
出参
代码示例
详见ReturnInfo，实例如下： 


            {
              "status": "1",
              "note": null,
              "description": null,
              "map": {
                  "data": {
                      "totalPages": 4,
                      "totalElements": 32,
                      "last": false,
                      "sort": null,
                      "first": true,
                      "numberOfElements": 10,
                      "size": 10,
                      "content": [
                          {
                              "id": "181",
                              "orgId": "241",
                              "passportNo": "ES224919110700181",
                              "chgTmsCnt": "0",
                              "dclTypecd": "1",
                              "ioTypecd": "I",
                              "masterCuscd": "2249",
                              "areainEtpsno": "2235636794",
                              "areainEtpsNm": "东东娱乐有限公司（浦东分公司）",
                              "areainEtpsSccd": "123456789012345658",
                              "gdsTypecd": "2",
                              "dclTime": null,
                              "putrecEmapvTime": null,
                              "faliureTime": null,
                              "vehicleNo": "沪A11101",
                              "passTime": null,
                              "secdPassTime": null,
                              "stucd": null,
                              "emapvMarkcd": null,
                              "ctrlNo": null,
                              "optResult": null,
                              "rmk": null,
                              "optStatus": "1",
                              "customName": "洋山保税",
                              "easyPassportDt": [],
                              "easyPassportStatus": []
                          }
                      ],
                      "number": 0
                  }
              }
          }
显示代码

# 17.10、登记单查询详情接口

接口名称 登记单查询详情
请求地址 /passport/pass/getDetail
请求方式 POST
入参 字段名 属性名 字段类型 是否必填
登记单id id String M
代码示例


          {
            "id": "181"
          }
显示代码
出参
代码示例
详见ReturnInfo，实例如下： 


              {
                  "status": "1",
                  "note": "查询成功",
                  "description": null,
                  "map": {
                      "data": {
                          "id": "181",
                          "orgId": "241",
                          "passportNo": "ES224919110700181",
                          "chgTmsCnt": "0",
                          "dclTypecd": "1",
                          "ioTypecd": "I",
                          "masterCuscd": "2249",
                          "areainEtpsno": "2235636794",
                          "areainEtpsNm": "东东娱乐有限公司（浦东分公司）",
                          "areainEtpsSccd": "123456789012345658",
                          "gdsTypecd": "2",
                          "dclTime": null,
                          "putrecEmapvTime": null,
                          "faliureTime": null,
                          "vehicleNo": "沪A11101",
                          "passTime": null,
                          "secdPassTime": null,
                          "stucd": null,
                          "emapvMarkcd": null,
                          "ctrlNo": null,
                          "optResult": null,
                          "rmk": null,
                          "optStatus": "1",
                          "customName": "洋山保税",
                          "easyPassportDt": [
                              {
                                  "id": "242",
                                  "pid": "181",
                                  "orgId": "241",
                                  "passportNo": "ES224919110700181",
                                  "chgTmsCnt": "0",
                                  "gdsSeqno": "1",
                                  "gdsNm": "中性笔",
                                  "dclQty": "100.00000",
                                  "dclUnitcd": "001",
                                  "unitName": null,
                                  "gdsTypecd": "2",
                                  "gdsSpcfModelDesc": "A-101",
                                  "rmk": null
                              }
                          ],
                          "easyPassportStatus": [
                              {
                                  "id": "621",
                                  "pid": "181",
                                  "createTime": "2019-11-07 17:15:24",
                                  "optStatus": "1",
                                  "optUserId": "263",
                                  "optUserName": "ddHappy1",
                                  "optTime": "2019-11-07 17:15:24",
                                  "remark": "暂存成功",
                                  "fileName": null
                              }
                          ]
                      }
                  }
              }
显示代码

# 18、状态列表

业务模块 单证状态 中文描述 备注
进出区提发货 1 暂存
3 海关入库
4 海关入库失败
5 审核通过
6 审核拒绝
8 比对退单
15 确认中
17 转人工
18 已确认
40 确认收货
95 作废确认
96 已作废
99 删除
101 出入库添加
102 出入库同步
103 出入库删除
47 出入库入库成功
48 出入库入库失败
业务模块 单证状态 中文描述备注 备注
卡口核放凭证 1 暂存
4 海关入库失败
5 审核通过
6 审核拒绝
15 确认中
17 转人工
18 已确认
50 未过卡
51 已过卡
52 拒绝过卡
53 卡口放行
61 校验中
62 校验失败
63 校验通过
95 作废确认
96 已作废
99 删除
100 海关删除
101 出入库信息新增
102 出入库信息同步
103 出入库信息删除
104 已委托
105 取消委托
106 绑定装车单
业务模块 单证状态 中文描述备注 备注
进境径予放行自主声明 1 暂存
3 海关入库成功
4 海关入库失败
5 审核通过
6 审核拒绝
16 待自动审核
17 待审核
18 已申报
19 待自动审核
96 已作废
99 删除
104 更新过卡时间
业务模块 单证状态 中文描述备注 备注
出境径予放行自主声明 1 暂存
3 海关入库成功
4 海关入库失败
5 审核通过
6 审核拒绝
15 确认中
17 待审核
18 已申报
27 退关未入库
29 退关删除
96 已作废
99 删除
104 更新过卡时间
业务模块 单证状态 中文描述备注 备注
总担保 1 暂存
3 海关入库成功
4 海关入库失败
5 审核通过
6 审核拒绝
17 待审核
18 已申报
99 删除
业务模块 单证状态 中文描述备注 备注
业务申报表 1 暂存
3 海关入库
4 海关入库失败
5 审核通过
6 审核拒绝
17 转人工
18 已申报
96 作废
99 删除
业务模块 单证状态 中文描述备注 备注
耗料单 1 暂存
3 海关入库
4 海关入库失败
5 审核通过
6 审核拒绝
15 确认中
17 转人工
18 已申报
96 作废
业务模块 单证状态 中文描述备注 备注
装车单 1 暂存
3 海关入库
4 海关入库失败
5 审核通过
6 审核拒绝
17 转人工
18 已申报
51 已过卡
52 拒绝过卡
95 作废申报
96 作废
99 删除
业务模块 单证状态 中文描述备注 备注
企业资质 1 暂存
3 海关入库
4 海关入库失败
5 审核通过
6 审核拒绝
17 转人工
18 已申报
96 作废
99 删除
202 暂停
业务模块 单证状态 中文描述备注 备注
子账户 1 暂存
3 海关入库
4 海关入库失败
5 审核通过
6 审核拒绝
17 转人工
18 已申报
96 作废
99 删除
业务模块 单证状态 中文描述备注 备注
场地备案 1 暂存
3 海关入库
4 海关入库失败
5 审核通过
6 审核拒绝
17 转人工
18 已申报
96 作废
99 删除
业务模块 单证状态 中文描述备注 备注
便捷进出区 1 暂存
3 海关入库
4 海关入库失败
5 审核通过
6 审核拒绝
17 转人工
18 已申报
50 未过卡
51 已过卡
52 拒绝过卡
53 卡口放行
54 正在过卡
70 已失效
95 作废申报
96 作废
99 删除
100 海关删除

# 19、版本变更说明

# 19.1、V1.1版本变更

1、增加便捷进出区接口信息规范

# 19.2、V1.2版本变更

1、进出区提发货表体信息新增字段：法定数量、法定单位，且为必填。且会在申报接口时对其进行必填校验。
2、卡口验放凭证表体信息的法定数量、法定单位在出入库类型为分送集报时必填。且会在申报接口时对其进行必填校验。

# 19.3、V1.3版本变更

1、装车单新增作废申报接口。

# 19.4、V1.4版本变更

1、进出区提发货凭证、卡口验放凭证、耗料单关于料件成品标志字段补充类型说明。

# 19.5、V1.5版本变更

1、卡口验放凭证 增加业务类型：24（便捷汽车出口）暂存，该类型暂存时：需要对VIN码汇总信息必填。 表头信息暂存需要增加 出境数量字段（必填），查询列表时：可以根据VIN字段关联查询。 注：表头的出境数量=表体的申报数量之和=VIN码总条数

# 19.6、V1.6版本变更

1、径予进境基本信息新增“木质包装字段”

# 19.7、V1.7版本变更

1、修改一司两地类型卡口验放单证时，出区方向的关联单证编号必填

# 19.8、V1.8版本变更

1、子账户新增、子账户修改接口入参新增“区域”必填字段

# 19.9、V1.9版本变更

1、业务申报新增“延期接口”

# 19.10、V2.0版本变更

1、便捷进出区暂存与修改接口变更：便捷进出区 出区登记单的货物类型为（2/4/6/7）时，可以关联入区登记单，也可以选择不关联。如果出区登记单关联了入区登记单，则出区登记单表体的货物名称、货物类型、计量单位必须与入区登记单保持一致。并且出区登记单表体的货物数量必须小于入区的对应表体的剩余数量。

# 19.11、V2.1版本变更

1、径予进出境暂存接口表头新增进出口岸字段
2、增加分送集报退运暂存与修改接口

# 19.12、V2.2版本变更

1、在进出区提发货接口信息列表章节中添加了报关单相关接口，详见第8.19~第8.22接口。
2、增加8.7报关行关系表。
3、在8.1进出区提发货基本信息中新增报关行企业名称、报关行企业编码。
4、在8.8、暂存/修改接口中新增入参：报关行企业名称、报关行企业编码。

# 19.13、V2.3版本变更

1、在6.1进境径予中 危禁品确认标志hazardousConfirm字段修改为必填项
2、在8.2进出区提发货表体信息中，增加危化品标志字段：0-否，1-是。
3、在进出区提发货凭证8.8、暂存/修改接口，入参的表体中增加危化品标志字段：0-否，1-是。
4、在进出区提发货凭证接口信息列表中的明细查询接口、表体查询接口，返参的表体中增加危化品标志字段productCharCode。

# 19.14、V2.4版本变更

1、 对9.9卡口验放凭证查询列表历史版本接口，入参字段进行改正（ieTyped 改成 ieTypecd； vechicleNo 改成 vehicleNo）
2、 对13.5场地备案查询列表历史版本接口，入参重复字段（address 、optStatus）去除。

# 19.15、V2.5版本变更

1、 对3.1接口环境地址中的生产环境IP地址进行了变更。
      原：https://newportal.lgxc.gov.cn
      新：https://newportal.lingang.gov.cn:2443
2、8.1进出区提发货凭证基本信息中的子账户id增加注释：修改必填

# 19.16、V2.6版本变更

1、增加17.便捷进出区信息列表增加字段长度说明
2、增加17.4登记单暂存接口入参增加说明

# 19.17、V2.7版本变更

1、增加14.5,14.5装车单暂存、修改接口入参说明
2、14.5,14.5装车单暂存、修改绑定单证逻辑修改
3、14.8装车单列表查询接口新增子账户多选查询条件，不传和之前查询保持一致

# 19.18、V2.8版本变更

1、8.10提发货列表查询接口/wareHouse/getList新增查询条件whSeqNo字段，支持模糊查询，返回结果新增whSeqNo字段（WareHouseBsc新增）。
2、8.11提发货明细查询接口/wareHouse/getBscDetails返回结果新增whSeqNo字段（WareHouseBsc新增）。
3、16.1子账户新增/org/saveOrg和子账户修改/org/updateOrg账号类型type新增29-保税展品，30-保税国际中转

# 19.19、V2.9版本变更

1、9.1卡口验放凭证表头新增字段goodsArrived（已进入待检区域）。
2、9.1卡口验放凭证表头新增inExpType（出入库类型）字段枚举值11-配套货物、13-保税区内直转
3、9.7卡口验放凭证暂存/修改接口/portRelease/save新增入参goodsArrived字段
4、8.1提发货凭证表头新增inExpType（出入库类型）字段枚举值11-配套货物、12-配套货物区内直转、13-保税区内直转。

← 企业数据对接接口规范 →