@dangl/angular-ava 1.1.2-beta0099 → 1.1.2-beta0110

package/lib/ava-tree/tree/model/ava-models.d.ts

@@ -85,6 +85,8 @@ export interface PartyInformationDto {
     bankingInformation?: BankingInformationDto[] | undefined;
     /** This can be used to specify a registration number for this party, e.g. a company registration number. It is usually used in GAEB XML commerce exchanges for bidders to supply their WEEE registration number, which is used to identify them as a registered WEEE company. */
     registrationNumber?: string | undefined;
+    /** This can be used to specify a tax id for this party. It is different from the VatId and the RegistrationNumber. For example, in Germany this would be the "Steuernummer". This is usually not mapped to any AVA exchanges, but it's used e.g. in the XRechnung electronic invoices. */
+    taxId?: string | undefined;
 }
 /** This is a class that represents the information about a bank connection. It is usually used within a PartyInformation. */
 export interface BankingInformationDto {

package/lib/ava-tree/tree/model/invoice-models.d.ts

@@ -1,4 +1,4 @@
-import { ProjectDto } from "./ava-models";
+import { ProjectDto } from './ava-models';
 /** This class represents an invoice */
 export interface Invoice {
     /** The number of the invoice */
@@ -15,7 +15,7 @@ export interface Invoice {
     references?: References | undefined;
     /** A text description of payment terms, e.g. cash discounts or payment conditions */
     paymentTerms?: string | undefined;
-    /** In case of partial of final invoices, it's possible to reference the previous invoice numbers */
+    /** In case of partial or final invoices, it's possible to reference the previous invoice numbers */
     previousInvoices?: PreviousInvoice[] | undefined;
     /** Information about the buyer */
     buyer?: Organization | undefined;
@@ -24,18 +24,20 @@ export interface Invoice {
     /** A payee is someone who receives the payment that is different from the seller */
     payee?: Payee | undefined;
     /** If present, this is an unstructured text that can be used to give additional information
-about the invoice. */
+  about the invoice. */
     invoiceNotes?: InvoiceNote[] | undefined;
     /** The period during which the services or goods were delivered */
     invoicePeriod?: InvoicePeriod | undefined;
+    /** Information about the delivery
+  BG-13 in XRechnung */
+    deliveryInformation?: DeliveryInformation | undefined;
     /** Totals for the invoice */
     totals?: InvoiceTotals | undefined;
     /** Instructions how to perform the payment */
     paymentInstructions?: PaymentInstructions | undefined;
     /** Attached documents to the invoice */
     documents?: SupportingDocument[] | undefined;
-    /** This is used to list VAT by category, e.g. for invoices
-where parts are in different VAT categories */
+    /** This is used to list VAT by category, e.g. for invoices where parts are in different VAT categories */
     vatBreakdown?: VatBreakdown[] | undefined;
     /** Allowances / deductions on the invoice */
     allowances?: InvoiceAllowance[] | undefined;
@@ -60,25 +62,38 @@ export declare enum InvoiceType {
 /** This class holds typical references used in an invoice */
 export interface References {
     /** An internal reference used by the buyer, this can also be used as the
-'Leitweg-ID' in Germany */
+  'Leitweg-ID' in Germany
+  BT-10 in XRechnung. */
     buyerReference?: string | undefined;
-    /** Reference to a project */
+    /** Reference to a project
+  BT-11 in XRechnung. */
     projectReference?: string | undefined;
-    /** Reference to a contract */
+    /** Reference to a contract
+  BT-12 in XRechnung. */
     contractReference?: string | undefined;
-    /** Reference to a purchase order created by the buyer */
+    /** Reference to a purchase order created by the buyer
+  BT-13 in XRechnung. */
     purchaseOrderReference?: string | undefined;
-    /** Reference to a sales order created by the seller */
+    /** Reference to a sales order created by the seller
+  BT-14 in XRechnung. */
     salesOrderReference?: string | undefined;
-    /** Reference to a delivery note */
+    /** Reference to a delivery note
+  BT-15 in XRechnung. */
     receivingAdviceReference?: string | undefined;
-    /** Reference to a dispatch advice */
+    /** Reference to a dispatch advice
+  BT-16 in XRechnung. */
     dispatchAdviceReference?: string | undefined;
-    /** Reference to a tender or lot */
+    /** Reference to a tender or lot
+  BT-17 in XRechnung. */
     tenderOrLotReference?: string | undefined;
     /** Reference to a custom item, e.g. a phone number, person,
-contract or anything that would identify the invoice in the buyer's system */
+  contract or anything that would identify the invoice in the buyer's system
+  BT-18 in XRechnung. */
     invoicedObjectIdentifier?: string | undefined;
+    /** This is a reference for accounting, like a cost center or similar. In German,
+  this would be a "Kostenstelle".
+  BT-19 in XRechnung. */
+    accountingReference?: string | undefined;
 }
 /** References to previous invoices */
 export interface PreviousInvoice {
@@ -117,6 +132,9 @@ export interface Organization {
     countryCode?: string | undefined;
     /** The state of the organization, e.g. a federal state in Germany */
     state?: string | undefined;
+    /** This provides some additional legal information.
+  BT-33 in XRechnung, and this is only used for the seller. */
+    additionalLegalInformation?: string | undefined;
 }
 /** Represents a payee, meaning someone that receives the payment */
 export interface Payee {
@@ -125,12 +143,13 @@ export interface Payee {
     /** The identifier of the payee */
     identifier?: string | undefined;
     /** A registered identifier for the payee, e.g. a VAT ID
-or Tax ID */
+  or Tax ID */
     legalRegistrationIdentifier?: string | undefined;
 }
 /** Represents a note / text in an invoice */
 export interface InvoiceNote {
-    /** Short summary / heading */
+    /** Short summary / heading. Should be a text code from this list:
+  https://unece.org/fileadmin/DAM/trade/untdid/d16b/tred/tred4451.htm */
     shortText?: string | undefined;
     /** Explanation of this note */
     longText?: string | undefined;
@@ -142,27 +161,61 @@ export interface InvoicePeriod {
     /** The end date */
     end?: Date | undefined;
 }
+/** Information about the delivery */
+export interface DeliveryInformation {
+    /** BT-70 in XRechnung */
+    deliverToName?: string | undefined;
+    /** BT-71 in XRechnung */
+    deliverToLocationIdentifier?: string | undefined;
+    /** BT-72 in XRechnung */
+    deliveryDate?: Date | undefined;
+    /** BG-15 in XRechnung */
+    deliveryAddress?: DeliveryAddress | undefined;
+}
+/** Address for deliveries */
+export interface DeliveryAddress {
+    /** The address. BT-75, BT-76 and BT-165 in XRechnung. */
+    address?: string | undefined;
+    /** The city. BT-77 in XRechnung. */
+    city?: string | undefined;
+    /** The zip code. BT-78 in XRechnung. */
+    zipCode?: string | undefined;
+    /** The ISO 3166-1 2 letter country code. BT-80 in XRechnung. */
+    countryCode?: string | undefined;
+}
 /** Totals for the invoice */
 export interface InvoiceTotals {
-    /** Sum of all invoice items in net. */
+    /** Sum of all invoice items in net.
+  BT-106 in XRechnung. */
     totalNet?: number | undefined;
-    /** This is the sum of all allowances (e.g. deductions or withheld tax) in the invoice */
+    /** This is the sum of all allowances (e.g. deductions or withheld tax) in the invoice
+  BT-107 in XRechnung. */
     totalAllowances?: number | undefined;
     /** This is the sum of all charges in the invoice, except VAT. For example, late
-fees or surcharges. */
+  fees or surcharges.
+  BT-108 in XRechnung. */
     totalCharges?: number | undefined;
     /** This is the total net value of the invoice after applied allowances and charges,
-meaning the actual net sum to be paid. */
+  meaning the actual net sum to be paid.
+  BT-109 in XRechnung. */
     totalAfterDeductions?: number | undefined;
-    /** The total amount of VAT in the invoice. */
+    /** The total amount of VAT in the invoice.
+  BT-110 in XRechnung. */
     totalVatAmount?: number | undefined;
-    /** The total gross amount of the invoice, including all taxes and deductions. */
+    /** The total gross amount of the invoice, including all taxes and deductions.
+  BT-112 in XRechnung. */
     totalGross?: number | undefined;
     /** The total amount that has already been paid for this invoice, e.g. used when
-previous invoice sums are included here that have already been paid. */
+  previous invoice sums are included here that have already been paid.
+  BT-113 in XRechnung. */
     alreadyPaidTotal?: number | undefined;
+    /** If this is given, this specifies if any rounding amount is applied to the invoice,
+  before calculating the TotalToBePaid value.
+  BT-114 in XRechnung. */
+    payableRoundingAmount?: number | undefined;
     /** The sum that needs to be paid for this invoice. This is the total gross amount
-minus the already paid amount. */
+  minus the already paid amount.
+  BT-115 in XRechnung. */
     totalToBePaid?: number | undefined;
 }
 /** Instructions how payment for an invoice should be provided. */
@@ -170,21 +223,40 @@ export interface PaymentInstructions {
     /** Additional text to describe the payment instructions. */
     description?: string | undefined;
     /** This should be a code according to UN/ECE 4461
-to identify the type of payment. For example, code "58" means SEPA Credit Transfer,
-and code "30" means non-SEPA Credit Transfer. */
+  to identify the type of payment. For example, code "58" means SEPA Credit Transfer,
+  and code "30" means non-SEPA Credit Transfer.
+  See this list: https://unece.org/fileadmin/DAM/trade/edifact/code/4461cl.htm */
     paymentTypeCode?: string | undefined;
+    /** If a SEPA direct debit payment mean is used, then this reference should be provided.
+  It's the creditor identifier in SEPA, in German "Gläubiger-Identifikationsnummer".
+  Field BT-90 in XRechnung. */
+    paymentCreditorIdentifier?: string | undefined;
     /** A list of payment means that can be used to pay the invoice. */
     paymentMeans?: PaymentMeans[] | undefined;
 }
 /** Represents a payment means for an invoice */
 export interface PaymentMeans {
-    /** This is typically the IBAN or account number */
+    /** This is typically the IBAN or account number
+  BT-84 in XRechnung. */
     accountIdentifier?: string | undefined;
     /** The name for the account, typically the name of the owner for
-a bank account. */
+  a bank account.
+  BT-85 in XRechnung. */
     accountName?: string | undefined;
-    /** This can be the BIC */
+    /** This can be the BIC
+  BT-86 in XRechnung. */
     serviceProviderIdentifier?: string | undefined;
+    /** If used, this is the mandate id for direct debit under which
+  the direct debit will be performed
+  BT-89 in XRechnung. */
+    directDebitMandateId?: string | undefined;
+    /** If used, this is the IBAN for direct debit
+  BT-91 in XRechnung. */
+    directDebitIban?: string | undefined;
+    /** The payment id, e.g. a reference number for the payment. In German,
+  this would be called "Verwendungszweck".
+  BT-83 in XRechnung. */
+    paymentId?: string | undefined;
 }
 /** Represents a document / attachment that is included with the invoice */
 export interface SupportingDocument {
@@ -220,11 +292,11 @@ export interface VatBreakdown {
     /** The category of the VAT */
     vatCategory?: VatCategory | undefined;
     /** The actual tax rate as a decimal value,
-e.g. 19% would be 0.19 */
+  e.g. 19% would be 0.19 */
     taxRate?: number | undefined;
     /** If the VAT is exempt, there should be a description here.
-For example, in reverse charge scenarios, this text
-should contain a reference to "Reverse charge according to ...". */
+  For example, in reverse charge scenarios, this text
+  should contain a reference to "Reverse charge according to ...". */
     vatExemptionReasonText?: string | undefined;
     /** A code from the VAT exemption reason code list(VATEX)“ */
     vatExemptionReasonCode?: string | undefined;
@@ -247,19 +319,21 @@ export interface InvoiceAllowance {
     /** The net amount of the allowance */
     netAmount?: number | undefined;
     /** If this is a relative / percentage allowance, this should be set
-and give the base amount that is being used for the calculation */
+  and give the base amount that is being used for the calculation */
     relativeAllowanceBaseAmount?: number | undefined;
     /** If this is a relative / percentage allowance, this should be set
-and be given in decimal representation, meaning 19% would be 0.19 */
+  and be given in decimal representation, meaning 19% would be 0.19 */
     relativeAllowancePercentage?: number | undefined;
     /** The VAT category for the allowance */
     vatCategory?: VatCategory | undefined;
     /** The actual tax rate as a decimal value,
-meaning 19% would be 0.19 */
+  meaning 19% would be 0.19 */
     vatRate?: number | undefined;
-    /** A description of the allowance. */
+    /** A description of the allowance. This should not be set it ReasonCode
+  is provided, otherwise this one takes precedence. */
     reason?: string | undefined;
-    /** A reason code for the allowance according to UNTDID 5189. */
+    /** A reason code for the allowance according to UNTDID 5189.
+  See this list: https://unece.org/fileadmin/DAM/trade/untdid/d16b/tred/tred5189.htm */
     reasonCode?: string | undefined;
 }
 /** This describes an charge in an invoice, which is a surcharge to the total amount */
@@ -267,19 +341,21 @@ export interface InvoiceCharge {
     /** The net amount of the charge */
     netAmount?: number | undefined;
     /** If this is a relative / percentage charge, this should be set
-and give the base amount that is being used for the calculation */
+  and give the base amount that is being used for the calculation */
     relativeChargeBaseAmount?: number | undefined;
     /** If this is a relative / percentage charge, this should be set
-and be given in decimal representation, meaning 19% would be 0.19 */
+  and be given in decimal representation, meaning 19% would be 0.19 */
     relativeChargePercentage?: number | undefined;
     /** The VAT category for the charge */
     vatCategory?: VatCategory | undefined;
     /** The actual tax rate as a decimal value,
-meaning 19% would be 0.19 */
+  meaning 19% would be 0.19 */
     vatRate?: number | undefined;
-    /** A description of the charge. */
+    /** A description of the charge. This should not be set it ReasonCode
+  is provided, otherwise this one takes precedence. */
     reason?: string | undefined;
-    /** A reason code for the charge according to UNTDID 7161. */
+    /** A reason code for the charge according to UNTDID 7161.
+  See this list: https://unece.org/fileadmin/DAM/trade/untdid/d16b/tred/tred5189.htm */
     reasonCode?: string | undefined;
 }
 /** Represents a single invoice line item */
@@ -289,17 +365,17 @@ export interface InvoiceLineItem {
     /** An unstructured note to classify line items */
     note?: string | undefined;
     /** A seller-defined object identifier for this line item,
-meaning an identifier for the actual line. This could be
-a numbering sequence or a reference to a product. */
+  meaning an identifier for the actual line. This could be
+  a numbering sequence or a reference to a product. */
     objectIdentifier?: string | undefined;
     /** The actual invoiced quantity of the line item */
     quantity?: number | undefined;
     /** A code for the unit of the quantity. This should be a code as defined
-in UN/ECE Recommendation No. 20 „Codes for Units of Measure Used in
-International Trade“ und UN/ECE Recommendation No 21 „Codes for Passengers,
-Types of Cargo, Packages and Packaging Materials(with Complementary Codes for Package Names) */
+  in UN/ECE Recommendation No. 20 „Codes for Units of Measure Used in
+  International Trade“ und UN/ECE Recommendation No 21 „Codes for Passengers,
+  Types of Cargo, Packages and Packaging Materials(with Complementary Codes for Package Names) */
     unitCode?: string | undefined;
-    /** The net amount for this line item */
+    /** The net amount for this line item. This is the total price for positions */
     netAmount?: number | undefined;
     /** A reference to an item in the buyers purachase order */
     purchaseOrderReference?: string | undefined;
@@ -323,10 +399,10 @@ export interface LineItemAllowance {
     /** The net amount of the allowance */
     netAmount?: number | undefined;
     /** If this is a relative / percentage allowance, this should be set
-and give the base amount that is being used for the calculation */
+  and give the base amount that is being used for the calculation */
     relativeAllowanceBaseAmount?: number | undefined;
     /** If this is a relative / percentage allowance, this should be set
-and be given in decimal representation, meaning 19% would be 0.19 */
+  and be given in decimal representation, meaning 19% would be 0.19 */
     relativeAllowancePercentage?: number | undefined;
     /** A description of the allowance. */
     reason?: string | undefined;
@@ -338,10 +414,10 @@ export interface LineItemCharge {
     /** The net amount of the charge */
     netAmount?: number | undefined;
     /** If this is a relative / percentage charge, this should be set
-and give the base amount that is being used for the calculation */
+  and give the base amount that is being used for the calculation */
     relativeChargeBaseAmount?: number | undefined;
     /** If this is a relative / percentage charge, this should be set
-and be given in decimal representation, meaning 19% would be 0.19 */
+  and be given in decimal representation, meaning 19% would be 0.19 */
     relativeChargePercentage?: number | undefined;
     /** A description of the charge. */
     reason?: string | undefined;
@@ -350,15 +426,16 @@ and be given in decimal representation, meaning 19% would be 0.19 */
 }
 /** Price details about a line item */
 export interface LineItemPriceDetail {
-    /** The net price of this line item */
+    /** The net price of this line item. This is the unit price */
     netPrice?: number | undefined;
     /** A discount for this line item, given as an absolute value. It is essentially the difference between NetPrice (or the list price)
-and the actual invoiced price GrossPrice. */
+  and the actual invoiced price GrossPrice. */
     absoluteDiscountPerItem?: number | undefined;
     /** The gross price of this line item, meaning the price without taxes
-that will be invoiced */
+  that will be invoiced */
     grossPrice?: number | undefined;
-    /** The quantity for which this price is valid */
+    /** The quantity for which this price is valid. In combination with the NetPrice,
+  you basically specify the denominator of the unit price for a line item. */
     baseQuantity?: number | undefined;
     /** A code representing the unit for the base quantity */
     baseQuantityUnitCode?: string | undefined;
@@ -368,7 +445,7 @@ export interface LineItemVatInformation {
     /** The VAT category for the charge */
     vatCategory?: VatCategory | undefined;
     /** The actual tax rate as a decimal value,
-meaning 19% would be 0.19 */
+  meaning 19% would be 0.19 */
     vatRate?: number | undefined;
 }
 /** Information about a single line item */
@@ -383,6 +460,9 @@ export interface LineItemInformation {
     buyerIdentifier?: string | undefined;
     /** A standard identifier for the line item, e.g. an EAN or a GTIN */
     standardIdentifier?: string | undefined;
+    /** If used together with StandardIdentifier, this is the scheme identifier
+  for which standard is used. */
+    standardSchemeId?: string | undefined;
     /** A list of classification identifiers for the line item */
     classificationIdentifiers?: string[] | undefined;
     /** The origin country code according to ISO 3166-1 in 2 letter format */
@@ -417,6 +497,10 @@ export interface AvaProjectWrapper {
     paymentInstructions?: PaymentInstructions | undefined;
     /** The type of the invoice */
     invoiceType?: InvoiceType | undefined;
+    /** If this is set to true, the invoice will be marked as a reverse charge invoice
+  in all VAT rates. You still need to ensure that the actual tax rates are set
+  to zero in all elements */
+    isEuReverseChargeInvoice?: boolean | undefined;
     /** Until when the payment is due */
     paymentDueDate?: Date | undefined;
     /** A text description of payment terms, e.g. cash discounts or payment conditions */
@@ -424,9 +508,20 @@ export interface AvaProjectWrapper {
     /** In case of partial of final invoices, it's possible to reference the previous invoice numbers */
     previousInvoices?: PreviousInvoice[] | undefined;
     /** If parts of this invoice (or of previous invoices) have already been paid,
-then this property can be used to specify that some parts of the invoice
-are already paid and this will be deducted from the to be paid amount. */
+  then this property can be used to specify that some parts of the invoice
+  are already paid and this will be deducted from the to be paid amount. */
     alreadyPaidTotalGross?: number | undefined;
     /** An object holding reference used in this invoice */
     references?: References | undefined;
+    /** Optional document level allowances. For example, those can be used to supply
+  global discounts e.g. for security deposits. When using this property, please
+  pay attention that a deduction factor on the exported ServiceSpecification
+  will also be exported as an allowance, in this case the total price of the
+  invoice might be different from the total price of the ServiceSpecification. */
+    allowances?: InvoiceAllowance[] | undefined;
+    /** Optional document level charges, e.g. for shipping or handling. When using this property,
+  please pay attention that the charges given here will be applied to the already calculated
+  total price of the ServiceSpecification, in this case the total price of the invoice
+  might be different from the total price of the ServiceSpecification. */
+    charges?: InvoiceCharge[] | undefined;
 }

package/lib/ava-tree/tree/model/invoice-words.model.d.ts

@@ -1,5 +1,7 @@
 export interface ITextWordInvoice {
     invoiceTitle: string;
+    invoiceBuyerTitle: string;
+    invoiceSellerTitle: string;
     vatId: string;
     detailsInvoiceNumber: string;
     detailsInvoiceDate: string;
@@ -43,4 +45,14 @@ export interface ITextWordInvoice {
     attachmentsMimeType: string;
     attachmentsFileName: string;
     attachmentsDownloadButton: string;
+    contactPersonName: string;
+    contactPersonPhone: string;
+    contactPersonEmail: string;
+    vat: string;
+    taxRate: string;
+    deliveryInformationTitle: string;
+    deliverToName: string;
+    deliverToLocationIdentifier: string;
+    deliveryDate: string;
+    deliveryAddress: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangl/angular-ava",
-  "version": "1.1.2-beta0099",
+  "version": "1.1.2-beta0110",
   "keywords": [
     "angular",
     "ava",