POST /api/v1/transactions/AuditLog – RetailForce

El punto final POST /api/v1/transactions/AuditLog permite añadir una entrada de evento para el client fiscal correspondiente, lo cual es importante para la trazabilidad de las transacciones y los procesos internos del sistema, y es un requisito legal en algunos países.

Importante: Los eventos deben enviarse de forma sincronizada y en el orden correcto. Al igual que con los documentos, los eventos (auditorías) no deben enviarse de forma agrupada (paquete).

Resultado

Una llamada correcta al punto final (200)

añade una entrada de registro de auditoría al diario de eventos técnicos.

Uso

Este punto final se utiliza para registrar los eventos que el sistema de caja registradora está obligado a registrar.

Asignación de códigos de evento

La información relativa a la correspondencia entre los códigos de evento de RetailForce y los códigos de evento de países específicos se puede consultar en la sección «Registro de eventos técnicos / Registro de eventos».

Requisitos

El cliente fiscal debe estar inicializado y en funcionamiento.

Proceso de transmisión

La solicitud debe enviarse como un objeto JSON:

{
  "recordId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "uniqueClientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "logEntryType": "100",
  "message": "string",
  "documentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "user": {
    "id": "string",
    "caption": "string",
    "firstName": "string",
    "lastName": "string",
    "taxNumber": "string",
    "dateOfEntry": "2022-01-01T00:00:00+01:00"
  },
  "amount": 0,
  "identifier": "string",
  "recordDateTime": "2023-12-07T10:14:19.859+01:00",
  "signature": "string"
}

Campos del formulario

Información de la columna «Tipo»:

M ... obligatorio / requerido
M* ... obligatorio en determinados países o bajo determinadas condiciones
R ... recomendado
O... opcional

Elemento		Tipo	Descripción
RecordId			identificador único de la entrada.
uniqueClientId		M	El «uniqueClientId» del punto de venta (perteneciente al RetailForce system) al que pertenece la entrada del registro de auditoría.
LogEntryType			El tipo de la entrada del registro de auditoría.
mensaje			Mensaje asociado a la entrada de auditoría.
DocumentGuid			Posible referencia a un documento relacionado con la entrada del registro de auditoría
usuario			El usuario (si procede) de la entrada del registro de auditoría.
	{...}
amount			Importe total del documento
identificador			Un posible identificador de la entrada del registro de auditoría.
fecha y hora de registro		M	La fecha y hora de registro de la entrada del registro de auditoría.
firma

Ejemplo:

// Saving the transaction
{
  "recordId": "58b55595-2796-4d65-b90f-4b2e1549db44",
  "uniqueClientId": "58b55595-2796-4d65-b90f-4b2e1549db44",
  "LogEntryType": 100,
  "Message": "DocumentTypeSales",
  "documentGuid": "215c2395-ab4a-4132-858d-86459a9e883a",
  "user": {
    "id": "1234",
    "caption": "Max Thomas"
  },
  "amount": 12.5,
  "identifier": "0000001",
  "recordDateTime": "2023-12-07T10:15:45+01:00"
}
// Closing the cash drawer
{
  "recordDateTime": "2023-12-07T10:15:46+01:00",
  "UniqueClientId": "58b55595-2796-4d65-b90f-4b2e1549db44",
  "LogEntryType": 201,
  "Message": "DrawerClose",
  "DocumentGuid": null,
  "user": {
    "id": "1234",
    "caption": "Max Thomas"
  }
}

Respuesta

Posibles respuestas:

Código	Descripción
200	OK
202	El registro era un duplicado
422	El parámetro AuditLog es nulo o se ha establecido la firma de la entrada.

Este artículo se ha traducido automáticamente.