U ovom članku naučit ćete kako učitati digitalne račune u RetailForce oblak pomoću FiscalClienta (kada se koristi bez fiskalizacije) i dobiti poveznicu za preuzimanje za svog klijenta.

Ova je funkcionalnost dostupna od verzije 1.2 klijenta i pruža odgovarajuću izvanmrežnu mogućnost za digitalni račun.

Kako biste koristili ovu funkciju, u konfiguraciji za odgovarajućeg klijenta mora biti aktivirana licenca za digitalni račun (cjeloviti proizvod).

Korištenje putem FiscalClient/FiscalService

Kod korištenja FiscalClienta, za prijenos digitalnih računa dostupne su sljedeće 2 metode:

Metoda korištenjem naziva datoteke

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

Ova funkcija omogućuje učitavanje digitalne potvrde pomoću datoteke na tvrdom disku (naziv datoteke).

Parametri

• uniqueClientId: jedinstveni ID fiskalnog klijenta.
• nazivdatoteke: naziv datoteke (uključujući putanju) PDF datoteke koja se učitava.
• receiptMetaData: metapodaci za digitalni račun.

Vraćena vrijednost: URL za prikaz.

Metoda streaminga

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

Ova funkcija omogućuje vam učitavanje digitalne računa prijenosom tokova datoteka (ili više tokova).

Parametri

• uniqueClientId: jedinstveni ID fiskalnog klijenta.
• file: stream sadržaja PDF datoteke (stream mora biti na početku)
• receiptMetaData: metapodaci za digitalni račun

Vraćena vrijednost: URL za prikaz.

Upotreba putem nuget implementacije

Kod korištenja izravne implementacije Fiskaclient (TrustedFiscalModule) s nugetom, dostupna je samo jedna metoda s FileStreamom:

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

Pomoću ove funkcije možete prenijeti digitalni račun putem prijenosa stream-a datoteke (ili streamova).

Parametri

• file: stream sadržaja PDF datoteke (stream mora biti na početku)
• receiptMetaData: metapodaci za digitalni račun

Vraćena vrijednost: URL za prikaz.

ReceiptMetaData

Objekt ReceiptMetaData sadrži metapodatke za digitalni račun, što uključuje sljedeće podatke:

• TipDokumenta: tip dokumenta (račun, potvrda o uplati, depozit itd.); za dokumente koji nisu fiskalni dokumenti upotrijebite [1100] Razno nefiskalni
• CustomDocumentType: neobavezni prilagođeni tip dokumenta za digitalni račun (nije tip dokumenta za fiskalizaciju)
• DocumentGuid: DocumentGuid potvrde (ne smije se miješati s DocumentGuid-om sustava za fiskalizaciju). Oblak ga koristi kao identifikaciju potvrde: ponovno učitavanje sa istim DocumentGuid-om zamjenjuje raniju potvrdu. Ako nije postavljeno, potvrda dobiva nasumičnu identifikaciju i ne može se referencirati putem CancelledDocumentGuid-a.
• RetailForceReceiptId: kratki (8-znakovni) jedinstveni ID računa
• Broj dokumenta: broj dokumenta
• ID dokumenta: jedinstvena identifikacija dokumenta
• Datum izdavanja: datum dokumenta
• Iznos: bruto iznos vaučera
• Partner: za prodajni dokument kupac, za ostale dokumente odgovarajući partner (dobavljač, kupac, ...)
• Korisnici: korisnici dokumenta (Id, Caption); koristi se za pretragu "User" u oblaku
• ItemIdArray: brojevi stavki na računu; koristi se za pretraživanje "Item" u oblaku
• Niz kodova stavki: kodovi stavki (npr. EAN) na računu; koristi se za pretraživanje "Stavka" u oblaku
• PaymentCardNumberMaskedArray: maskirani nizovi brojeva kartica za plaćanja (ne smiju se slati jasni brojevi kartica)
• ID procesa: povezuje nekoliko računa; računi s istim ID-om procesa označeni su u oblaku kao povezani računi i mogu se pregledavati zajedno
• CancelledDocumentGuid: za otkazivanje, DocumentGuid otkazanog računa. Oblak zatim označava taj račun kao otkazan.

Opis objekta možete pronaći u dokumentaciji modela objekata dokumenta (Document Object Model). (U odjeljku za preuzimanje izdanja).

Ovaj je članak automatski preveden.