DocumentType : AuditLog – Enregistrement des événements d’audit – RetailForce

Grâce au DocumentType « AuditLog », il est désormais possible d’enregistrer des événements non transactionnels (par exemple, les connexions des utilisateurs ou l’ouverture du tiroir-caisse) et de les faire signer via le point de terminaison standard, tout comme les reçus classiques.

1. Nouveau type de document (DocumentType)

enum désormais l’option suivante pour capturer les événements audités : DocumentType enum contient désormais l’option suivante pour la capture d’événements auditable :

AuditLog (1002)

2. Nouvelles propriétés dans le modèle de document

Lorsque vous définissez la documentType sur AuditLog, les nouvelles propriétés suivantes doivent être utilisées dans l’ Document :

Propriété	Type	Description
AuditLogEntryType	Énumération LogEntryType	(Obligatoire) Définit le type d’événement d’audit. Vous trouverez la liste complète dans la section suivante.
montant	décimal ?	(Facultatif) Montant monétaire associé à l’entrée de journal, par exemple le montant d’un écart de caisse.
identifiant	string	(Facultatif) Une chaîne supplémentaire à des fins d’identification ou pour fournir davantage de contexte, par exemple pour indiquer quel tiroir-caisse a été ouvert.

3. Événements `AuditLogEntryTypes`

Événements liés aux documents

documentReprintOther
documentSuspend
documentResume
documentModeFormationActivé
documentModeFormationDésactivé
documentTypeVentes
documentTypeRetour
documentTypeProforma
typeDeDocumentLivraison
type de document : Formation
typeDeDocumentRetrait
type de document « Versement »
type de document « Versement »
type de document « Solde d'ouverture »
type de document « Reçu nul »
type de document « facture »
typeDeDocumentAutre
typeDeDocumentAnnulé
typeDeDocumentCommandeÀLongTerme
typeDeDocumentConfirmationDePaiement
type de document « Commande client »
type de document « Stock »
type de document « Achat »
réimpression de commande à long terme
réimpression de document de confirmation de paiement
réimpression du document « Reçu »
réimpression de la facture
documentDuplicata du reçu
documentDuplicata de la facture
documentAnnulationCommandeÀLongTerme
documentSuiviCommandeÀLongTermeNonImprimée
documentAnnulerLigne
documentAnnulerLigne
documentAnnulerDocument
Mise à jour du paiement d’un document
Mise à jour d’une commande à long terme
documentMiseÀJourLigne
documentMiseÀJourTableau

Événements liés au matériel et à l’utilisateur

ouverture du tiroir
fermeture du tiroir
imprimante indisponible
imprimante disponible
connexionUtilisateur
déconnexion de l'utilisateur
modification des droits de l'utilisateur

Événements liés aux applications et au système

démarrage de l'application
arrêt de l'application
Mise à jour majeure de l'application
Mise à jour mineure de l'application
applicationFiscalMiddlewareUpdate
applicationModeUrgenceActivé
applicationModeD'urgenceDésactivé
initialisation de l'application
applicationAjouterUnPosteDeTravail
applicationSupprimerPosteDeTravail
applicationModeHorsLigneActivé
applicationModeHorsLigneDésactivé

Événements relatifs aux données de référence et à l'intégrité des données

modification du prix d’un élément de données de référence
Recherche de prix d’un élément de données de référence
Mise à jour de l'entreprise d'un élément de données de base
transfertDePropriété
Sauvegarde de la base de données pour l'intégrité des données
Vérification de l'intégrité des données et restauration de la base de données
intégritéDesDonnéesPurgeBaseDeDonnées
purge du journal des événements pour l'intégrité des données
intégritéDesDonnéesRécupérationDesDonnées
intégritéDesDonnéesTransfertDeDonnées
dataIntegrityConsolidationTerminée
Échec de l'intégrité des données
Modification de la séquence de données
Échec de la séquence de données
importation de données externes
exportation de données comptables
exportation de données générique

Événements comptables et de reporting

fiscalPeriodClosingDay
fiscalPeriodClosingMonth
fiscalPeriodClosingYear
fiscalReportClosingDay
rapport-fiscal-rapport-utilisateur
erreur comptable signalée par les autorités
Année d’archivage comptable
fiscalArchiveIntermédiaire
exportation du journal comptable
clé de mise à jour de la signature fiscale
audit-fiscal
fiscalAuditFileTransfer

Général

autre (type générique pour les événements ne figurant pas dans la liste)

4. Envoi d’un document AuditLog

Les documents AuditLog sont envoyés au même point de terminaison que tous les autres documents transactionnels :

POST /api/v1/transactions/storeDocument

Exemple de charge utile JSON

{
  "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": {}
}

Exemple de réponse

La réponse contient des données de fiscalisation spécifiques au pays concerné, comme dans l’exemple ci-dessous pour l’Allemagne, qui inclut des détails relatifs aux TSE (équipements techniques de sécurité).

{
  "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
  }
}

Cet article a été traduit automatiquement.