peddler 5.3.0 → 5.4.0

data/lib/peddler/apis/reports_2021_06_30/create_report_specification.rb

@@ -12,11 +12,11 @@ module Peddler
       CreateReportSpecification = Structure.new do
         # @return [Array<String>] A list of marketplace identifiers. The report document's contents will contain data
         #   for all of the specified marketplaces, unless the report type indicates otherwise.
-        attribute(:marketplace_ids, [String], from: "marketplaceIds")
+        attribute(:marketplace_ids, [String], null: false, from: "marketplaceIds")
 
         # @return [String] The report type. Refer to [Report Type
         #   Values](https://developer-docs.amazon.com/sp-api/docs/report-type-values) for more information.
-        attribute(:report_type, String, from: "reportType")
+        attribute(:report_type, String, null: false, from: "reportType")
 
         # @return [Time] The end of a date and time range, in {https://developer-docs.amazon.com/sp-api/docs/iso-8601
         #   ISO 8601} date time format, used for selecting the data to report. The default is now. The value must be

data/lib/peddler/apis/reports_2021_06_30/error.rb

@@ -10,10 +10,10 @@ module Peddler
       # Error response returned when the request is unsuccessful.
       Error = Structure.new do
         # @return [String] An error code that identifies the type of error that occurred.
-        attribute(:code, String)
+        attribute(:code, String, null: false)
 
         # @return [String] A message that describes the error condition.
-        attribute(:message, String)
+        attribute(:message, String, null: false)
 
         # @return [String] Additional details that can help the caller understand or fix the issue.
         attribute?(:details, String)

data/lib/peddler/apis/reports_2021_06_30/error_list.rb

@@ -10,7 +10,7 @@ module Peddler
       # A list of error responses returned when a request is unsuccessful.
       ErrorList = Structure.new do
         # @return [Array<Error>] Error response returned when the request is unsuccessful.
-        attribute(:errors, [Error])
+        attribute(:errors, [Error], null: false)
       end
     end
   end

data/lib/peddler/apis/reports_2021_06_30/get_reports_response.rb

@@ -10,7 +10,7 @@ module Peddler
       # The response for the `getReports` operation.
       GetReportsResponse = Structure.new do
         # @return [Array<Report>] The reports.
-        attribute(:reports, [Report])
+        attribute(:reports, [Report], null: false)
 
         # @return [String] Returned when the number of results exceeds `pageSize`. To get the next page of results, call
         #   `getReports` with this token as the only parameter.

data/lib/peddler/apis/reports_2021_06_30/report.rb

@@ -11,18 +11,18 @@ module Peddler
       # Detailed information about the report.
       Report = Structure.new do
         # @return [Time] The date and time when the report was created.
-        attribute(:created_time, Time, from: "createdTime")
+        attribute(:created_time, Time, null: false, from: "createdTime")
 
         # @return [String] The processing status of the report.
-        attribute(:processing_status, String, from: "processingStatus")
+        attribute(:processing_status, String, null: false, from: "processingStatus")
 
         # @return [String] The identifier for the report. This identifier is unique only in combination with a seller
         #   ID.
-        attribute(:report_id, String, from: "reportId")
+        attribute(:report_id, String, null: false, from: "reportId")
 
         # @return [String] The report type. Refer to [Report Type
         #   Values](https://developer-docs.amazon.com/sp-api/docs/report-type-values) for more information.
-        attribute(:report_type, String, from: "reportType")
+        attribute(:report_type, String, null: false, from: "reportType")
 
         # @return [Time] The end of a date and time range used for selecting the data to report.
         attribute?(:data_end_time, Time, from: "dataEndTime")

data/lib/peddler/apis/reports_2021_06_30/report_document.rb

@@ -11,11 +11,11 @@ module Peddler
       ReportDocument = Structure.new do
         # @return [String] The identifier for the report document. This identifier is unique only in combination with a
         #   seller ID.
-        attribute(:report_document_id, String, from: "reportDocumentId")
+        attribute(:report_document_id, String, null: false, from: "reportDocumentId")
 
         # @return [String] A presigned URL for the report document. If `compressionAlgorithm` is not returned, you can
         #   download the report directly from this URL. This URL expires after 5 minutes.
