如何将 VIES 增值税号核验接入企业进件
周五,您正在查看小微企业贷款业务的拒绝申请,几份德国申请接连出现,原因都标注为“增值税号未登记”。其中一家企业已经打来电话。负责人说,自己开出的每张发票上都有这个号码,想知道申请为什么卡在这里。上个月,一位中介提交的申请用了另一家企业的号码,您因此接入了增值税号核验。现在,相同的原因出现在情况各异的企业申请旁边,而周一又有新申请要处理。这个结果在进入决策前,应该代表什么?
VIES 返回的不只是有效或无效
VIES 响应可能包含注册状态、登记名称或登记系统错误。欧盟委员会的 VIES 服务会确认 VAT 号码是否已注册,响应中也可能包含登记名称。我们于 2026年10月30日使用自有机器发起调用,看到已注册号码返回名称、已注册号码未提供名称、未注册号码以及登记系统错误这几种情况。
一个德国号码第一次返回有效,名称显示为“---”,两分钟后再次查询却返回 MS_UNAVAILABLE。只读取 valid 的规则会通过第一次查询,即使没有名称可供比对。若把缺失的 valid 值当作无效,临时的登记机构故障就可能导致申请被拒。
| 回答类型 | 示例 | HTTP 状态码 | valid | 登记名称 | 仅读取 valid 的规则结果 |
|---|---|---|---|---|---|
| 已登记,返回名称 | IE6388047V | 200 | true | GOOGLE IRELAND LIMITED | 通过 |
| 已登记,未返回名称 | DE811569869, ESB82846825 | 200 | true | --- | 通过,但没有名称可供比对 |
| 未登记 | IE1234567X | 200 | false | --- | 拒绝 |
| 登记机构未响应,REST | DE811569869 | 200 | 未返回 | 未返回,错误为 MS_UNAVAILABLE | 找不到 valid |
| 登记机构未响应,SOAP | DE811569869 | 200 | 未返回 | 未返回,SOAP 故障响应为 MS_UNAVAILABLE | 找不到 valid |
| 登记机构繁忙,浏览器端点 | LV40003009497 | 200 | false | ---,错误为 MS_MAX_CONCURRENT_REQ | 拒绝 |
需要区分结果类型:登记状态说明号码是否出现在国家数据库中,登记名称则可用于核对申请人是否为登记企业。
状态页面无法判定单次查询结果
应根据每次调用的返回结果分类,状态页面只作参考。我们的调用中,登记机构繁忙时,浏览器接口返回了 isValid false 和 MS_MAX_CONCURRENT_REQ。单看这个 false 值,会把登记机构故障误判为号码未登记。
浏览器接口供 VIES 网页使用,已发布的 REST 协议文档描述的是另一个接口。状态接口显示的信息也与我们的调用结果双向不符:德国调用返回 MS_UNAVAILABLE 时,状态接口显示德国可用。拉脱维亚号码返回有效结果且带有名称时,状态接口却显示拉脱维亚不可用。
欧盟委员会说明,VIES 从成员国数据库获取信息,而这些数据库不受委员会控制。不同登记机构、不同调用的可用情况可能不同。
先识别服务错误,再判断登记状态
将申请中的国家代码和增值税号传给已发布的 VIES 服务,并为服务错误设置单独的结果。VIES 已发布的接口包括 REST 和 SOAP。REST 提供 POST /check-vat-number,SOAP 提供 checkVat。调用这两个接口都不需要密钥或账号。
在数据源中,通过决策流传入申请中的国家代码和号码。数据源会将返回结果加入本次决策的数据,供规则分类。读取 valid 前,先检查是否有错误:我们的德国调用中,REST 返回 HTTP 200 和 MS_UNAVAILABLE,但没有 valid 字段。REST 文档中的重试设置适用于连接问题和特定 HTTP 状态码。HTTP 200 响应中的 MS_UNAVAILABLE 不会触发重试,需要由决策流处理。
例如,错误响应应进入 unavailable 结果,可设为转交审核(refer)或稍后重试。valid 为 false 表示号码未注册,为 true 表示号码已注册。集成上线前,逐一测试各个分支是否进入预期决策。
单独核对登记名称
有效号码也可能属于其他企业。将登记名称与申请中的企业名称进行比对,并在决策表中分别设置登记状态和名称核验结果。
我们的德国和西班牙调用返回了有效号码,但名称和地址显示为“---”。企业名称匹配结果为 NOT_PROCESSED,因此没有名称可供比对。应将“---”归类为名称未披露。
例如,可以设置名称核对结果:返回名称包含申请企业名称时记为 match,名称为空或为“---”时记为 not disclosed,与申请企业名称不符时记为 mismatch。出现 mismatch 时,应交由人工复核。如果 VIES 未提供名称,可到相关企业登记机构查询登记名称。英国申请企业可查询 Companies House,作为企业登记信息核查的一个例子。
| 增值税号状态 | 名称核验 | 结果 | 原因 |
|---|---|---|---|
| 不可用 | 任意 | refer | VAT_CHECK_UNAVAILABLE |
| 无效 | 任意 | decline | VAT_NOT_REGISTERED |
| 有效 | 不匹配 | refer | VAT_NAME_MISMATCH |
| 有效 | 未披露 | refer | VAT_NAME_NOT_DISCLOSED |
| 有效 | 匹配 | pass | OK |
名称不匹配时交由人工复核,名称未披露时查询相应的企业登记机构。VIES 只是 小微企业贷款审核中的一项核验。
缓存响应前先核对使用条款
启用缓存前,请法务审查 VIES 条款是否允许预期用途。条款限制转发和其他用途,并明确禁止复制或再现其内容。请法务确认预期的接口接入和存储方式是否允许。
缓存还涉及一项技术风险。数据源缓存文档说明,HTTP 状态码低于 400 且能够解析的响应会被缓存。因此,HTTP 200 且正文可解析的 REST 响应,即使包含 MS_UNAVAILABLE,也可能像普通结果一样被缓存。
周一的新申请到来前,先配置好处理结果
周一的新申请到来前,先为这项核验配置好处理结果:
- 调用已发布的 REST 契约或 SOAP 服务,传入申请中的国家代码和增值税号。VIES 网页使用的是另一个浏览器接口。
- 读取
valid前先检查错误。错误应进入单独的处理结果,例如转人工处理或稍后重试。只有确认号码未登记时才拒绝。 - 发起调用并读取返回结果。根据每次调用的响应判断是否成功。状态页面可用于了解服务整体情况。
- 将登记名称与申请企业名称进行比对。号码有效但登记在其他名称下时,应设置单独的结果,交由人工复核。
- 将“---”归类为名称未披露,并到相应的企业登记机构核实名称。
- 通过 REST 缓存 VIES 响应前,请法务审查条款并批准预期用途。还需考虑缓存可能会将 HTTP 200 错误响应当作普通结果存储。
- 按照欧盟委员会关于税务检查的建议,在法务批准的形式下,将核验结果与决策一并保存。
VIES 增值税号核验常见问题
有没有免费的欧盟增值税号验证 API?
我们的调用不需要密钥或账号。欧盟委员会没有公布这项服务的价格。请核对条款,确认允许的用途。
MS_UNAVAILABLE 是什么意思?决策应如何处理?
MS_UNAVAILABLE 表示成员国的应用程序没有响应或无法使用。我们的德国调用返回了该错误,HTTP 状态码为 200。应将其导向单独的处理结果,例如转人工处理或稍后重试,而不是拒绝。
VIES 返回有效,能证明申请企业身份吗?
不能。有效号码可能属于另一家企业。应将登记名称与申请企业名称进行比对,名称不匹配时交由人工复核。
VIES 使用 REST 还是 SOAP?应该选哪个?
VIES 同时发布了 REST 和 SOAP 接口。选择集成方案支持的已发布接口,并测试错误如何进入决策流。
可以保存 VIES 返回结果并重复使用吗?
只有法务审查条款并批准预期用途后才可以。条款限制转发和其他用途,并禁止复制或再现其内容。保存或重复使用响应前,请与法务确认预期用途允许保存哪类核验记录。
VIES 调用需要多长时间?
我们在2026年10月30日的调用中,大多数响应耗时 0.4 到 0.8 秒,部分响应耗时更长。这些数据来自一个下午的测试,不代表服务承诺。请确保延迟或失败的调用进入单独的处理结果。