一、3201-小文件批量上传

1. 接口功能

​ 批量上传小文件,单个文件大小不超过2M,文件数量不超过5个。图片支持 jpg 、png格式(不支持手动修改图片后缀) 。文件存储ID(FileID)对应需调用3201的其他接口中的上传照片ID(UploadFileID)。

2. 报文结构

​ 请求报文:

报文元素 出现要求 非空约束 数据格式 说明
TxCode R NOT NULL N1..4 交易类型
InstitutionID R NOT NULL ANS1..8 机构编号
TxSN R NOT NULL ANS1..32 交易流水号
Files FileName R NOT NULL ANS1..256 文件名称
例如: img_best.jpg
FileContent R NOT NULL ANS1.. 文件内容 Base64
Remark O ANS0..256 备注

​ 响应报文:

报文元素 出现要求 非空约束 数据格式 说明
Code R NOT NULL N1..6 响应代码
Message R NOT NULL ANS1..256 响应消息
TxCode C ANS1..4 交易类型
InstitutionID C ANS1..8 机构号
TxSN C ANS1..32 交易流水号
TraceNo C ANS1..32 系统跟踪号
Files FileName C ANS1..256 文件名称
FileID C ANS1..32 文件存储ID

二、4030-营业执照ocr

1. 接口功能

​ 解析营业执照照片信息。需要将图片先通过3201接口上传到服务器,然后再发送4030验证请求。上传照片ID(UploadFileID)对应3201接口响应的FileID。(接口时序图:ocr接口介绍

2. 报文结构

​ 请求报文:

报文元素 出现要求 非空约束 数据格式 说明
TxCode R NOT NULL N1..4 交易类型
InstitutionID R NOT NULL ANS1..8 机构编号
TxSN R NOT NULL ANS1..32 交易流水号
UploadFileID R NOT NULL ANS1..32 上传照片ID
Remark O ANS0..64 备注

​ 响应报文:

报文元素 出现要求 非空约束 数据格式 说明
Code R NOT NULL N1..6 响应代码
Message R NOT NULL ANS1..256 响应消息
TxCode C NOT NULL ANS1..4 交易类型
InstitutionID C NOT NULL ANS1..8 机构编号
TxSN C NOT NULL ANS1..32 交易流水号
TraceNo C NOT NULL ANS1..32 交易跟踪号
ResponseCode C NOT NULL N0..4 通道响应代码
ResponseMessage C NOT NULL ANS0..256 通道响应消息
LicenseType C NOT NULL ANS0..100 执照类型
CompanyName C NOT NULL ANS0..256 公司名称
CompanyType C NOT NULL ANS0..300 公司类型
Address C NOT NULL ANS0..2000 住所
RegistrationCode C NOT NULL ANS0..100 注册号
SerialNumber C NOT NULL ANS0..100 证照编号
LrName C NOT NULL ANS0..192 法人姓名
RegisteredCapital C NOT NULL NS0..32 注册资本
PaidinCapital C NOT NULL NS0..32 实收资本
Scope C NOT NULL ANS0.. 经营范围
StartTime C NOT NULL YYYYMMDD 成立日期
OperatingPeriod C NOT NULL YYYYMMDD 营业期限
UniformSocialCreditCode C NOT NULL ANS0..32 统一社会信用代码

三、报文样例

[!TIP] (测试数据不校验数据真实性,默认为验证结果为匹配,若验证其他结果,可查看“总体规范-6.1.2.4 Remark 备注”)

​ 3201-文件上传接口请求地址与ocr接口不同,需注意接口地址,具体可查看ocr交易地址

1.3201报文样例

请求报文(InstitutionID由中金分配):

{
    "TxCode":"3201",
    "InstitutionID":"XXXXXX",
    "TxSN":"202301161632415618763945679",
    "Files":[
        {
            "FileContent":"iVBORw0KGg......5ErkJggg==",
            "FileName":"1.png"
        }
    ],
    "Remark":""
}

响应报文:

{
    "TxCode":"3201",
    "Message":"SUCCESS",
    "InstitutionID":"XXXXXX",
    "TxSN":"202301161632415618763945679",
    "Files":[
        {
            "FileName":"1.png",
            "FileID":"2301161636264863917961152"
        }
    ],
    "Code":"2000",
    "TraceNo":"2301161636262801312017612"
}

2.4030报文样例

请求报文(InstitutionID由中金分配):

{
    "TxCode":"4030",
    "InstitutionID":"XXXXXX",
    "TxSN":"202301170951500793252669539",
    "UploadFileID":"2301161636264863917961152",(3201接口返回)
    "Remark":""
}

响应报文:

{
    "PaidinCapital":"",
    "ResponseCode":"1000",
    "TxCode":"4030",
    "Address":"北京市西城区平原里小区20号楼1-7.1-9.1-10",
    "Message":"SUCCESS",
    "InstitutionID":"XXXXXX",
    "RegistrationCode":"",
    "StartTime":"2010年02月04日",
    "LrName":"季小杰",
    "CompanyType":"有限责任公司法人独资",
    "ResponseMessage":"查询成功",
    "Code":"2000",
    "LicenseType":"营业执照3",
    "CompanyName":"中金支付有限公司",
    "RegisteredCapital":"10000万元",
    "UniformSocialCreditCode":"91110102551443078Q",
    "Scope":"互联网支付(支付业务许可证有效期至2021年12月21日);技术开发;技术服务;技术推广;技术咨询。(企业依法自主选择经营项目,开展经营活动;互联网支付以及依法须经批准的项目,经相关部门批准后依批准的内容开展经营活动;不得从事本市产业政策禁止和限制类项目的经营活动。)",
    "SerialNumber":"",
    "OperatingPeriod":"2010年02月04日至2030年02月03日",
    "TxSN":"202301170951500793252669539",
    "TraceNo":"2301170955383001112011952"
}

该文档未解决您的疑问?png 查看常见问题

Copyright © China Financial Digital Technology Co., Ltd. all right reserved,powered by Gitbook该文章修订时间: 2024-04-12 15:00:31

results matching ""

    No results matching ""