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

Προκαταβολή για αγαθά και διαχείριση προκαταβολών

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

Τα παρακάτω παραδείγματα JSON δείχνουν πώς μπορεί να γίνει η διαχείριση της είσπραξης μιας προκαταβολής και η επακόλουθη επεξεργασία αυτής της προκαταβολής κατά την παράδοση ή την παροχή υπηρεσιών στο RetailForce. Σημειώστε ότι ο όρος που χρησιμοποιείται στο RetailForce για τις προκαταβολές είναι «deposit».

Σημειώστε ότι ορισμένες τιμές ιδιοτήτων που χρησιμοποιούνται στα παραδείγματα πρέπει να προσαρμοστούν, ώστε να μπορείτε να χρησιμοποιήσετε το payload στο σύστημά σας (π.χ. «uniqueClientId», «BookDate»). Τα παραδείγματα έχουν επίσης δημιουργηθεί για μια συγκεκριμένη χώρα, πράγμα που σημαίνει ότι πρέπει επίσης να προσαρμοστούν οι φορολογικοί συντελεστές, τα ακαθάριστα και καθαρά ποσά κ.λπ.

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 (το προϊόν που παρήγγειλε ο πελάτης και για το οποίο έχει καταβληθεί προκαταβολή)
Payments.Type «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 σχόλια

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

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