Implemented missing DTOs related to Finance services.

Author: basicondoadmin

src/Asaas.Sdk.csproj

@@ -19,7 +19,7 @@
 		<GenerateDocumentationFile>true</GenerateDocumentationFile>
 		<NoWarn>CS1591;CS1584</NoWarn>
 		<PackageReleaseNotes>
-			* 1.0.8 - Implemented missing DTOs related to Transfer services.
+			* 1.0.8 - Implemented missing DTOs related to Transfer and Finance services.
 			* 1.0.7 - Implemented missing DTOs related to Webhook services.
 			* 1.0.6 - Refactored Subaccount service to use newly created DTOs.
 			* 1.0.5 - Implemented missing DTOs related to Account services.

src/Models/FinanceBalanceResponseDto.cs

@@ -0,0 +1,15 @@
+using System.Text.Json.Serialization;
+
+namespace Asaas.Sdk.Models;
+
+/// <summary>
+/// Finance balance response
+/// </summary>
+public class FinanceBalanceResponseDto
+{
+    /// <summary>
+    /// Account balance
+    /// </summary>
+    [JsonPropertyName("balance")]
+    public double? Balance { get; set; }
+}

src/Models/FinanceGetPaymentStatisticsResponseDto.cs

@@ -0,0 +1,27 @@
+using System.Text.Json.Serialization;
+
+namespace Asaas.Sdk.Models;
+
+/// <summary>
+/// Finance payment statistics response
+/// </summary>
+public class FinanceGetPaymentStatisticsResponseDto
+{
+    /// <summary>
+    /// Number of charges
+    /// </summary>
+    [JsonPropertyName("quantity")]
+    public long? Quantity { get; set; }
+
+    /// <summary>
+    /// Amount
+    /// </summary>
+    [JsonPropertyName("value")]
+    public double? Value { get; set; }
+
+    /// <summary>
+    /// Total net worth
+    /// </summary>
+    [JsonPropertyName("netValue")]
+    public double? NetValue { get; set; }
+}

src/Models/FinanceGetSplitStatisticsResponseDto.cs

@@ -0,0 +1,21 @@
+using System.Text.Json.Serialization;
+
+namespace Asaas.Sdk.Models;
+
+/// <summary>
+/// Finance split statistics response
+/// </summary>
+public class FinanceGetSplitStatisticsResponseDto
+{
+    /// <summary>
+    /// Amounts receivable
+    /// </summary>
+    [JsonPropertyName("income")]
+    public double? Income { get; set; }
+
+    /// <summary>
+    /// Values to be sent
+    /// </summary>
+    [JsonPropertyName("value")]
+    public double? Value { get; set; }
+}

src/Models/FinancialTransactionGetResponseDto.cs

@@ -0,0 +1,99 @@
+using System.Text.Json.Serialization;
+
+namespace Asaas.Sdk.Models;
+
+/// <summary>
+/// Financial transaction response
+/// </summary>
+public class FinancialTransactionGetResponseDto
+{
+    /// <summary>
+    /// Object type
+    /// </summary>
+    [JsonPropertyName("object")]
+    public string? Object { get; set; }
+
+    /// <summary>
+    /// Unique transaction identifier in Asaas
+    /// </summary>
+    [JsonPropertyName("id")]
+    public string? Id { get; set; }
+
+    /// <summary>
+    /// Transaction value
+    /// </summary>
+    [JsonPropertyName("value")]
+    public double? Value { get; set; }
+
+    /// <summary>
+    /// Value in account at the time of the transaction
+    /// </summary>
+    [JsonPropertyName("balance")]
+    public double? Balance { get; set; }
+
+    /// <summary>
+    /// Transaction type (PAYMENT, PAYMENT_FEE, TRANSFER, TRANSFER_FEE, etc.)
+    /// </summary>
+    [JsonPropertyName("type")]
+    public string? Type { get; set; }
+
+    /// <summary>
+    /// Transaction date
+    /// </summary>
+    [JsonPropertyName("date")]
+    public string? Date { get; set; }
+
+    /// <summary>
+    /// Transaction description
+    /// </summary>
+    [JsonPropertyName("description")]
+    public string? Description { get; set; }
+
+    /// <summary>
+    /// Payment identifier (if any)
+    /// </summary>
+    [JsonPropertyName("paymentId")]
+    public string? PaymentId { get; set; }
+
+    /// <summary>
+    /// Split identifier (if any)
+    /// </summary>
+    [JsonPropertyName("splitId")]
+    public string? SplitId { get; set; }
+
+    /// <summary>
+    /// Transfer identifier (if any)
+    /// </summary>
+    [JsonPropertyName("transferId")]
+    public string? TransferId { get; set; }
+
+    /// <summary>
+    /// Anticipation identifier (if any)
+    /// </summary>
+    [JsonPropertyName("anticipationId")]
+    public string? AnticipationId { get; set; }
+
+    /// <summary>
+    /// Bill payment identifier (if any)
+    /// </summary>
+    [JsonPropertyName("billId")]
+    public string? BillId { get; set; }
+
+    /// <summary>
+    /// Invoice identifier (if any)
+    /// </summary>
+    [JsonPropertyName("invoiceId")]
+    public string? InvoiceId { get; set; }
+
+    /// <summary>
+    /// Payment dunning identifier (if any)
+    /// </summary>
+    [JsonPropertyName("paymentDunningId")]
+    public string? PaymentDunningId { get; set; }
+
+    /// <summary>
+    /// Serasa consultation identifier (if any)
+    /// </summary>
+    [JsonPropertyName("creditBureauReportId")]
+    public string? CreditBureauReportId { get; set; }
+}

