Verträge / AccountTypePatch
Geschäftspartner-Art Patch
AccountTypePatch · com.nexoware.connect.events
- Aggregat
- AccountType · State AccountTypeState
- Topic
- accounttype.patch je Mandant mit Präfix, z. B.
<mandant>.accounttype.patch - Key
- AccountTypeUuid
- Nachrichtenart
- Patch — ausdrückliche Teiländerungen, zusammengeführt vom Zusammenführungsdienst
- Schreiber
- c-entron Webservice (centron)
- Retention
- 30 Tage
- Fassung
- Version 1 (neueste)
- Schema-ID
- 42
Patch-Pfad
- Pflicht bei Anlage
- Kind, State
Vertragsentwurf: typisierte Teilaenderung fuer Geschäftspartner-Art. 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/accounttype.md.
Fassungen
Felder
-
EventId ↗ extern: EventId uuidBeim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch.
-
AccountTypeUuid Key uuidStabile, global eindeutige Identitaet der Geschaeftspartner-Art (Matching-Schluessel; zugleich Message-Key).
-
Mode enum(CHANGE|INITIAL_LOAD)
-
ChangedFields Liste string[]Explizite Maske der geaenderten Top-Level-Einheiten; keine Wildcards, Identitaets- oder Auditfelder. Listen und Records werden als Ganzes ersetzt.
-
Data AccountTypePatchData
3 Felder von
AccountTypePatchData-
Name optional stringDefault:
nullBezeichnung der Art, wie sie in c-entron gepflegt wird. -
Kind optional intDefault:
nullQuellseitige Klassifikation der Art (AccountTypeKind; 0 = unbestimmt). Der Legacy-CustomerSync erkennt Webshop-Kunden an der Art mit Kind SpecialTypeCustomerKind6 — welcher Zahlenwert das ist, steht in keiner Inventur und ist am Quellcode zu bestaetigen. Die Auswertung gehoert dem Consumer: das Schema transportiert die Klassifikation, nicht die Webshop-Entscheidung. -
State optional intDefault:
null
-
-
Default:
nullUUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt. -
ChangedAt timestampZeitpunkt der Aenderung als UTC-Instant.
Referenziert von
Kein Vertrag verweist auf diesen.
Rohfassung
Schema dieser Fassung (Avro)
{
"type": "record",
"name": "AccountTypePatch",
"namespace": "com.nexoware.connect.events",
"doc": "Vertragsentwurf: typisierte Teilaenderung fuer Geschäftspartner-Art. 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/accounttype.md.",
"fields": [
{
"name": "EventId",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Beim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch."
},
{
"name": "AccountTypeUuid",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Stabile, global eindeutige Identitaet der Geschaeftspartner-Art (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": "AccountTypePatchData",
"doc": "Werte der maskierten Einheiten. null ausserhalb der Maske wird ignoriert; innerhalb der Maske entscheidet die Nullability im State.",
"fields": [
{
"name": "Name",
"type": [
"null",
"string"
],
"doc": "Bezeichnung der Art, wie sie in c-entron gepflegt wird.",
"default": null
},
{
"name": "Kind",
"type": [
"null",
"int"
],
"doc": "Quellseitige Klassifikation der Art (AccountTypeKind; 0 = unbestimmt). Der Legacy-CustomerSync erkennt Webshop-Kunden an der Art mit Kind SpecialTypeCustomerKind6 — welcher Zahlenwert das ist, steht in keiner Inventur und ist am Quellcode zu bestaetigen. Die Auswertung gehoert dem Consumer: das Schema transportiert die Klassifikation, nicht die Webshop-Entscheidung.",
"default": null
},
{
"name": "State",
"type": [
"null",
"int"
],
"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": "AccountType",
"label": "Geschäftspartner-Art",
"topic": "accounttype.patch",
"key": "AccountTypeUuid",
"cleanupPolicy": "delete",
"retentionMs": 2592000000,
"partitions": 1,
"writers": [
"centron"
],
"requiredOnCreate": [
"Kind",
"State"
]
}