Neste artigo, irá aprender a implementar corretamente o tratamento de erros em Espanha.

Pré-requisitos

• FiscalClient a partir da versão 1.6.5 / Espanha 1.0.5 para as funcionalidades assinaladas com *.
• FiscalClient a partir da versão 1.5.0

Descrição

The Spanish TicketBAI system offers the possibility to send the generated receipts immediately, but also later. When sending the receipts, validation errors may occur. 

Com o processamento síncrono, estes erros de validação são imediatamente comunicados ao sistema POS. No caso de transmissão diferida (o TicketBAI system não estava disponível no momento da criação do recibo), os erros devem ser lidos a partir do sistema fiscal e, dependendo da causa do erro, o problema deve ser resolvido em conformidade.

Processamento síncrono

The TicketBAI system is available and receipts can be transferred.

Pré-requisitos

• The TicketBAI system is available
• Não existem ficheiros para transmissão (de interrupções anteriores)

O recibo é transferido de forma síncrona para o TicketBAI system. Se o recibo for transferido com sucesso e não houver erros de validação, o resultado é devolvido ao sistema POS com o estado «bem-sucedido».

O recibo é armazenado no sistema fiscal e no TicketBAI e não deve ser transferido novamente.

Causas dos erros

The TicketBAI system is now not available

O recibo é guardado pelo sistema fiscal e disponibilizado para a próxima transmissão. Isto dá início ao processo assíncrono.

O recibo é armazenado no sistema fiscal e é posteriormente transferido para o TicketBAI. Não deve ser transferido novamente para o sistema fiscal.

Erro de validação do TicketBAI

O recibo não é guardado no sistema fiscal e é devolvida uma mensagem de erro ao sistema POS indicando que o recibo é inválido.

O recibo deve ser novamente transferido para o sistema fiscal de forma correta.

Processamento assíncrono

The TicketBAI system or the connection to it are not available.

Pré-requisitos

• O FiscalClient está disponível e pronto a funcionar
• The TicketBAI system is not available or the connection to the TicketBAI system has been interrupted.

Os recibos são transferidos para o sistema fiscal, armazenados e marcados para transferência posterior.

Devido ao processamento assíncrono, os erros de validação não podem ser devolvidos diretamente ao sistema de PDV. Por conseguinte, os estados de erro relativos a estes recibos devem ser consultados.

Todos os recibos transmitidos de forma assíncrona são armazenados no sistema fiscal e já não podem ser transmitidos para o sistema fiscal.

Consultar informações sobre erros e resolução *

Esta função está disponível a partir da versão 1.6.5 do client fiscal.

As transferências com falha podem ser consultadas no sistema fiscal.

Consulta

Existe o seguinte ponto de extremidade para recuperar os ficheiros de erro:

REST:

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

nuget:

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

O ponto de extremidade devolve as informações de erro e os GUIDs (DocumentGuid) dos documentos afetados.

O parâmetro «onlyAsync» pode ser utilizado para obter apenas os erros que ocorreram de forma assíncrona.

Solução

Para resolver o problema, o documento deve ser cancelado no sistema fiscal, o que é feito através do seguinte ponto de extremidade.

REST:

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

nuget:

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Com esta chamada, o recibo é cancelado no sistema fiscal, mas o cancelamento não é encaminhado para o TicketBAI system (o recibo ainda não existe no TicketBAI system). Se este recibo for marcado como cancelado, deixará de ser devolvido como defeituoso através da consulta acima.

O documento é cancelado no sistema fiscal — não é eliminado!

O documento pode agora ser transferido novamente com novas informações de header (número do documento, DocumentGuid, etc.) para o sistema fiscal com os dados corrigidos. 

Este artigo foi traduzido automaticamente.