/
Stammdaten Bezug

Stammdaten Bezug

Endpunkte

Stammdaten Dateien

Die Stammdaten werden periodisch generiert und abgelegt. Die Daten werden mit einem XML Schema beschrieben.

Daten

Dateien

Integration

Produktion

Beschreibung

Daten

Dateien

Integration

Produktion

Beschreibung

Tariffdaten

TariffMasterData_v5.xsd
TariffMasterData_v5.zip

Tariffmaster v5

TariffMasterData_v6.xsd
TariffMasterData_v6.zip

Tariffmaster v6

Tariff Basisdaten

TariffBaseMasterData_v2.xsd
TariffBaseMasterData_v2.zip

Basemaster Data v2

TariffsTree

TariffsTree_v1.xsd
TariffsTree_v1.zip

Tariffs Tree v1

Länder Codes

CountryCodes_v2.xsd

CountryCodes_v2.zip

Ländercodes Tarifdaten

Passar Codelisten

PassarCodelists_v1.xsd

PassarCodelists_v1.xml

Passar CodeListen Schema

Taxud Codelisten

PassarTaxudCustomsOfficesCodelists_v1.xsd

PassarTaxudCustomsOfficesCodelists_v1.xml

TAXUD Codelisten Schema

Neue Stammdaten Laden

Die Stammdaten werden täglich aktualisiert, sofern Änderungen in der jeweiligen Stammdatendatei vorhanden sind. Mithilfe der HTTP-Header-Attribute

  • Last-Modified: Gibt an, wann die Datei zuletzt geändert wurde (z. B.: Wed, 05 Mar 2025 02:37:04 GMT)

  • ETag: Ein Hash-Wert über den gesamten Dateiinhalt, der sich ändert, sobald auch nur ein Zeichen in der Datei verändert wurde (z. B.: "8a279144f8d4cca7658fa0c6f417174d")

kann ermittelt werden, ob die Datei identisch mit der zuvor gespeicherten Version ist oder ob eine neue Version vorliegt.

Mit einer HTTP HEAD-Anfrage können diese Header-Informationen abgefragt werden, ohne dass die gesamte Datei übertragen werden muss.
Beispiel (cURL):

curl --head https://abn-datahub.bazg.admin.ch/public-resources/TariffMasterData_v4.zip

Das tatsächliche Herunterladen der Stammdaten erfolgt über einen HTTP GET-Request.

Beispiel (cURL):

curl -s https://abn-datahub.bazg.admin.ch/public-resources/CountryCodes_v2.xsd --output CountryCodes_v2.xsd

Im folgenden Sequenzdiagramm ist der Prozess zur Änderungsprüfung dargestellt: Ein externer Trigger (z. B. ein Timer) startet periodisch den MasterDataService, um eine bestimmte Stammdatendatei (fileName) zu überprüfen. Das gespeicherte ETag der letzten Version wird mit dem aktuellen ETag vom BAZGStorage verglichen. Nur wenn sich das ETag geändert hat, wird die neue Datei heruntergeladen und eingelesen.

 

Versionierung

Die XML (Zip) und XSD Dateinamen enden mit der Version des Schemas.

  • TariffMasterData_v2.xsd

  • TariffMasterData_v2.zip

Die Version der Generierten Datei ist immer im Attribute version des Toplevelelements definiert.

Q&A