Class: ModernTreasury::Resources::LedgerTransactions

Inherits:

Object

• Object
• ModernTreasury::Resources::LedgerTransactions

Defined in:

lib/modern_treasury/resources/ledger_transactions.rb,
lib/modern_treasury/resources/ledger_transactions/versions.rb

Defined Under Namespace

Classes: Versions

Instance Attribute Summary

• #versions ⇒ ModernTreasury::Resources::LedgerTransactions::Versions readonly

Instance Method Summary

• #create(ledger_entries:, description: nil, effective_at: nil, effective_date: nil, external_id: nil, ledgerable_id: nil, ledgerable_type: nil, metadata: nil, status: nil, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

  Some parameter documentations has been truncated, see Models::LedgerTransactionCreateParams for more details.

• #create_partial_post(id, posted_ledger_entries:, description: nil, effective_at: nil, metadata: nil, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

  Some parameter documentations has been truncated, see Models::LedgerTransactionCreatePartialPostParams for more details.

• #create_reversal(id, description: nil, effective_at: nil, external_id: nil, ledgerable_id: nil, ledgerable_type: nil, metadata: nil, status: nil, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

  Some parameter documentations has been truncated, see Models::LedgerTransactionCreateReversalParams for more details.

• #initialize(client:) ⇒ LedgerTransactions constructor private

  A new instance of LedgerTransactions.

• #list(id: nil, after_cursor: nil, amount: nil, effective_at: nil, effective_date: nil, external_id: nil, ledger_account_category_id: nil, ledger_account_id: nil, ledger_account_settlement_id: nil, ledger_id: nil, ledgerable_id: nil, ledgerable_type: nil, metadata: nil, order_by: nil, partially_posts_ledger_transaction_id: nil, per_page: nil, posted_at: nil, reverses_ledger_transaction_id: nil, status: nil, updated_at: nil, request_options: {}) ⇒ ModernTreasury::Internal::Page<ModernTreasury::Models::LedgerTransaction>

  Some parameter documentations has been truncated, see Models::LedgerTransactionListParams for more details.

• #retrieve(id, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

  Some parameter documentations has been truncated, see Models::LedgerTransactionRetrieveParams for more details.

• #update(id, description: nil, effective_at: nil, external_id: nil, ledger_entries: nil, ledgerable_id: nil, ledgerable_type: nil, metadata: nil, status: nil, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

  Some parameter documentations has been truncated, see Models::LedgerTransactionUpdateParams for more details.

Constructor Details

#initialize(client:) ⇒ LedgerTransactions

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of LedgerTransactions.

Parameters:

• client (ModernTreasury::Client)

# File 'lib/modern_treasury/resources/ledger_transactions.rb', line 256

def initialize(client:)
  @client = client
  @versions = ModernTreasury::Resources::LedgerTransactions::Versions.new(client: client)
end

Instance Attribute Details

#versions ⇒ ModernTreasury::Resources::LedgerTransactions::Versions (readonly)

Returns:

• (ModernTreasury::Resources::LedgerTransactions::Versions)

# File 'lib/modern_treasury/resources/ledger_transactions.rb', line 7

def versions
  @versions
end

Instance Method Details

#create(ledger_entries:, description: nil, effective_at: nil, effective_date: nil, external_id: nil, ledgerable_id: nil, ledgerable_type: nil, metadata: nil, status: nil, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

Some parameter documentations has been truncated, see Models::LedgerTransactionCreateParams for more details.

Create a ledger transaction.

Parameters:

• ledger_entries (Array<ModernTreasury::Models::LedgerEntryCreateRequest>) —

  An array of ledger entry objects.

• description (String, nil) —

  An optional description for internal use.

• effective_at (Time) —

  The timestamp (ISO8601 format) at which the ledger transaction happened for repo

• effective_date (Date) —

  The date (YYYY-MM-DD) on which the ledger transaction happened for reporting pur

• external_id (String) —

  A unique string to represent the ledger transaction. Only one pending or posted

• ledgerable_id (String) —

  If the ledger transaction can be reconciled to another object in Modern Treasury

• ledgerable_type (Symbol, ModernTreasury::Models::LedgerTransactionCreateRequest::LedgerableType) —

  If the ledger transaction can be reconciled to another object in Modern Treasury

• metadata (Hash{Symbol=>String}) —

  Additional data represented as key-value pairs. Both the key and value must be s

