V tem članku boste izvedeli, kako naložiti digitalne račune v RetailForce Cloud s pomočjo FiscalClient (če se uporablja brez fiskalizacije) in pridobiti povezavo za prenos za vašo stranko.
Ta funkcionalnost je na voljo od različice 1.2 odjemalca in omogoča ustrezno delovanje digitalnega računa tudi brez internetne povezave.
Da bi lahko uporabljali to funkcijo, mora biti v nastavitvah zadevnega odjemalca aktivirana licenca za digitalne račune (polna različica).
Uporaba prek FiscalClient/FiscalService
Pri uporabi programa FiscalClient sta za prenos digitalnih računov na voljo naslednji 2 načini:
Metoda z uporabo imena 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)
Ta funkcija vam omogoča naložitev digitalnega računa s pomočjo datoteke na trdem disku (ime datoteke).
Parametri
- uniqueClientId: edinstvena identifikacijska številka fiskalnega stranke.
- filename: ime datoteke (vključno s potjo) PDF-datoteke, ki jo želite naložiti.
- ReceiptMetaData: Metadata za digitalni račun.
Vrnjena vrednost: URL za prikaz.
Metoda pretakanja
/// <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)
Ta funkcija omogoča naložitev digitalnega računa s prenosom datoteke (ali streamov).
Parametri
- uniqueClientId: edinstvena identifikacijska številka davčnega zavezanca.
- file: tok z vsebino datoteke PDF (tok mora biti na začetku)
- ReceiptMetaData: Metadata za digitalni račun
Vrnjena vrednost: URL za prikaz.
Uporaba prek implementacije nuget
Pri neposredni implementaciji Fiskaclient (TrustedFiscalModule) z nugetom je na voljo le ena metoda s 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)
S to funkcijo lahko naložite digitalni račun s prenosom datotečnega toka (ali tokov).
Parametri
- file: tok z vsebino PDF datoteke (tok mora biti na začetku)
- ReceiptMetaData: Metadata za digitalni račun
Vrnjena vrednost: URL za prikaz.
ReceiptMetaData
Objekt ReceiptMetaData vsebuje Metadata za digitalni račun, ki vključujejo naslednje podatke:
- DocumentType: vrsta dokumenta (račun, potrdilo, polog itd.); za dokumente, ki niso davčni dokumenti, uporabite [1100] MiscellaneousNonFiscal
- CustomDocumentType: neobvezna vrsta dokumenta po meri za digitalni račun (ni vrsta davčnega dokumenta)
- DocumentGuid: DocumentGuid potrdila (ne zamenjujte ga z DocumentGuid sistema za fiskalizacijo). Cloud ga uporablja kot identifikator potrdila: ponovno nalaganje z istim DocumentGuidom nadomesti prejšnje potrdilo. Če ni nastavljen, potrdilo dobi naključni identifikator in se nanj ni mogoče sklicevati s CancelledDocumentGuid.
- retailForceReceiptId: kratka (8-znakovna) edinstvena identifikacijska številka potrdila
- DocumentNumber: številka dokumenta
- DocumentId: edinstvena identifikacija dokumenta
- BookDate: datum dokumenta
- Amount: bruto znesek potrdila
- Partner: za prodajni dokument stranka, za druge dokumente ustrezen partner (dobavitelj, stranka, ...)
- Uporabniki: uporabniki dokumenta (ID, caption); uporablja se pri iskanju po »uporabnikih« v Cloud
- ItemIdArray: številke artiklov na računu; uporablja se pri iskanju po »artiklu« v Cloudu
- ItemCodeArray: kode artiklov (npr. EAN) na računu; uporablja se pri iskanju po »artiklu« v Cloudu
- PaymentCardNumberMaskedArray: zamaskirane številke kartic za plačila (jasnih številk kartic se ne sme pošiljati)
- ProcessId: povezuje več računov; računi z istim ProcessId so v Cloud označeni kot povezani računi in jih je mogoče pregledati skupaj
- CancelledDocumentGuid: v primeru preklica DocumentGuid preklicanega računa. Cloud nato ta račun označi kot preklican.
Opis objekta je na voljo v dokumentaciji Document Object Model. (V razdelku za prenose v releasejih).
Ta članek je bil samodejno preveden.
Komentar
0 komentarjev
Za dodajanje komentarja prosimo kliknite Vpis.