checkExternalVoucherArticle function

String? checkExternalVoucherArticle(
  1. Map<String, Object?> article
)

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;
}