• status (Symbol, ModernTreasury::Models::LedgerTransactionCreateRequest::Status) —

  To post a ledger transaction at creation, use ‘posted`.

• request_options (ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

• (ModernTreasury::Models::LedgerTransaction)

See Also:

• Models::LedgerTransactionCreateParams

# File 'lib/modern_treasury/resources/ledger_transactions.rb', line 39

def create(params)
  parsed, options = ModernTreasury::LedgerTransactionCreateParams.dump_request(params)
  @client.request(
    method: :post,
    path: "api/ledger_transactions",
    body: parsed,
    model: ModernTreasury::LedgerTransaction,
    options: options
  )
end

#create_partial_post(id, posted_ledger_entries:, description: nil, effective_at: nil, metadata: nil, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

Some parameter documentations has been truncated, see Models::LedgerTransactionCreatePartialPostParams for more details.

Create a ledger transaction that partially posts another ledger transaction.

Parameters:

• id (String) —

  The ID of the ledger transaction to partially post.

• posted_ledger_entries (Array<ModernTreasury::Models::LedgerTransactionCreatePartialPostParams::PostedLedgerEntry>) —

  An array of ledger entry objects to be set on the posted ledger transaction. The

• description (String) —

  An optional free-form description for the posted ledger transaction. Maximum of

• effective_at (Time) —

  The timestamp (IS08601 format) at which the posted ledger transaction happened f

• metadata (Hash{Symbol=>String}) —

  Additional data represented as key-value pairs. Both the key and value must be s

• request_options (ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

• (ModernTreasury::Models::LedgerTransaction)

See Also:

• Models::LedgerTransactionCreatePartialPostParams

# File 'lib/modern_treasury/resources/ledger_transactions.rb', line 202

def create_partial_post(id, params)
  parsed, options = ModernTreasury::LedgerTransactionCreatePartialPostParams.dump_request(params)
  @client.request(
    method: :post,
    path: ["api/ledger_transactions/%1$s/partial_post", id],
    body: parsed,
    model: ModernTreasury::LedgerTransaction,
    options: options
  )
end

#create_reversal(id, description: nil, effective_at: nil, external_id: nil, ledgerable_id: nil, ledgerable_type: nil, metadata: nil, status: nil, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

Some parameter documentations has been truncated, see Models::LedgerTransactionCreateReversalParams for more details.

Create a ledger transaction reversal.

Parameters:

• id (String) —

  The id of ledger transaction to reverse.

• description (String) —

  An optional free-form description for the reversal ledger transaction. Maximum o

• effective_at (Time, nil) —

  The timestamp (ISO8601 format) at which the reversal ledger transaction happened

• external_id (String) —

  Must be unique within the ledger.

• ledgerable_id (String) —

  Specify this if you’d like to link the reversal ledger transaction to a Payment

• ledgerable_type (Symbol, ModernTreasury::Models::LedgerTransactionCreateReversalParams::LedgerableType) —

  Specify this if you’d like to link the reversal ledger transaction to a Payment

• metadata (Hash{Symbol=>String}) —

  Additional data to be added to the reversal ledger transaction as key-value pair

• status (Symbol, ModernTreasury::Models::LedgerTransactionCreateReversalParams::Status) —

  Status of the reversal ledger transaction. It defaults to ‘posted` if not provid

