广东农信信贷系统服务接口规范说明书_V1.0..docx

广东省农村信用合作社信贷业务管理系统接入服务接口规范广东省农村信用合作社联合社编写说明标题：网络中心接口规范类别：技术版本历史：版本作者日期备注V1.0.0魏磊2014/9/02创建1. 引言1.1. 编写目的本文档为广东省农村信用合作社信贷业务系统与佛山小企业系统间的数据交互接口规范。针对佛山小企业系统，省信贷系统发布了业务信息同步服务、核心系统MQ通知信息查询服务。该文档描述且用于规范信息同步、通知查询服务的接口交互规范，用于省信贷系统、前置系统、佛山小企业系统开发接口交互应用。本文档由广东农村信用合作社信贷业务管理系统项目组编写，在实施过程可能会做相应的调整。1.2. 定义1、 省前置系统：是由广东省农村信用合作社建设的前置平台，系统连接核心业务系统，银行卡交换系统，地市前置系统，呼叫中心系统，信贷系统，省柜面清算系统等等系统，定位为各个渠道的整合端，以及核心业务，国结，信贷等系统的服务发布端。2、 省信贷系统：广东省农村信用社信贷业务管理系统。3、 小企业系统：佛山农商银行小企业信贷业务管理系统。1.3. 参考文献佛山农商银行小企业信贷系统与信贷系统接口方案说明书V0.2.doc 广东农信前置系统-信贷项目-信贷系统接口_V1.10.0.doc2. 交易通信协议2.1. 基本通信协议采用TCP/IP短连接，通信双方每次通信时建立连接，通信结束后关闭连接。对于信贷调用前置的交易，前置监听SOCKET端口，接收、处理、返回交易请求；对于前置调用信贷的反向交易，信贷监听SOCKET端口，接收、处理、返回前置的交易请求。3. 数据传输在TCP/IP网络中传输的应用数据采用下面的格式进行传送。数据长度6个字节，用ASCII码表示的数据长度。其值为不包含该数据长度字段，但包括交易码长度字段的数据包长度。不足6个字节左补“0”，例如：数据块长度为128，则数据长度表示为“000128”。交易码标识交易的代码，固定由6个字节组成。数据块应用层要传输的交易报文数据。4. 超时时间接收报文的超时时间为90秒。5. 报文说明信贷与前置间采用XML报文格式，所有报文包含报文头和报文体两部分。5.1. 报文编码报文编码使用GBK编码。5.2. 属性说明n表示0至9的数字字符a表示数字和英文字字符G表示GB2312定义的16位（16bits or双字节）编码字符B表示二进制格式存储，其后的长度为Byte5.3. 报文头报文头信息在报文头节点之内，具体的内容在请求报文头与应答报文头有差异，具体内容如下：5.3.1. 请求报文头字段名说明数据类型正向交易是否必输反向交易是否必输备注tx_code交易码char(6)MMbranch_no机构号char(5)C(可选)M(必输)teller_no柜员号char(12)CCchannel_flag渠道标识char(2)MM02-信贷request_date请求方日期char(8)MMyyyymmddrequest_time请求方时间char(6)MMHHMMSSrequest_seq_no请求方流水号char(20)MM当日该渠道唯一值terminal_info客户渠道交易终端char(20)CM信贷发送信贷前端的IP，柜面发送终端号5.3.2. 应答报文头字段名说明数据类型正向交易是否必输反向交易是否必输备注tx_code交易码char(6)MMbranch_no机构号char(5)C(可选)M(必输)teller_no柜员号char(12)CCchannel_flag渠道标识char(2)MM02-信贷03-信贷request_seq_no请求方流水号char(20)MM当日该渠道唯一值service_date服务方日期char(8)MMyyyymmddservice_time服务方时间char(6)MMHHMMSSservice_serial_no服务方流水号char(20)MM当日内唯一ret_code响应码char(5)MMret_explain响应码说明char(100)CC5.4. 报文体报文体信息在报文体节点之内，对于数组，通过节点进行标识。5.5. 报文示例00123458101123456789012123456111111111CNY111111111HKD5.6. 交易码码命名规则前置服务命名由8位组成： 服务方代码(X) + 业务类别(XX) + 性质(X) + 编号(XXXX) 服务方代码标识服务的提供方，目前的取值有：1：核心系统2：省前置整合3：地市前置4：信贷系统5：国结系统6：网银/手机银行系统7：支付 8：ECIF业务类别由2位组成，目前取值有：01：存款类02：贷款类03：支付类04：借记卡类05：信用卡类06：国际结算类07：资金类08：外汇类09：理财类10：中间业务类11：综合类12：创新业务类性质目前的取值有：1：金融类2：非金融类(管理类)3：查询类4：冲正类5：文件类编号是一个四位的顺序号6. 报文清单交易码交易描述说明同步类11130001客户信息同步-主表同步7. 报文修改日志日期版本号修改人修改报文名修改内容修改原因8. 其他说明1， 本文档中所有报文的字段名称部分均为英文的小写字母，且字段名称的单个单词之间用下划线连接。2， 对报文中各字段赋值时忽略其中的隐藏域字段。9. 报文体格式9.1. 业务同步服务接入报文9.1.1. 客户信息同步. 客户信息主表同步接口(cus_com).1. 请求报文顺序字段名称字段名称类型长度是否必输说明1.opt操作类型char3是2.inner_cus_id内部客户号char30否3.cus_id客户代码char30否4.mng_br_id所属法人机构char20否5.cus_type客户类型char3否6.cus_name客户名称char80否7.cus_en_name外文名称char80是8.cus_short_name客户简称char80是9.cert_type开户证件类型char2否10.cert_code开户证件号码char20否11.com_country国别char3是12.com_lcl_flg是否异地客户char1是13.cus_bank_rel与我行关联关系char2是14.com_hold_stk_amt拥有我行股份金额DECIMAL18是15.invest_type投资主体char1是16.com_sub_typ隶属关系char1是17.com_scale企业规模char2是18.com_hold_type控股类型char3是19.loan_card_flg有无贷款卡char1是20.loan_card_id贷款卡编号char16是21.loan_card_pwd贷款卡密码char20是22.loan_card_eff_flg贷款卡有效标志char2是23.loan_card_audit_dt贷款卡最近年审日期char10是24.com_ins_code组织机构代码char30是25.com_cll_type行业类型char5是26.com_cll_name行业名称char200是27.com_str_date成立日期char10是28.com_employee从业人数INTEGER11是29.com_ins_reg_date组织机构登记日期char10是30.com_ins_exp_date组织机构有效日期char10是31.com_ins_ann_date组织机构代码证年检到期日char10是32.com_ins_org组织机构代码证颁发机关char60是33.reg_code登记注册号char20是34.reg_type注册登记类型char3是35.admin_org主管单位char80是36.appr_org审批机关char80是37.appr_doc_no批准文号char80是38.reg_state_code注册地行政区划char12是39.reg_area_code2注册地区域编码2char6是40.reg_area_code3注册地区域编码3char6是41.reg_area_name行政区划名称char100是42.reg_addr注册登记地址char80是43.en_reg_addr外文注册登记地址char80是44.reg_cur_type注册资本/开办资金币种char3是45.reg_cap_amt注册资本（万元）DECIMAL18是46.paid_cap_cur_type实收资本币种char3是47.paid_cap_amt实收资本（万元）DECIMAL18是48.fun_source经费来源char100是49.legal_name法定代表人/负责人姓名char60是50.legal_sex法定代表人性别char1是51.legal_cert_type法定代表人/负责人证件类型char2是52.legal_cert_code法定代表人/负责人证件号码char20是53.legal_phone法定代表人/负责人联系电话char35是54.legal_houh_reg_add法人代表户籍地址char60是55.spouse_name法定代表人配偶名称char35是56.spouse_cert_type法定代表人配偶证件类型char2是57.spouse_cert_code法定代表人配偶证件号码char20是58.com_main_opt_scp主营范围/宗旨与业务范围char250是59.com_part_opt_scp兼营范围char250是60.reg_org注册登记机关char80是61.reg_start_date注册登记日期char10是62.reg_end_date注册登记到期日期char10是63.reg_audit注册登记年审结论char200是64.reg_audit_date注册登记年审日期char10是65.reg_audit_end_date注册登记年审到期日char10是66.nat_tax_reg_code国税税务登记代码char20是67.nat_tax_reg_org国税税务登记机关char80是68.nat_tax_reg_dt国税税务登记日期char10是69.nat_tax_reg_end_dt国税登记有效期char10是70.nat_tax_ann_date国税登记证年检到期日char10是71.loc_tax_reg_code地税税务登记代码char20是72.loc_tax_reg_org地税税务登记机关char80是73.loc_tax_reg_dt地税税务登记日期char10是74.loc_tax_reg_end_dt地税登记有效期char10是75.loc_tax_ann_date地税登记证年检到期日char10是76.fna_mgr财务负责人char80是77.com_operator企业经办人char80是78.post_addr通讯地址char80是79.post_code邮政编码char6是80.phone联系电话char35是81.fax_code传真char35是82.emailEmail地址char80是83.web_url网址char80是84.bas_acc_flg基本存款账户是否在本机构char1是85.bas_acc_licence基本存款账户开户许可证核准号char20是86.bas_acc_bank基本存款账户开户行char80是87.bas_acc_no基本存款账户帐号char32是88.bas_acc_date基本存款账户开户日期char10是89.com_acc_no本机构一般结算账户帐号char32是90.com_acc_date本机构一般结算账户开户日期char10是91.com_fin_rep_type财务报表类型char6是92.com_mrk_flg上市公司标志char1是93.com_mrk_area上市地char2是94.com_stock_id股票代码char32是95.com_grp_mode集团客户类型char1是96.grp_no集团编号char30是97.com_crd_typ信用等级企业分类char2是98.com_crd_grade信用等级char2是99.com_crd_dt信用评定日期char10是100.com_out_crd_grade信用等级(外部)char2是101.com_out_crd_dt信用等级评定日期(外部)char10是102.com_out_crd_org信用等级评定机构(外部)char60是103.com_imp_exp_flg进出口权标识char1是104.com_fexc_prm_code外汇许可证号码char30是105.com_main_product主要产品情况char250是106.com_prod_equip主要生产设备char250是107.com_fact_prod实际生产能力char250是108.com_opt_aera经营场地面积(平方米)DECIMAL18是109.com_opt_owner经营场地所有权char1是110.com_sp_business特种经营标识char1是111.com_sp_lic_no特种经营许可证编号char80是112.com_sp_detail特种经营情况char80是113.com_sp_lic_org特种许可证颁发机关char80是114.com_sp_str_date特种经营起始日期char10是115.com_sp_end_date特种经营到期日期char10是116.com_opt_st经营状况char3是117.com_imptt_flg地区重点企业char1是118.com_prep_flg优势企业char1是119.com_dhgh_flg双高企业char1是120.com_cl_entp国家宏观调控限控行业char1是121.com_hd_enterprise龙头企业char1是122.com_rel_dgr与我行合作关系char2是123.com_init_loan_date建立信贷关系时间char10是124.com_city_flg城乡类型char2是125.com_mng_org上级主管单位char80是126.com_cus_rank我行客户分类char2是127.cust_mgr主管客户经理char20是128.main_br_id主管机构char20是129.input_id登记人char20是130.input_br_id登记机构char20是131.input_date登记日期char10是132.last_upd_id更新人char20是133.last_upd_date更新日期char10是134.cus_status状态char2是135.crd_end_dt信用等级到期日期char10是136.in_cll_typeIN_CLL_TYPEchar2是137.acu_addrACU_ADDRchar80是138.cus_id_rel关联客户代码char30是139.risk_desRISK_DESchar1是140.legal_sps_no法人配偶客户码char30是141.legal_sps_name法人配偶姓名char35是142.legal_sps_id_type法人配偶证件类型char2是143.legal_sps_id_code法人配偶证件号码char20是144.reality_controler_no实际控制人客户码char30是145.reality_controler_name实际控制人姓名char35是146.reality_controler_id_type实际控制人证件类型char2是147.reality_controler_id_code实际控制人证件号码char20是148.reality_sps_no实际控制人配偶客户码char30是149.reality_sps_name实际控制人配偶姓名char35是150.reality_sps_id_type实际控制人证件类型char2是151.reality_id_code实际控制人配偶证件号码char20是152.legal_sign_init_date法人签字样本开始日期char10是153.legal_end_init_date法人签字样本结束日期char10是154.real_sign_init_date实际控制人签字样本开始日期char10是155.real_sign_end_date实际控制人签字样本结束日期char10是156.real_accredit_init_date实际控制人授权书开始日期char10是157.real_accredit_end_date实际控制人授权书结束日期char10是158.real_work_resume实际控制人工作简历char250是159.total_assets资产规模DECIMAL18是160.total_sales销售额DECIMAL18是161.accredit_status授权状态char1是162.remark备注char250是163.finance_cd机构信用代码号char18是164.new_com_fin_rep_type新财务报表类型char6是165.reg_upd_date更新注册信息日期char10是166.wrk_state_code办公地址行政代码char6是167.wrk_state_name办公地址行政区域名称char80是168.wrk_upd_date更新办公地址日期char10是169.risc_code集团与单一法人风险预警信号代码char500是170.conc_code集团与单一关注事件代码char500是171.env_riskchar3是172.com_ins_pub_date组织代码颁发日char10是173.com_ins_upd_date登记信息更新日期char10是174.com_mrk上市市场char1是175.com_mrk_country上市地国别char3是176.default_rate违约概率DECIMAL8是177.opendaychar10是178.chg_time.2. 响应报文顺序字段名称字段说明类型长度是否必输说明1.rep_code响应码char10M(必输)2.rep_msg响应内容varchar150M(必输).3. 报文说明无. 客户信息子表同步接口(cus_base).1. 请求报文顺序字段名称字段说明类型长度是否必输说明1.opt操作类型char是2.cus_id客户代码char30否3.cus_name客户名称char80否4.cus_short_name客户简称char80是5.cus_type客户类型char3否6.cert_type证件类型char2否7.cert_code证件号码char20否8.contact_name联系人char80是9.phone联系电话char35是10.open_date最早开户日期char10是11.trans_cus_id核心过渡客户码char30是.2. 响应报文顺序字段名称字段说明类型长度是否必输说明3.rep_code响应码char10M(必输)4.rep_msg响应内容varchar150M(必输).3. 报文说明无9.1.2. 合同信息同步. 借款合同主表同步接口(ctr_loan_cont).1. 请求报文顺序字段名称字段说明类型长度是否必输说明1.opt操作类型VARCHAR1是2.cont_no合同编号VARCHAR30否3.serno业务流水号CHAR40否4.cont_type合同类型VARCHAR1是5.prd_pk产品主键VARCHAR32是6.biz_type业务品种VARCHAR6是7.prd_name产品名称VARCHAR60是8.app_form表单类型VARCHAR60是9.cust_no客户编号VARCHAR30是10.cust_name客户名称VARCHAR60是11.biz_type_sub业务品种细分VARCHAR8是12.biz_type_detail业务品种分类名称CHAR100是13.loan_form贷款形式CHAR1是14.loan_nature贷款性质CHAR2是15.loan_kind_ca企业贷款种类CHAR2是16.loan_type_ext关联交易类型VARCHAR2是17.loan_type_ext2关联交易描述CHAR100是18.currency_type币种DECIMAL3是19.approval_amt审批金额DECIMAL18是20.cont_amt合同金额DECIMAL18是21.total_issue_amt累计发放金额DECIMAL18是22.total_recyle_amt累计回收金额DECIMAL18是23.avail_amt合同可用余额CHAR18是24.term_time_type期限时间类型INTEGER3是25.loan_term贷款期限CHAR11是26.loan_start_date贷款起始日期CHAR10是27.loan_end_date贷款终止日期DECIMAL10是28.ruling_ir基准利率DECIMAL18是29.cal_floating_rate利率浮动比DECIMAL12是30.reality_ir_y执行利率DECIMAL18是31.overdue_rate逾期加罚率DECIMAL12是32.overdue_ir逾期月利率DECIMAL18是33.default_rate违约加罚率DECIMAL12是34.default_ir违约月利率DECIMAL18是35.ci_rate复利加罚率DECIMAL12是36.ci_ir复利月利率CHAR18是37.ir_adjust_mode利率调整方式CHAR1是38.interest_acc_mode结息周期CHAR2是39.chargeoff_ind出帐方式CHAR1是40.discont_ind是否贴息VARCHAR1是41.discount_id贴息方编号CHAR25是42.mortgage_flg按揭标识CHAR1是43.repayment_mode还款方式CHAR3是44.repayment_period还款频率CHAR2是45.assure_means_main主担保方式CHAR2是46.assure_means2担保方式2CHAR2是47.assure_means3担保方式3VARCHAR2是48.loan_direction贷款投向VARCHAR4是49.direction_name投向名称CHAR200是50.agriculture_type涉农情况CHAR2是51.agriculture_use涉农用途CHAR4是52.minor_entrp_range小企业统计口径(银监)CHAR1是53.loan_use_type借款用途类型VARCHAR3是54.use_dec用途说明VARCHAR200是55.repayment_src_dec还款来源CHAR200是56.limit_ind授信额度使用标志CHAR1是57.guarantora_grp_ind联保贷款标志CHAR1是58.copartner_ind市场合作方标志CHAR1是59.loan_card_ind使用农户贷款证标志CHAR1是60.entrust_ind委托方贷款标识VARCHAR1是61.loan_type1借款分类1VARCHAR6是62.loan_type2借款分类2VARCHAR6是63.loan_type3借款分类3VARCHAR6是64.loan_type4借款分类4VARCHAR6是65.loan_type5借款分类5VARCHAR6是66.loan_type6借款分类6VARCHAR6是67.final_endorse_br_id最终审批机构VARCHAR20是68.final_endorse_date最终审批日期VARCHAR20是69.final_endorse_id最终审批人CHAR20是70.sign_date合同签订日期CHAR10是71.change_date合同变更日期CHAR10是72.cont_state合同状态VARCHAR3是73.input_id托管人（申请人）VARCHAR20是74.cust_mgr客户经理VARCHAR20是75.input_br_id受理机构VARCHAR20是76.main_br_id主管机构VARCHAR20是77.fina_br_id账务机构VARCHAR20是78.old_bill_no原借据号CHAR30是79.cla_result风险分类初分结果VARCHAR2是80.cla_suggestion风险分类初分意见CHAR500是81.ir_exe_type利率执行方式VARCHAR1是82.responsible_man责任人CHAR80是83.government_ind涉政类型CHAR1是84.government_org_attribute涉政机构属性CHAR4是85.government_platform是否为涉政平台CHAR4是86.int_rate_type利率类型CHAR1是87.int_rate_inc_opt利率增量选项DECIMAL1是88.int_rate_inc利率增量DECIMAL18是89.fixed_rate固定利率CHAR18是90.prin_int_rate_inc_opt罚息利率增量选项（拖欠本金的罚息）DECIMAL1是91.prin_int_rate_inc罚息利率增量（拖欠本金的罚息）DECIMAL18是92.prin_fixed_rate固定的罚息率（拖欠本金的罚息）CHAR18是93.unpd_int_rate_inc_opt罚息利率增量选项（应收利息的罚息）DECIMAL1是94.unpd_int_rate_inc罚息利率增量（应收利息的罚息）DECIMAL18是95.unpd_fixed_rate固定的罚息率（应收利息的罚息）CHAR18是96.comp_int_rate_inc_opt罚息利率增量选项（复利）DECIMAL1是97.comp_int_rate_inc罚息利率增量（复利）DECIMAL18是98.comp_fixed_rate固定的罚息率（复利）DECIMAL18是99.appr_int_rate_inc罚息利率增量（挪用利率）VARCHAR18是100.prd_userdf_type产品自定义类型VARCHAR60是101.prd_userdf_name产品自定义名称VARCHAR60是102.consign_loan_bgl_acct_no委托贷款BGL帐号CHAR16是103.funds_src资金来源VARCHAR2是104.chargeoff_manage出帐负责人VARCHAR20是105.enter_account入账账号CHAR32是106.enter_account_name入账账户名称VARCHAR80是107.repayment_account还款账号CHAR32是108.repayment_acc_name还款账户名称CHAR80是109.prd_typePRD_TYPECHAR2是110.ispafISPAFVARCHAR1是111.cosurety_cont_no联保协议编号CHAR30是112.lead_arranger_ind牵头行标志VARCHAR1是113.cn_cont_no中文合同号VARCHAR60是114.fldvalue01FLDVALUE01VARCHAR250是115.fldvalue02FLDVALUE02CHAR250是116.seot专营中心业务类型CHAR1是117.fhf首套房标识DECIMAL1是118.ori_loan_bal原贷款余额CHAR18是119.indus_adj_type产业结构调整类型CHAR1是120.indus_upd_flag工业转型升级标识CHAR1是121.stra_indus_type战略新兴产业类型CHAR1是122.portfolio_ind是否组合贷款VARCHAR1是123.VARCHAR30否.2. 响应报文顺序字段名称字段说明类型长度是否必输说明1.rep_code响应码char10M(必输)2.rep_msg响应内容varchar150M(必输).3. 报文说明无. 展期合同表同步接口(ctr_loan_extend).1. 请求报文顺序字段名称字段说明类型长度是否必输说明1.opt操作类型VARCHAR1是2.cont_no展期协议编号VARCHAR32否3.serno业务流水号VARCHAR40否4.cus_id客户代码VARCHAR30否5.cus_name客户名称VARCHAR60否6.o_bill_no原借据编号VARCHAR30是7.o_cont_no原合同编号VARCHAR40是8.prd_pk原产品主键VAR