checkExternalVoucherArticle function
Regeln am wirksamen Artikelstand (Bestand + Aenderung) in /v3-Form
(externalVoucher, unitPriceCents, vatRate, askPrice,
serviceVoucher, addOns, stockTracked, reference, askQuantity,
deposits; PosArticle.toJson liefert diese Form). null = passt, sonst ein Wert aus
externalVoucherArticleReasons. Ohne externalVoucher gilt keine Regel.
Einzweck verlangt einen Satz der Kasse (0 = befreit verkauft), Mehrzweck
ignoriert ihn; nie zusammen mit Leistungsgutschein, eigener Zusatzliste,
Lagerbestand, Referenz, Mengenabfrage (die Kasse fragt die Nummer
selbst und bucht genau einen) oder Pfand; ohne askPrice braucht er einen Preis ab
1 Cent. Zwilling von checkExternalVoucherArticle (Backend pruefeArtikel).
Implementation
String? checkExternalVoucherArticle(Map<String, Object?> article) {
final wert = article['externalVoucher'];
if (wert == null) return null;
final art = ArticleExternalVoucher.fromWire(wert);
if (art == null) return 'invalid_type';
if (article['serviceVoucher'] == true) return 'service_voucher';
final zusaetze = article['addOns'];
if (zusaetze is List && zusaetze.isNotEmpty) return 'add_ons';
if (article['stockTracked'] == true) return 'stock_tracked';
if (_wahr(article['reference'])) return 'reference';
if (article['askQuantity'] == true) return 'asks_quantity';
final pfand = article['deposits'];
if (pfand is List && pfand.isNotEmpty) return 'deposit';
if (art == ArticleExternalVoucher.singlePurpose) {
final satz = article['vatRate'];
if (satz is! num || !satz.isFinite) return 'rate_required';
if (!articleExternalVoucherVatRates.contains(satz)) return 'invalid_rate';
}
final preis = article['unitPriceCents'];
// Ganzzahlig wie Number.isInteger: 2500.0 aus einem Zwischenspeicher zaehlt.
final preisOk = preis is num && preis.isFinite && preis == preis.roundToDouble() && preis >= 1;
if (article['askPrice'] != true && !preisOk) return 'price_required';
return null;
}