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

《金蝶金融税票征信服务接口标准说明书.docx》由会员分享，可在线阅读，更多相关《金蝶金融税票征信服务接口标准说明书.docx（45页珍藏版）》请在课桌文档上搜索。

1、金蝶金融税票征信服务接口标准说明书修改记录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中增加企业纳税信用等级字段credi

2、t1.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李祥修改指标：SaleGoodsAnaIysisx

3、salesTypesxSaIesRatesxbuyGoodsAnalysisxincomestatistics新增指标：参见返回示例中的标注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 签名

4、方式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);StringpublicK

5、ey=nMIGfMAOGCSqGSIbBDQEBA*,;StringencrData=pt(NString(),publicKey,vector);.printing加密报文：+encrData);1.1.2 签名方式接入方对自己请求报文字符串进行签名(所有需签名字段按key的字典序连接,组成keyl=valuel&key2=value2的方式)，即：用户自行生成签名密钥对，同时将签名公钥发给平台对接人，私钥留下自己注意保密，通过生成的签名私钥进行签名，产生签名值。同时通过平台签名公钥和平台返回签名值进行验签。根据用户自己的签名私钥对加密报文进行签名StringsignSource=a=bic

6、=d;StringSignatUre=(SignSOUrce,SignPrivateKey);.println(签名值:+signature);根据平台签名公钥对平台返回的报文进行验证签名booleanisTrue=datalSignPubIicKey,sign);2贷审税务报告查询接口2.1贷审税务报告查询接口接口地址：ort/preloan加密前输入：参数是否必填是否需要签名说明Clientjd是是idclient_secret是是secrettaxld是是企业税务号或企业名称StartMonth否是查询开始月份，格式yyyy-MM例如:2018-01endMonthS是查询结束月份，格式

7、yyyy-MM例如2018-07sign是否签名值加密后输入:参数是否必填说明appid是同ClientJddata是加密的请求参数vector是偏移向量请求实例POST方式传递JSON参数格式：(appid,20*77data,hXX91ga5BYI4H7NXk7jh62v7OftQyH+lmdKQMnIVF3OHWcK0YXK656SjEkmbuiOsslcoy480GiMDHdVgXyJOIfMaaGX8SHaZOBwQAP7P7zyTe+b2xcnZ+r9PPENaAhkKxZK41.Ydnvl1.P33EsT7etmzBalnqPZp8l9Y4Q4+QvidBX7IhxaIuOJIB

8、eYTfDBCsmmC+bRI1.pGBhR3YAyj+bvoY+bEXlID5aPvYe1.kqli7a7zKWo9OwpMl7joCPPD9j5NJXRhW4W1.BpZRr4sG5XkPna8ck6wB+hhSyWqjiFjHgIh27O6b8uiuiTJdOXft)dDZFecPSw7lE*WGgOUtECIF+Z1.ag01kyl1.vCXZA8iI3E+R4Ftlc58二，vectorw:28cc8da8M输出字段返回示例（解密后）：（data:supplierstability:供应商稳定指数（-SUPPStabilityIndex:0.19,胭商数可能01数值，或利直或者Tsu

9、pplierstability:轻度稳定”,供应商稳定度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:

10、/南十大客户列表NyerName深圳市*供应链管理有限公司,购方名称rateBuyerAmount:0.502,销售金额占比可能01数值，或空值或者TratelnvoiceCount:0.525,发票张数占比可能01数值，或空值或者TYotaIAmount:.65,销售金额totallnvoiceCount:1262发票张数,StartMonth:2015-0”开始年月CompanyName:深圳市*科技有限公司,/企业名称bankAccounts:企业银行信息bankAccount:银行账号bankName中国银行股份有限公司深圳大浪支行”,开户银行CompanyName:深圳市*科技有限公

