开放平台API
  1. 海关数据
开放平台API
  • 海关数据
    • 出口报关单获取接口
      POST
    • 进口报关单获取接口
      POST
    • 进口税单获取接口
      POST
    • 保证金获取接口
      POST
    • 海关编码获取接口
      POST
    • 退税商品编码获取接口
      POST
    • 下载任务状态查询
      POST
  • 进项数据
    • 进项发票获取接口
      POST
    • 进项发票查验接口
      POST
    • 进项异常发票获取接口
      POST
    • 进项票据OCR识别接口
      POST
  • 销项数据
    • 销项发票申请接口
      POST
    • 销项发票获取接口
      POST
    • 销项发票红冲接口
      POST
    • 销项发票作废接口
      POST
    • 记账凭证回推接口-XINVOICE.DBACK
      POST
  • 退税数据
    • 生产企业
    • 外贸企业
      • 退税申报批次-汇总数据申请下载接口
      • 退税申报批次-汇总数据查询(下载完成后调用)
      • 自检状态查询
    • 退税申报批次申请下载接口
      POST
    • 退税申报批次数据获取接口
      POST
    • 已申报批次基本信息获取接口
      POST
  • 企业数据
    • 企业信息获取接口
      POST
    • 是否一般纳税人查询接口
      POST
    • 税局违法企业获取接口
      POST
    • 企业财税数据获取接口
      POST
    • 企业开通申请接口
      POST
    • 企业开通申请结果获取接口
      POST
    • 企业备案信息申请下载接口
      POST
    • 企业备案信息结果获取接口
      POST
    • 企业开通申请接口WEB版
      POST
    • 渠道关联企业-续期接口WEB版
      POST
  • 开票服务
    • 登录电票平台接口
    • 获取是否需要人脸识别接口
    • 获取人脸识别二维码接口
  • 其他数据服务
    • 汇率查询
  1. 海关数据

进口报关单获取接口

POST
/post/rest/inmanifest/dii
此接口支持获取外贸企业自身的进口报关单数据(含:报关单的进口日期,报关单号,申报日期,合同协议号,境内收发货人,境外收发货人名称,申报单位,提运单号,监管方式,运保杂费,随附单证,集装箱,报关回执等信息),帮助外贸企业实时拿到进口关单数据,提升工作效率,同时规避申报数据错误的风险。

请求参数

Header 参数
Content-Type
string 
可选
示例值:
application/json
Body 参数application/json
authorize
object 
安全凭证
必需
appSecId
string 
密钥ID
必需
平台随机生成
appSec
string 
签名串
必需
根据密钥ID和KEY生成的签名串
globalInfo
object 
接口信息
必需
appId
string 
接口ID
必需
例:CKBGD
version
string 
接口版本号
必需
例:V1.0
interfaceCode
string 
接口编码
必需
例:MANIFEST.MGET
enterpriseCode
string 
企业编码
必需
dataExchangeId
string 
接口数据加密
必需
例:默认值dataExchangeId
data
object 
获取条件参数
必需
由获取条件参数通过用Base64加密生成的字符串
bgdNo
string 
报关单号
可选
cusDecStatus
string 
报关单状态
可选
例:1-保存 2-已申报 3-预录入接收失败 4-海关入库成功 5-海关入库失败 6-退单 7-审结 8-删单 9-放行 10-结关 11-查验通知
endDate
string 
进口结束日期
可选
格式:yyyy-MM-dd
flag
string 
数据类型
可选
条件判断 1:结关(startDate,endDate,条件必填) 2:未结关 3:全部(startDate,endDate条件必填)
optStartDate
string 
最新操作开始日期
可选
格式:yyyy-MM-dd
optEndDate
string 
最新操作结束日期
可选
格式:yyyy-MM-dd
preEntryId
string 
报关单预录入号
可选
pageSize
integer 
页数
必需
默认10条
page
integer 
当前第几页
必需
默认从1开始
startDate
string 
进口开始日期
可选
格式:yyyy-MM-dd
spDecSeqNo
string 
统一编号
可选
hgOpStartDate
string 
海关最新操作开始时间
可选
hgOpEndDate
string 
海关最新操作结束时间
可选
示例
{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE9794575EDF88CEF1B",
        "appSec": "/TGkBMNXDu05PiV2jlnANcpo2dw="
    },
    "globalInfo": {
        "appId": "JKBGD",
        "version": "V1.0",
        "interfaceCode": "INMANIFEST.MGET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzdGFydERhdGUiOiIiLCJlbmREYXRlIjoiIiwicGFnZSI6MTEsInBhZ2VTaXplIjoxMCwiY3VzRGVjU3RhdHVzIjoiIiwib3B0U3RhcnREYXRlIjoiMjAyMC0wOS0yMSIsIm9wdEVuZERhdGUiOiIyMDIxLTAyLTE4IiwiZmxhZyI6IiIsImJnZE5vIjoiIn0="
}


