V tomto článku se dozvíte, jak nahrát účtenky ve formátu PDF do RetailForce Cloud pomocí fiskálního klienta (při použití fiskalizace) a získat odkaz, pomocí kterého si váš zákazník může účtenky stáhnout nebo k nim získat přístup.

Tato funkce je k dispozici od verze 1.2 klienta a poskytuje odpovídající offline podporu pro digitální účtenky.

Aby bylo možné tuto funkci používat, musí být v konfiguraci příslušného klienta aktivována licence „Digitální účtenka“ (plná verze). 

Použití prostřednictvím FiscalClient/FiscalService

Při použití FiscalClient jsou pro přenos digitálních účtenek k dispozici následující 2 metody:

Metoda s použitím názvu souboru

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

Tato funkce umožňuje nahrát digitální účtenku pomocí souboru na pevném disku (název souboru).

Parametry

• uniqueClientId: jedinečné ID fiskálního klienta.
• filename: název souboru (včetně cesty) souboru PDF, který má být nahrán.
• documentGuid: GUID daňového dokladu (Document.DocumentGuid)

Vrácená hodnota: URL pro zobrazení.

Metoda streamování

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

Pomocí této funkce můžete nahrát digitální účtenku přenosem datového proudu (nebo datových proudů).

Parametry

• uniqueClientId: jedinečné ID daňového klienta.
• file: datový proud s obsahem souboru PDF (datový proud musí být na začátku)
• documentGuid: identifikátor fiskálního dokladu (Document.DocumentGuid)

Návratová hodnota: URL pro zobrazení.

Použití prostřednictvím implementace NuGet

Při použití přímé implementace Fiskaclient (TrustedFiscalModule) s NuGetem je k dispozici pouze jedna metoda s 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)

Pomocí této funkce můžete nahrát digitální účtenku přenosem datového proudu (nebo datových proudů).

Parametry

• file: proud s obsahem souboru PDF (proud musí být na začátku)
• documentGuid: GUID daňového dokladu (Document.DocumentGuid)

Návratová hodnota: URL pro zobrazení.

Tento článek byl přeložen automaticky.