Przejdź do głównej zawartości

Obiekt pozycji „positions”

Harald Krondorfer
  • Zaktualizowano

Niniejszy artykuł dotyczy obiektu „positions” w ramach obiektu „Document” (obiekt Document).

Pełny opis modelu obiektowego dokumentu (RetailForce DOM) RetailForce, a także opis poszczególnych elementów, można znaleźć w sekcji plików do pobrania na stronie internetowej RetailForce (Object model documentation.pdf) w odpowiednim katalogu wersji.

Obiekt „positions” zawiera informacje dotyczące poszczególnych pozycji w dokumencie.

Obiekt pozycji składa się z:

  • DocumentPositionBase – zawiera podstawowe informacje o pozycji (niezależnie od typu danej pozycji)
  • Informacje specyficzne dla typu pozycji – w zależności od typu pozycji „type” (DocumentPositionType) należy określić różne treści (typ pozycji definiuje zawartość pozycji).

DocumentPositionsBase

Poniższy obiekt zawiera przykładowe dane.

  "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": {}
    }
  ],

Obiekt DocumentPositionsBase zawiera następujące informacje.

Informacje w kolumnie „Type”:

  • M … obowiązkowe / wymagane
  • M* ... obowiązkowe / wymagane w niektórych krajach lub pod pewnymi warunkami
  • R … zalecane
  • O... opcjonalne
Elementy Typ Opis
PositionNumber M

Numer porządkowy pozycji. 

Uwaga: Numer pierwszej pozycji to zawsze „0”!
positionReference O Odwołanie do innej pozycji w dokumencie. Odpowiada parametrowi documentReference.
  {...} O  
cancellationPosition M „true”, jeśli dana pozycja unieważnia pozycję z innego dokumentu; w przeciwnym razie „false”.
DeletedPosition O „true”, jeśli ta pozycja została usunięta; w przeciwnym razie „false”.
typ M

określa typ pozycji „type” (DocumentPositionType).

Enum: 

  • [0] = Element
  • [1] = Podelement
  • [2] = Tekst
  • [3] = Rezerwacja
  • [9] = Suma częściowa
  • [10] = Suma

Objaśnienia poszczególnych typów (DocumentPositionTypes) znajdują się poniżej tej tabeli.
AdditionalFields O  
  {...}    
CreateDate M Czas utworzenia pozycji.
ExternalIdentifier O ID zewnętrzny (z poprzedniego systemu), przeznaczony do użytku wewnętrznego, nieistotny dla celów rozliczeń podatkowych.
user O Dane użytkownika (kasy fiskalnej), który wprowadził daną pozycję.
  {...}    
SalesPerson O Szczegółowe informacje dotyczące pracownika sprzedaży na danym stanowisku.
  {...}    
FiscalAdditionalFields O  

 

DocumentPositionType

[0] = Pozycja

Typ „pozycja” (DocumentPositionItem) oznacza konkretną pozycję sprzedaży (towar lub usługa).

Przykładowy obiekt 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": {}
   }
],

Obiekt DocumentPositionItem zawiera następujące informacje.

Informacje w kolumnie „Typ”:

  • M … obowiązkowe / wymagane
  • M* ... obowiązkowe / wymagane w niektórych krajach lub pod pewnymi warunkami
  • R … zalecane
  • O... opcjonalne
Elementy Typ Opis
ItemCaption M Oznaczenie pozycji, opis usługi
ItemShortCaption O Skrótowa nazwa pozycji, stosowana np. w przypadku ograniczeń dotyczących długości ciągu znaków, takich jak w przypadku drukarek fiskalnych.
ItemSerialNumber M*

Numer seryjny pozycji.

Szczegóły dotyczące kraju:

  • Portugalia: Informacje obowiązkowe
rabaty   Szczegóły dotyczące rabatów, obniżek cen itp.
  DiscountValue M

Kwota rabatu / wysokość zniżki

Uwaga: jeśli DiscountType [1] = discount, kwotę rabatu należy podać z dokładnością do 4 miejsc po przecinku!
  caption R

Nazwa rabatu

Szczegóły dotyczące kraju:

  • Włochy: na paragonie jako nazwa rabatu drukowana jest pozycja „discounts.caption”
  DiscountOrder M*

Wskazuje kolejność, w jakiej obliczana jest zniżka. Pierwsza uwzględniona zniżka ma wartość 0.

Należy podać tę wartość, jeśli do danego produktu stosowanych jest wiele rabatów.
  typ M

Rodzaj rabatu

