Anfrage State

{
  "type": "record",
  "name": "SupplierOfferState",
  "namespace": "com.nexoware.connect.events",
  "doc": "Vertragsentwurf: vollstaendiger veroeffentlichter Zustand fuer Anfrage. Feldumfang aus dem archivierten SupplierOfferChanged; kein fachlicher Vergleich beider Produkte. Einziger State-Writer ist merge; Produkte veroeffentlichen typisierte Patches. Grenzen, Migration und offene Fachregeln: docs/contracts/supplieroffer.md.",
  "fields": [
    {
      "name": "SupplierOfferUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet der Lieferanten-Anfrage (Matching-Schluessel; zugleich Message-Key). Bleibt ueber Belegversionen hinweg identisch (die historischen Kopien in AnfrKopf teilen sie, sind aber ueber AktuelleVersion = 0 vom eindeutigen Live-Stand ausgenommen)."
    },
    {
      "name": "SupplierOfferNumber",
      "type": "int",
      "doc": "Fachliche Anfragenummer (Business-Key, Quelle Nummer; eigener Nummernraum getrennt vom Kunden-Angebot). Vorlagen werden nicht publiziert."
    },
    {
      "name": "Version",
      "type": "int",
      "doc": "Belegversion dieses Snapshots (neue Versionen derselben Anfrage ueberschreiben per LWW; alle Versionen liegen in AnfrKopf selbst, nur die Live-Zeile mit AktuelleVersion = 1 wird publiziert)."
    },
    {
      "name": "State",
      "type": "int",
      "doc": "LWW-Statusfeld (Quelle Status, ReceiptState-Konvention: 1 = aktiv). Deaktivierung reist als Voll-Snapshot mit geaendertem State, kein Tombstone. 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 der direkte Fremdschluessel auf Kreditor.I3D (anders als bei der Bestellung, die die Kreditor-Nummer haelt); der Producer loest 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": "SupplierOfferDate",
      "type": [
        "null",
        {
          "type": "long",
          "logicalType": "timestamp-millis"
        }
      ],
      "doc": "Belegdatum als UTC-Instant (Quelle Datum; Host-lokale Zeit, beim Publish nach UTC konvertiert). DB nullable - die Anfrage hat keinen modernen Schreibpfad, der Non-Null garantiert.",
      "default": null
    },
    {
      "name": "DeliveryDate",
      "type": [
        "null",
        {
          "type": "long",
          "logicalType": "timestamp-millis"
        }
      ],
      "doc": "Gewuenschter Liefertermin der Anfrage (Quelle Lieferdatum); DB nullable. Positionsgenaue Wunschtermine reisen je Position (DeliveryDate der Position, Quelle LieferdatumSoll).",
      "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.",
      "default": null
    },
    {
      "name": "DeliveryConditionUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Referenz auf die Lieferbedingung (Quelle LieferbedingungI3D -> Zahkond, dasselbe Konditions-Stammdatum wie AssetConditionUuid) ueber deren UUID; quellseitig nullable.",
      "default": null,
      "references": "AssetCondition"
    },
    {
      "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 (Filial-FK-Befund, Topic-Zuschnitt Anhang A Nr. 9).",
      "default": null
    },
    {
      "name": "OrderUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "Querreferenz auf den ausloesenden Kunden-Auftrag (Quelle AuftragI3D -> AufKopf) ueber dessen UUID; quellseitig nullable. KEINE Vorbeleg-Referenz (die Anfrage ist Kettenanfang der Einkaufskette) - sie verknuepft die Einkaufs- mit der Verkaufskette, wenn die Anfrage aus einem Kunden-Auftrag heraus entstanden ist.",
      "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; DB nullable (die Quelle behandelt NULL als 1), 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 Anfrage (Quelle AnfrKopf.SummeNetto); DB nullable, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet. Ein Brutto-Kopfsummenfeld existiert auf AnfrKopf nicht; die MwSt-Splits der Preis-Views sind berechnet und keine Vertragsfelder.",
      "default": null
    },
    {
      "name": "IsDirectDelivery",
      "type": [
        "null",
        "boolean"
      ],
      "doc": "Ob Direktlieferung (Streckengeschaeft an den Endempfaenger) angefragt ist (Quelle Direktlieferung 0/1); DB nullable, die Quelle behandelt NULL als false.",
      "default": null
    },
    {
      "name": "Receiver",
      "type": [
        "null",
        "string"
      ],
      "doc": "Empfaenger-Anschrift der Anfrage als formatierter Textblock (Quelle Empfanger, Kopie zum Save-Zeitpunkt); DB nullable. ANDERS als die uebrigen Beleg-Schemas: AnfrKopf traegt keine ReceiptReceiver-Slots (kein modernes Beleg-Framework), deshalb reist hier das flache Quellfeld statt eines Receivers-Arrays.",
      "default": null
    },
    {
      "name": "Positions",
      "type": {
        "type": "array",
        "items": {
          "type": "record",
          "name": "SupplierOfferPosition",
          "fields": [
            {
              "name": "PositionNumber",
              "type": "int",
              "doc": "Interne Positionsnummer (Quelle Pos, Sortierung; quellseitig non-null).",
              "default": 0
            },
            {
              "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).",
              "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 - analog Bestellung.",
              "default": null
            },
            {
              "name": "Manufacturer",
              "type": [
                "null",
                "string"
              ],
              "doc": "Hersteller des angefragten Artikels (Quelle Hersteller); DB nullable. Anfragespezifisch: identifiziert das angefragte Produkt auch ohne eigenes Artikel-Stammdatum.",
              "default": null
            },
            {
              "name": "ManufacturerArticleCode",
              "type": [
                "null",
                "string"
              ],
              "doc": "Artikelcode des Herstellers (Quelle Herstellercode); DB nullable.",
              "default": null
            },
            {
              "name": "EanCode",
              "type": [
                "null",
                "string"
              ],
              "doc": "EAN/GTIN des angefragten Artikels (Quelle EANCode); DB nullable.",
              "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": "Angefragte Menge (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 Anfrage ist das der angefragte/erwartete Einkaufspreis, es gibt keine getrennte VK/EK-Spalte und keinen Positionsrabatt); quellseitig nullable float, beim Publish kaufmaennisch auf 4 Nachkommastellen gerundet.",
              "default": null
            },
            {
              "name": "DeliveryDate",
              "type": [
                "null",
                {
                  "type": "long",
                  "logicalType": "timestamp-millis"
                }
              ],
              "doc": "Gewuenschter Liefertermin der Position (Quelle LieferdatumSoll); DB nullable.",
              "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
            }
          ]
        }
      },
      "doc": "Eingebettete Positionsliste (AnfrPos), 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: AnfrPos traegt - anders als BestPos2 - keine StkGeliefert-Spalte; der Uebernahme-Fortschritt in die Bestellung reist im Bestellungs-Event (BestPos2.UebernommenAusArt = 15).",
      "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.",
      "default": null,
      "references": "Employee"
    },
    {
      "name": "ChangedAt",
      "type": {
        "type": "long",
        "logicalType": "timestamp-millis"
      },
      "doc": "Zeitpunkt der Aenderung als UTC-Instant."
    }
  ],
  "aggregate": "SupplierOffer",
  "label": "Anfrage",
  "topic": "supplieroffer.state",
  "key": "SupplierOfferUuid",
  "cleanupPolicy": "compact",
  "partitions": 1,
  "writers": [
    "merge"
  ],
  "readers": [
    "centron",
    "nexoware-erp"
  ]
}