@yunzhanghu/sdk-nodejs 0.0.4 → 1.0.1

package/README.md

@@ -1,7 +1,7 @@
 # 云账户 SDK for Node.js
 
 欢迎使用云账户 SDK for Node.js。  
-云账户是一家专注为平台企业和新就业形态劳动者提供高质量灵活就业服务的新时代企业。云账户 SDK 对云账户综合服务平台 API 接口进行封装，让您不必担心过多参数请求，帮助您快速接入到云账户综合服务平台。云账户 SDK for Node.js 为您提供签约、下单、回调、数据查询等功能，帮助您完成与云账户综合服务平台的接口对接及业务开发。  
+云账户是一家专注为平台企业和新就业形态劳动者提供高质量灵活就业服务的新时代企业。云账户 SDK 对云账户综合服务平台 API 接口进行封装，帮助您快速接入到云账户综合服务平台。云账户 SDK for Node.js 为您提供签约、支付、回调、数据查询等功能，帮助您完成与云账户综合服务平台的接口对接及业务开发。  
 如果您在使用过程中遇到任何问题，请在当前 GitHub 提交 Issues，或发送邮件至技术支持组 [techsupport@yunzhanghu.com](mailto:techsupport@yunzhanghu.com)。
 
 ## 环境要求
@@ -12,7 +12,7 @@
 
 ### 1、获取配置
 
