Neste artigo, irá aprender a encerrar uma transação TSE em aberto e a determinar quais as transações TSE que ainda se encontram em aberto no TSE.

Requisitos

• Fiscal client with fiscal country = Germany

Consulta de transações TSE em aberto

Consultas no serviço REST

O pedido no serviço REST é efetuado através do ponto de extremidade:

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

Parâmetro: clientId = ID do FiscalClient cujas transações TSE pretendem ser consultadas.

Valor devolvido: Lista de transações TSE em aberto, expressas como valores inteiros.

O valor inteiro representa o FiscalDocumentNo da fiscalResponse original gerada ao utilizar o createDocument.

Consultas na interface .NET (nuget)

Pré-requisito: O módulo fiscal para o respetivo client está disponível como variável «fiscalModule».

Parâmetro: clientId = ID do cliente fiscal em que as transações TSE devem ser consultadas.

if (fiscalModule.ModulImplementation is TrustedFiscalModuleGermany)
{
  fiscalModuleGermany = (TrustedFiscalModuleGermany)fiscalModule.ModulImplementation;
  var resultList = fiscalModuleGermany.Tse.ListStartedTransactions(clientId);
}

Valor devolvido: Lista de transações TSE em aberto, expressas como valores inteiros.

O valor inteiro representa o FiscalDocumentNo da fiscalResponse original gerada ao utilizar o createDocument.

Encerramento de transações em aberto

O encerramento de transações TSE em aberto é efetuado através do método storeDocument (para encerrar um documento concluído, tal como no processo normal) ou do método cancelDocument (para cancelar uma transação em aberto).

O encerramento através do storeDocument não é abordado neste artigo, uma vez que faz parte do processo padrão. 

Se for necessário cancelar uma transação de checkout, tal deve ser feito utilizando o método cancelDocument. Isto também encerra a transação TSE.

O cancelamento de recibos através do cancelDocument é descrito com mais pormenor no artigo seguinte:

Implementação do cancelamento de recibos

Se já não existirem quaisquer dados relativos a uma transação que ainda se encontre em aberto, deve ser enviado ao método cancelDocument um documento com o seguinte conteúdo mínimo:

{
  "UniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
  "DocumentGuid": "5c374337-e093-4fb5-abf4-d1c48f0428b4",
  "DocumentId": "5c374337-e093-4fb5-abf4-d1c48f0428b4",
  "CreateDate": "2021-03-29T06:38:26.1392038+02:00",
  "BookDate": "2021-03-29T06:38:26.1392038+02:00",
  "IsTraining": false,
  "DocumentType": 0,
  "User": 
  {
    "Id": "123",
    "Caption": "TestUser"
  },
  "FiscalDocumentNumber": {Rückgabe von ListStartedTransactions},
  "FiscalDocumentRevision": 0,
}

O clientId, os valores para DocumentGuid/ID, BookDate/CreateDate, bem como o User no bloco de código acima, são dados de exemplo.

Se o método listTransactions devolver vários números, o método cancelDocument deve ser chamado várias vezes.

Este artigo foi traduzido automaticamente.