Μετάβαση στο κύριο περιεχόμενο

Βασική διαδικασία μεταφοράς εγγράφων

Harald Krondorfer
  • Ενημέρωση

Δημιουργία της φορολογικής ενότητας

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

  • Εάν χρησιμοποιείτε την αξιόπιστη φορολογική υπηρεσία (υπηρεσία Windows ή Linux), η φορολογική ενότητα θα δημιουργηθεί αυτόματα για εσάς από τη φορολογική υπηρεσία.
  • Εάν σκοπεύετε να πραγματοποιήσετε την ενσωμάτωση της φορολογικής ενότητας με άμεση ενσωμάτωση .NET DLL, πρέπει να δημιουργήσετε τη φορολογική ενότητα μόνοι σας. Μια λεπτομερής περιγραφή παρατίθεται παρακάτω:
    Δημιουργία / εκκίνηση της φορολογικής ενότητας
Προσοχή: Η φορολογική ενότητα αρχικοποιεί μερικές υποενότητες και δεν πρέπει να δημιουργείται εκ νέου για κάθε απόδειξη (π.χ. ο αυτοέλεγχος του υλικού TSS (Γερμανία) απαιτεί τουλάχιστον 30 δευτερόλεπτα). Επιπλέον, η μέθοδος απαιτεί την κλήση του CloudConnect πριν από τη μεταφορά εγγράφων, διαφορετικά η αρχειοθέτηση στο cloud θα αποτύχει (απαιτείται μόνο εάν είναι ενεργοποιημένη η αρχειοθέτηση στο cloud).

Μεταφορά εγγράφων

Για να μεταφέρετε φορολογικά έγγραφα στη φορολογική ενότητα, χρειάζονται τουλάχιστον 2 βήματα:

  • createDocument
  • storeDocument

Ανεξάρτητα από τη χώρα, συνιστούμε να καλείτε τη μέθοδο createDocument σε κάθε περίπτωση.

Προσοχή: Η μέθοδος createDocument πρέπει να καλείται στην αρχή ενός εγγράφου (όταν καταχωρείτε ένα είδος). Αυτό είναι απολύτως απαραίτητο για τη νόμιμη εφαρμογή της φορολογικής καταγραφής (π.χ.: στη Γερμανία). Πρέπει να ορίσετε το fiscalResponse του εγγράφου που θα αποθηκεύσετε με το fiscalResponse που λάβατε κατά την κλήση της μεθόδου createDocument.

Παράδειγμα εγγράφου απόδειξης σε μορφή JSON:

{
"UniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
"DocumentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
"DocumentId": "2021-02-02T05:31:08.9450964+01:00",
"CreateDate": "2021-02-02T05:31:08.9450964+01:00",
"BookDate": "2021-02-02T05:31:08.9450964+01:00",
"DocumentNumber": null,
"CancellationDocument": false,
"DocumentReference": null,
"IsTraining": false,
"DocumentType": 0,
"DocumentTypeCaption": null,
"User": {
   "Id": "1234",
   "Caption": "Testuser"
},
"AllocationGroups": [],
"Partner": null,
"FiscalResponse": null, 
"FiscalDocumentNumber": 0, // set fiscaldocument of create document here
"FiscalDocumentRevision": 0, // set fisacldocument revision of create document here
"Positions": [
   {
      "ItemCaption": "Blume grün", // the caption of the item
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "Quantity": 1.0,
      "QuantityUnit": null,
      "ItemId": "000714", // the item id
      "BaseNetValue": 3.61, // base value (without discounts)
      "BaseGrossValue": 4.3,
      "BaseTaxValue": 0.69,
      "GTIN": null,
      "BusinessTransactionType": 0,
      "VatIdentification": 1, 
      "VatPercent": 19.0, 
      "NetValue": 3.61, // net value (quantity * price)
      "GrossValue": 4.3, // gross value of the position
      "TaxValue": 0.69,
      "AccountingIdentifier": null,
      "PositionNumber": 0,
      "PositionReference": null,
      "CancellationPosition": false
   }
],
"Payments": [
   {
      "Amount": 5.0, // payment with over payment
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   },
   {
      "Amount": -0.7, // cash return (second payment)
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   }
]
}

Αυτή η απόδειξη περιέχει:

  • μία θέση είδους με το είδος «000714», «Blume grün», με τιμή 4,3 EUR μικτό (1 τεμάχιο).
  • 2 πληρωμές, μία θέση με 5 EUR σε μετρητά και επιστροφή 0,7 EUR