//加密的获取参数
{
    "startDate": "",
    "endDate": "",
    "page": 1,
    "pageSize": 10,
    "cusDecStatus": "",
    "optStartDate": "2020-09-21",
    "optEndDate": "2021-02-18",
    "flag": "",
    "bgdNo": "",
    "hgOpStartDate":"",
    "hgOpEndDate":""
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://117.78.0.163/51GP/post/rest/inmanifest/dii' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE9794575EDF88CEF1B",
        "appSec": "/TGkBMNXDu05PiV2jlnANcpo2dw="
    },
    "globalInfo": {
        "appId": "JKBGD",
        "version": "V1.0",
        "interfaceCode": "INMANIFEST.MGET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzdGFydERhdGUiOiIiLCJlbmREYXRlIjoiIiwicGFnZSI6MTEsInBhZ2VTaXplIjoxMCwiY3VzRGVjU3RhdHVzIjoiIiwib3B0U3RhcnREYXRlIjoiMjAyMC0wOS0yMSIsIm9wdEVuZERhdGUiOiIyMDIxLTAyLTE4IiwiZmxhZyI6IiIsImJnZE5vIjoiIn0="
}


//加密的获取参数
{
    "startDate": "",
    "endDate": "",
    "page": 1,
    "pageSize": 10,
    "cusDecStatus": "",
    "optStartDate": "2020-09-21",
    "optEndDate": "2021-02-18",
    "flag": "",
    "bgdNo": "",
    "hgOpStartDate":"",
    "hgOpEndDate":""
}'

返回响应

🟢200成功
application/json
Body
data
object 
返回参数
必需
由返回的参数通过用Base64加密生成的字符串
totalRows
integer 
数据的总条数
必需
currentRows
integer 
当前返回条数
必需
result
array [object {123}] 
报关单列表数据
可选
returnStateInfo
object 
接口状态信息
必需
returnCode
string 
返回状态编码
必需
例:0000
returnMessage
string 
返回信息
必需
例:处理成功
示例
{
    "data": "eyJ0b3RhbFJvd3MiOjMwNTMsImN1cnJlbnRSb3dzIjoxMCwicmVz...",
    "returnStateInfo": {
        "returnCode": "0000",
        "returnMessage": "处理成功"
    }
}

