Class: EInvoiceAPI::Models::DocumentCreate

Inherits:

Internal::Type::BaseModel

• Object
• Internal::Type::BaseModel
• EInvoiceAPI::Models::DocumentCreate

Defined in:

lib/e_invoice_api/models/document_create.rb

Direct Known Subclasses

DocumentCreateParams, ValidateValidateJsonParams

Defined Under Namespace

Modules: AmountDue, InvoiceTotal, PreviousUnpaidBalance, Subtotal, TaxCode, TotalDiscount, TotalTax, Vatex Classes: Allowance, Charge, Item, TaxDetail

Instance Attribute Summary

• #allowances ⇒ Array<EInvoiceAPI::Models::DocumentCreate::Allowance>^?
• #amount_due ⇒ Float, ...

  The amount due for payment.

• #attachments ⇒ Array<EInvoiceAPI::Models::DocumentAttachmentCreate>^?
• #billing_address ⇒ String^?

  The billing address (if different from customer address).

• #billing_address_recipient ⇒ String^?

  The recipient name at the billing address.

• #charges ⇒ Array<EInvoiceAPI::Models::DocumentCreate::Charge>^?
• #currency ⇒ Symbol, ...

  Currency of the invoice (ISO 4217 currency code).

• #customer_address ⇒ String^?

  The address of the customer/buyer.

• #customer_address_recipient ⇒ String^?

  The recipient name at the customer address.

• #customer_company_id ⇒ String^?

  Customer company ID.

• #customer_email ⇒ String^?

  The email address of the customer.

• #customer_id ⇒ String^?

  The unique identifier for the customer in your system.

• #customer_name ⇒ String^?

  The company name of the customer/buyer.

• #customer_tax_id ⇒ String^?

  Customer tax ID.

• #direction ⇒ Symbol, ...

  The direction of the document: INBOUND (purchases) or OUTBOUND (sales).

• #document_type ⇒ Symbol, ...

  The type of document: INVOICE, CREDIT_NOTE, or DEBIT_NOTE.

• #due_date ⇒ Date^?

  The date when payment is due.

• #invoice_date ⇒ Date^?

  The date when the invoice was issued.

• #invoice_id ⇒ String^?

  The unique invoice identifier/number.

• #invoice_total ⇒ Float, ...

  The total amount of the invoice including tax (invoice_total = subtotal + total_tax + total_discount).

• #items ⇒ Array<EInvoiceAPI::Models::DocumentCreate::Item>^?

  At least one line item is required.

• #note ⇒ String^?

  Additional notes or comments for the invoice.

• #payment_details ⇒ Array<EInvoiceAPI::Models::PaymentDetailCreate>^?
• #payment_term ⇒ String^?

  The payment terms (e.g., ‘Net 30’, ‘Due on receipt’, ‘2/10 Net 30’).

• #previous_unpaid_balance ⇒ Float, ...

  The previous unpaid balance from prior invoices, if any.

• #purchase_order ⇒ String^?

  The purchase order reference number.

• #remittance_address ⇒ String^?

  The address where payment should be sent or remitted to.

• #remittance_address_recipient ⇒ String^?

  The recipient name at the remittance address.

• #service_address ⇒ String^?

  The address where services were performed or goods were delivered.

• #service_address_recipient ⇒ String^?

  The recipient name at the service address.

• #service_end_date ⇒ Date^?

  The end date of the service period or delivery period.

• #service_start_date ⇒ Date^?

  The start date of the service period or delivery period.

• #shipping_address ⇒ String^?

  The shipping/delivery address.

• #shipping_address_recipient ⇒ String^?

  The recipient name at the shipping address.

• #state ⇒ Symbol, ...

  The current state of the document: DRAFT, TRANSIT, FAILED, SENT, or RECEIVED.

• #subtotal ⇒ Float, ...

  The taxable base of the invoice.

• #tax_code ⇒ Symbol, ...

  Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E for exempt).

• #tax_details ⇒ Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>^?
• #total_discount ⇒ Float, ...

  The net financial discount/charge of the invoice (non-VAT charges minus non-VAT allowances).

• #total_tax ⇒ Float, ...

  The total tax amount of the invoice.

• #vatex ⇒ Symbol, ...

  VATEX code list for VAT exemption reasons.

• #vatex_note ⇒ String^?

  Textual explanation for VAT exemption.

• #vendor_address ⇒ String^?

  The address of the vendor/seller.

• #vendor_address_recipient ⇒ String^?

  The recipient name at the vendor address.

• #vendor_company_id ⇒ String^?

  Vendor company ID.

• #vendor_email ⇒ String^?

  The email address of the vendor.

• #vendor_name ⇒ String^?

  The name of the vendor/seller/supplier.

• #vendor_tax_id ⇒ String^?

  Vendor tax ID.

Class Method Summary

• .values ⇒ Array<Symbol>
• .variants ⇒ Array(Float, String)

Methods inherited from Internal::Type::BaseModel

