Το παρόν άρθρο ασχολείται με το αντικείμενο «positions» εντός του αντικειμένου «Document» (αντικείμενο «Document»).
Μια πλήρης περιγραφή του RetailForce DOM (Document Object Model), καθώς και μια περιγραφή των επιμέρους στοιχείων, μπορείτε να βρείτε στην περιοχή λήψεων του RetailForce website (Object model documentation.pdf) στον αντίστοιχο κατάλογο εκδόσεων.
Το αντικείμενο «positions» περιέχει πληροφορίες σχετικά με την αντίστοιχη θέση του εγγράφου.
Το αντικείμενο positions αποτελείται από:
- DocumentPositionBase - περιέχει βασικές πληροφορίες σχετικά με τη θέση (ανεξάρτητα από τον τύπο της εκάστοτε θέσης)
- Πληροφορίες συγκεκριμένες για τον τύπο θέσης - ανάλογα με τον τύπο θέσης «type» (DocumentPositionType), πρέπει να καθοριστούν διαφορετικά περιεχόμενα (ο τύπος θέσης καθορίζει το περιεχόμενο της θέσης).
DocumentPositionsBase
Το παρακάτω αντικείμενο περιέχει δείγματα δεδομένων.
"positions": [
{
"positionNumber": 0,
"positionReference": {
"positionNumber": 0,
"referenceType": "[0] = Cancellation",
"storeNumber": "string",
"terminalNumber": "string",
"documentType": "[0] = Receipt",
"documentNumber": "string",
"documentNumberSeries": "string",
"fiscalDocumentNumber": 0,
"documentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"documentId": "string",
"documentBookDate": "2023-05-03T11:20:40.057+01:00",
"returnReasonType": "userMistake",
"returnReasonText": "string"
},
"cancellationPosition": true,
"deletedPosition": false,
"type": "[0] = Item",
"additionalFields": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"createDate": "2023-05-03T11:20:40.057+01:00",
"externalIdentifier": [
"string"
],
"user": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"salesPerson": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"FiscalAdditionalFields": {}
}
],Το αντικείμενο DocumentPositionsBase περιέχει τις ακόλουθες πληροφορίες.
Πληροφορίες στη στήλη «Type»:
- M ... υποχρεωτικό / απαιτείται
- M* ... υποχρεωτικό / απαιτείται σε ορισμένες χώρες ή υπό ορισμένες προϋποθέσεις
- R ... συνιστάται
- O... προαιρετικό
| Στοιχεία | Τύπος | Περιγραφή | |
| PositionNumber | M |
Αριθμός σειράς της θέσης.
Προσοχή:
Ο αριθμός της πρώτης θέσης είναι πάντα «0»!
|
|
| positionReference | O | Αναφορά σε άλλη θέση εντός του εγγράφου. Ισοδύναμο με το documentReference. | |
| {...} | O | ||
| cancellationPosition | M | «true» εάν η θέση αυτή ακυρώνει μια θέση άλλου εγγράφου· διαφορετικά «false». | |
| DeletedPosition | O | "true" αν αυτή η θέση έχει διαγραφεί· διαφορετικά "false". | |
| τύπος | M |
καθορίζει τον τύπο θέσης "type" (DocumentPositionType). Enum:
Επεξηγήσεις για τους επιμέρους τύπους (DocumentPositionType) μπορείτε να βρείτε μετά από αυτόν τον πίνακα. |
|
| AdditionalFields | O | ||
| {...} | |||
| CreateDate | M | Χρόνος δημιουργίας της θέσης. | |
| εξωτερικός αναγνωριστικός κωδικός | O | Εξωτερικό ID (από το προηγούμενο σύστημα), για εσωτερικούς σκοπούς, χωρίς σημασία για τη φορολογική καταχώριση. | |
| user | O | Στοιχεία του χρήστη (του ταμειακού μηχανήματος) που καταχώρησε το αντίστοιχο είδος. | |
| {...} | |||
| SalesPerson | O | Λεπτομέρειες σχετικά με το μέλος του προσωπικού πωλήσεων της αντίστοιχης θέσης. | |
| {...} | |||
| FiscalAdditionalFields | O | ||
DocumentPositionType
[0] = Στοιχείο
Ο τύπος «στοιχείο» (DocumentPositionItem) είναι ένα συγκεκριμένο στοιχείο πώλησης (αγαθό ή υπηρεσία).
Παράδειγμα DocumentPositionItem:
positions": [
{
"itemCaption": "Prime rib steak house style",
"itemShortCaption": "PrimeRibSpec",
"itemSerialNumber": "string",
"discounts": [
{
"discountValue": 1.6900,
"caption": "Regular customer discount",
"discountOrder": 0,
"type": 1,
"typeValue": 10.00,
"promotionKeys": [],
"identifier": null
}
],
"type": 0,
"useSubItemVatCalculation": false,
"subItems": [],
"inHouse": true,
"itemGroupId": "1000",
"itemGroupCaption": "mains",
"costPrice": null,
"itemDateOfEntry": null,
"quantity": 1.0,
"quantityUnit": {
"id": null,
"isoCode": "Quantity"
},
"itemId": "1028",
"itemType": "[0] = Article",
"baseNetValue": 14.08,
"baseGrossValue": 16.90,
"baseTaxValue": 2.82,
"baseTaxValue2": 0,
"gtin": "8718274490558",
"businessTransactionType": 0,
"itemTypeClassification": "[1] = AlcoholicBeverage",
"vatIdentification": 1,
"vatPercent": 20.00,
"vatPercent2": 5,
"additionalTax": {
"additionalTaxType": "alcohol",
"additionalTaxTypeIdentification": "string",
"taxPercent": 0,
"taxValue": 0
},
"netValue": 12.68,
"grossValue": 15.21,
"taxValue": 2.53,
"taxValue2": 0,
"accountingIdentifier": null,
"itemTaxType": null,
"positionNumber": 0,
"positionReference": null,
"cancellationPosition": false,
"deletedPosition": false,
"additionalFields": {},
"createDate": null,
"externalIdentifier": [
"string"
],
"user": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"salesPerson": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"FiscalAdditionalFields": {}
}
],Το αντικείμενο DocumentPositionItem περιέχει τις ακόλουθες πληροφορίες.
Πληροφορίες στη στήλη «Τύπος»:
- M ... υποχρεωτικό / απαιτείται
- M* ... υποχρεωτικό / απαιτείται σε ορισμένες χώρες ή υπό ορισμένες προϋποθέσεις
- R ... συνιστάται
- O... προαιρετικό
| Στοιχεία | Τύπος | Περιγραφή | |
| ItemCaption | M |
Ονομασία στοιχείου, περιγραφή της υπηρεσίας Στοιχεία χώρας:
|
|
| ItemShortCaption | O | Συντομογραφία του στοιχείου, που χρησιμοποιείται π.χ. όταν υπάρχουν περιορισμοί στο μήκος των χαρακτήρων, όπως στις φορολογικές εκτυπωτικές συσκευές. | |
| ItemSerialNumber | M* |
Σειριακός αριθμός του στοιχείου. Λεπτομέρειες ανά χώρα:
|
|
| εκπτώσεις | Λεπτομέρειες σχετικά με εκπτώσεις, μειώσεις τιμών κ.λπ. | ||
| DiscountValue | M |
Ποσό έκπτωσης / ποσό επιστροφής
Προσοχή:
εάν DiscountType [1] = discount, το ποσό της έκπτωσης πρέπει να εισαχθεί με 4 δεκαδικά ψηφία!
|
|
| caption | R |
Ονομασία της έκπτωσης Λεπτομέρειες ανά χώρα:
|
|
| DiscountOrder | M* |
Υποδεικνύει τη σειρά με την οποία υπολογίζεται η έκπτωση. Η πρώτη έκπτωση που λαμβάνεται υπόψη έχει τιμή 0. Πρέπει να καθοριστεί εάν εφαρμόζονται πολλαπλές εκπτώσεις σε ένα είδος. |
|
| τύπος | M |
Τύπος έκπτωσης Enum:
|
|
| TypeValue | M |
Τιμή επιστροφής (άθροισμα της μείωσης) για [0] = Έκπτωση: η DiscountValue (=> DiscountValue = TypeValue) για [1] = Έκπτωση: το ποσοστό (π.χ. έκπτωση 10%) |
|
| PromotionKeys | O | Κλειδιά προσφοράς - εάν χρησιμοποιούνται (π.χ. κωδικός κουπονιού) | |
| αναγνωριστικό | O | Πρόσθετο αναγνωριστικό για την έκπτωση (μπορεί να χρησιμοποιηθεί π.χ. για την ομαδοποίηση εκπτώσεων σε τύπους εκπτώσεων). | |
| τύπος | M | Τύπος θέσεων (DocumentPositionType) | |
| UseSubItemVatCalculation | O | "true" εάν ο υπολογισμός του Vat των υπο-στοιχείων (SubItems) πρέπει να υιοθετηθεί και ο Vat του γονικού στοιχείου να αγνοηθεί· διαφορετικά "false". Προεπιλογή (εάν δεν αποσταλεί): «true». Όταν η τιμή είναι «true», κάθε υποστοιχείο πρέπει να διαθέτει VatIdentification και το άθροισμα των ακαθάριστων, καθαρών και φορολογικών αξιών των υποστοιχείων πρέπει να ισούται με τις τιμές BaseGrossValue, BaseNetValue και BaseTaxValue του γονικού στοιχείου· διαφορετικά, το έγγραφο απορρίπτεται. | |
| SubItems | O | Λεπτομέρειες για τα SubItems. Βλ.: DocumentPositionType [1] = SubItem | |
| [...] | |||
| inhouse | O | Υποδεικνύει εσωτερική πώληση ή εξωτερική πώληση (true / false). | |
| ItemGroupId | M* |
Δείκτης ομάδας ειδών Λεπτομέρειες χώρας:
|
|
| ItemGroupCaption | O |
Ονομασία ομάδας ειδών Λεπτομέρειες ανά χώρα:
|
|
| CostPrice | O/M* |
Τιμή μονάδας του είδους Λεπτομέρειες ανά χώρα:
|
|
| itemDateOfEntry | M* |
Χρόνος δημιουργίας του είδους. Λεπτομέρειες ανά χώρα:
|
|
| ποσότητα | M |
Πληροφορίες ποσότητας για το προϊόν Λεπτομέρειες ανά χώρα:
|
|
| QuantityUnit | M* |
Προδιαγραφή της μονάδας μέτρησης Λεπτομέρειες ανά χώρα:
|
|
| ID | M* |
Αναφορά της μονάδας μέτρησης. Λεπτομέρειες ανά χώρα:
|
|
| isoCode | M* |
Τυπική μονάδα μέτρησης, η οποία αποστέλλεται ως όνομα μιας τιμής QuantityUnitIsoCode (π.χ. «Quantity» για τεμάχια, «Kilogram»), και όχι ως ο ίδιος ο κωδικός ISO/UCUM. Η ενότητα μετατρέπει το όνομα στον κωδικό ISO/UCUM (π.χ. «Quantity» = «1»). Ένας αριθμός ερμηνεύεται ως η αριθμητική τιμή της enum, οπότε το «1» σημαίνει «Percent». Για περισσότερες πληροφορίες, ανατρέξτε στο σχετικό άρθρο. Λεπτομέρειες ανά χώρα:
|
|
| ItemId | M |
ID του είδους Στοιχεία χώρας:
|
|
| ItemType | M* |
Περιγράφει τον τύπο του στοιχείου: αγαθά ή υπηρεσίες.
Λεπτομέρειες χώρας:
|
|
| BaseNetValue | M* |
Καθαρό σύνολο (χωρίς Vat) πριν από την έκπτωση ή την επιβάρυνση
Προσοχή:
(Καθαρό) άθροισμα της γραμμής/θέσης, ΟΧΙ του είδους. Εάν η ποσότητα = 2, τότε το BaseNetValue είναι επίσης η τιμή μονάδας x 2!
|
|
| BaseGrossValue | M* |
Μικτό σύνολο (συμπεριλαμβανομένου του Vat) πριν από την έκπτωση ή την επιπλέον χρέωση
Προσοχή:
(Μικτό) άθροισμα της γραμμής/θέσης, ΟΧΙ του είδους. Εάν η ποσότητα = 2, τότε η BaseGrossValue είναι επίσης η τιμή του είδους x 2!
|
|
| BaseTaxValue | M* |
Σύνολο Vat (ή άθροισμα του πρώτου φορολογικού συντελεστή) πριν από την έκπτωση ή την επιπλέον χρέωση
Προσοχή:
(Vat) άθροισμα της γραμμής/θέσης, ΟΧΙ του είδους. Εάν η ποσότητα = 2, τότε η BaseTaxValue είναι επίσης η τιμή του είδους x 2!
Λεπτομέρειες χώρας:
|
|
| BaseTaxValue2 | M* |
Άθροισμα του δεύτερου φορολογικού συντελεστή της θέσης πριν από την έκπτωση/την επιπλέον χρέωση. Λεπτομέρειες χώρας:
|
|
| GTIN | O/R |
Παγκόσμιος αριθμός εμπορεύματος (GTIN) Λεπτομέρειες χώρας:
|
|
| BusinessTransactionType | M |
Είδος συναλλαγής. Enum:
|
|
| ItemTypeClassification | O/M* |
Η ItemTypeClassification μπορεί να χρησιμοποιηθεί για την εφαρμογή μιας περαιτέρω ταξινόμησης σε ένα στοιχείο. Η ItemTypeClassification μπορεί να οριστεί μόνο εάν η ιδιότητα «ItemType» έχει οριστεί σε «[0] - Άρθρο» ή «ItemType»: 0. Λεπτομερείς πληροφορίες σχετικά με την ιδιότητα «ItemTypeClassification» μπορείτε να βρείτε στο άρθρο που παρατίθεται στον σύνδεσμο. Διατίθενται οι ακόλουθες ταξινομήσεις.
Λεπτομέρειες χώρας:
|
|
| VatIdentification | M |
ID του συντελεστή ΦΠΑ. Μπορεί να αναζητηθεί μέσω GET /api/v1/information/client/ {clientId}/getVatIdentification, καθορίζοντας τον συντελεστή ΦΠΑ της αντίστοιχης χώρας. συντελεστή της αντίστοιχης χώρας. |
|
| VatPercent | M |
Συντελεστής Vat σε ποσοστό ή πρώτος φορολογικός συντελεστής που ισχύει για το προϊόν στην αντίστοιχη χώρα. Λεπτομέρειες χώρας:
|
|
| VatPercent2 | M* |
Δεύτερος φορολογικός συντελεστής που ισχύει για το προϊόν, εκφραζόμενος σε ποσοστό στην αντίστοιχη χώρα. Λεπτομέρειες χώρας:
|
|
| NetValue | M |
Καθαρό σύνολο της θέσης (μείον τυχόν εκπτώσεις / συν επιβαρύνσεις) - χωρίς Vat. Πρέπει πάντα να αναγράφεται. |
|
| GrossValue | M |
Μικτό σύνολο της θέσης (μείον τυχόν εκπτώσεις / συν επιπλέον χρεώσεις) – συμπεριλαμβανομένου του Vat. Πρέπει πάντα να αναγράφεται. |
|
| TaxValue | M |
Σύνολο Vat (ή άθροισμα του πρώτου φορολογικού συντελεστή) της θέσης (μείον τυχόν εκπτώσεις / συν επιβαρύνσεις) Πρέπει πάντα να αναγράφεται. Στοιχεία χώρας:
|
|
| TaxValue2 | M* |
Άθροισμα του δεύτερου φορολογικού συντελεστή του είδους μετά την έκπτωση/την επιβάρυνση. Λεπτομέρειες χώρας:
|
|
| AccountingIdentifier | O | Πρόσθετος αναγνωριστικός κωδικός για λογιστικούς σκοπούς (λογιστική διεπαφή) | |
| ItemTaxType | M* |
Τύπος φόρου της θέσης:
Λεπτομέρειες χώρας:
|
|
| PositionNumber | M | Αριθμός θέσης, ξεκινώντας από το 0 | |
| positionReference | O | Προδιαγραφή ενός αριθμού θέσης στην οποία πρέπει να γίνει αναφορά | |
| cancellationPosition | O/M* | «true» εάν η θέση αυτή ακυρώνει μια θέση άλλου εγγράφου· διαφορετικά «false» | |
| CreateDate | O | Χρόνος καταχώρισης της θέσης | |
[1] = Υποστοιχείο
Τα «υποστοιχεία» (DocumentPositionSubItem) παρέχουν τη δυνατότητα να εξηγηθεί η σύνθεση των πωληθέντων προϊόντων ή οι περιγραφές ομάδων προϊόντων σε επίπεδο στοιχείου.
Παράδειγμα: Μενού = Κόκα-Κόλα και χάμπουργκερ.
Δεν είναι υποχρεωτική η χρήση των SubItems. Εάν το γονικό στοιχείο έχει την τιμή «UseSubItemVatCalculation»: true (η προεπιλογή), χρησιμοποιείται ο Vat των SubItems αντί του Vat του γονικού στοιχείου και οι τιμές τους πρέπει να αθροίζονται στις βασικές τιμές του γονικού στοιχείου. Με την τιμή «UseSubItemVatCalculation»: false, ισχύει ο Vat του γονικού στοιχείου και τα SubItems εξηγούν μόνο τη σύνθεση του στοιχείου.
[2] = Κείμενο
Χρησιμοποιείται για τη μετατροπή της θέσης ενός κειμένου ή ενός Barcode εντός του εγγράφου.
Παράδειγμα DocumentPositionText:
positions": [
{
"type": 2,
"text": "Example text",
"barcodeType": code128,
"barcode": "Example text",
"positionNumber": 0,
"positionReference": null,
"cancellationPosition": false,
"deletedPosition": false,
"additionalFields": {},
"createDate": null,
"externalIdentifier": [
"string"
],
"user": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"salesPerson": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"FiscalAdditionalFields": {}
}
],Το αντικείμενο DocumentPositionText περιέχει τις ακόλουθες πληροφορίες.
Πληροφορίες στη στήλη «Type»:
- M ... υποχρεωτικό / απαιτείται
- M* ... υποχρεωτικό / απαιτείται σε ορισμένες χώρες ή υπό ορισμένες συνθήκες
- R ... συνιστάται
- O... προαιρετικό
| Στοιχεία | Τύπος | Περιγραφή | |
| τύπος | M | Τύπος θέσεων (DocumentPositionType) | |
| κείμενο | O |
Πεδίο ελεύθερου κειμένου Λεπτομέρειες χώρας:
|
|
| barcodeType | O |
Ένδειξη τύπου Barcode Enum:
|
|
| Barcode | O | Δεδομένα Barcode | |
| PositionNumber | M | Αριθμός θέσης, ξεκινώντας από το 0 | |
[3] = Κράτηση
Οι θέσεις κρατήσεων (DocumentPositionBooking) χρησιμοποιούνται για καταθέσεις, αναλήψεις καθώς και για πωλήσεις MultiPurposeVouchers (PayIn, payOut, MultiPurposeVoucher,...).
Παράδειγμα DocumentPositionBooking:
positions": [
{
"type": 3,
"caption": "Deposit",
"identifier": null,
"businessTransactionType": 11,
"payOutType": null,
"vatIdentification": 4,
"vatPercent": 0.00,
"netValue": 20.00,
"grossValue": 20.00,
"taxValue": 0.00,
"accountingIdentifier": null,
"itemTaxType": null,
"positionNumber": 0,
"positionReference": null,
"cancellationPosition": false,
"deletedPosition": false,
"additionalFields": {},
"createDate": null,
"externalIdentifier": [
"string"
],
"user": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"salesPerson": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"FiscalAdditionalFields": {}
}
],Το αντικείμενο DocumentPositionBooking περιέχει τις ακόλουθες πληροφορίες.
Πληροφορίες στη στήλη «Τύπος»:
- M ... υποχρεωτικό / απαιτείται
- M* ... υποχρεωτικό / απαιτείται σε ορισμένες χώρες ή υπό ορισμένες προϋποθέσεις
- R ... συνιστάται
- O... προαιρετικό
| Στοιχεία | Τύπος | Περιγραφή | |
| τύπος | M | Τύπος θέσεων (DocumentPositionType) | |
| caption | M | Περιγραφή της θέσης κράτησης | |
| αναγνωριστικό | O | Δείκτης πρόσθετου ID της εγγραφής | |
| BusinessTransactionType | M |
Τύπος επιχειρηματικής συναλλαγής. Enum:
|
|
| PayOutType | M* |
Υποδεικνύει τον τύπο της πληρωμής. Απαιτείται σε ορισμένες χώρες. Πιθανές τιμές:
Λεπτομέρειες χώρας:
Σημείωση:
Νέο από την έκδοση DOM v1.2.0 / Client v1.7.6
|
|
| VatIdentification | M |
ID συντελεστή ΦΠΑ. Μπορεί να αναζητηθεί μέσω GET /api/v1/information/client/ {clientId}/getVatIdentification, καθορίζοντας τον συντελεστή ΦΠΑ της αντίστοιχης χώρας. |
|
| VatPercent | M | Συντελεστής Vat σε ποσοστό | |
| NetValue | M |
Καθαρό σύνολο της θέσης (μείον τυχόν εκπτώσεις) - χωρίς Vat. Πρέπει πάντα να αναγράφεται. |
|
| GrossValue | M |
Μικτό σύνολο της θέσης (μείον τυχόν εκπτώσεις) – συμπεριλαμβανομένου του Vat. Πρέπει πάντα να αναγράφεται. |
|
| TaxValue | M |
Σύνολο Vat της θέσης (μείον τυχόν εκπτώσεις) Πρέπει πάντα να αναγράφεται. |
|
| AccountingIdentifier | O | Πρόσθετο αναγνωριστικό για λογιστικούς σκοπούς (λογιστική διεπαφή) | |
| ItemTaxType | M* |
Τύπος φόρου της θέσης:
Λεπτομέρειες χώρας:
|
|
| PositionNumber | M | Αριθμός θέσης, ξεκινώντας από το 0 | |
| positionReference | O | Προδιαγραφή ενός αριθμού στοιχείου στο οποίο πρέπει να γίνει αναφορά | |
| cancellationPosition | O | «true» εάν η θέση αυτή ακυρώνει μια θέση άλλου εγγράφου· διαφορετικά «false». | |
| DeletedPosition | O | "true" αν αυτή η θέση έχει διαγραφεί· διαφορετικά "false". | |
| CreateDate | O | Χρόνος καταγραφής της θέσης | |
[9] = Υποσύνολο
Θέση «SubTotal»
[10] = Σύνολο
Θέση «Σύνολο». Εάν χρησιμοποιείται η θέση DocumentPositionTotal, πρέπει πάντα να είναι η τελευταία θέση στο έγγραφο (ο μεγαλύτερος αριθμός θέσης).
Παράδειγμα DocumentPositionTotal:
positions": [
{
"type": 10,
"rounding": null,
"baseValue": 200.00,
"value": "200.00",
"discounts": [
{
"discountValue": 1.6900,
"caption": "Regulars discount",
"discountOrder": 0,
"type": 1,
"typeValue": 10.00,
"promotionKeys": [],
"identifier": null
}
],
"caption": "Total",
"positionNumber": 0,
"positionReference": null,
"cancellationPosition": false,
"deletedPosition": false,
"additionalFields": {},
"createDate": null,
"externalIdentifier": [
"string"
],
"user": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"salesPerson": {
"id": "string",
"caption": "string",
"firstName": "string",
"lastName": "string",
"taxNumber": "string"
},
"FiscalAdditionalFields": {}
}
],Το αντικείμενο DocumentPositionTotal περιέχει τις ακόλουθες πληροφορίες.
Πληροφορίες στη στήλη «Type»:
- M ... υποχρεωτικό / απαιτείται
- M* ... υποχρεωτικό / απαιτείται σε ορισμένες χώρες ή υπό ορισμένες προϋποθέσεις
- R ... συνιστάται
- O... προαιρετικό
| Στοιχεία | Τύπος | Περιγραφή | |
| τύπος | M | Τύπος θέσεων (DocumentPositionType) | |
| στρογγυλοποίηση | O |
Εφαρμόζεται στρογγυλοποίηση. Εάν το άθροισμα των θέσεων (ακαθάριστη αξία) δεν ισούται με το άθροισμα των πληρωμών. Η στρογγυλοποίηση προστίθεται στο άθροισμα των ακαθάριστων αξιών των θέσεων στοιχείου και καταχώρησης, και το άθροισμα των πληρωμών πρέπει να ισούται ακριβώς με το αποτέλεσμα. Πρόκειται για ποσό με πρόσημο, όχι για ανοχή: π.χ. -0,02 σημαίνει ότι οι πληρωμές είναι 0,02 χαμηλότερες από το ακαθάριστο άθροισμα των θέσεων, ενώ 0,01 σημαίνει ότι είναι ακριβώς 0,01 υψηλότερες. Σημείωση: Παρακαλούμε να το χρησιμοποιείτε με προσοχή. Εάν οι πληρωμές και οι θέσεις δεν διαφέρουν ακριβώς κατά αυτή την τιμή, το έγγραφο απορρίπτεται. |
|
| BaseValue | M* | Βασικό ποσό της θέσης πριν από την εφαρμογή εκπτώσεων (μόνο εάν εφαρμόζονται εκπτώσεις) | |
| value | M | Η αξία της θέσης συμπεριλαμβανομένων των εκπτώσεων. | |
| εκπτώσεις | Λεπτομέρειες σχετικά με εκπτώσεις, μειώσεις τιμών κ.λπ. | ||
| DiscountValue | M |
Ποσό έκπτωσης / ποσό επιστροφής
Προσοχή:
εάν DiscountType [1] = discount, το ποσό της έκπτωσης πρέπει να εισαχθεί με 4 δεκαδικά ψηφία!
|
|
| caption | O | Ονομασία της έκπτωσης | |
| DiscountOrder | M* |
Υποδεικνύει τη σειρά με την οποία υπολογίζεται η έκπτωση. Η πρώτη έκπτωση που λαμβάνεται υπόψη έχει τιμή 0. Πρέπει να καθοριστεί εάν εφαρμόζονται πολλαπλές εκπτώσεις σε ένα είδος. |
|
| τύπος | M |
Τύπος έκπτωσης Enum:
|
|
| TypeValue | M |
Τιμή επιστροφής (άθροισμα της μείωσης) για [0] = Εκπτωτικό όριο: το DiscountValue για [1] = Έκπτωση: το ποσοστό (π.χ. έκπτωση 10%) |
|
| PromotionKeys | O | Κωδικοί προσφοράς - εάν χρησιμοποιούνται (π.χ. κωδικός κουπονιού) | |
| αναγνωριστικό | O | Πρόσθετος αναγνωριστικός κωδικός για την έκπτωση (μπορεί να χρησιμοποιηθεί π.χ. για την ομαδοποίηση εκπτώσεων σε τύπους εκπτώσεων). | |
| caption | O | Η ονομασία της θέσης | |
| PositionNumber | M | Αριθμός θέσης, ξεκινώντας από το 0 | |
| positionReference | O | Προσδιορισμός ενός αριθμού θέσης στην οποία πρέπει να γίνει αναφορά | |
| cancellationPosition | O | «true» εάν η θέση αυτή ακυρώνει μια θέση άλλου εγγράφου· διαφορετικά «false». | |
| DeletedPosition | O | "true" αν αυτή η θέση έχει διαγραφεί· διαφορετικά "false". | |
| CreateDate | O | Χρόνος καταγραφής της θέσης | |
Αυτό το άρθρο μεταφράστηκε αυτόματα.
Σχόλια
0 σχόλια
Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.