Η υπηρεσία φορολογικής καταχώρησης RetailForce είναι ένα middleware φορολογικής καταχώρησης βασισμένο στο .NET για τη Γερμανία και όλες τις άλλες χώρες.

Εγκατάσταση

Μπορείτε να κατεβάσετε ένα αντίγραφο της υπηρεσίας φορολογικής καταγραφής για Windows χρησιμοποιώντας τον παρακάτω σύνδεσμο:

http://www.retailforce.cloud/downloads

Παρακαλούμε να κατεβάσετε την πιο πρόσφατη έκδοση του λογισμικού.

Η εγκατάσταση είναι απλή και δεν απαιτούνται περαιτέρω πληροφορίες.

Μετά την εγκατάσταση, η υπηρεσία λειτουργεί ως REST-WebService (JSON) στη θύρα 7678 (HTTPS) στον localhost.

Εναλλακτικές λύσεις

Ως εναλλακτική λύση της εγκατάστασης της υπηρεσίας REST, το RetailForce Fiskal middleware διατίθεται επίσης ως:

• Docker-container - ως λήψη στο Docker Hub https://hub.docker.com/u/RetailForce, καθώς και
• nuget-packages – κατεβάστε τα πακέτα από τη διεύθυνση: https://www.nuget.org/profiles/RetailForceDevelopment

Πληροφορίες σχετικά με αυτές τις παραλλαγές εγκατάστασης/ενσωμάτωσης μπορείτε να βρείτε στα ακόλουθα άρθρα:

• Docker-Container: Linux - TrustedFiscalService ως Docker Container
• nuget-packages: Πρώτα βήματα στην υλοποίηση με nuget

Δείγμα εφαρμογής

Θα βρείτε επίσης μια δείγμα εφαρμογή στον παραπάνω κατάλογο λήψης, στον υποφάκελο Samples (Fiscal Service Client Sample). Σε αυτή τη δείγμα εφαρμογή περιλαμβάνεται ολόκληρος ο πηγαίος κώδικας για απλή καταχώριση και υπογραφή σε C#.

Για να χρησιμοποιήσετε την εφαρμογή-δείγμα, μπορείτε να χρησιμοποιήσετε τον ακόλουθο κωδικό πελάτη:

{c1062c55-57c4-4ed2-9c53-aff1762326a4}

Μπορείτε να χρησιμοποιήσετε αυτό το client-guid για τις πρώτες σας δοκιμές χωρίς πρόβλημα. Για περαιτέρω δοκιμές, συμπεριλαμβανομένης της ενσωμάτωσης στο Cloud, θα πρέπει να δημιουργήσετε τον δικό σας δοκιμαστικό πελάτη με το RetailForce Cloud.

Εάν αντιμετωπίσετε προβλήματα με DLL που λείπουν, παρακαλούμε ρίξτε μια ματιά στο φάκελο bin/debug του έργου στην εφαρμογή-δείγμα.

Επικύρωση εγγράφου

Για να σας βοηθήσουμε στην ενσωμάτωση του λογισμικού σας, έχουμε δημιουργήσει μέχρι στιγμής μια συνάρτηση για την επικύρωση του μοντέλου αντικειμένου εγγράφου που θα στείλετε στη μονάδα φορολογικής καταχώρισης.

Όταν καλείτε τη μέθοδο ValidateDocument σε ένα δημιουργημένο TrustedFiscalModule ή στην υπηρεσία web φορολογικής καταχώρησης (ανάλογα με την ενσωμάτωσή σας), θα λάβετε όλα τα σφάλματα (και τις προειδοποιήσεις) του εγγράφου ταυτόχρονα. Έτσι, είναι πολύ πιο εύκολο να προσαρμόσετε τη διαδικασία κλήσης για να ολοκληρώσετε τη διαδικασία ενσωμάτωσης.

Πρόσθετες πληροφορίες

Η ενσωμάτωση του middleware μπορεί να πραγματοποιηθεί με τους ακόλουθους τρόπους

• Ενσωμάτωση μέσω διαδικτυακής υπηρεσίας (Windows, REST)
• Ενσωμάτωση μέσω διαδικτυακής υπηρεσίας (με το Fiskalclient στο .NET Standard, nuget)
• Ενσωμάτωση μέσω διαδικτυακής υπηρεσίας (με το Fiskalclient στο .NET Framework 2.0, nuget)
• Ενσωμάτωση μέσω διαδικτυακής υπηρεσίας (ως COM-DLL/Active X, διαθέσιμη κατόπιν αιτήματος)
• Ενσωμάτωση ως πακέτο AAR σε συσκευή Android (για Java) (η διαθεσιμότητα εξαρτάται από τα σχέδια της Microsoft)

Ορισμένες πρόσθετες πληροφορίες σχετικά με τεχνικά ζητήματα

• Η όλη ανάπτυξη πραγματοποιείται με τη μέθοδο της ανάπτυξης με βάση τις δοκιμές
• Όλες οι δοκιμές εκτελούνται κατά τη διάρκεια της διαδικασίας κατασκευής κατά τη δημιουργία μιας νέας έκδοσης
• Ανάπτυξη της λύσης μέσω πακέτων nuget-packages ή επίσης μέσω λήψης του προγράμματος εγκατάστασης των Windows.

Λειτουργικά συστήματα

Το RetailForce Fiscal Middleware έχει δοκιμαστεί μέχρι στιγμής στα ακόλουθα λειτουργικά συστήματα:

• Windows 7
• Windows 10
• Android (από την έκδοση 8) (ως ενσωμάτωση πακέτου nuget)
• Linux (για την υπηρεσία)

Παρακαλούμε ανατρέξτε επίσης στην τεκμηρίωση του συστήματος ασφαλείας για να διαπιστώσετε εάν το επιλεγμένο σύστημα ασφαλείας (TSE, HSM κ.λπ.) στη συγκεκριμένη χώρα υποστηρίζει το λειτουργικό σας σύστημα.

Προς το παρόν δεν έχει δοκιμαστεί και δεν υποστηρίζεται, αλλά θα πρέπει να λειτουργεί:

• iOS (ως ενσωμάτωση πακέτου nuget)

Διαχείριση φορολογικών πελατών

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

Γι' αυτό δημιουργήσαμε τις ακόλουθες πρόσθετες υπηρεσίες:

• Αυτόματη διαμόρφωση πελατών μέσω του RetailForce Cloud, χωρίς ανάγκη συντήρησης του εγκατεστημένου φορολογικού πελάτη
• API διαχείρισης του RetailForce Cloud για τη διαχείριση επιπλέον εταιρειών, καταστημάτων και τερματικών, καθώς και όλων των άλλων βασικών δεδομένων που θα χρειαστείτε.

Πρόσθετη τεκμηρίωση / τεκμηρίωση υπηρεσιών

Θα βρείτε πρόσθετη τεκμηρίωση εδώ:

Πλήρης περιγραφή της υπηρεσίας για την υπηρεσία web

• http://localhost:7678/swagger (μετά την εγκατάσταση της διαδικτυακής υπηρεσίας)

Πλήρης τεκμηρίωση (μοντέλο αντικειμένων) της φορολογικής υπηρεσίας

Τεκμηρίωση φακέλου στον υποφάκελο «download» των αρχείων εγκατάστασης (σύνδεσμος στο κεφάλαιο «Εγκατάσταση»)

Αυτή η τεκμηρίωση θα είναι σύντομα διαθέσιμη στη διεύθυνση http://docs.RetailForce Cloud.

Χαρακτηριστικά χώρας (fiscalCountryProperties)

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