Σημείωση: Για να δείτε πώς πρέπει να συγκροτηθεί ένα έγγραφο, μπορείτε να ρίξετε μια ματιά στο Fiscal Service Client Sample (C#), το οποίο μπορείτε να βρείτε στην ενότητα λήψεων (http://www.retailforce.cloud/downloads ). Εμφανίζει επίσης το JSON που προκύπτει όταν ξεκινάτε την εφαρμογή-δείγμα. Βεβαιωθείτε ότι έχετε εγκαταστήσει και εκκινήσει τη φορολογική υπηρεσία στον ίδιο υπολογιστή.

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

  • cancelDocument
Προσοχή: Κάθε έγγραφο που δημιουργείται (με τη μέθοδο createDocument) πρέπει να κλείνεται με τη μέθοδο storeDocument ή να ακυρώνεται με τη μέθοδο cancelDocument.

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

  • ValidateDocument
Πληροφορία: Το ίδιο το έγγραφο θα επικυρώνεται πάντα πριν αποθηκευτεί (ακόμη και αν ακυρωθεί). Εάν προκύψει σφάλμα επικύρωσης, η μέθοδος storeDocument θα αποτύχει με εξαίρεση.

Λεπτομερείς διαδικασίες

Διαδικασία πωλήσεων Λιανική

Η πώληση αγαθών, για παράδειγμα στη λιανική, ακολουθεί την παρακάτω διαδικασία:

Χειριστής Σύστημα ταμειακής μηχανής Υπηρεσία φορολογικής καταγραφής RetailForce
1. Ο χειριστής (χρήστης του ταμειακού μηχανήματος) εισάγει το πρώτο είδος που επιθυμεί να αγοράσει ο πελάτης.    
  2. Το σύστημα ταμειακής μηχανής αποστέλλει αίτημα στην υπηρεσία φορολογικής καταγραφής (createDocument) για την καταχώριση της έναρξης της αντίστοιχης συναλλαγής.  
    3. Η υπηρεσία φορολογικής καταγραφής λαμβάνει το αίτημα από το ανάντη σύστημα και το επεξεργάζεται σύμφωνα με τις απαιτήσεις της εκάστοτε χώρας (π.χ. υπογραφή κ.λπ.).
    4. Η υπηρεσία φορολογικής καταγραφής αποστέλλει απάντηση (fiscalResponse) στο ανάντη σύστημα.
  5. Το σύστημα ταμειακής μηχανής (ανώτερο σύστημα) λαμβάνει την απάντηση και αποθηκεύει τμήματα αυτής (ή ολόκληρο το αντικείμενο της απάντησης) για περαιτέρω χρήση (αναφορά) όταν ολοκληρωθεί η συναλλαγή.  
6. Ο χειριστής σαρώνει όλα τα είδη του πελάτη και ξεκινά τη διαδικασία πληρωμής.    
 

7. Μόλις καθοριστούν όλα τα δεδομένα της συναλλαγής (είδη, τρόπος πληρωμής κ.λπ.), το σύστημα POS δημιουργεί το payload της συναλλαγής (JSON) και αποστέλλει ένα ακόμη αίτημα στη φορολογική υπηρεσία (storeDocument), η οποία ολοκληρώνει (αποθηκεύει) τη συναλλαγή.

Ορισμένες πληροφορίες από το fiscalResponse που ελήφθη κατά τη διάρκεια του createDocument πρέπει να περιλαμβάνονται στο payload («fiscalDocumentNumber», «fiscalDocumentStartTime» και, εάν ισχύει, στοιχεία ειδικά για κάθε χώρα, όπως το «fiscalDocumentRevision» στη Γερμανία).

Προσοχή: στο payload επιτρέπεται να περιλαμβάνονται μόνο τα στοιχεία που αναφέρονται παραπάνω και ΟΧΙ ολόκληρο το αντικείμενο fiscalResp!
  
    8. Η φορολογική υπηρεσία λαμβάνει αιτήματα από το ανάντη σύστημα και τα επεξεργάζεται σύμφωνα με τις απαιτήσεις της εκάστοτε χώρας (π.χ. υπογραφή κ.λπ.).
    9. Η φορολογική υπηρεσία αποστέλλει μια απάντηση (fiscalResponse) στο ανάντη σύστημα.
  10. Το σύστημα ταμειακής μηχανής λαμβάνει το fiscalResponse, εξάγει τις πληροφορίες που απαιτούνται για τη δημιουργία του εγγράφου (π.χ. υπογραφή εγγράφου, κωδικός QR κ.λπ.) και εκτυπώνει το έγγραφο.  
11. Ο χειριστής παραδίδει την εκτυπωμένη απόδειξη στον πελάτη    

Διαδικασία πώλησης στο λιανικό εμπόριο με ακύρωση συναλλαγής

Εάν, όπως περιγράφεται παραπάνω, κατά τη διάρκεια του βήματος 6, δηλαδή ΜΕΤΑ την αποστολή του createDocument (βήμα 2) και ΠΡΙΝ την αποστολή του storeDocument (βήμα 7), το σύστημα POS στείλει ένα cancelDocument ΑΝΤΙ ενός storeDocument.

Προσοχή: η εντολή cancelDocument χρησιμοποιείται για την ακύρωση (εγκατάλειψη) μιας ημιτελούς συναλλαγής και ΟΧΙ (!) για την καταγραφή επιστροφών.

Οι επιστροφές επεξεργάζονται με τον ίδιο τρόπο όπως οι κανονικές συναλλαγές πώλησης, χρησιμοποιώντας τις εντολές createDocument και storeDocument.

 

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

Σχετικά άρθρα

Σχόλια

0 σχόλια

Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.

Παρέχεται από τη Zendesk