Σε αυτό το άρθρο θα μάθετε πώς να ανεβάζετε ψηφιακές αποδείξεις στο RetailForce Cloud χρησιμοποιώντας το FiscalClient (όταν χρησιμοποιείται χωρίς φορολογική καταχώριση) και πώς να λαμβάνετε έναν σύνδεσμο για λήψη για τον πελάτη σας.

Αυτή η λειτουργικότητα είναι διαθέσιμη από την έκδοση 1.2 του client και παρέχει αντίστοιχη δυνατότητα εκτός σύνδεσης για την ψηφιακή απόδειξη.

Για να χρησιμοποιήσετε αυτή τη λειτουργία, η άδεια χρήσης «Ψηφιακή Απόδειξη (πλήρες προϊόν)» πρέπει να είναι ενεργοποιημένη στις ρυθμίσεις του αντίστοιχου 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="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)

Αυτή η λειτουργία σας επιτρέπει να ανεβάσετε την ψηφιακή απόδειξη χρησιμοποιώντας ένα αρχείο στον σκληρό δίσκο (όνομα αρχείου).

Παράμετροι

• uniqueClientId: το μοναδικό ID του φορολογικού πελάτη.
• filename: το όνομα αρχείου (συμπεριλαμβανομένης της διαδρομής) του αρχείου PDF που θα μεταφορτωθεί.
• ReceiptMetaData: τα μεταδεδομένα για την ψηφιακή απόδειξη.

Επιστρεφόμενη τιμή: 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="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)

Αυτή η συνάρτηση σας επιτρέπει να ανεβάσετε την ψηφιακή απόδειξη μεταφέροντας ένα filestream (ή streams).

Παράμετροι

• uniqueClientId: το μοναδικό ID του φορολογικού πελάτη.
• file: η ροή με το περιεχόμενο του αρχείου PDF (η ροή πρέπει να βρίσκεται στην αρχή)
• ReceiptMetaData: τα μεταδεδομένα για την ψηφιακή απόδειξη

Επιστρεφόμενη τιμή: URL για εμφάνιση.

Χρήση μέσω υλοποίησης nuget

Όταν χρησιμοποιείτε την άμεση υλοποίηση του Fiskaclient (TrustedFiscalModule) με το nuget, διατίθεται μόνο μία μέθοδος με FileStream:

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

Με αυτή τη συνάρτηση μπορείτε να ανεβάσετε την ψηφιακή απόδειξη μεταφέροντας ένα filestream (ή ροές).

Παράμετροι

• file: το stream με το περιεχόμενο του αρχείου PDF (το stream πρέπει να βρίσκεται στην αρχή)
• ReceiptMetaData: τα μεταδεδομένα για την ψηφιακή απόδειξη

Τιμή επιστροφής: URL για εμφάνιση.

ReceiptMetaData

Το αντικείμενο ReceiptMetaData περιέχει τα μεταδεδομένα για την ψηφιακή απόδειξη, τα οποία περιλαμβάνουν τα ακόλουθα δεδομένα:

• DocumentType: ο τύπος εγγράφου (τιμολόγιο, απόδειξη, κατάθεση κ.λπ.)
• DocumentGuid: το DocumentGuid της απόδειξης (δεν πρέπει να συγχέεται με το DocumentGuid του συστήματος φορολογικής καταχώρισης)
• BookDate: η ημερομηνία του εγγράφου
• Amount: το ακαθάριστο ποσό του παραστατικού
• Partner: για ένα έγγραφο πώλησης, ο πελάτης, για άλλα έγγραφα, ο αντίστοιχος συνεργάτης (προμηθευτής, πελάτης, ...)

Η περιγραφή του αντικειμένου βρίσκεται στην τεκμηρίωση του Document Object Model. (Στην ενότητα «Λήψεις» των releases).

Αυτό το άρθρο μεταφράστηκε αυτόματα.