Rechnung State

{
  "type": "record",
  "name": "InvoiceState",
  "namespace": "com.nexoware.connect.events",
  "doc": "Kanonischer Vertrag, Version 1: der vollstaendige zusammengefuehrte Zustand einer Rechnung (Verkaufsbeleg, Quelle c-entron RechKopf/RechPos): Kopf mit eingebetteter Positionsliste und eingebetteten Beleg-Empfaengern. Positions und Receivers sind je eine Liste und damit je eine Einheit, die ein Patch als Ganzes ersetzt. Einziger Writer ist der Zusammenfuehrungsdienst (ADR-0023 Punkt 2 und 4); die Produkte schreiben Patches auf invoice.patch und lesen diesen State mit isolation.level=read_committed. Identitaet und alle Referenzen ausschliesslich ueber UUID; quell-lokale IDs sind nicht Teil des Vertrags. Zahl- und Mahnstatus sind Einheiten dieses Vertrags - es gibt kein eigenes Opos-, Zahlungs- oder Mahnungs-Topic; ein offener Posten ist eine Ableitung aus GrossTotal (bzw. NetTotal bei MwSt-freien Belegen) minus Paid. Anzahlungs- und Schlussrechnungen und Rechnungen aus Abrechnungslaeufen sind normale Rechnungen. Storno ist State = 3, kein Tombstone. Geldfelder als decimal, kaufmaennisch gerundet (ADR-0006). Feldumfang 1:1 aus dem Bestandsvertrag InvoiceChanged (archiviert), ergaenzt um Revision und LastEventId. Fachliche Anforderungen: docs/contracts/invoice.md.",
  "fields": [
    {
      "name": "InvoiceUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet der Rechnung; zugleich Message-Key auf State und Patch. Bleibt ueber Belegversionen hinweg identisch."
    },
    {
      "name": "InvoiceNumber",
      "type": "int",
      "doc": "Fachliche Rechnungsnummer (Business-Key; quellseitig non-null). Vorlagen (negative Nummer) werden nicht publiziert. Pflicht bei Anlage und danach unveraenderlich: Ein Patch vergibt keine Nummer neu."
    },
    {
      "name": "Version",
      "type": "int",
      "doc": "Belegversion (quellseitig non-null). Pflicht bei Anlage - kein Default; eine neue Belegversion ist ein Patch auf diese Einheit."
    },
    {
      "name": "State",
      "type": "int",
      "doc": "LWW-Statusfeld (ReceiptState: 1 = aktiv/offen, 2 = abgeschlossen/bezahlt, 3 = storniert). Storno ist ein Patch mit State = 3, kein Tombstone. Wird auch von Zahlungsbuchung und SEPA-Export-Abschluss geschrieben (Abschluss = State 2). Pflicht bei Anlage - kein Default, damit 0 keinen Status vortaeuscht."
    },
    {
      "name": "AccountUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Pflicht-Referenz auf den Kunden (AccountState) ueber dessen UUID; Pflicht bei Anlage, danach aenderbar (docs/contracts/invoice.md, OFFEN-6). Kann der Producer sie nicht aufloesen, scheitert er laut, statt still null zu senden."
    },
    {
      "name": "OrderUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Vorbeleg-Referenz auf den Auftrag ueber dessen UUID. Optional nach Quell-Garantie: nicht jede Rechnung hat einen Auftrag als Vorbeleg. Producer-seitig aus den Positions-Urspruengen abgeleitet (UrsprungArt 1 = Auftrag): genau EIN eindeutiger Ursprungs-Auftrag -> dessen UUID; kein oder mehrere unterschiedliche Auftraege -> null (es gibt dann keinen EINEN Vorbeleg).",
      "default": null
    },
    {
      "name": "DeliveryListUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Vorbeleg-Referenz auf den Lieferschein ueber dessen UUID. Optional nach Quell-Garantie; Ableitung analog OrderUuid aus den Positions-Urspruengen (UrsprungArt 2 = Lieferschein): genau EIN eindeutiger Ursprungs-Lieferschein -> dessen UUID, sonst null.",
      "default": null
    },
    {
      "name": "InvoiceDate",
      "type": {
        "type": "long",
        "logicalType": "timestamp-millis"
      },
      "doc": "Belegdatum als UTC-Instant (Quell-Property non-null; Host-lokale Zeit, beim Publish nach UTC konvertiert). Pflicht bei Anlage."
    },
    {
      "name": "DeliveryDate",
      "type": [
        "null",
        {
          "type": "long",
          "logicalType": "timestamp-millis"
        }
      ],
      "doc": "Lieferdatum der Rechnung (Quelle Lieferdatum); DB nullable.",
      "default": null
    },
    {
      "name": "DueDate",
      "type": [
        "null",
        {
          "type": "long",
          "logicalType": "timestamp-millis"
        }
      ],
      "doc": "Faelligkeitsdatum der Rechnung (Quelle FaelligAm, beim Save aus der Zahlungskondition berechnet); DB nullable. Basis der Opos-Ableitung beim Konsumenten.",
      "default": null
    },
    {
      "name": "AssetConditionUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Referenz auf die Belegkondition (Zahlungskondition der Rechnung, Quelle ZahlKondID -> Zahkond) ueber deren UUID; quellseitig nullable.",
      "default": null
    },
    {
      "name": "DeliveryConditionUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Referenz auf die Lieferbedingung (Quelle LieferBedID -> Zahkond, dasselbe Konditions-Stammdatum wie AssetConditionUuid) ueber deren UUID; quellseitig nullable.",
      "default": null
    },
    {
      "name": "CostCenterUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Referenz auf die Kostenstelle des Kopfes ueber deren UUID; quellseitig nullable.",
      "default": null
    },
    {
      "name": "CostObjectUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Referenz auf den Kostentraeger des Kopfes ueber dessen UUID; quellseitig nullable.",
      "default": null
    },
    {
      "name": "BranchUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Referenz auf die Filiale des Belegs (Quelle FilialI3D -> 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. Der zweite Quell-FK FilialgeberI3D ist bewusst kein Vertragsfeld - kein konzernweiter Konsument benannt.",
      "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, beim Publish kaufmaennisch auf 6 Nachkommastellen gerundet. Pflicht bei Anlage."
    },
    {
      "name": "NetTotal",
      "type": [
        "null",
        {
          "type": "bytes",
          "logicalType": "decimal",
          "precision": 18,
          "scale": 2
        }
      ],
      "doc": "Netto-Gesamtsumme der Rechnung (Quelle RechKopf.Netto, von der Quelle nach dem Save berechnet); DB nullable, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet.",
      "default": null
    },
    {
      "name": "GrossTotal",
      "type": [
        "null",
        {
          "type": "bytes",
          "logicalType": "decimal",
          "precision": 18,
          "scale": 2
        }
      ],
      "doc": "Brutto-Gesamtsumme der Rechnung (Quelle RechKopf.Brutto); DB nullable.",
      "default": null
    },
    {
      "name": "Paid",
      "type": [
        "null",
        {
          "type": "bytes",
          "logicalType": "decimal",
          "precision": 18,
          "scale": 2
        }
      ],
      "doc": "Bereits bezahlter Betrag in Belegwaehrung (Quelle RechKopf.Bezahlt). Wird von Zahlungsbuchung, PaidFC-Rueckschreibung aus Folgebelegen und SEPA-Export-Abschluss geschrieben - jede Aenderung ist ein Patch auf diese Einheit. Offener Posten = Ableitung aus GrossTotal (bzw. NetTotal bei MwSt-freien Belegen) minus Paid; DB nullable.",
      "default": null
    },
    {
      "name": "PaidDifference",
      "type": [
        "null",
        {
          "type": "bytes",
          "logicalType": "decimal",
          "precision": 18,
          "scale": 2
        }
      ],
      "doc": "Akzeptierte Zahldifferenz (Quelle RechKopf.BezahltDifferenz, z. B. Skonto/Rundung beim Zahlungsausgleich); DB nullable.",
      "default": null
    },
    {
      "name": "DunningLevel",
      "type": [
        "null",
        "int"
      ],
      "doc": "Aktuelle Mahnstufe (Quelle RechKopf.Mahnstufe: 0 = keine, 1-3 = Mahnstufe 1-3). Wird vom Mahnlauf geschrieben (Ausfuehren erhoeht, Zuruecksetzen senkt) - je betroffener Rechnung ein Patch auf diese Einheit; DB nullable.",
      "default": null
    },
    {
      "name": "DunningStop",
      "type": [
        "null",
        "boolean"
      ],
      "doc": "Mahnsperre der Rechnung (Quelle RechKopf.MahnStop, int 0/1 als boolean projiziert); DB nullable = nie gepflegt.",
      "default": null
    },
    {
      "name": "DunningStopBegin",
      "type": [
        "null",
        {
          "type": "long",
          "logicalType": "timestamp-millis"
        }
      ],
      "doc": "Beginn der befristeten Mahnsperre; DB nullable.",
      "default": null
    },
    {
      "name": "DunningStopEnd",
      "type": [
        "null",
        {
          "type": "long",
          "logicalType": "timestamp-millis"
        }
      ],
      "doc": "Ende der befristeten Mahnsperre; DB nullable.",
      "default": null
    },
    {
      "name": "DunningLevel1Date",
      "type": [
        "null",
        {
          "type": "long",
          "logicalType": "timestamp-millis"
        }
      ],
      "doc": "Datum der Mahnung Stufe 1 (Quelle Mahnung1Datum); DB nullable, wird beim Zuruecksetzen des Mahnlaufs wieder genullt.",
      "default": null
    },
    {
      "name": "DunningLevel2Date",
      "type": [
        "null",
        {
          "type": "long",
          "logicalType": "timestamp-millis"
        }
      ],
      "doc": "Datum der Mahnung Stufe 2 (Quelle Mahnung2Datum); DB nullable.",
      "default": null
    },
    {
      "name": "DunningLevel3Date",
      "type": [
        "null",
        {
          "type": "long",
          "logicalType": "timestamp-millis"
        }
      ],
      "doc": "Datum der Mahnung Stufe 3 (Quelle Mahnung3Datum); DB nullable.",
      "default": null
    },
    {
      "name": "ProjectNumber",
      "type": [
        "null",
        "string"
      ],
      "doc": "Projektnummer der Rechnung; DB nullable.",
      "default": null
    },
    {
      "name": "PurchaseOrderNumber",
      "type": [
        "null",
        "string"
      ],
      "doc": "Bestellnummer des Kunden (Quelle BestNr); DB nullable.",
      "default": null
    },
    {
      "name": "Positions",
      "type": {
        "type": "array",
        "items": {
          "type": "record",
          "name": "InvoicePosition",
          "fields": [
            {
              "name": "PositionNumber",
              "type": "int",
              "doc": "Interne Positionsnummer (Sortierung; quellseitig non-null).",
              "default": 0
            },
            {
              "name": "DisplayPositionNumber",
              "type": [
                "null",
                "string"
              ],
              "doc": "Angezeigte Positionsnummer (z. B. 1.2); DB nullable.",
              "default": null
            },
            {
              "name": "Kind",
              "type": "int",
              "doc": "Positionsart (ReceiptItemKind: 0 = Gruppenkopf, 1 = Artikel, 2 = Freitext, 3 = Kundenrabatt, 4 = Gesamtsumme, 5 = Zwischensumme, 6 = Titelposition, 7 = Stammdatenliste, 11/12 = Fracht/Versicherung).",
              "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 (Kopie zum Save-Zeitpunkt); DB nullable.",
              "default": null
            },
            {
              "name": "Text",
              "type": [
                "null",
                "string"
              ],
              "doc": "Positionstext (Artikel-/Freitext je nach Kind); DB nullable.",
              "default": null
            },
            {
              "name": "Quantity",
              "type": [
                "null",
                "double"
              ],
              "doc": "Berechnete Menge der Position (Quelle Stk); quellseitig nullable.",
              "default": null
            },
            {
              "name": "QuantityProcessed",
              "type": [
                "null",
                "double"
              ],
              "doc": "Durch Folgebelege verarbeitete Menge (Quelle numGutAbhol, z. B. Gutschrift-Buchung); wird auch am SaveReceipt vorbei fortgeschrieben - jede Fortschreibung ersetzt die Positionsliste als Ganzes.",
              "default": null
            },
            {
              "name": "BasePrice",
              "type": [
                "null",
                {
                  "type": "bytes",
                  "logicalType": "decimal",
                  "precision": 18,
                  "scale": 4
                }
              ],
              "doc": "Netto-Einzelpreis der Position (Quelle VKBasisWert, vor Rabatt); quellseitig nullable float, beim Publish kaufmaennisch auf 4 Nachkommastellen gerundet.",
              "default": null
            },
            {
              "name": "Discount",
              "type": {
                "type": "bytes",
                "logicalType": "decimal",
                "precision": 6,
                "scale": 2
              },
              "doc": "Positionsrabatt in Prozent; quellseitig non-null Property, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet.",
              "default": "\u0000"
            },
            {
              "name": "VatUuid",
              "type": [
                "null",
                {
                  "type": "string",
                  "logicalType": "uuid"
                }
              ],
              "doc": "Referenz auf das Mehrwertsteuersatz-Stammdatum der Position 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 (Kopie zum Save-Zeitpunkt); quellseitig nullable.",
              "default": null
            },
            {
              "name": "PurchasePrice",
              "type": [
                "null",
                {
                  "type": "bytes",
                  "logicalType": "decimal",
                  "precision": 18,
                  "scale": 4
                }
              ],
              "doc": "Einkaufspreis der Position (Quelle EK); quellseitig nullable.",
              "default": null
            }
          ]
        }
      },
      "doc": "Eingebettete Positionsliste (RechPos), aufsteigend nach PositionNumber; alle Zeilenarten (Artikel-, Text-, Gruppen-, Summenpositionen - siehe Kind). Eine Liste ist eine Einheit: Ein Patch ersetzt sie als Ganzes (kein positionsweises Mergen), die leere Liste ist ein Wert, null nicht. Default [] fuer die Anlage ohne Positionen.",
      "default": []
    },
    {
      "name": "Receivers",
      "type": {
        "type": "array",
        "items": {
          "type": "record",
          "name": "InvoiceReceiver",
          "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. Eine Liste ist eine Einheit: Ein Patch ersetzt sie als Ganzes, die leere Liste ist ein Wert, null nicht. Default [] fuer die Anlage ohne Empfaenger.",
      "default": []
    },
    {
      "name": "Revision",
      "type": "long",
      "doc": "Anzahl der zustandsaendernden Patches seit Erstanlage. Streng monoton je Objekt - Consumer ueberspringen Revisionen <= der zuletzt uebernommenen."
    },
    {
      "name": "LastEventId",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "EventId des zuletzt angewandten Patches (Diagnose)."
    },
    {
      "name": "ChangedByUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "UUID des aendernden Mitarbeiters (Employee) aus dem zuletzt angewandten Patch; null, wenn unbekannt (z. B. Fortschreibung durch Folgebeleg-Buchung).",
      "default": null
    },
    {
      "name": "ChangedAt",
      "type": {
        "type": "long",
        "logicalType": "timestamp-millis"
      },
      "doc": "Audit aus dem zuletzt angewandten Patch als UTC-Instant - kein Konfliktentscheider, es entscheidet die Kafka-Reihenfolge der Patches."
    }
  ],
  "aggregate": "Invoice",
  "label": "Rechnung",
  "topic": "invoice.state",
  "key": "InvoiceUuid",
  "cleanupPolicy": "compact",
  "partitions": 1,
  "writers": [
    "merge"
  ],
  "readers": [
    "centron",
    "nexoware-erp"
  ]
}