DocumentType: AuditLog – Rejestr zdarzeń audytowych

Dzięki dokumentTypowi „AuditLog” możliwe jest obecnie rejestrowanie zdarzeń nietransakcyjnych (np. logowania użytkowników lub otwierania szuflady kasowej) oraz podpisywanie ich za pośrednictwem standardowego punktu końcowego, podobnie jak w przypadku zwykłych paragonów.

1. Nowy typ dokumentu (documentType)

Enum DocumentType enum zawiera teraz następującą opcję służącą do rejestrowania zdarzeń podlegających audytowi:

• AuditLog (1002)

2. Nowe właściwości w modelu dokumentu

Po ustawieniu documentType wartość AuditLog, w obiekcie Document :

3. Dostępne AuditLogEntryTypes

Zdarzenia związane z dokumentami

• documentReprintOther
• documentSuspend
• documentResume
• włączenie trybu szkoleniowego dokumentu
• wyłączenie trybu szkoleniowego dokumentu
• typ_dokumentu_sprzedaż
• typ_dokumentuZwrot
• typ_dokumentu_proforma
• typ_dokumentu_dostawa
• typ_dokumentuSzkolenie
• typ_dokumentu_wypłata
• typ_dokumentu_wypłata
• typ_dokumentu_wpłata
• typ_dokumentuSaldoPoczątkowe
• typ_dokumentu_brak_pokwitowania
• typ_dokumentu_faktura
• typ_dokumentu_inne
• typ_dokumentu_unieważniony
• typ_dokumentu_zamówienie_długoterminowe
• typ_dokumentu_potwierdzenie_płatności
• typ_dokumentuZamówienieKlienta
• typ_dokumentu_stan_magazynu
• typ_dokumentu_zakup
• dokumentPonowneDrukowanieZamówieniaDługoterminowego
• dokumentPonownyDrukPotwierdzeniaPłatności
• dokumentReprintPotwierdzenieOdbioru
• dokument: ponowny wydruk faktury
• duplikat pokwitowania
• duplikat faktury
• dokumentAnulowanie zamówienia długoterminowego
• śledzenie niewydrukowanego zamówienia długoterminowego
• dokumentAnulujPozycję
• unieważnienie pozycji w dokumencie
• dokumentAnulujDokument
• aktualizacja płatności w dokumencie
• aktualizacja dokumentu zamówienia długoterminowego
• aktualizacja wiersza dokumentu
• aktualizacja_tabeli_dokumentu

Zdarzenia sprzętowe i użytkowe

• otwarcie szuflady
• zamknięcie szuflady
• drukarka niedostępna
• drukarka dostępna
• zalogowanie_użytkownika
• wylogowanie użytkownika
• zmiana uprawnień użytkownika

Zdarzenia aplikacji i systemu

• uruchomienie aplikacji
• zamknięcie aplikacji
• aktualizacja aplikacji
• drobna aktualizacja aplikacji
• aktualizacja oprogramowania pośredniczącego aplikacji w zakresie finansów
• włączenie trybu awaryjnego aplikacji
• wyłączenie trybu awaryjnego aplikacji
• inicjalizacja aplikacji
• aplikacjaDodajStacjęRoboczą
• usunięcie stacji roboczej
• włączenie trybu offline aplikacji
• wyłączenie trybu offline aplikacji

Zdarzenia dotyczące danych podstawowych i integralności danych

• zmianaCenyElementuDanychPodstawowych
• wyszukiwanie ceny pozycji danych podstawowych
• aktualizacja danych podstawowych pozycji z uwzględnieniem zmiany firmy
• przeniesienie własności
• kopia zapasowa bazy danych w celu zapewnienia integralności danych
• przywrócenie integralności danych bazy danych
• sprawdzanie integralności danych – czyszczenie bazy danych
• oczyszczenie dziennika zdarzeń w ramach integralności danych
• integralność danych – odzyskiwanie danych
• integralność danych – przekazywanie danych
• dataIntegrityConsolidationComplete
• błąd integralności danych
• zmiana sekwencji danych
• błąd sekwencji danych
• import danych z zewnętrznego źródła
• eksport danych księgowych
• eksport danych ogólny

Zdarzenia związane z rokiem obrotowym i sprawozdaniami

