Class: ModernTreasury::Models::Invoice

Inherits:
Internal::Type::BaseModel show all
Defined in:
lib/modern_treasury/models/invoice.rb

Overview

See Also:

Defined Under Namespace

Modules: PaymentMethod, PaymentType, Status Classes: CounterpartyBillingAddress, CounterpartyShippingAddress, InvoicerAddress

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Internal::Type::BaseModel

==, #==, #[], coerce, #deconstruct_keys, #deep_to_h, dump, fields, hash, #hash, inherited, inspect, #inspect, known_fields, optional, recursively_to_h, required, #to_h, #to_json, #to_s, to_sorbet_type, #to_yaml

Methods included from Internal::Type::Converter

#coerce, coerce, #dump, dump, #inspect, inspect, meta_info, new_coerce_state, type_info

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

#initialize(country:, line1:, locality:, postal_code:, region:, line2: nil) ⇒ Object

The invoice issuer’s business address.

Parameters:

  • country (String) —

    Country code conforms to [ISO 3166-1 alpha-2]

  • line1 (String)
  • locality (String) —

    Locality or City.

  • postal_code (String) —

    The postal code of the address.

  • region (String) —

    Region or State.

  • line2 (String) (defaults to: nil) 



# File 'lib/modern_treasury/models/invoice.rb', line 273

Instance Attribute Details

#amount_paid ⇒ Integer

Amount paid on the invoice in specified currency’s smallest unit, e.g., $10 USD would be represented as 1000.

Returns:

  • (Integer) 


17
 
# File 'lib/modern_treasury/models/invoice.rb', line 17

required :amount_paid, Integer

#amount_remaining ⇒ Integer

Amount remaining due on the invoice in specified currency’s smallest unit, e.g., $10 USD would be represented as 1000.

Returns:

  • (Integer) 


24
 
# File 'lib/modern_treasury/models/invoice.rb', line 24

required :amount_remaining, Integer

#contact_details ⇒ Array<ModernTreasury::Models::ContactDetail>

The invoicer’s contact details displayed at the top of the invoice.

Returns:



30
 
# File 'lib/modern_treasury/models/invoice.rb', line 30

required :contact_details, -> { ModernTreasury::Internal::Type::ArrayOf[ModernTreasury::ContactDetail] }

#counterparty_billing_address ⇒ ModernTreasury::Models::Invoice::CounterpartyBillingAddress?

The counterparty’s billing address.

Returns:



36
37
38
 
# File 'lib/modern_treasury/models/invoice.rb', line 36

required :counterparty_billing_address,
-> { ModernTreasury::Invoice::CounterpartyBillingAddress },
nil?: true

#counterparty_id ⇒ String

The ID of the counterparty receiving the invoice.

Returns:

  • (String) 


44
 
# File 'lib/modern_treasury/models/invoice.rb', line 44

required :counterparty_id, String

#counterparty_shipping_address ⇒ ModernTreasury::Models::Invoice::CounterpartyShippingAddress?

The counterparty’s shipping address where physical goods should be delivered.

Returns:



50
51
52
 
# File 'lib/modern_treasury/models/invoice.rb', line 50

required :counterparty_shipping_address,
-> { ModernTreasury::Invoice::CounterpartyShippingAddress },
nil?: true

#created_at ⇒ Time

Returns:

  • (Time) 


57
 
# File 'lib/modern_treasury/models/invoice.rb', line 57

required :created_at, Time

#currency ⇒ Symbol, ModernTreasury::Models::Currency

Currency that the invoice is denominated in. Defaults to ‘USD` if not provided.

Returns:



63
 
# File 'lib/modern_treasury/models/invoice.rb', line 63

required :currency, enum: -> { ModernTreasury::Currency }

#description ⇒ String

An optional free-form description of the invoice.

Returns:

  • (String) 


69
 
# File 'lib/modern_treasury/models/invoice.rb', line 69

required :description, String

#due_date ⇒ Time

A future date by when the invoice needs to be paid.

Returns:

  • (Time) 


75
 
# File 'lib/modern_treasury/models/invoice.rb', line 75

required :due_date, Time

#expected_payments ⇒ Array<ModernTreasury::Models::ExpectedPayment>

The expected payments created for an unpaid invoice.

Returns:



81
82
 
# File 'lib/modern_treasury/models/invoice.rb', line 81

required :expected_payments,
-> { ModernTreasury::Internal::Type::ArrayOf[ModernTreasury::ExpectedPayment] }

#fallback_payment_method ⇒ String?

When payment_method is automatic, the fallback payment method to use when an automatic payment fails. One of ‘manual` or `ui`.

