Šiame straipsnyje sužinosite, kaip įkelti skaitmeninius kvitus į „RetailForce Cloud“ naudodami „FiscalClient“ (kai naudojama be fiskalizacijos) ir gauti nuorodą, kurią galėsite atsisiųsti savo klientui.

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

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

Naudojimas naudojant „FiscalClient“ / „FiscalService“

Naudojant „FiscalClient“, skaitmeninius kvitus galima perduoti dviem būdais:

Būdas naudojant failo pavadinimą

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

Ši funkcija leidžia įkelti skaitmeninį kvitą naudojant kietajame diske esantį failą (failo pavadinimą).

Parametrai

• uniqueClientId: fiskalinio kliento unikalus ID.
• filename: įkeltino PDF failo pavadinimas (įskaitant kelią).
• ReceiptMetaData: skaitmeninio kvito Metadata.

Grąžinamoji reikšmė: URL rodymui.

Srautinio perdavimo metodas

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

Ši funkcija leidžia įkelti skaitmeninį kvitą perduodant failų srautą (arba srautus).

Parametrai

• uniqueClientId: fiskalinio kliento unikalus ID.
• file: stream su PDF failo turiniu (stream turi būti pradžioje)
• ReceiptMetaData: skaitmeninio kvito Metadata

Grąžinamoji reikšmė: URL, skirtas rodymui.

Naudojimas per „nuget“ įgyvendinimą

Naudojant tiesioginę „Fiskaclient“ (TrustedFiscalModule) įgyvendinimą su „nuget“, 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 srautus).

Parametrai

• file: stream su PDF failo turiniu (stream turi būti pradžioje)
• „ReceiptMetaData“: skaitmeninio kvito Metadata

Grąžinamoji reikšmė: URL, skirtas rodymui.

ReceiptMetaData

Objektas „ReceiptMetaData“ apima skaitmeninio kvito Metadata, įskaitant šiuos duomenis:

• „documentType“: dokumento tipas (sąskaita faktūra, kvitas, įmoka ir pan.)
• „DocumentGuid“: kvito „DocumentGuid“ (nereikia painioti su fiskalizacijos sistemos „DocumentGuid“)
• „BookDate“: dokumento data
• Amount: kvito bruto suma
• „Partner“: pardavimo dokumento atveju – klientas, kitų dokumentų atveju – atitinkamas partneris (tiekėjas, klientas ir pan.)

Objekto aprašymą galima rasti „Document Object Model“ dokumentacijoje (release skyriuje „Atsisiuntimai“).

Šis straipsnis buvo išverstas automatiškai.