V tomto článku se dozvíte, jak nahrát digitální účtenky do Cloudu RetailForce pomocí FiscalClient (při použití bez fiskalizace) a získat odkaz ke stažení pro svého klienta.

Tato funkce je k dispozici od verze 1.2 klienta a poskytuje odpovídající offline podporu pro digitální účtenky.

Abyste mohli tuto funkci používat, musí být v konfiguraci příslušného klienta aktivována licence „Digitální účtenka“ (plná verze).

Použití prostřednictvím FiscalClient/FiscalService

Při použití FiscalClient jsou k dispozici následující 2 metody pro přenos digitálních účtenek:

Metoda pomocí názvu souboru

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

Tato funkce umožňuje nahrát digitální účtenku pomocí souboru na pevném disku (název souboru).

Parametry

• uniqueClientId: jedinečné ID fiskálního klienta.
• filename: název souboru (včetně cesty) PDF souboru, který má být nahrán.
• receiptMetaData: Metadata digitální účtenky.

Návratová hodnota: URL pro zobrazení.

Metoda streamování

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

Tato funkce umožňuje nahrát digitální účtenku přenosem datového proudu (nebo datových proudů).

Parametry

• uniqueClientId: jedinečné ID daňového klienta.
• file: datový proud s obsahem souboru PDF (datový proud musí být na začátku)
• receiptMetaData: Metadata digitální účtenky

Návratová hodnota: URL pro zobrazení.

Použití prostřednictvím implementace nuget

Při použití přímé implementace Fiskaclient (TrustedFiscalModule) s NuGetem je k dispozici pouze jedna 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)

Pomocí této funkce můžete nahrát digitální účtenku přenosem datového proudu (nebo datových proudů).

Parametry

• file: proud s obsahem souboru PDF (proud musí být na začátku)
• receiptMetaData: Metadata digitální účtenky

Návratová hodnota: URL pro zobrazení.

ReceiptMetaData

Objekt ReceiptMetaData obsahuje Metadata pro digitální účtenku, která zahrnují následující údaje:

• DocumentType: typ dokumentu (faktura, účtenka, vklad atd.); u dokumentů, které nejsou daňovými doklady, použijte [1100] MiscellaneousNonFiscal
• CustomDocumentType: volitelný vlastní typ dokumentu pro digitální účtenku (nejedná se o typ fiskálního dokumentu)
• DocumentGuid: DocumentGuid účtenky (nezaměňovat s DocumentGuid fiskalizačního systému). Cloud jej používá jako identifikátor účtenky: opětovné nahrání se stejným DocumentGuid nahradí předchozí účtenku. Pokud není nastaven, účtenka dostane náhodný identifikátor a nelze na ni odkazovat pomocí CancelledDocumentGuid.
• RetailForceReceiptId: krátké (8znakové) jedinečné ID účtenky
• DocumentNumber: číslo dokumentu
• DocumentId: jedinečná identifikace dokumentu
• BookDate: datum dokladu
• Amount: hrubá částka dokladu
• Partner: u prodejního dokladu zákazník, u ostatních dokladů příslušný partner (dodavatel, zákazník, ...)
• Users: uživatelé dokladu (Id, Caption); používá se při vyhledávání podle „uživatele“ v Cloudu
• ItemIdArray: čísla položek na účtence; používá se při vyhledávání „Položka“ v Cloudu
• ItemCodeArray: kódy položek (např. EAN) na účtence; používá se při vyhledávání „Položka“ v Cloudu
• PaymentCardNumberMaskedArray: zamaskovaná čísla karet použitých k platbám (nesmí být odesílána nezaskrytá čísla karet)
• ProcessId: propojuje několik účtenek; účtenky se stejným ProcessId jsou v Cloudu označeny jako propojené účtenky a lze je prohlížet společně
• CancelledDocumentGuid: v případě zrušení se jedná o DocumentGuid zrušeného dokladu. Cloud poté tento doklad označí jako zrušený.

Popis objektu naleznete v dokumentaci k Document Object Model. (V sekci ke stažení jednotlivých verzí).

Tento článek byl přeložen automaticky.