• dzień zamknięcia okresu rozliczeniowego
• miesiąc zamknięcia okresu rozliczeniowego
• fiscalPeriodClosingYear
• fiscalReportClosingDay
• raport użytkownika dotyczący sprawozdania finansowego
• błąd-finansowy-otrzymany-od-organów-władzy
• rok archiwizacji sprawozdań finansowych
• rok archiwizacji pośredniej
• eksport dziennika księgowego
• klucz aktualizacji podpisu podatkowego
• audyt podatkowy
• fiskalnyPrzesyłPlikuAudytu

Ogólne

• inne (typ ogólny dla zdarzeń nieujętych na liście)

4. Przesyłanie dokumentu AuditLog

Dokumenty AuditLog są przesyłane do tego samego punktu końcowego, co wszystkie inne dokumenty transakcyjne: 

• POST /api/v1/transactions/storeDocument

Przykładowy JSON payload

{
  "ModelVersion": "1.6.1",
  "UniqueClientId": "2a296a14-f644-4f3f-9ea2-d3f00a3b587c",
  "UniqueCashRegisterId": "005-006",
  "FiscalModuleVersion": "1.10.2.0",
  "FiscalCountryModuleVersion": "1.0.21",
  "SoftwareName": "x x x",
  "AdditionalFields": {},
  "AutomaticVatCalculation": 0,
  "AuditLogEntryType": "userLogin",
  "DocumentGuid": "a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5",
  "DocumentId": "AUD-LOGIN-001",
  "CreateDate": "2025-08-08T12:59:10+02:00",
  "BookDate": "2025-08-08T12:59:10+02:00",
  "DocumentNumber": "AUD-LOGIN-001",
  "IsTraining": true,
  "DocumentType": "[1002] = AuditLog",
  "User": {
    "Id": "Armir A",
    "Caption": "Armir A"
  },
  "AllocationGroups": [],
  "PositionCount": 0,
  "FiscalDocumentNumber": 8,
  "FiscalDocumentRevision": 1,
  "FiscalDocumentStartTime": 1754657874,
  "Positions": [],
  "Payments": [],
  "AdditionalHeader": [],
  "AdditionalFooter": [],
  "FiscalAdditionalFields": {}
}

Przykładowa odpowiedź

Odpowiedź zawiera dane dotyczące fiskalizacji właściwe dla danego kraju, takie jak w poniższym przykładzie dla Niemiec, który obejmuje szczegóły dotyczące TSE (technicznego sprzętu zabezpieczającego).

