In questo articolo imparerete come chiudere una transazione TSE aperta e come determinare quali transazioni TSE siano ancora aperte sul TSE.

Requisiti

• Cliente fiscale con paese fiscale = Germania

Interrogazione delle transazioni TSE aperte

Richieste al servizio REST

La richiesta al servizio REST viene effettuata tramite l’endpoint:

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

Parametro: clientId = ID del FiscalClient per il quale si desidera interrogare le transazioni TSE.

Valore restituito: elenco delle transazioni TSE aperte sotto forma di valori interi.

Il valore intero rappresenta il FiscalDocumentNo della fiscalResponse originale generata durante l’utilizzo di createDocument.

Richieste sull’interfaccia .NET (nuget)

Prerequisito: il modulo fiscale relativo al client in questione è disponibile come variabile «fiscalModule».

Parametro: clientId = ID del cliente fiscale per il quale si desidera interrogare le transazioni TSE.

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

Valore restituito: elenco delle transazioni TSE aperte sotto forma di valori interi.

Il valore intero rappresenta il FiscalDocumentNo della fiscalResponse originale generata durante l’utilizzo di createDocument.

Chiusura delle transazioni aperte

La chiusura delle transazioni TSE aperte avviene tramite storeDocument (per chiudere un documento completato, come nel processo standard) o mediante il metodo cancelDocument (per annullare una transazione aperta).

La chiusura tramite StoreDocument non è trattata in questo articolo, poiché rientra nel processo standard. 

Se si desidera annullare una transazione di checkout, è necessario utilizzare il metodo CancelDocument. In questo modo si chiude anche la transazione TSE.

L’annullamento delle ricevute tramite CancelDocument è descritto in modo più dettagliato nel seguente articolo:

Implementazione dell’annullamento delle ricevute

Se non sono più disponibili dati relativi a una transazione ancora aperta, è necessario inviare al metodo CancelDocument un documento con il seguente contenuto minimo:

{
  "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,
}

Il ClientId, i valori per DocumentGuid/Id, BookDate/CreateDate e l’User riportati nel blocco di codice sopra riportato sono dati di esempio.

Se il metodo listTransactions restituisce più transazioni, il metodo cancelDocument deve essere invocato più volte.

Questo articolo è stato tradotto automaticamente.