В тази статия ще научите как да качвате касови бележки като PDF файлове в RetailForce Cloud чрез фискалния клиент (при използване на фискализация) и как да получите линк, чрез който вашият клиент да може да изтегли или да има достъп до касовите бележки.

Тази функционалност е достъпна от версия 1.2 на клиента и осигурява съответна офлайн възможност за цифровата разписка.

За да използвате тази функция, лицензът за „Цифрова разписка“ (пълна версия) трябва да бъде активиран в конфигурацията на съответния клиент. 

Използване чрез FiscalClient/FiscalService

При използване на FiscalClient за прехвърляне на цифрови касови бележки са налични следните 2 метода:

Метод чрез име на файл

 /// <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="documentGuid">The document guid of the document to get the receipt meta data. Document must be transferred before to fiscalisation.</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="ArgumentNullException">Thrown if parameter <paramref name="documentGuid"/> is set to <see cref="Guid.Empty"/>.</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, Guid documentGuid)

Тази функция ви позволява да качите цифровата разписка чрез файл на твърдия диск (име на файла).

Параметри

• uniqueClientId: уникалният ID на фискалния клиент.
• filename: името на файла (вкл. пътя) на PDF файла, който ще се качи.
• documentGuid: GUID на фискалния документ (Document.DocumentGuid)

Връщана стойност: 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="documentGuid">The document guid of the document to get the receipt meta data. Document must be transferred before to fiscalisation.</param>
/// <returns>A unique url to download the file for the customer.</returns>
/// <remarks>You can only use documents from the actual day.</remarks>
/// <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>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="documentGuid"/> is set to <see cref="Guid.Empty"/>.</exception>
public string UploadDigitalReceipt(Guid uniqueClientId, Stream file, Guid documentGuid)

С тази функция можете да качите цифровата разписка чрез прехвърляне на файлов поток (или потоци).

Параметри

• uniqueClientId: уникалният ID на фискалния клиент.
• file: stream-ът със съдържанието на PDF файла (stream-ът трябва да започва от началото)
• documentGuid: GUID на фискалния документ (Document.DocumentGuid)

Връщана стойност: URL за показване.

Използване чрез nuget имплементация

При използване на директната имплементация на Fiskaclient (TrustedFiscalModule) с nuget е наличен само един метод с FileStream:

 /// <summary>
/// Upload digital receipt (if proper license exists). Only in combination with fiscalisation.
/// </summary>
/// <param name="file">The file to upload.</param>
/// <param name="documentGuid">The document guid of the document to get the receipt meta data. Document must be transferred before to fiscalisation.</param>
/// <returns>An url to request the file in the cloud.</returns>
/// <remarks>You can only use documents from the actual day.</remarks>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="file"/> is set to null.</exception>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="documentGuid"/> is set to <see cref="Guid.Empty"/>.</exception>
/// <exception cref="KeyNotFoundException">Thrown if the given documentGuid does not found a document in the document store.</exception>
public string UploadDigitalReceipt(Stream file, Guid documentGuid)

С тази функция можете да качите цифровата разписка чрез прехвърляне на файлов поток (или потоци).

Параметри

• file: stream-ът със съдържанието на PDF файла (stream-ът трябва да е в началото)
• documentGuid: GUID на фискалния документ (Document.DocumentGuid)

Връщана стойност: URL за показване.

Тази статия е преведена автоматично.