{
  "FiscalCountry": "[0] = Germany",
  "FiscalisationDocumentNumber": 8,
  "FiscalDocumentNumber": "8",
  "FiscalDocumentStartTime": 1754657874,
  "ProcessStartTime": 0,
  "ErrorDescription": null,
  "CashRegisterId": "005-006",
  "Signature": "wn0cwKYhCes0dy4gEfjB7aAQF+iHXsyX3E6u9bBsJtJZTMtOoJ4IMDUYNJzZyykmZdrEMiT3YqtBvG7J/3sNzw==",
  "UserMessage": null,
  "PrintMessage": "***Test***",
  "RequestTime": "2025-08-08T12:58:47.310674+00:00",
  "RequestCompletionTime": "2025-08-08T12:58:47.6602076+00:00",
  "QrCode": "V0;005-006;SonstigerVorgang;AVSonstige;8;78;2025-08-08T12:57:54.000Z;2025-08-08T12:58:46.000Z;ecdsa-plain-SHA256;unixTime;wn0cwKYhCes0dy4gEfjB7aAQF+iHXsyX3E6u9bBsJtJZTMtOoJ4IMDUYNJzZyykmZdrEMiT3YqtBvG7J/3sNzw==;BFG6opUQnbSdHq76J8py+zy5iw9zeCdwgRkhQJIkDKz38NrDiAiFvNwKf4NRRyzyRXGZB1vuFmqWJLr+gi6GKIg=",
  "PrintingFields": {
    "NOT IMPLEMENTED": "NOT IMPLEMENTED"
  },
  "AdditionalFields": {
    "QrCodeDataString": "V0;005-006;SonstigerVorgang;AVSonstige;8;78;2025-08-08T12:57:54.000Z;2025-08-08T12:58:46.000Z;ecdsa-plain-SHA256;unixTime;wn0cwKYhCes0dy4gEfjB7aAQF+iHXsyX3E6u9bBsJtJZTMtOoJ4IMDUYNJzZyykmZdrEMiT3YqtBvG7J/3sNzw==;BFG6opUQnbSdHq76J8py+zy5iw9zeCdwgRkhQJIkDKz38NrDiAiFvNwKf4NRRyzyRXGZB1vuFmqWJLr+gi6GKIg=",
    "TransactionStartTime": 1754657874,
    "TransactionEndTime": 1754657926,
    "ProcessData": "AVSonstige",
    "ProcessType": "SonstigerVorgang",
    "TseSerial": "2b56a7b994fdb3be51f973b311db0a4494d88dc2d63efdc8fb6c2f1f3df1b696",
    "TseTimeFormat": "unixTime",
    "TseHashAlgorithm": "ecdsa-plain-SHA256",
    "TsePublicKey": "BFG6opUQnbSdHq76J8py+zy5iw9zeCdwgRkhQJIkDKz38NrDiAiFvNwKf4NRRyzyRXGZB1vuFmqWJLr+gi6GKIg=",
    "TseSignatureCounter": 78,
    "TseCertificate": "MIID0jCCA1mgAwIBAgIRAOxMaXsnzvjB/LzUZ7EN3ogwCgYIKoZIzj0EAwMwVTELMAkGA1UEBhMCQVQxFTATBgNVBAoTDGZpc2thbHkgR21iSDEjMCEGA1UEAxMaVEVTVC1GSVNLQUxZLVRTRS1TVUItQ0EtMDExCjAIBgNVBAUTATEwHhcNMjUwNjI3MDAwMjM0WhcNMzMwNjI3MjM1OTU5WjCB2TELMAkGA1UEBhMCQVQxFTATBgNVBAoTDGZpc2thbHkgR21iSDFOMEwGA1UEAwxFVEVTVC1CU0ktRFNaLUNDLTExNTNfQlNJLURTWi1DQy0xMTMwX0M0RjlFNkVDNkUxRTRENjg5NTlDNjFEREFDNjU0QTdDMUkwRwYDVQQFE0AyYjU2YTdiOTk0ZmRiM2JlNTFmOTczYjMxMWRiMGE0NDk0ZDg4ZGMyZDYzZWZkYzhmYjZjMmYxZjNkZjFiNjk2MRgwFgYDVQQuEw9CU0ktRFNaLUNDLTExNTMwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAARRuqKVEJ20nR6u+ifKcvs8uYsPc3gncIEZIUCSJAys9/Daw4gIhbzcCn+DUUcs8kVxmQdb7hZqliS6/oIuhiiIo4IBgzCCAX8wDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAU4lSqfYaZDlZy+rtN24iJKVDaxzYwRAYIKwYBBQUHAQEEODA2MDQGCCsGAQUFBzAChihodHRwczovL2thc3NlbnNpY2h2LXRlc3QtcGtpLmZpc2thbHkuY29tMF4GA1UdHwRXMFUwU6BRoE+GTWh0dHA6Ly9rYXNzZW5zaWNodi10ZXN0LXBraS5maXNrYWx5LmNvbS9jcmw/aXNzdWVyPVRFU1QtRklTS0FMWS1UU0UtU1VCLUNBLTAxMEcGA1UdEgRAMD6BEm9mZmljZUBmaXNrYWx5LmNvbYYoaHR0cHM6Ly9rYXNzZW5zaWNodi10ZXN0LXBraS5maXNrYWx5LmNvbTBPBgNVHSAESDBGMEQGCisGAQQBg7YgAQMwNjA0BggrBgEFBQcCARYoaHR0cHM6Ly9rYXNzZW5zaWNodi10ZXN0LXBraS5maXNrYWx5LmNvbTAKBggqhkjOPQQDAwNnADBkAjAanoJFOYfYD6PN8k2WfLLiskBHuGiYKkLrTJWlvwzLpMU+7UeZT85eizm5BLo6OWwCMBsv+mErzb9grV/kHJsu9tJcIqhWXJSdKabAc4J6mTtiCFMSUikJgwO9NTpTdd1KEg==",
    "FiscalDocumentRevision": 2
  }
}

Ten artykuł został przetłumaczony automatycznie.