fiscalResponseGermany

Po przesłaniu dokumentu do usługi RetailForce Fiscalisation (za pomocą metod createDocument i storeDocument) usługa zwraca tzw. fiscalResponse. Ogólny opis tego obiektu znajduje się w artykule „Obiekt fiscalResponse”.

W zależności od kraju, w którym obowiązują przepisy fiskalne przypisane do danego klienta (zależnie od odpowiedniej konfiguracji klienta), w tablicy „AdditionalFields” mogą znajdować się różne informacje. Niniejszy artykuł przedstawia informacje zwracane w odpowiedzi w ramach fiskalizacji w Niemczech (zgodnie z rozporządzeniem w sprawie zabezpieczenia kas fiskalnych przed manipulacją – KassenSichV).

AdditionalFields w obiekcie fiscalResponse dla Niemiec

{
  "fiscalCountry": "[0] = Germany",
  "fiscalisationDocumentNumber": 561,
  "fiscalDocumentNumber": "561",
  "fiscalDocumentStartTime": 1683289833,
  "processStartTime": 0,
  "errorDescription": null,
  "cashRegisterId": "00345-00345",
  "signature": "WlVgLXiFXDzDID2BnqN3eZyiEPNAtu00iJOvHQA61FJMvO0G1jNWaXLFs8UFuYxo1IiVD50sR/DYQkAKvqQjEw==",
  "userMessage": null,
  "printMessage": "***Test***",
  "requestTime": "2023-05-05T14:32:03.9697128+02:00",
  "requestCompletionTime": "2023-05-05T14:32:04.4637647+02:00",
  "retailForceReceiptId": "0p4j0001",    /// only for createDocument
  "AdditionalFields": {
    "QrCodeDataString": "V0;00345-00345;Kassenbeleg-V1;Beleg^0.00_0.00_0.00_0.00_0.00^0.00:Bar;61;178;2023-05-05T12:30:33.000Z;2023-05-05T12:32:03.000Z;ecdsa-plain-SHA256;unixTime;WlVgLXiFXDzDID2BnqN3eZyiEPNAtu00iJOvHQA61FJMvO0G1jNWaXLFs8UFuYxo1IiVD50sR/DYQkAKvqQjEw==;BIKU1KFtZqOqfo5Uzrxqkm50mDeHu6e2besCl4WtFz7cXIjB25/LhynCuWQTlVUoSoWzx2gn8chos3/X1EOq8b0=",
    "TransactionStartTime": 1683289833,
    "TransactionEndTime": 1683289923,
    "ProcessData": "Beleg^0.00_0.00_0.00_0.00_0.00^0.00:Bar",
    "ProcessType": "Kassenbeleg-V1",
    "TseSerial": "7f18ca57319a2dfdad246da26ba0133a64304f56fe0573bb5fc90c0ff4c99c61",
    "TseTimeFormat": "unixTime",
    "TseHashAlgorithm": "ecdsa-plain-SHA256",
    "TsePublicKey": "BIKU1KFtZqOqfo5Uzrxqkm50mDeHu6e2besCl4WtFz7cXIjB25/LhynCuWQTlVUoSoWzx2gn8chos3/X1EOq8b0=",
    "TseSignatureCounter": 878,
    "TseCertificate": "MIIB0zCCAVigAwIBAgIgfxjKVzGaLf2tJG2ia6ATOmQwT1b+BXO7X8kMD/TJnGEwCgYIKoZIzj0EAwMwMTEVMBMGA1UEChMMZmlza2FseSBHbWJIMRgwFgYDVQQDEw9maXNrYWx5IFRlc3QgQ0EwHhcNMjMwMjIwMDgzMTMyWhcNMjQwMjIwMDgzMTMyWjAyMRUwEwYDVQQKEwxmaXNrYWx5IEdtYkgxGTAXBgNVBAMTEGZpc2thbHkgVGVzdCBUU0UwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAASClNShbWajqn6OVM68apJudJg3h7untm3rApeFrRc+3FyIwdufy4cpwrlkE5VVKEqFs8doJ/HIaLN/19RDqvG9o0EwPzAOBgNVHQ8BAf8EBAMCB4AwDAYDVR0TAQH/BAIwADAfBgNVHSMEGDAWgBSWWUHKZAG6nqV0oaiNlWlm1Ybm1DAKBggqhkjOPQQDAwNpADBmAjEAlA2kITrQZzBca/Jn6oTJG1UJfwbuG7XKuokxWrUN2sZLJqKhkddS3l+bb2bkSADDAjEA4jngqpenY4bFKnGA55iFOTMD7klUoVXLmfmxHcTHaF95BbIGoCrpR/sT69qgEP1P",
    "fiscalDocumentRevision": 2
  }
}

W kontekście fiskalizacji w Niemczech wykorzystywane (przesyłane) są następujące pola dodatkowe.

Elementy		Typ	Opis
AdditionalFields			Informacje specyficzne dla danego kraju
	QrCodeDataString		Ciąg danych kodu QR zgodnie z załącznikiem I do rozporządzenia DSFinV-K. Dane zawarte w polu „QrCodeDataString” można przekształcić w kod QR (jako alternatywę dla pełnych danych TSE) i wydrukować na paragonie. Proszę również zwrócić uwagę na: Wymogi dotyczące dokumentów w Niemczech
	TransactionStartTime		Czas rozpoczęcia niniejszego dokumentu podatkowego (czas wywołania funkcji createDocument, wyrażony w sekundach czasu Unix).
	TransactionEndTime		Czas zakończenia transakcji. Sygnatura czasowa / moment w czasie mierzony w sekundach od epoki Unix.
	ProcessData		Dane przetwarzania podpisanej transakcji zgodnie z „Rozporządzeniem wykonawczym do § 146a Ogólnego Kodeksu Podatkowego / Anwendungserlass zu § 146a AO”. Wartość binarna (string znaków UTF-8 zakodowany w systemie Base64).
	ProcessType		Typ procesu podpisanej transakcji zgodnie z „Rozporządzeniem wykonawczym do § 146a Ogólnego Kodeksu Podatkowego / Anwendungserlass zu § 146a AO”.
	TseSerial		Numer seryjny wykorzystanego urządzenia TSE
	TseTimeFormat		Format czasu stosowany przez moduł TSE
	TseHashAlgorithm		Algorytm HASH stosowany przez moduł TSE
	TsePublicKey		Klucz publiczny certyfikatu TSE
	TseSignatureCounter		Stan licznika podpisów TSE
	TseCertificate		Certyfikat TSE
	fiscalDocumentRevision		Numer wersji dokumentu podatkowego. Wydany przez certyfikowaną organizację ds. bezpieczeństwa technicznego (TSE). Szczegóły dotyczące kraju: Niemcy: właściwość fiscalDocumentRevision (wraz z jej wartością) zawarta w odpowiedzi fiscalResponse po wywołaniu funk cji createDocument musi zostać uwzględniona w dokumencie JSON, który ma zostać przesłany do funkcji storeDocument . Uwaga: W wersji 1.7.7 dawna właściwość „fiscalisation DocumentRevision” w hederze odpowiedzi fiscalResponse została zastąpiona właściwością „fiscalDocumentRevision” i jest obecnie przekazywana wyłącznie w sekcji „AdditionalFields” odpowiedzi fiscalResponse dla Niemiec.

Ten artykuł został przetłumaczony automatycznie.

FiscalResponseGermany

Powiązane artykuły