-        attribute(:url, String)
+        attribute(:url, String, null: false)
 
         # @return [String] If the report document contents have been compressed, the compression algorithm used is
         #   returned in this property and you must decompress the report when you download. Otherwise, you can download

data/lib/peddler/apis/reports_2021_06_30/report_schedule.rb

@@ -12,15 +12,15 @@ module Peddler
       ReportSchedule = Structure.new do
         # @return [String] An {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} period value that
         #   indicates how often a report should be created.
-        attribute(:period, String)
+        attribute(:period, String, null: false)
 
         # @return [String] The identifier for the report schedule. This identifier is unique only in combination with a
         #   seller ID.
-        attribute(:report_schedule_id, String, from: "reportScheduleId")
+        attribute(:report_schedule_id, String, null: false, from: "reportScheduleId")
 
         # @return [String] The report type. Refer to [Report Type
         #   Values](https://developer-docs.amazon.com/sp-api/docs/report-type-values) for more information.
-        attribute(:report_type, String, from: "reportType")
+        attribute(:report_type, String, null: false, from: "reportType")
 
         # @return [Array<String>] A list of marketplace identifiers. The report document's contents will contain data
         #   for all of the specified marketplaces, unless the report type indicates otherwise.

data/lib/peddler/apis/reports_2021_06_30/report_schedule_list.rb

@@ -10,7 +10,7 @@ module Peddler
       # A list of report schedules.
       ReportScheduleList = Structure.new do
         # @return [Array<ReportSchedule>] Detailed information about a report schedule.
-        attribute(:report_schedules, [ReportSchedule], from: "reportSchedules")
+        attribute(:report_schedules, [ReportSchedule], null: false, from: "reportSchedules")
       end
     end
   end

data/lib/peddler/apis/reports_2021_06_30.rb

@@ -147,12 +147,18 @@ module Peddler
       #
       # @note This operation can make a static sandbox call.
       # @param report_document_id [String] The identifier for the report document.
+      # @param enable_content_encoding_url_header [Boolean] When `true`, the Content-Encoding header on the returned URL
+      #   is set to `gzip` instead of the default `identity` when `compressionAlgorithm` is `GZIP`. This allows
+      #   automatic decompression by HTTP clients.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
-      def get_report_document(report_document_id, rate_limit: 0.0167)
+      def get_report_document(report_document_id, enable_content_encoding_url_header: nil, rate_limit: 0.0167)
         path = "/reports/2021-06-30/documents/#{percent_encode(report_document_id)}"
+        params = {
+          "enableContentEncodingUrlHeader" => enable_content_encoding_url_header,
+        }.compact
         parser = -> { ReportDocument }
-        get(path, rate_limit:, parser:)
+        get(path, params:, rate_limit:, parser:)
       end
     end
   end

data/lib/peddler/apis/sales_v1/error.rb

@@ -10,10 +10,10 @@ module Peddler
       # Error response returned when the request is unsuccessful.
       Error = Structure.new do
         # @return [String] An error code that identifies the type of error that occured.
-        attribute(:code, String)
+        attribute(:code, String, null: false)
 
         # @return [String] A message that describes the error condition in a human-readable form.
-        attribute(:message, String)
+        attribute(:message, String, null: false)
 
         # @return [String] Additional details that can help the caller understand or fix the issue.
         attribute?(:details, String)

data/lib/peddler/apis/sales_v1/order_metrics_interval.rb

@@ -10,25 +10,25 @@ module Peddler
       # Contains order metrics.
       OrderMetricsInterval = Structure.new do
         # @return [Money] The average price for an item based on the specified filters. Formula is totalSales/unitCount.
-        attribute(:average_unit_price, Money, from: "averageUnitPrice")
+        attribute(:average_unit_price, Money, null: false, from: "averageUnitPrice")
 
         # @return [String] The interval of time based on requested granularity (ex. Hour, Day, etc.) If this is the
         #   first or the last interval from the list, it might contain incomplete data if the requested interval doesn't
         #   align with the requested granularity (ex. request interval 2018-09-01T02:00:00Z--2018-09-04T19:00:00Z and
         #   granularity day will result in Sept 1st UTC day and Sept 4th UTC days having partial data).
