Αντικείμενο θέσεων «positions»

Το παρόν άρθρο ασχολείται με το αντικείμενο «positions» εντός του αντικειμένου «Document» (αντικείμενο «Document»).

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

Το αντικείμενο «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... προαιρετικό

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": "1"
      }
      "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... προαιρετικό

[1] = SubItem

Τα «υποστοιχεία» (DocumentPositionSubItem) παρέχουν τη δυνατότητα να εξηγηθεί η σύνθεση των πωληθέντων προϊόντων ή οι περιγραφές ομάδων προϊόντων σε επίπεδο στοιχείου.

Παράδειγμα: Μενού = Κόκα-Κόλα και χάμπουργκερ.

Τα 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... προαιρετικό

[3] = Κράτηση

Οι θέσεις κρατήσεων (DocumentPositionBooking) χρησιμοποιούνται για καταθέσεις, αναλήψεις καθώς και για πωλήσεις MultiPurposeVoucher (PayIn, payOut, MultiPurposeVoucher,...).

Παράδειγμα DocumentPositionBooking:

positions": [
   {
      "type": 3,
      "caption": "Depositg",
      "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... προαιρετικό

[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... προαιρετικό

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