@atomsolution/invoice-sdk-api 1.26.1 → 1.28.0

package/dist/api.d.ts

@@ -252,6 +252,26 @@ export interface CreateInvoiceRequestInv {
      * @memberof CreateInvoiceRequestInv
      */
     type?: string;
+    /**
+     * Xác định có gửi mail khi hóa đơn phát hành có hiệu lực hay không:
+     * - true: Gửi mail khi hóa đơn phát hành có hiệu lực
+     * - false: không gửi mail khi hóa đơn phát hành có hiệu lực
+     * @type {boolean}
+     * @memberof CreateInvoiceRequestInv
+     */
+    is_send_mail?: boolean;
+    /**
+     * Tên người nhận
+     * @type {string}
+     * @memberof CreateInvoiceRequestInv
+     */
+    receiver_name?: string;
+    /**
+     * Email người nhận
+     * @type {string}
+     * @memberof CreateInvoiceRequestInv
+     */
+    receiver_email?: string;
     /**
      *
      * @type {Array<CreateInvoiceItem>}
@@ -434,7 +454,31 @@ export interface GetInvoiceRequest {
      * @type {string}
      * @memberof GetInvoiceRequest
      */
-    stax: string;
+    stax?: string;
+    /**
+     * Ngày bắt đầu lọc hóa đơn (định dạng yyyy-MM-dd)
+     * @type {string}
+     * @memberof GetInvoiceRequest
+     */
+    from_date?: string;
+    /**
+     * Ngày kết thúc lọc hóa đơn (định dạng yyyy-MM-dd)
+     * @type {string}
+     * @memberof GetInvoiceRequest
+     */
+    to_date?: string;
+    /**
+     * Số dòng cần lấy
+     * @type {number}
+     * @memberof GetInvoiceRequest
+     */
+    start?: number;
+    /**
+     * Vị trí bắt đầu lấy
+     * @type {number}
+     * @memberof GetInvoiceRequest
+     */
+    count?: number;
 }
 /**
  *
@@ -504,6 +548,24 @@ export interface GetInvoicesRequest {
      * @memberof GetInvoicesRequest
      */
     to_date?: string;
+    /**
+     * Số dòng cần lấy
+     * @type {number}
+     * @memberof GetInvoiceRequest
+     */
+    start?: number;
+    /**
+     * Vị trí bắt đầu lấy
+     * @type {number}
+     * @memberof GetInvoiceRequest
+     */
+    count?: number;
+    /**
+     * Mã số thuế của người bán
+     * @type {string}
+     * @memberof GetInvoiceRequest
+     */
+    stax?: string;
 }
 /**
  *
@@ -582,14 +644,6 @@ export interface SignContractRequest {
  * @interface SignContractRequestInv
  */
 export interface SignContractRequestInv {
-    /**
-     * Sid hóa đơn. Bắt buộc nếu không truyền form-serial-seq
-     * - M-Invoice -> hoadon68_id
-     * - FPT -> inv.sid
-     * @type {string}
-     * @memberof SignContractRequestInv
-     */
-    sid?: string;
     /**
      * Ký hiệu hóa đơn. Bắt buộc nếu không truyền sid
      * FPT Only
@@ -609,6 +663,14 @@ export interface SignContractRequestInv {
      * @memberof SignContractRequestInv
      */
     stax: string;
+    /**
+     * Xác định đính kèm file (PDF, XML) khi gửi mail:
+     * - 1: Gửi mail có đính kèm file
+     * - Không có thẻ sendfile: mặc định gửi mail không đính kèm file
+     * @type {number}
+     * @memberof SignContractRequestInv
+     */
+    sendfile?: number;
     /**
      * Thẻ xác định KHÔNG gửi email:
      * - 1: KHÔNG tự động gửi email khi hóa đơn phát hành có hiệu lực
@@ -618,13 +680,17 @@ export interface SignContractRequestInv {
      */
     notsendmail?: number;
     /**
-     * Xác định đính kèm file (PDF, XML) khi gửi mail:
-     * - 1: Gửi mail có đính kèm file
-     * - Không có thẻ sendfile: mặc định gửi mail không đính kèm file
-     * @type {number}
+     * Ngày bắt đầu lọc hóa đơn (định dạng yyyy-MM-dd)
+     * @type {string}
      * @memberof SignContractRequestInv
      */
-    sendfile?: number;
+    start_date?: string;
+    /**
+     * Ngày kết thúc lọc hóa đơn (định dạng yyyy-MM-dd)
+     * @type {string}
+     * @memberof SignContractRequestInv
+     */
+    end_date?: string;
 }
 /**
  *
@@ -972,6 +1038,12 @@ export interface GetInvoiceSerialsRequest {
      * @memberof GetInvoiceSerialsRequest
      */
     inv_type: string;
