Dans cet article, vous apprendrez comment importer des reçus au format PDF dans RetailForce Cloud à l’aide du client fiscal (lorsque vous utilisez la fiscalisation) et obtenir un lien permettant à votre client de télécharger ou d’accéder à ces reçus.

Cette fonctionnalité est disponible à partir de la version 1.2 du client et offre une fonctionnalité hors ligne correspondante pour le reçu numérique.

Pour utiliser cette fonction, la licence « Reçu numérique (produit complet) » doit être activée dans la configuration du client concerné. 

Utilisation via FiscalClient/FiscalService

Lorsque vous utilisez FiscalClient, les deux méthodes suivantes sont disponibles pour le transfert des reçus numériques :

Méthode utilisant le nom de fichier

 /// <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)

Cette fonction permet de charger le reçu numérique à partir d’un fichier stocké sur le disque dur (nom de fichier).

Paramètres

• uniqueClientId : l'ID unique du client fiscal.
• filename : le nom du fichier (chemin d'accès compris) du fichier PDF à télécharger.
• documentGuid : le GUID du document fiscal (Document.DocumentGuid)

Valeur de retour : URL d’affichage.

Méthode de 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)

Cette fonction permet de télécharger le reçu numérique en transférant un flux de fichiers (ou plusieurs flux).

Paramètres

• uniqueClientId : l’ID unique du client fiscal.
• file : le stream contenant le contenu du fichier PDF (le stream doit se trouver au début)
• documentGuid : le GUID du document fiscal (Document.DocumentGuid)

Valeur de retour : URL d'affichage.

Utilisation via l’implémentation NuGet

Lorsque vous utilisez l’implémentation directe de Fiskaclient (TrustedFiscalModule) avec NuGet, une seule méthode utilisant FileStream est disponible :

 /// <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)

Cette fonction permet de télécharger le reçu numérique en transmettant un stream de fichiers (ou plusieurs streams).

Paramètres

• file : le stream contenant le contenu du fichier PDF (le stream doit se trouver au début)
• documentGuid : le GUID du document fiscal (Document.DocumentGuid)

Valeur de retour : URL d'affichage.

Cet article a été traduit automatiquement.