merge_ruby_client 0.0.1

data/lib/merge_ruby_client/accounting/types/invoice_request.rb

@@ -0,0 +1,847 @@
+# frozen_string_literal: true
+
+require_relative "invoice_type_enum"
+require_relative "invoice_request_contact"
+require "date"
+require_relative "invoice_status_enum"
+require_relative "invoice_request_company"
+require_relative "currency_enum"
+require_relative "invoice_request_payments_item"
+require_relative "invoice_request_tracking_categories_item"
+require_relative "invoice_line_item_request"
+require_relative "invoice_request_purchase_orders_item"
+require "json"
+
+module Merge
+  module Accounting
+    # # The Invoice Object
+    #
+    #     ### Description
+    #     The `Invoice` object represents an itemized record of goods and/or services sold to a customer.
+    #
+    # If type = accounts_payable `Invoice` is a bill, if type = accounts_receivable it's an invoice.
+    #
+    #     ### Usage Example
+    #     Fetch from the `LIST Invoices` endpoint and view a company's invoices.
+    class InvoiceRequest
+      attr_reader :type, :contact, :number, :issue_date, :due_date, :paid_on_date, :memo, :status, :company, :currency,
+                  :exchange_rate, :total_discount, :sub_total, :total_tax_amount, :total_amount, :balance, :payments, :tracking_categories, :line_items, :purchase_orders, :integration_params, :linked_account_params, :additional_properties
+
+      # @param type [INVOICE_TYPE_ENUM] 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
+      # @param contact [Accounting::InvoiceRequestContact] The invoice's contact.
+      # @param number [String] The invoice's number.
+      # @param issue_date [DateTime] The invoice's issue date.
+      # @param due_date [DateTime] The invoice's due date.
+      # @param paid_on_date [DateTime] The invoice's paid date.
+      # @param memo [String] The invoice's private note.
+      # @param status [INVOICE_STATUS_ENUM] The status of the invoice.
+      #   - `PAID` - PAID
+      #   - `DRAFT` - DRAFT
+      #   - `SUBMITTED` - SUBMITTED
+      #   - `PARTIALLY_PAID` - PARTIALLY_PAID
+      #   - `OPEN` - OPEN
+      #   - `VOID` - VOID
+      # @param company [Accounting::InvoiceRequestCompany] The company the invoice belongs to.
+      # @param currency [CURRENCY_ENUM] 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)
+      # @param exchange_rate [String] The invoice's exchange rate.
+      # @param total_discount [Float] The total discounts applied to the total cost.
+      # @param sub_total [Float] The total amount being paid before taxes.
+      # @param total_tax_amount [Float] The total amount being paid in taxes.
+      # @param total_amount [Float] The invoice's total amount.
+      # @param balance [Float] The invoice's remaining balance.
+      # @param payments [Array<Accounting::InvoiceRequestPaymentsItem>] Array of `Payment` object IDs.
+      # @param tracking_categories [Array<Accounting::InvoiceRequestTrackingCategoriesItem>]
+      # @param line_items [Array<Accounting::InvoiceLineItemRequest>]
+      # @param purchase_orders [Array<Accounting::InvoiceRequestPurchaseOrdersItem>]
+      # @param integration_params [Hash{String => String}]
+      # @param linked_account_params [Hash{String => String}]
+      # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+      # @return [Accounting::InvoiceRequest]
+      def initialize(type: nil, contact: nil, number: nil, issue_date: nil, due_date: nil, paid_on_date: nil,
+                     memo: nil, status: nil, company: nil, currency: nil, exchange_rate: nil, total_discount: nil, sub_total: nil, total_tax_amount: nil, total_amount: nil, balance: nil, payments: nil, tracking_categories: nil, line_items: nil, purchase_orders: nil, integration_params: nil, linked_account_params: nil, additional_properties: nil)
+        # @type [INVOICE_TYPE_ENUM] 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
+        @type = type
+        # @type [Accounting::InvoiceRequestContact] The invoice's contact.
+        @contact = contact
+        # @type [String] The invoice's number.
+        @number = number
+        # @type [DateTime] The invoice's issue date.
+        @issue_date = issue_date
+        # @type [DateTime] The invoice's due date.
+        @due_date = due_date
+        # @type [DateTime] The invoice's paid date.
+        @paid_on_date = paid_on_date
+        # @type [String] The invoice's private note.
+        @memo = memo
+        # @type [INVOICE_STATUS_ENUM] The status of the invoice.
+        #   - `PAID` - PAID
+        #   - `DRAFT` - DRAFT
+        #   - `SUBMITTED` - SUBMITTED
+        #   - `PARTIALLY_PAID` - PARTIALLY_PAID
+        #   - `OPEN` - OPEN
+        #   - `VOID` - VOID
+        @status = status
+        # @type [Accounting::InvoiceRequestCompany] The company the invoice belongs to.
+        @company = company
+        # @type [CURRENCY_ENUM] 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)
+        @currency = currency
+        # @type [String] The invoice's exchange rate.
+        @exchange_rate = exchange_rate
+        # @type [Float] The total discounts applied to the total cost.
+        @total_discount = total_discount
+        # @type [Float] The total amount being paid before taxes.
+        @sub_total = sub_total
+        # @type [Float] The total amount being paid in taxes.
+        @total_tax_amount = total_tax_amount
+        # @type [Float] The invoice's total amount.
+        @total_amount = total_amount
+        # @type [Float] The invoice's remaining balance.
+        @balance = balance
+        # @type [Array<Accounting::InvoiceRequestPaymentsItem>] Array of `Payment` object IDs.
+        @payments = payments
+        # @type [Array<Accounting::InvoiceRequestTrackingCategoriesItem>]
+        @tracking_categories = tracking_categories
+        # @type [Array<Accounting::InvoiceLineItemRequest>]
+        @line_items = line_items
+        # @type [Array<Accounting::InvoiceRequestPurchaseOrdersItem>]
+        @purchase_orders = purchase_orders
+        # @type [Hash{String => String}]
+        @integration_params = integration_params
+        # @type [Hash{String => String}]
+        @linked_account_params = linked_account_params
+        # @type [OpenStruct] Additional properties unmapped to the current class definition
+        @additional_properties = additional_properties
+      end
+
+      # Deserialize a JSON object to an instance of InvoiceRequest
+      #
+      # @param json_object [JSON]
+      # @return [Accounting::InvoiceRequest]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        parsed_json = JSON.parse(json_object)
+        type = Accounting::INVOICE_TYPE_ENUM.key(parsed_json["type"]) || parsed_json["type"]
+        if parsed_json["contact"].nil?
+          contact = nil
+        else
+          contact = parsed_json["contact"].to_json
+          contact = Accounting::InvoiceRequestContact.from_json(json_object: contact)
+        end
+        number = struct.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 = struct.memo
+        status = Accounting::INVOICE_STATUS_ENUM.key(parsed_json["status"]) || parsed_json["status"]
+        if parsed_json["company"].nil?
+          company = nil
+        else
+          company = parsed_json["company"].to_json
+          company = Accounting::InvoiceRequestCompany.from_json(json_object: company)
+        end
+        currency = Accounting::CURRENCY_ENUM.key(parsed_json["currency"]) || parsed_json["currency"]
+        exchange_rate = struct.exchange_rate
+        total_discount = struct.total_discount
+        sub_total = struct.sub_total
+        total_tax_amount = struct.total_tax_amount
+        total_amount = struct.total_amount
+        balance = struct.balance
+        payments = parsed_json["payments"]&.map do |v|
+          v = v.to_json
+          Accounting::InvoiceRequestPaymentsItem.from_json(json_object: v)
+        end
+        tracking_categories = parsed_json["tracking_categories"]&.map do |v|
+          v = v.to_json
+          Accounting::InvoiceRequestTrackingCategoriesItem.from_json(json_object: v)
+        end
+        line_items = parsed_json["line_items"]&.map do |v|
+          v = v.to_json
+          Accounting::InvoiceLineItemRequest.from_json(json_object: v)
+        end
+        purchase_orders = parsed_json["purchase_orders"]&.map do |v|
+          v = v.to_json
+          Accounting::InvoiceRequestPurchaseOrdersItem.from_json(json_object: v)
+        end
+        integration_params = struct.integration_params
+        linked_account_params = struct.linked_account_params
+        new(type: type, contact: contact, number: number, issue_date: issue_date, due_date: due_date,
+            paid_on_date: paid_on_date, memo: memo, status: status, company: company, currency: currency, exchange_rate: exchange_rate, total_discount: total_discount, sub_total: sub_total, total_tax_amount: total_tax_amount, total_amount: total_amount, balance: balance, payments: payments, tracking_categories: tracking_categories, line_items: line_items, purchase_orders: purchase_orders, integration_params: integration_params, linked_account_params: linked_account_params, additional_properties: struct)
+      end
+
+      # Serialize an instance of InvoiceRequest to a JSON object
+      #
+      # @return [JSON]
+      def to_json(*_args)
+        {
+          "type": Accounting::INVOICE_TYPE_ENUM[@type] || @type,
+          "contact": @contact,
+          "number": @number,
+          "issue_date": @issue_date,
+          "due_date": @due_date,
+          "paid_on_date": @paid_on_date,
+          "memo": @memo,
+          "status": Accounting::INVOICE_STATUS_ENUM[@status] || @status,
+          "company": @company,
+          "currency": Accounting::CURRENCY_ENUM[@currency] || @currency,
+          "exchange_rate": @exchange_rate,
+          "total_discount": @total_discount,
+          "sub_total": @sub_total,
+          "total_tax_amount": @total_tax_amount,
+          "total_amount": @total_amount,
+          "balance": @balance,
+          "payments": @payments,
+          "tracking_categories": @tracking_categories,
+          "line_items": @line_items,
+          "purchase_orders": @purchase_orders,
+          "integration_params": @integration_params,
+          "linked_account_params": @linked_account_params
+        }.to_json
+      end
+
+      # 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.
+      #
+      # @param obj [Object]
+      # @return [Void]
+      def self.validate_raw(obj:)
+        obj.type&.is_a?(Accounting::INVOICE_TYPE_ENUM) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+        obj.contact.nil? || Accounting::InvoiceRequestContact.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.status&.is_a?(Accounting::INVOICE_STATUS_ENUM) != false || raise("Passed value for field obj.status is not the expected type, validation failed.")
+        obj.company.nil? || Accounting::InvoiceRequestCompany.validate_raw(obj: obj.company)
+        obj.currency&.is_a?(Accounting::CURRENCY_ENUM) != 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.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.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.payments&.is_a?(Array) != false || raise("Passed value for field obj.payments 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.line_items&.is_a?(Array) != false || raise("Passed value for field obj.line_items is not the expected type, validation failed.")
+        obj.purchase_orders&.is_a?(Array) != false || raise("Passed value for field obj.purchase_orders is not the expected type, validation failed.")
+        obj.integration_params&.is_a?(Hash) != false || raise("Passed value for field obj.integration_params is not the expected type, validation failed.")
+        obj.linked_account_params&.is_a?(Hash) != false || raise("Passed value for field obj.linked_account_params is not the expected type, validation failed.")
+      end
+    end
+  end
+end