-        attribute(:interval, String)
+        attribute(:interval, String, null: false)
 
         # @return [Integer] The number of orders based on the specified filters.
-        attribute(:order_count, Integer, from: "orderCount")
+        attribute(:order_count, Integer, null: false, from: "orderCount")
 
         # @return [Integer] The number of order items based on the specified filters.
-        attribute(:order_item_count, Integer, from: "orderItemCount")
+        attribute(:order_item_count, Integer, null: false, from: "orderItemCount")
 
         # @return [Money] The total ordered product sales for all orders based on the specified filters.
-        attribute(:total_sales, Money, from: "totalSales")
+        attribute(:total_sales, Money, null: false, from: "totalSales")
 
         # @return [Integer] The number of units in orders based on the specified filters.
-        attribute(:unit_count, Integer, from: "unitCount")
+        attribute(:unit_count, Integer, null: false, from: "unitCount")
       end
     end
   end

data/lib/peddler/apis/seller_wallet_2024_03_01/balance.rb

@@ -8,21 +8,21 @@ require "time"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Specifies the balance amount in the Amazon SW bank account
+      # The balance amount in the Amazon Seller Wallet bank account.
       Balance = Structure.new do
-        # @return [String] The unique identifier provided by Amazon to identify the account
-        attribute(:account_id, String, from: "accountId")
+        # @return [String] The unique identifier provided by Amazon to identify the account.
+        attribute(:account_id, String, null: false, from: "accountId")
 
-        # @return [Float] The balance amount in number format
-        attribute(:balance_amount, Float, from: "balanceAmount")
+        # @return [Float] The balance amount in number format.
+        attribute(:balance_amount, Float, null: false, from: "balanceAmount")
 
-        # @return [String] The Amazon SW bank account currency code in ISO 4217 format
-        attribute(:balance_currency, String, from: "balanceCurrency")
+        # @return [String] The Amazon Seller Wallet bank account currency code in ISO 4217 format.
+        attribute(:balance_currency, String, null: false, from: "balanceCurrency")
 
-        # @return [Time] The last update date on the account balance
-        attribute(:last_update_date, Time, from: "lastUpdateDate")
+        # @return [Time] The date of the most recent account balance update.
+        attribute(:last_update_date, Time, null: false, from: "lastUpdateDate")
 
-        # @return [String] Type of the balance
+        # @return [String] The type of balance.
         attribute?(:balance_type, String, from: "balanceType")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/balance_listing.rb

@@ -7,9 +7,9 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Struct that holds list of balances on the seller account.
+      # A list of balances in the seller account.
       BalanceListing = Structure.new do
-        # @return [Array<Balance>] Collection that holds list of balances on the account
+        # @return [Array<Balance>] A list of balances in the seller account.
         attribute?(:balances, [Balance])
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/bank_account.rb

@@ -10,19 +10,19 @@ module Peddler
       # Details of an Amazon Seller Wallet bank account. This account is used to hold the money that a Seller Wallet
       # customer earns by selling items.
       BankAccount = Structure.new do
-        # @return [String] The two digit country code, in ISO 3166 format.
-        attribute(:account_country_code, String, from: "accountCountryCode")
+        # @return [String] The two-digit country code in ISO 3166 format.
+        attribute(:account_country_code, String, null: false, from: "accountCountryCode")
 
-        # @return [String] BankAccount currency code in ISO 4217 format
-        attribute(:account_currency, String, from: "accountCurrency")
+        # @return [String] Bank account currency code in ISO 4217 format.
+        attribute(:account_currency, String, null: false, from: "accountCurrency")
 
