Die ZugerKB anbinden, ohne EBICS lernen zu müssen.
EBICS 2.5 und 3.0 mit Host-ID ZGKBEBICS, Hashwerte der Bankschlüssel und Zertifikate in einem veröffentlichten Parametermerkblatt, kostenlos nutzbar, mit Einzel- oder Kollektivunterschrift über die Verteilte Elektronische Unterschrift. Wir übernehmen die Zahlungen, die Kontoauszüge und jeden Protokollschritt darunter.
Der Host, live geprüft
<ebicsHEVResponse xmlns="http://www.ebics.org/H000"> <ReturnCode>000000</ReturnCode> <ReportText>[EBICS_OK] OK</ReportText> <VersionNumber ProtocolVersion="H003">02.40</VersionNumber> <VersionNumber ProtocolVersion="H004">02.50</VersionNumber> <VersionNumber ProtocolVersion="H005">03.00</VersionNumber> </ebicsHEVResponse>
Host ID
ZGKBEBICS
EBICS 2.5
H004
EBICS 3.0
H005
Antwortzeit
0.21 s
Von der Bank veröffentlicht
Die Seiten der Bank zu Kontakt, Porträt, Rechtsform und Aktionariat sowie das von ihr veröffentlichte Gesetz über die Zuger Kantonalbank; das Schweizer UID-Register, GLEIF und FINMA.
Bankdaten
| BIC | KBZGCH22 und KBZGCH22XXX |
| Clearing-Nummer (IID) | 00787 |
| QR-IID | 30787 |
| Firma | Zuger Kantonalbank |
| Rechtsform | Spezialgesetzliche Aktiengesellschaft (Art. 763 OR). UID-Register: Anstalt des öffentlichen Rechts |
| Sitz | Bahnhofstrasse 1, 6300 Zug |
| Postadresse | Bahnhofstrasse 1, Postfach, 6301 Zug |
| UID | CHE-105.744.410 |
| Handelsregister | CH-170.8.000.001-9 |
| LEI | 529900PVNQ0FQUKJQ049 |
| Gegründet | 1892 |
| Aktienkapital | CHF 144’144’000, eingeteilt in 288’288 Namenaktien zu CHF 500 Nennwert |
| Eigentümer | Kanton Zug: von Gesetzes wegen mindestens die Hälfte des Aktienkapitals, die er nicht veräussern darf; 50.1 % der Aktien und 33 % der Stimmrechte per 31. Dez. 2025 |
| Stimmrechtsbeschränkung | Kein Aktionär darf mehr als ein Drittel des Aktienkapitals plus eine Aktie vertreten |
| Kotierung | SIX Swiss Exchange, ISIN CH0493891243 |
| Staatsgarantie | Der Kanton Zug haftet für die Verbindlichkeiten der Bank, soweit deren eigene Mittel nicht ausreichen, ausgenommen nachrangige Verbindlichkeiten |
| Aufsicht | FINMA (bewilligte Bank, Aufsichtskategorie 3) |
| Geschäftskunden | 041 709 12 12, Mo–Fr 08:00–18:00 |
Live geprüft
Gemessen am Live-Host, unter Adresse und Host-ID aus dem Parametermerkblatt der Bank.
Zugangsdaten
| EBICS-Adresse | https://ebics.swisscom.com/ebics-server/ebics.aspx |
| Host-ID | ZGKBEBICS |
| Port | 443 |
| Protokollversionen | H003 (02.40), H004 (02.50) und H005 (03.00) |
Von der Bank veröffentlicht
Das EBICS-Parametermerkblatt der Bank und ihre EBICS-Seite.
Schlüssel, Unterschriften und Vereinbarung
| Leistungsumfang | Schnittstelle aus Ihrem ERP zur Einreichung von Zahlungsaufträgen (pain) und zum Abruf von Kontoinformationen (camt) |
| Preis | Nutzung von EBICS kostenlos |
| Voraussetzungen | Ein Konto bei der ZugerKB, Internetzugang und EBICS-fähige Software |
| Zugang erhalten | Sobald Ihre Software EBICS-fähig ist, über Ihre Beraterin oder Ihren Berater oder unter 041 709 12 12 |
| Versionen im Merkblatt | 3.0 (Schema H005) und 2.5 (Schema H004) |
| Authentifikation | X002 |
| Verschlüsselung | E002 |
| Elektronische Unterschrift | A006 (Standard); A005 weiterhin möglich, nicht empfohlen |
| Schlüssellänge | Nicht veröffentlicht |
| Hashwerte der Bankschlüssel | Im Merkblatt für X002 und E002 veröffentlicht: Hashwerte der öffentlichen Schlüssel und der X.509-Zertifikate |
| Initialisierung | INI und HIA, danach der vom Kunden unterschriebene Initialisierungsbrief, der per Post an die ZugerKB gesendet wird, damit der EBICS-Benutzer freigeschaltet werden kann |
| Prüfung der Bankschlüssel | Nachdem die ZugerKB die Kundenschlüssel geprüft und freigegeben hat: Bankschlüssel mit HPB laden und in der Kundensoftware anhand der Hashwerte im Merkblatt prüfen |
| Schlüsselwechsel | HCA (Authentifikation und Verschlüsselung) und HCS (Unterschrift, Authentifikation und Verschlüsselung) |
| Zugang sperren | SPR |
| Unterschriftsklassen, Einzelunterschrift (EU) | E Einzelunterschrift, T Transport ohne Unterschrift |
| Unterschriftsklassen, Verteilte Elektronische Unterschrift (VEU) | E Einzelunterschrift; A kollektiv, zweites Visum A, B oder E; B kollektiv, zweites Visum A oder E |
| Empfohlen | Die Verteilte Elektronische Unterschrift, mit Unterschriften aus getrennten Software-Clients und einem einreichenden Client, der netzwerkseitig vom unterzeichnenden getrennt ist. Die VEU-Mobile-App, die die ZugerKB anbietet, eignet sich dafür besonders |
| Ende von EBICS 2.5 | Nicht veröffentlicht |
Von der Bank veröffentlicht
EBICS-Parametermerkblatt der Bank (Stand Mai 2024).
Auftragsarten der ZugerKB
| 2.x | Funktion | Richtung | 3.0 BTF | Option | Container | Version |
|---|---|---|---|---|---|---|
| XE2 | Zahlungsauftrag (Überweisung), Swiss Payment Standards | BTU | MCT/CH/pain.001 | 03 | ||
| Zahlungsauftrag (Überweisung), Swiss Payment Standards | BTU | MCT/CH/pain.001 | 09 | |||
| XE3 | Einreichung Schweizer Lastschrift | BTU | SDD/CH/pain.008 | 02 | ||
| Z01 | Statusbericht, Bank an Auftraggeber | BTD | PSR/CH/pain.002 | ZIP | 03 und 10 | |
| Z52 | Untertägige und vorangekündigte Kontobewegungen | BTD | STM/CH/camt.052 | ZIP | 04 und 08 | |
| Z53 | Tageskontoauszug | BTD | EOP/CH/camt.053 | ZIP | 04 und 08 | |
| Z54 | Zusatzinformationen zu Sammelbuchungen | BTD | REP/CH/camt.054 | ZIP | 04 und 08 | |
| ZDF | Digitales Bankdokument | BTD | DAR/CH/documents | ZIP | ||
| STA | Kontoauszug im SWIFT-Format | BTD | EOP/CH/mt940 |
Uploads laufen als BTU, Downloads als BTD. Der Statusbericht, die drei camt-Berichte und die Bankdokumente kommen in einem ZIP-Container; MT940 hat keinen.
Die Auftragsarten der Verteilten Elektronischen Unterschrift: Unterschrift hinzufügen, VEU-Status, Widerruf, Transaktionsdetails, die Übersicht und die Übersicht mit Zusatzinformationen.
Die administrativen Auftragsarten: Schlüsselinitialisierung, das Statusprotokoll, abrufbare Auftragsarten, Schlüsselwechsel, unterstützte Versionen, die öffentlichen Schlüssel der Bank, Kunden- und Teilnehmerdaten, Bankparameter und Sperren. Sie bekommen keine davon zu sehen, denn wir führen sie bei der Einrichtung und danach aus.
Von der Bank veröffentlicht
Die Seite der Bank zu strukturierten Adressen, die über EBICS eingereichte pain.001-Dateien abdeckt.
Annahmeschluss und Ausführung
| Annahmeschluss für EBICS-Dateien | Nicht veröffentlicht |
| Fehler in einer pain.001-Datei | Teilverarbeitung: Bis zu zehn fehlerhafte Transaktionen werden zurückgewiesen und die übrigen verarbeitet; bei mehr als zehn wird die ganze Datei zurückgewiesen |
| Datum, für das die Adressregel gilt | Das gewünschte Ausführungsdatum, nicht das Datum der Erfassung oder Übermittlung |
Von der Bank veröffentlicht
Das EBICS-Parametermerkblatt der Bank und ihre Seite zu strukturierten Adressen.
Formate
| pain.001 | Swiss Payment Standards, Versionen 03 und 09 |
| pain.008 | Einreichung Schweizer Lastschrift, Version 02 |
| pain.002 | Versionen 03 und 10, geliefert als ZIP |
| camt.052, camt.053, camt.054 | Versionen 04 und 08, geliefert als ZIP |
| MT940 | STA |
| Strukturierte Adressen | In pain.001-Dateien ab Ausführungsdatum 14. Nov. 2026 erforderlich, unabhängig von der pain.001-Version: mindestens Name, Ort und Land in eigenen Feldern. Unstrukturierte Adressen sind nicht mehr zulässig |
| Empfohlen | Vollständig strukturierte Adressen: Name, Strasse, Hausnummer, Postleitzahl, Ort und Land |
| pain.001 Version 2009 (V3) | Über den 14. Nov. 2026 hinaus für eine Übergangszeit unterstützt, die voraussichtlich Mitte 2027 endet; danach ist Version 2019 (V9) erforderlich |
| Entgeltregelung | Nicht veröffentlicht |
| Sammelbuchung | Nicht veröffentlicht |
| Bank des Auftraggebers | Nicht veröffentlicht |
| Verwendungszweck | Nicht veröffentlicht |
| Ende von MT940 | Nicht veröffentlicht |
BankConnector
Was für diese Bank heute gebaut und ausgeliefert ist.
Was unsere Engine erzeugt
| Zahlungsformat | pain.001.001.09 (Swiss Payment Standards, Schema ch.03) |
| Richtlinie | Swiss Payment Standards 09/ch.03, herausgegeben von SIX |
| Entgeltregelung | SLEV bei SEPA-Zahlungen, SHAR bei allen übrigen |
| Sammelbuchung | False |
| Verwendungszweck | Höchstens 140 Zeichen |
| Name | Höchstens 70 Zeichen |
| Zeichensatz | Lateinisch, vor der Übergabe an die Bank transliteriert |
| Gebaute Zahlungsarten | SEPA-Überweisung, Inlandüberweisung Schweiz, QR-Rechnungszahlung, Auslandzahlung |
| Rückmeldungen | camt und pain.002 in einem einheitlichen Format |
| Nicht unterstützt | Lastschriften |
BankConnector
Häufige Fragen
- Wie lauten Host-ID und URL der Zuger Kantonalbank für EBICS?
- Host-ID ZGKBEBICS, Adresse https://ebics.swisscom.com/ebics-server/ebics.aspx, Port 443. Die ZugerKB veröffentlicht beides in ihrem EBICS-Parametermerkblatt, zusammen mit den Hashwerten ihrer öffentlichen Schlüssel X002 und E002 und ihrer X.509-Zertifikate.
- Welche EBICS-Versionen unterstützt die ZugerKB?
- Das Parametermerkblatt nennt EBICS 3.0 (Schema H005) und 2.5 (Schema H004); der Host antwortet auf H003 (02.40), H004 (02.50) und H005 (03.00). Ein Enddatum für EBICS 2.5 hat die ZugerKB nicht veröffentlicht.
- Welche Schlüssel und Unterschrift verwendet die ZugerKB für EBICS?
- X002 für die Authentifikation, E002 für die Verschlüsselung und A006 als Standard der elektronischen Unterschrift; A005 ist weiterhin möglich, aber nicht empfohlen. Nach INI und HIA geht der unterschriebene Initialisierungsbrief per Post an die ZugerKB, und sobald die Bank Ihre Schlüssel freigibt, laden Sie ihre Schlüssel mit HPB und prüfen sie anhand der Hashwerte im Merkblatt.
- Unterstützt die ZugerKB die Verteilte Elektronische Unterschrift (VEU)?
- Ja, und sie empfiehlt sie. Die VEU-Unterschriftsklassen sind E (einzeln), A (kollektiv, zweites Visum A, B oder E) und B (kollektiv, zweites Visum A oder E); ausserhalb der VEU unterschreibt Klasse E allein, und Klasse T transportiert ohne Unterschrift. Die VEU-Auftragsarten sind HVE, HVD, HVS, HVT, HVU und HVZ.
- Welche Auftragsarten verwendet die ZugerKB bei EBICS 3.0?
- Zahlungen werden als BTU MCT/CH/pain.001, Version 03 oder 09, hochgeladen, Schweizer Lastschriften als BTU SDD/CH/pain.008 Version 02. Downloads sind BTD: PSR/CH/pain.002, STM/CH/camt.052, EOP/CH/camt.053, REP/CH/camt.054 und DAR/CH für Bankdokumente, alle als ZIP, dazu EOP/CH/mt940. Die Entsprechungen bei EBICS 2.x sind XE2, XE3, Z01, Z52, Z53, Z54, ZDF und STA.
- Wann ist Annahmeschluss für EBICS-Dateien bei der ZugerKB?
- Die ZugerKB veröffentlicht keinen Annahmeschluss für über EBICS eingereichte Dateien.
- Was geschieht mit einer pain.001-Datei mit Fehlern?
- Die ZugerKB lässt Teilverarbeitung zu. Enthält eine Datei bis zu zehn fehlerhafte Transaktionen, werden nur diese zurückgewiesen und die korrekten verarbeitet. Enthält sie mehr als zehn, wird die ganze Datei zurückgewiesen.
- Was ändert sich bei der ZugerKB im November 2026?
- Ab Ausführungsdatum 14. November 2026 müssen pain.001-Dateien, auch solche über EBICS, strukturierte Adressen enthalten (mindestens Name, Ort und Land in eigenen Feldern), unabhängig von der pain.001-Version. Die ZugerKB nimmt pain.001 Version 2009 (V3) über dieses Datum hinaus für eine Übergangszeit weiter an, die nach ihrer Erwartung Mitte 2027 endet.
- Kann ich mein ERP-System an die Zuger Kantonalbank anbinden?
- Ja. Sie senden kanonisches JSON, und BankConnector erzeugt die pain.001.001.09-Datei nach den Swiss Payment Standards und liest camt und pain.002 in ein einheitliches Format zurück. Unterstützt werden SEPA-Überweisungen, Inlandüberweisungen in der Schweiz, QR-Rechnungszahlungen und Auslandzahlungen. Lastschriften nicht.
Von der Bank veröffentlicht
Termine, die die Bank angekündigt hat. Was wir jeweils daraus machen, liegt bei uns.
Anstehende Termine
Strukturierte Adressen sind erforderlich. pain.001-Dateien mit einem Ausführungsdatum ab diesem Tag müssen strukturierte Adressen enthalten, mit mindestens Name, Ort und Land in eigenen Feldern. Unsere Engine erzeugt für die ZugerKB bereits pain.001.001.09.
Falls das nach viel aussieht, muss es nicht sein
Fünf Schritte zur produktiven Verbindung mit der ZugerKB.
Sie müssen keinen der Codes oben verstehen. Unser Einrichtungsassistent führt Sie Bildschirm für Bildschirm durch.
- 1
Vereinbarung bei der ZugerKB anfordern
EBICS beginnt mit Papier. Wir entwerfen die E-Mail, Sie schicken sie ab und sagen uns Bescheid. Bis die Bank antwortet, gibt es nichts einzurichten.
- 2
Schlüssel einrichten und senden
Tragen Sie die Werte aus der Vereinbarung ein, die Sie von der ZugerKB erhalten. Die öffentlichen Angaben haben wir bereits, der grösste Teil des Formulars ist also schon ausgefüllt. Ein Klick erzeugt dann Ihre drei Schlüsselpaare und sendet die öffentlichen Schlüssel.
- 3
Identität auf Papier bestätigen
EBICS bestätigt den Schlüsselaustausch bewusst auf Papier. Wir drucken den Initialisierungsbrief mit den Hashwerten, die bei der ZugerKB geprüft werden. Sie unterschreiben ihn von Hand und schicken der Bank einfach einen Scan per E-Mail; das Original geht nur per Post, wenn die Bank es verlangt.
- 4
Schlüssel von der ZugerKB prüfen und live gehen
Während Sie warten, holen wir die öffentlichen Schlüssel der Bank ab und prüfen sie gegen die Hashwerte, die sie Ihnen über einen separaten Kanal mitteilt. Danach legen Sie fest, welche Freigaberegel hier für Zahlungen gilt, und die Verbindung wird aktiv.
- 5
Mit einer kleinen Zahlung produktiv gehen
Beginnen Sie mit einer kleinen Zahlung und verfolgen Sie sie bis zum Kontoauszug. Dann sind Sie produktiv mit der ZugerKB: Zahlungen gehen als pain.001 hinaus, Kontoauszüge kommen als camt zurück, und die Verbindung läuft von hier an ohne Ihr Zutun.
Quellen: die EBICS-Seite der Zuger Kantonalbank, ihr EBICS-Parametermerkblatt, ihre Seite zu strukturierten Adressen, ihre Seiten Kontakt, Porträt, Rechtsform und Aktionariat sowie das Gesetz über die Zuger Kantonalbank; das Schweizer UID-Register, GLEIF und die Liste der bewilligten Banken der FINMA. BankConnector ist nicht mit der Zuger Kantonalbank verbunden.