Class: Merge::Accounting::Invoice
- Inherits:
-
Object
- Object
- Merge::Accounting::Invoice
- Defined in:
- lib/merge_ruby_client/accounting/types/invoice.rb
Overview
# The Invoice Object
### Description
The `Invoice` object represents an itemized record of goods and/or services sold
to a customer or bought from a vendor.
Represents a Bill when the `Invoice` type is `ACCOUNTS_PAYABLE`. References an
Invoice when the `Invoice` type is `ACCOUNTS_RECEIVABLE`.
### Usage Example
Fetch from the `LIST Invoices` endpoint and view a company's invoices.
Constant Summary collapse
- OMIT =
Object.new
Instance Attribute Summary collapse
-
#accounting_period ⇒ Merge::Accounting::InvoiceAccountingPeriod
readonly
The accounting period that the Invoice was generated in.
-
#additional_properties ⇒ OpenStruct
readonly
Additional properties unmapped to the current class definition.
-
#applied_credit_notes ⇒ Array<Merge::Accounting::InvoiceAppliedCreditNotesItem>
readonly
‘CreditNoteApplyLines` applied to the Invoice.
-
#applied_payments ⇒ Array<Merge::Accounting::InvoiceAppliedPaymentsItem>
readonly
A list of the Payment Applied to Lines common models related to a given Invoice, Credit Note, or Journal Entry.
-
#applied_vendor_credits ⇒ Array<Merge::Accounting::InvoiceAppliedVendorCreditsItem>
readonly
‘VendorCreditApplyLines` applied to the Invoice.
-
#balance ⇒ Float
readonly
The invoice’s remaining balance.
-
#company ⇒ Merge::Accounting::InvoiceCompany
readonly
The company the invoice belongs to.
-
#contact ⇒ Merge::Accounting::InvoiceContact
readonly
The invoice’s contact.
-
#created_at ⇒ DateTime
readonly
The datetime that this object was created by Merge.
-
#currency ⇒ Merge::Accounting::TransactionCurrencyEnum
readonly
The invoice’s currency.
-
#due_date ⇒ DateTime
readonly
The invoice’s due date.
-
#employee ⇒ Merge::Accounting::InvoiceEmployee
readonly
The employee this overall transaction relates to.
-
#exchange_rate ⇒ String
readonly
The invoice’s exchange rate.
- #field_mappings ⇒ Hash{String => Object} readonly
- #id ⇒ String readonly
-
#inclusive_of_tax ⇒ Boolean
readonly
If the transaction is inclusive or exclusive of tax.
-
#issue_date ⇒ DateTime
readonly
The invoice’s issue date.
- #line_items ⇒ Array<Merge::Accounting::InvoiceLineItem> readonly
-
#memo ⇒ String
readonly
The invoice’s private note.
-
#modified_at ⇒ DateTime
readonly
The datetime that this object was modified by Merge.
-
#number ⇒ String
readonly
The invoice’s number.
-
#paid_on_date ⇒ DateTime
readonly
The invoice’s paid date.
-
#payment_term ⇒ Merge::Accounting::InvoicePaymentTerm
readonly
The payment term that applies to this transaction.
-
#payments ⇒ Array<Merge::Accounting::InvoicePaymentsItem>
readonly
Array of ‘Payment` object IDs.
- #purchase_orders ⇒ Array<Merge::Accounting::InvoicePurchaseOrdersItem> readonly
- #remote_data ⇒ Array<Merge::Accounting::RemoteData> readonly
- #remote_fields ⇒ Array<Merge::Accounting::RemoteField> readonly
-
#remote_id ⇒ String
readonly
The third-party API ID of the matching object.
-
#remote_updated_at ⇒ DateTime
readonly
When the third party’s invoice entry was updated.
-
#remote_was_deleted ⇒ Boolean
readonly
Indicates whether or not this object has been deleted in the third party platform.
-
#status ⇒ Merge::Accounting::InvoiceStatusEnum
readonly
The status of the invoice.
-
#sub_total ⇒ Float
readonly
The total amount being paid before taxes.
-
#total_amount ⇒ Float
readonly
The invoice’s total amount.
-
#total_discount ⇒ Float
readonly
The total discounts applied to the total cost.
-
#total_tax_amount ⇒ Float
readonly
The total amount being paid in taxes.
- #tracking_categories ⇒ Array<Merge::Accounting::InvoiceTrackingCategoriesItem> readonly
-
#type ⇒ Merge::Accounting::InvoiceTypeEnum
readonly
Whether the invoice is an accounts receivable or accounts payable.
Class Method Summary collapse
-
.from_json(json_object:) ⇒ Merge::Accounting::Invoice
Deserialize a JSON object to an instance of Invoice.
-
.validate_raw(obj:) ⇒ Void
Leveraged for Union-type generation, validate_raw attempts to parse the given hash and check each fields type against the current object’s property definitions.
Instance Method Summary collapse
- #initialize(id: OMIT, remote_id: OMIT, created_at: OMIT, modified_at: OMIT, type: OMIT, contact: OMIT, number: OMIT, issue_date: OMIT, due_date: OMIT, paid_on_date: OMIT, memo: OMIT, company: OMIT, employee: OMIT, currency: OMIT, exchange_rate: OMIT, payment_term: OMIT, total_discount: OMIT, sub_total: OMIT, status: OMIT, total_tax_amount: OMIT, total_amount: OMIT, balance: OMIT, remote_updated_at: OMIT, tracking_categories: OMIT, accounting_period: OMIT, purchase_orders: OMIT, payments: OMIT, applied_payments: OMIT, line_items: OMIT, applied_credit_notes: OMIT, applied_vendor_credits: OMIT, inclusive_of_tax: OMIT, remote_was_deleted: OMIT, field_mappings: OMIT, remote_data: OMIT, remote_fields: OMIT, additional_properties: nil) ⇒ Merge::Accounting::Invoice constructor
-
#to_json(*_args) ⇒ String
Serialize an instance of Invoice to a JSON object.
Constructor Details
#initialize(id: OMIT, remote_id: OMIT, created_at: OMIT, modified_at: OMIT, type: OMIT, contact: OMIT, number: OMIT, issue_date: OMIT, due_date: OMIT, paid_on_date: OMIT, memo: OMIT, company: OMIT, employee: OMIT, currency: OMIT, exchange_rate: OMIT, payment_term: OMIT, total_discount: OMIT, sub_total: OMIT, status: OMIT, total_tax_amount: OMIT, total_amount: OMIT, balance: OMIT, remote_updated_at: OMIT, tracking_categories: OMIT, accounting_period: OMIT, purchase_orders: OMIT, payments: OMIT, applied_payments: OMIT, line_items: OMIT, applied_credit_notes: OMIT, applied_vendor_credits: OMIT, inclusive_of_tax: OMIT, remote_was_deleted: OMIT, field_mappings: OMIT, remote_data: OMIT, remote_fields: OMIT, additional_properties: nil) ⇒ Merge::Accounting::Invoice
795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 795 def initialize(id: OMIT, remote_id: OMIT, created_at: OMIT, modified_at: OMIT, type: OMIT, contact: OMIT, number: OMIT, issue_date: OMIT, due_date: OMIT, paid_on_date: OMIT, memo: OMIT, company: OMIT, employee: OMIT, currency: OMIT, exchange_rate: OMIT, payment_term: OMIT, total_discount: OMIT, sub_total: OMIT, status: OMIT, total_tax_amount: OMIT, total_amount: OMIT, balance: OMIT, remote_updated_at: OMIT, tracking_categories: OMIT, accounting_period: OMIT, purchase_orders: OMIT, payments: OMIT, applied_payments: OMIT, line_items: OMIT, applied_credit_notes: OMIT, applied_vendor_credits: OMIT, inclusive_of_tax: OMIT, remote_was_deleted: OMIT, field_mappings: OMIT, remote_data: OMIT, remote_fields: OMIT, additional_properties: nil) @id = id if id != OMIT @remote_id = remote_id if remote_id != OMIT @created_at = created_at if created_at != OMIT @modified_at = modified_at if modified_at != OMIT @type = type if type != OMIT @contact = contact if contact != OMIT @number = number if number != OMIT @issue_date = issue_date if issue_date != OMIT @due_date = due_date if due_date != OMIT @paid_on_date = paid_on_date if paid_on_date != OMIT @memo = memo if memo != OMIT @company = company if company != OMIT @employee = employee if employee != OMIT @currency = currency if currency != OMIT @exchange_rate = exchange_rate if exchange_rate != OMIT @payment_term = payment_term if payment_term != OMIT @total_discount = total_discount if total_discount != OMIT @sub_total = sub_total if sub_total != OMIT @status = status if status != OMIT @total_tax_amount = total_tax_amount if total_tax_amount != OMIT @total_amount = total_amount if total_amount != OMIT @balance = balance if balance != OMIT @remote_updated_at = remote_updated_at if remote_updated_at != OMIT @tracking_categories = tracking_categories if tracking_categories != OMIT @accounting_period = accounting_period if accounting_period != OMIT @purchase_orders = purchase_orders if purchase_orders != OMIT @payments = payments if payments != OMIT @applied_payments = applied_payments if applied_payments != OMIT @line_items = line_items if line_items != OMIT @applied_credit_notes = applied_credit_notes if applied_credit_notes != OMIT @applied_vendor_credits = applied_vendor_credits if applied_vendor_credits != OMIT @inclusive_of_tax = inclusive_of_tax if inclusive_of_tax != OMIT @remote_was_deleted = remote_was_deleted if remote_was_deleted != OMIT @field_mappings = field_mappings if field_mappings != OMIT @remote_data = remote_data if remote_data != OMIT @remote_fields = remote_fields if remote_fields != OMIT @additional_properties = additional_properties @_field_set = { "id": id, "remote_id": remote_id, "created_at": created_at, "modified_at": modified_at, "type": type, "contact": contact, "number": number, "issue_date": issue_date, "due_date": due_date, "paid_on_date": paid_on_date, "memo": memo, "company": company, "employee": employee, "currency": currency, "exchange_rate": exchange_rate, "payment_term": payment_term, "total_discount": total_discount, "sub_total": sub_total, "status": status, "total_tax_amount": total_tax_amount, "total_amount": total_amount, "balance": balance, "remote_updated_at": remote_updated_at, "tracking_categories": tracking_categories, "accounting_period": accounting_period, "purchase_orders": purchase_orders, "payments": payments, "applied_payments": applied_payments, "line_items": line_items, "applied_credit_notes": applied_credit_notes, "applied_vendor_credits": applied_vendor_credits, "inclusive_of_tax": inclusive_of_tax, "remote_was_deleted": remote_was_deleted, "field_mappings": field_mappings, "remote_data": remote_data, "remote_fields": remote_fields }.reject do |_k, v| v == OMIT end end |
Instance Attribute Details
#accounting_period ⇒ Merge::Accounting::InvoiceAccountingPeriod (readonly)
Returns The accounting period that the Invoice was generated in.
400 401 402 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 400 def accounting_period @accounting_period end |
#additional_properties ⇒ OpenStruct (readonly)
Returns Additional properties unmapped to the current class definition.
429 430 431 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 429 def additional_properties @additional_properties end |
#applied_credit_notes ⇒ Array<Merge::Accounting::InvoiceAppliedCreditNotesItem> (readonly)
Returns ‘CreditNoteApplyLines` applied to the Invoice.
411 412 413 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 411 def applied_credit_notes @applied_credit_notes end |
#applied_payments ⇒ Array<Merge::Accounting::InvoiceAppliedPaymentsItem> (readonly)
Returns A list of the Payment Applied to Lines common models related to a given Invoice, Credit Note, or Journal Entry.
407 408 409 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 407 def applied_payments @applied_payments end |
#applied_vendor_credits ⇒ Array<Merge::Accounting::InvoiceAppliedVendorCreditsItem> (readonly)
Returns ‘VendorCreditApplyLines` applied to the Invoice.
413 414 415 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 413 def applied_vendor_credits @applied_vendor_credits end |
#balance ⇒ Float (readonly)
Returns The invoice’s remaining balance.
394 395 396 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 394 def balance @balance end |
#company ⇒ Merge::Accounting::InvoiceCompany (readonly)
Returns The company the invoice belongs to.
62 63 64 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 62 def company @company end |
#contact ⇒ Merge::Accounting::InvoiceContact (readonly)
Returns The invoice’s contact.
50 51 52 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 50 def contact @contact end |
#created_at ⇒ DateTime (readonly)
Returns The datetime that this object was created by Merge.
40 41 42 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 40 def created_at @created_at end |
#currency ⇒ Merge::Accounting::TransactionCurrencyEnum (readonly)
Returns The invoice’s currency.
-
‘XUA` - ADB Unit of Account
-
‘AFN` - Afghan Afghani
-
‘AFA` - Afghan Afghani (1927–2002)
-
‘ALL` - Albanian Lek
-
‘ALK` - Albanian Lek (1946–1965)
-
‘DZD` - Algerian Dinar
-
‘ADP` - Andorran Peseta
-
‘AOA` - Angolan Kwanza
-
‘AOK` - Angolan Kwanza (1977–1991)
-
‘AON` - Angolan New Kwanza (1990–2000)
-
‘AOR` - Angolan Readjusted Kwanza (1995–1999)
-
‘ARA` - Argentine Austral
-
‘ARS` - Argentine Peso
-
‘ARM` - Argentine Peso (1881–1970)
-
‘ARP` - Argentine Peso (1983–1985)
-
‘ARL` - Argentine Peso Ley (1970–1983)
-
‘AMD` - Armenian Dram
-
‘AWG` - Aruban Florin
-
‘AUD` - Australian Dollar
-
‘ATS` - Austrian Schilling
-
‘AZN` - Azerbaijani Manat
-
‘AZM` - Azerbaijani Manat (1993–2006)
-
‘BSD` - Bahamian Dollar
-
‘BHD` - Bahraini Dinar
-
‘BDT` - Bangladeshi Taka
-
‘BBD` - Barbadian Dollar
-
‘BYN` - Belarusian Ruble
-
‘BYB` - Belarusian Ruble (1994–1999)
-
‘BYR` - Belarusian Ruble (2000–2016)
-
‘BEF` - Belgian Franc
-
‘BEC` - Belgian Franc (convertible)
-
‘BEL` - Belgian Franc (financial)
-
‘BZD` - Belize Dollar
-
‘BMD` - Bermudan Dollar
-
‘BTN` - Bhutanese Ngultrum
-
‘BOB` - Bolivian Boliviano
-
‘BOL` - Bolivian Boliviano (1863–1963)
-
‘BOV` - Bolivian Mvdol
-
‘BOP` - Bolivian Peso
-
‘BAM` - Bosnia-Herzegovina Convertible Mark
-
‘BAD` - Bosnia-Herzegovina Dinar (1992–1994)
-
‘BAN` - Bosnia-Herzegovina New Dinar (1994–1997)
-
‘BWP` - Botswanan Pula
-
‘BRC` - Brazilian Cruzado (1986–1989)
-
‘BRZ` - Brazilian Cruzeiro (1942–1967)
-
‘BRE` - Brazilian Cruzeiro (1990–1993)
-
‘BRR` - Brazilian Cruzeiro (1993–1994)
-
‘BRN` - Brazilian New Cruzado (1989–1990)
-
‘BRB` - Brazilian New Cruzeiro (1967–1986)
-
‘BRL` - Brazilian Real
-
‘GBP` - British Pound
-
‘BND` - Brunei Dollar
-
‘BGL` - Bulgarian Hard Lev
-
‘BGN` - Bulgarian Lev
-
‘BGO` - Bulgarian Lev (1879–1952)
-
‘BGM` - Bulgarian Socialist Lev
-
‘BUK` - Burmese Kyat
-
‘BIF` - Burundian Franc
-
‘XPF` - CFP Franc
-
‘KHR` - Cambodian Riel
-
‘CAD` - Canadian Dollar
-
‘CVE` - Cape Verdean Escudo
-
‘KYD` - Cayman Islands Dollar
-
‘XAF` - Central African CFA Franc
-
‘CLE` - Chilean Escudo
-
‘CLP` - Chilean Peso
-
‘CLF` - Chilean Unit of Account (UF)
-
‘CNX` - Chinese People’s Bank Dollar
-
‘CNY` - Chinese Yuan
-
‘CNH` - Chinese Yuan (offshore)
-
‘COP` - Colombian Peso
-
‘COU` - Colombian Real Value Unit
-
‘KMF` - Comorian Franc
-
‘CDF` - Congolese Franc
-
‘CRC` - Costa Rican Colón
-
‘HRD` - Croatian Dinar
-
‘HRK` - Croatian Kuna
-
‘CUC` - Cuban Convertible Peso
-
‘CUP` - Cuban Peso
-
‘CYP` - Cypriot Pound
-
‘CZK` - Czech Koruna
-
‘CSK` - Czechoslovak Hard Koruna
-
‘DKK` - Danish Krone
-
‘DJF` - Djiboutian Franc
-
‘DOP` - Dominican Peso
-
‘NLG` - Dutch Guilder
-
‘XCD` - East Caribbean Dollar
-
‘DDM` - East German Mark
-
‘ECS` - Ecuadorian Sucre
-
‘ECV` - Ecuadorian Unit of Constant Value
-
‘EGP` - Egyptian Pound
-
‘GQE` - Equatorial Guinean Ekwele
-
‘ERN` - Eritrean Nakfa
-
‘EEK` - Estonian Kroon
-
‘ETB` - Ethiopian Birr
-
‘EUR` - Euro
-
‘XBA` - European Composite Unit
-
‘XEU` - European Currency Unit
-
‘XBB` - European Monetary Unit
-
‘XBC` - European Unit of Account (XBC)
-
‘XBD` - European Unit of Account (XBD)
-
‘FKP` - Falkland Islands Pound
-
‘FJD` - Fijian Dollar
-
‘FIM` - Finnish Markka
-
‘FRF` - French Franc
-
‘XFO` - French Gold Franc
-
‘XFU` - French UIC-Franc
-
‘GMD` - Gambian Dalasi
-
‘GEK` - Georgian Kupon Larit
-
‘GEL` - Georgian Lari
-
‘DEM` - German Mark
-
‘GHS` - Ghanaian Cedi
-
‘GHC` - Ghanaian Cedi (1979–2007)
-
‘GIP` - Gibraltar Pound
-
‘XAU` - Gold
-
‘GRD` - Greek Drachma
-
‘GTQ` - Guatemalan Quetzal
-
‘GWP` - Guinea-Bissau Peso
-
‘GNF` - Guinean Franc
-
‘GNS` - Guinean Syli
-
‘GYD` - Guyanaese Dollar
-
‘HTG` - Haitian Gourde
-
‘HNL` - Honduran Lempira
-
‘HKD` - Hong Kong Dollar
-
‘HUF` - Hungarian Forint
-
‘IMP` - IMP
-
‘ISK` - Icelandic Króna
-
‘ISJ` - Icelandic Króna (1918–1981)
-
‘INR` - Indian Rupee
-
‘IDR` - Indonesian Rupiah
-
‘IRR` - Iranian Rial
-
‘IQD` - Iraqi Dinar
-
‘IEP` - Irish Pound
-
‘ILS` - Israeli New Shekel
-
‘ILP` - Israeli Pound
-
‘ILR` - Israeli Shekel (1980–1985)
-
‘ITL` - Italian Lira
-
‘JMD` - Jamaican Dollar
-
‘JPY` - Japanese Yen
-
‘JOD` - Jordanian Dinar
-
‘KZT` - Kazakhstani Tenge
-
‘KES` - Kenyan Shilling
-
‘KWD` - Kuwaiti Dinar
-
‘KGS` - Kyrgystani Som
-
‘LAK` - Laotian Kip
-
‘LVL` - Latvian Lats
-
‘LVR` - Latvian Ruble
-
‘LBP` - Lebanese Pound
-
‘LSL` - Lesotho Loti
-
‘LRD` - Liberian Dollar
-
‘LYD` - Libyan Dinar
-
‘LTL` - Lithuanian Litas
-
‘LTT` - Lithuanian Talonas
-
‘LUL` - Luxembourg Financial Franc
-
‘LUC` - Luxembourgian Convertible Franc
-
‘LUF` - Luxembourgian Franc
-
‘MOP` - Macanese Pataca
-
‘MKD` - Macedonian Denar
-
‘MKN` - Macedonian Denar (1992–1993)
-
‘MGA` - Malagasy Ariary
-
‘MGF` - Malagasy Franc
-
‘MWK` - Malawian Kwacha
-
‘MYR` - Malaysian Ringgit
-
‘MVR` - Maldivian Rufiyaa
-
‘MVP` - Maldivian Rupee (1947–1981)
-
‘MLF` - Malian Franc
-
‘MTL` - Maltese Lira
-
‘MTP` - Maltese Pound
-
‘MRU` - Mauritanian Ouguiya
-
‘MRO` - Mauritanian Ouguiya (1973–2017)
-
‘MUR` - Mauritian Rupee
-
‘MXV` - Mexican Investment Unit
-
‘MXN` - Mexican Peso
-
‘MXP` - Mexican Silver Peso (1861–1992)
-
‘MDC` - Moldovan Cupon
-
‘MDL` - Moldovan Leu
-
‘MCF` - Monegasque Franc
-
‘MNT` - Mongolian Tugrik
-
‘MAD` - Moroccan Dirham
-
‘MAF` - Moroccan Franc
-
‘MZE` - Mozambican Escudo
-
‘MZN` - Mozambican Metical
-
‘MZM` - Mozambican Metical (1980–2006)
-
‘MMK` - Myanmar Kyat
-
‘NAD` - Namibian Dollar
-
‘NPR` - Nepalese Rupee
-
‘ANG` - Netherlands Antillean Guilder
-
‘TWD` - New Taiwan Dollar
-
‘NZD` - New Zealand Dollar
-
‘NIO` - Nicaraguan Córdoba
-
‘NIC` - Nicaraguan Córdoba (1988–1991)
-
‘NGN` - Nigerian Naira
-
‘KPW` - North Korean Won
-
‘NOK` - Norwegian Krone
-
‘OMR` - Omani Rial
-
‘PKR` - Pakistani Rupee
-
‘XPD` - Palladium
-
‘PAB` - Panamanian Balboa
-
‘PGK` - Papua New Guinean Kina
-
‘PYG` - Paraguayan Guarani
-
‘PEI` - Peruvian Inti
-
‘PEN` - Peruvian Sol
-
‘PES` - Peruvian Sol (1863–1965)
-
‘PHP` - Philippine Peso
-
‘XPT` - Platinum
-
‘PLN` - Polish Zloty
-
‘PLZ` - Polish Zloty (1950–1995)
-
‘PTE` - Portuguese Escudo
-
‘GWE` - Portuguese Guinea Escudo
-
‘QAR` - Qatari Rial
-
‘XRE` - RINET Funds
-
‘RHD` - Rhodesian Dollar
-
‘RON` - Romanian Leu
-
‘ROL` - Romanian Leu (1952–2006)
-
‘RUB` - Russian Ruble
-
‘RUR` - Russian Ruble (1991–1998)
-
‘RWF` - Rwandan Franc
-
‘SVC` - Salvadoran Colón
-
‘WST` - Samoan Tala
-
‘SAR` - Saudi Riyal
-
‘RSD` - Serbian Dinar
-
‘CSD` - Serbian Dinar (2002–2006)
-
‘SCR` - Seychellois Rupee
-
‘SLL` - Sierra Leonean Leone
-
‘XAG` - Silver
-
‘SGD` - Singapore Dollar
-
‘SKK` - Slovak Koruna
-
‘SIT` - Slovenian Tolar
-
‘SBD` - Solomon Islands Dollar
-
‘SOS` - Somali Shilling
-
‘ZAR` - South African Rand
-
‘ZAL` - South African Rand (financial)
-
‘KRH` - South Korean Hwan (1953–1962)
-
‘KRW` - South Korean Won
-
‘KRO` - South Korean Won (1945–1953)
-
‘SSP` - South Sudanese Pound
-
‘SUR` - Soviet Rouble
-
‘ESP` - Spanish Peseta
-
‘ESA` - Spanish Peseta (A account)
-
‘ESB` - Spanish Peseta (convertible account)
-
‘XDR` - Special Drawing Rights
-
‘LKR` - Sri Lankan Rupee
-
‘SHP` - St. Helena Pound
-
‘XSU` - Sucre
-
‘SDD` - Sudanese Dinar (1992–2007)
-
‘SDG` - Sudanese Pound
-
‘SDP` - Sudanese Pound (1957–1998)
-
‘SRD` - Surinamese Dollar
-
‘SRG` - Surinamese Guilder
-
‘SZL` - Swazi Lilangeni
-
‘SEK` - Swedish Krona
-
‘CHF` - Swiss Franc
-
‘SYP` - Syrian Pound
-
‘STN` - São Tomé & Príncipe Dobra
-
‘STD` - São Tomé & Príncipe Dobra (1977–2017)
-
‘TVD` - TVD
-
‘TJR` - Tajikistani Ruble
-
‘TJS` - Tajikistani Somoni
-
‘TZS` - Tanzanian Shilling
-
‘XTS` - Testing Currency Code
-
‘THB` - Thai Baht
-
‘XXX` - The codes assigned for transactions where no currency is involved
-
‘TPE` - Timorese Escudo
-
‘TOP` - Tongan Paʻanga
-
‘TTD` - Trinidad & Tobago Dollar
-
‘TND` - Tunisian Dinar
-
‘TRY` - Turkish Lira
-
‘TRL` - Turkish Lira (1922–2005)
-
‘TMT` - Turkmenistani Manat
-
‘TMM` - Turkmenistani Manat (1993–2009)
-
‘USD` - US Dollar
-
‘USN` - US Dollar (Next day)
-
‘USS` - US Dollar (Same day)
-
‘UGX` - Ugandan Shilling
-
‘UGS` - Ugandan Shilling (1966–1987)
-
‘UAH` - Ukrainian Hryvnia
-
‘UAK` - Ukrainian Karbovanets
-
‘AED` - United Arab Emirates Dirham
-
‘UYW` - Uruguayan Nominal Wage Index Unit
-
‘UYU` - Uruguayan Peso
-
‘UYP` - Uruguayan Peso (1975–1993)
-
‘UYI` - Uruguayan Peso (Indexed Units)
-
‘UZS` - Uzbekistani Som
-
‘VUV` - Vanuatu Vatu
-
‘VES` - Venezuelan Bolívar
-
‘VEB` - Venezuelan Bolívar (1871–2008)
-
‘VEF` - Venezuelan Bolívar (2008–2018)
-
‘VND` - Vietnamese Dong
-
‘VNN` - Vietnamese Dong (1978–1985)
-
‘CHE` - WIR Euro
-
‘CHW` - WIR Franc
-
‘XOF` - West African CFA Franc
-
‘YDD` - Yemeni Dinar
-
‘YER` - Yemeni Rial
-
‘YUN` - Yugoslavian Convertible Dinar (1990–1992)
-
‘YUD` - Yugoslavian Hard Dinar (1966–1990)
-
‘YUM` - Yugoslavian New Dinar (1994–2002)
-
‘YUR` - Yugoslavian Reformed Dinar (1992–1993)
-
‘ZWN` - ZWN
-
‘ZRN` - Zairean New Zaire (1993–1998)
-
‘ZRZ` - Zairean Zaire (1971–1993)
-
‘ZMW` - Zambian Kwacha
-
‘ZMK` - Zambian Kwacha (1968–2012)
-
‘ZWD` - Zimbabwean Dollar (1980–2008)
-
‘ZWR` - Zimbabwean Dollar (2008)
-
‘ZWL` - Zimbabwean Dollar (2009).
372 373 374 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 372 def currency @currency end |
#due_date ⇒ DateTime (readonly)
Returns The invoice’s due date.
56 57 58 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 56 def due_date @due_date end |
#employee ⇒ Merge::Accounting::InvoiceEmployee (readonly)
Returns The employee this overall transaction relates to.
64 65 66 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 64 def employee @employee end |
#exchange_rate ⇒ String (readonly)
Returns The invoice’s exchange rate.
374 375 376 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 374 def exchange_rate @exchange_rate end |
#field_mappings ⇒ Hash{String => Object} (readonly)
423 424 425 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 423 def field_mappings @field_mappings end |
#id ⇒ String (readonly)
36 37 38 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 36 def id @id end |
#inclusive_of_tax ⇒ Boolean (readonly)
Returns If the transaction is inclusive or exclusive of tax. ‘True` if inclusive, `False` if exclusive.
416 417 418 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 416 def inclusive_of_tax @inclusive_of_tax end |
#issue_date ⇒ DateTime (readonly)
Returns The invoice’s issue date.
54 55 56 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 54 def issue_date @issue_date end |
#line_items ⇒ Array<Merge::Accounting::InvoiceLineItem> (readonly)
409 410 411 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 409 def line_items @line_items end |
#memo ⇒ String (readonly)
Returns The invoice’s private note.
60 61 62 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 60 def memo @memo end |
#modified_at ⇒ DateTime (readonly)
Returns The datetime that this object was modified by Merge.
42 43 44 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 42 def modified_at @modified_at end |
#number ⇒ String (readonly)
Returns The invoice’s number.
52 53 54 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 52 def number @number end |
#paid_on_date ⇒ DateTime (readonly)
Returns The invoice’s paid date.
58 59 60 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 58 def paid_on_date @paid_on_date end |
#payment_term ⇒ Merge::Accounting::InvoicePaymentTerm (readonly)
Returns The payment term that applies to this transaction.
376 377 378 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 376 def payment_term @payment_term end |
#payments ⇒ Array<Merge::Accounting::InvoicePaymentsItem> (readonly)
Returns Array of ‘Payment` object IDs.
404 405 406 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 404 def payments @payments end |
#purchase_orders ⇒ Array<Merge::Accounting::InvoicePurchaseOrdersItem> (readonly)
402 403 404 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 402 def purchase_orders @purchase_orders end |
#remote_data ⇒ Array<Merge::Accounting::RemoteData> (readonly)
425 426 427 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 425 def remote_data @remote_data end |
#remote_fields ⇒ Array<Merge::Accounting::RemoteField> (readonly)
427 428 429 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 427 def remote_fields @remote_fields end |
#remote_id ⇒ String (readonly)
Returns The third-party API ID of the matching object.
38 39 40 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 38 def remote_id @remote_id end |
#remote_updated_at ⇒ DateTime (readonly)
Returns When the third party’s invoice entry was updated.
396 397 398 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 396 def remote_updated_at @remote_updated_at end |
#remote_was_deleted ⇒ Boolean (readonly)
Returns Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](docs.merge.dev/integrations/hris/supported-features/).
421 422 423 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 421 def remote_was_deleted @remote_was_deleted end |
#status ⇒ Merge::Accounting::InvoiceStatusEnum (readonly)
Returns The status of the invoice.
-
‘PAID` - PAID
-
‘DRAFT` - DRAFT
-
‘SUBMITTED` - SUBMITTED
-
‘PARTIALLY_PAID` - PARTIALLY_PAID
-
‘OPEN` - OPEN
-
‘VOID` - VOID.
388 389 390 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 388 def status @status end |
#sub_total ⇒ Float (readonly)
Returns The total amount being paid before taxes.
380 381 382 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 380 def sub_total @sub_total end |
#total_amount ⇒ Float (readonly)
Returns The invoice’s total amount.
392 393 394 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 392 def total_amount @total_amount end |
#total_discount ⇒ Float (readonly)
Returns The total discounts applied to the total cost.
378 379 380 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 378 def total_discount @total_discount end |
#total_tax_amount ⇒ Float (readonly)
Returns The total amount being paid in taxes.
390 391 392 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 390 def total_tax_amount @total_tax_amount end |
#tracking_categories ⇒ Array<Merge::Accounting::InvoiceTrackingCategoriesItem> (readonly)
398 399 400 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 398 def tracking_categories @tracking_categories end |
#type ⇒ Merge::Accounting::InvoiceTypeEnum (readonly)
Returns Whether the invoice is an accounts receivable or accounts payable. If ‘type` is `ACCOUNTS_PAYABLE`, the invoice is a bill. If `type` is `ACCOUNTS_RECEIVABLE`, it is an invoice.
-
‘ACCOUNTS_RECEIVABLE` - ACCOUNTS_RECEIVABLE
-
‘ACCOUNTS_PAYABLE` - ACCOUNTS_PAYABLE.
48 49 50 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 48 def type @type end |
Class Method Details
.from_json(json_object:) ⇒ Merge::Accounting::Invoice
Deserialize a JSON object to an instance of Invoice
880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 880 def self.from_json(json_object:) struct = JSON.parse(json_object, object_class: OpenStruct) parsed_json = JSON.parse(json_object) id = parsed_json["id"] remote_id = parsed_json["remote_id"] created_at = (DateTime.parse(parsed_json["created_at"]) unless parsed_json["created_at"].nil?) modified_at = (DateTime.parse(parsed_json["modified_at"]) unless parsed_json["modified_at"].nil?) type = parsed_json["type"] if parsed_json["contact"].nil? contact = nil else contact = parsed_json["contact"].to_json contact = Merge::Accounting::InvoiceContact.from_json(json_object: contact) end number = parsed_json["number"] issue_date = (DateTime.parse(parsed_json["issue_date"]) unless parsed_json["issue_date"].nil?) due_date = (DateTime.parse(parsed_json["due_date"]) unless parsed_json["due_date"].nil?) paid_on_date = (DateTime.parse(parsed_json["paid_on_date"]) unless parsed_json["paid_on_date"].nil?) memo = parsed_json["memo"] if parsed_json["company"].nil? company = nil else company = parsed_json["company"].to_json company = Merge::Accounting::InvoiceCompany.from_json(json_object: company) end if parsed_json["employee"].nil? employee = nil else employee = parsed_json["employee"].to_json employee = Merge::Accounting::InvoiceEmployee.from_json(json_object: employee) end currency = parsed_json["currency"] exchange_rate = parsed_json["exchange_rate"] if parsed_json["payment_term"].nil? payment_term = nil else payment_term = parsed_json["payment_term"].to_json payment_term = Merge::Accounting::InvoicePaymentTerm.from_json(json_object: payment_term) end total_discount = parsed_json["total_discount"] sub_total = parsed_json["sub_total"] status = parsed_json["status"] total_tax_amount = parsed_json["total_tax_amount"] total_amount = parsed_json["total_amount"] balance = parsed_json["balance"] remote_updated_at = unless parsed_json["remote_updated_at"].nil? DateTime.parse(parsed_json["remote_updated_at"]) end tracking_categories = parsed_json["tracking_categories"]&.map do |item| item = item.to_json Merge::Accounting::InvoiceTrackingCategoriesItem.from_json(json_object: item) end if parsed_json["accounting_period"].nil? accounting_period = nil else accounting_period = parsed_json["accounting_period"].to_json accounting_period = Merge::Accounting::InvoiceAccountingPeriod.from_json(json_object: accounting_period) end purchase_orders = parsed_json["purchase_orders"]&.map do |item| item = item.to_json Merge::Accounting::InvoicePurchaseOrdersItem.from_json(json_object: item) end payments = parsed_json["payments"]&.map do |item| item = item.to_json Merge::Accounting::InvoicePaymentsItem.from_json(json_object: item) end applied_payments = parsed_json["applied_payments"]&.map do |item| item = item.to_json Merge::Accounting::InvoiceAppliedPaymentsItem.from_json(json_object: item) end line_items = parsed_json["line_items"]&.map do |item| item = item.to_json Merge::Accounting::InvoiceLineItem.from_json(json_object: item) end applied_credit_notes = parsed_json["applied_credit_notes"]&.map do |item| item = item.to_json Merge::Accounting::InvoiceAppliedCreditNotesItem.from_json(json_object: item) end applied_vendor_credits = parsed_json["applied_vendor_credits"]&.map do |item| item = item.to_json Merge::Accounting::InvoiceAppliedVendorCreditsItem.from_json(json_object: item) end inclusive_of_tax = parsed_json["inclusive_of_tax"] remote_was_deleted = parsed_json["remote_was_deleted"] field_mappings = parsed_json["field_mappings"] remote_data = parsed_json["remote_data"]&.map do |item| item = item.to_json Merge::Accounting::RemoteData.from_json(json_object: item) end remote_fields = parsed_json["remote_fields"]&.map do |item| item = item.to_json Merge::Accounting::RemoteField.from_json(json_object: item) end new( id: id, remote_id: remote_id, created_at: created_at, modified_at: modified_at, type: type, contact: contact, number: number, issue_date: issue_date, due_date: due_date, paid_on_date: paid_on_date, memo: memo, company: company, employee: employee, currency: currency, exchange_rate: exchange_rate, payment_term: payment_term, total_discount: total_discount, sub_total: sub_total, status: status, total_tax_amount: total_tax_amount, total_amount: total_amount, balance: balance, remote_updated_at: remote_updated_at, tracking_categories: tracking_categories, accounting_period: accounting_period, purchase_orders: purchase_orders, payments: payments, applied_payments: applied_payments, line_items: line_items, applied_credit_notes: applied_credit_notes, applied_vendor_credits: applied_vendor_credits, inclusive_of_tax: inclusive_of_tax, remote_was_deleted: remote_was_deleted, field_mappings: field_mappings, remote_data: remote_data, remote_fields: remote_fields, additional_properties: struct ) end |
.validate_raw(obj:) ⇒ Void
Leveraged for Union-type generation, validate_raw attempts to parse the given
hash and check each fields type against the current object's property
definitions.
1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 1027 def self.validate_raw(obj:) obj.id&.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.") obj.remote_id&.is_a?(String) != false || raise("Passed value for field obj.remote_id is not the expected type, validation failed.") obj.created_at&.is_a?(DateTime) != false || raise("Passed value for field obj.created_at is not the expected type, validation failed.") obj.modified_at&.is_a?(DateTime) != false || raise("Passed value for field obj.modified_at is not the expected type, validation failed.") obj.type&.is_a?(Merge::Accounting::InvoiceTypeEnum) != false || raise("Passed value for field obj.type is not the expected type, validation failed.") obj.contact.nil? || Merge::Accounting::InvoiceContact.validate_raw(obj: obj.contact) obj.number&.is_a?(String) != false || raise("Passed value for field obj.number is not the expected type, validation failed.") obj.issue_date&.is_a?(DateTime) != false || raise("Passed value for field obj.issue_date is not the expected type, validation failed.") obj.due_date&.is_a?(DateTime) != false || raise("Passed value for field obj.due_date is not the expected type, validation failed.") obj.paid_on_date&.is_a?(DateTime) != false || raise("Passed value for field obj.paid_on_date is not the expected type, validation failed.") obj.memo&.is_a?(String) != false || raise("Passed value for field obj.memo is not the expected type, validation failed.") obj.company.nil? || Merge::Accounting::InvoiceCompany.validate_raw(obj: obj.company) obj.employee.nil? || Merge::Accounting::InvoiceEmployee.validate_raw(obj: obj.employee) obj.currency&.is_a?(Merge::Accounting::TransactionCurrencyEnum) != false || raise("Passed value for field obj.currency is not the expected type, validation failed.") obj.exchange_rate&.is_a?(String) != false || raise("Passed value for field obj.exchange_rate is not the expected type, validation failed.") obj.payment_term.nil? || Merge::Accounting::InvoicePaymentTerm.validate_raw(obj: obj.payment_term) obj.total_discount&.is_a?(Float) != false || raise("Passed value for field obj.total_discount is not the expected type, validation failed.") obj.sub_total&.is_a?(Float) != false || raise("Passed value for field obj.sub_total is not the expected type, validation failed.") obj.status&.is_a?(Merge::Accounting::InvoiceStatusEnum) != false || raise("Passed value for field obj.status is not the expected type, validation failed.") obj.total_tax_amount&.is_a?(Float) != false || raise("Passed value for field obj.total_tax_amount is not the expected type, validation failed.") obj.total_amount&.is_a?(Float) != false || raise("Passed value for field obj.total_amount is not the expected type, validation failed.") obj.balance&.is_a?(Float) != false || raise("Passed value for field obj.balance is not the expected type, validation failed.") obj.remote_updated_at&.is_a?(DateTime) != false || raise("Passed value for field obj.remote_updated_at is not the expected type, validation failed.") obj.tracking_categories&.is_a?(Array) != false || raise("Passed value for field obj.tracking_categories is not the expected type, validation failed.") obj.accounting_period.nil? || Merge::Accounting::InvoiceAccountingPeriod.validate_raw(obj: obj.accounting_period) obj.purchase_orders&.is_a?(Array) != false || raise("Passed value for field obj.purchase_orders is not the expected type, validation failed.") obj.payments&.is_a?(Array) != false || raise("Passed value for field obj.payments is not the expected type, validation failed.") obj.applied_payments&.is_a?(Array) != false || raise("Passed value for field obj.applied_payments is not the expected type, validation failed.") obj.line_items&.is_a?(Array) != false || raise("Passed value for field obj.line_items is not the expected type, validation failed.") obj.applied_credit_notes&.is_a?(Array) != false || raise("Passed value for field obj.applied_credit_notes is not the expected type, validation failed.") obj.applied_vendor_credits&.is_a?(Array) != false || raise("Passed value for field obj.applied_vendor_credits is not the expected type, validation failed.") obj.inclusive_of_tax&.is_a?(Boolean) != false || raise("Passed value for field obj.inclusive_of_tax is not the expected type, validation failed.") obj.remote_was_deleted&.is_a?(Boolean) != false || raise("Passed value for field obj.remote_was_deleted is not the expected type, validation failed.") obj.field_mappings&.is_a?(Hash) != false || raise("Passed value for field obj.field_mappings is not the expected type, validation failed.") obj.remote_data&.is_a?(Array) != false || raise("Passed value for field obj.remote_data is not the expected type, validation failed.") obj.remote_fields&.is_a?(Array) != false || raise("Passed value for field obj.remote_fields is not the expected type, validation failed.") end |
Instance Method Details
#to_json(*_args) ⇒ String
Serialize an instance of Invoice to a JSON object
1017 1018 1019 |
# File 'lib/merge_ruby_client/accounting/types/invoice.rb', line 1017 def to_json(*_args) @_field_set&.to_json end |