-        # @return [String] Last 3 digit of the bank account number, for all Amazon Seller Wallet account the value will
-        #   be three consecutive 0's
-        attribute(:bank_account_number_tail, String, from: "bankAccountNumberTail")
+        # @return [String] The last 3 digit of the bank account number. This value is three consecutive zeros for Amazon
+        #   Seller Wallet accounts.
+        attribute(:bank_account_number_tail, String, null: false, from: "bankAccountNumberTail")
 
         # @return [String] Type of ownership of the bank account. This value is `SELF` for Amazon Seller Wallet
         #   accounts.
-        attribute(:bank_account_ownership_type, String, from: "bankAccountOwnershipType")
+        attribute(:bank_account_ownership_type, String, null: false, from: "bankAccountOwnershipType")
 
         # @return [String] The bank account holder's name (expected to be an Amazon customer). There is a 50 character
         #   limit.
@@ -35,7 +35,7 @@ module Peddler
         #   is required.
         attribute?(:account_id, String, from: "accountId")
 
-        # @return [String] Bank account holder compliance status
+        # @return [String] The compliance status of the bank account holder.
         attribute?(:bank_account_holder_status, String, from: "bankAccountHolderStatus")
 
         # @return [String] The format in which the bank account number is provided for `THIRD_PARTY` transaction

data/lib/peddler/apis/seller_wallet_2024_03_01/bank_account_listing.rb

@@ -7,10 +7,10 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Struct that holds collection of accounts.
+      # A list of bank accounts.
       BankAccountListing = Structure.new do
-        # @return [Array<BankAccount>] Collection that holds BankAccount
-        attribute(:accounts, [BankAccount])
+        # @return [Array<BankAccount>] A list of bank accounts.
+        attribute(:accounts, [BankAccount], null: false)
       end
     end
   end

data/lib/peddler/apis/seller_wallet_2024_03_01/create_transaction_response.rb

@@ -11,10 +11,10 @@ module Peddler
       CreateTransactionResponse = Structure.new do
         # @return [String] The callback URL for the transaction which the user have to click to approve/consent the
         #   transaction
-        attribute(:call_back_url, String, from: "callBackURL")
+        attribute(:call_back_url, String, null: false, from: "callBackURL")
 
         # @return [Transaction] The transaction response details.
-        attribute(:transaction, Transaction)
+        attribute(:transaction, Transaction, null: false)
       end
     end
   end

data/lib/peddler/apis/seller_wallet_2024_03_01/delete_transfer_schedule.rb

@@ -7,13 +7,14 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Response returned when the schedule transfer's delete request is successful.
+      # The response returned when the schedule transfer's delete request is successful.
       DeleteTransferSchedule = Structure.new do
-        # @return [String] A success code that specifies the delete operation was successful. eg:HTTP 200.
-        attribute(:code, String)
+        # @return [String] A success code that specifies that the delete operation was successful. For example, HTTP
+        #   200.
+        attribute(:code, String, null: false)
 
         # @return [String] A message that describes the success condition of the delete schedule transaction.
-        attribute(:message, String)
+        attribute(:message, String, null: false)
 
         # @return [String] Additional details that can help the caller understand the operation execution.
         attribute?(:details, String)

data/lib/peddler/apis/seller_wallet_2024_03_01/error.rb

@@ -10,10 +10,10 @@ module Peddler
       # Error response returned when the request is unsuccessful.
       Error = Structure.new do
         # @return [String] An error code that identifies the type of error that occurred.
-        attribute(:code, String)
+        attribute(:code, String, null: false)
 
         # @return [String] A message that describes the error condition.
-        attribute(:message, String)
+        attribute(:message, String, null: false)
 
         # @return [String] Additional details that can help the caller understand or fix the issue.
         attribute?(:details, String)

data/lib/peddler/apis/seller_wallet_2024_03_01/error_list.rb

@@ -10,7 +10,7 @@ module Peddler
       # A list of error responses returned when a request is unsuccessful.
       ErrorList = Structure.new do
         # @return [Array<Error>] List of errors
-        attribute(:errors, [Error])
+        attribute(:errors, [Error], null: false)
       end
     end
   end

data/lib/peddler/apis/seller_wallet_2024_03_01/fee.rb

