I denne artikel lærer du, hvordan du uploader digitale kvitteringer til RetailForce Cloud ved hjælp af FiscalClient (når den bruges uden fiskalisering) og får et link, som din client kan downloade.

Denne funktion er tilgængelig fra version 1.2 af clienten og giver en tilsvarende offline-funktion til den digitale kvittering.

For at kunne bruge denne funktion skal licensen til Digital Receipt (fuld version) være aktiveret i konfigurationen for den pågældende client.

Brug via FiscalClient/FiscalService

Når du bruger FiscalClient, er følgende to metoder tilgængelige til overførsel af digitale kvitteringer:

Metode ved hjælp af filnavn

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

Denne funktion giver dig mulighed for at uploade den digitale kvittering ved hjælp af en fil på harddisken (filnavn).

Parametre

• uniqueClientId: den unikke ID for den skattemæssige klient.
• filename: filnavnet (inkl. sti) på den PDF-fil, der skal uploades.
• ReceiptMetaData: Metadata for den digitale kvittering.

Returværdi: URL til visning.

Streaming-metode

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

Denne funktion giver dig mulighed for at uploade den digitale kvittering ved at overføre en filestrøm (eller flere strømme).

Parametre

• uniqueClientId: den unikke ID for den skattepligtige klient.
• file: streamen med indholdet af PDF-filen (streamen skal være i begyndelsen)
• ReceiptMetaData: Metadata for den digitale kvittering

Returværdi: URL til visning.

Anvendelse via nuget-implementering

Når du bruger den direkte implementering af Fiskaclient (TrustedFiscalModule) med nuget, er der kun én metode med FileStream tilgængelig:

/// <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 denne funktion kan du uploade den digitale kvittering ved at overføre en filestrøm (eller flere filestrømme).

Parametre

• file: streamen med indholdet af PDF-filen (streamen skal være i begyndelsen)
• ReceiptMetaData: Metadata for den digitale kvittering

Returværdi: URL til visning.

ReceiptMetaData

ReceiptMetaData-objektet indeholder metadataene for den digitale kvittering, herunder følgende data:

• DocumentType: dokumenttypen (faktura, kvittering, indbetaling osv.)
• DocumentGuid: kvitteringens DocumentGuid (skal ikke forveksles med DocumentGuid fra skatte- og afgiftsregistreringssystemet)
• BookDate: dokumentdatoen
• Amount: bilagets bruttobeløb
• Partner: for et salgsdokument er det kunden, for andre dokumenter er det den relevante partner (leverandør, kunde osv.)

Objektbeskrivelsen findes i dokumentationen til Document Object Model. (I afsnittet om downloads i de forskellige releases).

Denne artikel er oversat automatisk.