@thorprovider/medusa-extended 1.2.3 → 1.3.0

package/src/dropshipper.ts

@@ -106,6 +106,35 @@ import type {
   GetDashboardStatsResponse,
   // Storefront (V)
   GetStorefrontDropshipperCategoriesResponse,
+  // Financial Endpoints — Group A
+  GetDropshipperAccountBalanceResponse,
+  GetDropshipperAccountOrdersOptions,
+  GetDropshipperAccountOrdersResponse,
+  GetAdminDropshipperAccountOrdersResponse,
+  GetAdminDropshipperAccountSettlementsOptions,
+  GetAdminDropshipperAccountSettlementsResponse,
+  ResolveGuaranteeBody,
+  ResolveGuaranteeResponse,
+  CreateCompensacionBody,
+  CreateCompensacionResponse,
+  CreateAjusteBody,
+  CreateAjusteResponse,
+  // Financial Endpoints — Group B
+  CreateCobroBody,
+  CreateCobroResponse,
+  CreatePagoBody,
+  CreatePagoResponse,
+  CreateReversoBody,
+  CreateReversoResponse,
+  ConfirmMovementBody,
+  ConfirmMovementResponse,
+  CancelMovementBody,
+  CancelMovementResponse,
+  GetFinancialAnalysisResponse,
+  RegisterPaymentBody,
+  RegisterPaymentResponse,
+  // Dashboard Capabilities
+  DropshipperDashboardCapabilities,
   // Inline return types
   DropshipperCategory,
   DropshipperPromotion,
@@ -220,6 +249,22 @@ export class DropshipperClient {
     return response.json() as Promise<T>;
   }
 
+  // -------------------------------------------------------------------------
+  // Capabilities
+  // -------------------------------------------------------------------------
+
+  /**
+   * Fetch dashboard capabilities from the backend.
+   *
+   * `GET /admin/thor/dropshipper/capabilities`
+   */
+  async getCapabilities(): Promise<DropshipperDashboardCapabilities> {
+    return this.request<DropshipperDashboardCapabilities>(
+      'GET',
+      '/admin/thor/dropshipper/capabilities',
+    );
+  }
+
   // -------------------------------------------------------------------------
   // Onboarding (Solo X)
   // -------------------------------------------------------------------------
@@ -422,6 +467,8 @@ export class DropshipperClient {
     const qs = new URLSearchParams({
       currency_code: params.currency_code.toLowerCase(),
       ...(params.country_code ? { country_code: params.country_code.toLowerCase() } : {}),
+      ...(params.province ? { province: params.province } : {}),
+      ...(params.city ? { city: params.city } : {}),
     });
 
     return this.request<GetDropshipperShippingOptionsResponse>(
@@ -636,8 +683,6 @@ export class DropshipperClient {
   /**
    * Delete a custom category.
    *
-   * Pass `{ force: true }` to cascade-delete child categories.
-   *
    * `DELETE /admin/thor/dropshipper/categories/:id`
    */
   async deleteCategory(
@@ -676,7 +721,7 @@ export class DropshipperClient {
   ): Promise<CreateCategoryMappingResponse> {
     return this.request<CreateCategoryMappingResponse>(
       'POST',
-      '/admin/thor/dropshipper/category-mappings',
+      `/admin/thor/dropshipper/category-mappings`,
       body,
     );
   }
@@ -893,19 +938,53 @@ export class DropshipperClient {
     *
     * `GET /admin/thor/dropshipper/settlements/:id`
     */
-   async getSettlement(
-     settlementId: string,
-   ): Promise<GetSettlementDetailResponse> {
-     return this.request<GetSettlementDetailResponse>(
+    async getSettlement(
+      settlementId: string,
+    ): Promise<GetSettlementDetailResponse> {
+      return this.request<GetSettlementDetailResponse>(
+        'GET',
+        `/admin/thor/dropshipper/settlements/${settlementId}`,
+
+     );
+   }
+
+   /**
+    * Consolidated financial balance for the authenticated dropshipper.
+    *
+    * `GET /admin/thor/dropshipper/account/balance`
+    */
+   async getAccountBalance(): Promise<GetDropshipperAccountBalanceResponse> {
+     return this.request<GetDropshipperAccountBalanceResponse>(
        'GET',
-       `/admin/thor/dropshipper/settlements/${settlementId}`,
+       '/admin/thor/dropshipper/account/balance',
+     );
+   }
 
-    );
-  }
+   /**
+    * Unified financial order list for the authenticated dropshipper.
+    *
+    * `GET /admin/thor/dropshipper/account/orders`
+    */
+   async getAccountOrders(
+     options: GetDropshipperAccountOrdersOptions = {},
+   ): Promise<GetDropshipperAccountOrdersResponse> {
+     const { tab, status, limit = 20, offset = 0, q } = options;
+     const qs = new URLSearchParams({
+       limit: String(limit),
+       offset: String(offset),
+       ...(tab ? { tab } : {}),
+       ...(status ? { status } : {}),
+       ...(q ? { q } : {}),
+     });
+     return this.request<GetDropshipperAccountOrdersResponse>(
+       'GET',
+       `/admin/thor/dropshipper/account/orders?${qs}`,
+     );
+   }
 
-  // -------------------------------------------------------------------------
-  // Admin Settlements (Solo X)
-  // -------------------------------------------------------------------------
+   // -------------------------------------------------------------------------
+   // Admin Settlements (Solo X)
+   // -------------------------------------------------------------------------
 
   /**
    * Create a settlement record for a dropshipper account.
@@ -1034,6 +1113,221 @@ export class DropshipperClient {
     );
   }
 
+  // -------------------------------------------------------------------------
+  // Financial Endpoints — Group A (Admin X)
+  // -------------------------------------------------------------------------
+
+  /**
+   * List orders with financial detail for a dropshipper account (Admin only).
+   *
+   * `GET /admin/thor/dropshipper/admin/accounts/:id/orders`
+   */
+  async getAdminAccountOrders(
+    accountId: string,
+    options: GetDropshipperAccountOrdersOptions = {},
+  ): Promise<GetAdminDropshipperAccountOrdersResponse> {
+    const { tab, status, limit = 20, offset = 0, q } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      ...(tab ? { tab } : {}),
+      ...(status ? { status } : {}),
+      ...(q ? { q } : {}),
+    });
+    return this.request<GetAdminDropshipperAccountOrdersResponse>(
+      'GET',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/orders?${qs}`,
+    );
+  }
+
+  /**
+   * List financial movements for a dropshipper account (Admin only).
+   *
+   * `GET /admin/thor/dropshipper/admin/accounts/:id/settlements`
+   */
+  async getAdminAccountSettlements(
+    accountId: string,
+    options: GetAdminDropshipperAccountSettlementsOptions = {},
+  ): Promise<GetAdminDropshipperAccountSettlementsResponse> {
+    const { type, status, limit = 20, offset = 0 } = options;
+    const qs = new URLSearchParams({
+      limit: String(limit),
+      offset: String(offset),
+      ...(type ? { type } : {}),
+      ...(status ? { status } : {}),
+    });
+    return this.request<GetAdminDropshipperAccountSettlementsResponse>(
+      'GET',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/settlements?${qs}`,
+    );
+  }
+
+  /**
+   * Manually resolve a guarantee on an order (Admin only).
+   *
+   * `POST /admin/thor/dropshipper/admin/accounts/:id/guarantee/:order_id`
+   */
+  async resolveGuarantee(
+    accountId: string,
+    orderId: string,
+    body: ResolveGuaranteeBody,
+  ): Promise<ResolveGuaranteeResponse> {
+    return this.request<ResolveGuaranteeResponse>(
+      'POST',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/guarantee/${orderId}`,
+      body,
+    );
+  }
+
+  /**
+   * Create an internal compensation (netting) between DS and Thor debts (Admin only).
+   *
+   * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/compensacion`
+   */
+  async createCompensacion(
+    accountId: string,
+    body: CreateCompensacionBody,
+  ): Promise<CreateCompensacionResponse> {
+    return this.request<CreateCompensacionResponse>(
+      'POST',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/settlements/compensacion`,
+      body,
+    );
+  }
+
+  /**
+   * Create a financial adjustment (Admin only).
+   *
+   * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/ajuste`
+   */
+  async createAjuste(
+    accountId: string,
+    body: CreateAjusteBody,
+  ): Promise<CreateAjusteResponse> {
+    return this.request<CreateAjusteResponse>(
+      'POST',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/settlements/ajuste`,
+      body,
+    );
+  }
+
+  // -------------------------------------------------------------------------
+  // Financial Endpoints — Group B (Admin X)
+  // -------------------------------------------------------------------------
+
+  /**
+   * Register a cobro — DS pays Thor the product cost (Admin only).
+   *
+   * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/cobro`
+   */
+  async createCobro(
+    accountId: string,
+    body: CreateCobroBody,
+  ): Promise<CreateCobroResponse> {
+    return this.request<CreateCobroResponse>(
+      'POST',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/settlements/cobro`,
+      body,
+    );
+  }
+
+  /**
+   * Register a pago — Thor pays the dropshipper their commission (Admin only).
+   *
+   * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/pago`
+   */
+  async createPago(
+    accountId: string,
+    body: CreatePagoBody,
+  ): Promise<CreatePagoResponse> {
+    return this.request<CreatePagoResponse>(
+      'POST',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/settlements/pago`,
+      body,
+    );
+  }
+
+  /**
+   * Reverse a confirmed financial movement (Admin only).
+   *
+   * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/:mov_id/reverso`
+   */
+  async reverseSettlement(
+    accountId: string,
+    movementId: string,
+    body: CreateReversoBody,
+  ): Promise<CreateReversoResponse> {
+    return this.request<CreateReversoResponse>(
+      'POST',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/settlements/${movementId}/reverso`,
+      body,
+    );
+  }
+
+  /**
+   * Confirm a pending financial movement (Admin only).
+   *
+   * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/:mov_id/confirm`
+   */
+  async confirmSettlementMovement(
+    accountId: string,
+    movementId: string,
+    body: ConfirmMovementBody = {},
+  ): Promise<ConfirmMovementResponse> {
+    return this.request<ConfirmMovementResponse>(
+      'POST',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/settlements/${movementId}/confirm`,
+      body,
+    );
+  }
+
+  /**
+   * Cancel a pending financial movement draft (Admin only).
+   *
+   * `POST /admin/thor/dropshipper/admin/accounts/:id/settlements/:mov_id/cancel`
+   */
+  async cancelSettlementMovement(
+    accountId: string,
+    movementId: string,
+    body: CancelMovementBody,
+  ): Promise<CancelMovementResponse> {
+    return this.request<CancelMovementResponse>(
+      'POST',
+      `/admin/thor/dropshipper/admin/accounts/${accountId}/settlements/${movementId}/cancel`,
+      body,
+    );
+  }
+
+  /**
+   * Get financial analysis for a dropshipper order (Admin only).
+   *
+   * `GET /admin/thor/dropshipper/admin/orders/:id/financial-analysis`
+   */
+  async getOrderFinancialAnalysis(
+    orderId: string,
+  ): Promise<GetFinancialAnalysisResponse> {
+    return this.request<GetFinancialAnalysisResponse>(
+      'GET',
+      `/admin/thor/dropshipper/admin/orders/${orderId}/financial-analysis`,
+    );
+  }
+
+  /**
+   * Register a partial or full payment for an order.
+   *
+   * `POST /admin/thor/dropshipper/orders/:id/payment`
+   */
+  async registerOrderPayment(
+    orderId: string,
+    body: RegisterPaymentBody,
+  ): Promise<RegisterPaymentResponse> {
+    return this.request<RegisterPaymentResponse>(
+      'POST',
+      `/admin/thor/dropshipper/orders/${orderId}/payment`,
+      body,
+    );
+  }
+
   // -------------------------------------------------------------------------
   // Promotions (Solo Y)
   // -------------------------------------------------------------------------