# Invoice

Editable semantic invoice shared by XML writers and presentation adapters.

Class 

`OfficeIMO.Invoicing`

**Namespace**

`OfficeIMO.Invoicing`

**Assembly**

`OfficeIMO.Invoicing`

**Source revision**

`ba882f6b0d07` with working tree changes

**Source**

[Invoice.cs:29](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L29)

**Modifiers**

sealed

Editable semantic invoice shared by XML writers and presentation adapters.

## Inheritance

- object
- Invoice

## Usage

Explore 10 API references to this type

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

### Returned or exposed by 2

- Property [Fa3InvoiceReadResult.Invoice](/api/invoicing/officeimo-invoicing-fa3invoicereadresult/#property-invoice)
- Property [InvoiceReadResult.Invoice](/api/invoicing/officeimo-invoicing-invoicereadresult/#property-invoice)

### Accepted by parameters 8

- Method [Fa3InvoiceWriter.Inspect](/api/invoicing/officeimo-invoicing-fa3invoicewriter/#method-inspect-officeimo-invoicing-invoice-officeimo-invoicing-fa3invoicewriteoptions) parameter `invoice`
- Method [Fa3InvoiceWriter.Write](/api/invoicing/officeimo-invoicing-fa3invoicewriter/#method-write-officeimo-invoicing-invoice-officeimo-invoicing-fa3invoicewriteoptions) parameter `invoice`
- Method [InvoiceCalculator.Calculate](/api/invoicing/officeimo-invoicing-invoicecalculator/#method-calculate-officeimo-invoicing-invoice) parameter `invoice`
- Method [InvoiceCalculator.UpdateDeclaredAmounts](/api/invoicing/officeimo-invoicing-invoicecalculator/#method-updatedeclaredamounts-officeimo-invoicing-invoice) parameter `invoice`
- Method [InvoiceEditor.Recalculate](/api/invoicing/officeimo-invoicing-invoiceeditor/#method-recalculate-officeimo-invoicing-invoice-nullable-system-decimal) parameter `invoice`
- Method [InvoiceModelValidator.Validate](/api/invoicing/officeimo-invoicing-invoicemodelvalidator/#method-validate-officeimo-invoicing-invoice) parameter `invoice`
- Method [InvoiceSerializer.InspectTarget](/api/invoicing/officeimo-invoicing-invoiceserializer/#method-inspecttarget-officeimo-invoicing-invoice-officeimo-invoicing-invoicexmloptions) parameter `invoice`
- Method [InvoiceSerializer.Write](/api/invoicing/officeimo-invoicing-invoiceserializer/#method-write-officeimo-invoicing-invoice-officeimo-invoicing-invoicexmloptions) parameter `invoice`

Filter members 

Show inherited

## Constructors

`public Invoice()` [#](#constructor-ctor)

[Invoice.cs:29](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L29)

## Methods

`public InvoiceLine AddLine(InvoiceLine line)` [#](#method-addline-officeimo-invoicing-invoiceline)

[Invoice.cs:9](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L9)

Adds a line, assigning an unused positive numeric identifier when its identifier is empty.

Parameters

**line OfficeIMO.Invoicing.InvoiceLine required**

Caller-created line. An explicit duplicate identifier is rejected before the collection changes.

Returns

`InvoiceLine` The added line.

`public void ClearDeclaredAmounts()` [#](#method-cleardeclaredamounts)

[Invoice.cs:24](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L24)

Removes source-declared amounts so subsequent validation and serialization use calculated line, tax and document amounts.

## Inherited Methods

`public virtual bool Equals(object? obj)` [#](#method-equals-object)

Inherited from object

Parameters

**obj object? required**

Returns

`bool`

`public virtual int GetHashCode()` [#](#method-gethashcode)

Inherited from object

Returns

`int`

`public Type GetType()` [#](#method-gettype)

Inherited from object

Returns

`Type`

`public virtual string? ToString()` [#](#method-tostring)

Inherited from object

Returns

`string?`

## Properties

`public string Number { get; set; }` [#](#property-number)

[Invoice.cs:32](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L32)

Seller-assigned invoice number (BT-1).

`public DateTime IssueDate { get; set; }` [#](#property-issuedate)

[Invoice.cs:34](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L34)

Issue date, without a time or timezone (BT-2).

`public string TypeCode { get; set; }` [#](#property-typecode)

[Invoice.cs:36](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L36)

UNCL 1001 document type, normally 380 for an invoice or 381 for a credit note.

`public string Currency { get; set; }` [#](#property-currency)

[Invoice.cs:39](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L39)

ISO 4217 invoice currency (BT-5). Changing it invalidates any accounting-currency VAT amount.

`public string? BusinessProcessId { get; set; }` [#](#property-businessprocessid)

[Invoice.cs:43](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L43)

Business process identifier (BT-23), distinct from the selected guideline.

`public string? BuyerReference { get; set; }` [#](#property-buyerreference)

[Invoice.cs:45](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L45)

Buyer routing reference, including a Leitweg-ID where required (BT-10).

`public InvoiceParty Seller { get; set; }` [#](#property-seller)

[Invoice.cs:47](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L47)

Seller (BG-4).

`public InvoiceParty Buyer { get; set; }` [#](#property-buyer)

[Invoice.cs:49](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L49)

Buyer (BG-7).

`public InvoiceParty? Payee { get; set; }` [#](#property-payee)

[Invoice.cs:51](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L51)

Payee when different from the seller (BG-10).

`public InvoiceParty? TaxRepresentative { get; set; }` [#](#property-taxrepresentative)

[Invoice.cs:53](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L53)

Seller's tax representative (BG-11).

`public InvoiceDelivery? Delivery { get; set; }` [#](#property-delivery)

[Invoice.cs:55](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L55)

Delivery recipient, address, location identifier and date (BG-13).

`public InvoicePeriod? Period { get; set; }` [#](#property-period)

[Invoice.cs:57](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L57)

Invoice period (BG-14).

`public DateTime? TaxPointDate { get; set; }` [#](#property-taxpointdate)

[Invoice.cs:59](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L59)

Tax point date (BT-7).

`public string? TaxPointDateCode { get; set; }` [#](#property-taxpointdatecode)

[Invoice.cs:61](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L61)

Tax point date code when the actual date is not known (BT-8).

`public string? ProjectReference { get; set; }` [#](#property-projectreference)

[Invoice.cs:63](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L63)

Project reference (BT-11).

`public string? ContractReference { get; set; }` [#](#property-contractreference)

[Invoice.cs:65](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L65)

Contract reference (BT-12).

`public string? PurchaseOrderReference { get; set; }` [#](#property-purchaseorderreference)

[Invoice.cs:67](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L67)

Purchase order reference (BT-13).

`public string? SalesOrderReference { get; set; }` [#](#property-salesorderreference)

[Invoice.cs:69](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L69)

Sales order reference (BT-14).

`public string? ReceivingAdviceReference { get; set; }` [#](#property-receivingadvicereference)

[Invoice.cs:71](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L71)

Receiving advice reference (BT-15).

`public string? DespatchAdviceReference { get; set; }` [#](#property-despatchadvicereference)

[Invoice.cs:73](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L73)

Despatch advice reference (BT-16).

`public string? TenderReference { get; set; }` [#](#property-tenderreference)

[Invoice.cs:75](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L75)

Tender or lot reference (BT-17).

`public string? AccountingReference { get; set; }` [#](#property-accountingreference)

[Invoice.cs:77](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L77)

Buyer accounting reference (BT-19).

`public InvoiceIdentifier? ObjectIdentifier { get; set; }` [#](#property-objectidentifier)

[Invoice.cs:79](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L79)

Invoiced object identifier (BT-18).

`public IList<InvoiceNote> Notes { get; }` [#](#property-notes)

[Invoice.cs:81](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L81)

Free text notes, optionally classified by subject (BG-1).

`public IList<InvoiceReference> PrecedingInvoices { get; }` [#](#property-precedinginvoices)

[Invoice.cs:83](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L83)

Preceding invoice references (BG-3).

`public IList<InvoiceSupportingDocument> SupportingDocuments { get; }` [#](#property-supportingdocuments)

[Invoice.cs:85](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L85)

Additional supporting documents (BG-24).

`public IList<InvoiceLine> Lines { get; }` [#](#property-lines)

[Invoice.cs:87](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L87)

Invoice lines (BG-25).

`public IList<InvoiceAllowanceCharge> AllowancesAndCharges { get; }` [#](#property-allowancesandcharges)

[Invoice.cs:89](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L89)

Document-level allowances and charges (BG-20/BG-21).

`public IList<InvoicePayment> Payments { get; }` [#](#property-payments)

[Invoice.cs:91](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L91)

Payment instruction occurrences (BG-16), retained independently so conflicting descriptions and references are not collapsed.

`public string? PaymentReference { get; set; }` [#](#property-paymentreference)

[Invoice.cs:93](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L93)

Invoice-level remittance reference retained when no payment instruction is present.

`public string? CreditorIdentifier { get; set; }` [#](#property-creditoridentifier)

[Invoice.cs:95](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L95)

Bank-assigned creditor identifier retained independently of payment instructions.

`public string? DirectDebitMandateReference { get; set; }` [#](#property-directdebitmandatereference)

[Invoice.cs:97](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L97)

Invoice-level direct-debit mandate retained when no payment instruction is present.

`public string? PaymentTerms { get; set; }` [#](#property-paymentterms)

[Invoice.cs:99](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L99)

Payment terms (BT-20).

`public DateTime? DueDate { get; set; }` [#](#property-duedate)

[Invoice.cs:101](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L101)

Payment due date (BT-9).

`public decimal PrepaidAmount { get; set; }` [#](#property-prepaidamount)

[Invoice.cs:103](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L103)

Amount already paid (BT-113).

`public decimal RoundingAmount { get; set; }` [#](#property-roundingamount)

[Invoice.cs:105](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L105)

Explicit rounding adjustment to the amount due (BT-114).

`public string? TaxCurrency { get; set; }` [#](#property-taxcurrency)

[Invoice.cs:108](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L108)

Accounting currency for VAT reporting (BT-6). Changing an established currency invalidates its VAT amount.

`public decimal? TaxAmountInAccountingCurrency { get; set; }` [#](#property-taxamountinaccountingcurrency)

[Invoice.cs:112](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L112)

VAT total in the accounting currency (BT-111), supplied with an explicit tax currency.

`public InvoiceDeclaredTotals? DeclaredTotals { get; set; }` [#](#property-declaredtotals)

[Invoice.cs:114](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L114)

Totals declared by a source document, retained for validation rather than silently recalculated on import.

`public IList<InvoiceDeclaredTax> DeclaredTaxes { get; }` [#](#property-declaredtaxes)

[Invoice.cs:116](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Invoicing/Model/Invoice.cs#L116)

VAT breakdowns declared by a source document (BG-23).

<!-- PowerForge markdown artifact sha256:0ABF9907FD822C282A39284694DEA52147BE33F8397BE96DFEE7EAE83FAC8C2B -->
