ITG RKSVNet - Webservice Signierung von Belegen via Internet

Größe: px

Ab Seite anzeigen:

Download "ITG RKSVNet - Webservice Signierung von Belegen via Internet"

Arnim Engel
vor 8 Jahren
Abrufe

1 ITG RKSVNet - Webservice Signierung von Belegen via Internet Dieser Signierdienst via Internet ist für Kassensoftwarehersteller gedacht, die Ihre Kassensoftware über das Internet Ihren Kunden zugänglich machen und eine Möglichkeit zum Signieren der Belege benötigen. Wir stellen vorerst einen Testzugang auf unserem Webserver als Entwicklungshilfe zur Verfügung. Der Echtbetrieb wird allerdings im zertifizierten Rechenzentrum von Global Trust abgewickelt. Als HSM kommt die Luna SA 1700 zum Einsatz. Das Webservice befindet sich auf: und dient ausschließlich zu Testzwecken. Für Testzwecke wird von unserer Seite für den Kunden/Interessenten eine Testfirma angelegt sowie zwei User und zwei Kassen. Weiters wird von uns ein Key-Pair (private, public) für die Signierung aller Belege verwendet. In weiterer Folge wird das Zertifikat von der GlobalTrust über das Webservice bereitgestellt. Die Test-Zugangsdaten werden per versendet und Sie können den Signierdienst testen. Gerne stellen wir Ihnen das WSDL-File (RKSVNet.svc.wsdl) sowie einen Testclient (RKSV.Net.Client.exe) für das Webservice zur Verfügung sowohl als ausführbarer Code als auch den Source Code dazu in c# - als Implementierungsbeispiel. Die Funktion zum Signieren: bool SignReceipt ( string susername, string spassword, string scompanyguid, string scashboxid, RKSVReceipt oreceipt, ref string sjwscompactresult, RetVal osignreceiptresult) Funktion zur Erzeugung des QR-Codes (RKSVConvert.dll) Der QR-Code wird aus dem String sjwscompactresult generiert. Diese Funktion wird sinnvollerweise auf dem Client ausgeführt, um unnötigen Datenverkehr zu vermeiden (sjwscompactresult hat eine Länge von ca. 300 Byte, während der QR-Code eine Länge von ca. 20 Kilobyte aufweist) bool ConvertJwsToQrImage(string sjwscompactresult, out Image img) Beispiel: Image img = null; if (RKSVConvert.RKSVConvert.ConvertJwsToQrImage(sJWSCompactResult, out img)) pictureboxqrcode.image = img;

Der Echtbetrieb wird allerdings im zertifizierten Rechenzentrum von Global Trust abgewickelt. Als HSM kommt die Luna SA 1700 zum Einsatz. Das Webservice befindet sich auf: https://mobile.

2 Beschreibung der beiden Objekte (RKSVReceipt, RetVal) die für die Signierfunktion benötigt werden public class RKSVReceipt string GUID get; set; // Kassenidentifikationsnummer string m_kassenidentifikation = string.empty; // Fortlaufende Nummer des Barumsatzes string m_belegnummer = string.empty; // Datum und Uhrzeit der Belegausstellung ( T23:34:30) DateTime m_datumuhrzeit = DateTime.Now; // Betrag Steuersatz-Normal decimal m_betragsatznormal = 0; // Betrag Steuersatz-Ermässigt-1 decimal m_betragsatzermaessigt1 = 0; // Betrag Steuersatz-Ermässigt-2 decimal m_betragsatzermaessigt2 = 0; // Betrag Steuersatz-Null decimal m_betragsatznull = 0; // Betrag Steuersatz-Besonders decimal m_betragsatzbesonders = 0; decimal m_standumsatzzaehlerplain = 0; string m_standumsatzzaehleraes = string.empty; // Seriennummer des Signaturzertifikates string m_zertifikatseriennummer = string.empty; // Signaturwert des vorhergehenden Barumsatzes des Datenerfassungsprotokolls (letzte 10 Stellen) string m_sigvorrigerbeleg = string.empty; // Signaturwert des betreffenden Barumsatzes string m_sigbeleg = string.empty; /* Objects for Json Web Signature */ string m_jwstoken = string.empty; string m_jwsheader = string.empty; string m_jwspayload = string.empty; string m_jwssignature = string.empty; public string KassenIdentifikation get return m_kassenidentifikation;

empty; // Datum und Uhrzeit der Belegausstellung (2017-06-14T23:34:30) DateTime m_datumuhrzeit = DateTime.

3 set m_kassenidentifikation = value; public string Belegnummer get return m_belegnummer; set m_belegnummer = value; public DateTime BelegDatumUhrzeit get return m_datumuhrzeit; set m_datumuhrzeit = value; public decimal BetragSatzNormal get return m_betragsatznormal; set m_betragsatznormal = value; public decimal BetragSatzErmaessigt1 get return m_betragsatzermaessigt1; set m_betragsatzermaessigt1 = value; public decimal BetragSatzErmaessigt2 get return m_betragsatzermaessigt2; set m_betragsatzermaessigt2 = value; public decimal BetragSatzNull get return m_betragsatznull; set m_betragsatznull = value; public decimal BetragSatzBesonders get return m_betragsatzbesonders; set m_betragsatzbesonders = value; public decimal StandUmsatzZaehlerPlain get return m_standumsatzzaehlerplain; set m_standumsatzzaehlerplain = value;

m_betragsatzermaessigt1 = value; public decimal BetragSatzErmaessigt2 get return m_betragsatzermaessigt2; set m_betragsatzermaessigt2 = value; public decimal BetragSatzNull get return

4 public string StandUmsatzZaehlerAES get return m_standumsatzzaehleraes; set m_standumsatzzaehleraes = value; public string ZertifikatSeriennummer get return m_zertifikatseriennummer; set m_zertifikatseriennummer = value; public string SigVorrigerBeleg get return m_sigvorrigerbeleg; set m_sigvorrigerbeleg = value; public string SigBeleg get return m_sigbeleg; set m_sigbeleg = value; public string JWSToken get return m_jwstoken; set m_jwstoken = value; public string JWSHeader // Base64URL get return m_jwsheader; set m_jwsheader = value; public string JWSPayload // Base64URL get return m_jwspayload; set m_jwspayload = value; public string JWSSignature // Base64URL get return m_jwssignature; set m_jwssignature = value;

get return m_sigbeleg; set m_sigbeleg = value; public string JWSToken get return m_jwstoken; set m_jwstoken = value; public string JWSHeader // Base64URL get return m_jwsheader;

5 public class RetVal private string m_status; private bool m_passed; public string Status get return m_status; set m_status = value; public bool Passed get return m_passed; set m_passed = value; public RetVal() public RetVal(bool passed, string status) m_passed = passed; m_status = status; public static RetVal OK() return new RetVal(true, "passed"); public static RetVal OK(string text) return new RetVal(true, text); public static RetVal Error(string text) return new RetVal(false, text);

status) m_passed = passed; m_status = status; public static RetVal OK() return new RetVal(true, "passed"); public static

Ähnliche Dokumente

Verwendung der PayJoe -API zum externen Upload von Belegen und Zahlungen

Verwendung der PayJoe -API zum externen Upload von Belegen und Zahlungen Um über die PayJoe -API Belege bzw. Zahlungen hochladen zu können, müssen Sie zunächst einen entsprechenden Zugang anlegen, bei