Enum:

  • [0] = Rabat – rabat sumaryczny
  • [1] = Rabat – rabat procentowy
  TypeValue M

Wartość rabatu (suma obniżki)

w przypadku [0] = Ulga: DiscountValue (=> DiscountValue = TypeValue)

w przypadku [1] = Rabat: wartość procentowa (np. 10% rabatu)
  PromotionKeys O Klucze promocyjne – jeśli są stosowane (np. kod kuponu)
  identyfikator O Dodatkowy identyfikator rabatu (może służyć np. do grupowania rabatów według typów).
typ M Typ pozycji (DocumentPositionType)
UseSubItemVatCalculation O „true”, jeśli obliczenie podatku Vat dla pozycji podrzędnych (SubItems) ma zostać przejęte, a podatek Vat pozycji nadrzędnej ma zostać pominięty; w przeciwnym razie „false”.
SubItems O Szczegóły dotyczące SubItems. Zob. DocumentPositionType [1] = SubItem
  [...]    
inhouse O Wskazuje, czy sprzedaż odbywa się wewnątrz firmy, czy poza nią (true / fałsz).
ItemGroupId M*

Wskaźnik grupy artykułów

Szczegóły dotyczące kraju:

  • Dania: informacja obowiązkowa („artGroupID” w formacie SAF-T)
ItemGroupCaption O Oznaczenie grupy artykułów
CostPrice O/M*

Cena jednostkowa artykułu

Szczegóły dotyczące kraju:

  • Dania: można ustawić jako cenę poszczególnych pozycji dla pozycji podrzędnych.
  • Portugalia: informacja obowiązkowa (jeśli nie zostanie podana, CostPrice oblicza się jako: BaseGrossValue / ilość)
itemDateOfEntry M*

Czas utworzenia artykułu.

Szczegóły dotyczące kraju:

  • Dania: informacje obowiązkowe („dateOfEntry” w formacie SAF-T). Pola te odzwierciedlają moment pierwszego utworzenia pozycji w systemie (utworzenie danych podstawowych). Jeśli informacja ta nie jest dostępna w systemie POS, należy zastosować następujące wartości: dateOfEntry: 0001-01-01, timeOfEntry: 00:00:00 oraz przesunięcie czasowe względem UTC: +00:00
    • "itemDateOfEntry": "0001-01-01T00:00:00+00:00"
ilość M Informacje dotyczące ilości dla danego artykułu
QuantityUnit M*

Określenie jednostki miary

Szczegóły dotyczące kraju:

  • Portugalia: Wymagane jest określenie jednostki miary („ID” lub „isoCode”)
  ID M*

Oznaczenie jednostki miary.

Szczegóły dotyczące kraju:

  • Rumunia: Informacje obowiązkowe
  isoCode

M*

 Standardowa jednostka miary zgodnie z kodem ISO/UCUM. Więcej informacji można znaleźć w artykule, do którego prowadzi link.
ItemId M ID artykułu
ItemType M*

Określa rodzaj pozycji: towary lub usługi.

  • [0] = Artykuł
  • [1] = Usługa

Szczegóły dotyczące kraju:

  • Francja: Informacje obowiązkowe
BaseNetValue M*

Suma netto (bez Vat) przed uwzględnieniem rabatu lub dopłaty

Uwaga: Suma (netto) pozycji, a NIE artykułu. Jeśli ilość wynosi 2, wówczas wartość BaseNetValue również wynosi cenę jednostkową pomnożoną przez 2!
BaseGrossValue M*

Suma brutto (z Vat) przed uwzględnieniem rabatu lub dopłaty

Uwaga: (Brutto) suma wiersza/pozycji, a NIE artykułu. Jeśli ilość wynosi 2, wówczas wartość BaseGrossValue również wynosi cenę jednostkową pomnożoną przez 2!
BaseTaxValue M*

Suma podatku Vat (lub suma pierwszej stawki podatkowej) przed uwzględnieniem rabatu lub dopłaty

Uwaga: (Vat) suma pozycji, a NIE artykułu. Jeśli ilość wynosi 2, wówczas BaseTaxValue również wynosi cenę jednostkową pomnożoną przez 2!

Szczegóły dotyczące kraju:

  • Québec (Kanada): Podatek federalny GST
BaseTaxValue2 M*

Suma drugiej stawki podatkowej pozycji przed uwzględnieniem rabatu/dopłaty.

Szczegóły dotyczące kraju:

  • Québec (Kanada): Podatek prowincjonalny QST
GTIN O

