集团采购部每年四月做一轮供应商复审表格里有一栏叫“经营规模”往年照抄注册资本。今年审计翻到三十家供应商的底稿问了一句这三十家注册资本都在一千万以上为什么有两家去年就停业了。复审真正想确认的只有两件事这家公司现在还有没有人在正常上班股东的钱到底有没有真进来。注册资本是认缴口径写在章程里可以约定十年后才缴足回答不了这两个问题而企业自行填报并公示的年报恰好有能回答这两件事的栏目。改法很直接把供应商发来的截图换掉后端按企业名称或统一社会信用代码调一次企业年报详情把社保参保人数和股东实缴出资落到复审表上。审计那条问题才算有了能写进流程的答案。文中公司名称、注册号、金额与日期均为官方文档测试数据仅用于说明字段结构。认缴写的是承诺实缴写的是到账章程上的注册资本是股东认缴的总额可以分期到位日期可以写得很远。年报的股东出资栏目把两种口径并排放认缴出资额、认缴出资时间、认缴出资方式以及实缴出资额、实缴出资时间、实缴出资方式。只看前者等于只看了一张欠条。判断供应商的体量看差额更实在。认缴五千万、实缴为零的公司不该被一票否决——不少正常经营的公司确实在分期缴纳但也不该按五千万的授信口径给账期。复审表里我加了两列实缴占认缴的比例以及实缴时间为空的条数。比例长期为零的转人工问一句比例逐年爬升的说明股东还在往里投钱是个正面信号。只有一个 query 参数三个请求头才是重点接口是GET https://api.shuxuntech.com/v1/enterprise_report/query。请求头三个appKey、timestamp当前时间的毫秒数、signquery 只有一个keyword可以填企业名称、统一社会信用代码或注册号。签名规则是sha256(appKey timestamp appSecret)。三处容易错。时间戳要用 13 位毫秒写成 10 位秒级服务端算出的签名一定对不上参与签名的 timestamp 字符串和放进请求头的那一个必须是同一个变量前后各取一次时间就会差几毫秒appSecret只能留在服务端前端直连等于把密钥发给所有人。keyword优先填统一社会信用代码企业改名后按名称查不到代码一直指向同一主体。一段能直接跑的 Python 调用文档只给了字段没给完整结构所以解析不写死路径按特征找数组缺字段时降级而不是抛异常。importhashlibimporttimeimportrequests APP_KEYyour_app_keyAPP_SECRETyour_app_secretURLhttps://api.shuxuntech.com/v1/enterprise_report/querydeffetch(keyword:str,timeout(0.8,4.0))-dict:tsstr(int(time.time()*1000))# 毫秒签名与请求头共用同一个值signhashlib.sha256((APP_KEYtsAPP_SECRET).encode(utf-8)).hexdigest()resprequests.get(URL,params{keyword:keyword},headers{appKey:APP_KEY,timestamp:ts,sign:sign},timeouttimeout,)resp.raise_for_status()bodyresp.json()ifbody.get(code)!0:# 顶层码只说明这次调用成不成功raiseRuntimeError(fcall failed:{body.get(code)}{body.get(msg)})returnbody.get(data)or{}defpartner_rows(data:dict)-list:# 股东出资那一栏首个带 shouldCapi 键的字典数组forvindata.values():ifisinstance(v,list)andvandisinstance(v[0],dict)andshouldCapiinv[0]:returnvreturn[]defpaid_ratio(row:dict):# 认缴与实缴成对读缺值返回 None绝不当成 0try:returnround(float(row[realCapi])/float(row[shouldCapi]),4)except(KeyError,TypeError,ValueError,ZeroDivisionError):returnNoneif__name____main__:forrowinpartner_rows(fetch(91330100MA2XXXXXXX)):print(row.get(name),row.get(realCapi),row.get(realDate),paid_ratio(row))paid_ratio里那个except是故意的认缴为零、实缴是未公示、字段缺失都会走到这里。让异常流成None下游看到的是“没有数据可算”而不是被 0 除或者假的 0%。返回的是按年度组织的材料不是当前状态这个接口返回的不是快照而是一份按报送年度组织的材料。企业基本信息里的名称、电话、地址、经营状态都是填报时点的值经营状态写“开业”说的是那一年填报时的状态不能当成今天的登记状态用。要判断主体现在是否存续、是否被列入异常名录走登记信息类查询不要拿年报替代。还有一层年报的部分栏目允许企业选择不公示。同一份年报里有的栏目是数字有的是企业未公示有的是这一期没返回来。取值必须分三态——数字、企业未公示、接口未返回——下游处置完全不同。把后两种都塞成 0资产、社保、纳税会一起失真而且全程不报错。社保栏量的是缴社保的人不是员工总数社保信息栏里的参保人数量的是这家公司给自己员工缴社保的人数。它不等于员工总数劳务派遣、外包、个体户用工都不在里面各地申报口径也有差别。所以它适合当“这家公司还有没有人在正常上班”的证据不适合直接换算营收。纵向看比单年看有用。连续两三年人数稳定或小幅上升说明业务还在运转一年掉一半同时实缴出资停滞、股东名单收缩就是复审要当面问的问题。只看某一年的数字下结论容易被一次组织架构调整带偏把销售团队整体转成外包参保人数会掉业务未必掉。和资产、纳税两栏交叉看才稳。社保人数稳、纳税额稳、实缴停滞通常是股东不再追加投入但经营正常三栏同时往下走才值得拉响警报。任何一栏是未公示就把这一栏标成“未披露”而不是零。七个出资字段不要只看合计股东及发起人出资信息里文档给了七个字段name股东或发起人、shouldCapi认缴出资额、shouldDate认缴出资时间、shouldType认缴出资方式、realCapi实缴出资额、realDate实缴出资时间、realType实缴出资方式。三个配套字段都要看。出资方式决定“到账”的含金量货币出资是真金白银实物和知识产权出资要评估作价账面数字和可动用现金不是一回事。出资时间和章程约定的期限要对早于约定是提前到位晚于约定还没缴是合同里要补条款的。多名股东要逐条比不能只看合计——一个大股东实缴到位、其余挂空和平均到位风险完全不同。查完之后还要补的四件事缓存按主体加年度。年报一年报送一次复审季同一家公司会被不同部门查很多遍。缓存 key 用统一社会信用代码加报送年度TTL 给到 30 天以上既省调用也避免同一份材料在几个页面里长得不一样。并发要合并。查询幂等计费按次不幂等页面刷新连点、批量导入里同一家公司出现三遍都会各扣一次。用信用代码做短锁后到的请求等前一个结果几十秒内复用。超时与重试分开。连接超时 800 毫秒、总超时 4 秒复审页面有人在等。只对超时和系统类异常重试上限两次指数退避加随机抖动鉴权、参数、额度类错误重试没有意义直接告警到人。脱敏与降级。响应里带电话、地址、股东姓名都属于个人信息日志只留调用流水号、结果码和信用代码后六位不落完整号码和地址快照按项目设留存期到期只保留统计口径。接口持续异常时页面回退到缓存里上一份快照标注年度同时把这家公司推进人工复核队列不要让复审卡在加载动画上。它不该承担的判断和几条合规红线这个接口不做实时监控也不做审计结论。它给的是企业自行填报并公示的年报不判断履约能力、涉诉、失信、经营异常——这些栏目文档里没有。新设企业当年可能还没到首次报送查不到属于正常不能推成“公司有问题”。个体户、分支机构的公示口径和有限公司不同也不该套同一组阈值。合规上守住四条只用于供应商准入、授信评审、招投标资审这类有真实业务关系的场景并在告知书里写清会委托第三方接口服务商核验企业公示信息只取需要的栏目不要把整份年报落库展示和导出按规则打码数据不长期留存、不二次对外提供。平台只做标准化封装不采集、不留存原始数据。价格、试用与接入顺序免费试用 5 次属于企业专用接口需要企业认证后开通企业认证还会额外赠送 666 次调用额度。标准单价 0.16 元/次按调用量分档调用量价格单价5 次¥ 0¥ 015 次¥ 5¥ 0.333333500 次¥ 120¥ 0.241,000 次¥ 220¥ 0.225,000 次¥ 1,000¥ 0.210,000 次¥ 1,900¥ 0.1930,000 次¥ 5,500¥ 0.18333350,000 次¥ 8,000¥ 0.16500 次档到 50,000 次档单价从 0.24 元/次走到 0.16 元/次但复审场景真正省钱的还是缓存按主体年数计费不按人次数。接入顺序建议是先用 5 次免费额度把签名、结果码分支和“企业未公示”三态跑通再按实际供应商数量选档。额度叠加、有效期内不清零采购后可开增值税发票。把截图换成一次接口调用复审会上争论的东西就从“这家公司靠不靠谱”变成了“社保人数为什么掉了四成、实缴为什么还是零”。前者没人答得上来后者可以去问。商品页https://shuxuntech.com/productDetail/34本文含商业推广信息产品参数与价格整理自数勋科技官网价格及活动以官网当期为准。