#==, ==, #[], coerce, #deconstruct_keys, #deep_to_h, dump, fields, hash, #hash, inherited, #initialize, 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

This class inherits a constructor from EInvoiceAPI::Internal::Type::BaseModel

Instance Attribute Details

#allowances ⇒ Array<EInvoiceAPI::Models::DocumentCreate::Allowance>^?

Returns:

• (Array<EInvoiceAPI::Models::DocumentCreate::Allowance>, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 9

optional :allowances,
-> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::DocumentCreate::Allowance] },
nil?: true

#amount_due ⇒ Float, ...

The amount due for payment. Must be positive and rounded to maximum 2 decimals

Returns:

• (Float, String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 17

optional :amount_due, union: -> { EInvoiceAPI::DocumentCreate::AmountDue }, nil?: true

#attachments ⇒ Array<EInvoiceAPI::Models::DocumentAttachmentCreate>^?

Returns:

• (Array<EInvoiceAPI::Models::DocumentAttachmentCreate>, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 22

optional :attachments,
-> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::DocumentAttachmentCreate] },
nil?: true

#billing_address ⇒ String^?

The billing address (if different from customer address)

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 30

optional :billing_address, String, nil?: true

#billing_address_recipient ⇒ String^?

The recipient name at the billing address

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 36

optional :billing_address_recipient, String, nil?: true

#charges ⇒ Array<EInvoiceAPI::Models::DocumentCreate::Charge>^?

Returns:

• (Array<EInvoiceAPI::Models::DocumentCreate::Charge>, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 41

optional :charges,
-> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::DocumentCreate::Charge] },
nil?: true

#currency ⇒ Symbol, ...

Currency of the invoice (ISO 4217 currency code)

Returns:

