W niniejszym artykule dowiedzą się Państwo, jak przesłać paragony w formacie PDF do RetailForce Cloud za pomocą klienta fiskalnego (w przypadku korzystania z funkcji fiskalizacji) oraz jak uzyskać link, za pomocą którego Państwa klient będzie mógł pobrać paragony lub uzyskać do nich dostęp.

Funkcja ta jest dostępna od wersji 1.2 klienta i zapewnia odpowiednią obsługę trybu offline dla paragonów cyfrowych.

Aby skorzystać z tej funkcji, w konfiguracji danego klienta musi być aktywowana licencja na „Paragon cyfrowy” (pełna wersja). 

Korzystanie za pomocą FiscalClient/FiscalService

W przypadku korzystania z FiscalClient do przesyłania cyfrowych paragonów dostępne są następujące 2 metody:

Metoda z wykorzystaniem nazwy pliku

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

Funkcja ta umożliwia przesłanie cyfrowego paragonu za pomocą pliku znajdującego się na dysku twardym (nazwa pliku).

Parametry

• uniqueClientId: unikalny ID klienta fiskalnego.
• filename: nazwa pliku (wraz ze ścieżką) pliku PDF, który ma zostać przesłany.
• documentGuid: identyfikator GUID dokumentu fiskalnego (Document.DocumentGuid)

Wartość zwracana: adres URL do wyświetlenia.

Metoda streamu

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

Za pomocą tej funkcji można przesłać cyfrowy paragon poprzez przekazanie strumienia plików (lub strumieni).

Parametry

• uniqueClientId: unikalny ID klienta fiskalnego.
• file: stream zawierający zawartość pliku PDF (stream musi znajdować się na początku)
• documentGuid: identyfikator GUID dokumentu fiskalnego (Document.DocumentGuid)

Wartość zwracana: adres URL do wyświetlenia.

Sposób użycia poprzez implementację z wykorzystaniem nuget

W przypadku korzystania z bezpośredniej implementacji Fiskaclient (TrustedFiscalModule) za pośrednictwem nuget dostępna jest tylko jedna metoda wykorzystująca 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)

Za pomocą tej funkcji można przesłać cyfrowy paragon poprzez przekazanie strumienia pliku (lub strumieni).

Parametry

• file: stream zawierający zawartość pliku PDF (stream musi znajdować się na początku)
• documentGuid: identyfikator GUID dokumentu fiskalnego (Document.DocumentGuid)

Wartość zwracana: adres URL do wyświetlenia.

Ten artykuł został przetłumaczony automatycznie.