====== std.validate.de_numbers ======

Deutsche Fachkennzeichen: Pharmazentralnummer (PZN) für Arzneimittel, Wertpapierkennnummer (WKN) für Wertpapiere, Gemeindeschlüssel (GND-Nummer / AGS) und Zählpunktbezeichnung für Energiezähler (Strom, Gas, Wasser).

→ [[lyx_-_programmiersprache:units:validate|std.validate]] · [[lyx_-_programmiersprache:units:validate:de_personal|std.validate.de_personal]]

----

===== Konstanten =====

^ Name ^ Wert ^ Bedeutung ^
| ''DE_NUM_OK'' | ''0'' | Gültig |
| ''DE_NUM_ERR_INVALID_LENGTH'' | ''1'' | Falsche Länge |
| ''DE_NUM_ERR_INVALID_CHAR'' | ''2'' | Ungültiges Zeichen |
| ''DE_NUM_ERR_INVALID_CHECK'' | ''3'' | Falsche Prüfziffer |
| ''DE_NUM_ERR_INVALID_FORMAT'' | ''4'' | Format entspricht nicht dem Standard |

----

===== Verwendung =====

<code lyx>
import std.validate.de_numbers;

// Pharmazentralnummer (PZN-8, 8 Stellen)
var pzn: pchar := "03386388";
if (DEPZNValidate(pzn) = DE_NUM_OK) {
    log_info("PZN gültig");
}

// Wertpapierkennnummer (WKN, 6 alphanumerische Zeichen)
var wkn: pchar := "840400";  // Deutsche Bank
if (DEWKNValidate(wkn) = DE_NUM_OK) {
    log_info("WKN gültig");
}

// Amtlicher Gemeindeschlüssel (AGS / GND, 8 Stellen)
var ags: pchar := "09162000";  // München
if (DEAGSValidate(ags) = DE_NUM_OK) {
    log_info(DEAGSGetBundesland(ags));  // "09" = Bayern
    log_info(DEAGSGetLandkreis(ags));  // "162"
}

// Zählpunktbezeichnung (Strom/Gas/Wasser, DE+33 Zeichen)
var zp: pchar := "DE00056266802AO6G14S0000000";
if (DEZaehlpunktValidate(zp) = DE_NUM_OK) {
    log_info("Zählpunkt gültig");
}
</code>

----

===== Funktionen =====

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^
| ''DEPZNValidate(pzn: pchar): int64'' | pub | Pharmazentralnummer (PZN-8) mit Prüfziffer validieren |
| ''DEPZNCheckDigit(pzn: pchar): int64'' | pub | Prüfziffer für 7-stelligen PZN-Stamm berechnen |
| ''DEWKNValidate(wkn: pchar): int64'' | pub | Wertpapierkennnummer (6 alphanumerische Zeichen) strukturell validieren |
| ''DEWKNNormalize(wkn: pchar): pchar'' | pub | WKN normalisieren (Bindestriche entfernen, Großbuchstaben) |
| ''DEAGSValidate(ags: pchar): int64'' | pub | Amtlichen Gemeindeschlüssel (8 Stellen) validieren |
| ''DEAGSGetBundesland(ags: pchar): pchar'' | pub | Bundeslandkennziffer (2 Stellen) aus AGS extrahieren |
| ''DEAGSGetLandkreis(ags: pchar): pchar'' | pub | Landkreisschlüssel aus AGS extrahieren |
| ''DEAGSGetGemeinde(ags: pchar): pchar'' | pub | Gemeindeschlüssel aus AGS extrahieren |
| ''DEZaehlpunktValidate(zp: pchar): int64'' | pub | Zählpunktbezeichnung nach BDEW-Standard validieren |
| ''DEZaehlpunktGetSparte(zp: pchar): pchar'' | pub | Sparte aus Zählpunkt extrahieren (z.B. "G" = Gas, "S" = Strom) |

Letzte Aktualisierung: 2026-05-23