广东农信信贷系统服务接口规范说明书-V.1.2..docx

广东省农村信用合作社信贷业务管理系统接入服务接口规范广东省农村信用合作社联合社编写说明标题：网络中心接口规范类别：技术版本历史：版本作者日期备注v1.0.0魏磊2014/9/02创建v1.0.2魏磊2014/9/22修改v1.0.2魏磊2014/9/22修改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. 报文清单交易码交易描述说明同步类40210001客户信息同步-主表同步40210002客户信息同步-子表同步40210003合同信息同步-借款合同主表同步40210004合同信息同步-展期合同同步40210005合同信息同步-业务合同引担保合同同步40210006担保信息同步-担保主表同步40210007担保信息同步-联保协议主表同步40210008担保信息同步-联保协议成员表同步40210009担保信息同步-保证人同步40210010担保信息同步-抵押品基本信息同步40210011担保信息同步-质押品基本信息同步40210012担保信息同步-房产同步40210013担保信息同步-土地同步40210014担保信息同步-在建工程同步40210015担保信息同步-机动车辆同步40210016担保信息同步-船舶同步40210017担保信息同步-设备同步40210018担保信息同步-林权同步40210019担保信息同步-海域同步40210020担保信息同步-其他抵押品同步40210021担保信息同步-存单同步40210022担保信息同步-票据同步40210023担保信息同步-保单同步40210024担保信息同步-债券同步40210025担保信息同步-股权/股票基金同步40210026担保信息同步-仓单/提单表同步40210027担保信息同步-贵金属同步40210028担保信息同步-商铺使用权同步40210029担保信息同步-应收账款同步40210030担保信息同步-动产同步40210031担保信息同步-商标使用权同步40210032担保信息同步-其他质押品同步40210033放款授权信息同步-放款授权同步40210038贷后信息同步-贷款台账同步 40210039对私客户信息同步-主表同步控制类40210034 合同信息同步-签订合同同步接口40210035 担保信息同步-担保合同签订同步接口查询类40210036 放款成功、还款、冲正通知查询接口其他40210037押品出入库、撤销7. 报文修改日志日期版本号修改人修改报文名修改内容修改原因2014-09-17v.1.0.2魏磊台账同步增加台账同步接口2014-09-17v.1.0.2魏磊押品出、入库、撤销增加押品出入库接口2014-09-17v.1.0.2魏磊放款授权接口操作类型说明2014-09-22v.1.0.2魏磊查询接口整合查询接口2014-09-22v.1.0.2魏磊出入库接口最终确定出入库接口2014-09-24v.1.0.2万志生对私客户接口增加对私客户接口2014-09-25v.1.2.0魏磊修改担保合同与押品关系同步接口2014-09-25v.1.2.0魏磊梳理了字典8. 其他说明1， 本文档中所有报文的字段名称部分均为英文的小写字母，且字段名称的单个单词之间用下划线连接。2， 对报文中各字段赋值时忽略其中的隐藏域字段。9. 报文体格式9.1. 业务同步服务接入报文9.1.1. 客户信息同步. 客户信息主表同步接口(cus_com).1. 请求报文顺序字段名称字段名称类型长度是否能为空说明1.opt操作类型char3否A- 新增U- 更新D- 删除2.inner_cus_id内部客户号char30否3.cus_id客户代码char30否4.mng_br_id所属法人机构char20否5.cus_type客户类型char3否STD_ZB_CUS_TYPE6.cus_name客户名称char80否7.cus_en_name外文名称char80是8.cus_short_name客户简称char80是9.cert_type开户证件类型char2否STD_ZB_CERT_TYP10.cert_code开户证件号码char20否11.com_country国别char3是STD_GB_2659-200012.com_lcl_flg是否异地客户char1是STD_ZX_YES_NO13.cus_bank_rel与我行关联关系char2是STD_ZB_CUS_BANK14.com_hold_stk_amt拥有我行股份金额decimal18是15.invest_type投资主体char1是STD_ZB_INVESTOR16.com_sub_typ隶属关系char1是STD_ZB_SUBJECTION17.com_scale企业规模char2是STD_ZB_ENTERPRISE18.com_hold_type控股类型char3是STD_ZB_HOLD_TYPE19.loan_card_flg有无贷款卡char1是STD_ZX_YES_NO20.loan_card_id贷款卡编号char16是21.loan_card_pwd贷款卡密码char20是22.loan_card_eff_flg贷款卡有效标志char2是STD_ZB_LOAN_CARD_FLG23.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是STD_ZB_REG_TYPE35.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是STD_ZX_CUR_TYPE45.reg_cap_amt注册资本（万元）decimal18是46.paid_cap_cur_type实收资本币种char3是STD_ZX_CUR_TYPE47.paid_cap_amt实收资本（万元）decimal18是48.fun_source经费来源char100是49.legal_name法定代表人/负责人姓名char60是50.legal_sex法定代表人性别char1是STD_ZX_SEX51.legal_cert_type法定代表人/负责人证件类型char2是STD_ZB_CERT_TYP52.legal_cert_code法定代表人/负责人证件号码char20是53.legal_phone法定代表人/负责人联系电话char35是54.legal_houh_reg_add法人代表户籍地址char60是55.spouse_name法定代表人配偶名称char35是56.spouse_cert_type法定代表人配偶证件类型char2是STD_ZB_CERT_TYP57.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是STD_ZX_YES_NO85.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是STD_FIN_REP_TYPE92.com_mrk_flg上市公司标志char1是STD_ZX_YES_NO93.com_mrk_area上市地char2是STD_ZX_LISTED94.com_stock_id股票代码char32是95.com_grp_mode集团客户类型char1是STD_ZB_GROUP_TYPE96.grp_no集团编号char30是97.com_crd_typ信用等级企业分类char2是STD_ZB_COM_CRD_TY98.com_crd_grade信用等级char2是STD_ZB_CREDIT_GRADE99.com_crd_dt信用评定日期char10是100.com_out_crd_grade信用等级(外部)char2是STD_ZB_CREDIT_GRADE101.com_out_crd_dt信用等级评定日期(外部)char10是102.com_out_crd_org信用等级评定机构(外部)char60是103.com_imp_exp_flg进出口权标识char1是STD_ZX_YES_NO104.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是STD_ZX_FIELD_OWNER110.com_sp_business特种经营标识char1是STD_ZX_YES_NO111.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是STD_ZB_BUSI_STATUS117.com_imptt_flg地区重点企业char1是STD_ZX_YES_NO118.com_prep_flg优势企业char1是STD_ZX_YES_NO119.com_dhgh_flg双高企业char1是STD_ZX_YES_NO120.com_cl_entp国家宏观调控限控行业char1是STD_ZX_YES_NO121.com_hd_enterprise龙头企业char1是STD_ZB_COM_HD_ENTER122.com_rel_dgr与我行合作关系char2是STD_ZB_COM_REL_DGR123.com_init_loan_date建立信贷关系时间char10是124.com_city_flg城乡类型char2是STD_ZB_URBAN_RURAL125.com_mng_org上级主管单位char80是126.com_cus_rank我行客户分类char2是STD_GB_COM_CUS_RANK127.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是STD_ZB_CUS_STATUS135.crd_end_dt信用等级到期日期char10是136.in_cll_typein_cll_typechar2是STD_YZ_HNHYFL137.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是STD_ZB_CERT_TYP143.legal_sps_id_code法人配偶证件号码char20是144.reality_controler_no实际控制人客户码char30是145.reality_controler_name实际控制人姓名char35是146.reality_controler_id_type实际控制人证件类型char2是STD_ZB_CERT_TYP147.reality_controler_id_code实际控制人证件号码char20是148.reality_sps_no实际控制人配偶客户码char30是149.reality_sps_name实际控制人配偶姓名char35是150.reality_sps_id_type实际控制人证件类型char2是STD_ZB_CERT_TYP151.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是STD_ZB_ACCREDIT_STAT162.remark备注char250是163.finance_cd机构信用代码号char18是164.new_com_fin_rep_type新财务报表类型char6是STD_NEW_FIN_REP_TYPE165.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是DIC_STOCK175.com_mrk_country上市地国别char3是STD_GB_2659-2000176.default_rate违约概率decimal8是177.openday登记日期char10是178.chg_time更新时间timestamp是.2. 响应报文顺序字段名称字段说明类型长度是否必输说明1.rep_code响应码char10m(必输)2.rep_msg响应内容varchar150m(必输).3. 报文说明无. 对私客户信息同步接口(cus_indiv).1. 请求报文顺序字段名称字段说明类型长度是否能为空说明1opt操作类型char否 A- 新增U- 更新D- 删除2inner_cus_id内部客户号varchar30否3cus_id客户代码varchar30否4mng_br_id所属法人机构varchar20否5cus_type客户类型char3否STD_ZB_CUS_TYPE6cus_name姓名varchar80否7indiv_sex性别char1是STD_ZX_SEX8cert_type证件类型char2否STD_ZB_CERT_TYP9cert_code证件号码varchar20否10indiv_id_exp_dt证件到期日char10是11agri_flg是否农户char1是STD_ZX_YES_NO12cus_bank_rel与我行关联关系char2是STD_ZB_CUS_BANK13com_hold_stk_amt拥有我行股份金额decimal18是14bank_duty在我行职务char1是STD_ZB_BANK_DUTY15indiv_ntn民族char2是STD_ZB_NATION16indiv_brt_place籍贯varchar60是17indiv_houh_reg_add户籍地址varchar60是18indiv_dt_of_birth出生年月日char10是19indiv_pol_st政治面貌char2是STD_ZB_POLITICAL20indiv_edt文化程度（最高学历）char2是STD_ZX_EDU21indiv_dgr最高学位char1是STD_ZX_DEGREE22indiv_mar_st婚姻状况char2是STD_ZX_MARR_STATUS23indiv_heal_st健康状况char1是STD_ZB_ HEAL_ST24post_addr通讯地址varchar80是25post_code邮政编码char6是26area_code区域编码varchar12是27area_name区域名称varchar100是28phone联系电话varchar35是29fphone家庭电话varchar35是30mobile手机varchar35是31fax_code传真varchar35是32emailemail地址varchar80是33indiv_rsd_addr居住地址varchar60是34indiv_zip_code居住地邮政编码varchar6是35indiv_rsd_st居住状况char1是STD_ZB_RESIDE_STATUS36indiv_soc_scr社会保障情况varchar60是STD_ZB_SOC_SCR37indiv_hobby爱好varchar200是38indiv_occ从事职业char1是STD_ZX_EMPLOYMET39indiv_com_name工作单位varchar60是40indiv_com_typ单位性质char3是41indiv_com_fld单位所属行业char5是42indiv_com_phn单位电话varchar25是43indiv_com_fax单位传真varchar25是44indiv_com_addr单位地址varchar80是45indiv_com_zip_code单位邮编char6是46indiv_com_cnt_name单位联系人varchar30是47indiv_work_job_y单位工作起始年varchar10是48indiv_com_job_ttl职务char1是STD_ZX_DUTY49indiv_crtfctn职称char1是STD_ZX_TITLE50indiv_ann_incm年收入情况decimal18是51indiv_sal_acc_bank工资账户开户行varchar80是52indiv_sal_acc_no工资账号varchar32是53indiv_sps_name配偶姓名varchar80是54indiv_sps_id_typ配偶证件类型char2是STD_ZB_CERT_TYP55indiv_sps_id_code配偶证件号码varchar20是56indiv_scom_name配偶工作单位varchar60是57indiv_sps_occ配偶职业char1是58indiv_sps_duty配偶职务char1是59indiv_sps_mincm配偶年收入decimal18是60indiv_sps_phn配偶单位联系电话varchar35是61indiv_sps_mphn配偶手机号码varchar35是62indiv_sps_job_dt配偶参加工作时间varchar10是63com_rel_dgr与我行合作关系char2是STD_ZB_CUS_BANK_CO64com_init_loan_date建立信贷关系时间char10是65indiv_hld_acnt在我行开立账户情况char1是66hold_card持卡情况char1是STD_ZB_HOLD_CARD_YZ67passport_flg是否拥有外国护照或居住权char1是STD_ZX_YES_NO68crd_grade信用等级char2是STD_ZB_CREDIT_GRADE69crd_date信用评定日期varchar10是70remark备注varchar250是71cust_mgr主管客户经理varchar20是72main_br_id主管机构varchar20是73input_id登记人varchar20是74input_br_id登记机构varchar20是75input_date登记日期char10是76last_upd_id更新人varchar20是77last_upd_date更新日期varchar10是78cus_status状态char2否STD_ZB_CUS_STATUS79indiv_com_fld_name单位所属行业名称varchar200是80crd_end_dt信用等级到期日期char10是81indiv_psp_crtfctn配偶职称char1是82indiv_sps_mar_code结婚证号码varchar20是83cus_id_rel配偶关联客户码varchar30是84work_resume个人简历varchar250是85accredit_status授权状态char1是86former_name姓名varchar35是87lay_off_flag是否有工作单位char1是LAY_OFF_FLAG88lay_off_code下岗证号varchar20是89loan_card_flg有无贷款卡char1是STD_ZX_YES_NO90loan_card_id贷款卡编号varchar16是91loan_card_pwd贷款卡密码varchar20是92loan_card_eff_flg贷款卡有效标志char2是STD_ZB_LOAN_CARD_FLG93loan_card_audit_dt贷款卡最近年审日期char10是94openday登记日期varchar10是95chg_time更新时