金蝶金融税票征信服务接口标准说明书.docx

金蝶金融税票征信服务接口标准说明书修改记录Ver.No发版日期编制人批准人修改的章节号1.02018-08-07陈灵科创建文档1.12018-09-10陈灵科更新文档内容1.22018-09-11陈灵科更新状态码132018-11-1陈灵科更新接口文档字段1.42019-01-28陈灵科移除10大供应商和10大客户中的税号字段1.52019-03-15陈灵科修复示例说明中fees字段内的结构问题1.62019-04-23李祥增力口notifyUH、encrypt字E殳1.6.12019-06-18李祥1.增加额度模型字段quota,2.overalllnfo中增加企业纳税信用等级字段credit1.6.22019-06-26李祥1 .增加工商信息字段：enterprise2 .增加失信被执行人信息字段：disrupt3 .增加被执行人信息字段：undertaker4 .增加法院公告字段：CoUrtInfo5 .增加裁判文书字段：wenshu1.72019-07-17陈灵科优化查询接口，以及新增字段KeadcustomerJustizsache和KeadsupplierJustizsache1.7.12019-08-01陈灵科修复文档中一处书写错误1.7.22019-08-22陈灵科修复文档中几处书写错误1.7.32019-12-26李祥修改指标：SaleGoodsAnaIysisxsalesTypesxSaIesRatesxbuyGoodsAnalysisxincomestatistics新增指标：参见返回示例中的标注1.82020-03-10李祥增加一些数据的可能值和范围说明,例如可能ol数值，或空值或者一1.8.12020-03-11陈灵科增加通过企业名称查询报告1.8.22020-03-18李祥工商信息指标增加"一级行业"字段IndustryName1.8.32020-04-03李祥补充SaIesTypesxincomestatistics指标字段:冲红作废金额比补充PartnerS指标字段:持股比例目录1调用版51.1 安全协议51.1.1 加解密51.1.2 签名方式52贷审税务报告查询接口62.1 贷审税务报告查询接口62.2 贷后税务报告杳询接口353响应码431调用方式接口采用RESTfUlI的设计方式客户端通过HTTP协议的GET、POST(g前主要是这两种)方法请求进行调用。Restful:参考资料。API的调用地址基本上遵循如下约定的方式：APl地址前缀+服务+资源+参数其中：API地址前缀：基本不变的API访问UR1.地址生产环境：1.1 安全协议1.1.1 加解密用户通过所分配的秘钥及任意随机的8位偏移量进行数据加密。Stringvector=mUUID().toString().substring(0,8);StringpublicKey=nMIGfMAOGCSqGSIbBDQEBA*,;StringencrData=pt(NString(),publicKey,vector);.printing加密报文："+encrData);1.1.2 签名方式接入方对自己请求报文字符串进行签名(所有需签名字段按key的字典序连接,组成keyl=valuel&key2=value2的方式)，即：用户自行生成签名密钥对，同时将签名公钥发给平台对接人，私钥留下自己注意保密，通过生成的签名私钥进行签名，产生签名值。同时通过平台签名公钥和平台返回签名值进行验签。根据用户自己的签名私钥对加密报文进行签名StringsignSource="a=bic=d"StringSignatUre=(SignSOUrce,SignPrivateKey);.println("签名值:"+signature);根据平台签名公钥对平台返回的报文进行验证签名booleanisTrue=datalSignPubIicKey,sign);2贷审税务报告查询接口2.1贷审税务报告查询接口接口地址：ort/preloan加密前输入：参数是否必填是否需要签名说明Clientjd是是idclient_secret是是secrettaxld是是企业税务号或企业名称StartMonth否是查询开始月份，格式"yyyy-MM'例如:"2018-01"endMonthS是查询结束月份，格式"yyyy-MM'例如2018-07"sign是否签名值加密后输入:参数是否必填说明appid是同ClientJddata是加密的请求参数vector是偏移向量请求实例POST方式传递JSON参数格式：("appid,20*77"data,hXX91ga5BYI4H7NXk7jh62v7OftQyH+lmdKQMnIVF3OHWcK0YXK656SjEkmbuiOsslcoy480GiMDHdVgXyJOIfMaaGX8SHaZOBwQAP7P7zyTe+b2xcnZ+r9PPENaAhkKxZK41.Ydnvl1.P33EsT7etmzBalnqPZp8l9Y4Q4+QvidBX7IhxaIuOJIBeYTfDBCsmmC+bRI1.pGBhR3YAyj+bvoY+bEXlID5aPvYe1.kqli7a7zKWo9OwpMl7joCPPD9j5NJXRhW×4W1.BpZRr4sG5XkPna8ck6wB+hhSyWqjiFjHgIh27O6b8uiuiTJdOXft)dDZFecPSw7l×E*WGgOUtECIF+Z1.ag01kyl1.vCXZA8iI3E+R4Ftlc58二，"vectorw:"28cc8da8M输出字段返回示例（解密后）：（"data":"supplierstability":供应商稳定指数（-SUPPStabilityIndex":"0.19",胭商数可能01数值，或利直或者T"supplierstability":"轻度稳定”,供应商稳定度"yearName":"2018"年份）I-fees":进项票-费用信息"totalAmounf:"34560.00",费用支出开票总金额htotalCount":2,费用支出开票总张数"fees1.ist":"运输与仓储费"：（"CountNum":2,该类发票总张数"feeType":"运输与仓储费",数据维度（费用类型）"invoiceDateStr":"2018-08-24",开票日期-SaIerName":"深圳市*物流有限公司",供应商"SumAmountStr":"34560.00",该类发票总金额"totalAmountStr":"2250.00"开票金额)."Customert1.ist":/南十大客户列表NyerName深圳市*供应链管理有限公司",购方名称"rateBuyerAmount":"0.502",销售金额占比可能01数值，或空值或者T"ratelnvoiceCount":"0.525",发票张数占比可能01数值，或空值或者TYotaIAmount":.65,销售金额"totallnvoiceCount":1262发票张数,"StartMonth":"2015-0”开始年月"CompanyName":"深圳市*科技有限公司",/企业名称"bankAccounts":企业银行信息"bankAccount":'银行账号"bankName中国银行股份有限公司深圳大浪支行”,开户银行"CompanyName":"深圳市*科技有限公司，企业名称"rate":"1.000”,金额占总开票金额比可能01数值，或空值或者一"taxNo":"*62129B",纳税人期号"totalAmount":.35,该账号开票总金额"totalCount":2403该账号开票总张数)I"salesRates":/假月汇总-销项票说率统计("rateOPer":"0.000",/顺率0%占比可能01数值，或空值或者T"ratelOPer":"0.000",税率10%占比可能01数值，或空值或者T"ratellPer":OOOO",税率11%占比可能01数值，或空值或者7"ratel3Per":"0.00(,/厩率13%占比可能01数值，或空值或者T"ratel6Per":"0.000",税率16%占比可能01数值，或空值或者T"ratel7Per":"1.oO(T,除17%占比可能01数值，或空值或者T"rate3Perh:-0.000",/顺率3%占比可能01数值，或空值或者7"rate5Pern:"0.000",/税率5%占比可能01数值，或空值或者T"rate6Per":"0.000",/顺率6%占比可能01数值，或空值或者T"rateMutiPer":"0.000",一票多税率占比可能01数值，或空值或者一"rateOtherPer":"0.362",/段他占比"yearMonth":"2018-01"年月,"CustomerAnaIysis":企业客户圈子分析'VgBuyerAmount":.59,/历史平均销售金额"customerconcentration":阚氐",客户集中度"CustomerCount":4,累计客户数量"CustomerGini":"0.498",客户集中系数（基尼系数）可能01数值，或空值或者一"months":8,#交易月份数"rateTa×CreditA":纳税A级客户数量占比可能01数值，或空值或者T"ta×CreditACount":0,纳税A级客户数量"taxCreditCount":0,纳税等级查得企业数量"totalAmount":.35,收入开票总金额"totalCount":2403收入开票总张数）1."incomestatistics":按月汇总一进项票汇总"negativeAmount":0,/进项冲I金额合计"negativeCount":0,/进项冲张数合计"normalAmount":76699.99,进项有效票金额合计"normalCount":2,进项有效票张数合计YotaIAmount":.26,进项金额"totalCount":16,进项张数"VoidedAmount":994816.27,/进项作废票金额合计"VoidedCount":14,进项作废票张数合计"yearMonth":"2018-0,年月"normalTaxIncomeAmount":.34,/应税销售收入合计"totalSupplier":62,/供应商数量，"rateNegativeAmounf:"0.037/冲红作废金额比1."basicStatistics":开票基本情况汇总("countForl2":2403,前12个月合计开票张数"countFor24M:2403,前24个月合计开票张数"countFor36":2403,前36个月合计开票张数"CountPerMonth":200,近一年月均开票张数"inmaxMonths":7,最早一张进项发票距离现在的月份数"inmiDays":7,最近一张进项发票距离现在天数"invoiceAmountForl2":.5,前12个月合计应税销售收入"invoiceAmountFor36":5前36个月合计应税销售收入"invoiceAmountPerMonth":.63,近一年月均开票应税销售收入"maxGapDays":27,历史最长连续未开票天数"ma×GapDaysl2":27,最近12个月最长连续未开票天数"ma×GapDays6":27,最近6个月最长连续未开票天数“smaxMonths":7,最早一张销项发票距离现在的月份数"sminDays":9,最近一张销项发舞巨离现在天数YotaIAmount":.35,历史总开票金额"totalAmountFor!2":.35,/商12个月合计开票金额YotalAmountFor24":.35,/隔24个月合计开票金额YotalAmountFor36":.35,/隔36个月合计开票金额YotaIAmountPerMonth":.529167,近一年月均开票金额"totalCount":2403历史总开票笔数)V"SuppIierTrade":按月;口总一企业供应商交易"avgAmount":542546.62,平均彳蛔商交易金额"rateToplOAmounf,:"0.901，/廊10供应商销售额占比()可能01数值，或空值或者T"rateToplOCount":"0.471",前10供应商交易次数占比(%)可能01数值，或空值或者T"rateTop5Amount":"0.799",前5供应商采购额占比（）可能01数值，或空值或者T"rateTop5Count":"0.161”,前5供应商交易次数占比（%）可能01数值，或空值或者T"SiimToplOAmount":.44,主要供应商（前10）销售额合计"SumToplOCount":146,前10供应商交易次数"sumTop5Amount":.79,主要供应商（前5）销售额合计"sumTop5Count":50,/廊5供应商交易次数"totalsupplier":36"/供应商数量"yearMonth":"2018-08"年月,"SuppIierMonth":按月汇总-企业新供应商开票"newInvoiceCount":119,册共应商发票份数"newSupplierCount":20,"FiewTotaIAmount":.04,新供应商交易金额"rateNewAmounf:"0.107",新供应商交易金额占比可能01数值，或空值或者T"yearMonth":"2018-08"年月,l"dataStartDate":"2018-01-05",最早发票开票日期"dataEndDate":"2018-08-31",最近发票开票日期"purchaseGoods":采购商品列表前10"goodsName":"*计算机外部设备*液晶显示屏",/W品名称"rateAmount":"0.096",金额占比可能01数值，或空值或者T"ratelnvoiceCount":"0.081，发票张数占比可能01数值，或空值或者T"specModel":"PJ050IA",规格型号YotaIAmount":.02,采购金额"totllnvoiceCount":50,/发票张数"unit":"片"单位,"CustomerYear":按年汇总一企业客户"avgCustomerAmount":.59,年企业平均交易金额"newCustomerCount":4,年汇总：新客户数量"newCustomerInvoiceCount":2403,年汇总：新客户发票份数"newCustomerTotalAmount":.35,年汇总：新客户交易金额"rateNewCustomerAmount":TOOO",年汇总：新客户交易金额占比可能01数值,或空值或者T"totalCustomerCount":4,企业客户数量"totalSalesAmount":.35,年有效票金额合计"totalSalesCount":2403,年有嬷张数合计"yearName":"2018"年份)I"salesTypes":"做月汇总T项票分类统计("negativeAmount":0,冲红票额合计"negativeCount":0,冲红张数等十"normalAmount":.26,/效票金额合计"normalCount":354,/W嬷张数合计"normalTaxAmount":.89,有税额合计"ratelntegerAmount":"0.041，开票金额为整数的发票金额占比(%)可能01数值，或空值或者"rateIntegerCount":"0.04”开票金额为龈的发票张数占总%X可能01数值，或空值或者T"VoidedAmount":536466.4,作废票额等十-VOidedCOUnt":10,作废张数合计"yearMonth":"2018-0；年月"normalTaxAmount":.43,/应税销售收入"totalcustomer":302/客户数，"rateNegativeAmount":"0.037/冲红作废金额比l,"customerstability":客户稳定指数"CUStStabiIityIndex":"0.47",客户稳定指数可能01数值，或空值或者T"customerstability":"中度稳定",客户稳定度"taxld":"*62129B,/顺务Id"yearName":"2018"年份)I"SuppIier1.ist":前10供应商列表"ratelnvoiceCount":"0.026",发票张数占比可能01数值，或空值或者T"rateSalerAmount":"0.261",金额占比【可能01数值，或空值或者T"SaIerName":"深圳*科技有限公司，销方名称YotaIAmount":.7,销售金额"totallnvoiceCount":17发票抽"buyGoodsAnalysis":企业采购商品分析"goodsConcentration":"高",采购商品集中度"goodsGini":"0.767",采购商品集中系数可能01数值,或空值或者T"goodsTypeCount":69,累计采购商品种类数量"ItemslnvoiceCount":621,含商品明细发票份数"itemsSumAmount":.63,/含商品明细发票总金额"noneltemsInvoiceCount":21,无商品明细发票份数"noneltemsSumAmount":.43,无商品明细发票总金额"rateltemsAmount":"0.980,含商品明细发票金额占比可能01数值，或空值或者一"rateNoneltemsAmount":"0.020",无商品明细发票金额占比可能01数值，或空值或者一"totalAmounf:.98开票金额合计）I"headSupplierJUStiZSaChe":/头部供应商司法和关联预警（文档1.7版本新增）YaxNo":"供应商企业税号"，"CompanyName":"供应商企业名称，-ClisruptNumT失信被执行条数","UndertakerNum":"被执行条数，"CourtInfoNum":"法院公告条数”，"WenshuNumT裁判文书条数，FxecMoneyT总涉案金额"，"taxNoT供应商企业税号"，,companyName":"供应商企业名称",VeIatedType":"关联类型"，"relatedElement":"关联要素"，"relatedPositior:"关联企业职位，"SearchPosition":"杳询企业职位",1."headCustomerJustizsache":/头部客户司法和关联预警（文档1.7版本新增）YaxNo":"客户企业税号"，"CompanyName":"客户企业名称"，PisruptNum":"失信被执行条数”，"UndertakerNum":"被执行条数"，-CourtInfoNum":"法院公告条数”，"WenshuNum":"裁判文书条数"，FxecMoneyT总涉案金额，"taxNo":"客户企业税号”，"CompanyName":"客户企业名称",relatedType":"关联类型"，VeIatedEIementT关联要素"，"relatedPosition":"关联企业职位","SearchPosition":"查询企业职位",1."SuppIierArea":供应商按地区分组"area":"江苏省，地区"amount":.43,金额"rate":"183%"占比1."saleGoods":销售金额前10商品列表"goodsNamen:"*移动通信设备*2.4英寸液晶显示屏”,商品名称"rateAmount":"0.668",金额占比回能01数值，或空值或者T"ratelnvoiceCount":"0.636,发票张数占比可能0l数值，或空值或者T"specModel":"JX024-0,规格型号"totalAmount":605430.29,销售金额"totallnvoiceCount":7,发票张数"unit":"个"单位,"CustomerArea":客户区域分组("area":"江西省"，地区"amount":83600,金额"rate":"0.0%"比率可能01数值，或空值或者TI"SuppIierAnaIysish:企业供应商圈子分析("avgPurchaseAmount":.08,历史平均采购金额"months":8,有交易月份数rateTaxCreditA":"一，纳税顺供应商数量占比何能01数值或空值或者T"supplierconcentration":"较高）供应商集中度"suppliercount":52,累计牺商数量"SuppIierGinih:"0.863",艇商集中系数可能01数值，或空者T"taxCreditACount":0,纳税A级供应商数量"ta×CreditCount":0,纳税等级查得供应商数量"totaIAmount":.06,进项票总金额"totalCount":642进项票总张数I"SaleGoodsAnaIysis":企业销售商品分析("goodsConcentration":"高/扃品集中度"goodsGini":"0.697",主营商品集中系数可能01数值，或空值或者T"goodsInvoiceCount":I1.含商品明细发票份数"goodsSumAmount":906089.3,含商品明细发票总金额"goodsTypeCount":8,累计销售商品种类数量"noneGoodsInvoiceCount":2392,无商品明细发票份数"noneGoodsSurAmount":.05,无商品B月细发票总金额"rateGoodsAmount":"0.005",含商品明细发票金额占比可能01数值,或空侬者T"rateNoneGoodsAmount":',0.995nf无商品明细发票金额占比可能01数值，或空值或者T"totalAmounf:.01/开票金额合计,KuppIierYear":按年汇总-企业供应商"avgSupplierAmount":.08,年供应商平均交易金额"newSupplierAmount":.06,年汇总：新供应商交易金额"newSupplierCount":52,年汇总：册共应商妲"newSupplierInvoiceCount":642,年:口总：新供应商发票份数"rateNewSupplierAmount":"1.000",年汇总新供应商交易金额占比可能01数值，或空值或者一"totalIncomeAmount":.06,年进项有效票金额合计"totalIncomeCount":642,年进项有效票张数合计"totalSupplierCount":52,企业供应商数量"yearName":"2018"年份)I"taxkT:"*62129B",企业税务号nqueryTime":"2018-11-0115:54:02，直询时间"CustomerTrade":按月汇总一企业客户交易"avgAmount":.42,平均客户交易金额"rateToplOAmount":"1.OOO",/值JlO客户销售额占比()叵T能01数值，或空值或者T"rateToplOCount":"：1.oo(T,前10客户交易次数占比(%)可能01数值，或空值或者T"rateTop5Amount":"1.000",前5客户销售额占比()可能01数值，或%直或者T"rateTop5Count":"1.000",前5客户交易次数占比(%)可能01数值，或空值或者"SiimToplOAmount":.26,主要客户(前10)销售额合计"SumToplOCount":354,前10客户交易次数"sumTop5Amount":.26,主要客户(前5)销售额合计"sumTop5Count":354,前5客户交易次数"totalCustomer":3,企业客户数量"yearMonth":"2018-01"年月,"CustomerMonth":/假月汇总-企业客户开票("avgTop5Count":"63.6",当月开票张数最多的前5日平均开票张数"newCustomerCount":3,/惭客户数量"newInvoiceCount":354,新客户发票份数"newTotalAmount":.26,新客户交易金额TateNewAmount":"1.000",/新客户交易金额占比可能01数值，或期或"runlOAmount":.64,当月在连续10天内开票给同一主体的发票金额"yearMonth":"2018-01"年月,"endMonth":"2018-09",结束月份Pve同Info":综合评价（文档1.3版本新增）"avgAmountPerMonth":29",近1年月均开票金额"avgCountPerMonth":"300.4",近1年月均开票张数"CountInYear":"2403",近1年开票张数"CustomerCentraIity":"0.498",下游客户集中性可能01数值，或空值或者T"customerstability":"0.47",下游客户稳定性可能01数值，或空值或者T"growth":"0.0",成长性"negativeCount3Month":"1",/近三个月冲红张数"PartnerQuaIity":"0.00",圈子质量可能01数值，或空值或者T"riskInde×Str,:"0.50",风险指数可能01数值,或空值或者T"supplierCentrality":"0.863",上游供应商集中度可能01数值，或空值或者T"supplierStability":"0.19，上游供应商稳定性可能01数值，或空值或者T"totalAmount":".35",开票总金额"totalMonth":"8",开票月数"voidCount3Month":"0",近三个月作废张数"credit":"AAAA"企业自身纳税信用等级（文档1.6.1版本新增）l"saleBasic":按月汇总一销项票，匚总、（"invoiceAmount":.47,应税销售收入合计"OtherAmount":0,开票金额（其他发票）"OtherCountw:0,开票张数（其他发票）"PlainAmount":0,开票金额（普通发票）"PlainCount":0,开票张数（普通发票）"SpeciaIAmount":.66,开票金额（增值税专用发票）"SpeciaICount":364,开票张数（增值税专用发票）YotaIAmount":.66,开票金额合计"totalCount":364,开票张数合计"totalTaxAmount":.19,开票税额合计"yearMonth":"2018-01"年月"quota":/额度模型（文档1.6.1版本新增）"result"结果：通过、未通过"company_name":"",公司名称"detail":"score":900,评分"credilimit”:200,000,建议额度"reason":"原因"，wcreate.datew:"2019-05-30”）,"enterprise""/工商信息（文档1.6.2版本新增）"basic""/工商基本信息"name":"企业名称，"econKindT企业类型"，"registCapi":"注册资本，"address":"地址，KCOPe":"经营范围，"termStart":"营业开始日期，"termEnd":"营业结束日期”，"oPerNameT企业法定代表人，-StartDateT成立日期，"CheckDateT核准日期","status":"经营状态"，FeditNo":.统一社会信用代码，"domains":"行业"，"industryName":"一级行业""partners"：1/股东信息"identifyNo":"证彳牛号码"，TdentifyTypeT证彳牛类型”，"name":"股东姓名"，"StockJype":"股东类型，YotaIReaIC叩i":"累计实缴额”，YotalShouIdCapi":"累计认缴额"，WStoCkRate丁持股比例”)1."employees":/M管信息(1JobTitIeT职位"，"name":"姓名")1."changerecords":/变更信息("afterContent":"变更后内容”，"beforeContent":"变更前内容"，"ChangeDate":"变更日期”,"changeitem":"变更项目1.“abnormaI":经营异常信息（"inDate":"列入日期"，"inReason":2经营异常列入原因”,"OUtDateT移出时间，"OUtReasonT移出原因”"disrupt”:失信被执行人信息（文档1.6.2版本新增）"name丁失信被执行人姓名/称"，"regDate":"立案时间"，"CourtName?执行法院"，"performance":"履行情况"，"disreputTypeName":"失信被执行人具体情形”,"undertaker”被执行人信息（文档1.6.2版本新增）"name":"姓名/公司名称，"caseCode":"案号"，"CourtName":"执行法院"，"regDateT立案时间，"execMoney":"执行标的""courtlnfo":/法院公告（文档1.6.2版本新增）"fctParty":"姓名/公司名称，"fctGgpersonT'公告人"，"fctClass":"公告类型，"fctGgdateT公告时间"，"fctExecutiondocT公告内容""wenshu":裁判文书(文档1.6.2版本新增)"judgeTitle":"文书标题，"CaseTypd:"案件类型"，"judgeDate":文书日期"，"CaseCode":"案件号")/文档17.3新增指标START/"SaIesYear1.ist":/假年统计每月开票收入情况("normalAmount":开票金额2 .E71月份1.E7/2月份3 .E7,/3月份4 .E7/4月份5 .E7,/5月份6 .E7/6月份7 .E7/7月份8 .E7/8月份1E7,“9月份O1/10月份0,/11月份0/12月份1."total":.25,总开票金额year":'2019"年份"enterpriselnfoPrompt":工商司法提示navgOperMonth":"253.0",当前法人及股东平均司龄（月）"CntIntangibIeAssets":2,/商标及专利信息数"cntOperChange3yr":O1/3年内法人、股东变更次数"CourtInfoCount-:1法院公告条数nCpOperMonth-:253,/企业成立距今月份数（月）"disruptcount":0失信被执行条数"regiCapitalPer3yr":"15.67"3年内注册资本变化比例"taxOverdueAmount":0,/当前欠税金额（元）"totalA