Returns:

  • (String, nil) 


89
 
# File 'lib/modern_treasury/models/invoice.rb', line 89

required :fallback_payment_method, String, nil?: true

#hosted_url ⇒ String

The URL of the hosted web UI where the invoice can be viewed.

Returns:

  • (String) 


95
 
# File 'lib/modern_treasury/models/invoice.rb', line 95

required :hosted_url, String

#id ⇒ String

Returns:

  • (String) 


10
 
# File 'lib/modern_treasury/models/invoice.rb', line 10

required :id, String

#invoicer_address ⇒ ModernTreasury::Models::Invoice::InvoicerAddress?

The invoice issuer’s business address.

Returns:



101
 
# File 'lib/modern_treasury/models/invoice.rb', line 101

required :invoicer_address, -> { ModernTreasury::Invoice::InvoicerAddress }, nil?: true

#invoicer_name ⇒ String?

The name of the issuer for the invoice. Defaults to the name of the Organization.

Returns:

  • (String, nil) 


108
 
# File 'lib/modern_treasury/models/invoice.rb', line 108

required :invoicer_name, String, nil?: true

#issued_at ⇒ Time?

Translation missing: en.openapi.descriptions.invoice.schema.issued_at

Returns:

  • (Time, nil) 


114
 
# File 'lib/modern_treasury/models/invoice.rb', line 114

required :issued_at, Time, nil?: true

#ledger_account_settlement_id ⇒ String?

Deprecated.

The ledger account settlement object linked to the invoice.

Returns:

  • (String, nil) 


122
 
# File 'lib/modern_treasury/models/invoice.rb', line 122

required :ledger_account_settlement_id, String, nil?: true

#live_mode ⇒ Boolean

This field will be true if this object exists in the live environment or false if it exists in the test environment.

Returns:

  • (Boolean) 


129
 
# File 'lib/modern_treasury/models/invoice.rb', line 129

required :live_mode, ModernTreasury::Internal::Type::Boolean

#metadata ⇒ Hash{Symbol=>String}?

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

Returns:

  • (Hash{Symbol=>String}, nil) 


136
 
# File 'lib/modern_treasury/models/invoice.rb', line 136

required :metadata, ModernTreasury::Internal::Type::HashOf[String], nil?: true

#notification_email_addresses ⇒ Array<String>?

Emails in addition to the counterparty email to send invoice status notifications to. At least one email is required if notifications are enabled and the counterparty doesn’t have an email.

Returns:

  • (Array<String>, nil) 


144
 
# File 'lib/modern_treasury/models/invoice.rb', line 144

required :notification_email_addresses, ModernTreasury::Internal::Type::ArrayOf[String], nil?: true

#notifications_enabled ⇒ Boolean

If true, the invoice will send email notifications to the invoice recipients about invoice status changes.

Returns:

  • (Boolean) 


151
 
# File 'lib/modern_treasury/models/invoice.rb', line 151

required :notifications_enabled, ModernTreasury::Internal::Type::Boolean

#number ⇒ String

A unique record number assigned to each invoice that is issued.

Returns:

  • (String) 


157
 
# File 'lib/modern_treasury/models/invoice.rb', line 157

required :number, String

#object ⇒ String

Returns:

  • (String) 


162
 
# File 'lib/modern_treasury/models/invoice.rb', line 162

required :object, String

#originating_account_id ⇒ String

The ID of the internal account the invoice should be paid to.

Returns:

  • (String) 


168
 
# File 'lib/modern_treasury/models/invoice.rb', line 168

required :originating_account_id, String

Translation missing: en.openapi.descriptions.invoice.schema.paid_at

Returns:

  • (Time, nil) 


174
 
# File 'lib/modern_treasury/models/invoice.rb', line 174

required :paid_at, Time, nil?: true

#payment_effective_date ⇒ Date?

Date transactions are to be posted to the participants’ account. Defaults to the current business day or the next business day if the current day is a bank holiday or weekend. Format: yyyy-mm-dd.

