V tomto článku sa dozviete, ako nahrať digitálne účtenky do RetailForce Cloud pomocou FiscalClient (ak sa používa bez fiskalizácie) a získať odkaz na stiahnutie pre vášho klienta.
Táto funkcia je k dispozícii od verzie 1.2 klienta a poskytuje zodpovedajúcu offline funkciu pre digitálnu účtenku.
Aby ste mohli túto funkciu používať, musí byť v konfigurácii príslušného klienta aktivovaná licencia „Digitálna účtenka“ (plná verzia).
Použitie prostredníctvom FiscalClient/FiscalService
Pri používaní FiscalClient sú na prenos digitálnych potvrdeniek k dispozícii nasledujúce 2 metódy:
Metóda pomocou názvu súboru
/// <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)
Táto funkcia vám umožňuje nahrať digitálnu účtenku pomocou súboru na pevnom disku (názov súboru).
Parametre
- uniqueClientId: jedinečné ID fiškálneho klienta.
- filename: názov súboru (vrátane cesty) PDF súboru, ktorý sa má nahrať.
- ReceiptMetaData: Metadata digitálnej účtenky.
Vrátená hodnota: URL na zobrazenie.
Metóda streamovania
/// <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)
Táto funkcia umožňuje nahrať digitálnu účtenku prostredníctvom prenosu súborového toku (alebo tokov).
Parametre
- uniqueClientId: jedinečné ID daňového klienta.
- file: stream s obsahom súboru PDF (stream musí byť na začiatku)
- ReceiptMetaData: Metadata digitálnej účtenky
Vrátená hodnota: URL na zobrazenie.
Použitie prostredníctvom implementácie nuget
Pri použití priamej implementácie Fiskaclient (TrustedFiscalModule) s nugetom je k dispozícii iba jedna metóda 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)
Pomocou tejto funkcie môžete nahrať digitálnu účtenku prenosom súborového toku (alebo tokov).
Parametre
- file: stream s obsahom súboru PDF (stream musí byť na začiatku)
- ReceiptMetaData: Metadata digitálnej účtenky
Vrátená hodnota: URL na zobrazenie.
ReceiptMetaData
Objekt ReceiptMetaData obsahuje Metadata pre digitálnu pokladničnú stvrzenku, ktoré zahŕňajú nasledujúce údaje:
- DocumentType: typ dokumentu (faktúra, potvrdenka, vklad atď.); pre dokumenty, ktoré nie sú daňovými dokladmi, použite [1100] MiscellaneousNonFiscal
- CustomDocumentType: voliteľný vlastný typ dokumentu pre digitálnu účtenku (nie je to typ daňového dokumentu)
- DocumentGuid: DocumentGuid potvrdenia (nezamieňať s DocumentGuid systému fiskalizácie). Cloud ho používa ako identifikátor potvrdenia: opätovné nahratie s rovnakým DocumentGuid nahradí predchádzajúce potvrdenie. Ak nie je nastavený, potvrdenie dostane náhodný identifikátor a nemožno naň odkazovať prostredníctvom CancelledDocumentGuid.
- retailForceReceiptId: krátke (8-znakové) jedinečné ID potvrdenia
- DocumentNumber: číslo dokumentu
- DocumentId: jedinečná identifikácia dokumentu
- BookDate: dátum dokumentu
- Amount: hrubá suma dokladu
- Partner: v prípade predajného dokladu ide o zákazníka, v prípade ostatných dokladov o príslušného partnera (dodávateľa, zákazníka, ...)
- Users: používatelia dokumentu (ID, caption); používa sa pri vyhľadávaní „Používateľ“ v Cloude
- ItemIdArray: čísla položiek na účtenke; používa sa pri vyhľadávaní „Položka“ v Cloude
- ItemCodeArray: kódy položiek (napr. EAN) na doklade; používa sa pri vyhľadávaní „Položka“ v Cloude
- PaymentCardNumberMaskedArray: zamaskované čísla kariet platieb (nesmú sa odosielať nezamaskované čísla kariet)
- ProcessId: spája viacero účteniek; účtenky s rovnakým ProcessId sú v Cloudi označené ako prepojené účtenky a je možné ich zobraziť spoločne
- CancelledDocumentGuid: v prípade zrušenia ide o DocumentGuid zrušenej účtenky. Cloud následne označí túto účtenku ako zrušenú.
Popis objektu nájdete v dokumentácii k Document Object Model. (V sekcii na stiahnutie v rámci jednotlivých release).
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.