Artikel Patch

{
  "type": "record",
  "name": "ArticlePatch",
  "namespace": "com.nexoware.connect.events",
  "doc": "Vertragsentwurf: typisierte Teilaenderung fuer Artikel. 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/article.md.",
  "fields": [
    {
      "name": "EventId",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Beim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch."
    },
    {
      "name": "ArticleUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet des Artikels (Matching-Schluessel; zugleich Message-Key)."
    },
    {
      "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": "ArticlePatchData",
        "doc": "Werte der maskierten Einheiten. null ausserhalb der Maske wird ignoriert; innerhalb der Maske entscheidet die Nullability im State.",
        "fields": [
          {
            "name": "ArticleCode",
            "type": [
              "null",
              "string"
            ],
            "doc": "Fachlicher Artikelcode (Business-Key, quellseitig unique + non-null; Uebergangs-Matching-Fallback).",
            "default": null
          },
          {
            "name": "ManufacturerCode",
            "type": [
              "null",
              "string"
            ],
            "doc": "Herstellernummer/-code des Artikels; DB nullable.",
            "default": null
          },
          {
            "name": "EANCode",
            "type": [
              "null",
              "string"
            ],
            "doc": "EAN/GTIN des Artikels; DB nullable.",
            "default": null
          },
          {
            "name": "ShortDescription",
            "type": [
              "null",
              "string"
            ],
            "doc": "Kurzbegriff des Artikels; DB nullable.",
            "default": null
          },
          {
            "name": "Description",
            "type": [
              "null",
              "string"
            ],
            "doc": "Artikelbeschreibung (Langtext); DB nullable.",
            "default": null
          },
          {
            "name": "MaterialGroupUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Referenz auf das Warengruppen-Stammdatum ueber dessen UUID; quellseitig nullable.",
            "default": null
          },
          {
            "name": "VatUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Referenz auf das Mehrwertsteuersatz-Stammdatum ueber dessen UUID; Altdaten koennen ohne Satz sein.",
            "default": null
          },
          {
            "name": "ArticleUnitUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Referenz auf das Artikeleinheiten-Stammdatum ueber dessen UUID; quellseitig nullable.",
            "default": null
          },
          {
            "name": "ManufacturerUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Rollenreferenz: der Hersteller ist ein Geschaeftspartner (Account mit Manufacturer-Facette, QS-1) und reist ueber dessen UUID (vormals ManufacturerI3D). Erst damit kann ein Consumer den Herstellernamen aus dem AccountState beziehen, statt ihn aufgeloest mitzuschicken. Null ohne Hersteller-Bezug.",
            "default": null,
            "references": "Account"
          },
          {
            "name": "Price1",
            "type": [
              "null",
              {
                "type": "bytes",
                "logicalType": "decimal",
                "precision": 18,
                "scale": 4
              }
            ],
            "doc": "Verkaufspreis 1 (netto); quellseitig non-null float, beim Publish kaufmaennisch auf 4 Nachkommastellen gerundet.",
            "default": null
          },
          {
            "name": "Price2",
            "type": [
              "null",
              {
                "type": "bytes",
                "logicalType": "decimal",
                "precision": 18,
                "scale": 4
              }
            ],
            "doc": "Verkaufspreis 2 (netto).",
            "default": null
          },
          {
            "name": "Price3",
            "type": [
              "null",
              {
                "type": "bytes",
                "logicalType": "decimal",
                "precision": 18,
                "scale": 4
              }
            ],
            "doc": "Verkaufspreis 3 (netto).",
            "default": null
          },
          {
            "name": "Price4",
            "type": [
              "null",
              {
                "type": "bytes",
                "logicalType": "decimal",
                "precision": 18,
                "scale": 4
              }
            ],
            "doc": "Verkaufspreis 4 (netto).",
            "default": null
          },
          {
            "name": "EVP",
            "type": [
              "null",
              {
                "type": "bytes",
                "logicalType": "decimal",
                "precision": 18,
                "scale": 4
              }
            ],
            "doc": "Empfohlener Verkaufspreis (EVK).",
            "default": null
          },
          {
            "name": "ListPrice",
            "type": [
              "null",
              {
                "type": "bytes",
                "logicalType": "decimal",
                "precision": 18,
                "scale": 4
              }
            ],
            "doc": "Listenpreis.",
            "default": null
          },
          {
            "name": "PurchasePrice",
            "type": [
              "null",
              {
                "type": "bytes",
                "logicalType": "decimal",
                "precision": 18,
                "scale": 4
              }
            ],
            "doc": "Einkaufspreis (EK, Hauptlager). Wird auch ausserhalb der Stammpflege fortgeschrieben (EK-Fortschreibung beim Wareneingang) - jede Fortschreibung erzeugt ein eigenes ArticleState.",
            "default": null
          },
          {
            "name": "State",
            "type": [
              "null",
              "int"
            ],
            "doc": "LWW-Statusfeld: 1 = aktiv, 0 = deaktiviert (Quellflag EOL/End-of-Life; Soft-Delete, kein Tombstone).",
            "default": null
          },
          {
            "name": "Blocked",
            "type": [
              "null",
              "boolean"
            ],
            "doc": "Artikel gesperrt (Gesperrt-Flag der Quelle); unabhaengig vom LWW-Status.",
            "default": null
          },
          {
            "name": "Deliverable",
            "type": [
              "null",
              "boolean"
            ],
            "doc": "Artikel lieferbar (Lieferbar-Flag der Quelle).",
            "default": null
          },
          {
            "name": "NotDiscountable",
            "type": [
              "null",
              "boolean"
            ],
            "doc": "Artikel nicht rabattierbar.",
            "default": null
          },
          {
            "name": "VisibleOnWeb",
            "type": [
              "null",
              "boolean"
            ],
            "doc": "Artikel im Web-Portal sichtbar.",
            "default": null
          },
          {
            "name": "Vpe",
            "type": [
              "null",
              "int"
            ],
            "doc": "Verpackungseinheit (Menge je Gebinde); non-null Quell-Property.",
            "default": null
          },
          {
            "name": "Precision",
            "type": [
              "null",
              "int"
            ],
            "doc": "Nachkommastellen der artikel-individuellen Preis-/Mengenrundung in der Quelle (Kontext zu den decimal(18,4)-Preisfeldern).",
            "default": null
          },
          {
            "name": "MinimumOrderQuantity",
            "type": [
              "null",
              "double"
            ],
            "doc": "Mindestbestellmenge; DB nullable.",
            "default": null
          },
          {
            "name": "DeliveryTime",
            "type": [
              "null",
              "int"
            ],
            "doc": "Lieferzeit in Tagen; non-null Quell-Property.",
            "default": null
          },
          {
            "name": "Length",
            "type": [
              "null",
              "double"
            ],
            "doc": "Laenge (Abmessung); non-null Quell-Property.",
            "default": null
          },
          {
            "name": "Width",
            "type": [
              "null",
              "double"
            ],
            "doc": "Breite (Abmessung).",
            "default": null
          },
          {
            "name": "Height",
            "type": [
              "null",
              "double"
            ],
            "doc": "Hoehe (Abmessung).",
            "default": null
          },
          {
            "name": "Volume",
            "type": [
              "null",
              "double"
            ],
            "doc": "Volumen.",
            "default": null
          },
          {
            "name": "NetWeight",
            "type": [
              "null",
              "double"
            ],
            "doc": "Nettogewicht.",
            "default": null
          },
          {
            "name": "GrossWeight",
            "type": [
              "null",
              "double"
            ],
            "doc": "Bruttogewicht.",
            "default": null
          },
          {
            "name": "GoodsNumber",
            "type": [
              "null",
              "string"
            ],
            "doc": "Warennummer (FiBu/Zoll); DB nullable.",
            "default": null
          },
          {
            "name": "CustomsNumber",
            "type": [
              "null",
              "string"
            ],
            "doc": "Zolltarifnummer; DB nullable.",
            "default": null
          },
          {
            "name": "IntrastatNumber",
            "type": [
              "null",
              "string"
            ],
            "doc": "Intrastat-Nummer; DB nullable.",
            "default": null
          }
        ]
      }
    },
    {
      "name": "ChangedByUuid",
      "type": [
        "null",
        {
          "type": "string",
          "logicalType": "uuid"
        }
      ],
      "doc": "UUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt.",
      "default": null,
      "references": "Employee"
    },
    {
      "name": "ChangedAt",
      "type": {
        "type": "long",
        "logicalType": "timestamp-millis"
      },
      "doc": "Zeitpunkt der Aenderung als UTC-Instant."
    }
  ],
  "aggregate": "Article",
  "label": "Artikel",
  "topic": "article.patch",
  "key": "ArticleUuid",
  "cleanupPolicy": "delete",
  "retentionMs": 2592000000,
  "partitions": 1,
  "writers": [
    "centron",
    "nexoware-erp"
  ],
  "requiredOnCreate": [
    "ArticleCode",
    "Price1",
    "Price2",
    "Price3",
    "Price4",
    "EVP",
    "ListPrice",
    "PurchasePrice",
    "State",
    "Blocked",
    "Deliverable",
    "NotDiscountable",
    "VisibleOnWeb",
    "Vpe",
    "Precision",
    "DeliveryTime",
    "Length",
    "Width",
    "Height",
    "Volume",
    "NetWeight",
    "GrossWeight"
  ]
}