Lieferanten-Rechnung State

{
  "type": "record",
  "name": "SupplierInvoiceState",
  "namespace": "com.nexoware.connect.events",
  "doc": "Vertragsentwurf: vollstaendiger veroeffentlichter Zustand fuer Lieferanten-Rechnung. Feldumfang aus dem archivierten SupplierInvoiceChanged; kein fachlicher Vergleich beider Produkte. Einziger State-Writer ist merge; Produkte veroeffentlichen typisierte Patches. Grenzen, Migration und offene Fachregeln: docs/contracts/supplierinvoice.md.",
  "fields": [
    {
      "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": "SupplierInvoiceNumber",
      "type": "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."
    },
    {
      "name": "Version",
      "type": "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)."
    },
    {
      "name": "State",
      "type": "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."
    },
    {
      "name": "AccountUuid",
      "type": {
        "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."
    },
    {
      "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": {
        "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."
    },
    {
      "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": {
        "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."
    },
    {
      "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": "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."
    },
    {
      "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": {
        "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": []
    },
    {
      "name": "Receivers",
      "type": {
        "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": []
    },
    {
      "name": "Revision",
      "type": "long",
      "doc": "Anzahl der zustandsaendernden Patches seit Anlage; vom Zusammenfuehrungsdienst gesetzt."
    },
    {
      "name": "LastEventId",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "EventId des zuletzt angewandten Patches; vom Zusammenfuehrungsdienst gesetzt."
    },
    {
      "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.state",
  "key": "SupplierInvoiceUuid",
  "cleanupPolicy": "compact",
  "partitions": 1,
  "writers": [
    "merge"
  ],
  "readers": [
    "centron",
    "nexoware-erp"
  ]
}