Lieferanten-Gutschrift Patch

{
  "type": "record",
  "name": "SupplierCreditVoucherPatch",
  "namespace": "com.nexoware.connect.events",
  "doc": "Vertragsentwurf: typisierte Teilaenderung fuer Lieferanten-Gutschrift. 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/suppliercreditvoucher.md.",
  "fields": [
    {
      "name": "EventId",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Beim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch."
    },
    {
      "name": "SupplierCreditVoucherUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet der Lieferanten-Gutschrift (Matching-Schluessel; zugleich Message-Key). Bleibt ueber Belegversionen hinweg identisch (die historischen Kopien in LiGutKopf 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": "SupplierCreditVoucherPatchData",
        "doc": "Werte der maskierten Einheiten. null ausserhalb der Maske wird ignoriert; innerhalb der Maske entscheidet die Nullability im State.",
        "fields": [
          {
            "name": "SupplierCreditVoucherNumber",
            "type": [
              "null",
              "int"
            ],
            "doc": "Fachliche Belegnummer der Lieferanten-Gutschrift (Quelle Nummer; aus der Nummerngruppe Lieferantengutschrift vergeben, eigener Nummernraum getrennt von der Kunden-Gutschrift). Vorlagen (negative Nummer) werden nicht publiziert. Die Gutschriftsnummer des Lieferanten reist getrennt als ExternalCreditVoucherNumber. Nur bei Anlage; fixedAfterCreate.",
            "default": null
          },
          {
            "name": "Version",
            "type": [
              "null",
              "int"
            ],
            "doc": "Belegversion dieses Snapshots (neue Versionen derselben Lieferanten-Gutschrift ueberschreiben per LWW; alle Versionen liegen in LiGutKopf 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. Einziger Schreiber ist der Beleg-Save - die Lieferanten-Gutschrift ist Endbeleg ohne Folgebeleg-Zweitschreiber. 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": "SupplierInvoiceUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Vorbeleg-Referenz auf die Eingangsrechnung (Lieferanten-Rechnung) ueber deren UUID - gespiegelt zur InvoiceUuid der Kunden-Gutschrift. Optional nach Quell-Garantie: frei erfasste Lieferanten-Gutschriften ohne Rechnungsbezug existieren. Producer-seitig aus den Positions-Urspruengen abgeleitet (UebernommenAusArt 18 = Eingangsrechnung - die Quelle laesst nur diesen Vorbeleg zu): genau EINE eindeutige Ursprungs-Eingangsrechnung -> deren UUID; keine oder mehrere unterschiedliche Rechnungen -> null (es gibt dann keinen EINEN Vorbeleg).",
            "default": null
          },
          {
            "name": "SupplierCreditVoucherDate",
            "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 Gutschriftsdatum des Lieferanten reist getrennt als ExternalCreditVoucherDate.",
            "default": null
          },
          {
            "name": "ExternalCreditVoucherNumber",
            "type": [
              "null",
              "string"
            ],
            "doc": "Gutschriftsnummer des Lieferanten (Quelle GutschriftsNr - der externe Beleg, gegen den die Lieferanten-Gutschrift erfasst wurde; die Duplikatpruefung der Quelle laeuft ueber dieses Feld); DB nullable. Einkaufsspezifisch - das Gegenstueck zur eigenen fachlichen SupplierCreditVoucherNumber (Konvention wie ExternalInvoiceNumber der Eingangsrechnung).",
            "default": null
          },
          {
            "name": "ExternalCreditVoucherDate",
            "type": [
              "null",
              {
                "type": "long",
                "logicalType": "timestamp-millis"
              }
            ],
            "doc": "Gutschriftsdatum des Lieferanten (Quelle GutschriftsDatum); 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 Lieferanten-Gutschrift 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 Lieferanten-Gutschrift inklusive Fracht/Versicherung (Quelle LiGutKopf.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. Vorzeichen wie in der Quelle: die Gutschrift ist als eigener Beleg positiv erfasst, die buchhalterische Negativ-Wirkung ergibt sich aus der Belegart.",
            "default": null
          },
          {
            "name": "GrossTotal",
            "type": [
              "null",
              {
                "type": "bytes",
                "logicalType": "decimal",
                "precision": 18,
                "scale": 2
              }
            ],
            "doc": "Brutto-Gesamtsumme der Lieferanten-Gutschrift (Quelle LiGutKopf.BruttobetragGesamt, von der Quelle nach dem Save per Raw-UPDATE 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 Lieferanten-Gutschrift (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 Lieferanten-Gutschrift (Quelle Versicherung); quellseitig nullable float, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet. Verteilung auf Positionen analog Fracht - Prozessdetail.",
            "default": null
          },
          {
            "name": "ReasonText",
            "type": [
              "null",
              "string"
            ],
            "doc": "Gutschriftsgrund als Text (Quelle LiGutschriftGrundText, Kopie des Grund-Stammdatums zum Save-Zeitpunkt); DB nullable. Das Grund-Stammdatum selbst (LiGutschriftGrundI3D) traegt keine UUID und reist deshalb nicht als Referenz (Konvention wie ReasonText der Kunden-Gutschrift).",
            "default": null
          },
          {
            "name": "Positions",
            "type": [
              "null",
              {
                "type": "array",
                "items": {
                  "type": "record",
                  "name": "SupplierCreditVoucherPosition",
                  "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 LiGutPos 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 Einkaufs-Belegkette.",
                      "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": "Gutgeschriebene Menge der Position (Quelle Stk); quellseitig nullable.",
                      "default": null
                    },
                    {
                      "name": "BasePrice",
                      "type": [
                        "null",
                        {
                          "type": "bytes",
                          "logicalType": "decimal",
                          "precision": 18,
                          "scale": 4
                        }
                      ],
                      "doc": "Einkaufs-Einzelpreis der Position (Quelle Preis - bei der Lieferanten-Gutschrift ist das der gutgeschriebene 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 Lieferanten-Gutschrift auf der POSITION - der Kopf traegt keine Kostenstellen-/Kostentraeger-FKs (anders als die Kunden-Gutschrift).",
                      "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 (LiGutPos), 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. KEIN QuantityProcessed: die Lieferanten-Gutschrift ist Endbeleg (keine Folgebelege), die Quelle schreibt keine verarbeiteten Mengen (die Read-only-View liefert konstant 0).",
            "default": null
          },
          {
            "name": "Receivers",
            "type": [
              "null",
              {
                "type": "array",
                "items": {
                  "type": "record",
                  "name": "SupplierCreditVoucherReceiver",
                  "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.",
      "default": null,
      "references": "Employee"
    },
    {
      "name": "ChangedAt",
      "type": {
        "type": "long",
        "logicalType": "timestamp-millis"
      },
      "doc": "Zeitpunkt der Aenderung als UTC-Instant."
    }
  ],
  "aggregate": "SupplierCreditVoucher",
  "label": "Lieferanten-Gutschrift",
  "topic": "suppliercreditvoucher.patch",
  "key": "SupplierCreditVoucherUuid",
  "cleanupPolicy": "delete",
  "retentionMs": 2592000000,
  "partitions": 1,
  "writers": [
    "centron"
  ],
  "requiredOnCreate": [
    "SupplierCreditVoucherNumber",
    "Version",
    "State",
    "AccountUuid",
    "SupplierCreditVoucherDate",
    "CurrencyFactor"
  ],
  "fixedAfterCreate": [
    "SupplierCreditVoucherNumber"
  ]
}