Verträge / SupplierInvoicePatch
Lieferanten-Rechnung Patch
SupplierInvoicePatch · com.nexoware.connect.events
- Aggregat
- SupplierInvoice · State SupplierInvoiceState
- Topic
- supplierinvoice.patch je Mandant mit Präfix, z. B.
<mandant>.supplierinvoice.patch - Key
- SupplierInvoiceUuid
- Nachrichtenart
- Patch — ausdrückliche Teiländerungen, zusammengeführt vom Zusammenführungsdienst
- Schreiber
- c-entron Webservice (centron)
- Retention
- 30 Tage
- Fassung
- Version 1 (neueste)
- Schema-ID
- 91
Patch-Pfad
- Pflicht bei Anlage
- SupplierInvoiceNumber, Version, State, AccountUuid, SupplierInvoiceDate, CurrencyFactor, IsStandalone
- Fix nach Anlage
- SupplierInvoiceNumber
Vertragsentwurf: typisierte Teilaenderung fuer Lieferanten-Rechnung. Nur ChangedFields werden angewandt; null leert nur nullable State-Einheiten. Listen und Unterobjekte sind atomare Ersetzungen mit vollstaendigem Inhalt. Fachliche Freigabe und Regeln gekoppelter Werte sind offen; siehe docs/contracts/supplierinvoice.md.
Fassungen
Felder
-
EventId ↗ extern: EventId uuidBeim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch.
-
SupplierInvoiceUuid Key uuidStabile, global eindeutige Identitaet der Lieferanten-Rechnung (Matching-Schluessel; zugleich Message-Key). Bleibt ueber Belegversionen hinweg identisch (die historischen Kopien in KalkKopf teilen sie, sind aber ueber AktuelleVersion = 0 vom eindeutigen Live-Stand ausgenommen).
-
Mode enum(CHANGE|INITIAL_LOAD)
-
ChangedFields Liste string[]Explizite Maske der geaenderten Top-Level-Einheiten; keine Wildcards, Identitaets- oder Auditfelder. Listen und Records werden als Ganzes ersetzt.
-
Data SupplierInvoicePatchData
25 Felder von
SupplierInvoicePatchData-
SupplierInvoiceNumber optional intDefault:
nullFachliche Belegnummer der Eingangsrechnung (Quelle Nummer; im modernen Schreibpfad aus der Nummerngruppe vergeben, eigener Nummernraum getrennt von der Kunden-Rechnung). Vorlagen (negative Nummer) werden nicht publiziert. Die Rechnungsnummer des Lieferanten reist getrennt als ExternalInvoiceNumber. Nur bei Anlage; fixedAfterCreate. -
Version optional intDefault:
nullBelegversion dieses Snapshots (neue Versionen derselben Eingangsrechnung ueberschreiben per LWW; alle Versionen liegen in KalkKopf selbst, nur die Live-Zeile mit AktuelleVersion = 1 wird publiziert). -
State optional intDefault:
nullLWW-Statusfeld (Quelle Status, ReceiptState: 1 = aktiv/offen, 2 = abgeschlossen, 3 = storniert). Deaktivierung/Storno reist als Voll-Snapshot mit State = 3, kein Tombstone. Wird auch vom Folgebeleg-Zweitschreiber geschrieben (Lieferanten-Gutschrift-Buchung, SaveReceiptAfterOriginUpdate: Status + gutgeschriebene Mengen) - jede Fortschreibung erzeugt einen neuen Voll-Snapshot. Der Wert 0 sendet der Producer nie; er ist allein der Schema-Evolutions-Default fuer Leser, deren Writer-Schema das Feld noch nicht kannte, und darf nicht als Status ausgewertet werden. -
Default:
nullPflicht-Referenz auf den Lieferanten (Account mit Supplier-Facette, QS-1) ueber dessen UUID. Quellseitig ist KreditorI3D die Kreditor-Nummer (AccountSupplier.Number); der Producer loest sie ueber AccountSupplier -> AccountTypeToAccount -> Account auf. Kann der Producer sie nicht aufloesen, scheitert die Avro-Projektion laut (Failed-Outbox-Zeile) statt still null zu senden. -
Default:
nullVorbeleg-Referenz auf die Bestellung ueber deren UUID. Optional nach Quell-Garantie: nicht jede Eingangsrechnung hat eine Bestellung als Vorbeleg. Producer-seitig aus den Positions-Urspruengen abgeleitet (UebernommenAusArt 7 = Bestellung): genau EINE eindeutige Ursprungs-Bestellung -> deren UUID; keine oder mehrere unterschiedliche Bestellungen -> null (es gibt dann keinen EINEN Vorbeleg). -
Default:
nullVorbeleg-Referenz auf den Wareneingang (Lieferanten-Lieferschein) ueber dessen UUID - der Regelfall der WE-Kalkulation: die Eingangsrechnung rechnet Wareneingaenge ab. Optional nach Quell-Garantie (Standalone-Erfassung ohne Wareneingangs-Bezug, siehe IsStandalone); Ableitung analog SupplierOrderUuid aus den Positions-Urspruengen (UebernommenAusArt 8 = Wareneingang): genau EIN eindeutiger Ursprungs-Wareneingang -> dessen UUID, sonst null. -
SupplierInvoiceDate optional timestampDefault:
nullBelegdatum als UTC-Instant (Quelle Datum; Quell-Property des modernen Schreibpfads non-null; Host-lokale Zeit, beim Publish nach UTC konvertiert). Das Rechnungsdatum des Lieferanten reist getrennt als ExternalInvoiceDate. -
DeliveryDate optional timestampDefault:
nullLieferdatum der Eingangsrechnung (Quelle Lieferdatum); DB nullable. -
DueDate optional timestampDefault:
nullFaelligkeitsdatum der Eingangsrechnung (Quelle FaelligAm, beim Save aus der Lieferanten-Zahlungskondition uebernommen); DB nullable. Basis der Kreditoren-Opos-Ableitung beim Konsumenten (QS-5). -
ExternalInvoiceNumber optional stringDefault:
nullRechnungsnummer des Lieferanten (Quelle RechnungsNr - der externe Beleg, gegen den die Eingangsrechnung erfasst wurde; die Duplikatpruefung der Quelle laeuft ueber dieses Feld); DB nullable. Einkaufsspezifisch - das Gegenstueck zur eigenen fachlichen SupplierInvoiceNumber. -
ExternalInvoiceDate optional timestampDefault:
nullRechnungsdatum des Lieferanten (Quelle RechnungsDatum); DB nullable. -
Default:
nullReferenz auf die Belegkondition (Lieferanten-Zahlungskondition, Quelle ZahlKondI3D -> Zahkond) ueber deren UUID; quellseitig nullable. Eine Lieferbedingungs-Referenz existiert am Kopf der Eingangsrechnung nicht. -
Default:
nullReferenz auf die Filiale des Belegs (Quelle BranchI3D -> Filiale) ueber deren UUID; quellseitig nullable. 0/NULL im Quell-FK bedeutet 'Hauptsitz (keine Filiale)' (BranchBL.GetHeadquarter) - der Hauptsitz ist KEIN Filiale-Datensatz, die Referenz reist dann als null. Die Begleitspalte BranchOrigin (Herkunft der Filial-Zuordnung) ist Prozess-Detail und kein Vertragsfeld (Filial-FK-Befund, Topic-Zuschnitt Anhang A Nr. 9). -
CurrencyIso optional stringDefault:
nullISO-Waehrungskennzeichen des Belegs (Quelle CurrencyString); DB nullable. -
CurrencyFactor optional decimal(18,6)Default:
nullUmrechnungsfaktor der Belegwaehrung zur Hauswaehrung; quellseitig non-null geschrieben (moderner Schreibpfad), beim Publish kaufmaennisch auf 6 Nachkommastellen gerundet. -
NetTotal optional decimal(18,2)Default:
nullNetto-Gesamtsumme der Eingangsrechnung inklusive Fracht/Versicherung (Quelle KalkKopf.NettobetragGesamt, von der Quelle nach dem Save per Raw-UPDATE berechnet); DB nullable, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet. Die reinen Positionssummen (Nettobetrag/SummeNetto) sind Zwischenwerte derselben Berechnung und keine Vertragsfelder. -
GrossTotal optional decimal(18,2)Default:
nullBrutto-Gesamtsumme der Eingangsrechnung (Quelle KalkKopf.BruttobetragGesamt, von der Quelle nach dem Save per Raw-UPDATE inkl. MwSt-Behandlung von Fracht/Versicherung berechnet); DB nullable, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet. -
FreightAmount optional decimal(18,2)Default:
nullFrachtkosten der Eingangsrechnung (Quelle Frachtkosten); quellseitig nullable float, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet. Die Verteilungs-Modi (FrachtVerteilung) und die positionsweise verteilten Anteile sind Kalkulations-Prozessdetail und keine Vertragsfelder. -
InsuranceAmount optional decimal(18,2)Default:
nullVersicherungskosten der Eingangsrechnung (Quelle Versicherung); quellseitig nullable float, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet. Verteilung auf Positionen analog Fracht - Prozessdetail. -
Paid optional decimal(18,2)Default:
nullBereits bezahlter Betrag in Belegwaehrung (Quelle KalkKopf.Bezahlt, QS-5: der Zahlstatus reist als Kopf-Feld, kein eigenes Opos- oder Zahlungs-Topic; offener Posten = Ableitung aus GrossTotal minus Paid); DB nullable. Einkaufsseitig ist der Schreiber der ZahlungsAUSGANG: Zahlungen werden quellseitig als OutgoingPayment-Datensaetze erfasst (Ledger mit Referenz auf den Rechnungskopf), der moderne Beleg-Save schreibt Bezahlt nicht - jede Pflege des Zahlstatus muss einen neuen Voll-Snapshot publizieren (Offset-LWW). Wie die Spalte gepflegt wird (Legacy-Zahlungsausgang vs. producer-seitige Aggregation aus OutgoingPayment) ist Klaerungspunkt des Handoffs. KEIN Mahnwesen: KalkKopf traegt keine Mahnfelder - die Dunning-Felder der Kunden-Rechnung entfallen ersatzlos. -
ProjectNumber optional stringDefault:
nullProjektnummer der Eingangsrechnung (Quelle ProjNr); DB nullable. -
IsStandalone optional booleanDefault:
nullOb die Eingangsrechnung eigenstaendig (ohne Wareneingangs-Bezug) erfasst wurde (Quelle IsSupplierInvoiceStandalone, non-null mit Default false). Unterscheidet die reine Eingangsrechnung von der abrechnenden WE-Kalkulation; bei true sind die Vorbeleg-Referenzen regelmaessig null. -
ReasonText optional stringDefault:
nullBeleggrund als Text (Quelle WEKalkulationGrundText, Kopie zum Save-Zeitpunkt); DB nullable. Das Grund-Stammdatum selbst (WEKalkulationGrundI3D) hat keine UUID-Identitaet und ist kein Topic-Kandidat - nur die Text-Kopie reist mit (Konvention wie ReasonText des Wareneingangs). -
Positions Liste optional SupplierInvoicePosition[]Default:
nullEingebettete Positionsliste (KalkPos), aufsteigend nach PositionNumber; alle Zeilenarten (Artikel-, Text-, Gruppen-, Summenpositionen - siehe Kind). Voll-Snapshot: der Consumer ersetzt die Collection je Event vollstaendig (kein positionsweises Mergen). Default [] nur fuer Schema-Evolution.15 Felder von
SupplierInvoicePosition[]-
PositionNumber intDefault:
0Interne Positionsnummer (Quelle Pos, Sortierung; quellseitig non-null geschrieben). -
DisplayPositionNumber optional stringDefault:
nullAngezeigte Positionsnummer (z. B. 1.2); DB nullable. -
Kind intDefault:
0Positionsart (Quelle Art, ReceiptItemKind: 0 = Gruppenkopf, 1 = Artikel, 2 = Freitext, 3 = Kundenrabatt, 4 = Gesamtsumme, 5 = Zwischensumme, 6 = Titelposition, 7 = Stammdatenliste, 11/12 = Fracht/Versicherung). Quellseitig speichert KalkPos den Gruppenkopf als NULL - die Projektion reist ueber die moderne Kind-Property als 0 = Gruppenkopf. -
Default:
nullReferenz auf das Artikel-Stammdatum ueber dessen UUID. Null fuer Zeilen ohne Artikel (Text-/Gruppen-/Summenpositionen) - deshalb optional, obwohl Artikelpositionen sie fachlich immer tragen. -
ArticleCode optional stringDefault:
nullFachlicher Artikelcode der Position (Quelle Artikelcode, Kopie zum Save-Zeitpunkt); DB nullable. -
SupplierArticleCode optional stringDefault:
nullArtikelcode beim Lieferanten (Quelle Kreditorcode); DB nullable. Einkaufsspezifisch, Kopie aus der Bestell-/Wareneingangs-Kette. -
Text optional stringDefault:
nullPositionstext (Quelle Text bzw. Freitext je nach Kind, analog der Quell-Projektion); DB nullable. -
Quantity optional doubleDefault:
nullAbgerechnete Menge der Position (Quelle Stk); quellseitig nullable. -
QuantityProcessed optional doubleDefault:
nullDurch Folgebelege gutgeschriebene Menge (Quelle StkGutgeschrieben, Lieferanten-Gutschrift-Buchung); wird auch am Beleg-Save vorbei fortgeschrieben (SaveReceiptAfterOriginUpdate) - jede Fortschreibung erzeugt einen neuen Voll-Snapshot. Quellseitig int-Spalte, als double projiziert (Mengen-Konvention der Beleg-Schemas). -
BasePrice optional decimal(18,4)Default:
nullEinkaufs-Einzelpreis der Position (Quelle Preis - bei der Eingangsrechnung ist das der abgerechnete Einkaufspreis, es gibt keine getrennte VK/EK-Spalte und keinen Positionsrabatt); quellseitig nullable float, beim Publish kaufmaennisch auf 4 Nachkommastellen gerundet. -
Default:
nullReferenz auf das Mehrwertsteuersatz-Stammdatum der Position (Quelle MwStI3D) ueber dessen UUID; quellseitig nullable. -
VatRate optional decimal(6,2)Default:
nullMehrwertsteuersatz der Position in Prozent (Quelle MwStSatz, Kopie zum Save-Zeitpunkt); quellseitig nullable. -
Default:
nullReferenz auf die Kostenstelle der Position (Quelle Kostenstelle) ueber deren UUID; quellseitig nullable. Einkaufsspezifisch: Die FiBu-Kontierung liegt bei der Eingangsrechnung auf der POSITION - der Kopf traegt keine Kostenstellen-/Kostentraeger-FKs (anders als die Kunden-Rechnung). -
Default:
nullReferenz auf den Kostentraeger der Position (Quelle Kostentraeger) ueber dessen UUID; quellseitig nullable. -
ExpenseAccount optional intDefault:
nullFiBu-Aufwandskonto der Position (Quelle AufwandKTO, Sachkonto-Nummer); DB nullable. Bewusst als fachliche Kontonummer und nicht als UUID-Referenz - Sachkonten sind kein Topic-Kandidat (Konten-Stammdaten liegen in der FiBu, vgl. Topic-Zuschnitt Anhang C).
-
-
Receivers Liste optional SupplierInvoiceReceiver[]Default:
nullEingebettete Beleg-Empfaenger (ReceiptReceivers, Cascade am Kopf): nur belegte Slots reisen mit, unterschieden per Kind. Voll-Snapshot: der Consumer ersetzt die Collection je Event vollstaendig. Default [] nur fuer Schema-Evolution.11 Felder von
SupplierInvoiceReceiver[]-
Kind intDefault:
0Empfaenger-Slot am Belegkopf: 0 = Standard, 1 = Rechnung, 2 = Lieferung, 3 = Lizenznehmer. -
CompanyName optional stringDefault:
nullFirmenname des Empfaengers; DB nullable. -
ContactName optional stringDefault:
nullAnsprechpartner-Name; DB nullable. -
Department optional stringDefault:
nullAbteilung; DB nullable. -
Street optional stringDefault:
nullStrasse; DB nullable. -
HouseNumber optional stringDefault:
nullHausnummer; DB nullable. -
PostOfficeBox optional stringDefault:
nullPostfach; DB nullable. -
Zip optional stringDefault:
nullPostleitzahl; DB nullable. -
City optional stringDefault:
nullOrt; DB nullable. -
Default:
nullReferenz auf das Laender-Stammdatum ueber dessen UUID; quellseitig nullable. -
Default:
nullReferenz auf den Account, aus dem der Empfaenger stammt, ueber dessen UUID; quellseitig nullable.
-
-
-
Default:
nullUUID des aendernden Mitarbeiters (Employee, Quelle GeaendertVonI3D); null, wenn unbekannt (z. B. Fortschreibung durch Folgebeleg-Buchung). -
ChangedAt timestampZeitpunkt der Aenderung als UTC-Instant.
Referenziert von
- Lieferanten-Gutschrift
SupplierCreditVoucherPatch.Data.SupplierInvoiceUuid - Lieferanten-Gutschrift
SupplierCreditVoucherState.SupplierInvoiceUuid
Rohfassung
Schema dieser Fassung (Avro)
{
"type": "record",
"name": "SupplierInvoicePatch",
"namespace": "com.nexoware.connect.events",
"doc": "Vertragsentwurf: typisierte Teilaenderung fuer Lieferanten-Rechnung. Nur ChangedFields werden angewandt; null leert nur nullable State-Einheiten. Listen und Unterobjekte sind atomare Ersetzungen mit vollstaendigem Inhalt. Fachliche Freigabe und Regeln gekoppelter Werte sind offen; siehe docs/contracts/supplierinvoice.md.",
"fields": [
{
"name": "EventId",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Beim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch."
},
{
"name": "SupplierInvoiceUuid",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Stabile, global eindeutige Identitaet der Lieferanten-Rechnung (Matching-Schluessel; zugleich Message-Key). Bleibt ueber Belegversionen hinweg identisch (die historischen Kopien in KalkKopf teilen sie, sind aber ueber AktuelleVersion = 0 vom eindeutigen Live-Stand ausgenommen)."
},
{
"name": "Mode",
"type": {
"type": "enum",
"name": "PatchMode",
"doc": "CHANGE: lokal autorisierte Aenderung, LWW je Einheit nach Kafka-Reihenfolge. INITIAL_LOAD: Erstbefuellung beim Anschluss eines Produkts - setzt eine Einheit nur, wenn sie noch nie geschrieben wurde; ueberschreibt nie einen vorhandenen oder ausdruecklich geleerten Wert. Bewusst ohne Enum-Default: ein unbekannter kuenftiger Modus darf nicht still als CHANGE gelesen werden.",
"symbols": [
"CHANGE",
"INITIAL_LOAD"
]
}
},
{
"name": "ChangedFields",
"type": {
"type": "array",
"items": "string"
},
"doc": "Explizite Maske der geaenderten Top-Level-Einheiten; keine Wildcards, Identitaets- oder Auditfelder. Listen und Records werden als Ganzes ersetzt."
},
{
"name": "Data",
"type": {
"type": "record",
"name": "SupplierInvoicePatchData",
"doc": "Werte der maskierten Einheiten. null ausserhalb der Maske wird ignoriert; innerhalb der Maske entscheidet die Nullability im State.",
"fields": [
{
"name": "SupplierInvoiceNumber",
"type": [
"null",
"int"
],
"doc": "Fachliche Belegnummer der Eingangsrechnung (Quelle Nummer; im modernen Schreibpfad aus der Nummerngruppe vergeben, eigener Nummernraum getrennt von der Kunden-Rechnung). Vorlagen (negative Nummer) werden nicht publiziert. Die Rechnungsnummer des Lieferanten reist getrennt als ExternalInvoiceNumber. Nur bei Anlage; fixedAfterCreate.",
"default": null
},
{
"name": "Version",
"type": [
"null",
"int"
],
"doc": "Belegversion dieses Snapshots (neue Versionen derselben Eingangsrechnung ueberschreiben per LWW; alle Versionen liegen in KalkKopf selbst, nur die Live-Zeile mit AktuelleVersion = 1 wird publiziert).",
"default": null
},
{
"name": "State",
"type": [
"null",
"int"
],
"doc": "LWW-Statusfeld (Quelle Status, ReceiptState: 1 = aktiv/offen, 2 = abgeschlossen, 3 = storniert). Deaktivierung/Storno reist als Voll-Snapshot mit State = 3, kein Tombstone. Wird auch vom Folgebeleg-Zweitschreiber geschrieben (Lieferanten-Gutschrift-Buchung, SaveReceiptAfterOriginUpdate: Status + gutgeschriebene Mengen) - jede Fortschreibung erzeugt einen neuen Voll-Snapshot. Der Wert 0 sendet der Producer nie; er ist allein der Schema-Evolutions-Default fuer Leser, deren Writer-Schema das Feld noch nicht kannte, und darf nicht als Status ausgewertet werden.",
"default": null
},
{
"name": "AccountUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Pflicht-Referenz auf den Lieferanten (Account mit Supplier-Facette, QS-1) ueber dessen UUID. Quellseitig ist KreditorI3D die Kreditor-Nummer (AccountSupplier.Number); der Producer loest sie ueber AccountSupplier -> AccountTypeToAccount -> Account auf. Kann der Producer sie nicht aufloesen, scheitert die Avro-Projektion laut (Failed-Outbox-Zeile) statt still null zu senden.",
"default": null
},
{
"name": "SupplierOrderUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Vorbeleg-Referenz auf die Bestellung ueber deren UUID. Optional nach Quell-Garantie: nicht jede Eingangsrechnung hat eine Bestellung als Vorbeleg. Producer-seitig aus den Positions-Urspruengen abgeleitet (UebernommenAusArt 7 = Bestellung): genau EINE eindeutige Ursprungs-Bestellung -> deren UUID; keine oder mehrere unterschiedliche Bestellungen -> null (es gibt dann keinen EINEN Vorbeleg).",
"default": null
},
{
"name": "SupplierDeliveryListUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Vorbeleg-Referenz auf den Wareneingang (Lieferanten-Lieferschein) ueber dessen UUID - der Regelfall der WE-Kalkulation: die Eingangsrechnung rechnet Wareneingaenge ab. Optional nach Quell-Garantie (Standalone-Erfassung ohne Wareneingangs-Bezug, siehe IsStandalone); Ableitung analog SupplierOrderUuid aus den Positions-Urspruengen (UebernommenAusArt 8 = Wareneingang): genau EIN eindeutiger Ursprungs-Wareneingang -> dessen UUID, sonst null.",
"default": null
},
{
"name": "SupplierInvoiceDate",
"type": [
"null",
{
"type": "long",
"logicalType": "timestamp-millis"
}
],
"doc": "Belegdatum als UTC-Instant (Quelle Datum; Quell-Property des modernen Schreibpfads non-null; Host-lokale Zeit, beim Publish nach UTC konvertiert). Das Rechnungsdatum des Lieferanten reist getrennt als ExternalInvoiceDate.",
"default": null
},
{
"name": "DeliveryDate",
"type": [
"null",
{
"type": "long",
"logicalType": "timestamp-millis"
}
],
"doc": "Lieferdatum der Eingangsrechnung (Quelle Lieferdatum); DB nullable.",
"default": null
},
{
"name": "DueDate",
"type": [
"null",
{
"type": "long",
"logicalType": "timestamp-millis"
}
],
"doc": "Faelligkeitsdatum der Eingangsrechnung (Quelle FaelligAm, beim Save aus der Lieferanten-Zahlungskondition uebernommen); DB nullable. Basis der Kreditoren-Opos-Ableitung beim Konsumenten (QS-5).",
"default": null
},
{
"name": "ExternalInvoiceNumber",
"type": [
"null",
"string"
],
"doc": "Rechnungsnummer des Lieferanten (Quelle RechnungsNr - der externe Beleg, gegen den die Eingangsrechnung erfasst wurde; die Duplikatpruefung der Quelle laeuft ueber dieses Feld); DB nullable. Einkaufsspezifisch - das Gegenstueck zur eigenen fachlichen SupplierInvoiceNumber.",
"default": null
},
{
"name": "ExternalInvoiceDate",
"type": [
"null",
{
"type": "long",
"logicalType": "timestamp-millis"
}
],
"doc": "Rechnungsdatum des Lieferanten (Quelle RechnungsDatum); DB nullable.",
"default": null
},
{
"name": "AssetConditionUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf die Belegkondition (Lieferanten-Zahlungskondition, Quelle ZahlKondI3D -> Zahkond) ueber deren UUID; quellseitig nullable. Eine Lieferbedingungs-Referenz existiert am Kopf der Eingangsrechnung nicht.",
"default": null
},
{
"name": "BranchUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf die Filiale des Belegs (Quelle BranchI3D -> Filiale) ueber deren UUID; quellseitig nullable. 0/NULL im Quell-FK bedeutet 'Hauptsitz (keine Filiale)' (BranchBL.GetHeadquarter) - der Hauptsitz ist KEIN Filiale-Datensatz, die Referenz reist dann als null. Die Begleitspalte BranchOrigin (Herkunft der Filial-Zuordnung) ist Prozess-Detail und kein Vertragsfeld (Filial-FK-Befund, Topic-Zuschnitt Anhang A Nr. 9).",
"default": null
},
{
"name": "CurrencyIso",
"type": [
"null",
"string"
],
"doc": "ISO-Waehrungskennzeichen des Belegs (Quelle CurrencyString); DB nullable.",
"default": null
},
{
"name": "CurrencyFactor",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 18,
"scale": 6
}
],
"doc": "Umrechnungsfaktor der Belegwaehrung zur Hauswaehrung; quellseitig non-null geschrieben (moderner Schreibpfad), beim Publish kaufmaennisch auf 6 Nachkommastellen gerundet.",
"default": null
},
{
"name": "NetTotal",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 18,
"scale": 2
}
],
"doc": "Netto-Gesamtsumme der Eingangsrechnung inklusive Fracht/Versicherung (Quelle KalkKopf.NettobetragGesamt, von der Quelle nach dem Save per Raw-UPDATE berechnet); DB nullable, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet. Die reinen Positionssummen (Nettobetrag/SummeNetto) sind Zwischenwerte derselben Berechnung und keine Vertragsfelder.",
"default": null
},
{
"name": "GrossTotal",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 18,
"scale": 2
}
],
"doc": "Brutto-Gesamtsumme der Eingangsrechnung (Quelle KalkKopf.BruttobetragGesamt, von der Quelle nach dem Save per Raw-UPDATE inkl. MwSt-Behandlung von Fracht/Versicherung berechnet); DB nullable, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet.",
"default": null
},
{
"name": "FreightAmount",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 18,
"scale": 2
}
],
"doc": "Frachtkosten der Eingangsrechnung (Quelle Frachtkosten); quellseitig nullable float, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet. Die Verteilungs-Modi (FrachtVerteilung) und die positionsweise verteilten Anteile sind Kalkulations-Prozessdetail und keine Vertragsfelder.",
"default": null
},
{
"name": "InsuranceAmount",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 18,
"scale": 2
}
],
"doc": "Versicherungskosten der Eingangsrechnung (Quelle Versicherung); quellseitig nullable float, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet. Verteilung auf Positionen analog Fracht - Prozessdetail.",
"default": null
},
{
"name": "Paid",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 18,
"scale": 2
}
],
"doc": "Bereits bezahlter Betrag in Belegwaehrung (Quelle KalkKopf.Bezahlt, QS-5: der Zahlstatus reist als Kopf-Feld, kein eigenes Opos- oder Zahlungs-Topic; offener Posten = Ableitung aus GrossTotal minus Paid); DB nullable. Einkaufsseitig ist der Schreiber der ZahlungsAUSGANG: Zahlungen werden quellseitig als OutgoingPayment-Datensaetze erfasst (Ledger mit Referenz auf den Rechnungskopf), der moderne Beleg-Save schreibt Bezahlt nicht - jede Pflege des Zahlstatus muss einen neuen Voll-Snapshot publizieren (Offset-LWW). Wie die Spalte gepflegt wird (Legacy-Zahlungsausgang vs. producer-seitige Aggregation aus OutgoingPayment) ist Klaerungspunkt des Handoffs. KEIN Mahnwesen: KalkKopf traegt keine Mahnfelder - die Dunning-Felder der Kunden-Rechnung entfallen ersatzlos.",
"default": null
},
{
"name": "ProjectNumber",
"type": [
"null",
"string"
],
"doc": "Projektnummer der Eingangsrechnung (Quelle ProjNr); DB nullable.",
"default": null
},
{
"name": "IsStandalone",
"type": [
"null",
"boolean"
],
"doc": "Ob die Eingangsrechnung eigenstaendig (ohne Wareneingangs-Bezug) erfasst wurde (Quelle IsSupplierInvoiceStandalone, non-null mit Default false). Unterscheidet die reine Eingangsrechnung von der abrechnenden WE-Kalkulation; bei true sind die Vorbeleg-Referenzen regelmaessig null.",
"default": null
},
{
"name": "ReasonText",
"type": [
"null",
"string"
],
"doc": "Beleggrund als Text (Quelle WEKalkulationGrundText, Kopie zum Save-Zeitpunkt); DB nullable. Das Grund-Stammdatum selbst (WEKalkulationGrundI3D) hat keine UUID-Identitaet und ist kein Topic-Kandidat - nur die Text-Kopie reist mit (Konvention wie ReasonText des Wareneingangs).",
"default": null
},
{
"name": "Positions",
"type": [
"null",
{
"type": "array",
"items": {
"type": "record",
"name": "SupplierInvoicePosition",
"fields": [
{
"name": "PositionNumber",
"type": "int",
"doc": "Interne Positionsnummer (Quelle Pos, Sortierung; quellseitig non-null geschrieben).",
"default": 0
},
{
"name": "DisplayPositionNumber",
"type": [
"null",
"string"
],
"doc": "Angezeigte Positionsnummer (z. B. 1.2); DB nullable.",
"default": null
},
{
"name": "Kind",
"type": "int",
"doc": "Positionsart (Quelle Art, ReceiptItemKind: 0 = Gruppenkopf, 1 = Artikel, 2 = Freitext, 3 = Kundenrabatt, 4 = Gesamtsumme, 5 = Zwischensumme, 6 = Titelposition, 7 = Stammdatenliste, 11/12 = Fracht/Versicherung). Quellseitig speichert KalkPos den Gruppenkopf als NULL - die Projektion reist ueber die moderne Kind-Property als 0 = Gruppenkopf.",
"default": 0
},
{
"name": "ArticleUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf das Artikel-Stammdatum ueber dessen UUID. Null fuer Zeilen ohne Artikel (Text-/Gruppen-/Summenpositionen) - deshalb optional, obwohl Artikelpositionen sie fachlich immer tragen.",
"default": null
},
{
"name": "ArticleCode",
"type": [
"null",
"string"
],
"doc": "Fachlicher Artikelcode der Position (Quelle Artikelcode, Kopie zum Save-Zeitpunkt); DB nullable.",
"default": null
},
{
"name": "SupplierArticleCode",
"type": [
"null",
"string"
],
"doc": "Artikelcode beim Lieferanten (Quelle Kreditorcode); DB nullable. Einkaufsspezifisch, Kopie aus der Bestell-/Wareneingangs-Kette.",
"default": null
},
{
"name": "Text",
"type": [
"null",
"string"
],
"doc": "Positionstext (Quelle Text bzw. Freitext je nach Kind, analog der Quell-Projektion); DB nullable.",
"default": null
},
{
"name": "Quantity",
"type": [
"null",
"double"
],
"doc": "Abgerechnete Menge der Position (Quelle Stk); quellseitig nullable.",
"default": null
},
{
"name": "QuantityProcessed",
"type": [
"null",
"double"
],
"doc": "Durch Folgebelege gutgeschriebene Menge (Quelle StkGutgeschrieben, Lieferanten-Gutschrift-Buchung); wird auch am Beleg-Save vorbei fortgeschrieben (SaveReceiptAfterOriginUpdate) - jede Fortschreibung erzeugt einen neuen Voll-Snapshot. Quellseitig int-Spalte, als double projiziert (Mengen-Konvention der Beleg-Schemas).",
"default": null
},
{
"name": "BasePrice",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 18,
"scale": 4
}
],
"doc": "Einkaufs-Einzelpreis der Position (Quelle Preis - bei der Eingangsrechnung ist das der abgerechnete Einkaufspreis, es gibt keine getrennte VK/EK-Spalte und keinen Positionsrabatt); quellseitig nullable float, beim Publish kaufmaennisch auf 4 Nachkommastellen gerundet.",
"default": null
},
{
"name": "VatUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf das Mehrwertsteuersatz-Stammdatum der Position (Quelle MwStI3D) ueber dessen UUID; quellseitig nullable.",
"default": null
},
{
"name": "VatRate",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 6,
"scale": 2
}
],
"doc": "Mehrwertsteuersatz der Position in Prozent (Quelle MwStSatz, Kopie zum Save-Zeitpunkt); quellseitig nullable.",
"default": null
},
{
"name": "CostCenterUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf die Kostenstelle der Position (Quelle Kostenstelle) ueber deren UUID; quellseitig nullable. Einkaufsspezifisch: Die FiBu-Kontierung liegt bei der Eingangsrechnung auf der POSITION - der Kopf traegt keine Kostenstellen-/Kostentraeger-FKs (anders als die Kunden-Rechnung).",
"default": null
},
{
"name": "CostObjectUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf den Kostentraeger der Position (Quelle Kostentraeger) ueber dessen UUID; quellseitig nullable.",
"default": null
},
{
"name": "ExpenseAccount",
"type": [
"null",
"int"
],
"doc": "FiBu-Aufwandskonto der Position (Quelle AufwandKTO, Sachkonto-Nummer); DB nullable. Bewusst als fachliche Kontonummer und nicht als UUID-Referenz - Sachkonten sind kein Topic-Kandidat (Konten-Stammdaten liegen in der FiBu, vgl. Topic-Zuschnitt Anhang C).",
"default": null
}
]
}
}
],
"doc": "Eingebettete Positionsliste (KalkPos), aufsteigend nach PositionNumber; alle Zeilenarten (Artikel-, Text-, Gruppen-, Summenpositionen - siehe Kind). Voll-Snapshot: der Consumer ersetzt die Collection je Event vollstaendig (kein positionsweises Mergen). Default [] nur fuer Schema-Evolution.",
"default": null
},
{
"name": "Receivers",
"type": [
"null",
{
"type": "array",
"items": {
"type": "record",
"name": "SupplierInvoiceReceiver",
"fields": [
{
"name": "Kind",
"type": "int",
"doc": "Empfaenger-Slot am Belegkopf: 0 = Standard, 1 = Rechnung, 2 = Lieferung, 3 = Lizenznehmer.",
"default": 0
},
{
"name": "CompanyName",
"type": [
"null",
"string"
],
"doc": "Firmenname des Empfaengers; DB nullable.",
"default": null
},
{
"name": "ContactName",
"type": [
"null",
"string"
],
"doc": "Ansprechpartner-Name; DB nullable.",
"default": null
},
{
"name": "Department",
"type": [
"null",
"string"
],
"doc": "Abteilung; DB nullable.",
"default": null
},
{
"name": "Street",
"type": [
"null",
"string"
],
"doc": "Strasse; DB nullable.",
"default": null
},
{
"name": "HouseNumber",
"type": [
"null",
"string"
],
"doc": "Hausnummer; DB nullable.",
"default": null
},
{
"name": "PostOfficeBox",
"type": [
"null",
"string"
],
"doc": "Postfach; DB nullable.",
"default": null
},
{
"name": "Zip",
"type": [
"null",
"string"
],
"doc": "Postleitzahl; DB nullable.",
"default": null
},
{
"name": "City",
"type": [
"null",
"string"
],
"doc": "Ort; DB nullable.",
"default": null
},
{
"name": "CountryUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf das Laender-Stammdatum ueber dessen UUID; quellseitig nullable.",
"default": null
},
{
"name": "AccountUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf den Account, aus dem der Empfaenger stammt, ueber dessen UUID; quellseitig nullable.",
"default": null
}
]
}
}
],
"doc": "Eingebettete Beleg-Empfaenger (ReceiptReceivers, Cascade am Kopf): nur belegte Slots reisen mit, unterschieden per Kind. Voll-Snapshot: der Consumer ersetzt die Collection je Event vollstaendig. Default [] nur fuer Schema-Evolution.",
"default": null
}
]
}
},
{
"name": "ChangedByUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "UUID des aendernden Mitarbeiters (Employee, Quelle GeaendertVonI3D); null, wenn unbekannt (z. B. Fortschreibung durch Folgebeleg-Buchung).",
"default": null,
"references": "Employee"
},
{
"name": "ChangedAt",
"type": {
"type": "long",
"logicalType": "timestamp-millis"
},
"doc": "Zeitpunkt der Aenderung als UTC-Instant."
}
],
"aggregate": "SupplierInvoice",
"label": "Lieferanten-Rechnung",
"topic": "supplierinvoice.patch",
"key": "SupplierInvoiceUuid",
"cleanupPolicy": "delete",
"retentionMs": 2592000000,
"partitions": 1,
"writers": [
"centron"
],
"requiredOnCreate": [
"SupplierInvoiceNumber",
"Version",
"State",
"AccountUuid",
"SupplierInvoiceDate",
"CurrencyFactor",
"IsStandalone"
],
"fixedAfterCreate": [
"SupplierInvoiceNumber"
]
}