Šiame straipsnyje sužinosite, kaip naudodami „FiskalClient“ (jei naudojate be fiskalinės funkcijos) įkelti skaitmeninius kvitus į „RetailForce Cloud“ ir gauti nuorodą, kurią galėsite pateikti savo klientams atsisiuntimui. 

Ši funkcija yra prieinama nuo 1.2 kliento versijos ir suteikia atitinkamą skaitmeninio kvito naudojimo neprisijungus galimybę.

Norint naudotis šia funkcija, atitinkamo kliento konfigūracijoje turi būti aktyvuota licencija „Digital Receipt (full product)“.

Naudojimas naudojant „FiscalClient“ / „FiscalService“

Naudojant „FiscalClient“, galite rinktis iš šių 2 skaitmeninių kvitų perdavimo metodų:

Metodas su failo pavadinimu

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

Naudodami šią funkciją, galite įkelti skaitmeninį dokumentą pagal failą kietajame diske (failo pavadinimas).

Parametrai

• uniqueClientId: FiscalClient identifikatorius.
• filename: failo pavadinimas (įskaitant kelią) į PDF failą, kurį norite įkelti.
• receiptMetaData: skaitmeninio kvito metaduomenys.

Grąžinimas: URL rodymui.

Metodas su srautu

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

Naudodami šią funkciją galite įkelti skaitmeninį kvitą perduodami failų srautą (arba srautus).

Parametrai

• uniqueClientId: fiskalinio kliento ID.
• file: srautas su PDF failo turiniu (srautas turi būti pradžioje)
• receiptMetaData: skaitmeninio kvito metaduomenys

Grąžinimas: URL rodymui.

Naudojimas naudojant „nuget“ įgyvendinimą

Naudojant tiesioginį fiskalinio kliento (TrustedFiscalModule) įgyvendinimą su „NuGet“, yra prieinamas tik vienas metodas su „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)

Naudodami šią funkciją, galite įkelti skaitmeninį kvitą perduodami failų srautą (arba srautą).

Parametrai

• file: srautas su PDF failo turiniu (srautas turi būti pradžioje)
• receiptMetaData: skaitmeninio kvito metaduomenys

Grąžinimas: URL rodymui.

ReceiptMetaData

Objektas ReceiptMetaData apima skaitmeninio kvito metaduomenis, kurie apima šiuos duomenis:

• DocumentType: dokumento tipas (sąskaita, kvitas, įmoka ir pan.)
• DocumentGuid: kvito DocumentGuid (palyginkite su fiskalinės sistemos DocumentGuid)
• BookDate: kvito data
• Amount: kvito bruto suma
• Partner: pardavimo kvito atveju – klientas, kitų kvitų atveju – atitinkamas partneris (tiekėjas, klientas ir pan.)

Objekto aprašymą rasite Document Object Model dokumentacijoje. (Išleidimų skyriuje „Atsisiuntimai“).