În acest articol veți afla cum să încărcați chitanțele digitale în RetailForce Cloud folosind FiscalClient (atunci când este utilizat fără fiscalizare) și cum să obțineți un link de descărcare pentru clientul dumneavoastră.

Această funcționalitate este disponibilă începând cu versiunea 1.2 a clientului și oferă o funcționalitate offline corespunzătoare pentru chitanța digitală.

Pentru a utiliza această funcție, licența „Chitanță digitală (produs complet)” trebuie activată în configurația clientului respectiv.

Utilizare prin intermediul FiscalClient/FiscalService

Atunci când utilizați FiscalClient, sunt disponibile următoarele 2 metode pentru transferul chitanțelor digitale:

Metoda folosind numele fișierului

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

Această funcție vă permite să încărcați chitanța digitală folosind un fișier de pe hard disk (numele fișierului).

Parametri

• uniqueClientId: ID-ul unic al clientului fiscal.
• filename: numele fișierului (inclusiv calea) fișierului PDF care urmează să fie încărcat.
• ReceiptMetaData: Metadata pentru chitanța digitală.

Valoare returnată: URL pentru afișare.

Metoda de streaming

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

Această funcție vă permite să încărcați chitanța digitală prin transferul unui stream de fișiere (sau mai multe stream-uri).

Parametri

• uniqueClientId: ID-ul unic al clientului fiscal.
• file: stream-ul cu conținutul fișierului PDF (stream-ul trebuie să se afle la început)
• ReceiptMetaData: Metadata-ul chitanței digitale

Valoare returnată: URL pentru afișare.

Utilizare prin implementarea nuget

Atunci când se utilizează implementarea directă a Fiskaclient (TrustedFiscalModule) cu nuget, este disponibilă o singură metodă cu 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)

Cu această funcție puteți încărca chitanța digitală prin transferul unui stream de fișiere (sau mai multe stream-uri).

Parametri

• file: stream-ul cu conținutul fișierului PDF (stream-ul trebuie să se afle la început)
• ReceiptMetaData: Metadata pentru chitanța digitală

Valoare returnată: URL pentru afișare.

ReceiptMetaData

Obiectul ReceiptMetaData conține metadatele pentru chitanța digitală, inclusiv următoarele date:

• DocumentType: documentType (factură, chitanță, depunere etc.)
• DocumentGuid: DocumentGuid-ul chitanței (a nu se confunda cu DocumentGuid-ul sistemului de fiscalizare)
• BookDate: data documentului
• Amount: suma brută a bonului
• Partner: pentru un document de vânzare, clientul; pentru alte documente, partenerul corespunzător (furnizor, client etc.)

Descrierea obiectului poate fi găsită în documentația Document Object Model. (În secțiunea de descărcări a release-urilor).

Acest articol a fost tradus automat.