Globalny numer artykułu handlowego (GTIN)

Szczegóły dotyczące kraju:

  • Portugalia: Zaleca się podanie numeru GTIN dla danego artykułu. Alternatywnie w formacie SAF-T stosuje się właściwość „ItemId”.
BusinessTransactionType M

Rodzaj transakcji biznesowej.

Enum:

  • [0] = Revenue
  • [1] = Rabat
  • [2] = Kaucja za puste opakowania
  • [3] = KuponJednorazowy
  • [4] = MultiPurposeVoucher
  • [5] = Napiwek
  • [6] = Napiwek firmowy
  • [7] = Kaucja
  • [10] = Wypłata
  • [11] = PayIn
  • [90] = MoneyTransfer
  • [91] = Różnica gotówkowa
  • [92] = Potwierdzenie autentyczności
  • [93] = Przyznanie nierzeczywiste
ItemTypeClassification  

ItemTypeClassification można wykorzystać do zastosowania dalszej klasyfikacji danej pozycji.

Właściwość „ItemTypeClassification” można ustawić wyłącznie wtedy, gdy właściwość „ItemType” została ustawiona na „[0] – Artykuł” lub „ItemType”: 0.

Szczegółowe informacje na temat właściwości „ItemTypeClassification” można znaleźć w artykule, do którego prowadzi link.

Dostępne są następujące klasyfikacje.

  • [1] = Napójalkoholowy
  • [5] = Wyroby tytoniowe
  • [10] = Paliwo benzynowe
  • [11] = Paliwo etanolowe do pojazdów
  • [12] = Paliwo dieslowskie
  • [13] = Ester metylowy kwasów tłuszczowych
  • [14] = Paliwo dieslowskie przeznaczone do stosowania w rolnictwie i rybołówstwie
  • [15] = Gaz ziemny do celów transportowych
  • [16] = Skroplony gaz ropopochodny do celów transportowych
  • [17] = Paliwo transportowe niesklasyfikowane gdzie indziej

Szczegóły dotyczące kraju:

  • FiscalCountryProperties: Wymóg zdefiniowania ItemTypeClassification jest określony w fiscalCountryProperties za pomocą właściwości itemTypeClassificationRequired. Jeśli wartość wynosi „true”, pozycja musi zostać sklasyfikowana – pod warunkiem, że jest to pozycja specjalna (!). Właściwość supportedItemTypeClassification określa, dla jakiego typu produktu można ustawić tę właściwość.
VatIdentification M

ID stawki Vat.

Można uzyskać za pomocą żądania GET /api/v1/information/client/ {clientId}/getVatIdentification, podając stawkę Vat danego kraju. stawkę danego kraju.
VatPercent M

Stawka Vat w procentach lub pierwsza stawka podatkowa mająca zastosowanie do danego artykułu w danym kraju.

Szczegóły dotyczące krajów:

  • Québec (Kanada): Podatek federalny GST
VatPercent2 M*

druga stawka podatku mająca zastosowanie do danego artykułu, wyrażona w procentach w danym kraju.

Szczegóły dotyczące kraju:

  • Québec (Kanada): Podatek prowincjonalny QST
NetValue M

Wartość netto pozycji (pomniejszona o ewentualne rabaty / powiększona o dopłaty) – bez Vat.

Należy zawsze podać tę wartość.
GrossValue M

Suma brutto pozycji (pomniejszona o ewentualne rabaty / powiększona o ewentualne dopłaty) – z Vat.

Należy zawsze podawać.
TaxValue M

Suma Vat (lub suma według pierwszej stawki podatkowej) pozycji (pomniejszona o ewentualne rabaty / powiększona o ewentualne dopłaty)

Należy zawsze podać.

Informacje o kraju:

  • Québec (Kanada): Podatek federalny GST
TaxValue2 M*

Suma drugiej stawki podatkowej pozycji po uwzględnieniu rabatu / dopłaty.

Szczegóły dotyczące kraju:

  • Québec (Kanada): Podatek prowincjonalny QST
AccountingIdentifier O Dodatkowy identyfikator do celów księgowych (interfejs księgowy)
ItemTaxType M*

Rodzaj podatku dla pozycji:

  • dostawy
  • usługi

Szczegóły dotyczące kraju:

  • Hiszpania: Należy ustawić w przypadku wystawiania faktur dla klientów spoza Hiszpanii.
