基于天远人企关联构建自动化B2B供应商准入架构

破解B2B供应商准入痛点：从传统人工核查到数据直连

在现代大型B2B采购与供应链管理中，确保供应商资质的真实性和关联关系的透明度是防控履约风险的核心环节。传统模式下，采购方往往需要供应商提交繁琐的纸质营业执照、法人身份证件以及授权委托书，随后由法务或合规专员进行人工比对。这种方式不仅流程冗长、效率低下，且难以实时防范信息不匹配资质或非存续异常主体带来的合约隐患，极易在后续履约中引发信用合规问题。

通过引入人企关联 API，企业在获得供应商授权的前提下，系统只需传入法人或主要管理人员的身份证号（id_card）与姓名（name），即可直连权威数据源进行双向核验。系统能够毫秒级解密获取关键合规字段，例如统一社会信用代码（creditNo）、企业登记或经营状态（companyStatus）以及该人员在企业中的具体角色（如法定代表人 lp 或股东 sh）。这些客观、不可篡改的数据，为企业的供应商分层、准入评估与合规流转提供了坚实的数据支撑。

将合规审查动作无缝嵌入 Java 业务微服务或风控网关中，不仅实现了前置自动化合规审查，极大降低了人工复核的成本，还能在供应商注册或投标的第一时间拦截潜在的资信隐患。这种数据穿透能力，让整个供应链生态更加健康，业务流转更加顺畅。

1. Java 加密通信集成：构建高可用审核管道

1. 核心参数与加密配置

• 接口地址 : https://api.tianyuanapi.com/api/v1/QYGL101A?t={``{13位时间戳}}
• 请求方式 : POST
• 请求头 :
  • Access-Id: 账号的 Access-Id (必填)
  • Content-Type: application/json
• 关键入参 :
  • id_card: 身份证号（必填）
  • name: 姓名（必填）
• 鉴权与加密机制 : 使用账户的 16 进制 Access Key 作为密钥，采用 AES-128 算法的 CBC 模式。每次请求需动态生成 16 字节的 IV（初始化向量），并配合 PKCS7 填充，最终将 IV 与密文拼接后进行 Base64 编码放入请求体 data 字段中。

2. 标准化调用代码 (Java)

import javax.crypto.Cipher;
import javax.crypto.spec.IvParameterSpec;
import javax.crypto.spec.SecretKeySpec;
import java.nio.charset.StandardCharsets;
import java.security.SecureRandom;
import java.util.Base64;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Instant;

public class ApiClient {
    private static final String ACCESS_KEY_HEX = "你的16进制AccessKey";
    private static final String ACCESS_ID = "你的AccessId";
    private static final String API_URL = "https://api.tianyuanapi.com/api/v1/QYGL101A";

    public static byte[] hexStringToByteArray(String s) {
        int len = s.length();
        byte[] data = new byte[len / 2];
        for (int i = 0; i < len; i += 2) {
            data[i / 2] = (byte) ((Character.digit(s.charAt(i), 16) << 4)
                                 + Character.digit(s.charAt(i+1), 16));
        }
        return data;
    }

    public static String encryptAndEncode(String plainText, String hexKey) throws Exception {
        byte[] keyBytes = hexStringToByteArray(hexKey);
        SecretKeySpec secretKeySpec = new SecretKeySpec(keyBytes, "AES");
        
        byte[] iv = new byte[16];
        new SecureRandom().nextBytes(iv);
        IvParameterSpec ivSpec = new IvParameterSpec(iv);
        
        Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
        cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, ivSpec);
        byte[] cipherText = cipher.doFinal(plainText.getBytes(StandardCharsets.UTF_8));
        
        byte[] combined = new byte[iv.length + cipherText.length];
        System.arraycopy(iv, 0, combined, 0, iv.length);
        System.arraycopy(cipherText, 0, combined, iv.length, cipherText.length);
        
        return Base64.getEncoder().encodeToString(combined);
    }

    public static void main(String[] args) {
        try {
            String requestPayload = "{\"id_card\":\"110105199001011234\",\"name\":\"张三\"}";
            String encryptedData = encryptAndEncode(requestPayload, ACCESS_KEY_HEX);
            
            String jsonBody = "{\"data\":\"" + encryptedData + "\"}";
            String urlWithTime = API_URL + "?t=" + Instant.now().toEpochMilli();

            HttpClient client = HttpClient.newHttpClient();
            HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(urlWithTime))
                    .header("Access-Id", ACCESS_ID)
                    .header("Content-Type", "application/json")
                    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
                    .build();

            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
            System.out.println("Response: " + response.body());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3. 终端快捷验证 (cURL)

curl -X POST "https://api.tianyuanapi.com/api/v1/QYGL101A?t=$(date +%s000)" \
     -H "Access-Id: your_access_id" \
     -H "Content-Type: application/json" \
     -d '{"data":"生成好的Base64加密串"}'

2. 核心人企关联数据解析与业务映射

• success: 请求是否成功完成，涵盖有数据与暂无数据状态。
• resultCode: 查询状态码，1代表查到关联企业，0代表暂无关联。
• companyName: 关联企业名称，用于比对供应商填报资质。
• legalPersonName: 法定代表人姓名，核对注册人身份。
• relationship: 核心人企关系类型（lp 法定代表人、tm 高管、sh 股东）。
• companyStatus: 企业登记或经营状态，识别注销或吊销等非存续异常主体。
• creditNo: 统一社会信用代码，构建企业画像的关键标识。
• isHistory: 0 为当前关系，1 为历史关系，辅助判断当前掌控权。

技术提示 ：在落库或向前端输出日志时，务必对敏感个人信息（PII）进行脱敏处理，例如身份证号保留首尾，处理为 110105********1234。

3. 场景化应用：让核验数据赋能合规闭环

在B2B采购系统中，人企关联 API 的典型合规流转逻辑如下：

1. 供应商自动入驻审查 ：企业代表在平台提交入驻申请。系统获取代表姓名与身份证号，调用接口。若返回的 companyStatus 为"在营"且 relationship 匹配为 lp（法人），系统自动通过前置准入校验，进入开户流程；若为 isHistory=1，则引导其补充最新的企业授权证明文件。
2. 企业信贷授信评估：金融机构在进行企业供应链金融授信时，通过传入实际控制人信息，核查其名下是否存在其他非存续异常主体，或是否存在多头挂职的高管记录，从而完善企业资信评估模型。
3. 电子合同签署前置确认：在企业间签署大额电子采购合同前，自动化审查签字人是否确为该企业当前的高管或法人，避免越权签署导致的法律合规问题，若不匹配则自动触发人工复核提醒。

4. 生产环境接入的安全与合规边界

在生产环境集成该接口时，需严格遵循以下准则：确保在调用接口前，已通过协议或弹窗获取用户的明确授权，严禁违规采集；在传输与存储环节，务必依赖强大的AES+IV动态加密机制，严禁明文记录身份证号等关键字段；此外，建议在业务网关层建立合理的限流控制，防止恶意并发查询冲击系统并保障合规调用的持续稳定。