+    /**
+     * Mã số thuế bên bán
+     * @type {string}
+     * @memberof GetInvoiceSerialsRequest
+     */
+    stax?: string;
 }
 /**
  *
@@ -1032,20 +1104,15 @@ export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getInvoice: (id: string, stax?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    getInvoice: (params: GetInvoiceRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Lấy danh sách tất cả hóa đơn dựa trên bộ lọc được cung cấp.
      * @summary API lấy danh sách hóa đơn
-     * @param {string} fromDate Ngày bắt đầu lọc hóa đơn (định dạng yyyy-MM-dd)
-     * @param {string} toDate Ngày kết thúc lọc hóa đơn (định dạng yyyy-MM-dd)
-     * @param {string} stax mã số thuế bên bán
-     * @param {number} [start] Vị trí bắt đầu của danh sách hóa đơn (phân trang)
-     * @param {number} [count] Số lượng hóa đơn cần lấy (phân trang)
-     * @param {string} [serial] Ký hiệu hóa đơn để lọc
+     * @param {GetInvoicesRequest} params
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getInvoices: (fromDate: string, toDate: string, stax?: string, start?: number, count?: number, serial?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    getInvoices: (params: GetInvoicesRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Ký hợp đồng điện tử với thông tin hợp đồng được cung cấp.
      * @summary API ký hóa đơn
@@ -1070,7 +1137,7 @@ export declare const DefaultApiAxiosParamCreator: (configuration?: Configuration
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    viewPrintInvoice: (id: string, stax?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    viewPrintInvoice: (id: string, stax?: string, template_code?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Lấy thông tin chi tiết của một mã số thuế (MST) dựa trên mã số thuế được cung cấp.
      * @summary API lấy thông tin mã số thuế
@@ -1146,7 +1213,7 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getInvoice(id: string, stax?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetInvoiceResponse>>;
+    getInvoice(params: GetInvoiceRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetInvoiceResponse>>;
     /**
      * Lấy danh sách tất cả hóa đơn dựa trên bộ lọc được cung cấp.
      * @summary API lấy danh sách hóa đơn
@@ -1159,7 +1226,7 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getInvoices(fromDate: string, toDate: string, stax?: string, start?: number, count?: number, serial?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetInvoicesSuccess>>;
+    getInvoices(params: GetInvoicesRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetInvoicesSuccess>>;
     /**
      * Ký hợp đồng điện tử với thông tin hợp đồng được cung cấp.
      * @summary API ký hóa đơn
@@ -1184,7 +1251,7 @@ export declare const DefaultApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    viewPrintInvoice(id: string, stax?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ViewPrintInvoiceResponse>>;
+    viewPrintInvoice(id: string, stax?: string, template_code?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ViewPrintInvoiceResponse>>;
     /**
      * Lấy thông tin chi tiết của một mã số thuế (MST) dựa trên mã số thuế được cung cấp.
      * @summary API lấy thông tin mã số thuế
@@ -1264,7 +1331,7 @@ export declare class DefaultApi extends BaseAPI {
      * @throws {RequiredError}
      * @memberof DefaultApi
      */