-使用云账户 SDK for Node.js 前，您需先获取 dealer_id、broker_id、3DES Key、App Key 信息。  
+使用云账户 SDK for Node.js 前，您需先获取 dealer_id、broker_id、3DES Key、App Key、云账户公钥。  
 获取方式：使用开户邮件中的账号登录【[云账户综合服务平台](https://service.yunzhanghu.com)】，选择“业务中心 > 业务管理 > 对接信息”，查看并获取以上配置信息。
 ![获取配置信息](https://yos.yunzhanghu.com/getobject/duijiexinxi.png?isAttachment=false&fileID=9487bd54b93a5abf49003c2b8ce7e069bfa24220&signature=X%2BR7PocQgPqSpR2xM1TgYU6lAapr%2FB9p3aFof03Gcfw%3D)
 
@@ -34,37 +34,37 @@ OpenSSL-> rsa -in private_key.pem -pubout -out pubkey.pem
 
 - 方式二：使用工具生成
 
-请联系云账户技术支持获取 RSA 密钥生成工具 > 登录【[云账户开放平台](https://open.yunzhanghu.com/)】，选择“开发工具下载 > 开发助手 > 工具下载”，下载安装“云账户开放平台开发助手”
+登录【[云账户开放平台](https://open.yunzhanghu.com)】，选择“开发工具下载 > 开发助手 > 工具下载”，下载安装“云账户开放平台开发助手”。
 
 ### 3、配置密钥
 
 登录【[云账户综合服务平台](https://service.yunzhanghu.com)】，选择“业务中心 > 业务管理 > 对接信息”，单击页面右上角的“编辑”，配置平台企业公钥。  
 ![配置平台企业公钥信息](https://yos.yunzhanghu.com/getobject/dujiexinxi-2.png?isAttachment=false&fileID=84e3cd1684a61c1e32eb0e7b7f43390cd053206b&signature=mqW8Zbk7h3gYXfzjR99pK%2B0pgVLcLly3VjBB2KsqDvQ%3D)
 
-## 安装 Node.js SDK
+## 安装云账户 SDK for Node.js
 
 ### 通过 NPM 安装
 
-推荐通过 Node.js 的包管理工具 NPM 获取并安装 Node.js SDK。NPM 详细介绍请参考[ NPM 官网](https://www.npmjs.com/) 。
+推荐通过 Node.js 的包管理工具 NPM 获取并安装云账户 SDK for Node.js。NPM 详细介绍请参考[ NPM 官网](https://www.npmjs.com) 。
 
-1. 执行以下安装命令安装云账户 Node.js SDK：
+1. 执行以下安装命令安装云账户 SDK for Node.js：
 
    > npm install @yunzhanghu/sdk-nodejs --save
 
-2. 在您的代码中引用对应模块代码，可参考示例。
+2. 在您的代码中引用对应模块代码，具体引用方式可参考下文示例。
 
 ### 通过源码包安装
 
-1. 前往 [Github 仓库](https://github.com/YunzhanghuOpen/sdk-nodejs) 下载源码压缩包;
-2. 解压源码包到您项目的合适位置;
-3. 在您的代码中引用对应模块代码，可参考示例。
+1. 前往 [Github 仓库](https://github.com/YunzhanghuOpen/sdk-nodejs) 下载源码压缩包；
+2. 解压源码包到您项目的合适位置；
+3. 在您的代码中引用对应模块代码，具体引用方式可参考下文示例。
 
 ## 快速使用
 
 ### 示例功能列表
 
-- [用户信息验证](./example/verify.js)
-- [H5 签约](./example/h5UserSign.js) or [API 签约](./example/apiUserSign.js)
+- [用户信息验证](./example/authentication.js)
+- [用户签约（H5 签约）](./example/h5UserSign.js) or [用户签约（API 签约）](./example/apiUserSign.js)
 - [个体工商户注册（云账户新经济 H5）](./example/bizlicXjjH5.js) or [个体工商户注册（云账户新经济 H5+API）](./example/bizlicXjjH5Api.js)
 - [实时支付](./example/payment.js)
 - [异步通知](./example/notify.js)
@@ -76,8 +76,8 @@ OpenSSL-> rsa -in private_key.pem -pubout -out pubkey.pem
 ```
 const yunzhanghu = require("@yunzhanghu/sdk-nodejs")
 
-// 实例化要请求的 client 对象(以 Invoice 为例)
-const client = new yunzhanghu.Invoice({
+// 实例化要请求的 client 对象(以 InvoiceClient 为例)
+const client = new yunzhanghu.InvoiceClient({
   // 为了保护密钥安全，建议将密钥配置到环境变量中或配置文件中。
   // 请勿在代码中使用硬编码密钥，可能导致密钥暴露，存在安全隐患。
 
@@ -104,6 +104,8 @@ client
   .GetInvoiceAmount({
     dealer_id: process.env.DEALER_ID,
     broker_id: process.env.BROKER_ID,
+// 可自定义 Header 中的 request-id，建议将 request-id 记录在日志中
+// request_id:'req1678257009001'
   })
   .then((data) => {
     console.log("data", data)

package/example/apiUserSign.js

@@ -1,13 +1,13 @@
 const yzhAPI = require("../yzh/index.js")
 const config = require("./conf/config.js")
 
-// API 签约
+// 用户签约（API 签约）
 
-const apiusersign = new yzhAPI.Apiusersign(config)
+const apiusersign = new yzhAPI.ApiUserSignServiceClient(config)
 
 // 获取协议预览 URL
 apiusersign
-  .ApiUseSignContract({
+  .ApiUserSignContract({
     dealer_id: config.dealer_id,
     broker_id: config.broker_id,
   })

package/example/authentication.js

@@ -5,7 +5,7 @@ const path = require("path")
 
 // 用户信息验证
 
-const authentication = new yzhAPI.Authentication(config)
+const authentication = new yzhAPI.AuthenticationClient(config)
 
 // 银行卡四要素鉴权请求（下发短信验证码）
 authentication

package/example/bizlicXjjH5.js

@@ -3,7 +3,7 @@ const config = require("./conf/config.js")
 
 // 个体工商户注册（云账户新经济 H5）
 
-const bizlicxjjh5 = new yzhAPI.Bizlicxjjh5({
+const bizlicxjjh5 = new yzhAPI.BizlicXjjH5ServiceClient({
   ...config,
   base_url: "https://api-aic.yunzhanghu.com/",
 })

package/example/bizlicXjjH5Api.js

@@ -3,7 +3,10 @@ const config = require("./conf/config.js")
 
 // 个体工商户注册（云账户新经济 H5+API）
 
-const bizlicxjjh5api = new yzhAPI.Bizlicxjjh5api({...config,base_url: "https://api-aic.yunzhanghu.com/"})
+const bizlicxjjh5api = new yzhAPI.BizlicXjjH5APIServiceClient({
+  ...config,
+  base_url: "https://api-aic.yunzhanghu.com/",
+})
 
 // 工商实名信息录入
 bizlicxjjh5api

package/example/dataService.js

@@ -3,7 +3,7 @@ const config = require("./conf/config.js")
 
 // 对账文件获取
 
-const dataService = new yzhAPI.Dataservice(config)
+const dataService = new yzhAPI.DataServiceClient(config)
 
 // 查询日订单文件
 dataService

package/example/h5UserSign.js

@@ -1,9 +1,9 @@
 const yzhAPI = require("../yzh/index.js")
 const config = require("./conf/config.js")
 
-// H5 签约
+// 用户签约（H5 签约）
 
-const h5usersign = new yzhAPI.H5usersign(config)
+const h5usersign = new yzhAPI.H5UserSignServiceClient(config)
 
 // 预申请签约
 h5usersign

package/example/invoice.js

@@ -3,7 +3,7 @@ const config = require("./conf/config.js")
 
 // 发票开具
 
-const invoice = new yzhAPI.Invoice(config)
+const invoice = new yzhAPI.InvoiceClient(config)
 
 // 查询平台企业已开具和待开具发票金额
 invoice
@@ -89,3 +89,16 @@ invoice
   .catch((err) => {
     console.log(err.toString())
   })
+
+// 查询发票信息
+invoice
+  .GetInvoiceInformation({
+    invoice_apply_id: "",
+    application_id: "423721",
+  })
+  .then((data) => {
+    console.log('响应内容: %j', data)
+  })
+  .catch((err) => {
+    console.log(err.toString())
+  })

package/example/notify.js

@@ -1,6 +1,6 @@
 const yunzhanghu = require("../yzh/index.js")
 
-// 模拟异步通知接口验签+解密
+// 异步通知
 
 const util = new yunzhanghu.Util({
   dealer_id: process.env.DEALER_ID,

package/example/payment.js

@@ -1,7 +1,7 @@
 const yzhAPI = require("../yzh/index.js")
 const config = require("./conf/config.js")
 // 实时支付
-const payment = new yzhAPI.Payment(config)
+const payment = new yzhAPI.PaymentClient(config)
 
 // 银行卡实时支付
 payment

package/example/tax.js

@@ -2,7 +2,7 @@ const yzhAPI = require("../yzh/index.js")
 const config = require("./conf/config.js")
 
 // 个人所得税扣缴明细表
-const tax = new yzhAPI.Tax(config)
+const tax = new yzhAPI.TaxClient(config)
 
 // 下载个人所得税扣缴明细表
 tax

package/package.json

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

package/src/common/client.ts

@@ -68,11 +68,12 @@ export class YZHClient {
 
   // 基础请求：进行请求实例生成 Header，动态设置、请求体包装等偏底层操作
   private doRequest(method: string, action: string, req: any): Promise<ResponseData> {
+    const { request_id, ...resReq } = req
     // 请求参数加密
-    const encryptParams = this.generatorResquestParams(req)
+    const encryptParams = this.generatorRequestParams(resReq)
     // 生成请求实例，配置 Header
     const instance = getInstance({
-      request_id: req?.request_id ?? this.mess(),
+      request_id: request_id ?? this.mess(),
       dealer_id: this.dealer_id,
       base_url: this.base_url,
     })
@@ -120,7 +121,7 @@ export class YZHClient {
    * @param {object} params
    * @returns {*} object
    */
-  private generatorResquestParams(params: string) {
+  private generatorRequestParams(params: string) {
     try {
       const t = Date.now().toString()
       const m = this.mess()
@@ -129,7 +130,7 @@ export class YZHClient {
 
       const data = this.encrypt(plaintext)
 
-      const signStr = this.generatorSign(data, m, t)
+      const signStr = this.sign(data, m, t)
       return {
         data,
         mess: m,
@@ -149,7 +150,7 @@ export class YZHClient {
    * @param {string} timestamp 时间戳，精确到秒
    * @returns {string} 签名内容
    */
-  private generatorSignRSASHA256 = (data: string, mess: string, timestamp: string) => {
+  private signRSASHA256 = (data: string, mess: string, timestamp: string) => {
     try {
       const plaintext = `data=${data}&mess=${mess}&timestamp=${timestamp}&key=${this.app_key}`
       const sign = crypto.createSign("RSA-SHA256")
@@ -168,7 +169,7 @@ export class YZHClient {
    * @param {string} timestamp 时间戳，精确到秒
    * @returns {string} 签名内容
    */
-  private generatorSignHmacSHA256 = (data: string, mess: string, timestamp: string) => {
+  private signHmacSHA256 = (data: string, mess: string, timestamp: string) => {
     try {
       const plaintext = `data=${data}&mess=${mess}&timestamp=${timestamp}&key=${this.app_key}`
       const hmac = crypto.createHmac("sha256", this.app_key)
@@ -187,14 +188,14 @@ export class YZHClient {
    * @param {string} sign_type 签名方式
    * @returns {string} 签名内容
    */
-  private generatorSign = (data: string, mess: string, timestamp: string) => {
+  private sign = (data: string, mess: string, timestamp: string) => {
     try {
       switch (this.sign_type) {
         case "rsa": {
-          return this.generatorSignRSASHA256(data, mess, timestamp)
+          return this.signRSASHA256(data, mess, timestamp)
         }
         case "sha256": {
-          return this.generatorSignHmacSHA256(data, mess, timestamp)
+          return this.signHmacSHA256(data, mess, timestamp)
         }
         default:
           throw new YZHSDKHttpException(`sign_type类型不存在`)
@@ -238,12 +239,12 @@ export class YZHClient {
       yzhError.httpCode = result.status
       throw yzhError
     } else {
-      // httpcode 200
+      // HTTP Status Code 200
       const { data: axiosData } = result
       let response = axiosData
       // 需解密
       if (encryption) {
-        response = { ...response, data: this.decryption(response.data) }
+        response = { ...response, data: this.decrypt(response.data) }
       }
       return response
     }
@@ -254,7 +255,7 @@ export class YZHClient {
    * @param ciphertext
    * @returns 明文数据
    */
-  decryption = (ciphertext: string) => {
+  decrypt = (ciphertext: string) => {
     try {
       const iv = this.des3_key.slice(0, 8)
       const cipherChunks = []
@@ -349,7 +350,7 @@ export class YZHClient {
       const verifyResult = verifyMap[this.sign_type](data, mess, timestamp, sign)
       let plaintext = {}
       if (verifyResult) {
-        plaintext = this.decryption(data)
+        plaintext = this.decrypt(data)
       }
       return {
         result: verifyResult,

package/src/services/apiusersign/index.ts

@@ -16,6 +16,22 @@ interface ApiUseSignContractResponse {
   title: string
 }
 
+/** ApiUserSignContractRequest 获取协议预览 URL 请求 V2 */
+interface ApiUserSignContractRequest {
+  /** 平台企业 ID */
+  dealer_id: string
+  /** 综合服务主体 ID */
+  broker_id: string
+}
+
+/** ApiUserSignContractResponse 获取协议预览 URL 返回 V2 */
+interface ApiUserSignContractResponse {
+  /** 预览跳转 URL */
+  url: string
+  /** 协议名称 */
+  title: string
+}
+
 /** ApiUserSignRequest 用户签约请求 */
 interface ApiUserSignRequest {
   /** 综合服务主体 ID */
@@ -76,7 +92,7 @@ interface ApiUserSignReleaseResponse {
   status: string
 }
 
-export class Apiusersign extends YZHclient {
+export class ApiUserSignServiceClient extends YZHclient {
   constructor(conf: {
     dealer_id: string
     broker_id: string
@@ -98,6 +114,14 @@ export class Apiusersign extends YZHclient {
     return this.request("get", "/api/sign/v1/user/contract", req, { encryption: false }, cb)
   }
 
+  // ApiUserSignContract 获取协议预览 URL V2
+  async ApiUserSignContract(
+    req: ApiUserSignContractRequest,
+    cb?: (error: null | string, rep: ApiUserSignContractResponse) => void
+  ): Promise<ApiUserSignContractResponse> {
+    return this.request("get", "/api/sign/v1/user/contract", req, { encryption: false }, cb)
+  }
+
   // ApiUserSign 用户签约
   async ApiUserSign(
     req: ApiUserSignRequest,

package/src/services/authentication/index.ts

@@ -161,7 +161,7 @@ interface GetBankCardInfoResponse {
   is_support: boolean
 }
 
-export class Authentication extends YZHclient {
+export class AuthenticationClient extends YZHclient {
   constructor(conf: {
     dealer_id: string
     broker_id: string

package/src/services/bizlicxjjh5/index.ts

@@ -17,7 +17,7 @@ interface H5GetStartUrlRequest {
   /** 跳转 URL */
   return_url: string
   /** H5 页面 Title */
-  custom_title: number
+  customer_title: number
 }
 
 /** H5GetStartUrlResponse 预启动返回 */
@@ -96,7 +96,7 @@ interface NotifyH5EcoCityAicRequest {
   type: number
 }
 
-export class Bizlicxjjh5 extends YZHclient {
+export class BizlicXjjH5ServiceClient extends YZHclient {
   constructor(conf: {
     dealer_id: string
     broker_id: string

package/src/services/bizlicxjjh5api/index.ts

@@ -49,7 +49,7 @@ interface H5APIGetStartUrlRequest {
   /** 跳转 URL */
   return_url: string
   /** H5 页面 Title */
-  custom_title: number
+  customer_title: number
 }
 
 /** H5APIGetStartUrlResponse 预启动返回 */
@@ -128,7 +128,7 @@ interface NotifyH5APIEcoCityAicRequest {
   type: number
 }
 
-export class Bizlicxjjh5api extends YZHclient {
+export class BizlicXjjH5APIServiceClient extends YZHclient {
   constructor(conf: {
     dealer_id: string
     broker_id: string

package/src/services/dataservice/index.ts

@@ -242,7 +242,7 @@ interface StatementDetail {
   project_name: string
 }
 
-export class Dataservice extends YZHclient {
+export class DataServiceClient extends YZHclient {
   constructor(conf: {
     dealer_id: string
     broker_id: string

package/src/services/h5usersign/index.ts

@@ -96,7 +96,7 @@ interface NotifyH5UserSignRequest {
   phone: string
 }
 
-export class H5usersign extends YZHclient {
+export class H5UserSignServiceClient extends YZHclient {
   constructor(conf: {
     dealer_id: string
     broker_id: string

package/src/services/index.ts

@@ -1,10 +1,10 @@
 export { Util } from "../common/utils"
-export { Apiusersign } from "./apiusersign"
-export { Authentication } from "./authentication"
-export { Dataservice } from "./dataservice"
-export { H5usersign } from "./h5usersign"
-export { Invoice } from "./invoice"
-export { Payment } from "./payment"
-export { Tax } from "./tax"
-export { Bizlicxjjh5api } from "./bizlicxjjh5api"
-export { Bizlicxjjh5 } from "./bizlicxjjh5"
+export { ApiUserSignServiceClient } from "./apiusersign"
+export { AuthenticationClient } from "./authentication"
+export { DataServiceClient } from "./dataservice"
+export { H5UserSignServiceClient } from "./h5usersign"
+export { InvoiceClient } from "./invoice"
+export { PaymentClient } from "./payment"
+export { TaxClient } from "./tax"
+export { BizlicXjjH5APIServiceClient } from "./bizlicxjjh5api"
+export { BizlicXjjH5ServiceClient } from "./bizlicxjjh5"

package/src/services/invoice/index.ts

@@ -110,6 +110,40 @@ interface GetInvoiceStatusResponse {
   waybill_number: string[]
 }
 
+/** GetInvoiceInformationRequest 查询发票信息请求 */
+interface GetInvoiceInformationRequest {
+  /** 发票申请编号 */
+  invoice_apply_id: string
+  /** 发票申请单 ID */
+  application_id: string
+}
+
+/** GetInvoiceInformationResponse 查询发票信息返回 */
+interface GetInvoiceInformationResponse {
+  /** 发票信息 */
+  information: InformationDataInfo[]
+}
+
+/** InformationDataInfo 查询发票信息返回 */
+interface InformationDataInfo {
+  /** 货物或应税劳务、服务名称 */
+  goods_services_name: string
+  /** 发票号码 */
+  invoice_num: string
+  /** 发票代码 */
+  invoice_code: string
+  /** 不含税金额 */
+  price_amount: string
+  /** 税额 */
+  tax_amount: string
+  /** 税率 */
+  tax_rate: string
+  /** 价税合计 */
+  price_tax_amount: string
+  /** 开票日期 */
+  invoiced_date: string
+}
+
 /** BankNameAccount 系统支持的开户行及账号 */
 interface BankNameAccount {
   /** 开户行及账号 */
@@ -191,7 +225,7 @@ interface NotifyInvoiceDoneRequest {
   reject_reason: string
 }
 
-export class Invoice extends YZHclient {
+export class InvoiceClient extends YZHclient {
   constructor(conf: {
     dealer_id: string
     broker_id: string
@@ -243,6 +277,20 @@ export class Invoice extends YZHclient {
     )
   }
 
+  // GetInvoiceInformation 查询发票信息
+  async GetInvoiceInformation(
+    req: GetInvoiceInformationRequest,
+    cb?: (error: null | string, rep: GetInvoiceInformationResponse) => void
+  ): Promise<GetInvoiceInformationResponse> {
+    return this.request(
+      "post",
+      "/api/invoice/v2/invoice-face-information",
+      req,
+      { encryption: false },
+      cb
+    )
+  }
+
   // GetInvoiceFile 下载 PDF 版发票
   async GetInvoiceFile(
     req: GetInvoiceFileRequest,

package/src/services/payment/index.ts

@@ -422,7 +422,7 @@ interface ConfirmBatchOrderRequest {
 /** ConfirmBatchOrderResponse 批次确认响应 */
 interface ConfirmBatchOrderResponse {}
 
-export class Payment extends YZHclient {
+export class PaymentClient extends YZHclient {
   constructor(conf: {
     dealer_id: string
     broker_id: string

package/src/services/tax/index.ts

@@ -44,7 +44,7 @@ interface GetUserCrossResponse {
   is_cross: boolean
 }
 
-export class Tax extends YZHclient {
+export class TaxClient extends YZHclient {
   constructor(conf: {
     dealer_id: string
     broker_id: string

package/yzh/common/client.d.ts

@@ -39,7 +39,7 @@ export declare class YZHClient {
      * @param {object} params
      * @returns {*} object
      */
-    private generatorResquestParams;
+    private generatorRequestParams;
     /**
      * 生成签名（RSA-SHA256）
      * @param {string} data 经过加密后的具体数据
@@ -47,7 +47,7 @@ export declare class YZHClient {
      * @param {string} timestamp 时间戳，精确到秒
      * @returns {string} 签名内容
      */
-    private generatorSignRSASHA256;
+    private signRSASHA256;
     /**
      * 生成签名（HmacSHA256）
      * @param {string} data 经过加密后的具体数据
@@ -55,7 +55,7 @@ export declare class YZHClient {
      * @param {string} timestamp 时间戳，精确到秒
      * @returns {string} 签名内容
      */
-    private generatorSignHmacSHA256;
+    private signHmacSHA256;
     /**
      * 生成签名
      * @param {string} data 经过加密后的具体数据
@@ -64,7 +64,7 @@ export declare class YZHClient {
      * @param {string} sign_type 签名方式
      * @returns {string} 签名内容
      */
-    private generatorSign;
+    private sign;
     private mess;
     /**
      * 3DES 加密数据
@@ -78,7 +78,7 @@ export declare class YZHClient {
      * @param ciphertext
      * @returns 明文数据
      */
-    decryption: (ciphertext: string) => any;
+    decrypt: (ciphertext: string) => any;
     /**
      * 验签
      * @param {string} data 返回的数据

package/yzh/common/client.js

@@ -26,7 +26,7 @@ class YZHClient {
          * @param {string} timestamp 时间戳，精确到秒
          * @returns {string} 签名内容
          */
-        this.generatorSignRSASHA256 = (data, mess, timestamp) => {
+        this.signRSASHA256 = (data, mess, timestamp) => {
             try {
                 const plaintext = `data=${data}&mess=${mess}&timestamp=${timestamp}&key=${this.app_key}`;
                 const sign = crypto.createSign("RSA-SHA256");
@@ -45,7 +45,7 @@ class YZHClient {
          * @param {string} timestamp 时间戳，精确到秒
          * @returns {string} 签名内容
          */
-        this.generatorSignHmacSHA256 = (data, mess, timestamp) => {
+        this.signHmacSHA256 = (data, mess, timestamp) => {
             try {
                 const plaintext = `data=${data}&mess=${mess}&timestamp=${timestamp}&key=${this.app_key}`;
                 const hmac = crypto.createHmac("sha256", this.app_key);
@@ -64,17 +64,17 @@ class YZHClient {
          * @param {string} sign_type 签名方式
          * @returns {string} 签名内容
          */
-        this.generatorSign = (data, mess, timestamp) => {
+        this.sign = (data, mess, timestamp) => {
             try {
                 switch (this.sign_type) {
                     case "rsa": {
-                        return this.generatorSignRSASHA256(data, mess, timestamp);
+                        return this.signRSASHA256(data, mess, timestamp);
                     }
                     case "sha256": {
-                        return this.generatorSignHmacSHA256(data, mess, timestamp);
+                        return this.signHmacSHA256(data, mess, timestamp);
                     }
                     default:
-                        throw new yzhSDKHttpException_1.default(`sign_type类型不存在`);
+                        throw new yzhSDKHttpException_1.default(`sign_type 类型不存在`);
                 }
             }
             catch (err) {
@@ -111,7 +111,7 @@ class YZHClient {
          * @param ciphertext
          * @returns 明文数据
          */
-        this.decryption = (ciphertext) => {
+        this.decrypt = (ciphertext) => {
             try {
                 const iv = this.des3_key.slice(0, 8);
                 const cipherChunks = [];
@@ -188,7 +188,7 @@ class YZHClient {
                 const verifyResult = verifyMap[this.sign_type](data, mess, timestamp, sign);
                 let plaintext = {};
                 if (verifyResult) {
-                    plaintext = this.decryption(data);
+                    plaintext = this.decrypt(data);
                 }
                 return {
                     result: verifyResult,
@@ -225,12 +225,12 @@ class YZHClient {
     }
     // 基础请求：进行请求实例生成 Header，动态设置、请求体包装等偏底层操作
     doRequest(method, action, req) {
-        var _a;
+        const { request_id, ...resReq } = req;
         // 请求参数加密
-        const encryptParams = this.generatorResquestParams(req);
+        const encryptParams = this.generatorRequestParams(resReq);
         // 生成请求实例，配置 Header
         const instance = (0, http_1.default)({
-            request_id: (_a = req === null || req === void 0 ? void 0 : req.request_id) !== null && _a !== void 0 ? _a : this.mess(),
+            request_id: request_id !== null && request_id !== void 0 ? request_id : this.mess(),
             dealer_id: this.dealer_id,
             base_url: this.base_url,
         });
@@ -272,13 +272,13 @@ class YZHClient {
      * @param {object} params
      * @returns {*} object
      */
-    generatorResquestParams(params) {
+    generatorRequestParams(params) {
         try {
             const t = Date.now().toString();
             const m = this.mess();
             const plaintext = JSON.stringify(params);
             const data = this.encrypt(plaintext);
-            const signStr = this.generatorSign(data, m, t);
+            const signStr = this.sign(data, m, t);
             return {
                 data,
                 mess: m,
@@ -299,12 +299,12 @@ class YZHClient {
             throw yzhError;
         }
         else {
-            // httpcode 200
+            // HTTP Status Code 200
             const { data: axiosData } = result;
             let response = axiosData;
             // 需解密
             if (encryption) {
-                response = { ...response, data: this.decryption(response.data) };
+                response = { ...response, data: this.decrypt(response.data) };
             }
             return response;
         }

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

@@ -13,6 +13,20 @@ interface ApiUseSignContractResponse {
     /** 协议名称 */
     title: string;
 }
+/** ApiUserSignContractRequest 获取协议预览 URL 请求 V2 */
+interface ApiUserSignContractRequest {
+    /** 平台企业 ID */
+    dealer_id: string;
+    /** 综合服务主体 ID */
+    broker_id: string;
+}
+/** ApiUserSignContractResponse 获取协议预览 URL 返回 V2 */
+interface ApiUserSignContractResponse {
+    /** 预览跳转 URL */
+    url: string;
+    /** 协议名称 */
+    title: string;
+}
 /** ApiUserSignRequest 用户签约请求 */
 interface ApiUserSignRequest {
     /** 综合服务主体 ID */
@@ -67,7 +81,7 @@ interface ApiUserSignReleaseResponse {
     /** 是否解约成功 */
     status: string;
 }
-export declare class Apiusersign extends YZHclient {
+export declare class ApiUserSignServiceClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
         broker_id: string;
@@ -79,6 +93,7 @@ export declare class Apiusersign extends YZHclient {
         base_url?: string;
     });
     ApiUseSignContract(req: ApiUseSignContractRequest, cb?: (error: null | string, rep: ApiUseSignContractResponse) => void): Promise<ApiUseSignContractResponse>;
+    ApiUserSignContract(req: ApiUserSignContractRequest, cb?: (error: null | string, rep: ApiUserSignContractResponse) => void): Promise<ApiUserSignContractResponse>;
     ApiUserSign(req: ApiUserSignRequest, cb?: (error: null | string, rep: ApiUserSignResponse) => void): Promise<ApiUserSignResponse>;
     GetApiUserSignStatus(req: GetApiUserSignStatusRequest, cb?: (error: null | string, rep: GetApiUserSignStatusResponse) => void): Promise<GetApiUserSignStatusResponse>;
     ApiUserSignRelease(req: ApiUserSignReleaseRequest, cb?: (error: null | string, rep: ApiUserSignReleaseResponse) => void): Promise<ApiUserSignReleaseResponse>;

package/yzh/services/apiusersign/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Apiusersign = void 0;
+exports.ApiUserSignServiceClient = void 0;
 const client_1 = require("../../common/client");
-class Apiusersign extends client_1.default {
+class ApiUserSignServiceClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
@@ -10,6 +10,10 @@ class Apiusersign extends client_1.default {
     async ApiUseSignContract(req, cb) {
         return this.request("get", "/api/sign/v1/user/contract", req, { encryption: false }, cb);
     }
+    // ApiUserSignContract 获取协议预览 URL V2
+    async ApiUserSignContract(req, cb) {
+        return this.request("get", "/api/sign/v1/user/contract", req, { encryption: false }, cb);
+    }
     // ApiUserSign 用户签约
     async ApiUserSign(req, cb) {
         return this.request("post", "/api/sign/v1/user/sign", req, { encryption: false }, cb);
@@ -23,4 +27,4 @@ class Apiusersign extends client_1.default {
         return this.request("post", "/api/sign/v1/user/release", req, { encryption: false }, cb);
     }
 }
-exports.Apiusersign = Apiusersign;
+exports.ApiUserSignServiceClient = ApiUserSignServiceClient;

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

@@ -130,7 +130,7 @@ interface GetBankCardInfoResponse {
     /** 云账户是否支持向该银行支付 */
     is_support: boolean;
 }
-export declare class Authentication extends YZHclient {
+export declare class AuthenticationClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
         broker_id: string;

package/yzh/services/authentication/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Authentication = void 0;
+exports.AuthenticationClient = void 0;
 const client_1 = require("../../common/client");
-class Authentication extends client_1.default {
+class AuthenticationClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
@@ -39,4 +39,4 @@ class Authentication extends client_1.default {
         return this.request("get", "/api/payment/v1/card", req, { encryption: false }, cb);
     }
 }
-exports.Authentication = Authentication;
+exports.AuthenticationClient = AuthenticationClient;

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

@@ -16,7 +16,7 @@ interface H5GetStartUrlRequest {
     /** 跳转 URL */
     return_url: string;
     /** H5 页面 Title */
-    custom_title: number;
+    customer_title: number;
 }
 /** H5GetStartUrlResponse 预启动返回 */
 interface H5GetStartUrlResponse {
@@ -59,7 +59,7 @@ interface H5EcoCityAicStatusResponse {
     /** 姓名 */
     real_name: string;
 }
-export declare class Bizlicxjjh5 extends YZHclient {
+export declare class BizlicXjjH5ServiceClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
         broker_id: string;

package/yzh/services/bizlicxjjh5/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Bizlicxjjh5 = void 0;
+exports.BizlicXjjH5ServiceClient = void 0;
 const client_1 = require("../../common/client");
-class Bizlicxjjh5 extends client_1.default {
+class BizlicXjjH5ServiceClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
@@ -15,4 +15,4 @@ class Bizlicxjjh5 extends client_1.default {
         return this.request("get", "/api/aic/new-economy/h5/v1/status", req, { encryption: false }, cb);
     }
 }
-exports.Bizlicxjjh5 = Bizlicxjjh5;
+exports.BizlicXjjH5ServiceClient = BizlicXjjH5ServiceClient;

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

@@ -46,7 +46,7 @@ interface H5APIGetStartUrlRequest {
     /** 跳转 URL */
     return_url: string;
     /** H5 页面 Title */
-    custom_title: number;
+    customer_title: number;
 }
 /** H5APIGetStartUrlResponse 预启动返回 */
 interface H5APIGetStartUrlResponse {
@@ -89,7 +89,7 @@ interface H5APIEcoCityAicStatusResponse {
     /** 姓名 */
     real_name: string;
 }
-export declare class Bizlicxjjh5api extends YZHclient {
+export declare class BizlicXjjH5APIServiceClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
         broker_id: string;

package/yzh/services/bizlicxjjh5api/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Bizlicxjjh5api = void 0;
+exports.BizlicXjjH5APIServiceClient = void 0;
 const client_1 = require("../../common/client");
-class Bizlicxjjh5api extends client_1.default {
+class BizlicXjjH5APIServiceClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
@@ -19,4 +19,4 @@ class Bizlicxjjh5api extends client_1.default {
         return this.request("get", "/api/aic/new-economy/api-h5/v1/status", req, { encryption: false }, cb);
     }
 }
-exports.Bizlicxjjh5api = Bizlicxjjh5api;
+exports.BizlicXjjH5APIServiceClient = BizlicXjjH5APIServiceClient;

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

@@ -223,7 +223,7 @@ interface StatementDetail {
     /** 项目名称 */
     project_name: string;
 }
-export declare class Dataservice extends YZHclient {
+export declare class DataServiceClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
         broker_id: string;

package/yzh/services/dataservice/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Dataservice = void 0;
+exports.DataServiceClient = void 0;
 const client_1 = require("../../common/client");
-class Dataservice extends client_1.default {
+class DataServiceClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
@@ -35,4 +35,4 @@ class Dataservice extends client_1.default {
         return this.request("get", "/api/dataservice/v1/statements-daily", req, { encryption: false }, cb);
     }
 }
-exports.Dataservice = Dataservice;
+exports.DataServiceClient = DataServiceClient;

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

@@ -73,7 +73,7 @@ interface H5UserReleaseResponse {
     /** 是否解约成功 */
     status: string;
 }
-export declare class H5usersign extends YZHclient {
+export declare class H5UserSignServiceClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
         broker_id: string;

package/yzh/services/h5usersign/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.H5usersign = void 0;
+exports.H5UserSignServiceClient = void 0;
 const client_1 = require("../../common/client");
-class H5usersign extends client_1.default {
+class H5UserSignServiceClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
@@ -23,4 +23,4 @@ class H5usersign extends client_1.default {
         return this.request("post", "/api/sdk/v1/sign/release", req, { encryption: false }, cb);
     }
 }
-exports.H5usersign = H5usersign;
+exports.H5UserSignServiceClient = H5UserSignServiceClient;

package/yzh/services/index.d.ts

@@ -1,10 +1,10 @@
 export { Util } from "../common/utils";
-export { Apiusersign } from "./apiusersign";
-export { Authentication } from "./authentication";
-export { Dataservice } from "./dataservice";
-export { H5usersign } from "./h5usersign";
-export { Invoice } from "./invoice";
-export { Payment } from "./payment";
-export { Tax } from "./tax";
-export { Bizlicxjjh5api } from "./bizlicxjjh5api";
-export { Bizlicxjjh5 } from "./bizlicxjjh5";
+export { ApiUserSignServiceClient } from "./apiusersign";
+export { AuthenticationClient } from "./authentication";
+export { DataServiceClient } from "./dataservice";
+export { H5UserSignServiceClient } from "./h5usersign";
+export { InvoiceClient } from "./invoice";
+export { PaymentClient } from "./payment";
+export { TaxClient } from "./tax";
+export { BizlicXjjH5APIServiceClient } from "./bizlicxjjh5api";
+export { BizlicXjjH5ServiceClient } from "./bizlicxjjh5";

package/yzh/services/index.js

@@ -1,23 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Bizlicxjjh5 = exports.Bizlicxjjh5api = exports.Tax = exports.Payment = exports.Invoice = exports.H5usersign = exports.Dataservice = exports.Authentication = exports.Apiusersign = exports.Util = void 0;
+exports.BizlicXjjH5ServiceClient = exports.BizlicXjjH5APIServiceClient = exports.TaxClient = exports.PaymentClient = exports.InvoiceClient = exports.H5UserSignServiceClient = exports.DataServiceClient = exports.AuthenticationClient = exports.ApiUserSignServiceClient = exports.Util = void 0;
 var utils_1 = require("../common/utils");
 Object.defineProperty(exports, "Util", { enumerable: true, get: function () { return utils_1.Util; } });
 var apiusersign_1 = require("./apiusersign");
-Object.defineProperty(exports, "Apiusersign", { enumerable: true, get: function () { return apiusersign_1.Apiusersign; } });
+Object.defineProperty(exports, "ApiUserSignServiceClient", { enumerable: true, get: function () { return apiusersign_1.ApiUserSignServiceClient; } });
 var authentication_1 = require("./authentication");
-Object.defineProperty(exports, "Authentication", { enumerable: true, get: function () { return authentication_1.Authentication; } });
+Object.defineProperty(exports, "AuthenticationClient", { enumerable: true, get: function () { return authentication_1.AuthenticationClient; } });
 var dataservice_1 = require("./dataservice");
-Object.defineProperty(exports, "Dataservice", { enumerable: true, get: function () { return dataservice_1.Dataservice; } });
+Object.defineProperty(exports, "DataServiceClient", { enumerable: true, get: function () { return dataservice_1.DataServiceClient; } });
 var h5usersign_1 = require("./h5usersign");
-Object.defineProperty(exports, "H5usersign", { enumerable: true, get: function () { return h5usersign_1.H5usersign; } });
+Object.defineProperty(exports, "H5UserSignServiceClient", { enumerable: true, get: function () { return h5usersign_1.H5UserSignServiceClient; } });
 var invoice_1 = require("./invoice");
-Object.defineProperty(exports, "Invoice", { enumerable: true, get: function () { return invoice_1.Invoice; } });
+Object.defineProperty(exports, "InvoiceClient", { enumerable: true, get: function () { return invoice_1.InvoiceClient; } });
 var payment_1 = require("./payment");
-Object.defineProperty(exports, "Payment", { enumerable: true, get: function () { return payment_1.Payment; } });
+Object.defineProperty(exports, "PaymentClient", { enumerable: true, get: function () { return payment_1.PaymentClient; } });
 var tax_1 = require("./tax");
-Object.defineProperty(exports, "Tax", { enumerable: true, get: function () { return tax_1.Tax; } });
+Object.defineProperty(exports, "TaxClient", { enumerable: true, get: function () { return tax_1.TaxClient; } });
 var bizlicxjjh5api_1 = require("./bizlicxjjh5api");
-Object.defineProperty(exports, "Bizlicxjjh5api", { enumerable: true, get: function () { return bizlicxjjh5api_1.Bizlicxjjh5api; } });
+Object.defineProperty(exports, "BizlicXjjH5APIServiceClient", { enumerable: true, get: function () { return bizlicxjjh5api_1.BizlicXjjH5APIServiceClient; } });
 var bizlicxjjh5_1 = require("./bizlicxjjh5");
-Object.defineProperty(exports, "Bizlicxjjh5", { enumerable: true, get: function () { return bizlicxjjh5_1.Bizlicxjjh5; } });
+Object.defineProperty(exports, "BizlicXjjH5ServiceClient", { enumerable: true, get: function () { return bizlicxjjh5_1.BizlicXjjH5ServiceClient; } });

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

@@ -101,6 +101,37 @@ interface GetInvoiceStatusResponse {
     /** 快递单号 */
     waybill_number: string[];
 }
+/** GetInvoiceInformationRequest 查询发票信息请求 */
+interface GetInvoiceInformationRequest {
+    /** 发票申请编号 */
+    invoice_apply_id: string;
+    /** 发票申请单 ID */
+    application_id: string;
+}
+/** GetInvoiceInformationResponse 查询发票信息返回 */
+interface GetInvoiceInformationResponse {
+    /** 发票信息 */
+    information: InformationDataInfo[];
+}
+/** InformationDataInfo 查询发票信息返回 */
+interface InformationDataInfo {
+    /** 货物或应税劳务、服务名称 */
+    goods_services_name: string;
+    /** 发票号码 */
+    invoice_num: string;
+    /** 发票代码 */
+    invoice_code: string;
+    /** 不含税金额 */
+    price_amount: string;
+    /** 税额 */
+    tax_amount: string;
+    /** 税率 */
+    tax_rate: string;
+    /** 价税合计 */
+    price_tax_amount: string;
+    /** 开票日期 */
+    invoiced_date: string;
+}
 /** BankNameAccount 系统支持的开户行及账号 */
 interface BankNameAccount {
     /** 开户行及账号 */
@@ -139,7 +170,7 @@ interface SendReminderEmailRequest {
 /** SendReminderEmailResponse 发送发票扫描件压缩包下载链接邮件返回 */
 interface SendReminderEmailResponse {
 }
-export declare class Invoice extends YZHclient {
+export declare class InvoiceClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
         broker_id: string;
@@ -154,6 +185,7 @@ export declare class Invoice extends YZHclient {
     GetInvoiceAmount(req: GetInvoiceAmountRequest, cb?: (error: null | string, rep: GetInvoiceAmountResponse) => void): Promise<GetInvoiceAmountResponse>;
     ApplyInvoice(req: ApplyInvoiceRequest, cb?: (error: null | string, rep: ApplyInvoiceResponse) => void): Promise<ApplyInvoiceResponse>;
     GetInvoiceStatus(req: GetInvoiceStatusRequest, cb?: (error: null | string, rep: GetInvoiceStatusResponse) => void): Promise<GetInvoiceStatusResponse>;
+    GetInvoiceInformation(req: GetInvoiceInformationRequest, cb?: (error: null | string, rep: GetInvoiceInformationResponse) => void): Promise<GetInvoiceInformationResponse>;
     GetInvoiceFile(req: GetInvoiceFileRequest, cb?: (error: null | string, rep: GetInvoiceFileResponse) => void): Promise<GetInvoiceFileResponse>;
     SendReminderEmail(req: SendReminderEmailRequest, cb?: (error: null | string, rep: SendReminderEmailResponse) => void): Promise<SendReminderEmailResponse>;
 }

package/yzh/services/invoice/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Invoice = void 0;
+exports.InvoiceClient = void 0;
 const client_1 = require("../../common/client");
-class Invoice extends client_1.default {
+class InvoiceClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
@@ -22,6 +22,10 @@ class Invoice extends client_1.default {
     async GetInvoiceStatus(req, cb) {
         return this.request("post", "/api/invoice/v2/invoice/invoice-status", req, { encryption: false }, cb);
     }
+    // GetInvoiceInformation 查询发票信息
+    async GetInvoiceInformation(req, cb) {
+        return this.request("post", "/api/invoice/v2/invoice-face-information", req, { encryption: false }, cb);
+    }
     // GetInvoiceFile 下载 PDF 版发票
     async GetInvoiceFile(req, cb) {
         return this.request("post", "/api/invoice/v2/invoice/invoice-pdf", req, { encryption: false }, cb);
@@ -31,4 +35,4 @@ class Invoice extends client_1.default {
         return this.request("post", "/api/invoice/v2/invoice/reminder/email", req, { encryption: false }, cb);
     }
 }
-exports.Invoice = Invoice;
+exports.InvoiceClient = InvoiceClient;

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

@@ -333,7 +333,7 @@ interface ConfirmBatchOrderRequest {
 /** ConfirmBatchOrderResponse 批次确认响应 */
 interface ConfirmBatchOrderResponse {
 }
-export declare class Payment extends YZHclient {
+export declare class PaymentClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
         broker_id: string;

package/yzh/services/payment/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Payment = void 0;
+exports.PaymentClient = void 0;
 const client_1 = require("../../common/client");
-class Payment extends client_1.default {
+class PaymentClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
@@ -47,4 +47,4 @@ class Payment extends client_1.default {
         return this.request("post", "/api/payment/v1/confirm-batch", req, { encryption: false }, cb);
     }
 }
-exports.Payment = Payment;
+exports.PaymentClient = PaymentClient;

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

@@ -38,7 +38,7 @@ interface GetUserCrossResponse {
     /** 跨集团标识 */
     is_cross: boolean;
 }
-export declare class Tax extends YZHclient {
+export declare class TaxClient extends YZHclient {
     constructor(conf: {
         dealer_id: string;
         broker_id: string;

package/yzh/services/tax/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Tax = void 0;
+exports.TaxClient = void 0;
 const client_1 = require("../../common/client");
-class Tax extends client_1.default {
+class TaxClient extends client_1.default {
     constructor(conf) {
         super(conf);
     }
@@ -15,4 +15,4 @@ class Tax extends client_1.default {
         return this.request("post", "/api/tax/v1/user/cross", req, { encryption: false }, cb);
     }
 }
-exports.Tax = Tax;
+exports.TaxClient = TaxClient;