У овом чланку ћете научити како да отпремате дигиталне потврде у RetailForce облак користећи FiscalClient (када се користи без фискализације) и добијете линк за преузимање за свог клијента.

Ова функционалност је доступна од верзије 1.2 клијента и пружа одговарајућу офлајн могућност за дигитални рачун.

Да бисте користили ову функцију, лиценца за дигитални рачун (цео производ) мора бити активирана у конфигурацији за одговарајућег клијента.

Коришћење преко FiscalClient/FiscalService

При коришћењу FiscalClient-а, за пренос дигиталних потврда доступне су следеће две методе:

Метод коришћењем имена датотеке

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

Ова функција вам омогућава да отпремите дигитални рачун користећи датотеку са чврстог диска (име датотеке).

Параметри

• uniqueClientId: јединствени ИД фискалног клијента.
• filename: име датотеке (укључујући путању) PDF датотеке која се отпрема.
• receiptMetaData: метаподаци за дигитални рачун.

Вредност повраћаја: URL за приказ.

Метод стримовања

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

Ова функција вам омогућава да отпремите дигитални рачун преносом тока датотеке (или токова).

Параметри

• uniqueClientId: јединствени ИД пореског клијента.
• file: ток са садржајем PDF датотеке (ток мора бити на почетку)
• receiptMetaData: метаподаци за дигитални рачун

Вредност повраћаја: URL за приказивање.

Употреба преко nuget имплементације

Када се користи директна имплементација Fiskaclient-а (TrustedFiscalModule) преко nuget-а, доступна је само једна метода са 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)

Помоћу ове функције можете отпремити дигитални рачун преношењем стрима датотеке (или више стримова).

Параметри

• file: ток са садржајем PDF датотеке (ток мора бити на почетку)
• receiptMetaData: метаподаци за дигитални рачун

Вредност повраћаја: URL за приказ.

ReceiptMetaData

Објекат ReceiptMetaData садржи метаподатке за дигитални рачун, што укључује следеће податке:

• Тип документа: тип документа (фактура, потврда, депозит итд.)
• DocumentGuid: DocumentGuid потврде о плаћању (не мешати са DocumentGuid-ом система фискализације)
• Датум издавања: датум документа
• Износ: бруто износ ваучера
• Partner: за продајни документ купац, за остале документе одговарајући партнер (добављач, купац, ...)

Опис објекта можете пронаћи у документацији Document Object Model. (У одељку за преузимање издања).

Овај чланак је аутоматски преведен.