//data加密前的数据
{
    "totalRows": 1,
    "currentRows": 1,
    "result": [
        {
            "agentCode": "4419986606",
            "agentName": "东莞市铂逸报关报检有限公司",
            "agentScc": "91441900303830466R",
            "appCertCode": " ",
            "appCertName": " ",
            "attaDocuCds": [
                
            ],
            "attaDocuCdstr": "Y,O",
            "billNo": "CULKHH20018675",
            "bonNo": " ",
            "ciqBillNo": " ",
            "ciqEntyPortCode": "441914",
            "ciqEntyPortCodeName": "东莞虎门港7、8号泊位",
            "consigneeCname": "江苏舜天国际集团机械进出口有限公司",
            "consigneeCode": "3201000071",
            "consignorCode": " ",
            "consignorEname": "TONGTAI MACHINE & TOOL CO.,LTD",
            "contaCount": "2",
            "containers": [
                {
                    "goodsNo": "1,2",
                    "containerNo": "CICU9660362",
                    "contSeqNo": "1",
                    "lclFlag": null,
                    "lclFlagName": null,
                    "cusCiqNo": "I20200000520666235",
                    "containerMdCode": "11",
                    "containerMdCodeName": "普通2*标准箱(L)",
                    "containerWt": null
                }
            ],
            "contrNo": "20MCD(01)-0551957TW/20MCD(01)-05",
            "correlationDeclNo": " ",
            "correlationReasonFlag": " ",
            "correlationReasonFlagName": " ",
            "cusCiqNo": "I20200000520666235",
            "cusDecStatus": "10",
            "cusDecStatusName": "结关",
            "cusRemark": "1000000000000",
            "cusTradeCountry": "TWN",
            "cusTradeCountryName": "中国台湾",
            "cusTradeNationCode": "TWN",
            "cusTradeNationCodeName": "中国台湾",
            "cusTrafMode": "2",
            "cusTrafModeName": "水路运输",
            "cusVoyageNo": "2044W",
            "customMaster": "5216",
            "customMasterName": "沙田海关",
            "customsField": "5250",
            "customsFieldName": "78号泊位",
            "cutMode": "101",
            "cutModeName": "一般征税",
            "dDate": "2020-11-05",
            "decOtherPacksVo": " ",
            "declRegNo": "4400910751",
            "despDate": "2020-11-04",
            "despPortCode": "TWN128",
            "despPortCodeName": "高雄(中国台湾)",
            "detailList": [
                {
                    "bgdNo": "521620201160036580001",
                    "ciqCode": "999",
                    "ciqDestCode": "440306",
                    "ciqDestCodeName": "深圳市宝安区",
                    "ciqName": "切削金属的其他数控钻床(但品目8458的车床除外)",
                    "codeTs": "8459210000",
                    "contrItem": " ",
                    "cusOriginCountry": "TWN",
                    "cusOriginCountryName": "中国台湾",
                    "declPrice": 379203,
                    "declTotal": 379203,
                    "destinationCountry": "CHN",
                    "destinationCountryName": "中国",
                    "districtCode": "44031",
                    "districtCodeName": "深圳特区",
                    "dutyMode": "1",
                    "dutyModeName": "照章征税",
                    "exgNo": " ",
                    "exgVersion": " ",
                    "gModel": "4|3|用途:用于金属板上的钻孔的机器|功能:钻孔|控制方式:数控|品牌:TONGTAI|型号:SD-220|数控系统原产地:台湾|||控制系统品牌:SIEB&MEYER 西伯麦亚/控制系统的型号:CNC 84",
                    "gName": "数控钻床",
                    "gNo": "1",
                    "gQty": 1,
                    "gUnit": "001",
                    "gUnitName": "台",
                    "goodsAttr": "19",
                    "goodsAttrName": " ",
                    "inspGoodsLicenceInfo": " ",
                    "inspGoodsTarget": " ",
                    "origPlaceCode": " ",
                    "origPlaceCodeName": " ",
                    "pId": "b60c5454d2754fb0bc5503c67e3e6aae",
                    "preDecCiqGoodsLimit": " ",
                    "purpose": "26",
                    "purposeName": "仅工业用途     ",
                    "qty1": 1,
                    "qty2": 4465,
                    "rmbPrice": 379203,
                    "tradeCurr": "CNY",
                    "tradeCurrName": "人民币",
                    "unit1": "001",
                    "unit1Name": "台",
                    "unit2": "035",
                    "unit2Name": "千克",
                    "usdPrice": 56433.22
                },
                {
                    "bgdNo": "521620201160036580002",
                    "ciqCode": "999",
                    "ciqDestCode": "440306",
                    "ciqDestCodeName": "深圳市宝安区",
                    "ciqName": "切削金属的其他数控钻床(但品目8458的车床除外)",
                    "codeTs": "8459210000",
                    "contrItem": " ",
                    "cusOriginCountry": "TWN",
                    "cusOriginCountryName": "中国台湾",
                    "declPrice": 643362,
                    "declTotal": 643362,
                    "destinationCountry": "CHN",
                    "destinationCountryName": "中国",
                    "districtCode": "44031",
                    "districtCodeName": "深圳特区",
                    "dutyMode": "1",
                    "dutyModeName": "照章征税",
                    "exgNo": " ",
                    "exgVersion": " ",
                    "gModel": "4|3|用途:用于金属板上的钻孔的机器|功能:钻孔|控制方式:数控|品牌:TONGTAI|型号:SD-620|数控系统原产地:台湾|||控制系统品牌:SIEB&MEYER 西伯麦亚/控制系统的型号:CNC 84",
                    "gName": "数控钻床",
                    "gNo": "2",
                    "gQty": 1,
                    "gUnit": "001",
                    "gUnitName": "台",
                    "goodsAttr": "19",
                    "goodsAttrName": " ",
                    "inspGoodsLicenceInfo": " ",
                    "inspGoodsTarget": " ",
                    "origPlaceCode": " ",
                    "origPlaceCodeName": " ",
                    "pId": "b60c5454d2754fb0bc5503c67e3e6aae",
                    "preDecCiqGoodsLimit": " ",
                    "purpose": "26",
                    "purposeName": "仅工业用途     ",
                    "qty1": 1,
                    "qty2": 11908,
                    "rmbPrice": 643362,
                    "tradeCurr": "CNY",
                    "tradeCurrName": "人民币",
                    "unit1": "001",
                    "unit1Name": "台",
                    "unit2": "035",
                    "unit2Name": "千克",
                    "usdPrice": 95745.52
                }
            ],
            "distinatePort": "TWN128",
            "distinatePortName": "高雄(中国台湾)",
            "entQualifNo": " ",
            "entryId": "521620201160036580",
            "entryType": "M",
            "entryTypeName": "通关无纸化",
            "feeCurr": "",
            "feeCurrName": " ",
            "feeMark": " ",
            "feeMarkName": " ",
            "feeRate": 0,
            "feeUsdAmt": 0,
            "goodsPlace": "东莞虎门港7、8号泊位",
            "grossWt": 17603,
            "iEDate": "2020-11-06",
            "iEPort": "5216",
            "iEPortName": "沙田海关",
            "id": "b60c5454d2754fb0bc5503c67e3e6aae",
            "inDbTime": " ",
            "inspOrgCode": "566600",
            "inspOrgCodeName": "沙田海关本部",
            "insurCurr": "",
            "insurCurrName": " ",
            "insurMark": " ",
            "insurMarkName": " ",
            "insurRate": 0,
            "insurUsdAmt": 0,
            "licenseNo": " ",
            "manualNo": " ",
            "markNo": "N/M",
            "netWt": 16373,
            "newFlag": "Y",
            "noteS": "[装卸口岸]78号泊位 T/T 包装:木托盘,纸箱 境内收货人AEO认证编号:(134762588001) 厂家:东台精机股份有限公司 原理:利用高转速主轴夹头夹持钻孔刀具高速旋转,由CNC数控电脑系统,控制机台移动,达成金属板钻孔功能20201012签约 合同号:20MCD(01)-0551957TW/20MCD(01)-0551956TW",
            "orgCode": "566600",
            "orgCodeName": "沙田海关本部",
            "origBoxFlag": " ",
            "origBoxFlagName": " ",
            "otherCurr": "CNY",
            "otherCurrName": "人民币",
            "otherMark": "3",
            "otherMarkName": "总价",
            "otherRate": 3200,
            "otherUsdAmt": 476.23,
            "ownerCiqCode": " ",
            "ownerCode": "4403006729",
            "ownerName": "深圳市快捷电子科技有限公司",
            "ownerScc": "91440300672981585X",
            "packNo": "2",
            "preDecEntQualifListVo": " ",
            "preDecRequCertList": " ",
            "preDecUserList": " ",
            "preEntryId": "521620201160036580",
            "promiseItems": "000",
            "purpOrgCode": "566600",
            "purpOrgCodeName": "沙田海关本部",
            "rcvgdTradeCode": "3201919018",
            "rcvgdTradeScc": "91320000134762588N",
            "receipts": [
                {
                    "note": ";报关单放行",
                    "iEDate": "2020-11-06",
                    "dDate": "2020-11-05",
                    "noticeDate": "2020-11-06 08:37:34",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003220793275",
                    "channel": "P",
                    "channelName": "海关已放行",
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": "521620201160036580"
                },
                {
                    "note": "结关;报关单结关",
                    "iEDate": "2020-11-06",
                    "dDate": "2020-11-05",
                    "noticeDate": "2020-11-06 08:37:34",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003220793459",
                    "channel": "R",
                    "channelName": "海关已结关",
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": "521620201160036580"
                },
                {
                    "note": "检验检疫编号:[120000007424981]已检验检疫合格,请您与【沙田海关本部】签证部门联系通关证或换证凭单等放行相关事宜,联系电话:。特别提示:请凭检验检疫编号120000007424981办理报关。",
                    "iEDate": "2020-11-06",
                    "dDate": "2020-11-05",
                    "noticeDate": "2020-11-05 14:42:26",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003218550275",
                    "channel": "S",
                    "channelName": null,
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": "521620201160036580"
                },
                {
                    "note": "检验检疫编号:[120000007424981]已检验检疫合格,请您与【沙田海关本部】签证部门联系通关证或换证凭单等放行相关事宜,联系电话:。特别提示:请凭检验检疫编号120000007424981办理报关。",
                    "iEDate": "2020-11-06",
                    "dDate": "2020-11-05",
                    "noticeDate": "2020-11-05 14:42:26",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003218551521",
                    "channel": "S",
                    "channelName": null,
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": "521620201160036580"
                },
                {
                    "note": "检验检疫编号:[120000007424981]已正式受理通过。申请日期:2020-11-05 14:42:24。。特别提示:请凭检验检疫编号120000007424981办理报关。",
                    "iEDate": "2020-11-06",
                    "dDate": "2020-11-05",
                    "noticeDate": "2020-11-05 14:42:25",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003218550951",
                    "channel": "d",
                    "channelName": "检务受理",
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": "521620201160036580"
                },
                {
                    "note": "上传自动进口许可证",
                    "iEDate": null,
                    "dDate": null,
                    "noticeDate": "2020-11-05 11:53:49",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003217589103",
                    "channel": "N",
                    "channelName": "补传随附单证电子数据",
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": "521620201160036580"
                },
                {
                    "note": ";,,(适用自报自缴);。特别提示:请凭检验检疫编号120000007424981办理报关。",
                    "iEDate": "2020-11-06",
                    "dDate": "2020-11-05",
                    "noticeDate": "2020-11-05 11:18:38",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003217331379",
                    "channel": "J",
                    "channelName": "通关无纸化审结",
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": "521620201160036580"
                },
                {
                    "note": "申请检验检疫成功!(进口)统一编号/(出口)检验检疫申请号【I20200000520666235/566600120054233E】,已成功接收数据,待审单。",
                    "iEDate": null,
                    "dDate": "2020-11-05",
                    "noticeDate": "2020-11-05 11:18:17",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003217328341",
                    "channel": "b",
                    "channelName": "已发检验检疫审核",
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": null
                },
                {
                    "note": "成功入海关预录入库;",
                    "iEDate": "2020-11-06",
                    "dDate": "2020-11-05",
                    "noticeDate": "2020-11-05 10:46:10",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003217075161",
                    "channel": "L",
                    "channelName": "海关入库成功",
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": "521620201160036580"
                },
                {
                    "note": "I20200000520666235直接申报成功",
                    "iEDate": null,
                    "dDate": null,
                    "noticeDate": "2020-11-05 10:45:51",
                    "cusCiqNo": "I20200000520666235",
                    "cusRetSeqNo": "202000003217071767",
                    "channel": "7",
                    "channelName": "申报到海关预录入系统成功",
                    "spDecSeqNo": "I20200000520666235",
                    "entryId": null
                }
            ],
            "relManNo": " ",
            "relativeId": " ",
            "rmbAmt": 1022565,
            "rn": 0,
            "sjly": "2",
            "spDecSeqNo": "I20200000520666235",
            "specDeclFlag": "0000",
            "supvModeCdde": "0110",
            "supvModeCddeName": "一般贸易",
            "trafName": "OSG BOSSTEC",
            "transMode": "1",
            "transModeName": "CIF",
            "usdAmt": 152178.74,
            "vsaOrgCode": "566600",
            "vsaOrgCodeName": "沙田海关本部",
            "wrapType": "93",
            "wrapTypeName": "天然木托"
        } 
    ]
}
修改于 2025-04-18 06:02:32
上一页
出口报关单获取接口
下一页
进口税单获取接口
Built with