Verträge / AssetConditionPatch
Belegkondition Patch
AssetConditionPatch · com.nexoware.connect.events
- Aggregat
- AssetCondition · State AssetConditionState
- Topic
- assetcondition.patch je Mandant mit Präfix, z. B.
<mandant>.assetcondition.patch - Key
- AssetConditionUuid
- 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
- 58
Patch-Pfad
- Pflicht bei Anlage
- State, BelongsToInvoice, CustomerDeliveryCondition, Skonto1OffDay, Skonto1Percent, Skonto2OffDay, Skonto2Percent, Skonto3OffDay, DueKind, DuePlusDays, DueAtDay, DuePlusMonths
Vertragsentwurf: typisierte Teilaenderung fuer Belegkondition. 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/assetcondition.md.
Fassungen
Felder
-
EventId ↗ extern: EventId uuidBeim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch.
-
AssetConditionUuid Key uuidStabile, global eindeutige Identitaet der Belegkondition (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 AssetConditionPatchData
22 Felder von
AssetConditionPatchData-
ShortName optional stringDefault:
nullKurzname (fachliches Attribut). -
Caption optional stringDefault:
nullBezeichnung der Kondition, wie sie die Quelle fuehrt und wie sie dem Anwender begegnet — laenger und sprechender als ShortName. Der Legacy-ES-Sync leitet daraus per Stichwort-Heuristik seine Versandart ab; die Ableitung gehoert dem Consumer, nicht dem Vertrag. -
State optional intDefault:
null -
BelongsToInvoice optional booleanDefault:
nullKlassifiziert Zahlungskondition (true) vs. Lieferbedingung. -
CustomerDeliveryCondition optional booleanDefault:
null -
IsCashCondition optional booleanDefault:
nullZahlart-Kennzeichen: Barzahlung. Quellseitige Nullability nicht verifiziert, daher optional — null heisst unbestimmt, nicht false (c-entron-schema-cut.md). -
IsECCondition optional booleanDefault:
nullZahlart-Kennzeichen: EC-Karte. Null heisst unbestimmt. -
IsCreditCardCondition optional booleanDefault:
nullZahlart-Kennzeichen: Kreditkarte. Null heisst unbestimmt. -
IsCheckCondition optional booleanDefault:
nullZahlart-Kennzeichen: Scheck. Null heisst unbestimmt. -
DTADebit optional booleanDefault:
nullZahlart-Kennzeichen: Lastschrift. Null heisst unbestimmt. -
CashOnDelivery optional booleanDefault:
nullZahlart-Kennzeichen: Nachnahme. Null heisst unbestimmt. -
Skonto1OffDay optional intDefault:
null -
Skonto1Percent optional decimal(6,2)Default:
nullSkonto in Prozent; quellseitig non-null double, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet (ADR-0006). -
Skonto2OffDay optional intDefault:
null -
Skonto2Percent optional decimal(6,2)Default:
nullSkonto in Prozent; quellseitig non-null double, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet (ADR-0006). -
Skonto3OffDay optional intDefault:
null -
DueKind optional intDefault:
null -
DuePlusDays optional intDefault:
null -
DueAtDay optional intDefault:
null -
DuePlusMonths optional intDefault:
null -
Default:
nullRollenreferenz: der Frachtfuehrer dieser Lieferbedingung ist ein Geschaeftspartner (Account mit Carrier-Facette, QS-1) und reist ueber dessen UUID (vormals CarrierI3D). Null bei Zahlungskonditionen und bei Lieferbedingungen ohne Spedition. -
Texts Liste optional AssetConditionText[]Default:
nullEingebettete Konditions-Hinweistexte, ein Eintrag je Locale.2 Felder von
AssetConditionText[]-
Default:
nullReferenz auf das Land/Locale-Stammdatum ueber dessen UUID (vormals CountryI3D). -
Text optional stringDefault:
null
-
-
-
Default:
nullUUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt. -
ChangedAt timestampZeitpunkt der Aenderung als UTC-Instant.
Referenziert von
- Vertrag
ContractPatch.Data.AssetConditionUuid - Vertrag
ContractPatch.Data.DeliveryConditionUuid - Vertrag
ContractState.AssetConditionUuid - Vertrag
ContractState.DeliveryConditionUuid - Gutschrift
CreditVoucherPatch.Data.AssetConditionUuid - Gutschrift
CreditVoucherState.AssetConditionUuid - Lieferschein
DeliveryListPatch.Data.AssetConditionUuid - Lieferschein
DeliveryListState.AssetConditionUuid - Shop-Bestellung
EsOrderState.AssetConditionUuid - Shop-Bestellung
EsOrderState.DeliveryConditionUuid - Rechnung
InvoicePatch.Data.AssetConditionUuid - Rechnung
InvoiceState.AssetConditionUuid - Angebot
OfferPatch.Data.AssetConditionUuid - Angebot
OfferState.AssetConditionUuid - Auftrag
OrderPatch.Data.AssetConditionUuid - Auftrag
OrderState.AssetConditionUuid - Abholschein
PickupListPatch.Data.AssetConditionUuid - Abholschein
PickupListState.AssetConditionUuid - Lieferanten-Gutschrift
SupplierCreditVoucherPatch.Data.AssetConditionUuid - Lieferanten-Gutschrift
SupplierCreditVoucherState.AssetConditionUuid - Lieferantenlieferschein
SupplierDeliveryListPatch.Data.AssetConditionUuid - Lieferantenlieferschein
SupplierDeliveryListState.AssetConditionUuid - Lieferanten-Rechnung
SupplierInvoicePatch.Data.AssetConditionUuid - Lieferanten-Rechnung
SupplierInvoiceState.AssetConditionUuid - Anfrage
SupplierOfferPatch.Data.AssetConditionUuid - Anfrage
SupplierOfferPatch.Data.DeliveryConditionUuid - Anfrage
SupplierOfferState.AssetConditionUuid - Anfrage
SupplierOfferState.DeliveryConditionUuid - Bestellung
SupplierOrderPatch.Data.AssetConditionUuid - Bestellung
SupplierOrderPatch.Data.DeliveryConditionUuid - Bestellung
SupplierOrderState.AssetConditionUuid - Bestellung
SupplierOrderState.DeliveryConditionUuid
Rohfassung
Schema dieser Fassung (Avro)
{
"type": "record",
"name": "AssetConditionPatch",
"namespace": "com.nexoware.connect.events",
"doc": "Vertragsentwurf: typisierte Teilaenderung fuer Belegkondition. 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/assetcondition.md.",
"fields": [
{
"name": "EventId",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Beim ersten Enqueue in die Outbox erzeugt; bei Wiederholung identisch."
},
{
"name": "AssetConditionUuid",
"type": {
"type": "string",
"logicalType": "uuid"
},
"doc": "Stabile, global eindeutige Identitaet der Belegkondition (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": "AssetConditionPatchData",
"doc": "Werte der maskierten Einheiten. null ausserhalb der Maske wird ignoriert; innerhalb der Maske entscheidet die Nullability im State.",
"fields": [
{
"name": "ShortName",
"type": [
"null",
"string"
],
"doc": "Kurzname (fachliches Attribut).",
"default": null
},
{
"name": "Caption",
"type": [
"null",
"string"
],
"doc": "Bezeichnung der Kondition, wie sie die Quelle fuehrt und wie sie dem Anwender begegnet — laenger und sprechender als ShortName. Der Legacy-ES-Sync leitet daraus per Stichwort-Heuristik seine Versandart ab; die Ableitung gehoert dem Consumer, nicht dem Vertrag.",
"default": null
},
{
"name": "State",
"type": [
"null",
"int"
],
"default": null
},
{
"name": "BelongsToInvoice",
"type": [
"null",
"boolean"
],
"doc": "Klassifiziert Zahlungskondition (true) vs. Lieferbedingung.",
"default": null
},
{
"name": "CustomerDeliveryCondition",
"type": [
"null",
"boolean"
],
"default": null
},
{
"name": "IsCashCondition",
"type": [
"null",
"boolean"
],
"doc": "Zahlart-Kennzeichen: Barzahlung. Quellseitige Nullability nicht verifiziert, daher optional — null heisst unbestimmt, nicht false (c-entron-schema-cut.md).",
"default": null
},
{
"name": "IsECCondition",
"type": [
"null",
"boolean"
],
"doc": "Zahlart-Kennzeichen: EC-Karte. Null heisst unbestimmt.",
"default": null
},
{
"name": "IsCreditCardCondition",
"type": [
"null",
"boolean"
],
"doc": "Zahlart-Kennzeichen: Kreditkarte. Null heisst unbestimmt.",
"default": null
},
{
"name": "IsCheckCondition",
"type": [
"null",
"boolean"
],
"doc": "Zahlart-Kennzeichen: Scheck. Null heisst unbestimmt.",
"default": null
},
{
"name": "DTADebit",
"type": [
"null",
"boolean"
],
"doc": "Zahlart-Kennzeichen: Lastschrift. Null heisst unbestimmt.",
"default": null
},
{
"name": "CashOnDelivery",
"type": [
"null",
"boolean"
],
"doc": "Zahlart-Kennzeichen: Nachnahme. Null heisst unbestimmt.",
"default": null
},
{
"name": "Skonto1OffDay",
"type": [
"null",
"int"
],
"default": null
},
{
"name": "Skonto1Percent",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 6,
"scale": 2
}
],
"doc": "Skonto in Prozent; quellseitig non-null double, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet (ADR-0006).",
"default": null
},
{
"name": "Skonto2OffDay",
"type": [
"null",
"int"
],
"default": null
},
{
"name": "Skonto2Percent",
"type": [
"null",
{
"type": "bytes",
"logicalType": "decimal",
"precision": 6,
"scale": 2
}
],
"doc": "Skonto in Prozent; quellseitig non-null double, beim Publish kaufmaennisch auf 2 Nachkommastellen gerundet (ADR-0006).",
"default": null
},
{
"name": "Skonto3OffDay",
"type": [
"null",
"int"
],
"default": null
},
{
"name": "DueKind",
"type": [
"null",
"int"
],
"default": null
},
{
"name": "DuePlusDays",
"type": [
"null",
"int"
],
"default": null
},
{
"name": "DueAtDay",
"type": [
"null",
"int"
],
"default": null
},
{
"name": "DuePlusMonths",
"type": [
"null",
"int"
],
"default": null
},
{
"name": "CarrierUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Rollenreferenz: der Frachtfuehrer dieser Lieferbedingung ist ein Geschaeftspartner (Account mit Carrier-Facette, QS-1) und reist ueber dessen UUID (vormals CarrierI3D). Null bei Zahlungskonditionen und bei Lieferbedingungen ohne Spedition.",
"default": null,
"references": "Account"
},
{
"name": "Texts",
"type": [
"null",
{
"type": "array",
"items": {
"type": "record",
"name": "AssetConditionText",
"fields": [
{
"name": "CountryUuid",
"type": [
"null",
{
"type": "string",
"logicalType": "uuid"
}
],
"doc": "Referenz auf das Land/Locale-Stammdatum ueber dessen UUID (vormals CountryI3D).",
"default": null
},
{
"name": "Text",
"type": [
"null",
"string"
],
"default": null
}
]
}
}
],
"doc": "Eingebettete Konditions-Hinweistexte, ein Eintrag je Locale.",
"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": "AssetCondition",
"label": "Belegkondition",
"topic": "assetcondition.patch",
"key": "AssetConditionUuid",
"cleanupPolicy": "delete",
"retentionMs": 2592000000,
"partitions": 1,
"writers": [
"centron",
"nexoware-erp"
],
"requiredOnCreate": [
"State",
"BelongsToInvoice",
"CustomerDeliveryCondition",
"Skonto1OffDay",
"Skonto1Percent",
"Skonto2OffDay",
"Skonto2Percent",
"Skonto3OffDay",
"DueKind",
"DuePlusDays",
"DueAtDay",
"DuePlusMonths"
]
}