src/Models/FinancialTransactionListResponseDto.cs

@@ -0,0 +1,8 @@
+namespace Asaas.Sdk.Models;
+
+/// <summary>
+/// Financial transaction list response
+/// </summary>
+public class FinancialTransactionListResponseDto : ListResponseDto<FinancialTransactionGetResponseDto>
+{
+}

src/Services/FinanceService.cs

@@ -1,5 +1,6 @@
 using Asaas.Sdk.Config;
 using Asaas.Sdk.Http;
+using Asaas.Sdk.Models;
 
 namespace Asaas.Sdk.Services;
 
@@ -8,52 +9,65 @@ namespace Asaas.Sdk.Services;
 /// </summary>
 public class FinanceService : BaseService
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="FinanceService"/> class.
+    /// </summary>
+    /// <param name="httpClient">HTTP client instance</param>
+    /// <param name="config">SDK configuration</param>
     public FinanceService(HttpClient httpClient, AsaasSdkConfig config) 
         : base(httpClient, config)
     {
     }
 
     /// <summary>
-    /// Get balance
+    /// Get account balance
     /// </summary>
-    public async Task<dynamic> GetBalanceAsync(
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Current account balance</returns>
+    public async Task<FinanceBalanceResponseDto> GetBalanceAsync(
         CancellationToken cancellationToken = default)
     {
         var requestBuilder = new RequestBuilder(HttpMethod.Get, "v3/finance/balance");
         var request = requestBuilder.Build(GetBaseUrl());
-        return await ExecuteAsync<dynamic>(request);
+        return await ExecuteAsync<FinanceBalanceResponseDto>(request);
     }
 
     /// <summary>
-    /// Get current balance
+    /// Get current account balance
     /// </summary>
-    public async Task<dynamic> GetCurrentBalanceAsync(
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Current account balance</returns>
+    public async Task<FinanceBalanceResponseDto> GetCurrentBalanceAsync(
         CancellationToken cancellationToken = default)
     {
         var requestBuilder = new RequestBuilder(HttpMethod.Get, "v3/finance/getCurrentBalance");
         var request = requestBuilder.Build(GetBaseUrl());
-        return await ExecuteAsync<dynamic>(request);
+        return await ExecuteAsync<FinanceBalanceResponseDto>(request);
     }
 
     /// <summary>
-    /// Get statistics
+    /// Get payment statistics
     /// </summary>
-    public async Task<dynamic> GetStatisticsAsync(
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Payment statistics including quantity, value, and net value</returns>
+    public async Task<FinanceGetPaymentStatisticsResponseDto> GetStatisticsAsync(
         CancellationToken cancellationToken = default)
     {
         var requestBuilder = new RequestBuilder(HttpMethod.Get, "v3/finance/payment/statistics");
         var request = requestBuilder.Build(GetBaseUrl());
-        return await ExecuteAsync<dynamic>(request);
+        return await ExecuteAsync<FinanceGetPaymentStatisticsResponseDto>(request);
     }
 
     /// <summary>
     /// Get split statistics
     /// </summary>
-    public async Task<dynamic> GetSplitStatisticsAsync(
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Split statistics including income and values to be sent</returns>
+    public async Task<FinanceGetSplitStatisticsResponseDto> GetSplitStatisticsAsync(
         CancellationToken cancellationToken = default)
     {
         var requestBuilder = new RequestBuilder(HttpMethod.Get, "v3/finance/split/statistics");
         var request = requestBuilder.Build(GetBaseUrl());
-        return await ExecuteAsync<dynamic>(request);
+        return await ExecuteAsync<FinanceGetSplitStatisticsResponseDto>(request);
     }
 }

src/Services/FinancialTransactionService.cs

@@ -1,5 +1,7 @@
 using Asaas.Sdk.Config;
+using Asaas.Sdk.Exceptions;
 using Asaas.Sdk.Http;
+using Asaas.Sdk.Models;
 
 namespace Asaas.Sdk.Services;
 
@@ -8,15 +10,26 @@ namespace Asaas.Sdk.Services;
 /// </summary>
 public class FinancialTransactionService : BaseService
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="FinancialTransactionService"/> class.
+    /// </summary>
+    /// <param name="httpClient">HTTP client instance</param>
+    /// <param name="config">SDK configuration</param>
     public FinancialTransactionService(HttpClient httpClient, AsaasSdkConfig config) 
         : base(httpClient, config)
     {
     }
 
     /// <summary>
-    /// List financial transactions
+    /// List financial transactions with optional filters
     /// </summary>
-    public async Task<dynamic> ListFinancialTransactionsAsync(
+    /// <param name="startDate">Start date for filtering transactions</param>
+    /// <param name="endDate">End date for filtering transactions</param>
+    /// <param name="offset">Offset for pagination</param>
+    /// <param name="limit">Limit for pagination</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>List of financial transactions</returns>
+    public async Task<FinancialTransactionListResponseDto> ListFinancialTransactionsAsync(
         DateTime? startDate = null,
         DateTime? endDate = null,
         long? offset = null,
@@ -30,46 +43,70 @@ public async Task<dynamic> ListFinancialTransactionsAsync(
             .AddQueryParam("limit", limit);
 
         var request = requestBuilder.Build(GetBaseUrl());
-        return await ExecuteAsync<dynamic>(request);
+        return await ExecuteAsync<FinancialTransactionListResponseDto>(request);
     }
 
     /// <summary>
     /// Get financial transaction by ID
     /// </summary>
-    public async Task<dynamic> GetFinancialTransactionAsync(
+    /// <param name="id">Financial transaction identifier</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Financial transaction details</returns>
+    public async Task<FinancialTransactionGetResponseDto> GetFinancialTransactionAsync(
         string id,
         CancellationToken cancellationToken = default)
     {
+        if (string.IsNullOrEmpty(id))
+        {
+            throw new ValidationException("Financial transaction ID is required");
+        }
+
         var requestBuilder = new RequestBuilder(HttpMethod.Get, $"v3/financialTransactions/{id}");
         var request = requestBuilder.Build(GetBaseUrl());
-        return await ExecuteAsync<dynamic>(request);
+        return await ExecuteAsync<FinancialTransactionGetResponseDto>(request);
     }
 
     /// <summary>
-    /// Get payment anticipation financial transaction
+    /// Get financial transactions related to a payment anticipation
     /// </summary>
-    public async Task<dynamic> GetPaymentAnticipationFinancialTransactionAsync(
+    /// <param name="anticipationId">Anticipation identifier</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>List of financial transactions related to the anticipation</returns>
+    public async Task<FinancialTransactionListResponseDto> GetPaymentAnticipationFinancialTransactionAsync(
         string anticipationId,
         CancellationToken cancellationToken = default)
     {
+        if (string.IsNullOrEmpty(anticipationId))
+        {
+            throw new ValidationException("Anticipation ID is required");
+        }
+
         var requestBuilder = new RequestBuilder(HttpMethod.Get, "v3/financialTransactions")
             .AddQueryParam("anticipation", anticipationId);
 
         var request = requestBuilder.Build(GetBaseUrl());
-        return await ExecuteAsync<dynamic>(request);
+        return await ExecuteAsync<FinancialTransactionListResponseDto>(request);
     }
 
     /// <summary>
-    /// Get payment financial transaction
+    /// Get financial transactions related to a payment
     /// </summary>
-    public async Task<dynamic> GetPaymentFinancialTransactionAsync(
+    /// <param name="paymentId">Payment identifier</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>List of financial transactions related to the payment</returns>
+    public async Task<FinancialTransactionListResponseDto> GetPaymentFinancialTransactionAsync(
         string paymentId,
         CancellationToken cancellationToken = default)
     {
+        if (string.IsNullOrEmpty(paymentId))
+        {
+            throw new ValidationException("Payment ID is required");
+        }
+
         var requestBuilder = new RequestBuilder(HttpMethod.Get, "v3/financialTransactions")
             .AddQueryParam("payment", paymentId);
 
         var request = requestBuilder.Build(GetBaseUrl());
-        return await ExecuteAsync<dynamic>(request);
+        return await ExecuteAsync<FinancialTransactionListResponseDto>(request);
     }
 }