• request_options (ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

• (ModernTreasury::Models::LedgerTransaction)

See Also:

• Models::LedgerTransactionCreateReversalParams

# File 'lib/modern_treasury/resources/ledger_transactions.rb', line 242

def create_reversal(id, params = {})
  parsed, options = ModernTreasury::LedgerTransactionCreateReversalParams.dump_request(params)
  @client.request(
    method: :post,
    path: ["api/ledger_transactions/%1$s/reversal", id],
    body: parsed,
    model: ModernTreasury::LedgerTransaction,
    options: options
  )
end

#list(id: nil, after_cursor: nil, amount: nil, effective_at: nil, effective_date: nil, external_id: nil, ledger_account_category_id: nil, ledger_account_id: nil, ledger_account_settlement_id: nil, ledger_id: nil, ledgerable_id: nil, ledgerable_type: nil, metadata: nil, order_by: nil, partially_posts_ledger_transaction_id: nil, per_page: nil, posted_at: nil, reverses_ledger_transaction_id: nil, status: nil, updated_at: nil, request_options: {}) ⇒ ModernTreasury::Internal::Page<ModernTreasury::Models::LedgerTransaction>

Some parameter documentations has been truncated, see Models::LedgerTransactionListParams for more details.

Get a list of ledger transactions.

Parameters:

• id (Array<String>) —

  If you have specific IDs to retrieve in bulk, you can pass them as query paramet

• after_cursor (String, nil)
• amount (ModernTreasury::Models::LedgerTransactionListParams::Amount) —

  Use ‘gt` (>), `gte` (>=), `lt` (<), `lte` (<=), or `eq` (=) to filter by amount.

• effective_at (Hash{Symbol=>Time}) —

  Use “gt” (>), “gte” (>=), “lt” (<), “lte” (<=), or “eq” (=) to filter by effecti

• effective_date (Hash{Symbol=>Time}) —

  Use ‘gt` (>), `gte` (>=), `lt` (<), `lte` (<=), or `eq` (=) to filter by effecti

• external_id (String)
• ledger_account_category_id (String)
• ledger_account_id (String)
• ledger_account_settlement_id (String)
• ledger_id (String)
• ledgerable_id (String)
• ledgerable_type (Symbol, ModernTreasury::Models::LedgerTransactionListParams::LedgerableType)
• metadata (Hash{Symbol=>String}) —

  For example, if you want to query for records with metadata key ‘Type` and value

• order_by (ModernTreasury::Models::LedgerTransactionListParams::OrderBy) —

  Order by ‘created_at` or `effective_at` in `asc` or `desc` order. For example, t

• partially_posts_ledger_transaction_id (String)
• per_page (Integer)
• posted_at (Hash{Symbol=>Time}) —

  Use ‘gt` (>), `gte` (>=), `lt` (<), `lte` (<=), or `eq` (=) to filter by the pos

• reverses_ledger_transaction_id (String)
• status (Symbol, Array<Symbol, ModernTreasury::Models::LedgerTransactionListParams::Status::UnionMember1>, ModernTreasury::Models::LedgerTransactionListParams::Status)
• updated_at (Hash{Symbol=>Time}) —

  Use ‘gt` (>), `gte` (>=), `lt` (<), `lte` (<=), or `eq` (=) to filter by the pos

• request_options (ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

• (ModernTreasury::Internal::Page<ModernTreasury::Models::LedgerTransaction>)

See Also:

• Models::LedgerTransactionListParams

# File 'lib/modern_treasury/resources/ledger_transactions.rb', line 166

def list(params = {})
  parsed, options = ModernTreasury::LedgerTransactionListParams.dump_request(params)
  query = ModernTreasury::Internal::Util.encode_query_params(parsed)
  @client.request(
    method: :get,
    path: "api/ledger_transactions",
    query: query,
    page: ModernTreasury::Internal::Page,
    model: ModernTreasury::LedgerTransaction,
    options: options
  )
end

#retrieve(id, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

Some parameter documentations has been truncated, see Models::LedgerTransactionRetrieveParams for more details.

Get details on a single ledger transaction.

Parameters:

• id (String) —

  The ledger transaction id (UUID) or external_id. If using external_id, only non-

• request_options (ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

• (ModernTreasury::Models::LedgerTransaction)

See Also:

• Models::LedgerTransactionRetrieveParams

# File 'lib/modern_treasury/resources/ledger_transactions.rb', line 64

def retrieve(id, params = {})
  @client.request(
    method: :get,
    path: ["api/ledger_transactions/%1$s", id],
    model: ModernTreasury::LedgerTransaction,
    options: params[:request_options]
  )
end

#update(id, description: nil, effective_at: nil, external_id: nil, ledger_entries: nil, ledgerable_id: nil, ledgerable_type: nil, metadata: nil, status: nil, request_options: {}) ⇒ ModernTreasury::Models::LedgerTransaction

Some parameter documentations has been truncated, see Models::LedgerTransactionUpdateParams for more details.

Update the details of a ledger transaction.

Parameters:

• id (String) —

  The ledger transaction id (UUID)

• description (String, nil) —

  An optional description for internal use.

• effective_at (Time) —

  The timestamp (ISO8601 format) at which the ledger transaction happened for repo

• external_id (String, nil) —

  A unique string to represent the ledger transaction. Only one pending or posted

• ledger_entries (Array<ModernTreasury::Models::LedgerEntryCreateRequest>) —

  An array of ledger entry objects.

• ledgerable_id (String) —

  If the ledger transaction can be reconciled to another object in Modern Treasury

• ledgerable_type (Symbol, ModernTreasury::Models::LedgerTransactionUpdateParams::LedgerableType) —

  If the ledger transaction can be reconciled to another object in Modern Treasury

• metadata (Hash{Symbol=>String}) —

  Additional data represented as key-value pairs. Both the key and value must be s

• status (Symbol, ModernTreasury::Models::LedgerTransactionUpdateParams::Status) —

  To post a ledger transaction at creation, use ‘posted`.

• request_options (ModernTreasury::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

• (ModernTreasury::Models::LedgerTransaction)

See Also:

• Models::LedgerTransactionUpdateParams

# File 'lib/modern_treasury/resources/ledger_transactions.rb', line 103

def update(id, params = {})
  parsed, options = ModernTreasury::LedgerTransactionUpdateParams.dump_request(params)
  @client.request(
    method: :patch,
    path: ["api/ledger_transactions/%1$s", id],
    body: parsed,
    model: ModernTreasury::LedgerTransaction,
    options: options
  )
end