Î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ă utilizând 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ă.
Valoarea 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 multor streamuri).
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 pentru chitanța digitală
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ă
Valoarea returnată: URL pentru afișare.
ReceiptMetaData
Obiectul ReceiptMetaData conține metadatele pentru chitanța digitală, inclusiv următoarele date:
- DocumentType: tipul documentului (factură, chitanță, depunere etc.); pentru documentele care nu sunt documente fiscale, se utilizează [1100] MiscellaneousNonFiscal
- CustomDocumentType: un tip de document personalizat opțional pentru chitanța digitală (nu este un tip de document de fiscalizare)
- DocumentGuid: DocumentGuid-ul chitanței (nu trebuie confundat cu DocumentGuid-ul sistemului de fiscalizare). Cloud-ul îl utilizează ca identitate a chitanței: încărcarea din nou cu același DocumentGuid înlocuiește chitanța anterioară. Dacă nu este setat, chitanța primește o identitate aleatorie și nu poate fi referențiată prin CancelledDocumentGuid.
- retailForceReceiptId: ID-ul unic scurt (8 caractere) al chitanței
- DocumentNumber: numărul documentului
- DocumentId: identificatorul unic al documentului
- 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.)
- Utilizatori: utilizatorii documentului (ID, caption); folosiți de căutarea „Utilizator” în Cloud
- ItemIdArray: numerele articolelor de pe chitanță; utilizate de căutarea „Articol” în Cloud
- ItemCodeArray: codurile articolelor (de ex. EAN) de pe bon; utilizate de funcția de căutare „Articol” în Cloud
- PaymentCardNumberMaskedArray: numerele de card mascate ale plăților (nu trebuie trimise numerele de card în format clar)
- ProcessId: leagă mai multe chitanțe; chitanțele cu același ProcessId sunt marcate în Cloud ca fiind chitanțe legate și pot fi vizualizate împreună
- CancelledDocumentGuid: în cazul unei anulări, DocumentGuid-ul bonului anulat. Cloud-ul marchează apoi acel bon ca fiind anulat.
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.
Comentarii
0 comentarii
Vă rugăm să vă autentificați pentru a lăsa un comentariu.