ELIMINAR /api/v1/management/germany/ {clientId}/TSE/listTransactions – RetailForce

DELETE /api/v1/management/germany/{clientId}/TSE/listTransactions

permite cerrar las transacciones TSE pendientes.

Por regla general, no se deben dejar transacciones abiertas. Recomendamos cerrar todas las transacciones pendientes antes del cierre diario mediante

POST /api/v1/transactions/storeDocument —si se ha producido una venta— o
POST /api/v1/transactions/cancelDocument —si no se ha producido ninguna venta—.

Atención: tenga en cuenta que las cancelaciones de documentos también se registran (y deben registrarse) en el TSE. Por lo tanto, también es necesario finalizar cada transacción iniciada con PUT /api/v1/transactions/createDocument mediante «storeDocument » o «cancelDocument ». En caso de cancelaciones frecuentes de documentos, no podemos descartar la posibilidad de que las autoridades fiscales planteen preguntas sobre los motivos de dichas cancelaciones en el transcurso de una inspección de caja registradora .

Resultado

Las transacciones abiertas en el TSE se cierran de forma colectiva mediante POST /api/v1/transactions/cancelDocument, sin necesidad de cerrarlas individualmente.

Uso

Recomendamos utilizar este punto final con precaución y únicamente en caso de error.

La llamada genera en primer lugar una consulta al TSE para determinar qué transacciones están abiertas. Los distintos tipos de TSE (Cloud TSE, hardware TSE) no devuelven una lista completa de las transacciones abiertas, sino solo «paquete por paquete»:

SWISSBIT HARDWARE TSE: 8 transacciones por paquete,
fiskal Cloud TSE: 100 transacciones cada una

Una vez que el TSE ha devuelto el paquete de transacciones abiertas, dichas transacciones se cierran mediante un documento vacío con la siguiente información:

DocumentId: Guid generado por el servicio
DocumentNr: GUID generado por el servicio
DocumentGuid: GUID generado por el servicio
DocumentType: Recibo
documentTypeCaption: CancelTransaction

Si existen más transacciones abiertas que las indicadas anteriormente, deberá invocarse el punto final más de una vez.

Todas las transacciones cerradas también se persisten correctamente en los datos DSFinV-K.

Requisitos previos

Existen transacciones abiertas (iniciadas), es decir, no cerradas, en la TSE.

Si se alcanza el límite de transacciones abiertas configurado en la TSE, no será posible iniciar nuevas transacciones y el dispositivo devolverá un código de error. Para más detalles, consulte el artículo «Error de conexión con la TSE».

Puede consultar el número de transacciones abiertas mediante el punto final:

GET /api/v1/management/germany/{clientId}/TSE/listTransactions

Ejemplo:

El TSE devuelve el número de transacciones iniciadas en el campo «startedTransactions».

{
   ...
   "startedTransactions": 512,
   "maxStartedTransactions": 512,
   ...
}

Nota: esta funcionalidad solo es aplicable a TSE de hardware. El límite de transacciones abiertas simultáneas en el Fiskaly Cloud TSE es de 2.000.

Campos del formulario

Se debe transmitir la siguiente información:

Denominación	Descripción	Ejemplo
clientId	El «uniqueClientId» de la caja registradora (del RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Respuestas

Posibles respuestas:

Código	Descripción	Ejemplo
200	fiscalResponse: las transacciones pendientes se han cerrado correctamente (cancelDocument)	-
400	«TSE no conectado»: no hay ningún TSE conectado al sistema ni asignado al cliente correspondiente. Resolución de problemas: Verifique si la TSE está conectada al sistema , por ejemplo, mediante una solicitud GET a /api/v1/management/germany/tse	-
404	«No se ha encontrado el cliente»: no existe ninguna configuración en este sistema con el clientId especificado Solución de problemas: Compruebe el «clientId» especificado Verifique que el clientId especificado esté configurado en el middleware (en el archivo fiscalService.config.json, ubicado en C:\Archivos de programa\RetailForce\Fiscal Webservice\Config).	-
422	«El clientId se ha establecido en Guid.Empty» Solución de problemas:	-
500	«Error interno del servidor» – Otro error. Solución de problemas: repita la llamada, reinicie el servicio si es necesario, ejecute CloudConnect.	-

Atención: Independientemente de cómo se haya resuelto el error, le recomendamos que analice detenidamente el motivo por el que las transacciones TSE permanecen abiertas. En el proceso habitual de cierre de caja, todas las transacciones abiertas deben cerrarse antes del cierre diario.

Este artículo ha sido traducido automáticamente.

Resultado

Uso

Requisitos previos

Campos del formulario

Respuestas

Artículos relacionados