In questo articolo imparerete come caricare le ricevute digitali sul RetailForce Cloud utilizzando FiscalClient (se utilizzato senza fiscalizzazione) e ottenere un link per il download destinato al vostro client.

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 del 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="receiptMetaData">The metadata of the file.</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="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, ReceiptMetaData receiptMetaData)

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.
• ReceiptMetaData: i metadati associati alla ricevuta digitale.

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="receiptMetaData">The metadata of the file.</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="file"/> is set to null.</exception>
public string UploadDigitalReceipt(Guid uniqueClientId, Stream file, ReceiptMetaData receiptMetaData)

Questa funzione consente di caricare la ricevuta digitale tramite il trasferimento di uno o più flussi di dati (filestream).

Parametri

• uniqueClientId: l’ID univoco del cliente fiscale.
• file: lo stream contenente il contenuto del file PDF (lo stream deve trovarsi all’inizio)
• ReceiptMetaData: i metadati associati alla ricevuta digitale

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>
/// Uploads digital receipt (if proper license exists).
/// </summary>
/// <param name="receiptMetaData">The metadata for the receipt.</param>
/// <param name="file">The pdf file as stream.</param>
/// <returns>An url to request the file in the cloud.</returns>
/// <remarks>If <paramref name="receiptMetaData"/> is set to null, only bookDate is set to Now, other values are not set.</remarks>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="file"/> is set to null.</exception>
public string UploadDigitalReceipt(Stream file, ReceiptMetaData receiptMetaData)

Tale metodo 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)
• ReceiptMetaData: i metadati relativi alla ricevuta digitale

Valore restituito: URL per la visualizzazione.

ReceiptMetaData

L’oggetto ReceiptMetaData contiene i metadati relativi alla ricevuta digitale, che includono i seguenti dati:

• DocumentType: il tipo di documento (fattura, ricevuta, versamento, ecc.)
• DocumentGuid: l’identificativo univoco della ricevuta (da non confondere con il DocumentGuid del sistema di fiscalizzazione)
• BookDate: la data del documento
• Amount: l’importo lordo del documento
• Partner: per un documento di vendita, il cliente; per gli altri documenti, il partner corrispondente (fornitore, cliente, ...)

La descrizione dell’oggetto è disponibile nella documentazione relativa al Document Object Model (nella sezione «Download» delle release).

Questo articolo è stato tradotto automaticamente.