@yunzhanghu/sdk-nodejs 1.0.22 → 1.0.24

package/example/calculatelabor.js

@@ -69,3 +69,61 @@ caculatorLabor
   // 发生异常
   console.log(err.toString())
 })
+
+// 连续劳务年度税费测算-H5
+caculatorLabor
+.CalculationYearH5Url({
+
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
+    request_id: 'requestIdExample123456789',
+    dealer_id: config.dealer_id,
+    broker_id: config.broker_id,
+    color: "#FF3D3D",
+})
+.then((data) => {
+  if (data.code === '0000') {
+    // 操作成功
+    console.log('操作成功 ', data.data)
+  } else {
+    // 失败返回
+    console.log('失败返回 ', 'code：' + data.code + ' message：' + data.message + ' request_id：' + data.request_id)
+  }
+})
+.catch((err) => {
+  // 发生异常
+  console.log(err.toString())
+})
+
+// 连续劳务单笔结算税费测算-H5
+caculatorLabor
+.CalculationH5Url({
+
+    /**
+      * @param {string} request-id：请求 ID，请求的唯一标识
+      * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+      * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+      */
+    request_id: 'requestIdExample123456789',
+    dealer_id: config.dealer_id,
+    broker_id: config.broker_id,
+    real_name: "张三",
+    id_card:   "11010519491231002X",
+    color: "#FF3D3D",
+})
+.then((data) => {
+  if (data.code === '0000') {
+    // 操作成功
+    console.log('操作成功 ', data.data)
+  } else {
+    // 失败返回
+    console.log('失败返回 ', 'code：' + data.code + ' message：' + data.message + ' request_id：' + data.request_id)
+  }
+})
+.catch((err) => {
+  // 发生异常
+  console.log(err.toString())
+})

package/example/realName.js

