NEXOWARE ConnectSchema-Explorer · Kafka-Backbone

Verträge / MaterialGroupPatch

Warengruppe Patch

MaterialGroupPatch · com.nexoware.connect.events

Aggregat
MaterialGroup · State MaterialGroupState
Topic
materialgroup.patch je Mandant mit Präfix, z. B. <mandant>.materialgroup.patch
Key
MaterialGroupUuid
Nachrichtenart
Patch — ausdrückliche Teiländerungen, zusammengeführt vom Zusammenführungsdienst
Schreiber
c-entron Webservice (centron) , NEXOWARE.ERP (nexoware-erp)
Retention
30 Tage
Fassung
Version 1 (neueste)
Schema-ID
102

Patch-Pfad

Pflicht bei Anlage
MaterialGroupID, State, RevenueAccount

Vertragsentwurf: typisierte Teilaenderung fuer Warengruppe. 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/materialgroup.md.

Fassungen

Felder

Referenziert von

Rohfassung

Schema dieser Fassung (Avro) 
{
  "type": "record",
  "name": "MaterialGroupPatch",
  "namespace": "com.nexoware.connect.events",
  "doc": "Vertragsentwurf: typisierte Teilaenderung fuer Warengruppe. 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/materialgroup.md.",
  "fields": [
    {
      "name": "EventId",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Beim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch."
    },
    {
      "name": "MaterialGroupUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet der Warengruppe (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": "MaterialGroupPatchData",
        "doc": "Werte der maskierten Einheiten. null ausserhalb der Maske wird ignoriert; innerhalb der Maske entscheidet die Nullability im State.",
        "fields": [
          {
            "name": "MaterialGroupID",
            "type": [
              "null",
              "int"
            ],
            "doc": "Fachliche Warengruppen-Nummer (Attribut; Uebergangs-Matching-Fallback).",
            "default": null
          },
          {
            "name": "Name",
            "type": [
              "null",
              "string"
            ],
            "default": null
          },
          {
            "name": "VatUuid",
            "type": [
              "null",
              {
                "type": "string",
                "logicalType": "uuid"
              }
            ],
            "doc": "Referenz auf das Mehrwertsteuersatz-Stammdatum ueber dessen UUID (vormals VatI3D).",
            "default": null
          },
          {
            "name": "State",
            "type": [
              "null",
              "int"
            ],
            "default": null
          },
          {
            "name": "RevenueAccount",
            "type": [
              "null",
              "int"
            ],
            "doc": "Erloeskonto (fachliches Attribut; quellseitig non-null garantiert, ADR-0006).",
            "default": null
          },
          {
            "name": "Markups",
            "type": [
              "null",
              {
                "type": "array",
                "items": {
                  "type": "record",
                  "name": "MaterialMarkup",
                  "fields": [
                    {
                      "name": "TillEk",
                      "type": {
                        "type": "bytes",
                        "logicalType": "decimal",
                        "precision": 18,
                        "scale": 2
                      },
                      "doc": "Obere Einkaufspreis-Staffelgrenze (bis-EK), bis zu der dieser Eintrag gilt; quellseitig non-null double, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet (ADR-0006).",
                      "default": "\u0000"
                    },
                    {
                      "name": "Vk1Procent",
                      "type": {
                        "type": "bytes",
                        "logicalType": "decimal",
                        "precision": 6,
                        "scale": 2
                      },
                      "doc": "Aufschlag in Prozent fuer Verkaufspreis 1; quellseitig non-null double, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet (ADR-0006).",
                      "default": "\u0000"
                    },
                    {
                      "name": "Vk2Procent",
                      "type": {
                        "type": "bytes",
                        "logicalType": "decimal",
                        "precision": 6,
                        "scale": 2
                      },
                      "doc": "Aufschlag in Prozent fuer Verkaufspreis 2.",
                      "default": "\u0000"
                    },
                    {
                      "name": "Vk3Procent",
                      "type": {
                        "type": "bytes",
                        "logicalType": "decimal",
                        "precision": 6,
                        "scale": 2
                      },
                      "doc": "Aufschlag in Prozent fuer Verkaufspreis 3.",
                      "default": "\u0000"
                    },
                    {
                      "name": "Vk4Procent",
                      "type": {
                        "type": "bytes",
                        "logicalType": "decimal",
                        "precision": 6,
                        "scale": 2
                      },
                      "doc": "Aufschlag in Prozent fuer Verkaufspreis 4.",
                      "default": "\u0000"
                    },
                    {
                      "name": "MarkupEVKProcent",
                      "type": [
                        "null",
                        {
                          "type": "bytes",
                          "logicalType": "decimal",
                          "precision": 6,
                          "scale": 2
                        }
                      ],
                      "doc": "Aufschlag in Prozent fuer den empfohlenen Verkaufspreis (EVK); quellseitig nullable double.",
                      "default": null
                    },
                    {
                      "name": "MarkupMinPriceProcent",
                      "type": {
                        "type": "bytes",
                        "logicalType": "decimal",
                        "precision": 6,
                        "scale": 2
                      },
                      "doc": "Aufschlag in Prozent fuer den Mindestpreis.",
                      "default": "\u0000"
                    }
                  ]
                }
              }
            ],
            "doc": "Eingebettete Staffel-Aufschlaege (Warenaufschlaege), ein Eintrag je EK-Staffelgrenze, aufsteigend nach TillEk; nur quellseitig aktive Zeilen. Voll-Snapshot: der Consumer ersetzt die Collection je Event vollstaendig (kein Mergen einzelner Eintraege). Default [] deckt Altdaten vor dieser Erweiterung ab.",
            "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": "MaterialGroup",
  "label": "Warengruppe",
  "topic": "materialgroup.patch",
  "key": "MaterialGroupUuid",
  "cleanupPolicy": "delete",
  "retentionMs": 2592000000,
  "partitions": 1,
  "writers": [
    "centron",
    "nexoware-erp"
  ],
  "requiredOnCreate": [
    "MaterialGroupID",
    "State",
    "RevenueAccount"
  ]
}