Αντικείμενο πληρωμής «payments» – RetailForce

Το παρόν άρθρο αφορά το αντικείμενο «Payment» («payments») εντός του αντικειμένου «Document».

Μια πλήρης περιγραφή του RetailForce DOM (Document Object Model), καθώς και μια περιγραφή των επιμέρους στοιχείων, μπορείτε να βρείτε στην ενότητα «Λήψεις» του RetailForce website (Object model documentation.pdf) στον αντίστοιχο κατάλογο εκδόσεων.

Το αντικείμενο «πληρωμή» μπορεί φυσικά να περιέχει διάφορες πληρωμές (= διαφορετικά μέσα πληρωμής – PaymentType) για ένα μόνο παραστατικό.

Αντικείμενο πληρωμών

Το παρακάτω αντικείμενο πληρωμής περιέχει δείγματα δεδομένων.

"payments": [
    {
      "amount": 120.00,
      "currencyIsoCode": "EUR",
      "caption": "BAR",
      "uniqueReadablePaymentIdentifier": "BARZAHLUNG",
      "foreignAmount": 0,
      "foreignAmountExchangeRate": 0,
      "additionalFields": {
        "voucherId": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      },
      "paymentType": "cash",
      "createDate": "2023-04-25T15:08:11.57+01:00",
      "vatIdentification": 1,
      "vatPercent": 20,
      "vatPercent2": 10,
      "taxValue": 20.00,
      "taxValue2": 10.00,
      "externalIdentifier": [
        "string"
      ],
      "user": {
        "id": "user01",
        "caption": "user01",
        "firstName": "Manuela",
        "lastName": "Musterfrau",
        "taxNumber": "123456789"
      },
      "salesPerson": {
        "id": "VK01",
        "caption": "Franz",
        "firstName": "Franz",
        "lastName": "Österreicher",
        "taxNumber": "234567890"
      },
      "paymentTerminalReferenceId": "string",
      "cardData": {
        "receiptCopyCount": 2,
        "receipt": ["line1", "line2"],
        "cardNumberMasked": "****1234",
        "identificationToken": "token123",
        "merchantCopyCount": 1,
        "merchantReceipt": ["merchant line1"],
        "cardType": "VISA",
        "authorizationCode": "AUTH123",
        "terminalId": "TERM001",
        "merchantId": "MERCH001",
        "transactionId": "TRX123456",
        "providerSignature": "signature_string",
        "providerTransactionId": "PROV_TRX_001",
        "providerSignatureMessage": "signature_message",
        "transactionDate": "2023-04-25T15:08:11.57+01:00",
        "transactionNumber": "12345"
      }
    }
  ],

Το παρακάτω αντικείμενο «πληρωμές» περιέχει δείγματα δεδομένων.

Πληροφορίες στη στήλη «Type»:

M ... υποχρεωτικό / απαιτείται
M* ... υποχρεωτικό / απαιτείται σε ορισμένες χώρες ή υπό ορισμένες προϋποθέσεις
R ... συνιστάται
O... προαιρετικό

Στοιχεία		Τύπος	Περιγραφή
Ποσότητα		M	Σύνολο της θέσης πληρωμής
CurrencyIsoCode		M	Κωδικός νομίσματος ISO 4217
caption		M	Ονομασία της μεθόδου πληρωμής / μέσου πληρωμής
UniqueReadablePaymentIdentifier		M	(αυθαίρετο) μοναδικό αναγνωριστικό του τύπου πληρωμής. Παραδείγματα: «μετρητά», «πληρωμή με μετρητά», «VISA», «μετρητά-EUR»,... Προσοχή: δεν είναι δυνατή η χρήση 2 διαφορετικών συντομογραφιών νομισμάτων για τον ίδιο μοναδικό αναγνώσιμο αναγνωριστικό πληρωμής (UniqueReadablePaymentIdentifier) εντός ενός ημερήσιου απολογισμού (αναφορά Z)! Εάν χρησιμοποιούνται πολλά νομίσματα, πρέπει να χρησιμοποιείται ένας μοναδικός αναγνώσιμος αναγνωριστικός πληρωμής (UniqueReadablePaymentIdentifier) για κάθε νόμισμα. Π.χ. «CashEUR», «CashUSD», «CashDKK», «πληρωμή με μετρητά EUR»,...
ForeignAmount		O	Σύνολο εάν η πληρωμή πραγματοποιείται σε ξένο νόμισμα
ForeignAmountExchangeRate		O	Συναλλαγματική ισοτιμία ξένου νομίσματος
AdditionalFields		M*
	VoucherId	M*	Τύποι: MultiPurposeVoucher, SinglePurposeVoucher. Προσοχή: `VoucherId` πρέπει να είναι ενσωματωμένο κάτω από το `AdditionalFields` αντικείμενο.
	additionalProp1-x	M*