@@ -7,22 +7,19 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # If the fees is in baseAmount (sourceAccount) currency, effectiveRate = (baseAmount -
-      # sum(fees.feeAmount.currencyAmount)) * baseRate) / baseAmount. If the fees is in transferAmount
-      # (destinationAccount) currency, effectiveRate = (( baseAmount * baseRate ) - sum(fees.feeAmount.currencyAmount ))
-      # / baseAmount
+      # Details of the fee.
       Fee = Structure.new do
-        # @return [Money] Displays actual value of the fee in numeric format.
-        attribute(:fee_amount, Money, from: "feeAmount")
+        # @return [Money] The actual value of the fee in numeric format.
+        attribute(:fee_amount, Money, null: false, from: "feeAmount")
 
-        # @return [String] Unique identifier assigned to the Fee.
-        attribute(:fee_id, String, from: "feeId")
+        # @return [String] The unique identifier assigned to the fee.
+        attribute(:fee_id, String, null: false, from: "feeId")
 
         # @return [String] The value of the fee in percentage format.
-        attribute(:fee_rate_value, String, from: "feeRateValue")
+        attribute(:fee_rate_value, String, null: false, from: "feeRateValue")
 
-        # @return [String] Displays type of the Fee.
-        attribute(:fee_type, String, from: "feeType")
+        # @return [String] The type of the fee.
+        attribute(:fee_type, String, null: false, from: "feeType")
       end
     end
   end

data/lib/peddler/apis/seller_wallet_2024_03_01/fx_rate_details.rb

@@ -7,20 +7,20 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Foreign exchange rate details displayed when transfer preview is requested.
+      # Foreign exchange rate details.
       FxRateDetails = Structure.new do
-        # @return [Float] This is the rate that will be market foreign exchange rate. For example: 1USD -> 86.0 INR.
-        attribute(:base_rate, Float, from: "baseRate")
+        # @return [Float] The market foreign exchange rate.
+        attribute(:base_rate, Float, null: false, from: "baseRate")
 
-        # @return [Float] Displays the foreign exchange rate which will be all rates and fees baked in (i.e; markup
-        #   fees), example: market fx rate and international transaction fee.
-        attribute(:effective_fx_rate, Float, from: "effectiveFxRate")
+        # @return [Float] The total rate applied to the money transfer. This includes all exchange rates, markups, and
+        #   fees.
+        attribute(:effective_fx_rate, Float, null: false, from: "effectiveFxRate")
 
-        # @return [String] Unique identifier assigned to the fees/foreign exchange Rate of a transaction.
-        attribute(:fx_rate_id, String, from: "fxRateId")
+        # @return [String] The unique identifier assigned to the fees / foreign exchange rate of a transaction.
+        attribute(:fx_rate_id, String, null: false, from: "fxRateId")
 
-        # @return [String] Rate Direction can refer to the way final amount is calculated.
-        attribute(:rate_direction, String, from: "rateDirection")
+        # @return [String] Whether the customer is buying or selling the source currency.
+        attribute(:rate_direction, String, null: false, from: "rateDirection")
       end
     end
   end

data/lib/peddler/apis/seller_wallet_2024_03_01/payee_contact_information.rb

@@ -10,40 +10,40 @@ module Peddler
       # The contact information of the payee. This field is required when the request `bankAccountOwnershipType` is
       # `THIRD_PARTY`. The contact information is used for payee verification and registration purposes.
       PayeeContactInformation = Structure.new do
-        # @return [String] Address Line 1 of the public address
-        attribute(:address_line1, String, from: "addressLine1")
+        # @return [String] Address Line 1 of the public address.
+        attribute(:address_line1, String, null: false, from: "addressLine1")
 
-        # @return [String] City name of the public address
-        attribute(:city, String)
+        # @return [String] City name of the public address.
+        attribute(:city, String, null: false)
 
         # @return [String] The two digit country code, in ISO 3166 format.
-        attribute(:country_code, String, from: "countryCode")
+        attribute(:country_code, String, null: false, from: "countryCode")
 
         # @return [String] Email address of the payee.
