Τα παρακάτω παραδείγματα JSON δείχνουν πώς μπορεί να γίνει η διαχείριση της είσπραξης μιας προκαταβολής και η επακόλουθη επεξεργασία αυτής της προκαταβολής κατά την παράδοση ή την παροχή υπηρεσιών στο RetailForce. Σημειώστε ότι ο όρος που χρησιμοποιείται στο RetailForce για τις προκαταβολές είναι «deposit».
Σημειώστε ότι ορισμένες τιμές ιδιοτήτων που χρησιμοποιούνται στα παραδείγματα πρέπει να προσαρμοστούν, ώστε να μπορείτε να χρησιμοποιήσετε το payload στο σύστημά σας (π.χ. «uniqueClientId», «BookDate»). Τα παραδείγματα έχουν επίσης δημιουργηθεί για μια συγκεκριμένη χώρα, πράγμα που σημαίνει ότι πρέπει επίσης να προσαρμοστούν οι φορολογικοί συντελεστές, τα ακαθάριστα και καθαρά ποσά κ.λπ.
Δεν υποστηρίζονται και οι δύο παραλλαγές σε όλες τις χώρες: ο τύπος επιχειρηματικής συναλλαγής «7» (Προκαταβολή), ο οποίος χρησιμοποιείται στο βήμα 1 και στην επιλογή 1, δεν υποστηρίζεται στην Ισπανία και την Κροατία. Στον Καναδά, δεν υποστηρίζεται ούτε ο τύπος επιχειρηματικής συναλλαγής «7» (Προκαταβολή) ούτε ο τύπος πληρωμής «6» (Προκαταβολή). Οι τύποι που υποστηρίζει μια χώρα αναφέρονται στα χαρακτηριστικά της χώρας (fiscalCountryProperties).
| Release χρήστη: | 1.11.16.2546 |
| Έκδοση DOM: | 1.7.0 |
1. Λήψη κατάθεσης/προκαταβολής
Στο πρώτο βήμα δημιουργείται απόδειξη για την προκαταβολή που εισπράχθηκε:
- Ο πελάτης καταθέτει μετρητά ύψους 1.200 EUR για μια μελλοντική παράδοση ή υπηρεσία.
Ιδιότητες συναλλαγής
Ο παρακάτω πίνακας δείχνει ποιες ιδιότητες πρέπει να οριστούν σε ποιες τιμές, προκειμένου να αποτυπωθεί σωστά η επιχειρηματική περίπτωση.
| Ιδιότητα | Τιμή | Περιγραφή |
| DocumentType | "0" ή "[0] = Απόδειξη" | να διεκπεραιωθεί μέσω απόδειξης εισπράξεως |
| Τύπος θέσεων | «3» ή «[3] = Καταχώριση» | Μια εισπραχθείσα κατάθεση καταγράφεται ως γραμμή τύπου «3» (θέση κράτησης). |
| Θέσεις.BusinessTransactionType | «7» ή «[7] = Προκαταβολή» | Ο συγκεκριμένος τύπος επιχειρηματικής συναλλαγής (BusinessTransactionType) που χρησιμοποιείται είναι «7» (προκαταβολή). |
| Θέσεις.VatIdentification | Εάν, στη σχετική χώρα, ο Vat πρέπει να αναγράφεται ή να καταβάλλεται ήδη κατά την είσπραξη προκαταβολής ή προκαταβολής, πρέπει να καθοριστεί ο σωστός ID του Vat και να υπολογιστεί ο Vat αναλόγως. | |
| Payments.Type | «0» ή «Μετρητά» | Δεδομένου ότι η συγκεκριμένη περίπτωση αφορά πληρωμή με μετρητά, πρέπει επίσης να καθοριστεί αναλόγως ο τρόπος πληρωμής. |
Παράδειγμα:
{
"ModelVersion": "1.7.0",
"UniqueClientId": "3e2c0cdf-e72c-43ea-a050-686eb0eb3853",
"UniqueCashRegisterId": null,
"ApplicationVersion": "1.0.0",
"ApplicationVersionId": null,
"ApplicationVersionPrevious": null,
"FiscalModuleVersion": "1.11.0.0",
"FiscalCountryModuleVersion": null,
"SoftwareName": "RetailForce neverPOS",
"RetailForceReceiptId": null,
"AdditionalFields": {},
"AutomaticVatCalculation": 0,
"AllowedVatDeviation": 0.01,
"PrintCount": null,
"TerminalSlaveId": null,
"FooterGraphicIndex": null,
"DocumentGuid": "026f0809-88b8-48c2-9e96-6f3ba37f48ff",
"DocumentId": "0026",
"CreateDate": "2026-06-01T13:30:08+02:00",
"BookDate": "2026-06-01T13:30:08+02:00",
"AccountingDate": "2026-06-01T13:30:08+02:00",
"DocumentNumber": "202500026",
"DocumentNumberSeries": "SI",
"CancellationDocument": false,
"FailedToPay": false,
"DocumentReference": null,
"IsTraining": false,
"TestCaseNumber": null,
"DocumentType": 0,
"DocumentTypeCaption": "POS-Receipt",
"User": {
"Id": "1",
"Caption": "User01",
"FirstName": "Joe",
"LastName": "Dowe",
"TaxNumber": null,
"DateOfEntry": "2025-09-23T15:11:08.6041978+02:00"
},
"SalesPerson": null,
"AllocationGroups": [],
"CustomerCount": null,
"Partner": null,
"Notes": null,
"PaymentTerms": null,
"ServicePeriodStart": null,
"ServicePeriodEnd": null,
"PositionCount": 1,
"DocumentIssueType": null,
"Coupon": null,
"ServiceType": null,
"IsEcommerceTransaction": null,
"TaxPositions": null,
"FiscalDocumentNumber": 0,
"FiscalDocumentRevision": 0,
"FiscalDocumentStartTime": 0,
"Positions": [
{
"PositionNumber": 0,
"Caption": "Downpayment for Order",
"Type": 3,
"BusinessTransactionType": 7,
"PayOutType": null,
"VatIdentification": 1,
"VatPercent": 200.0,
"NetValue": 1000.00,
"GrossValue": 1200.00,
"TaxValue": 200.00,
"AdditionalFields": {},
"ExternalIdentifier": []
}
],
"Payments": [
{
"Amount": 1200.00,
"CurrencyIsoCode": "EUR",
"Caption": "Bar",
"UniqueReadablePaymentIdentifier": "BAR",
"ForeignAmount": 0,
"ForeignAmountExchangeRate": 0,
"AdditionalFields": {},
"PaymentType": 0,
"CreateDate": null,
"VatIdentification": null,
"VatPercent": null,
"VatPercent2": null,
"TaxValue": null,
"TaxValue2": null,
"ExternalIdentifier": [],
"User": null,
"SalesPerson": null,
"PaymentTerminalReferenceId": null,
"CardData": null
}
],
"AdditionalHeader": [],
"AdditionalFooter": [],
"FiscalAdditionalFields": {}
}
2. Εξόφληση της τελικής πληρωμής
Κατά την παράδοση ή την παροχή των υπηρεσιών (π.χ. όταν ο πελάτης παραλαμβάνει τα προϊόντα που έχει παραγγείλει), ο πελάτης πρέπει να εξοφλήσει το υπόλοιπο της συνολικής αξίας των προϊόντων:
- Συνολική αξία των εμπορευμάτων/υπηρεσιών: 2.979,90 EUR
- Λαμβάνοντας υπόψη την προκαταβολή των 1.200 EUR
- Ο πελάτης καταβάλλει επίσης το υπόλοιπο (1.779,90 EUR) σε μετρητά
Η προκαταβολή μπορεί να συμπεριληφθεί στο τελικό έγγραφο με δύο διαφορετικούς τρόπους:
Επιλογή 1 – Προκαταβολή ως στοιχείο
Σε αυτή την παραλλαγή, η προκαταβολή περιλαμβάνεται στο payload ως αρνητική εγγραφή (το αντίθετο της εγγραφής στο αρχικό payload).
Ιδιότητες συναλλαγής
Ο παρακάτω πίνακας δείχνει ποιες ιδιότητες πρέπει να οριστούν σε ποιες τιμές, προκειμένου να αποτυπωθεί σωστά η επιχειρηματική περίπτωση.
| Ιδιότητα | Τιμή | Περιγραφή |
| DocumentType | "0" ή "[0] = Απόδειξη" | για επεξεργασία μέσω απόδειξης εισπράξεως |
| Τύπος θέσεων | «0» ή «[0] = Είδος» | Για τη θέση είδους 0 (το είδος που παραγγέλθηκε από τον πελάτη και για το οποίο έχει καταβληθεί προκαταβολή) |
| Θέσεις.BusinessTransactionType | «0» ή «[0] = Revenue» | Για τη θέση 0 (το προϊόν που παραγγέλθηκε από τον πελάτη και για το οποίο έχει καταβληθεί προκαταβολή) |
| Θέσεις.Τύπος | «3» ή «[3] = Κράτηση» | Για να συμπεριληφθεί η προκαταβολή που εισπράχθηκε, χρησιμοποιείται η θέση 1 τύπου «3» (θέση κράτησης) – όπως στο πρώτο παράδειγμα. Ωστόσο, οι τιμές (GrossValue, NetValue κ.λπ.) για αυτή τη θέση είναι αρνητικές (!) |
| BusinessTransactionType | «7» ή «[7] = Προκαταβολή» | Ο συγκεκριμένος τύπος επιχειρηματικής συναλλαγής (BusinessTransactionType) που χρησιμοποιείται στο στοιχείο 1 είναι «7» (προκαταβολή). |
| Θέσεις.VatIdentification | Ο Vat πρέπει επίσης να ληφθεί υπόψη κατά τον διακανονισμό της προκαταβολής. | |
| Payments.Type | «0» ή «Μετρητά» |
Στην ενότητα «Πληρωμές», εμφανίζεται μόνο η υπόλοιπη πληρωμή σε μετρητά (Σύνολο Στοιχείων = Σύνολο Πληρωμών). Υπολογισμός: Θέση 0: 2.979,90 Θέση 1: -1.200,00 Σύνολο θέσεων: 1.779,90 Πληρωμές: 1.779,90 (μετρητά) Σύνολο πληρωμών: 1.779,90 |
Παράδειγμα:
{
"ModelVersion": "1.7.0",
"UniqueClientId": "3e2c0cdf-e72c-43ea-a050-686eb0eb3853",
"UniqueCashRegisterId": null,
"ApplicationVersion": "1.0.0",
"ApplicationVersionId": null,
"ApplicationVersionPrevious": null,
"FiscalModuleVersion": "1.11.0.0",
"FiscalCountryModuleVersion": null,
"SoftwareName": "RetailForce neverPOS",
"RetailForceReceiptId": null,
"AdditionalFields": {},
"AutomaticVatCalculation": 0,
"AllowedVatDeviation": 0.01,
"PrintCount": null,
"TerminalSlaveId": null,
"FooterGraphicIndex": null,
"DocumentGuid": "215f0809-88b8-48c2-9e96-6f3ba37f48ff",
"DocumentId": "0021",
"CreateDate": "2025-10-09T12:50:08+02:00",
"BookDate": "2025-10-09T12:50:08+02:00",
"AccountingDate": "2025-10-09T12:50:08+02:00",
"ProcessStartDate": "2025-10-09T12:50:08+02:00",
"DocumentNumber": "202500021",
"DocumentNumberSeries": "SI",
"CancellationDocument": false,
"FailedToPay": false,
"DocumentReference": null,
"IsTraining": false,
"TestCaseNumber": null,
"DocumentType": 0,
"DocumentTypeCaption": "POS-Receipt",
"User": {
"Id": "1",
"Caption": "User01",
"FirstName": "Joe",
"LastName": "Dowe",
"TaxNumber": null,
"DateOfEntry": "2025-09-23T15:11:08.6041978+02:00"
},
"SalesPerson": null,
"AllocationGroups": [],
"CustomerCount": null,
"Partner": null,
"Notes": null,
"PaymentTerms": null,
"ServicePeriodStart": null,
"ServicePeriodEnd": null,
"PositionCount": 2,
"DocumentIssueType": null,
"Coupon": null,
"ServiceType": null,
"IsEcommerceTransaction": null,
"TaxPositions": null,
"FiscalDocumentNumber": 0,
"FiscalDocumentRevision": 0,
"FiscalDocumentStartTime": 0,
"Positions": [
{
"PositionNumber": 0,
"ItemCaption": "RENOXA KnowPal 15.6 Untel Lore Ultra- Z9 399J 32GB RAM 512GB SSD RTX 3060 W11P",
"ItemShortCaption": "RENOXA KnowPal",
"ItemSerialNumber": null,
"Type": 0,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "RKP156UZ9",
"ItemTaxType": 0,
"InHouse": true,
"ItemGroupId": "1000",
"ItemGroupCaption": "Notebooks",
"BusinessTransactionType": 0,
"CostPrice": 2979.90,
"BaseNetValue": 2483.25,
"BaseGrossValue": 2979.90,
"BaseTaxValue": 496.65,
"Discounts": [],
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": 2483.25,
"GrossValue": 2979.90,
"TaxValue": 496.65,
"AdditionalFields": {},
"ExternalIdentifier": []
},
{
"PositionNumber": 1,
"Caption": "Downpayment for Order",
"Type": 3,
"BusinessTransactionType": 7,
"PayOutType": null,
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": -1000.00,
"GrossValue": -1200.00,
"TaxValue": -200.00,
"AdditionalFields": {},
"ExternalIdentifier": []
}
],
"Payments": [
{
"Amount": 1779.90,
"CurrencyIsoCode": "EUR",
"Caption": "Bar",
"UniqueReadablePaymentIdentifier": "Cash",
"ForeignAmount": 0,
"ForeignAmountExchangeRate": 0,
"AdditionalFields": {},
"PaymentType": 0,
"CreateDate": null,
"VatIdentification": null,
"VatPercent": null,
"VatPercent2": null,
"TaxValue": null,
"TaxValue2": null,
"ExternalIdentifier": [],
"User": null,
"SalesPerson": null,
"PaymentTerminalReferenceId": null,
"CardData": null
}
],
"AdditionalHeader": [],
"AdditionalFooter": [],
"FiscalAdditionalFields": {}
}
Επιλογή 2 – Κατάθεση ως πληρωμή
Σε αυτή την παραλλαγή, η εισπραχθείσα κατάθεση εμφανίζεται ως στοιχείο πληρωμής στο payload.
Ιδιότητες συναλλαγής
Ο παρακάτω πίνακας δείχνει ποιες ιδιότητες πρέπει να οριστούν σε ποιες τιμές, προκειμένου να αντιστοιχιστεί σωστά η επιχειρηματική περίπτωση.
| Ιδιότητα | Τιμή | Περιγραφή |
| DocumentType | "0" ή "[0] = Απόδειξη" | να διεκπεραιωθεί μέσω απόδειξης εισπράξεως |
| Τύπος θέσεων | «0» ή «[0] = Είδος» | Για τη θέση είδους 0 (το είδος που παρήγγειλε ο πελάτης και για το οποίο έχει καταβληθεί προκαταβολή) |
| Θέσεις.BusinessTransactionType | «0» ή «[0] = Revenue» | Για τη θέση 0 (το προϊόν που παραγγέλθηκε από τον πελάτη και για το οποίο έχει καταβληθεί προκαταβολή) |
| Πληρωμές.Τύπος | «0» ή «Μετρητά» | Η ενότητα «Πληρωμές» περιλαμβάνει δύο στοιχεία: 1. Το υπόλοιπο ποσό που καταβλήθηκε σε μετρητά, και... |
| Τύπος πληρωμής | «6» αντίστοιχα «[6] = Προκαταβολή» |
... την εισπραχθείσα προκαταβολή (θετική!). Υπολογισμός: Θέση 0: 2.979,90 Σύνολο θέσεων: 2.979,90 Πληρωμές: 1.779,90 (Μετρητά) Πληρωμές: 1.200,00 (Κατάθεση) Σύνολο πληρωμών: 2.979,90 |
| Πληρωμές.VatPercent | Εάν, στη σχετική χώρα, ο Vat πρέπει να αναγράφεται ή να καταβάλλεται ήδη κατά την παραλαβή μιας προκαταβολής ή εγγύησης, ο Vat που έχει ήδη δηλωθεί πρέπει επίσης να προσδιορίζεται αναλόγως στο αντικείμενο «Πληρωμές»! | |
| Πληρωμές.TaxValue | Εάν, στη σχετική χώρα, ο Vat πρέπει να αναγράφεται ή να καταβάλλεται ήδη κατά την είσπραξη προκαταβολής ή εγγύησης, ο Vat που έχει ήδη δηλωθεί πρέπει επίσης να προσδιορίζεται αναλόγως στο αντικείμενο «Πληρωμές»! |
Παράδειγμα:
{
"ModelVersion": "1.7.0",
"UniqueClientId": "3e2c0cdf-e72c-43ea-a050-686eb0eb3853",
"UniqueCashRegisterId": null,
"ApplicationVersion": "1.0.0",
"ApplicationVersionId": null,
"ApplicationVersionPrevious": null,
"FiscalModuleVersion": "1.11.0.0",
"FiscalCountryModuleVersion": null,
"SoftwareName": "RetailForce neverPOS",
"RetailForceReceiptId": null,
"AdditionalFields": {},
"AutomaticVatCalculation": 0,
"AllowedVatDeviation": 0.01,
"PrintCount": null,
"TerminalSlaveId": null,
"FooterGraphicIndex": null,
"DocumentGuid": "026f0809-88b8-48c2-9e96-6f3ba37f48ff",
"DocumentId": "0026",
"CreateDate": "2026-06-10T14:39:08+02:00",
"BookDate": "2026-06-10T14:39:08+02:00",
"AccountingDate": "2026-06-10T14:39:08+02:00",
"DocumentNumber": "202500026",
"DocumentNumberSeries": "SI",
"CancellationDocument": false,
"FailedToPay": false,
"DocumentReference": null,
"IsTraining": false,
"TestCaseNumber": null,
"DocumentType": 0,
"DocumentTypeCaption": "POS-Receipt",
"User": {
"Id": "1",
"Caption": "User01",
"FirstName": "Joe",
"LastName": "Dowe",
"TaxNumber": null,
"DateOfEntry": "2025-09-23T15:11:08.6041978+02:00"
},
"SalesPerson": null,
"AllocationGroups": [],
"CustomerCount": null,
"Partner": null,
"Notes": null,
"PaymentTerms": null,
"ServicePeriodStart": null,
"ServicePeriodEnd": null,
"PositionCount": 1,
"DocumentIssueType": null,
"Coupon": null,
"ServiceType": null,
"IsEcommerceTransaction": null,
"TaxPositions": null,
"FiscalDocumentNumber": 0,
"FiscalDocumentRevision": 0,
"FiscalDocumentStartTime": 0,
"Positions": [
{
"PositionNumber": 0,
"ItemCaption": "RENOXA KnowPal 15.6 Untel Lore Ultra- Z9 399J 32GB RAM 512GB SSD RTX 3060 W11P",
"ItemShortCaption": "RENOXA KnowPal",
"ItemSerialNumber": null,
"Type": 0,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "RKP156UZ9",
"ItemTaxType": 0,
"InHouse": true,
"ItemGroupId": "1000",
"ItemGroupCaption": "Notebooks",
"BusinessTransactionType": 0,
"CostPrice": 2979.90,
"BaseNetValue": 2483.25,
"BaseGrossValue": 2979.90,
"BaseTaxValue": 496.65,
"Discounts": [],
"VatIdentification": 1,
"VatPercent": 20.0,
"NetValue": 2483.25,
"GrossValue": 2979.90,
"TaxValue": 496.65,
"AdditionalFields": {},
"ExternalIdentifier": []
}
],
"Payments": [
{
"Amount": 1779.90,
"CurrencyIsoCode": "EUR",
"Caption": "Bar",
"UniqueReadablePaymentIdentifier": "Cash",
"ForeignAmount": 0,
"ForeignAmountExchangeRate": 0,
"AdditionalFields": {},
"PaymentType": 0,
"CreateDate": null,
"VatIdentification": null,
"VatPercent": null,
"VatPercent2": null,
"TaxValue": null,
"TaxValue2": null,
"ExternalIdentifier": [],
"User": null,
"SalesPerson": null,
"PaymentTerminalReferenceId": null,
"CardData": null
},
{
"Amount": 1200.00,
"CurrencyIsoCode": "EUR",
"Caption": "Anzahlung",
"UniqueReadablePaymentIdentifier": "Deposit",
"ForeignAmount": 0,
"ForeignAmountExchangeRate": 0,
"AdditionalFields": {},
"PaymentType": 6,
"CreateDate": null,
"VatIdentification": 1,
"VatPercent": 20.0,
"VatPercent2": null,
"TaxValue": 200.00,
"TaxValue2": null,
"ExternalIdentifier": [],
"User": null,
"SalesPerson": null,
"PaymentTerminalReferenceId": null,
"CardData": null
}
],
"AdditionalHeader": [],
"AdditionalFooter": [],
"FiscalAdditionalFields": {}
}
Αυτό το άρθρο μεταφράστηκε αυτόματα.
Σχόλια
0 σχόλια
Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.