For the complete documentation index, see llms.txt. This page is also available as Markdown.

72242969 SOUDHL Tariff Import Mgt

Verantwortung

Importiert DHL-Vertragstarife aus einem festen Excel-Schema in Staging-Tabellen, validiert jede Zelle und aktiviert eine konsistente Tarifversion.

Öffentliche Procedures

ImportWorkbook(): Integer

Öffnet den XLSX-Upload, legt einen Import Batch an, liest alle kanonischen Sheets in Import Lines und ruft ValidateBatch auf. Rückgabe ist die Batch No.; Abbruch liefert 0.

CreateEmptyTemplate()

Erzeugt und lädt eine leere Vorlage mit den sieben Sheets und allen erwarteten Spalten herunter.

ValidateBatch(BatchNo: Integer)

Setzt alte Fehler zurück und prüft:

  • Pflicht-Sheets und Spalten,

  • mindestens eine relevante Datenzeile,

  • Pflichtwerte je Zeile,

  • Datum, Decimal, Boolean und Enum-Formate,

  • Länder, Währungen, Produkte und Zonenreferenzen,

  • genau eine Tarif-/Versionskombination.

Status wird Validated oder Error; Error Count wird aktualisiert.

ActivateBatch(BatchNo: Integer)

Validiert erneut, verwirft eine vorhandene nichtaktive identische Version, importiert alle sieben Datenbereiche und ruft SOUDHL Tariff Validation Mgt.ActivateTariff auf. Aktive identische Versionen werden nicht ersetzt.

Normalisierung und Referenzprüfung

  • NormalizeCountryCode(CountryCode: Text): Code[10] – Trim, Uppercase, EL → GR.

  • IsValidCurrencyCode(CurrencyCode: Code[10]): Boolean – Currency-Stamm oder LCY.

  • IsValidCountryCode(CountryCode: Code[10]): Boolean – ISO-2 plus Country-Stamm oder Installation-Lookup.

Interne Methodengruppen

Upload und Staging

CreateBatch, ReadSheet, NormalizeHeader, NormalizeCellValue, AddBatchError.

Struktur- und Zeilenvalidierung

CheckRequiredValue, ValidateRequiredColumns, CheckRequiredColumns, SheetHasHeader, ColumnExists, ValidateRequiredRows, CheckRequiredRows, RowHasData.

Formate und Referenzen

ValidateCellFormats, ValidateReferences, SetReferenceError, StagedValueExists.

Aktivierung

DeleteImportedVersion, DeleteVersionData, ImportPriceLists, ImportProducts, ImportZones, ImportDestinations, ImportRates, ImportCharges, ImportIndexValues.

Parser und Template

SetProductKeys, GetValue, GetMaxRow, EvaluateDate, EvaluateDecimal, EvaluateInteger, EvaluateBoolean, EvaluateOptionalEnum, EvaluateOptionalExpressEnum, GetSheetNames, AddTemplateSheet, AddColumns.

Fehlercodes

MISSING_SHEET, MISSING_COLUMN, REQUIRED_VALUE, INVALID_FORMAT, UNKNOWN_REFERENCE.

Datenwirkung

Persistente Import Batches/Lines und Tarifstammdaten. Aktivierung kann ältere überlappende Versionen archivieren.

Externe Verwendung

Administration über Import Wizard bevorzugen. Automatisierungen dürfen die vier High-Level-Methoden verwenden, müssen aber Batchstatus und Fehlerzeilen auswerten.