-        attribute(:email_address, String, from: "emailAddress")
+        attribute(:email_address, String, null: false, from: "emailAddress")
 
         # @return [String] Type of entity of the payee.
-        attribute(:payee_entity_type, String, from: "payeeEntityType")
+        attribute(:payee_entity_type, String, null: false, from: "payeeEntityType")
 
         # @return [String] First name of the payee. There is a 50 character limit.
-        attribute(:payee_first_name, String, from: "payeeFirstName")
+        attribute(:payee_first_name, String, null: false, from: "payeeFirstName")
 
         # @return [String] Last name of the payee. There is a 50 character limit.
-        attribute(:payee_last_name, String, from: "payeeLastName")
+        attribute(:payee_last_name, String, null: false, from: "payeeLastName")
 
         # @return [String] Valid phone number of the payee.
-        attribute(:phone_number, String, from: "phoneNumber")
+        attribute(:phone_number, String, null: false, from: "phoneNumber")
 
-        # @return [String] Postal code of the public address
-        attribute(:postal_code, String, from: "postalCode")
+        # @return [String] Postal code of the public address.
+        attribute(:postal_code, String, null: false, from: "postalCode")
 
         # @return [String] State name of the public address. This is the state or region for China-based addresses.
-        attribute(:state, String)
+        attribute(:state, String, null: false)
 
-        # @return [String] Address Line 2 of the public address
+        # @return [String] Address Line 2 of the public address.
         attribute?(:address_line2, String, from: "addressLine2")
 
-        # @return [String] Country name of the public address
+        # @return [String] Country name of the public address.
         attribute?(:country, String)
 
         # @return [String] Middle name of the payee. There is a 50 character limit.

data/lib/peddler/apis/seller_wallet_2024_03_01/payment_preference.rb

@@ -7,14 +7,13 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Payment preference type in which transfer is being scheduled
+      # The type of payment preference in which the transfer is being scheduled.
       PaymentPreference = Structure.new do
-        # @return [String] Specifies the preferred payment type for the scheduled transaction eg:PERCENTAGE of certain
-        #   total amount in account
-        attribute(:payment_preference_payment_type, String, from: "paymentPreferencePaymentType")
+        # @return [String] The preferred payment type for the scheduled transaction. Can be `PERCENTAGE` or `AMOUNT`.
+        attribute(:payment_preference_payment_type, String, null: false, from: "paymentPreferencePaymentType")
 
         # @return [Float] The value of the payment preference.
-        attribute(:value, Float)
+        attribute(:value, Float, null: false)
       end
     end
   end

data/lib/peddler/apis/seller_wallet_2024_03_01/schedule_expression.rb

@@ -7,14 +7,13 @@ require "structure"
 module Peddler
   module APIs
     class SellerWallet20240301
-      # Parameters containing information of the expression that defines when the schedule runs. The following formats
-      # are supported.
+      # The configuration of the schedule.
       ScheduleExpression = Structure.new do
-        # @return [String] Field to specify type of the scheduled transfer
-        attribute(:schedule_expression_type, String, from: "scheduleExpressionType")
+        # @return [String] The type of the scheduled transfer.
+        attribute(:schedule_expression_type, String, null: false, from: "scheduleExpressionType")
 
-        # @return [String] Field to specify recurrence of the scheduled transfer. Recurring frequency is mandatory if
-        #   scheduleExpressionType is set as RECURRING otherwise it should be empty field.
+        # @return [String] How often the scheduled transfer happens. This field is required if `scheduleExpressionType`
+        #   is `RECURRING`; otherwise it should be empty.
         attribute?(:recurring_frequency, String, from: "recurringFrequency")
       end
     end

data/lib/peddler/apis/seller_wallet_2024_03_01/transaction.rb

@@ -12,58 +12,57 @@ module Peddler
       Transaction = Structure.new do
         # @return [String] The unique identifier of the Amazon Seller Wallet bank account from which the money is
         #   debited.
-        attribute(:account_id, String, from: "accountId")
+        attribute(:account_id, String, null: false, from: "accountId")
 