Returns:

  • (Date, nil) 


182
 
# File 'lib/modern_treasury/models/invoice.rb', line 182

required :payment_effective_date, Date, nil?: true

#payment_method ⇒ Symbol, ...

When opening an invoice, whether to show the embedded payment UI , automatically debit the recipient, or rely on manual payment from the recipient.

Returns:



189
 
# File 'lib/modern_treasury/models/invoice.rb', line 189

required :payment_method, enum: -> { ModernTreasury::Invoice::PaymentMethod }, nil?: true

#payment_orders ⇒ Array<ModernTreasury::Models::PaymentOrder>

The payment orders created for paying the invoice through the invoice payment UI.

Returns:



196
 
# File 'lib/modern_treasury/models/invoice.rb', line 196

required :payment_orders, -> { ModernTreasury::Internal::Type::ArrayOf[ModernTreasury::PaymentOrder] }

#payment_type ⇒ Symbol, ...

One of ‘ach` or `eft`.

Returns:



202
 
# File 'lib/modern_treasury/models/invoice.rb', line 202

required :payment_type, enum: -> { ModernTreasury::Invoice::PaymentType }, nil?: true

#pdf_url ⇒ String?

The URL where the invoice PDF can be downloaded.

Returns:

  • (String, nil) 


208
 
# File 'lib/modern_treasury/models/invoice.rb', line 208

required :pdf_url, String, nil?: true

#receiving_account_id ⇒ String?

The receiving account ID. Can be an ‘internal_account`.

Returns:

  • (String, nil) 


214
 
# File 'lib/modern_treasury/models/invoice.rb', line 214

required :receiving_account_id, String, nil?: true

#recipient_email ⇒ String?

The email of the recipient of the invoice. Leaving this value as null will fallback to using the counterparty’s name.

Returns:

  • (String, nil) 


221
 
# File 'lib/modern_treasury/models/invoice.rb', line 221

required :recipient_email, String, nil?: true

#recipient_name ⇒ String?

The name of the recipient of the invoice. Leaving this value as null will fallback to using the counterparty’s name.

Returns:

  • (String, nil) 


228
 
# File 'lib/modern_treasury/models/invoice.rb', line 228

required :recipient_name, String, nil?: true

#remind_after_overdue_days ⇒ Array<Integer>?

Number of days after due date when overdue reminder emails will be sent out to invoice recipients.

Returns:

  • (Array<Integer>, nil) 


235
 
# File 'lib/modern_treasury/models/invoice.rb', line 235

required :remind_after_overdue_days, ModernTreasury::Internal::Type::ArrayOf[Integer], nil?: true

#status ⇒ Symbol, ModernTreasury::Models::Invoice::Status

The status of the invoice.

Returns:



241
 
# File 'lib/modern_treasury/models/invoice.rb', line 241

required :status, enum: -> { ModernTreasury::Invoice::Status }

#total_amount ⇒ Integer

Total amount due in specified currency’s smallest unit, e.g., $10 USD would be represented as 1000.

Returns:

  • (Integer) 


248
 
# File 'lib/modern_treasury/models/invoice.rb', line 248

required :total_amount, Integer

#transaction_line_item_ids ⇒ Array<String>

IDs of transaction line items associated with an invoice.

Returns:

  • (Array<String>) 


254
 
# File 'lib/modern_treasury/models/invoice.rb', line 254

required :transaction_line_item_ids, ModernTreasury::Internal::Type::ArrayOf[String]

#updated_at ⇒ Time

Returns:

  • (Time) 


259
 
# File 'lib/modern_treasury/models/invoice.rb', line 259

required :updated_at, Time

#virtual_account_id ⇒ String?

The ID of the virtual account the invoice should be paid to.

Returns:

  • (String, nil) 


265
 
# File 'lib/modern_treasury/models/invoice.rb', line 265

required :virtual_account_id, String, nil?: true

#voided_at ⇒ Time?

Translation missing: en.openapi.descriptions.invoice.schema.voided_at

Returns:

  • (Time, nil) 


271
 
# File 'lib/modern_treasury/models/invoice.rb', line 271

required :voided_at, Time, nil?: true

Class Method Details

.values ⇒ Array<Symbol>

Returns:

  • (Array<Symbol>) 



# File 'lib/modern_treasury/models/invoice.rb', line 526