PositionNumber M Numer pozycji, zaczynający się od 0
positionReference O Określenie numeru pozycji, do której należy się odnieść
cancellationPosition O „true”, jeśli dana pozycja unieważnia pozycję z innego dokumentu; w przeciwnym razie „false”
CreateDate O Czas zarejestrowania pozycji

 

[1] = SubItem

„Podpozycje” (DocumentPositionSubItem) umożliwiają wyjaśnienie składu sprzedawanych produktów lub opisów grup produktów na poziomie poszczególnych pozycji.

Przykład: Menu = Coca-Cola i hamburger.

SubItems mają charakter wyjaśniający i nie ma obowiązku ich stosowania. Nie mają one również żadnego wpływu na cenę oraz sprzedaż i podatek od wartości dodanej.

Uwaga: pozycja „SubItem” odpowiada pozycji „Item”, ale nie zawiera elementów „UseSubItemVatCalculation” oraz „SubItems”.

 

[2] = Tekst

Służy do określenia położenia tekstu lub Barcode w dokumencie.

Przykład 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": {}
   }
],

Obiekt DocumentPositionText zawiera następujące informacje.

Informacje w kolumnie „Type”:

  • M ... obowiązkowe / wymagane
  • M* … obowiązkowe / wymagane w niektórych krajach lub pod pewnymi warunkami
  • R ... zalecane
  • O... opcjonalne
Elementy Typ Opis
typ M Typ pozycji (DocumentPositionType)
tekst O

Pole tekstowe

Szczegóły dotyczące kraju:

  • Włoskie drukarki EPSON: wysyłane do drukarki jako messageType="4" (Body Lines); maksymalnie 38 znaków na jedną pozycję tekstową. Po 25 znakach następuje automatyczny przełom linii. Tekst wielowierszowy należy podzielić na kilka pozycji. Alternatywnie można zastosować dodatkowe teksty header i Footer . Jeśli po 25 znakach nie nastąpił przełom wiersza, a tekst został zamiast tego skrócony, prosimy o kontakt z serwisantem drukarki (słowo kluczowe: „RT DESCR. OVERLAP”).
barcodeType O

Oznaczenie typu Barcode

Enum:

  • ean8
  • ean13
  • code128
kod kreskowy O Dane Barcode
PositionNumber M Numer pozycji, zaczynający się od 0

 

[3] = Rezerwacja

Pozycje rezerwacji (DocumentPositionBooking) są wykorzystywane w przypadku wpłat, wypłat oraz sprzedaży bonów wielofunkcyjnych (PayIn, payOut, MultiPurposeVoucher, ...).

Przykład obiektu 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": {}
   }
],

Obiekt DocumentPositionBooking zawiera następujące informacje.

Informacje w kolumnie „Typ”:

  • M ... obowiązkowe / wymagane
  • M* ... obowiązkowe / wymagane w niektórych krajach lub pod pewnymi warunkami
  • R ... zalecane
  • O... opcjonalne
Elementy Typ Opis
typ M Typ pozycji (DocumentPositionType)
caption M Opis pozycji księgowej
identyfikator O Dodatkowy wskaźnik ID księgowania
BusinessTransactionType M

Typ transakcji biznesowej.

Enum:

  • [0] = Revenue
  • [1] = Rabat
  • [2] = Kaucja za opakowania zwrotne
  • [3] = Kupon jednorazowy
  • [4] = MultiPurposeVoucher
  • [5] = Napiwek
  • [6] = Napiwek firmowy
  • [7] = Kaucja
  • [10] = Wypłata
  • [11] = PayIn
  • [90] = MoneyTransfer
  • [91] = Różnica gotówkowa
  • [92] = Potwierdzenie autentyczności
  • [93] = Przyznanie nierzeczywiste
PayOutType M*

Wskazuje rodzaj wypłaty. Wymagane w niektórych krajach.

Możliwe wartości:

  • [0] = CleaningMaterial
  • [1] = Artykuły biurowe
  • [2] = Opłata pocztowa
  • [3] = Wynagrodzenie
  • [4] = Wynagrodzenie
  • [5] = Zakup towarów
  • [6] = Inne koszty

Szczegóły dotyczące kraju:

  • Dania: Informacje obowiązkowe („reportPayOut” „PayOutType” w formacie SAF-T). Element typu ciąg znaków (string36) służący do określenia rodzaju wypłaty.
Uwaga: Nowość od wersji DOM v1.2.0 / Client v1.7.6
VatIdentification M

ID stawki Vat.

Można uzyskać za pomocą żądania GET /api/v1/information/client/ {clientId}/getVatIdentification, podając stawkę Vat odpowiedniego kraju.
VatPercent M Stawka Vat w procentach
NetValue M

