Saltar al contenido principal

DocumentType: AuditLog — Registro de eventos de auditoría

Armir Alidema
  • Actualización

Con el DocumentType «AuditLog», ahora es posible registrar eventos no transaccionales (por ejemplo, inicios de sesión de usuarios o la apertura de la caja registradora) y hacer que se firmen a través del punto final estándar, al igual que los recibos habituales.

 

1. Nuevo tipo de documento (DocumentType)

La DocumentType enum ahora incluye la siguiente opción para registrar eventos auditables:

  • AuditLog (1002)

 

2. Nuevas propiedades en el modelo de documento

Al establecer el documentType en AuditLog, deben utilizarse las siguientes propiedades nuevas en el Document objeto:

Propiedad Tipo Descripción
AuditLogEntryType Enumeración LogEntryType (Obligatorio) Define el tipo de evento de auditoría. En la siguiente sección se puede consultar una lista completa.
amount ¿decimal? (Opcional) Importe en decimal asociado a la entrada de registro, p. ej., el importe de una discrepancia en la caja registradora.
identificador cadena (Opcional) Cadena adicional para identificación o para aportar más contexto, p. ej., para indicar qué cajón de caja se ha abierto.

3. Eventos de AuditLogEntryTypes

Eventos de documento

  • documentReprintOther
  • documentSuspend
  • documentResume
  • documentTrainingModeOn
  • documentModoFormaciónDesactivado
  • documentoTipoVentas
  • documentoTipoDevolución
  • documentoTipoProforma
  • tipo de documento: Entrega
  • Tipo de documento: Formación
  • tipo de documento: «Retirada»
  • tipo de documento: pago
  • tipo de documento: ingreso
  • tipo de documento «saldo inicial»
  • tipo de documento: recibo nulo
  • tipo de documento: factura
  • tipo de documento «Otros»
  • tipo de documento Anulación
  • tipo de documento «Pedido a largo plazo»
  • tipo de documento: Confirmación de pago
  • tipo de documento: pedido de cliente
  • tipo de documento: inventario
  • tipo de documento: Compra
  • reimpresión de documento de pedido a largo plazo
  • reimpresión de documento de confirmación de pago
  • reimpresión de recibo
  • reimpresión de factura
  • documentoDuplicadoDelRecibo
  • documentoDuplicadoFactura
  • documento: Anular pedido a largo plazo
  • rastrear un pedido a largo plazo no impreso
  • documentoCancelarLínea
  • documentoAnularLínea
  • documentoCancelarDocumento
  • actualización de pago de documento
  • actualización de documento de pedido a largo plazo
  • actualización de línea de documento
  • actualización de tabla de documento

Eventos de hardware y de usuario

  • cajón abierto
  • cierre del cajón
  • impresora no disponible
  • impresora disponible
  • userLogin
  • cierre de sesión de usuario
  • cambio de permisos de usuario

Eventos de la aplicación y del sistema

  • inicio de la aplicación
  • aplicaciónCerrada
  • actualización de la aplicación
  • actualización menor de la aplicación
  • actualización del middleware fiscal de la aplicación
  • activación del modo de emergencia de la aplicación
  • aplicaciónModoDeEmergenciaDesactivado
  • inicialización de la aplicación
  • aplicaciónAñadirEstaciónDeTrabajo
  • eliminarEstaciónDeTrabajo
  • activarModoSinConexión
  • applicationOfflineModeOff

Eventos relacionados con los datos maestros y la integridad de los datos

  • cambio de precio de un elemento de datos maestros
  • consulta de precio de elemento de datos maestros
  • Actualización de la empresa de un elemento de datos maestros
  • transferencia de propiedad
  • dataIntegrityBackupDatabase
  • Restauración de la integridad de los datos de la base de datos
  • integridadDeDatosPurgaBaseDeDatos
  • purga del registro de eventos de integridad de datos
  • integridadDeDatosRecuperaciónDeDatos
  • integridadDeDatosReenvíoDeDatos
  • Consolidación de la integridad de los datos completada
  • fallo de integridad de datos
  • cambio en la secuencia de datos
  • fallo en la secuencia de datos
  • importación de datos externos
  • exportación de datos contables
  • exportación de datos genérica

Eventos fiscales y de informes

  • día de cierre del período fiscal
  • mes de cierre del período fiscal
  • año de cierre del período fiscal
  • día de cierre del informe fiscal
  • informe fiscal: informe de usuario
  • error fiscal recibido de las autoridades
  • año de archivo fiscal
  • archivo fiscal intermedio
  • exportación del libro mayor fiscal
  • clave de actualización de la firma fiscal
  • auditoría fiscal
  • transferencia de archivos de auditoría fiscal

General

  • otros (tipo genérico para eventos no incluidos en la lista)

4. Envío de un documento de AuditLog

Los documentos AuditLog se envían al mismo punto final (endpoint) que el resto de documentos transaccionales: 

  • POST /api/v1/transactions/storeDocument

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

Ejemplo de respuesta

La respuesta contiene datos de fiscalización relevantes para el país en cuestión, como se muestra en el ejemplo siguiente correspondiente a Alemania, que incluye detalles sobre el TSE (Equipo Técnico de Seguridad).

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

Este artículo ha sido traducido automáticamente.

Artículos relacionados

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.

Tecnología de Zendesk