11、司，企业名称rate:1.000”,金额占总开票金额比可能01数值，或空值或者一taxNo:*62129B,纳税人期号totalAmount:.35,该账号开票总金额totalCount:2403该账号开票总张数)IsalesRates:/假月汇总-销项票说率统计(rateOPer:0.000,/顺率0%占比可能01数值，或空值或者TratelOPer:0.000,税率10%占比可能01数值，或空值或者TratellPer:OOOO,税率11%占比可能01数值，或空值或者7ratel3Per:0.00(,/厩率13%占比可能01数值，或空值或者Tratel6Per:0.000,税率16%占比可

12、能01数值，或空值或者Tratel7Per:1.oO(T,除17%占比可能01数值，或空值或者Trate3Perh:-0.000,/顺率3%占比可能01数值，或空值或者7rate5Pern:0.000,/税率5%占比可能01数值，或空值或者Trate6Per:0.000,/顺率6%占比可能01数值，或空值或者TrateMutiPer:0.000,一票多税率占比可能01数值，或空值或者一rateOtherPer:0.362,/段他占比yearMonth:2018-01年月,CustomerAnaIysis:企业客户圈子分析VgBuyerAmount:.59,/历史平均销售金额customerco

13、ncentration:阚氐,客户集中度CustomerCount:4,累计客户数量CustomerGini:0.498,客户集中系数（基尼系数）可能01数值，或空值或者一months:8,#交易月份数rateTaCreditA:纳税A级客户数量占比可能01数值，或空值或者TtaCreditACount:0,纳税A级客户数量taxCreditCount:0,纳税等级查得企业数量totalAmount:.35,收入开票总金额totalCount:2403收入开票总张数）1.incomestatistics:按月汇总一进项票汇总negativeAmount:0,/进项冲I金额合计negativeC

14、ount: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:开票基本情况汇总

15、(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,历史最长连续未开票天数maG

16、apDaysl2:27,最近12个月最长连续未开票天数maGapDays6:27,最近6个月最长连续未开票天数“smaxMonths:7,最早一张销项发票距离现在的月份数sminDays:9,最近一张销项发舞巨离现在天数YotaIAmount:.35,历史总开票金额totalAmountFor!2:.35,/商12个月合计开票金额YotalAmountFor24:.35,/隔24个月合计开票金额YotalAmountFor36:.35,/隔36个月合计开票金额YotaIAmountPerMonth:.529167,近一年月均开票金额totalCount:2403历史总开票笔数)VSuppIie

17、rTrade:按月;口总一企业供应商交易avgAmount:542546.62,平均彳蛔商交易金额rateToplOAmounf,:0.901，/廊10供应商销售额占比()可能01数值，或空值或者TrateToplOCount:0.471,前10供应商交易次数占比(%)可能01数值，或空值或者TrateTop5Amount:0.799,前5供应商采购额占比（）可能01数值，或空值或者TrateTop5Count:0.161”,前5供应商交易次数占比（%）可能01数值，或空值或者TSiimToplOAmount:.44,主要供应商（前10）销售额合计SumToplOCount:146,前10供应

18、商交易次数sumTop5Amount:.79,主要供应商（前5）销售额合计sumTop5Count:50,/廊5供应商交易次数totalsupplier:36/供应商数量yearMonth:2018-08年月,SuppIierMonth:按月汇总-企业新供应商开票newInvoiceCount:119,册共应商发票份数newSupplierCount:20,FiewTotaIAmount:.04,新供应商交易金额rateNewAmounf:0.107,新供应商交易金额占比可能01数值，或空值或者TyearMonth:2018-08年月,ldataStartDate:2018-01-05,最早发

19、票开票日期dataEndDate:2018-08-31,最近发票开票日期purchaseGoods:采购商品列表前10goodsName:*计算机外部设备*液晶显示屏,/W品名称rateAmount:0.096,金额占比可能01数值，或空值或者TratelnvoiceCount:0.081，发票张数占比可能01数值，或空值或者TspecModel:PJ050IA,规格型号YotaIAmount:.02,采购金额totllnvoiceCount:50,/发票张数unit:片单位,CustomerYear:按年汇总一企业客户avgCustomerAmount:.59,年企业平均交易金额newCus

20、tomerCount:4,年汇总：新客户数量newCustomerInvoiceCount:2403,年汇总：新客户发票份数newCustomerTotalAmount:.35,年汇总：新客户交易金额rateNewCustomerAmount:TOOO,年汇总：新客户交易金额占比可能01数值,或空值或者TtotalCustomerCount:4,企业客户数量totalSalesAmount:.35,年有效票金额合计totalSalesCount:2403,年有嬷张数合计yearName:2018年份)IsalesTypes:做月汇总T项票分类统计(negativeAmount:0,冲红票额合计

21、negativeCount:0,冲红张数等十normalAmount:.26,/效票金额合计normalCount:354,/W嬷张数合计normalTaxAmount:.89,有税额合计ratelntegerAmount:0.041，开票金额为整数的发票金额占比(%)可能01数值，或空值或者rateIntegerCount:0.04”开票金额为龈的发票张数占总%X可能01数值，或空值或者TVoidedAmount:536466.4,作废票额等十-VOidedCOUnt:10,作废张数合计yearMonth:2018-0；年月normalTaxAmount:.43,/应税销售收入totalcu

22、stomer:302/客户数，rateNegativeAmount:0.037/冲红作废金额比l,customerstability:客户稳定指数CUStStabiIityIndex:0.47,客户稳定指数可能01数值，或空值或者Tcustomerstability:中度稳定,客户稳定度taxld:*62129B,/顺务IdyearName:2018年份)ISuppIier1.ist:前10供应商列表ratelnvoiceCount:0.026,发票张数占比可能01数值，或空值或者TrateSalerAmount:0.261,金额占比【可能01数值，或空值或者TSaIerName:深圳*科技有

23、限公司，销方名称YotaIAmount:.7,销售金额totallnvoiceCount:17发票抽buyGoodsAnalysis:企业采购商品分析goodsConcentration:高,采购商品集中度goodsGini:0.767,采购商品集中系数可能01数值,或空值或者TgoodsTypeCount:69,累计采购商品种类数量ItemslnvoiceCount:621,含商品明细发票份数itemsSumAmount:.63,/含商品明细发票总金额noneltemsInvoiceCount:21,无商品明细发票份数noneltemsSumAmount:.43,无商品明细发票总金额rate

24、ltemsAmount:0.980,含商品明细发票金额占比可能01数值，或空值或者一rateNoneltemsAmount:0.020,无商品明细发票金额占比可能01数值，或空值或者一totalAmounf:.98开票金额合计）IheadSupplierJUStiZSaChe:/头部供应商司法和关联预警（文档1.7版本新增）YaxNo:供应商企业税号，CompanyName:供应商企业名称，-ClisruptNumT失信被执行条数,UndertakerNum:被执行条数，CourtInfoNum:法院公告条数”，WenshuNumT裁判文书条数，FxecMoneyT总涉案金额，taxNoT供应

25、商企业税号，,companyName:供应商企业名称,VeIatedType:关联类型，relatedElement:关联要素，relatedPositior:关联企业职位，SearchPosition:杳询企业职位,1.headCustomerJustizsache:/头部客户司法和关联预警（文档1.7版本新增）YaxNo:客户企业税号，CompanyName:客户企业名称，PisruptNum:失信被执行条数”，UndertakerNum:被执行条数，-CourtInfoNum:法院公告条数”，WenshuNum:裁判文书条数，FxecMoneyT总涉案金额，taxNo:客户企业税号”，C

26、ompanyName:客户企业名称,relatedType:关联类型，VeIatedEIementT关联要素，relatedPosition:关联企业职位,SearchPosition:查询企业职位,1.SuppIierArea:供应商按地区分组area:江苏省，地区amount:.43,金额rate:183%占比1.saleGoods:销售金额前10商品列表goodsNamen:*移动通信设备*2.4英寸液晶显示屏”,商品名称rateAmount:0.668,金额占比回能01数值，或空值或者TratelnvoiceCount:0.636,发票张数占比可能0l数值，或空值或者TspecMode

27、l:JX024-0,规格型号totalAmount:605430.29,销售金额totallnvoiceCount:7,发票张数unit:个单位,CustomerArea:客户区域分组(area:江西省，地区amount:83600,金额rate:0.0%比率可能01数值，或空值或者TISuppIierAnaIysish:企业供应商圈子分析(avgPurchaseAmount:.08,历史平均采购金额months:8,有交易月份数rateTaxCreditA:一，纳税顺供应商数量占比何能01数值或空值或者Tsupplierconcentration:较高）供应商集中度suppliercount

28、:52,累计牺商数量SuppIierGinih:0.863,艇商集中系数可能01数值，或空者TtaxCreditACount:0,纳税A级供应商数量taCreditCount:0,纳税等级查得供应商数量totaIAmount:.06,进项票总金额totalCount:642进项票总张数ISaleGoodsAnaIysis:企业销售商品分析(goodsConcentration:高/扃品集中度goodsGini:0.697,主营商品集中系数可能01数值，或空值或者TgoodsInvoiceCount:I1.含商品明细发票份数goodsSumAmount:906089.3,含商品明细发票总金额go

29、odsTypeCount:8,累计销售商品种类数量noneGoodsInvoiceCount:2392,无商品明细发票份数noneGoodsSurAmount:.05,无商品B月细发票总金额rateGoodsAmount:0.005,含商品明细发票金额占比可能01数值,或空侬者TrateNoneGoodsAmount:,0.995nf无商品明细发票金额占比可能01数值，或空值或者TtotalAmounf:.01/开票金额合计,KuppIierYear:按年汇总-企业供应商avgSupplierAmount:.08,年供应商平均交易金额newSupplierAmount:.06,年汇总：新供应商

30、交易金额newSupplierCount:52,年汇总：册共应商妲newSupplierInvoiceCount:642,年:口总：新供应商发票份数rateNewSupplierAmount:1.000,年汇总新供应商交易金额占比可能01数值，或空值或者一totalIncomeAmount:.06,年进项有效票金额合计totalIncomeCount:642,年进项有效票张数合计totalSupplierCount:52,企业供应商数量yearName:2018年份)ItaxkT:*62129B,企业税务号nqueryTime:2018-11-0115:54:02，直询时间CustomerTr

31、ade:按月汇总一企业客户交易avgAmount:.42,平均客户交易金额rateToplOAmount:1.OOO,/值JlO客户销售额占比()叵T能01数值，或空值或者TrateToplOCount:：1.oo(T,前10客户交易次数占比(%)可能01数值，或空值或者TrateTop5Amount:1.000,前5客户销售额占比()可能01数值，或%直或者TrateTop5Count:1.000,前5客户交易次数占比(%)可能01数值，或空值或者SiimToplOAmount:.26,主要客户(前10)销售额合计SumToplOCount:354,前10客户交易次数sumTop5Amoun

32、t:.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天内开票给同一主体的

33、发票金额yearMonth:2018-01年月,endMonth:2018-09,结束月份Pve同Info:综合评价（文档1.3版本新增）avgAmountPerMonth:29,近1年月均开票金额avgCountPerMonth:300.4,近1年月均开票张数CountInYear:2403,近1年开票张数CustomerCentraIity:0.498,下游客户集中性可能01数值，或空值或者Tcustomerstability:0.47,下游客户稳定性可能01数值，或空值或者Tgrowth:0.0,成长性negativeCount3Month:1,/近三个月冲红张数PartnerQuaIi

34、ty:0.00,圈子质量可能01数值，或空值或者TriskIndeStr,:0.50,风险指数可能01数值,或空值或者TsupplierCentrality:0.863,上游供应商集中度可能01数值，或空值或者TsupplierStability:0.19，上游供应商稳定性可能01数值，或空值或者TtotalAmount:.35,开票总金额totalMonth:8,开票月数voidCount3Month:0,近三个月作废张数credit:AAAA企业自身纳税信用等级（文档1.6.1版本新增）lsaleBasic:按月汇总一销项票，匚总、（invoiceAmount:.47,应税销售收入合计Ot

35、herAmount: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:,公司名称de

36、tail: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:行

37、业，industryName:一级行业partners：1/股东信息identifyNo:证彳牛号码，TdentifyTypeT证彳牛类型”，name:股东姓名，StockJype:股东类型，YotaIReaIC叩i:累计实缴额”，YotalShouIdCapi:累计认缴额，WStoCkRate丁持股比例”)1.employees:/M管信息(1JobTitIeT职位，name:姓名)1.changerecords:/变更信息(afterContent:变更后内容”，beforeContent:变更前内容，ChangeDate:变更日期”,changeitem:变更项目1.“abnormaI:

38、经营异常信息（inDate:列入日期，inReason:2经营异常列入原因”,OUtDateT移出时间，OUtReasonT移出原因”disrupt”:失信被执行人信息（文档1.6.2版本新增）name丁失信被执行人姓名/称，regDate:立案时间，CourtName?执行法院，performance:履行情况，disreputTypeName:失信被执行人具体情形”,undertaker”被执行人信息（文档1.6.2版本新增）name:姓名/公司名称，caseCode:案号，CourtName:执行法院，regDateT立案时间，execMoney:执行标的courtlnfo:/法院公告（

39、文档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

40、月份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.673年内注册资本变化比例taxOverdueAmount:0,/当前欠税金额（元）totalA