@lilaquadrat/interfaces 1.34.0 → 1.35.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [1.35.0](https://github.com/lilaquadrat/interfaces/compare/v1.34.1...v1.35.0) (2026-01-16)
+
+
+### Features
+
+* **Invoice:** add invoice-related interfaces and types for structured invoice management ([ac928be](https://github.com/lilaquadrat/interfaces/commit/ac928be59e4009c2d23402a0f4e3e38ba3b8678a))
+
+
+### Bug Fixes
+
+* **CustomerPerson:** make prename optional in CustomerPerson interface ([0826980](https://github.com/lilaquadrat/interfaces/commit/0826980f7eb341058e5fbae5c8d48cac7c3af7ae))
+
+### [1.34.1](https://github.com/lilaquadrat/interfaces/compare/v1.34.0...v1.34.1) (2026-01-03)
+
+
+### Bug Fixes
+
+* **ProjectDomain:** rename interface to ProjectDomainWithSecret for clarity ([617e7ae](https://github.com/lilaquadrat/interfaces/commit/617e7aecc2efafd10227902754f5b32c18b8a5a7))
+
 ## [1.34.0](https://github.com/lilaquadrat/interfaces/compare/v1.33.2...v1.34.0) (2026-01-03)
 
 

package/lib/cjs/CustomerPerson.d.ts

@@ -2,7 +2,7 @@ import { CustomerAccounts } from "./CustomerAccounts";
 import { CustomerBase } from "./CustomerBase";
 export interface CustomerPerson extends CustomerBase {
     type?: 'person';
-    prename: string;
+    prename?: string;
     gender?: 'm' | 'w' | 'd';
     accounts?: CustomerAccounts[];
 }

package/lib/cjs/Invoice.d.ts

@@ -0,0 +1,34 @@
+import { ObjectId } from "mongodb";
+import { InvoiceAttachment } from "./InvoiceAttachment";
+import { InvoiceLine } from "./InvoiceLine";
+import { InvoiceParty } from "./InvoiceParty";
+import { InvoicePaymentMeans } from "./InvoicePaymentMeans";
+import { InvoiceReferences } from "./InvoiceReferences";
+import { InvoiceTaxBreakdown } from "./InvoiceTaxBreakdown";
+import { InvoiceTotals } from "./InvoiceTotals";
+export type InvoiceProfile = 'zugferd-basic' | 'zugferd-comfort' | 'zugferd-extended' | 'xrechnung';
+export type InvoiceState = 'draft' | 'issued' | 'sent' | 'paid' | 'cancelled';
+export interface Invoice {
+    _id?: ObjectId;
+    id?: number | string;
+    company: string;
+    project: string;
+    app: string;
+    profile: InvoiceProfile;
+    state: InvoiceState;
+    invoiceNumber?: string;
+    issueDate: string;
+    deliveryDate?: string;
+    dueDate?: string;
+    seller: InvoiceParty;
+    buyer: InvoiceParty;
+    lines: InvoiceLine[];
+    taxBreakdown: InvoiceTaxBreakdown[];
+    totals: InvoiceTotals;
+    paymentMeans?: InvoicePaymentMeans;
+    references?: InvoiceReferences;
+    notes?: string[];
+    attachments?: InvoiceAttachment[];
+    paymentId?: ObjectId;
+    customer?: ObjectId;
+}

package/lib/cjs/InvoiceAttachment.d.ts

@@ -0,0 +1,7 @@
+export interface InvoiceAttachment {
+    type: 'pdf' | 'xml';
+    name: string;
+    mimeType: string;
+    key?: string;
+    size?: number;
+}

package/lib/cjs/InvoiceLine.d.ts

@@ -0,0 +1,12 @@
+export interface InvoiceLine {
+    description: string;
+    quantity: number;
+    unitPrice: number;
+    taxRate: number;
+    taxAmount: number;
+    netAmount: number;
+    grossAmount: number;
+    unit?: string;
+    position?: number;
+    productId?: string;
+}

package/lib/cjs/InvoiceParty.d.ts

@@ -0,0 +1,15 @@
+export interface InvoiceParty {
+    name: string;
+    street: string;
+    zipcode: string;
+    city: string;
+    countryCode: string;
+    vatId?: string;
+    taxNumber?: string;
+    legalEntity?: string;
+    contactName?: string;
+    contactEmail?: string;
+    buyerReference?: string;
+    gln?: string;
+    leitwegId?: string;
+}

package/lib/cjs/InvoicePaymentMeans.d.ts

@@ -0,0 +1,9 @@
+export interface InvoicePaymentMeans {
+    method: 'sepa-credit-transfer' | 'bank-transfer' | 'card' | 'cash';
+    iban?: string;
+    bic?: string;
+    accountHolder?: string;
+    sepaMandateId?: string;
+    paymentTerms?: string;
+    dueDate?: string;
+}

package/lib/cjs/InvoiceReferences.d.ts

@@ -0,0 +1,5 @@
+export interface InvoiceReferences {
+    orderReference?: string;
+    contractReference?: string;
+    paymentReference?: string;
+}

package/lib/cjs/InvoiceTaxBreakdown.d.ts

@@ -0,0 +1,5 @@
+export interface InvoiceTaxBreakdown {
+    rate: number;
+    baseAmount: number;
+    taxAmount: number;
+}

package/lib/cjs/InvoiceTotals.d.ts

@@ -0,0 +1,7 @@
+export interface InvoiceTotals {
+    netTotal: number;
+    taxTotal: number;
+    grossTotal: number;
+    currency: string;
+    rounding?: number;
+}

package/lib/cjs/InvoiceWithXml.d.ts

@@ -0,0 +1,4 @@
+import { Invoice } from "./Invoice";
+export interface InvoiceWithXml extends Invoice {
+    xml: string;
+}

package/lib/cjs/ProjectDomainWithSecret.d.ts

@@ -1,6 +1,6 @@
 import { Domain } from "./Domain";
 import { Secret } from "./Secret";
-export interface ProjectDomain extends Omit<Domain, 'secret'> {
+export interface ProjectDomainWithSecret extends Omit<Domain, 'secret'> {
     company: string;
     project: string;
     secret: Secret;

package/lib/cjs/index.d.ts

@@ -106,6 +106,15 @@ export * from './IdentifiersEntity';
 export * from './ImportExportData';
 export * from './ImportJob';
 export * from './IndexModule';
+export * from './Invoice';
+export * from './InvoiceAttachment';
+export * from './InvoiceLine';
+export * from './InvoiceParty';
+export * from './InvoicePaymentMeans';
+export * from './InvoiceReferences';
+export * from './InvoiceTaxBreakdown';
+export * from './InvoiceTotals';
+export * from './InvoiceWithXml';
 export * from './Link';
 export * from './LinkGroupElement';
 export * from './List';

package/lib/esm/CustomerPerson.d.ts

@@ -2,7 +2,7 @@ import { CustomerAccounts } from "./CustomerAccounts";
 import { CustomerBase } from "./CustomerBase";
 export interface CustomerPerson extends CustomerBase {
     type?: 'person';
-    prename: string;
+    prename?: string;
     gender?: 'm' | 'w' | 'd';
     accounts?: CustomerAccounts[];
 }

package/lib/esm/Invoice.d.ts

@@ -0,0 +1,34 @@
+import { ObjectId } from "mongodb";
+import { InvoiceAttachment } from "./InvoiceAttachment";
+import { InvoiceLine } from "./InvoiceLine";
+import { InvoiceParty } from "./InvoiceParty";
+import { InvoicePaymentMeans } from "./InvoicePaymentMeans";
+import { InvoiceReferences } from "./InvoiceReferences";
+import { InvoiceTaxBreakdown } from "./InvoiceTaxBreakdown";
+import { InvoiceTotals } from "./InvoiceTotals";
+export type InvoiceProfile = 'zugferd-basic' | 'zugferd-comfort' | 'zugferd-extended' | 'xrechnung';
+export type InvoiceState = 'draft' | 'issued' | 'sent' | 'paid' | 'cancelled';
+export interface Invoice {
+    _id?: ObjectId;
+    id?: number | string;
+    company: string;
+    project: string;
+    app: string;
+    profile: InvoiceProfile;
+    state: InvoiceState;
+    invoiceNumber?: string;
+    issueDate: string;
+    deliveryDate?: string;
+    dueDate?: string;
+    seller: InvoiceParty;
+    buyer: InvoiceParty;
+    lines: InvoiceLine[];
+    taxBreakdown: InvoiceTaxBreakdown[];
+    totals: InvoiceTotals;
+    paymentMeans?: InvoicePaymentMeans;
+    references?: InvoiceReferences;
+    notes?: string[];
+    attachments?: InvoiceAttachment[];
+    paymentId?: ObjectId;
+    customer?: ObjectId;
+}

package/lib/esm/Invoice.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Invoice.js.map

package/lib/esm/Invoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Invoice.js","sourceRoot":"","sources":["../../src/Invoice.ts"],"names":[],"mappings":""}

package/lib/esm/InvoiceAttachment.d.ts

@@ -0,0 +1,7 @@
+export interface InvoiceAttachment {
+    type: 'pdf' | 'xml';
+    name: string;
+    mimeType: string;
+    key?: string;
+    size?: number;
+}

package/lib/esm/InvoiceAttachment.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InvoiceAttachment.js.map

package/lib/esm/InvoiceAttachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoiceAttachment.js","sourceRoot":"","sources":["../../src/InvoiceAttachment.ts"],"names":[],"mappings":""}

package/lib/esm/InvoiceLine.d.ts

@@ -0,0 +1,12 @@
+export interface InvoiceLine {
+    description: string;
+    quantity: number;
+    unitPrice: number;
+    taxRate: number;
+    taxAmount: number;
+    netAmount: number;
+    grossAmount: number;
+    unit?: string;
+    position?: number;
+    productId?: string;
+}

package/lib/esm/InvoiceLine.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InvoiceLine.js.map

package/lib/esm/InvoiceLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoiceLine.js","sourceRoot":"","sources":["../../src/InvoiceLine.ts"],"names":[],"mappings":""}

package/lib/esm/InvoiceParty.d.ts

@@ -0,0 +1,15 @@
+export interface InvoiceParty {
+    name: string;
+    street: string;
+    zipcode: string;
+    city: string;
+    countryCode: string;
+    vatId?: string;
+    taxNumber?: string;
+    legalEntity?: string;
+    contactName?: string;
+    contactEmail?: string;
+    buyerReference?: string;
+    gln?: string;
+    leitwegId?: string;
+}

package/lib/esm/InvoiceParty.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InvoiceParty.js.map

package/lib/esm/InvoiceParty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoiceParty.js","sourceRoot":"","sources":["../../src/InvoiceParty.ts"],"names":[],"mappings":""}

package/lib/esm/InvoicePaymentMeans.d.ts

@@ -0,0 +1,9 @@
+export interface InvoicePaymentMeans {
+    method: 'sepa-credit-transfer' | 'bank-transfer' | 'card' | 'cash';
+    iban?: string;
+    bic?: string;
+    accountHolder?: string;
+    sepaMandateId?: string;
+    paymentTerms?: string;
+    dueDate?: string;
+}

package/lib/esm/InvoicePaymentMeans.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InvoicePaymentMeans.js.map

package/lib/esm/InvoicePaymentMeans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoicePaymentMeans.js","sourceRoot":"","sources":["../../src/InvoicePaymentMeans.ts"],"names":[],"mappings":""}

package/lib/esm/InvoiceReferences.d.ts

@@ -0,0 +1,5 @@
+export interface InvoiceReferences {
+    orderReference?: string;
+    contractReference?: string;
+    paymentReference?: string;
+}

package/lib/esm/InvoiceReferences.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InvoiceReferences.js.map

package/lib/esm/InvoiceReferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoiceReferences.js","sourceRoot":"","sources":["../../src/InvoiceReferences.ts"],"names":[],"mappings":""}

package/lib/esm/InvoiceTaxBreakdown.d.ts

@@ -0,0 +1,5 @@
+export interface InvoiceTaxBreakdown {
+    rate: number;
+    baseAmount: number;
+    taxAmount: number;
+}

package/lib/esm/InvoiceTaxBreakdown.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InvoiceTaxBreakdown.js.map

package/lib/esm/InvoiceTaxBreakdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoiceTaxBreakdown.js","sourceRoot":"","sources":["../../src/InvoiceTaxBreakdown.ts"],"names":[],"mappings":""}

package/lib/esm/InvoiceTotals.d.ts

@@ -0,0 +1,7 @@
+export interface InvoiceTotals {
+    netTotal: number;
+    taxTotal: number;
+    grossTotal: number;
+    currency: string;
+    rounding?: number;
+}

package/lib/esm/InvoiceTotals.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InvoiceTotals.js.map

package/lib/esm/InvoiceTotals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoiceTotals.js","sourceRoot":"","sources":["../../src/InvoiceTotals.ts"],"names":[],"mappings":""}

package/lib/esm/InvoiceWithXml.d.ts

@@ -0,0 +1,4 @@
+import { Invoice } from "./Invoice";
+export interface InvoiceWithXml extends Invoice {
+    xml: string;
+}

package/lib/esm/InvoiceWithXml.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=InvoiceWithXml.js.map

package/lib/esm/InvoiceWithXml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvoiceWithXml.js","sourceRoot":"","sources":["../../src/InvoiceWithXml.ts"],"names":[],"mappings":""}

package/lib/esm/ProjectDomainWithSecret.d.ts

@@ -1,6 +1,6 @@
 import { Domain } from "./Domain";
 import { Secret } from "./Secret";
-export interface ProjectDomain extends Omit<Domain, 'secret'> {
+export interface ProjectDomainWithSecret extends Omit<Domain, 'secret'> {
     company: string;
     project: string;
     secret: Secret;

package/lib/esm/index.d.ts

@@ -106,6 +106,15 @@ export * from './IdentifiersEntity';
 export * from './ImportExportData';
 export * from './ImportJob';
 export * from './IndexModule';
+export * from './Invoice';
+export * from './InvoiceAttachment';
+export * from './InvoiceLine';
+export * from './InvoiceParty';
+export * from './InvoicePaymentMeans';
+export * from './InvoiceReferences';
+export * from './InvoiceTaxBreakdown';
+export * from './InvoiceTotals';
+export * from './InvoiceWithXml';
 export * from './Link';
 export * from './LinkGroupElement';
 export * from './List';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lilaquadrat/interfaces",
-  "version": "1.34.0",
+  "version": "1.35.0",
   "description": "interfaces in context of lilaquadrat STUDIO",
   "author": {
     "email": "m.schuebel@lila2.de",

package/src/CustomerPerson.ts

@@ -5,7 +5,7 @@ export interface CustomerPerson extends CustomerBase {
 
   type?: 'person'
 
-  prename: string
+  prename?: string
 
   // birthday?: Date
   gender?: 'm' | 'w' | 'd'

package/src/Invoice.ts

@@ -0,0 +1,38 @@
+import { ObjectId } from "mongodb"
+import { InvoiceAttachment } from "./InvoiceAttachment"
+import { InvoiceLine } from "./InvoiceLine"
+import { InvoiceParty } from "./InvoiceParty"
+import { InvoicePaymentMeans } from "./InvoicePaymentMeans"
+import { InvoiceReferences } from "./InvoiceReferences"
+import { InvoiceTaxBreakdown } from "./InvoiceTaxBreakdown"
+import { InvoiceTotals } from "./InvoiceTotals"
+
+export type InvoiceProfile = 'zugferd-basic' | 'zugferd-comfort' | 'zugferd-extended' | 'xrechnung'
+
+export type InvoiceState = 'draft' | 'issued' | 'sent' | 'paid' | 'cancelled'
+
+export interface Invoice {
+    _id?: ObjectId
+    id?: number | string
+    company: string
+    project: string
+    app: string
+    profile: InvoiceProfile
+    state: InvoiceState
+    invoiceNumber?: string
+    issueDate: string
+    deliveryDate?: string
+    dueDate?: string
+    seller: InvoiceParty
+    buyer: InvoiceParty
+    lines: InvoiceLine[]
+    taxBreakdown: InvoiceTaxBreakdown[]
+    totals: InvoiceTotals
+    paymentMeans?: InvoicePaymentMeans
+    references?: InvoiceReferences
+    notes?: string[]
+    attachments?: InvoiceAttachment[]
+    paymentId?: ObjectId
+    customer?: ObjectId
+}
+

package/src/InvoiceAttachment.ts

@@ -0,0 +1,7 @@
+export interface InvoiceAttachment {
+    type: 'pdf' | 'xml'
+    name: string
+    mimeType: string
+    key?: string
+    size?: number
+}

package/src/InvoiceLine.ts

@@ -0,0 +1,12 @@
+export interface InvoiceLine {
+    description: string
+    quantity: number
+    unitPrice: number
+    taxRate: number
+    taxAmount: number
+    netAmount: number
+    grossAmount: number
+    unit?: string
+    position?: number
+    productId?: string
+}

package/src/InvoiceParty.ts

@@ -0,0 +1,15 @@
+export interface InvoiceParty {
+    name: string
+    street: string
+    zipcode: string
+    city: string
+    countryCode: string
+    vatId?: string
+    taxNumber?: string
+    legalEntity?: string
+    contactName?: string
+    contactEmail?: string
+    buyerReference?: string
+    gln?: string
+    leitwegId?: string
+}

package/src/InvoicePaymentMeans.ts

@@ -0,0 +1,9 @@
+export interface InvoicePaymentMeans {
+    method: 'sepa-credit-transfer' | 'bank-transfer' | 'card' | 'cash'
+    iban?: string
+    bic?: string
+    accountHolder?: string
+    sepaMandateId?: string
+    paymentTerms?: string
+    dueDate?: string
+}

package/src/InvoiceReferences.ts

@@ -0,0 +1,5 @@
+export interface InvoiceReferences {
+    orderReference?: string
+    contractReference?: string
+    paymentReference?: string
+}

package/src/InvoiceTaxBreakdown.ts

@@ -0,0 +1,5 @@
+export interface InvoiceTaxBreakdown {
+    rate: number
+    baseAmount: number
+    taxAmount: number
+}

package/src/InvoiceTotals.ts

@@ -0,0 +1,7 @@
+export interface InvoiceTotals {
+    netTotal: number
+    taxTotal: number
+    grossTotal: number
+    currency: string
+    rounding?: number
+}

package/src/InvoiceWithXml.ts

@@ -0,0 +1,5 @@
+import { Invoice } from "./Invoice"
+
+export interface InvoiceWithXml extends Invoice {
+    xml: string
+}

package/src/ProjectDomainWithSecret.ts

@@ -1,7 +1,7 @@
 import { Domain } from "./Domain";
 import { Secret } from "./Secret";
 
-export interface ProjectDomain extends Omit<Domain, 'secret'> {
+export interface ProjectDomainWithSecret extends Omit<Domain, 'secret'> {
   company: string
   project: string
   secret: Secret