PaymentType		M	Τρόπος πληρωμής / Μέσο πληρωμής
~~IsCash~~		-	Το στοιχείο "IsCash" δεν υποστηρίζεται πλέον από την 1η Μαρτίου 2023. Ο τύπος πληρωμής ορίζεται από το στοιχείο PaymentType. Προσοχή: Η ιδιότητα «IsCash» έχει καταργηθεί από την έκδοση 1.7.6 του Fiscal Client!
CreateDate		O	Ημερομηνία δημιουργίας του τύπου πληρωμής (εάν υπάρχει)
VatIdentification		M*	Αναγνωριστικό κατηγορίας Vat (σύμφωνα με την εκχώρηση RF), βλ.: GET /api/v1/information/client/ {clientId}/getVatIdentification Προσοχή: Για ορισμένους τύπους πληρωμών, πρέπει να παρέχονται πληροφορίες σχετικά με τον Vat. Για παράδειγμα, για προκαταβολές (εγγύηση), κουπόνια,... Σας συνιστούμε να συμπεριλαμβάνετε πάντα τα στοιχεία Vat.
VatPercent		M*	Ποσοστό Vat / συντελεστής
VatPercent2		O	Δεύτερο ποσοστό Vat / συντελεστής (για πληρωμές μεικτού συντελεστή Vat)
TaxValue		M*	Ποσό Vat
TaxValue2		O	Δεύτερο ποσό Vat (για πληρωμές με μικτό συντελεστή Vat)
εξωτερικός αναγνωριστικός κωδικός		O
user		O/M*	Στοιχεία του χρήστη του ταμειακού μηχανήματος (μπορούν να προσδιοριστούν εάν διαφέρουν από τα στοιχεία στο header του εγγράφου ή στις γραμμές του εγγράφου).
	ID	O/M*	ID του χρήστη του ταμειακού μηχανήματος
	caption	O/M*	Ονομασία χρήστη του ταμειακού μηχανήματος
	firstName	O	Όνομα του χρήστη του ταμειακού μηχανήματος
	lastName	O	Επώνυμο του χρήστη του ταμείου
	taxNumber	O/M*	Αριθμός φορολογικού μητρώου του χρήστη του ταμειακού μηχανήματος Στοιχεία χώρας: σε ορισμένες χώρες (π.χ. Σλοβενία), πρέπει να αναγράφεται ο αριθμός φορολογικού μητρώου του ταμία.
SalesPerson		O/M*	Στοιχεία του SalesPerson (μπορούν να αναφερθούν εάν διαφέρουν από τα στοιχεία στο header του εγγράφου ή στα μεμονωμένα στοιχεία)
	ID	O/M*	ID του πωλητή
	caption	O/M*	Τίτλος του SalesPerson
	firstName	O	Όνομα του SalesPerson
	lastName	O	Επώνυμο του SalesPerson
	taxNumber	O/M*	Αριθμός φορολογικού μητρώου του SalesPerson Στοιχεία χώρας: σε ορισμένες χώρες (π.χ. Σλοβενία), πρέπει να αναγράφεται ο αριθμός φορολογικού μητρώου του ταμία.
