En este artículo aprenderá a implementar correctamente la gestión de errores en España.

Requisitos previos

• FiscalClient a partir de la versión 1.6.5 / España 1.0.5 para las funciones marcadas con *.
• FiscalClient a partir de la versión 1.5.0

Descripción

El sistema español TicketBAI permite enviar los tickets generados de forma síncrona o, en su defecto, de forma asíncrona. Durante el envío pueden producirse errores de validación. 

Con el procesamiento síncrono, estos errores de validación se notifican inmediatamente al sistema TPV. En el caso de una transmisión diferida (el TicketBAI system no estaba disponible en el momento de la creación del recibo), los errores deben leerse desde el sistema fiscal y, en función de la causa del error, el problema debe resolverse en consecuencia.

Procesamiento síncrono

El sistema TicketBAI está disponible y los comprobantes pueden transferirse.

Requisitos previos

• El sistema TicketBAI está disponible
• No existen archivos en cola de transmisión (procedentes de interrupciones previas)

El recibo se transfiere de forma sincrónica al sistema TicketBAI. Si la transferencia del recibo se realiza correctamente y no se producen errores de validación, el resultado se devuelve al sistema TPV con el estado «correcto».

El recibo se almacena en el sistema fiscal y en TicketBAI, y no debe volver a transferirse.

Causas de los errores

El sistema TicketBAI no está disponible

El sistema fiscal almacena el recibo y lo mantiene disponible para la siguiente transmisión, iniciando así el proceso asíncrono.

El recibo se almacena en el sistema fiscal y, posteriormente, se transfiere a TicketBAI. No debe volver a transferirse al sistema fiscal.

Error de validación de TicketBAI

El recibo no se ha persistido en el sistema fiscal y se devuelve un mensaje de error al sistema TPV indicando que el recibo no es válido.

El recibo debe volver a transferirse correctamente al sistema fiscal.

Procesamiento asíncrono

El sistema TicketBAI o la conexión con él no están disponibles.

Requisitos previos

• FiscalClient está disponible y listo para funcionar
• El sistema TicketBAI no está disponible o la conexión con él se ha interrumpido.

Los recibos se transfieren al sistema fiscal, se almacenan y se marcan para su posterior transferencia.

Debido al procesamiento asíncrono, las respuestas de validación no pueden devolverse directamente al sistema de punto de venta (POS). Por lo tanto, es necesario consultar los estados de error de dichos comprobantes.

Todos los recibos transmitidos de forma asíncrona se almacenan en el sistema fiscal y ya no pueden volver a transmitirse a dicho sistema.

Consulta de la información sobre errores y su resolución *

Esta funcionalidad está disponible a partir de la versión 1.6.5 del cliente fiscal.

Las transferencias fallidas pueden consultarse en el sistema fiscal.

Consulta

Existe el siguiente punto final para recuperar los archivos de error:

REST:

GET /api/v1/transactions/errorDocuments/{clientId}

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

El punto final devuelve la información sobre los errores y los GUID (DocumentGuid) de los documentos afectados.

El parámetro «onlyAsync» puede utilizarse para obtener únicamente los errores que se produjeron de forma asíncrona.

Solución

Para resolver el problema, es necesario cancelar el documento en el sistema fiscal; esto se realiza a través del siguiente punto final.

REST:

DELETE /api/v1/transactions/errorDocuments/{clientId}/{documentGuid}

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Con esta llamada, el recibo se anula en el sistema fiscal, pero la anulación no se transmite al TicketBAI system (el recibo aún no existe en el TicketBAI system). Si este recibo se marca como anulado, ya no se mostrará como defectuoso en la consulta anterior.

El documento se anula en el sistema fiscal, ¡no se elimina!

A continuación, el documento puede volver a enviarse al sistema fiscal con una nueva información de cabecera (número de documento, DocumentGuid, etc.) y con los datos corregidos. 

Este artículo ha sido traducido automáticamente.