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 funktionalitet er tilgængelig fra version 1.2 af clienten og giver en tilsvarende offlinefunktion til den digitale kvittering.
For at kunne bruge denne funktion skal licensen til Digital kvittering (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 skatteklienten.
- filename: filnavnet (inkl. sti) på den PDF-fil, der skal uploades.
- ReceiptMetaData: Metadata for den digitale kvittering.
Returværdi: URL til visning.
Streamingmetode
/// <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 filstrø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 til rådighed:
/// <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.); for dokumenter, der ikke er skattedokumenter, skal der anvendes [1100] MiscellaneousNonFiscal
- CustomDocumentType: en valgfri brugerdefineret dokumenttype for den digitale kvittering (ikke en skattepligtig dokumenttype)
- DocumentGuid: kvitteringens DocumentGuid (må ikke forveksles med DocumentGuid fra skatte- og afgiftsregistreringssystemet). Cloudtjenesten bruger den som kvitteringens identitet: hvis den uploades igen med samme DocumentGuid, erstatter den den tidligere kvittering. Hvis den ikke er angivet, får kvitteringen en tilfældig identitet og kan ikke henvises til via CancelledDocumentGuid.
- retailForceReceiptId: det korte (8 tegn) unikke kvitterings-ID
- DocumentNumber: dokumentnummeret
- DocumentId: dokumentets unikke identifikationsnummer
- BookDate: dokumentdatoen
- Amount: kvitteringens bruttobeløb
- Partner: for et salgsdokument er det kunden, for andre dokumenter er det den tilhørende partner (leverandør, kunde osv.)
- Brugere: dokumentets brugere (ID, caption); bruges af "Bruger"-søgningen i Cloud
- ItemIdArray: varenumrene på kvitteringen; bruges af "Vare"-søgningen i Cloud
- ItemCodeArray: varenumrene (f.eks. EAN) på kvitteringen; bruges ved søgning efter "Vare" i Cloud
- PaymentCardNumberMaskedArray: de maskerede kortnumre for betalingerne (klare kortnumre må ikke sendes)
- ProcessId: forbinder flere kvitteringer; kvitteringer med samme ProcessId markeres i Clouden som sammenkædede kvitteringer og kan ses samlet
- CancelledDocumentGuid: ved en annullering, DocumentGuid for den annullerede kvittering. Cloud-tjenesten markerer derefter den pågældende kvittering som annulleret.
Objektbeskrivelsen findes i dokumentationen til Document Object Model. (I afsnittet »Downloads« under »Releases«).
Denne artikel er oversat automatisk.
Kommentarer
0 kommentarer
Log ind for at kommentere.