I den här artikeln lär du dig hur du laddar upp digitala kvitton till RetailForce Cloud med hjälp av FiscalClient (när det används utan fiscalisation) och får en länk som du kan ladda ner åt din client.

Denna funktion finns tillgänglig från version 1.2 av clienten och erbjuder motsvarande offlinefunktion för det digitala kvittot.

För att kunna använda denna funktion måste licensen för Digital Receipt (full version) vara aktiverad i konfigurationen för respektive client.

Användning via FiscalClient/FiscalService

När du använder FiscalClient finns följande två metoder tillgängliga för överföring av digitala kvitton:

Metod med filnamn

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

Med den här funktionen kan du ladda upp det digitala kvittot med hjälp av en fil på hårddisken (filnamn).

Parametrar

• uniqueClientId: det unika ID:t för skatteklienten.
• filename: filnamnet (inkl. sökväg) på den PDF-fil som ska laddas upp.
• ReceiptMetaData: metadata för det digitala kvittot.

Returvärde: URL för visning.

Strömningsmetod

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

Denna funktion gör det möjligt att ladda upp det digitala kvittot genom att överföra en filström (eller flera strömmar).

Parametrar

• uniqueClientId: det unika ID:t för den skattemässiga kunden.
• file: streamen med innehållet i PDF-filen (streamen måste vara i början)
• ReceiptMetaData: Metadata för det digitala kvittot

Returvärde: URL för visning.

Användning via nuget-implementering

När du använder den direkta implementeringen av Fiskaclient (TrustedFiscalModule) med nuget finns endast en metod med FileStream tillgänglig:

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

Med denna funktion kan du ladda upp det digitala kvittot genom att överföra en filström (eller strömmar).

Parametrar

• file: streamen med innehållet i PDF-filen (streamen måste vara i början)
• ReceiptMetaData: Metadata för det digitala kvittot

Returvärde: URL för visning.

ReceiptMetaData

ReceiptMetaData-objektet innehåller metadata för det digitala kvittot, vilket inkluderar följande data:

• DocumentType: dokumenttypen (faktura, kvitto, insättning etc.)
• DocumentGuid: kvittots DocumentGuid (ska inte förväxlas med DocumentGuid i skattesystemet)
• BookDate: dokumentets datum
• Amount: kvittots bruttobelopp
• Partner: för ett försäljningsdokument är det kunden, för andra dokument är det motsvarande partner (leverantör, kund, ...)

Objektbeskrivningen finns i dokumentationen för Document Object Model. (I avsnittet för nedladdningar i releases).

Den här artikeln har översatts automatiskt.