Suma netto pozycji (po odliczeniu ewentualnych rabatów) – bez Vat.

Należy zawsze podać tę wartość.
GrossValue M

Suma brutto pozycji (pomniejszona o ewentualne rabaty) – z Vat.

Należy zawsze podać.
TaxValue M

Suma pozycji z uwzględnieniem podatku Vat (pomniejszona o ewentualne rabaty)

Należy zawsze podać.
AccountingIdentifier O Dodatkowy identyfikator do celów księgowych (interfejs księgowy)
ItemTaxType M*

Rodzaj podatku dla pozycji:

  • dostawy
  • usługi

Szczegóły dotyczące kraju:

  • Hiszpania: Należy ustawić w przypadku wystawiania faktur dla klientów spoza Hiszpanii.
PositionNumber M Numer pozycji, zaczynający się od 0
positionReference O Określenie numeru pozycji, do której należy się odnieść
cancellationPosition O „true”, jeśli dana pozycja unieważnia pozycję z innego dokumentu; w przeciwnym razie „false”.
DeletedPosition O „true”, jeśli ta pozycja została usunięta; w przeciwnym razie „false”.
CreateDate O Czas zarejestrowania pozycji

 

[9] = Suma częściowa

Pozycja „SubTotal”

Uwaga: Pozycja „Suma częściowa” odpowiada pozycji „Suma całkowita”.

 

[10] = Suma

Pozycja „Suma całkowita”. W przypadku stosowania pozycji „DocumentPositionTotal” musi ona zawsze stanowić ostatnią pozycję w dokumencie (najwyższy numer pozycji).

Przykład 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": {}
   }
],

Obiekt DocumentPositionTotal zawiera następujące informacje.

Informacje w kolumnie „Type”:

  • M … obowiązkowe / wymagane
  • M* ... obowiązkowe / wymagane w niektórych krajach lub pod pewnymi warunkami
  • R ... zalecane
  • O... opcjonalne
Elementy Typ Opis
typ M Typ pozycji (DocumentPositionType)
zaokrąglenie O

Zastosowano zaokrąglenie. Jeśli suma pozycji (wartość brutto) nie jest równa sumie płatności.

Np. wartość 0,01 pozwoliłaby na różnice w zaokrągleniu wynoszące +/-0,01

Uwaga: Prosimy o ostrożność podczas stosowania tej opcji. Wysokie wartości spowodują wyłączenie walidacji kwoty płatności / wartości brutto dokumentu
BaseValue M* Kwota bazowa pozycji przed zastosowaniem rabatów (tylko w przypadku stosowania rabatów)
value M Wartość pozycji z uwzględnieniem rabatów.
rabaty   Szczegóły dotyczące rabatów, obniżek cen itp.
  DiscountValue M

Suma rabatu / kwota zniżki

Uwaga: jeśli DiscountType [1] = discount, kwotę rabatu należy podać z dokładnością do 4 miejsc po przecinku!
  caption O Nazwa rabatu
  DiscountOrder M*

Wskazuje kolejność, w jakiej obliczana jest zniżka. Pierwsza uwzględniona zniżka ma wartość 0.

Należy podać tę wartość, jeśli do pozycji stosowanych jest wiele rabatów.
  typ M

Rodzaj rabatu

Enum:

  • [0] = Rabat sumaryczny
  • [1] = Rabat – rabat procentowy
  TypeValue M

Wartość rabatu (suma obniżki)

w przypadku [0] = ulga: DiscountValue

w przypadku [1] = Rabat: wartość procentowa (np. 10% rabatu)
  PromotionKeys O Klucze promocyjne – jeśli są stosowane (np. kod kuponu)
  identyfikator O Dodatkowy identyfikator rabatu (może być wykorzystywany np. do grupowania rabatów według typów).
caption O Oznaczenie pozycji
PositionNumber M Numer stanowiska, zaczynający się od 0
positionReference O Określenie numeru pozycji, do której należy się odnieść
cancellationPosition O „true”, jeśli dana pozycja unieważnia pozycję z innego dokumentu; w przeciwnym razie „false”.
DeletedPosition O „true”, jeśli ta pozycja została usunięta; w przeciwnym razie „false”.
CreateDate O Czas zarejestrowania pozycji

 

Ten artykuł został przetłumaczony automatycznie.

Powiązane artykuły

Komentarze

Komentarze: 0

Zaloguj się, aby dodać komentarz.

Oparte na technologii Zendesk