Σε αυτό το άρθρο θα μάθετε πώς να ανεβάζετε αποδείξεις σε μορφή PDF στο RetailForce Cloud χρησιμοποιώντας τον φορολογικό πελάτη (όταν χρησιμοποιείτε τη λειτουργία φορολογικής καταγραφής) και πώς να λαμβάνετε έναν σύνδεσμο για τον πελάτη σας, ώστε να μπορεί να κατεβάσει ή να έχει πρόσβαση στις αποδείξεις.
Αυτή η λειτουργικότητα είναι διαθέσιμη από την έκδοση 1.2 του client και παρέχει αντίστοιχη δυνατότητα εκτός σύνδεσης για την ψηφιακή απόδειξη.
Προσοχή: Εάν δεν χρησιμοποιείτε τη φορολογική καταγραφή, τότε η κλήση πρέπει να σχεδιαστεί διαφορετικά. Παρακαλούμε διαβάστε το άρθρο «Μεταφορά ψηφιακών αποδείξεων μέσω του φορολογικού clients».
Για να χρησιμοποιήσετε αυτή τη λειτουργία, η άδεια χρήσης «Ψηφιακή Απόδειξη (πλήρες προϊόν)» πρέπει να είναι ενεργοποιημένη στη διαμόρφωση του αντίστοιχου client.
Προσοχή: Προκειμένου το σύστημα να μπορεί να διαβάσει τα Metadata από το φορολογικό έγγραφο, το φορολογικό έγγραφο πρέπει να μεταδοθεί στον φορολογικό client ΠΡΙΝ από την κλήση των παρακάτω μεθόδων.
Χρήση μέσω του 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)
Με αυτή τη λειτουργία μπορείτε να ανεβάσετε την ψηφιακή απόδειξη μεταφέροντας ένα filestream (ή streams).
Παράμετροι
- uniqueClientId: το μοναδικό ID του φορολογικού πελάτη.
- file: η ροή με το περιεχόμενο του αρχείου PDF (η ροή πρέπει να βρίσκεται στην αρχή)
- 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)
Με αυτή τη συνάρτηση μπορείτε να ανεβάσετε την ψηφιακή απόδειξη μεταφέροντας ένα filestream (ή ροές).
Παράμετροι
- file: το stream με το περιεχόμενο του αρχείου PDF (το stream πρέπει να βρίσκεται στην αρχή)
- documentGuid: το GUID του φορολογικού εγγράφου (DocumentGuid)
Επιστρεφόμενη τιμή: URL για εμφάνιση.
Αυτό το άρθρο μεταφράστηκε αυτόματα.
Σχόλια
0 σχόλια
Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.