@yunzhanghu/sdk-nodejs 1.0.28 → 1.0.29

package/README.md

@@ -68,9 +68,7 @@ OpenSSL-> rsa -in private_key.pem -pubout -out pubkey.pem
    - [H5 签约](./example/h5UserSign.js)
    - [API 签约](./example/apiUserSign.js)
    - [签约信息上传](./example/uploadusersign.js)
-- 个体工商户注册
-   - [云账户新经济 H5](./example/bizlicXjjH5.js)
-   - [云账户新经济 H5+API](./example/bizlicXjjH5Api.js) 
+- [订单税费试算](./example/calculatelabor.js) 
 - [实时支付](./example/payment.js)
 - [异步通知](./example/notify.js)
 - [对账文件获取](./example/dataService.js)

package/example/authentication.js

@@ -239,6 +239,7 @@ authentication
     notify_url: 'https://www.example.com',
     ref: 'test019011901',
     resident_type:"1",
+    permit_card:"H12345678",
   })
   .then((data) => {
     if (data.code === '0000') {

package/example/invoice.js

@@ -44,6 +44,8 @@ invoice
     request_id: 'requestIdExample123456789',
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
+    start_date: '2026-01-01',
+    end_date: '2026-01-26',
   })
   .then((data) => {
     if (data.code === '0000') {
@@ -79,6 +81,8 @@ invoice
     remark: '',
     receive_emails: ['username1@example.com'],
     invoice_media: '1',
+    start_date: '2026-01-01',
+    end_date: '2026-01-26',
   })
   .then((data) => {
     if (data.code === '0000') {

package/example/taxClearRefund.js

@@ -86,3 +86,33 @@ taxClearRefundClient
         // 发生异常
         console.log(err.toString())
     })
+
+// 查询税费退补涉及劳动者
+taxClearRefundClient
+    .GetRefundTaxLaborInfo({
+
+        /**
+         * @param {string} request-id：请求 ID，请求的唯一标识
+         * 建议平台企业自定义 request-id，并记录在日志中，便于问题发现及排查
+         * 如未自定义 request-id，将使用 SDK 中的 UUID 方法自动生成。注意：UUID 方法生成的 request-id 不能保证全局唯一，推荐自定义 request-id
+         */
+        broker_id: config.broker_id,
+        dealer_id: config.dealer_id,
+        tax_month: '2025-10',
+        batch_id: '10313232135454132',
+        offset: 0,
+        length: 500,
+    })
+    .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.28",
+    "version": "1.0.29",
     "description": "云账户 SDK for Node.js",
     "main": "yzh/index.js",
     "scripts": {

package/src/services/authentication/index.ts

@@ -106,6 +106,8 @@ interface UserExemptedInfoRequest {
     image_urls: string[];
     /** 外籍人员类型 */
     resident_type: string;
+    /** 港澳台通行证号码 */
+    permit_card: string;
 }
 
 /** UserExemptedInfoResponse 上传非居民身份证验证名单信息返回 */

package/src/services/invoice/index.ts

@@ -30,6 +30,10 @@ interface GetInvoiceAmountRequest {
     broker_id: string;
     /** 平台企业 ID */
     dealer_id: string;
+    /** 查询开始日期 */
+    start_date: string;
+    /** 查询结束日期 */
+    end_date: string;
 }
 
 /** GetInvoiceAmountResponse 查询可开具发票额度和发票开具信息返回 */
@@ -64,6 +68,10 @@ interface ApplyInvoiceRequest {
     receive_emails: string[];
     /** 发票介质 */
     invoice_media: string;
+    /** 查询开始日期 */
+    start_date: string;
+    /** 查询结束日期 */
+    end_date: string;
 }
 
 /** ApplyInvoiceResponse 发票开具申请返回 */

package/src/services/taxclearrefund/index.ts

@@ -132,6 +132,58 @@ interface GetRefundTaxInfoRequest {
   batch_id: string;
 }
 
+/** GetRefundTaxLaborInfoRequest 查询税费退补涉及劳动者请求 */
+interface GetRefundTaxLaborInfoRequest {
+  /** 综合服务主体 ID */
+  broker_id: string;
+  /** 平台企业 ID */
+  dealer_id: string;
+  /** 批次号 */
+  batch_id: string;
+  /** 税款所属期 */
+  tax_month: string;
+  /** 偏移量 */
+  offset: number;
+  /** 每页返回条数 */
+  length: number;
+}
+
+/** GetRefundTaxLaborInfoResponse 查询税费退补涉及劳动者返回 */
+interface GetRefundTaxLaborInfoResponse {
+  /** 税款所属期 */
+  tax_month: string;
+  /** 批次号 */
+  batch_id: string;
+  /** 批次生成时间 */
+  batch_create_time: string;
+  /** 退补税劳动者数量 */
+  labor_num: string;
+  /** 退补税订单数量 */
+  order_num: string;
+  /** 总数据条数 */
+  total_num: string;
+  /** 退补税劳动者明细 */
+  labor_refund_info: LaborRefundInfo[];
+}
+
+/** LaborRefundInfo 退补税劳动者明细 */
+interface LaborRefundInfo {
+  /** 劳动者姓名 */
+  real_name: string;
+  /** 劳动者证件号 */
+  id_card: string;
+  /** 本批次退补给劳动者税费总额 */
+  refund_tax: string;
+  /** 退补税状态 */
+  tax_refund_status: string;
+  /** 劳动者收款账户 */
+  receiving_account: string;
+  /** 劳动者收款账号 */
+  receiving_channel: string;
+  /** 退补税费时间 */
+  refund_tax_finished_time: string;
+}
+
 export class TaxClearRefundClient extends YZHclient {
   // eslint-disable-next-line no-useless-constructor
   constructor(conf: {
@@ -190,4 +242,18 @@ export class TaxClearRefundClient extends YZHclient {
     );
   }
 
+  // GetRefundTaxLaborInfo 查询税费退补涉及劳动者
+  async GetRefundTaxLaborInfo(
+    req: GetRefundTaxLaborInfoRequest, 
+    cb?: (error: null | string,rep: GetRefundTaxLaborInfoResponse)=>void
+  ): Promise<GetRefundTaxLaborInfoResponse> {
+    return this.request(
+      'get', 
+      '/api/payment/v1/query-clear-labor-info', 
+      req,
+      {encryption: false },
+      cb
+    );
+  }
+
 }

package/yzh/services/authentication/index.d.ts

@@ -105,6 +105,8 @@ interface UserExemptedInfoRequest {
     image_urls: string[];
     /** 外籍人员类型 */
     resident_type: string;
+    /** 港澳台通行证号码 */
+    permit_card: string;
 }
 
 /** UserExemptedInfoResponse 上传非居民身份证验证名单信息返回 */

package/yzh/services/invoice/index.d.ts

@@ -29,6 +29,10 @@ interface GetInvoiceAmountRequest {
     broker_id: string;
     /** 平台企业 ID */
     dealer_id: string;
+    /** 查询开始日期 */
+    start_date: string;
+    /** 查询结束日期 */
+    end_date: string;
 }
 
 /** GetInvoiceAmountResponse 查询可开具发票额度和发票开具信息返回 */
@@ -63,6 +67,10 @@ interface ApplyInvoiceRequest {
     receive_emails: string[];
     /** 发票介质 */
     invoice_media: string;
+    /** 查询开始日期 */
+    start_date: string;
+    /** 查询结束日期 */
+    end_date: string;
 }
 
 /** ApplyInvoiceResponse 发票开具申请返回 */

package/yzh/services/taxclearrefund/index.d.ts

@@ -131,6 +131,58 @@ interface GetRefundTaxInfoRequest {
   batch_id: string;
 }
 
+/** GetRefundTaxLaborInfoRequest 查询税费退补涉及劳动者请求 */
+interface GetRefundTaxLaborInfoRequest {
+  /** 综合服务主体 ID */
+  broker_id: string;
+  /** 平台企业 ID */
+  dealer_id: string;
+  /** 批次号 */
+  batch_id: string;
+  /** 税款所属期 */
+  tax_month: string;
+  /** 偏移量 */
+  offset: number;
+  /** 每页返回条数 */
+  length: number;
+}
+
+/** GetRefundTaxLaborInfoResponse 查询税费退补涉及劳动者返回 */
+interface GetRefundTaxLaborInfoResponse {
+  /** 税款所属期 */
+  tax_month: string;
+  /** 批次号 */
+  batch_id: string;
+  /** 批次生成时间 */
+  batch_create_time: string;
+  /** 退补税劳动者数量 */
+  labor_num: string;
+  /** 退补税订单数量 */
+  order_num: string;
+  /** 总数据条数 */
+  total_num: string;
+  /** 退补税劳动者明细 */
+  labor_refund_info: LaborRefundInfo[];
+}
+
+/** LaborRefundInfo 退补税劳动者明细 */
+interface LaborRefundInfo {
+  /** 劳动者姓名 */
+  real_name: string;
+  /** 劳动者证件号 */
+  id_card: string;
+  /** 本批次退补给劳动者税费总额 */
+  refund_tax: string;
+  /** 退补税状态 */
+  tax_refund_status: string;
+  /** 劳动者收款账户 */
+  receiving_account: string;
+  /** 劳动者收款账号 */
+  receiving_channel: string;
+  /** 退补税费时间 */
+  refund_tax_finished_time: string;
+}
+
 export declare class TaxClearRefundClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
@@ -155,6 +207,10 @@ export declare class TaxClearRefundClient extends YZHclient {
         req: GetRefundTaxInfoRequest,
         cb?: (error: null | string, rep: RefundTaxData) => void
     ): Promise<RefundTaxData>;
+    GetRefundTaxLaborInfo(
+        req: GetRefundTaxLaborInfoRequest,
+        cb?: (error: null | string, rep: GetRefundTaxLaborInfoResponse) => void
+    ): Promise<GetRefundTaxLaborInfoResponse>;
 }
 
 export {};

package/yzh/services/taxclearrefund/index.js

@@ -37,5 +37,15 @@ class TaxClearRefundClient extends client_1.default {
             cb
         );
     }
+    // GetRefundTaxLaborInfo 查询税费退补涉及劳动者
+    async GetRefundTaxLaborInfo(req, cb) {
+        return this.request(
+            'get',
+            '/api/payment/v1/query-clear-labor-info',
+            req,
+            { encryption: (req === null || req === void 0 ? void 0 : req.data_type) === 'encryption' },
+            cb
+        );
+    }
 }
 exports.TaxClearRefundClient = TaxClearRefundClient;