@jugarhoy/api 1.1.26 → 1.1.27

package/apis/AdminPaymentConfigsApi.ts

@@ -15,6 +15,7 @@
 
 import * as runtime from '../runtime';
 import type {
+  BankCard,
   CreateCustomerPaymentConfigDto,
   CustomerPaymentConfig,
   CustomerPaymentConfigDto,
@@ -24,6 +25,8 @@ import type {
   SuccessResponse,
 } from '../models/index';
 import {
+    BankCardFromJSON,
+    BankCardToJSON,
     CreateCustomerPaymentConfigDtoFromJSON,
     CreateCustomerPaymentConfigDtoToJSON,
     CustomerPaymentConfigFromJSON,
@@ -185,6 +188,40 @@ export class AdminPaymentConfigsApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Get all available bank cards
+     */
+    async getBankCardsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<BankCard>>> {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/admin/payment-configs/bank-cards`,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(BankCardFromJSON));
+    }
+
+    /**
+     * Get all available bank cards
+     */
+    async getBankCards(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<BankCard>> {
+        const response = await this.getBankCardsRaw(initOverrides);
+        return await response.value();
+    }
+
     /**
      * Get MercadoPago authorization URL for OAuth flow
      */

package/apis/AdminSubscriptionBillingApi.ts

@@ -15,32 +15,52 @@
 
 import * as runtime from '../runtime';
 import type {
+  BillingSummaryItemDto,
+  BulkMarkBillsPaid200Response,
   DeleteShift200Response,
   GenerateSubscriptionBillsRequest,
   LinkPaymentToBillRequest,
+  MarkBillAsPaidRequest,
   SubscriptionBill,
+  SubscriptionBillPageDto,
   UpdateBillRequest,
+  UploadBillReceipt200Response,
 } from '../models/index';
 import {
+    BillingSummaryItemDtoFromJSON,
+    BillingSummaryItemDtoToJSON,
+    BulkMarkBillsPaid200ResponseFromJSON,
+    BulkMarkBillsPaid200ResponseToJSON,
     DeleteShift200ResponseFromJSON,
     DeleteShift200ResponseToJSON,
     GenerateSubscriptionBillsRequestFromJSON,
     GenerateSubscriptionBillsRequestToJSON,
     LinkPaymentToBillRequestFromJSON,
     LinkPaymentToBillRequestToJSON,
+    MarkBillAsPaidRequestFromJSON,
+    MarkBillAsPaidRequestToJSON,
     SubscriptionBillFromJSON,
     SubscriptionBillToJSON,
+    SubscriptionBillPageDtoFromJSON,
+    SubscriptionBillPageDtoToJSON,
     UpdateBillRequestFromJSON,
     UpdateBillRequestToJSON,
+    UploadBillReceipt200ResponseFromJSON,
+    UploadBillReceipt200ResponseToJSON,
 } from '../models/index';
 
+export interface BulkMarkBillsPaidRequest {
+    subscriptionId: string;
+    file: Blob;
+}
+
 export interface DeleteBillRequest {
     billId: string;
 }
 
 export interface GenerateSubscriptionBillsOperationRequest {
     subscriptionId: string;
-    generateSubscriptionBillsRequest?: GenerateSubscriptionBillsRequest;
+    generateSubscriptionBillsRequest: GenerateSubscriptionBillsRequest;
 }
 
 export interface GetBillByIdRequest {
@@ -51,21 +71,116 @@ export interface GetSubscriptionBillsRequest {
     subscriptionId: string;
 }
 
+export interface GetSubscriptionBillsPaginatedRequest {
+    subscriptionId: string;
+    offset?: number;
+    limit?: number;
+    periodNumber?: number;
+    paymentConfigId?: string;
+    search?: string;
+    billingYear?: number;
+    status?: string;
+}
+
+export interface GetSubscriptionBillsSummaryRequest {
+    subscriptionId: string;
+    billingYear?: number;
+}
+
 export interface LinkPaymentToBillOperationRequest {
     billId: string;
     linkPaymentToBillRequest: LinkPaymentToBillRequest;
 }
 
+export interface MarkBillAsPaidOperationRequest {
+    billId: string;
+    markBillAsPaidRequest: MarkBillAsPaidRequest;
+}
+
 export interface UpdateBillOperationRequest {
     billId: string;
     updateBillRequest?: UpdateBillRequest;
 }
 
+export interface UploadBillReceiptRequest {
+    billId: string;
+    file: Blob;
+}
+
 /**
  * 
  */
 export class AdminSubscriptionBillingApi extends runtime.BaseAPI {
 
+    /**
+     * Bulk mark bills as paid from CSV data
+     */
+    async bulkMarkBillsPaidRaw(requestParameters: BulkMarkBillsPaidRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkMarkBillsPaid200Response>> {
+        if (requestParameters['subscriptionId'] == null) {
+            throw new runtime.RequiredError(
+                'subscriptionId',
+                'Required parameter "subscriptionId" was null or undefined when calling bulkMarkBillsPaid().'
+            );
+        }
+
+        if (requestParameters['file'] == null) {
+            throw new runtime.RequiredError(
+                'file',
+                'Required parameter "file" was null or undefined when calling bulkMarkBillsPaid().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const consumes: runtime.Consume[] = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+
+        let formParams: { append(param: string, value: any): any };
+        let useForm = false;
+        // use FormData to transmit files using content-type "multipart/form-data"
+        useForm = canConsumeForm;
+        if (useForm) {
+            formParams = new FormData();
+        } else {
+            formParams = new URLSearchParams();
+        }
+
+        if (requestParameters['file'] != null) {
+            formParams.append('file', requestParameters['file'] as any);
+        }
+
+        const response = await this.request({
+            path: `/api/admin/subscriptions/{subscriptionId}/bills/bulk-mark-paid`.replace(`{${"subscriptionId"}}`, encodeURIComponent(String(requestParameters['subscriptionId']))),
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BulkMarkBillsPaid200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Bulk mark bills as paid from CSV data
+     */
+    async bulkMarkBillsPaid(requestParameters: BulkMarkBillsPaidRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkMarkBillsPaid200Response> {
+        const response = await this.bulkMarkBillsPaidRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Delete a bill
      */
@@ -118,6 +233,13 @@ export class AdminSubscriptionBillingApi extends runtime.BaseAPI {
             );
         }
 
+        if (requestParameters['generateSubscriptionBillsRequest'] == null) {
+            throw new runtime.RequiredError(
+                'generateSubscriptionBillsRequest',
+                'Required parameter "generateSubscriptionBillsRequest" was null or undefined when calling generateSubscriptionBills().'
+            );
+        }
+
         const queryParameters: any = {};
 
         const headerParameters: runtime.HTTPHeaders = {};
@@ -233,6 +355,120 @@ export class AdminSubscriptionBillingApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Get paginated bills for a subscription with filters
+     */
+    async getSubscriptionBillsPaginatedRaw(requestParameters: GetSubscriptionBillsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubscriptionBillPageDto>> {
+        if (requestParameters['subscriptionId'] == null) {
+            throw new runtime.RequiredError(
+                'subscriptionId',
+                'Required parameter "subscriptionId" was null or undefined when calling getSubscriptionBillsPaginated().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['periodNumber'] != null) {
+            queryParameters['periodNumber'] = requestParameters['periodNumber'];
+        }
+
+        if (requestParameters['paymentConfigId'] != null) {
+            queryParameters['paymentConfigId'] = requestParameters['paymentConfigId'];
+        }
+
+        if (requestParameters['search'] != null) {
+            queryParameters['search'] = requestParameters['search'];
+        }
+
+        if (requestParameters['billingYear'] != null) {
+            queryParameters['billingYear'] = requestParameters['billingYear'];
+        }
+
+        if (requestParameters['status'] != null) {
+            queryParameters['status'] = requestParameters['status'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/admin/subscriptions/{subscriptionId}/bills/paginated`.replace(`{${"subscriptionId"}}`, encodeURIComponent(String(requestParameters['subscriptionId']))),
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SubscriptionBillPageDtoFromJSON(jsonValue));
+    }
+
+    /**
+     * Get paginated bills for a subscription with filters
+     */
+    async getSubscriptionBillsPaginated(requestParameters: GetSubscriptionBillsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubscriptionBillPageDto> {
+        const response = await this.getSubscriptionBillsPaginatedRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Get aggregated billing summary for a subscription
+     */
+    async getSubscriptionBillsSummaryRaw(requestParameters: GetSubscriptionBillsSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<BillingSummaryItemDto>>> {
+        if (requestParameters['subscriptionId'] == null) {
+            throw new runtime.RequiredError(
+                'subscriptionId',
+                'Required parameter "subscriptionId" was null or undefined when calling getSubscriptionBillsSummary().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['billingYear'] != null) {
+            queryParameters['billingYear'] = requestParameters['billingYear'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/admin/subscriptions/{subscriptionId}/bills/summary`.replace(`{${"subscriptionId"}}`, encodeURIComponent(String(requestParameters['subscriptionId']))),
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(BillingSummaryItemDtoFromJSON));
+    }
+
+    /**
+     * Get aggregated billing summary for a subscription
+     */
+    async getSubscriptionBillsSummary(requestParameters: GetSubscriptionBillsSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<BillingSummaryItemDto>> {
+        const response = await this.getSubscriptionBillsSummaryRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Link a payment detail to a bill
      */
@@ -284,6 +520,57 @@ export class AdminSubscriptionBillingApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Mark a bill as paid with payment tracking info
+     */
+    async markBillAsPaidRaw(requestParameters: MarkBillAsPaidOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubscriptionBill>> {
+        if (requestParameters['billId'] == null) {
+            throw new runtime.RequiredError(
+                'billId',
+                'Required parameter "billId" was null or undefined when calling markBillAsPaid().'
+            );
+        }
+
+        if (requestParameters['markBillAsPaidRequest'] == null) {
+            throw new runtime.RequiredError(
+                'markBillAsPaidRequest',
+                'Required parameter "markBillAsPaidRequest" was null or undefined when calling markBillAsPaid().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/admin/bills/{billId}/mark-paid`.replace(`{${"billId"}}`, encodeURIComponent(String(requestParameters['billId']))),
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: MarkBillAsPaidRequestToJSON(requestParameters['markBillAsPaidRequest']),
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SubscriptionBillFromJSON(jsonValue));
+    }
+
+    /**
+     * Mark a bill as paid with payment tracking info
+     */
+    async markBillAsPaid(requestParameters: MarkBillAsPaidOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubscriptionBill> {
+        const response = await this.markBillAsPaidRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Update a bill
      */
@@ -328,4 +615,73 @@ export class AdminSubscriptionBillingApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Upload a receipt attachment for a bill
+     */
+    async uploadBillReceiptRaw(requestParameters: UploadBillReceiptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<UploadBillReceipt200Response>> {
+        if (requestParameters['billId'] == null) {
+            throw new runtime.RequiredError(
+                'billId',
+                'Required parameter "billId" was null or undefined when calling uploadBillReceipt().'
+            );
+        }
+
+        if (requestParameters['file'] == null) {
+            throw new runtime.RequiredError(
+                'file',
+                'Required parameter "file" was null or undefined when calling uploadBillReceipt().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const consumes: runtime.Consume[] = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+
+        let formParams: { append(param: string, value: any): any };
+        let useForm = false;
+        // use FormData to transmit files using content-type "multipart/form-data"
+        useForm = canConsumeForm;
+        if (useForm) {
+            formParams = new FormData();
+        } else {
+            formParams = new URLSearchParams();
+        }
+
+        if (requestParameters['file'] != null) {
+            formParams.append('file', requestParameters['file'] as any);
+        }
+
+        const response = await this.request({
+            path: `/api/admin/bills/{billId}/upload-receipt`.replace(`{${"billId"}}`, encodeURIComponent(String(requestParameters['billId']))),
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => UploadBillReceipt200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Upload a receipt attachment for a bill
+     */
+    async uploadBillReceipt(requestParameters: UploadBillReceiptRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<UploadBillReceipt200Response> {
+        const response = await this.uploadBillReceiptRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
 }