-    getInvoice(id: string, stax?: string, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<GetInvoiceResponse, any>>;
+    getInvoice(params: GetInvoiceRequest, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<GetInvoiceResponse, any>>;
     /**
      * Lấy danh sách tất cả hóa đơn dựa trên bộ lọc được cung cấp.
      * @summary API lấy danh sách hóa đơn
@@ -1278,7 +1345,7 @@ export declare class DefaultApi extends BaseAPI {
      * @throws {RequiredError}
      * @memberof DefaultApi
      */
-    getInvoices(fromDate: string, toDate: string, stax?: string, start?: number, count?: number, serial?: string, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<GetInvoicesSuccess, any>>;
+    getInvoices(params: GetInvoicesRequest, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<GetInvoicesSuccess, any>>;
     /**
      * Ký hợp đồng điện tử với thông tin hợp đồng được cung cấp.
      * @summary API ký hóa đơn
@@ -1306,7 +1373,7 @@ export declare class DefaultApi extends BaseAPI {
      * @throws {RequiredError}
      * @memberof DefaultApi
      */
-    viewPrintInvoice(id: string, stax?: string, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<ViewPrintInvoiceResponse, any>>;
+    viewPrintInvoice(id: string, stax?: string, template_code?: string, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<ViewPrintInvoiceResponse, any>>;
     /**
      * Lấy thông tin chi tiết của một mã số thuế (MST) dựa trên mã số thuế được cung cấp.
      * @summary API lấy thông tin mã số thuế
@@ -1344,14 +1411,7 @@ export declare class DefaultApi extends BaseAPI {
     /**
      * Check customer declaration status with filtering options.
      * @summary API check customer declaration status
-     * @param {string} provider Provider identifier (required)
-     * @param {string} taxCode Tax code for merchant (required)
-     * @param {number} [maxResultCount] Tổng số bản ghi muốn lấy
-     * @param {string} [sorting] Sắp xếp theo trường (tên trường)
-     * @param {string} [sortType] Kiểu sắp xếp (DESCEND: Giảm dần, ASCEND: Tăng dần)
-     * @param {string} [fromDate] Ngày lập từ ngày (2025-06-23T00:00:00)
-     * @param {string} [toDate] Ngày lập đến ngày (2025-06-23T00:00:00)
-     * @param {number} [taxAuthorityFeedback] Phản hồi của CQT (1: Tiếp nhận, 2: Không tiếp nhận, 3: Chập nhận, 4: Không chấp nhận)
+     * @param {CheckCustomerDeclarationStatusRequest} params
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof DefaultApi
@@ -1381,21 +1441,11 @@ export declare const InvoiceApi: (configuration?: Configuration, basePath?: stri
     /**
      * Get Invoice (Unified)
      */
-    getInvoice(params: {
-        id: string;
-        stax?: string;
-    }, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<GetInvoiceResponse, any>>;
+    getInvoice(params: GetInvoiceRequest, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<GetInvoiceResponse, any>>;
     /**
      * Get Invoices (Unified)
      */
-    getInvoices(params: {
-        fromDate: string;
-        toDate: string;
-        stax?: string;
-        start?: number;
-        count?: number;
-        serial?: string;
-    }, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<GetInvoicesSuccess, any>>;
+    getInvoices(params: GetInvoicesRequest, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<GetInvoicesSuccess, any>>;
     /**
      * Sign Contract (Unified)
      */
@@ -1410,6 +1460,7 @@ export declare const InvoiceApi: (configuration?: Configuration, basePath?: stri
     viewPrintInvoice(params: {
         id: string;
         stax?: string;
+        template_code?: string;
     }, options?: RawAxiosRequestConfig): Promise<import('axios').AxiosResponse<ViewPrintInvoiceResponse, any>>;
     /**
      * Tax Info (Unified)

package/dist/auth.d.ts

@@ -11,7 +11,7 @@ export declare const PROVIDERS: IProvider[];
  * Returns a list of available providers
  * @returns {IProvider[]}
  */
-export declare function getListProviders(bank: string, mode: string): Promise<IProvider[]>;
+export declare function getListProviders(mode: string, bank: string): Promise<IProvider[]>;
 /**
  * Save one provider info (encrypted)
  */

package/dist/configuration.d.ts

@@ -1,7 +1,8 @@
 export declare enum Provider {
     MInvoice = "m-invoice",
     FPT = "fpt",
-    MISA = "misa"
+    MISA = "misa",
+    Viettel = "viettel"
 }
 export interface ConfigurationParameters {
     clientId?: string;