In questo articolo imparerete come caricare le ricevute in formato PDF su RetailForce Cloud utilizzando il client fiscale (in caso di utilizzo della fiscalizzazione) e ottenere un link che consenta al vostro cliente di scaricare o accedere alle ricevute.

Questa funzionalità è disponibile a partire dalla versione 1.2 del client e offre una corrispondente funzionalità offline per la ricevuta digitale.

Per poter utilizzare questa funzione, è necessario che la licenza "Scontrino digitale (prodotto completo)" sia attivata nella configurazione del rispettivo client. 

Utilizzo tramite FiscalClient/FiscalService

Quando si utilizza FiscalClient, sono disponibili i seguenti 2 metodi per il trasferimento delle ricevute digitali:

Metodo tramite nome file

 /// <summary>
/// Uploads digital receipt with digital receipt metadata.
/// </summary>
/// <param name="uniqueClientId">The client id of the client where the digital receipt should be uploaded.</param>
/// <param name="filename">The name of the file to be uploaded. The file must exist and must be readable.</param>
/// <param name="documentGuid">The document guid of the document to get the receipt meta data. Document must be transferred before to fiscalisation.</param>
/// <returns>A unique url to download the file for the customer.</returns>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="uniqueClientId"/> is set to <see cref="Guid.Empty"/>.</exception>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="filename"/> is null or <see cref="string.Empty"/>.</exception>
/// <exception cref="FileNotFoundException">Thrown if given filename is not found.</exception>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="documentGuid"/> is set to <see cref="Guid.Empty"/>.</exception>
/// <exception cref="UnauthorizedAccessException"><paramref name="filename" /> specified a directory.-or- The caller does not have the required permission. </exception>
/// <exception cref="IOException">An I/O error occurred while opening the file. </exception>
public string UploadDigitalReceipt(Guid uniqueClientId, string filename, Guid documentGuid)

Questa funzione consente di caricare la ricevuta digitale utilizzando un file presente sul disco rigido (nome del file).

Parametri

• uniqueClientId: l’ID univoco del cliente fiscale.
• filename: il nome del file (compreso il percorso) del file PDF da caricare.
• documentGuid: il GUID del documento fiscale (Document.DocumentGuid)

Valore restituito: URL per la visualizzazione.

Metodo di streaming

/// <summary>
/// Uploads digital receipt with digital receipt metadata.
/// </summary>
/// <param name="uniqueClientId">The client id of the client where the digital receipt should be uploaded.</param>
/// <param name="file">The stream of the file to be uploaded.</param>
/// <param name="documentGuid">The document guid of the document to get the receipt meta data. Document must be transferred before to fiscalisation.</param>
/// <returns>A unique url to download the file for the customer.</returns>
/// <remarks>You can only use documents from the actual day.</remarks>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="uniqueClientId"/> is set to <see cref="Guid.Empty"/>.</exception>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="file"/> is set to null.</exception>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="documentGuid"/> is set to <see cref="Guid.Empty"/>.</exception>
public string UploadDigitalReceipt(Guid uniqueClientId, Stream file, Guid documentGuid)

Con questa funzione è possibile caricare la ricevuta digitale trasferendo uno o più streams di file.

Parametri

• uniqueClientId: l’ID univoco del cliente fiscale.
• file: lo stream contenente il contenuto del file PDF (lo stream deve trovarsi all’inizio)
• documentGuid: il GUID del documento fiscale (Document.DocumentGuid)

Valore restituito: URL per la visualizzazione.

Utilizzo tramite implementazione NuGet

Quando si utilizza l’implementazione diretta di Fiskaclient (TrustedFiscalModule) tramite NuGet, è disponibile un solo metodo con FileStream:

 /// <summary>
/// Upload digital receipt (if proper license exists). Only in combination with fiscalisation.
/// </summary>
/// <param name="file">The file to upload.</param>
/// <param name="documentGuid">The document guid of the document to get the receipt meta data. Document must be transferred before to fiscalisation.</param>
/// <returns>An url to request the file in the cloud.</returns>
/// <remarks>You can only use documents from the actual day.</remarks>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="file"/> is set to null.</exception>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="documentGuid"/> is set to <see cref="Guid.Empty"/>.</exception>
/// <exception cref="KeyNotFoundException">Thrown if the given documentGuid does not found a document in the document store.</exception>
public string UploadDigitalReceipt(Stream file, Guid documentGuid)

Tale funzione consente di caricare la ricevuta digitale trasferendo uno o più stream di file.

Parametri

• file: lo stream contenente il contenuto del file PDF (lo stream deve trovarsi all’inizio)
• documentGuid: il GUID del documento fiscale (Document.DocumentGuid)

Valore restituito: URL per la visualizzazione.

Questo articolo è stato tradotto automaticamente.