PaymentTerminalReferenceId		O/M*	ID συναλλαγής που επιστρέφεται από τον terminal πληρωμών (εάν ο terminal πληρωμών είναι ενσωματωμένος στο σύστημα POS και το ID συναλλαγής πρέπει να εκτυπωθεί στο έγγραφο). Λεπτομέρειες ανά χώρα: Δανία: το PaymentTerminalReferenceId πρέπει να περιλαμβάνεται στο αίτημα σε περίπτωση πληρωμών με κάρτα. Περισσότερες πληροφορίες μπορείτε να βρείτε στο σημείο 7 των απαιτήσεων για τα ταμεία στη Δανία .
cardData		O	Οι αποδείξεις από τερματικά πιστωτικών καρτών (χωρίς δική τους λειτουργία εκτύπωσης) μπορούν να ενσωματωθούν σε μια απόδειξη μέσω του cardData. Σε χώρες όπου χρησιμοποιούνται «φορολογικοί εκτυπωτές» (= το RetailForce system ελέγχει την εκτύπωση των εγγράφων), οι πληροφορίες που περιλαμβάνονται στην περιοχή cardData εκτυπώνονται ως γραμμές ελεύθερου κειμένου μετά τη φορολογική απόδειξη. Δεν υπάρχει διαχωρισμός μεταξύ των δύο τμημάτων. Λεπτομέρειες ανά χώρα: Ελλάδα: Απαιτούνται πρόσθετα πεδία για την επεξεργασία ηλεκτρονικών πληρωμών στην Ελλάδα, συμπεριλαμβανομένων των ProviderSignature, ProviderTransactionId και ProviderSignatureMessage, για συμμόρφωση με τους τοπικούς κανονισμούς.
	ReceiptCopyCount	O	Αριθμός αντιγράφων απόδειξης
	απόδειξη	O	Πίνακας γραμμών κειμένου απόδειξης
	CardNumberMasked	O	Αριθμός κάρτας με μάσκα για λόγους ασφαλείας (π.χ., ****1234)
	IdentificationToken	O	Μοναδικό διακριτικό αναγνώρισης για τη συναλλαγή
	MerchantCopyCount	O	Αριθμός αντιγράφων της απόδειξης του εμπόρου
	MerchantReceipt	O	Πίνακας γραμμών κειμένου της απόδειξης εμπόρου
	CardType	O	Ο τύπος κάρτας της συναλλαγής πληρωμής (π.χ. VISA, MASTERCARD κ.λπ.)
	AuthorizationCode	O	Ο κωδικός εξουσιοδότησης για την πληρωμή
	terminalId	O	Το ID του τερματικού για την πληρωμή
	MerchantId	O	Το ID (από τον αποκτώντα) του εμπόρου
	transactionId	O	Μοναδικό ID για τη συναλλαγή
	υπογραφή_παρόχου	O/M*	Η υπογραφή του παρόχου πληρωμών για τη διαδικασία πληρωμής στην Ελλάδα
	ProviderTransactionId	O/M*	Το transactionId του παρόχου πληρωμών για τη διαδικασία πληρωμής στην Ελλάδα
	ProviderSignatureMessage	O/M*	Το μήνυμα υπογραφής του παρόχου πληρωμών για τη διαδικασία πληρωμής στην Ελλάδα
	TransactionDate	O	Η ημερομηνία της συναλλαγής πληρωμής
	TransactionNumber	O	Ο αριθμός συναλλαγής της ηλεκτρονικής πληρωμής

Σημείωση: Από την 1η Μαρτίου 2023, το πεδίο «IsCash» έχει καταργηθεί από το μοντέλο αντικειμένων. Μπορεί ακόμα να μεταδοθεί, αλλά δεν ενεργοποιεί πλέον καμία λειτουργία. Οι τύποι πληρωμών ελέγχονται μέσω του πεδίου «PaymentType».

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

Αντικείμενο πληρωμών

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