În acest articol veți afla cum să încărcați chitanțele în format PDF în RetailForce Cloud folosind clientul fiscal (atunci când utilizați funcția de fiscalizare) și cum să obțineți un link pe care clientul dvs. îl poate folosi pentru a descărca/accesa chitanțele.

Această funcționalitate este disponibilă începând cu versiunea 1.2 a clientului și oferă o funcționalitate offline corespunzătoare pentru chitanța digitală.

Pentru a utiliza această funcție, licența „Chitanță digitală (produs complet)” trebuie activată în configurația clientului respectiv. 

Utilizare prin intermediul FiscalClient/FiscalService

Atunci când se utilizează FiscalClient, sunt disponibile următoarele 2 metode pentru transferul chitanțelor digitale:

Metoda care utilizează numele fișierului

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

Această funcție vă permite să încărcați chitanța digitală utilizând un fișier de pe hard disk (numele fișierului).

Parametri

• uniqueClientId: ID-ul unic al clientului fiscal.
• filename: numele fișierului (inclusiv calea) al fișierului PDF care urmează să fie încărcat.
• documentGuid: GUID-ul documentului fiscal (Document.DocumentGuid)

Valoarea returnată: URL pentru afișare.

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

Cu această funcție puteți încărca chitanța digitală prin transferul unui stream de fișiere (sau mai multe stream-uri).

Parametri

• uniqueClientId: ID-ul unic al clientului fiscal.
• file: stream-ul cu conținutul fișierului PDF (stream-ul trebuie să se afle la început)
• documentGuid: GUID-ul documentului fiscal (Document.DocumentGuid)

Valoare returnată: URL pentru afișare.

Utilizare prin implementarea nuget

Atunci când se utilizează implementarea directă a Fiskaclient (TrustedFiscalModule) cu nuget, este disponibilă o singură metodă cu 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)

Cu această funcție puteți încărca chitanța digitală prin transferul unui stream de fișiere (sau mai multe stream-uri).

Parametri

• file: stream-ul cu conținutul fișierului PDF (stream-ul trebuie să se afle la început)
• documentGuid: GUID-ul documentului fiscal (Document.DocumentGuid)

Valoare returnată: URL pentru afișare.

Acest articol a fost tradus automat.