@@ -0,0 +1,149 @@
+const yzhAPI = require('../yzh/index.js')
+const config = require('./conf/config.js')
+
+// 用户实名认证信息收集
+const realNameServiceClient = new yzhAPI.RealNameServiceClient(config)
+
+
+// 用户实名认证信息收集-人脸认证方式
+realNameServiceClient
+    .CollectRealNameInfo({
+
+        /**
+          * @param {string} request-id：请求 ID，请求的唯一标识
+          * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+          * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+          */
+        request_id: 'requestIdExample123456789',
+        dealer_id: config.dealer_id,
+        broker_id: config.broker_id,
+        real_name: "张三",
+        id_card: "11010519491231002X",
+        realname_result: 1,
+        realname_time: "2025-09-09 19:19:19",
+        realname_type: 1,
+        realname_trace_id: "1413536187796566016",
+        realname_platform: "xxxxxxx公司",
+        face_image_collect_type: 1,
+        face_image: "https://www.example.com/file_name.png",
+        face_verify_score: "89.12",
+    })
+    .then((data) => {
+        if (data.code === '0000') {
+            // 操作成功
+            console.log('操作成功 ', data.data)
+        } else {
+            // 失败返回
+            console.log('失败返回 ', 'code：' + data.code + ' message：' + data.message + ' request_id：' + data.request_id)
+        }
+    })
+    .catch((err) => {
+        // 发生异常
+        console.log(err.toString())
+    })
+
+// 用户实名认证信息收集-银行卡四要素认证方式
+realNameServiceClient
+    .CollectRealNameInfo({
+
+        /**
+          * @param {string} request-id：请求 ID，请求的唯一标识
+          * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+          * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+          */
+        request_id: 'requestIdExample123456789',
+        dealer_id: config.dealer_id,
+        broker_id: config.broker_id,
+        real_name: "张三",
+        id_card: "11010519491231002X",
+        realname_result: 1,
+        realname_time: "2025-09-09 19:19:19",
+        realname_type: 2,
+        realname_trace_id: "1413536187796566016",
+        realname_platform: "xxxxxxx公司",
+        bank_no: "6127000xxxxxxx16",
+        bank_phone: "188xxx8888",
+    })
+    .then((data) => {
+        if (data.code === '0000') {
+            // 操作成功
+            console.log('操作成功 ', data.data)
+        } else {
+            // 失败返回
+            console.log('失败返回 ', 'code：' + data.code + ' message：' + data.message + ' request_id：' + data.request_id)
+        }
+    })
+    .catch((err) => {
+        // 发生异常
+        console.log(err.toString())
+    })
+
+// 用户实名认证信息收集-人工审核
+realNameServiceClient
+    .CollectRealNameInfo({
+
+        /**
+          * @param {string} request-id：请求 ID，请求的唯一标识
+          * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+          * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+          */
+        request_id: 'requestIdExample123456789',
+        dealer_id: config.dealer_id,
+        broker_id: config.broker_id,
+        real_name: "张三",
+        id_card: "11010519491231002X",
+        realname_result: 1,
+        realname_time: "2025-09-09 19:19:19",
+        realname_type: 3,
+        realname_trace_id: "1413536187796566016",
+        realname_platform: "xxxxxxx公司",
+        face_image_collect_type: 1,
+        face_image: "https://www.example.com/file_name.png",
+        face_verify_score: "89.12",
+        bank_no: "6127000xxxxxxx16",
+        bank_phone: "188xxx8888",
+        reviewer: "908xxx8888",
+    })
+    .then((data) => {
+        if (data.code === '0000') {
+            // 操作成功
+            console.log('操作成功 ', data.data)
+        } else {
+            // 失败返回
+            console.log('失败返回 ', 'code：' + data.code + ' message：' + data.message + ' request_id：' + data.request_id)
+        }
+    })
+    .catch((err) => {
+        // 发生异常
+        console.log(err.toString())
+    })
+
+
+// 用户实名认证信息查询
+realNameServiceClient
+    .QueryRealNameInfo({
+
+        /**
+          * @param {string} request-id：请求 ID，请求的唯一标识
+          * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+          * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+          */
+        request_id: 'requestIdExample123456789',
+        dealer_id: config.dealer_id,
+        broker_id: config.broker_id,
+        real_name: "张三",
+        id_card: "11010519491231002X",
+    })
+    .then((data) => {
+        if (data.code === '0000') {
+            // 操作成功
+            console.log('操作成功 ', data.data)
+        } else {
+            // 失败返回
+            console.log('失败返回 ', 'code：' + data.code + ' message：' + data.message + ' request_id：' + data.request_id)
+        }
+    })
+    .catch((err) => {
+        // 发生异常
+        console.log(err.toString())
+    })

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@yunzhanghu/sdk-nodejs",
-    "version": "1.0.22",
+    "version": "1.0.24",
     "description": "云账户 SDK for Node.js",
     "main": "yzh/index.js",
     "scripts": {

package/src/services/calculatelabor/index.ts

@@ -2,68 +2,68 @@ import YZHclient from '../../common/client';
 
 /** LaborCaculatorRequest 连续劳务税费试算（计算器）请求 */
 interface LaborCaculatorRequest {
-    /** 平台企业 ID */
-    dealer_id: string;
-    /** 综合服务主体 ID */
-    broker_id: string;
-    /** 月度收入列表 */
-    month_settlement_list: MonthSettlement[];
+  /** 平台企业 ID */
+  dealer_id: string;
+  /** 综合服务主体 ID */
+  broker_id: string;
+  /** 月度收入列表 */
+  month_settlement_list: MonthSettlement[];
 }
 
 /** MonthSettlement 月度收入 */
 interface MonthSettlement {
-    /** 月份 */
-    month: number;
-    /** 月度收入 */
-    month_pre_tax_amount: string;
+  /** 月份 */
+  month: number;
+  /** 月度收入 */
+  month_pre_tax_amount: string;
 }
 
 /** LaborCaculatorResponse 连续劳务税费试算（计算器）返回 */
 interface LaborCaculatorResponse {
-    /** 综合所得汇算清缴 */
-    year_tax_info: YearTaxInfo;
-    /** 月度税务信息列表 */
-    month_tax_list: MontTax[];
+  /** 综合所得汇算清缴 */
+  year_tax_info: YearTaxInfo;
+  /** 月度税务信息列表 */
+  month_tax_list: MontTax[];
 }
 
 /** YearTaxInfo 综合所得汇算清缴信息 */
 interface YearTaxInfo {
-    /** 连续劳务年度个税 */
-    continuous_month_personal_tax: string;
-    /** 综合所得汇算清缴年度个税 */
-    personal_tax: string;
-    /** 年度扣除费用 */
-    deduct_cost: string;
-    /** 个税税率 */
-    personal_tax_rate: string;
-    /** 速算扣除数 */
-    deduct_tax: string;
-    /** 税负率 */
-    total_tax_rate: string;
+  /** 连续劳务年度个税 */
+  continuous_month_personal_tax: string;
+  /** 综合所得汇算清缴年度个税 */
+  personal_tax: string;
+  /** 年度扣除费用 */
+  deduct_cost: string;
+  /** 个税税率 */
+  personal_tax_rate: string;
+  /** 速算扣除数 */
+  deduct_tax: string;
+  /** 税负率 */
+  total_tax_rate: string;
 }
 
 /** MontTax 月度税务信息 */
 interface MontTax {
-    /** 月份 */
-    month: number;
-    /** 含增值税收入 */
-    pre_tax_amount: string;
-    /** 不含增值税收入 */
-    excluding_vat_amount: string;
-    /** 增值税 */
-    value_added_tax: string;
-    /** 附加税 */
-    additional_tax: string;
-    /** 个税 */
-    personal_tax: string;
-    /** 个税税率 */
-    personal_tax_rate: string;
-    /** 速算扣除数 */
-    deduct_tax: string;
-    /** 税后金额 */
-    post_tax_amount: string;
-    /** 税负率 */
-    total_tax_rate: string;
+  /** 月份 */
+  month: number;
+  /** 含增值税收入 */
+  pre_tax_amount: string;
+  /** 不含增值税收入 */
+  excluding_vat_amount: string;
+  /** 增值税 */
+  value_added_tax: string;
+  /** 附加税 */
+  additional_tax: string;
+  /** 个税 */
+  personal_tax: string;
+  /** 个税税率 */
+  personal_tax_rate: string;
+  /** 速算扣除数 */
+  deduct_tax: string;
+  /** 税后金额 */
+  post_tax_amount: string;
+  /** 税负率 */
+  total_tax_rate: string;
 }
 
 /** CalcTaxRequest 订单税费试算请求 */
@@ -110,6 +110,14 @@ interface CalcTaxResponse {
   status_message: string;
   /** 结果详细状态码描述 */
   status_detail_message: string;
+  /** 用户实收金额（未扣除追缴的增附税） */
+  user_real_excluding_vat_amount: string;
+  /** 用户还未缴清的增附税 */
+  user_remaining_repayment_amount: string;
+  /** 已追缴增附税（本笔订单） */
+  user_recover_tax_amount: string;
+  /** 待追缴增附税总金额 */
+  user_total_recover_tax_amount: string;
 }
 
 /** CalcTaxDetail 税费明细 */
@@ -144,35 +152,112 @@ interface CalcTaxDetail {
   deduct_tax: string;
 }
 
+/** CalculationYearH5UrlRequest 连续劳务年度税费测算-H5 请求 */
+interface CalculationYearH5UrlRequest {
+  /** 平台企业 ID */
+  dealer_id: string;
+  /** 综合服务主体 ID */
+  broker_id: string;
+  /** 主题颜色 */
+  color: string;
+}
+
+/** CalculationYearH5UrlResponse 连续劳务年度税费测算-H5 返回 */
+interface CalculationYearH5UrlResponse {
+  /** 年度劳务测算 H5 页面 URL */
+  url: string;
+}
+
+/** CalculationH5UrlRequest 连续劳务单笔结算税费测算-H5 请求 */
+interface CalculationH5UrlRequest {
+  /** 平台企业 ID */
+  dealer_id: string;
+  /** 综合服务主体 ID */
+  broker_id: string;
+  /** 姓名 */
+  real_name: string;
+  /** 证件号 */
+  id_card: string;
+  /** 主题颜色 */
+  color: string;
+}
+
+/** CalculationH5UrlResponse 连续劳务单笔结算税费测算-H5 返回 */
+interface CalculationH5UrlResponse {
+  /** 连续劳务单笔结算税费测算 H5 页面 URL */
+  url: string;
+}
+
 export class CalculateLaborServiceClient extends YZHclient {
-    // eslint-disable-next-line no-useless-constructor
-    constructor(conf: {
-        dealer_id: string;
-        broker_id: string;
-        app_key: string;
-        des3_key: string;
-        private_key: string;
-        yzh_public_key: string;
-        sign_type: 'rsa' | 'sha256';
-        base_url?: string;
-        timeout?: number;
-    }) {
-        super(conf);
-    }
-
-    // LaborCaculator 连续劳务税费试算（计算器）
-    async LaborCaculator(
-        req: LaborCaculatorRequest,
-        cb?: (error: null | string, rep: LaborCaculatorResponse) => void
-    ): Promise<LaborCaculatorResponse> {
-        return this.request('post', '/api/tax/v1/labor-caculator', req, { encryption: false }, cb);
-    }
-
-    // CalcTax 订单税费试算
-    async CalcTax(
-        req: CalcTaxRequest,
-        cb?: (error: null | string, rep: CalcTaxResponse) => void
-    ): Promise<CalcTaxResponse> {
-        return this.request('post', '/api/payment/v1/calc-tax', req, { encryption: false }, cb);
-    }
+  // eslint-disable-next-line no-useless-constructor
+  constructor(conf: {
+    dealer_id: string;
+    broker_id: string;
+    app_key: string;
+    des3_key: string;
+    private_key: string;
+    yzh_public_key: string;
+    sign_type: 'rsa' | 'sha256';
+    base_url?: string;
+    timeout?: number;
+  }) {
+    super(conf);
+  }
+
+  // LaborCaculator 连续劳务税费试算（计算器）
+  async LaborCaculator(
+    req: LaborCaculatorRequest,
+    cb?: (error: null | string,rep: LaborCaculatorResponse)=>void
+  ): Promise<LaborCaculatorResponse> {
+    return this.request(
+      'post',
+      '/api/tax/v1/labor-caculator',
+      req,
+      {encryption: false },
+      cb
+    );
+  }
+
+  // CalcTax 订单税费试算
+  async CalcTax(
+    req: CalcTaxRequest,
+    cb?: (error: null | string,rep: CalcTaxResponse)=>void
+  ): Promise<CalcTaxResponse> {
+    return this.request(
+      'post',
+      '/api/payment/v1/calc-tax',
+      req,
+      {encryption: false },
+      cb
+    );
+  }
+
+  // CalculationYearH5Url 连续劳务年度税费测算-H5
+  async CalculationYearH5Url(
+    req: CalculationYearH5UrlRequest,
+    cb?: (error: null | string,rep: CalculationYearH5UrlResponse)=>void
+  ): Promise<CalculationYearH5UrlResponse> {
+    return this.request(
+      'get',
+      '/api/labor/service/calculation/year/h5url',
+      req,
+      {encryption: false },
+      cb
+    );
+  }
+
+  // CalculationH5Url 连续劳务单笔结算税费测算-H5
+  async CalculationH5Url(
+    req: CalculationH5UrlRequest,
+    cb?: (error: null | string,rep: CalculationH5UrlResponse)=>void
+  ): Promise<CalculationH5UrlResponse> {
+    return this.request(
+      'get',
+      '/api/labor/service/calculation/h5url',
+      req,
+      {encryption: false },
+      cb
+    );
+  }
+
 }