• (Symbol, EInvoiceAPI::Models::CurrencyCode, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 49

optional :currency, enum: -> { EInvoiceAPI::CurrencyCode }

#customer_address ⇒ String^?

The address of the customer/buyer

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 55

optional :customer_address, String, nil?: true

#customer_address_recipient ⇒ String^?

The recipient name at the customer address

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 61

optional :customer_address_recipient, String, nil?: true

#customer_company_id ⇒ String^?

Customer company ID. For Belgium this is the CBE number or their EUID (European Unique Identifier) number. In the Netherlands this is the KVK number.

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 68

optional :customer_company_id, String, nil?: true

#customer_email ⇒ String^?

The email address of the customer

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 74

optional :customer_email, String, nil?: true

#customer_id ⇒ String^?

The unique identifier for the customer in your system

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 80

optional :customer_id, String, nil?: true

#customer_name ⇒ String^?

The company name of the customer/buyer

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 86

optional :customer_name, String, nil?: true

#customer_tax_id ⇒ String^?

Customer tax ID. For Belgium this is the VAT number. Must include the country prefix

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 93

optional :customer_tax_id, String, nil?: true

#direction ⇒ Symbol, ...

The direction of the document: INBOUND (purchases) or OUTBOUND (sales)

Returns:

• (Symbol, EInvoiceAPI::Models::DocumentDirection, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 99

optional :direction, enum: -> { EInvoiceAPI::DocumentDirection }

#document_type ⇒ Symbol, ...

The type of document: INVOICE, CREDIT_NOTE, or DEBIT_NOTE

Returns:

• (Symbol, EInvoiceAPI::Models::DocumentType, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 105

optional :document_type, enum: -> { EInvoiceAPI::DocumentType }

#due_date ⇒ Date^?

The date when payment is due

Returns:

• (Date, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 111

optional :due_date, Date, nil?: true

#invoice_date ⇒ Date^?

The date when the invoice was issued

Returns:

• (Date, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 117

optional :invoice_date, Date, nil?: true

#invoice_id ⇒ String^?

The unique invoice identifier/number

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 123

optional :invoice_id, String, nil?: true

#invoice_total ⇒ Float, ...

The total amount of the invoice including tax (invoice_total = subtotal + total_tax + total_discount). Must be positive and rounded to maximum 2 decimals

Returns:

• (Float, String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 130

optional :invoice_total, union: -> { EInvoiceAPI::DocumentCreate::InvoiceTotal }, nil?: true

#items ⇒ Array<EInvoiceAPI::Models::DocumentCreate::Item>^?

At least one line item is required

Returns:

• (Array<EInvoiceAPI::Models::DocumentCreate::Item>, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 136

optional :items, -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::DocumentCreate::Item] }

#note ⇒ String^?

Additional notes or comments for the invoice

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 142

optional :note, String, nil?: true

#payment_details ⇒ Array<EInvoiceAPI::Models::PaymentDetailCreate>^?

Returns:

• (Array<EInvoiceAPI::Models::PaymentDetailCreate>, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 147

optional :payment_details,
-> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::PaymentDetailCreate] },
nil?: true

#payment_term ⇒ String^?

The payment terms (e.g., ‘Net 30’, ‘Due on receipt’, ‘2/10 Net 30’)

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 155

optional :payment_term, String, nil?: true

#previous_unpaid_balance ⇒ Float, ...

The previous unpaid balance from prior invoices, if any. Must be positive and rounded to maximum 2 decimals

Returns:

• (Float, String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 162

optional :previous_unpaid_balance,
union: -> { EInvoiceAPI::DocumentCreate::PreviousUnpaidBalance },
nil?: true

#purchase_order ⇒ String^?

The purchase order reference number

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 170

optional :purchase_order, String, nil?: true

#remittance_address ⇒ String^?

The address where payment should be sent or remitted to

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 176

optional :remittance_address, String, nil?: true

#remittance_address_recipient ⇒ String^?

The recipient name at the remittance address

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 182

optional :remittance_address_recipient, String, nil?: true

#service_address ⇒ String^?

The address where services were performed or goods were delivered

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 188

optional :service_address, String, nil?: true

#service_address_recipient ⇒ String^?

The recipient name at the service address

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 194

optional :service_address_recipient, String, nil?: true

#service_end_date ⇒ Date^?

The end date of the service period or delivery period

Returns:

• (Date, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 200

optional :service_end_date, Date, nil?: true

#service_start_date ⇒ Date^?

The start date of the service period or delivery period

Returns:

• (Date, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 206

optional :service_start_date, Date, nil?: true

#shipping_address ⇒ String^?

The shipping/delivery address

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 212

optional :shipping_address, String, nil?: true

#shipping_address_recipient ⇒ String^?

The recipient name at the shipping address

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 218

optional :shipping_address_recipient, String, nil?: true

#state ⇒ Symbol, ...

The current state of the document: DRAFT, TRANSIT, FAILED, SENT, or RECEIVED

Returns:

• (Symbol, EInvoiceAPI::Models::DocumentState, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 224

optional :state, enum: -> { EInvoiceAPI::DocumentState }

#subtotal ⇒ Float, ...

The taxable base of the invoice. Should be the sum of all line items - allowances (for example commercial discounts) + charges with impact on VAT. Must be positive and rounded to maximum 2 decimals

Returns:

• (Float, String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 232

optional :subtotal, union: -> { EInvoiceAPI::DocumentCreate::Subtotal }, nil?: true

#tax_code ⇒ Symbol, ...

Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E for exempt)

Returns:

• (Symbol, EInvoiceAPI::Models::DocumentCreate::TaxCode, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 239

optional :tax_code, enum: -> { EInvoiceAPI::DocumentCreate::TaxCode }

#tax_details ⇒ Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>^?

Returns:

• (Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 244

optional :tax_details,
-> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::DocumentCreate::TaxDetail] },
nil?: true

#total_discount ⇒ Float, ...

The net financial discount/charge of the invoice (non-VAT charges minus non-VAT allowances). Can be positive (net charge), negative (net discount), or zero. Must be rounded to maximum 2 decimals

Returns:

• (Float, String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 254

optional :total_discount, union: -> { EInvoiceAPI::DocumentCreate::TotalDiscount }, nil?: true

#total_tax ⇒ Float, ...

The total tax amount of the invoice. Must be positive and rounded to maximum 2 decimals

Returns:

• (Float, String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 261

optional :total_tax, union: -> { EInvoiceAPI::DocumentCreate::TotalTax }, nil?: true

#vatex ⇒ Symbol, ...

VATEX code list for VAT exemption reasons

Agency: CEF Identifier: vatex

Returns:

• (Symbol, EInvoiceAPI::Models::DocumentCreate::Vatex, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 269

optional :vatex, enum: -> { EInvoiceAPI::DocumentCreate::Vatex }, nil?: true

#vatex_note ⇒ String^?

Textual explanation for VAT exemption

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 275

optional :vatex_note, String, nil?: true

#vendor_address ⇒ String^?

The address of the vendor/seller

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 281

optional :vendor_address, String, nil?: true

#vendor_address_recipient ⇒ String^?

The recipient name at the vendor address

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 287

optional :vendor_address_recipient, String, nil?: true

#vendor_company_id ⇒ String^?

Vendor company ID. For Belgium this is the CBE number or their EUID (European Unique Identifier) number. In the Netherlands this is the KVK number.

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 294

optional :vendor_company_id, String, nil?: true

#vendor_email ⇒ String^?

The email address of the vendor

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 300

optional :vendor_email, String, nil?: true

#vendor_name ⇒ String^?

The name of the vendor/seller/supplier

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 306

optional :vendor_name, String, nil?: true

#vendor_tax_id ⇒ String^?

Vendor tax ID. For Belgium this is the VAT number. Must include the country prefix

Returns:

• (String, nil)

# File 'lib/e_invoice_api/models/document_create.rb', line 313

optional :vendor_tax_id, String, nil?: true

Class Method Details

.values ⇒ Array<Symbol>

Returns:

• (Array<Symbol>)

# File 'lib/e_invoice_api/models/document_create.rb', line 1732

.variants ⇒ Array(Float, String)

Returns:

• (Array(Float, String))

# File 'lib/e_invoice_api/models/document_create.rb', line 591