Verträge / ArticleUnitState

Artikeleinheit State

ArticleUnitState · com.nexoware.connect.events

Aggregat: ArticleUnit · Patch ArticleUnitPatch
Topic: articleunit.state je Mandant mit Präfix, z. B. <mandant>.articleunit.state
Key: ArticleUnitUuid
Nachrichtenart: State — der aktuelle Zustand, ein Writer
Schreiber: Zusammenführungsdienst (merge)
Leser: c-entron Webservice (centron) , NEXOWARE.ERP (nexoware-erp) , Shop (shop)
Fassung: Version 1 (neueste)
Schema-ID: 43

Vertragsentwurf: vollstaendiger veroeffentlichter Zustand fuer Artikeleinheit. Feldumfang aus dem archivierten ArticleUnitChanged; kein fachlicher Vergleich beider Produkte. Einziger State-Writer ist merge; Produkte veroeffentlichen typisierte Patches. Grenzen, Migration und offene Fachregeln: docs/contracts/articleunit.md.

Fassungen

Felder

ArticleUnitUuid Key uuid

Stabile, global eindeutige Identitaet der Artikeleinheit (Matching-Schluessel; zugleich Message-Key).
Name optional string

Default: null

Bezeichnung der Einheit (z. B. Stueck, Stunde); DB nullable.
ShortText optional string

Default: null

Kurztext/Kuerzel der Einheit (z. B. Stk, h); DB nullable.
VPE double

Verpackungseinheit (Menge je Gebinde); non-null Quell-Property.
Standard int

1 = systemweite Standard-Einheit (die Quelle stellt sicher, dass genau eine Einheit Standard ist), sonst 0.
State int

LWW-Statusfeld: 1 = aktiv, 0 = deaktiviert (Quellspalte Status; Soft-Delete).
TimeUnit int

1 = Zeiteinheit (dann ist FactorToSeconds gepflegt), sonst 0.
FactorToSeconds int

Umrechnungsfaktor der Einheit in Sekunden; nur fuer Zeiteinheiten fachlich relevant, sonst 0.
UNECECode optional string

Default: null

UN/ECE-Recommendation-20-Code der Einheit (z. B. C62, HUR); DB nullable.
Revision long

Anzahl der zustandsaendernden Patches seit Anlage; vom Zusammenfuehrungsdienst gesetzt.
LastEventId ↗ extern: LastEventId uuid

EventId des zuletzt angewandten Patches; vom Zusammenfuehrungsdienst gesetzt.
ChangedByUuid optional → Mitarbeiter uuid

Default: null

UUID des aendernden Mitarbeiters (Employee); null, wenn unbekannt.
ChangedAt timestamp

Zeitpunkt der Aenderung als UTC-Instant.

Referenziert von

Kein Vertrag verweist auf diesen.

Rohfassung

Schema dieser Fassung (Avro)

{
  "type": "record",
  "name": "ArticleUnitState",
  "namespace": "com.nexoware.connect.events",
  "doc": "Vertragsentwurf: vollstaendiger veroeffentlichter Zustand fuer Artikeleinheit. Feldumfang aus dem archivierten ArticleUnitChanged; kein fachlicher Vergleich beider Produkte. Einziger State-Writer ist merge; Produkte veroeffentlichen typisierte Patches. Grenzen, Migration und offene Fachregeln: docs/contracts/articleunit.md.",
  "fields": [
    {
      "name": "ArticleUnitUuid",
      "type": {
        "type": "string",
        "logicalType": "uuid"
      },
      "doc": "Stabile, global eindeutige Identitaet der Artikeleinheit (Matching-Schluessel; zugleich Message-Key)."
    },
    {
      "name": "Name",
      "type": [
        "null",
        "string"
      ],
      "doc": "Bezeichnung der Einheit (z. B. Stueck, Stunde); DB nullable.",
      "default": null
    },
    {
      "name": "ShortText",
      "type": [
        "null",
        "string"
      ],
      "doc": "Kurztext/Kuerzel der Einheit (z. B. Stk, h); DB nullable.",
      "default": null
    },
    {
      "name": "VPE",
      "type": "double",
      "doc": "Verpackungseinheit (Menge je Gebinde); non-null Quell-Property."
    },
    {
      "name": "Standard",
      "type": "int",
      "doc": "1 = systemweite Standard-Einheit (die Quelle stellt sicher, dass genau eine Einheit Standard ist), sonst 0."
    },
    {
      "name": "State",
      "type": "int",
      "doc": "LWW-Statusfeld: 1 = aktiv, 0 = deaktiviert (Quellspalte Status; Soft-Delete)."
    },
    {
      "name": "TimeUnit",
      "type": "int",
      "doc": "1 = Zeiteinheit (dann ist FactorToSeconds gepflegt), sonst 0."
    },
    {
      "name": "FactorToSeconds",
      "type": "int",
      "doc": "Umrechnungsfaktor der Einheit in Sekunden; nur fuer Zeiteinheiten fachlich relevant, sonst 0."
    },
    {
      "name": "UNECECode",
      "type": [
        "null",
        "string"
      ],
      "doc": "UN/ECE-Recommendation-20-Code der Einheit (z. B. C62, HUR); DB nullable.",
      "default": null
    },
    {
      "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); null, wenn unbekannt.",
      "default": null,
      "references": "Employee"
    },
    {
      "name": "ChangedAt",
      "type": {
        "type": "long",
        "logicalType": "timestamp-millis"
      },
      "doc": "Zeitpunkt der Aenderung als UTC-Instant."
    }
  ],
  "aggregate": "ArticleUnit",
  "label": "Artikeleinheit",
  "topic": "articleunit.state",
  "key": "ArticleUnitUuid",
  "cleanupPolicy": "compact",
  "partitions": 1,
  "writers": [
    "merge"
  ],
  "readers": [
    "centron",
    "nexoware-erp",
    "shop"
  ]
}