-        # @return [Time] The last update date on the transaction
-        attribute(:last_update_date, Time, from: "lastUpdateDate")
+        # @return [Time] The date of the most recent account balance update.
+        attribute(:last_update_date, Time, null: false, from: "lastUpdateDate")
 
         # @return [String] A description of the transaction that the requester provides when they initiate the
         #   transaction.
-        attribute(:transaction_description, String, from: "transactionDescription")
+        attribute(:transaction_description, String, null: false, from: "transactionDescription")
 
-        # @return [TransactionAccount] Destination bank account details in the transaction
-        attribute(:transaction_destination_account, TransactionAccount, from: "transactionDestinationAccount")
+        # @return [TransactionAccount] The destination bank account details in the transaction.
+        attribute(:transaction_destination_account, TransactionAccount, null: false, from: "transactionDestinationAccount")
 
-        # @return [String] The unique identifier provided by Amazon to the transaction
-        attribute(:transaction_id, String, from: "transactionId")
+        # @return [String] The unique identifier provided by Amazon to the transaction.
+        attribute(:transaction_id, String, null: false, from: "transactionId")
 
-        # @return [Money] Specifies the amount for which the transfer was initiated
-        attribute(:transaction_request_amount, Money, from: "transactionRequestAmount")
+        # @return [Money] The amount for which the transfer was initiated.
+        attribute(:transaction_request_amount, Money, null: false, from: "transactionRequestAmount")
 
         # @return [Time] The date when the transaction was initiated.
-        attribute(:transaction_request_date, Time, from: "transactionRequestDate")
+        attribute(:transaction_request_date, Time, null: false, from: "transactionRequestDate")
 
         # @return [String] The transaction initiation source. This value is either the Amazon portal or PISP name that
         #   the customer used to start the transaction.
-        attribute(:transaction_requester_source, String, from: "transactionRequesterSource")
+        attribute(:transaction_requester_source, String, null: false, from: "transactionRequesterSource")
 
-        # @return [String] Execution Status of the transaction
-        attribute(:transaction_status, String, from: "transactionStatus")
+        # @return [String] The status of the transaction.
+        attribute(:transaction_status, String, null: false, from: "transactionStatus")
 
-        # @return [String] Type of the transaction
-        attribute(:transaction_type, String, from: "transactionType")
+        # @return [String] The type of the transaction.
+        attribute(:transaction_type, String, null: false, from: "transactionType")
 
         # @return [TransferRatePreview] The fees and rates that apply to the transaction, as applicable.
-        attribute(:transfer_rate_details, TransferRatePreview, from: "transferRateDetails")
+        attribute(:transfer_rate_details, TransferRatePreview, null: false, from: "transferRateDetails")
 
-        # @return [Time] Expected completion date of a transaction, for existing active Payees (Trusted Beneficiaries)
-        #   it will be 24 hours but for new destination bank accounts the value could go up to 5 days
+        # @return [Time] The expected completion date of the transaction.
         attribute?(:expected_completion_date, Time, from: "expectedCompletionDate")
 
-        # @return [String] Amazon SW customer who requested the transaction
+        # @return [String] The Amazon Seller Wallet customer who requested the transaction.
         attribute?(:requester_name, String, from: "requesterName")
 
-        # @return [Time] Transaction completion date
+        # @return [Time] The transaction's completion date.
         attribute?(:transaction_actual_completion_date, Time, from: "transactionActualCompletionDate")
 
-        # @return [String] Description in case the transaction fails before completion
+        # @return [String] The reason the transaction failed, if applicable.
         attribute?(:transaction_failure_reason, String, from: "transactionFailureReason")
 
-        # @return [Money] Specifies the amount of completed transaction in the destination account currency, this will
-        #   be populated only for international transactions
+        # @return [Money] The amount of completed transaction in the destination account currency. This value is only
+        #   populated for international transactions
         attribute?(:transaction_final_amount, Money, from: "transactionFinalAmount")
 
-        # @return [TransactionAccount] Source bank account details in the transaction
+        # @return [TransactionAccount] The source bank account details in the transaction.
         attribute?(:transaction_source_account, TransactionAccount, from: "transactionSourceAccount")
       end
     end