Ovaj članak bavi se objektom positions unutar objekta Document (objekt dokumenta).
Potpuni opis RetailForce DOM-a (modela objekata dokumenta), kao i opis pojedinih elemenata, možete pronaći u odjeljku za preuzimanje na web-stranici RetailForce (Object model documentation.pdf) u odgovarajućem direktoriju verzija.
Objekt "positions" sadrži informacije o odgovarajućoj poziciji dokumenta.
Objekt pozicije sastoji se od:
- DocumentPositionBase - sadrži osnovne informacije o položaju (neovisno o vrsti dotičnog položaja)
- Informacije specifične za tip položaja - ovisno o tipu položaja "type" (DocumentPositionType), moraju se navesti različiti sadržaji (tip položaja definira sadržaj položaja).
DocumentPositionsBase
Sljedeći objekt sadrži primjerno podatke.
"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": {}
}
],Objekt DocumentPositionsBase sadrži sljedeće informacije.
Informacije u stupcu "Type":
- M ... obavezno / potrebno
- M* ... obavezno / potrebno u određenim zemljama ili pod određenim uvjetima
- R ... preporučeno
- O... opcionalno
| Elementi | Tip | Opis | |
| brojpozicije | M |
Redni broj položaja.
Pažnja:
Broj prve pozicije je uvijek "0"!
|
|
| pozicijskiReferentMRedni broj pozicije.Obratite pažnju: Broj prve pozicije je uvijek | O | Referenca na drugu poziciju unutar dokumenta. Ekvivalentno documentReference. | |
| {...} | O | ||
| pozicija otkazivanja | M | "true" ako ova pozicija poništava poziciju drugog dokumenta; inače "false". | |
| izbrisanaPozicija | Opozicija otkazivanjaM"true" ako ova pozicija otkazuje poziciju | "true" ako je ova pozicija izbrisana; inače "false". | |
| vrsta | M |
određuje tip položaja "type" (DocumentPositionType). Enum:
Objašnjenja pojedinačnih tipova (DocumentPositionTypes) nalaze se nakon ove tablice. |
|
| dodatnaPolja | O | ||
| {...} | |||
| datumIzrade | M | Vrijeme kada je pozicija stvorena. | |
| externalIdentifier | O | Vanjski identifikator (iz prethodnog sustava), za interne svrhe, nije relevantan za fiskalizaciju. | |
| korisnik | O | Podaci o korisniku (blagajne) koji je unio odgovarajuću stavku. | |
| {...} | |||
| prodavač | O | Podaci o prodajnom osoblju na odgovarajućoj poziciji. | |
| {...} | |||
| Dodatna fiskalna polja | O | ||
Tip položaja dokumenta
[0] = stavka
Tip "item" (DocumentPositionItem) je specifična prodajna stavka (roba ili usluga).
Primjer 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": {}
}
],Objekt DocumentPositionItem sadrži sljedeće informacije.
Informacije u stupcu "Tip":
- M ... obavezno / potrebno
- M* ... obavezno / potrebno u određenim zemljama ili pod određenim uvjetima
- R ... preporučeno
- O... opcionalno
| Elementi | Tip | Opis | |
| oznakopis | M | Naziv članka, opis usluge | |
| Kratki opis stavke | O | Kratki naziv stavke, koji se koristi npr. kada postoje ograničenja duljine karaktera, kao kod fiskalnih pisača. | |
| Serijski broj stavke | M* |
Serijski broj stavke. Podaci o zemlji:
|
|
| popusti | Detalji o popustima, sniženjima cijena itd. | ||
| vrijednostpopusta | M |
Iznos popusta / iznos rabata
Pažnja:
ako je discountType [1] = discount, iznos popusta mora biti unesen s 4 decimalne znamenke!
|
|
| natpis | R |
Naziv popusta Podaci o zemlji:
|
|
| discountOrder | M* |
Označava redoslijed u kojem se popust izračunava. Prvi popust koji se uzima u obzir ima vrijednost 0. Mora biti navedeno ako se na artiklu primjenjuje više popusta. |
|
| vrsta | M |
Vrsta popusta Enum:
|
|
| vrstaVrijednost | M |
Vrijednost povrata (zbirka umanjenja) bei [0] = Naknada: iznos popusta (discountValue = typeValue) bei [1] = Popust: postotak (npr. 10% popusta) |
|
| ključevi promocije | OVrijednost povrata (zbir iznosa umanjenja)bei [0] = Naknada | Ključevi promocije - ako se koriste (npr. kod kupona) | |
| identifikator | O | Dodatni identifikator za popust (može se koristiti npr. za grupiranje popusta u vrste popusta). | |
| vrsta | M | Tip stavke (Tip dokumentne stavke) | |
| koristiPodstavnuProračunuPDV-a | O | "true" ako se treba preuzeti izračun PDV-a za podstavke (SubItems) i zanemariti PDV nadređenog stavka; inače "false". | |
| podstavke | O | Detalji podstavki. Vidi: DocumentPositionType [1] = SubItem | |
| [...] | |||
| unutar kuće | O | Označava prodaju unutar tvrtke ili prodaju izvan tvrtke (true / false). | |
| ID grupe stavki | M* |
Indikator grupe članaka Podaci o zemlji:
|
|
| nazivGrupeArtikla | O | Naznaka grupe artikala | |
| cijena | O/M* |
Jedinična cijena artikla Podaci o zemlji:
|
|
| datumUlaskaArtikla | M* |
Vrijeme izrade članka. Podaci o zemlji:
|
|
| količina | M | Informacije o količini za artikl | |
| quantityUnit | M* |
Specifikacija mjerne jedinice Podaci o zemlji:
|
|
| id | M* |
Navod mjerne jedinice. Podaci o zemlji:
|
|
| ISO kod | M* |
Standardna mjerna jedinica prema ISO/UCUM kodu. Za više informacija pogledajte povezan članak. | |
| ID stavke | M | ID članka | |
| vrsta stavke | M* |
Opisuje vrstu stavke: robu ili usluge.
Podaci o zemlji:
|
|
| osnovna vrijednost | M* |
Neto ukupno (bez PDV-a) prije popusta ili nadoplate
Pažnja:
(Neto) zbroj retka/pozicije, a NE artikla. Ako je količina = 2, tada je osnovna neto vrijednost također cijena artikla x 2!
|
|
| baseGrossValue | M* |
Bruto ukupno (ukl. PDV) prije popusta ili nadoplate
Pažnja:
(Bruto) zbroj retka/pozicije, A NE artikla. Ako je količina = 2, tada je i baseGrossValue cijena artikla x 2!
|
|
| osnovna vrijednost za porez | M* |
Ukupni PDV (ili zbroj prve porezne stope) prije popusta ili nadoplate
Napomena:
(PDV) zbroj retka/pozicije, A NE artikla. Ako je količina = 2, tada je i baseTaxValue cijena artikla x 2!
Podaci o zemlji:
|
|
| baseTaxValue2 | M* |
Zbir drugog poreznog stope stavke prije popusta / nadoplate. Podaci o zemlji:
|
|
| gtin | O |
Globalni broj trgovačke stavke (GTIN) Podaci o zemlji:
|
|
| vrstaPoslovneTransakcije | M |
Vrsta poslovnog slučaja. Enum:
|
|
| klasifikacija vrste stavke |
Klasifikacija vrste stavke može se koristiti za primjenu dodatne klasifikacije na stavku. Klasifikaciju vrste stavke (ItemTypeClassification) može se postaviti samo ako je svojstvo 'ItemType' postavljeno na "[0] - Article" ili "ItemType": 0. Detaljne informacije o svojstvu "ItemTypeClassification" mogu se pronaći u povezanom članku. Sljedeće klasifikacije su dostupne.
Podaci o zemlji:
|
||
| identifikacijaPDV-a | M |
ID stope PDV-a. Može se upititi putem GET /api/v1/information/client/ {clientId}/getVatIdentification, navodeći stopu PDV-a dotične zemlje. stopu dotične zemlje. |
|
| vatPercent | M |
Stopa PDV-a u postotku ili prva porezna stopa primjenjiva na artikl u dotičnoj zemlji. Podaci o zemlji:
|
|
| vatPercent2 | M* |
druga porezna stopa primjenjiva na proizvod, izražena u postotku u dotičnoj zemlji. Podaci o zemlji:
|
|
| neto vrijednost | M |
Neto ukupni iznos stavke (umanjen za popuste / uvećan za doplate) - bez PDV-a. Mora uvijek biti navedeno. |
|
| bruto vrijednost | NNeto ukupan iznos stavke (umanjeno za sve popuste / uvećano za sve nadop |
Bruto ukupni iznos pozicije (umanjen za sve popuste / uvećan za sve nadoplate) - uklj. PDV. Mora se uvijek navesti. |
|
| porezniIznos | M |
Ukupni PDV (ili zbroj prve porezne stope) za stavku (umanjeno za popuste / uvećano za nadoplatu) Mora uvijek biti navedeno. Podaci o zemlji:
|
|
| taxValue2 | M* |
Zbir drugog poreznog stope stavke nakon popusta / nadoplate. Podaci o zemlji:
|
|
| identifikatorRačunovodstva | O | Dodatni identifikator za računovodstvene svrhe (računovodstveni sučelje) | |
| vrstaPoreza | M* |
Porezni tip stavke:
Podaci o zemlji:
|
|
| brojpozicije | M | Broj pozicije, počevši od 0 | |
| pozicijskiReferentpozicijskiReferentpozicijskiReferentpozicijskiReferentpozicijskiRefer | O | Navod broja pozicije na koji se treba pozvati | |
| pozicija otkazivanja | O | "true" ako ova pozicija poništava poziciju drugog dokumenta; inače "false" | |
| datum stvaranja | O | Vrijeme zabilježavanja položaja | |
[1] = Podstavka
"Podstavke" (DocumentPositionSubItem) omogućuju objašnjenje sastava prodanih proizvoda ili opisa grupe proizvoda na razini stavke.
Primjer: Jelo = Coca-Cola i hamburger.
Podstavke imaju objašnjavajući karakter i ne moraju se koristiti. Također nemaju utjecaja na cijenu i porez na promet / porez na dodanu vrijednost.
[2] = Tekst
Koristi se za pretvorbu položaja teksta ili crtičnog koda unutar dokumenta.
Primjer 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": {}
}
],Objekt DocumentPositionText sadrži sljedeće informacije.
Informacije u stupcu "Type":
- M ... obavezno / potrebno
- M* ... obavezno / potrebno u određenim zemljama ili pod određenim uvjetima
- R ... preporučeno
- O... opcionalno
| Elementi | Tip | Opis | |
| vrsta | M | Pozicije-tip (Tip dokumentne pozicije) | |
| tekst | O |
Polje za slobodan tekst Podaci o zemlji:
|
|
| vrsta crtičnog koda | O |
Indikacija tipa crtičnog koda Enum:
|
|
| crtični kod | O | Podaci o crtičnom kodu | |
| brojpozicije | M | Broj položaja, počevši od 0 | |
[3] = Rezervacija
Pozicije rezervacija (DocumentPositionBooking) koriste se za uplate, isplate, kao i za prodaju višenamjenskih vaučera (payIn, payOut, multiPurposeVoucher,...).
Primjer 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": {}
}
],Objekt DocumentPositionBooking sadrži sljedeće informacije.
Informacije u stupcu "Type":
- M ... obavezno / potrebno
- M* ... obavezno / potrebno u određenim zemljama ili pod određenim uvjetima
- R ... preporučeno
- O... opcionalno
| Elementi | Tip | Opis | |
| vrsta | M | Pozicije-tip (Tip dokumentne pozicije) | |
| natpis | M | Opis pozicije rezervacije | |
| identifikator | O | Dodatni ID pokazatelj rezervacije | |
| vrsta poslovne transakcije | M |
Vrsta poslovne transakcije. Enum:
|
|
| vrstaisplate | M* |
Označava vrstu isplate. Obavezno u nekim zemljama. Moguće vrijednosti:
Podaci o zemlji:
Napomena:
Novo od DOM v1.2.0 / Client v1.7.6
|
|
| identifikacijaPDV-a | M |
ID stope PDV-a. Može se upititi putem GET /api/v1/information/client/ {clientId}/getVatIdentification, navodeći stopu PDV-a dotične zemlje. |
|
| vatPercent | M | Stopa PDV-a u postotku | |
| neto vrijednost | M |
Neto ukupan iznos pozicije (umanjen za sve popuste) - bez PDV-a. Mora uvijek biti navedeno. |
|
| bruto vrijednost | N |
Bruto ukupni iznos stavke (umanjen za sve popuste) - uklj. PDV. Mora se uvijek navesti. |
|
| poreznaVrijednost | M |
Ukupni PDV za stavku (umanjen za sve popuste) Mora uvijek biti navedeno. |
|
| računskiIdentifikator | O | Dodatni identifikator za računovodstvene svrhe (računovodstveni sučelje) | |
| vrstaPorezaArtikla | M* |
Porezni tip stavke:
Podaci o zemlji:
|
|
| brojpozicije | M | Broj pozicije, počevši od 0 | |
| pozicijskiReferencija | O | Specifikacija broja stavke na koji se treba pozvati | |
| pozicija otkazivanja | O | "true" ako ova pozicija poništava poziciju drugog dokumenta; inače "false". | |
| izbrisanaPozicija | O | "true" ako je ova pozicija izbrisana; inače "false". | |
| datum stvaranja | O | Vrijeme snimanja pozicije | |
[9] = SubTotal
Pozicija podzbrota
[10] = Ukupno
Ukupna pozicija. Ako se koristi DocumentPositionTotal, ona mora uvijek biti posljednja pozicija u dokumentu (najveći broj pozicije).
Primjer 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": {}
}
],Objekt DocumentPositionTotal sadrži sljedeće informacije.
Informacije u stupcu "Type":
- M ... obavezno / potrebno
- M* ... obavezno / potrebno u određenim zemljama ili pod određenim uvjetima
- R ... preporučeno
- O... opcionalno
| Elementi | Tip | Opis | |
| vrsta | M | Pozicije-tip (Tip dokumentne pozicije) | |
| zaokruživanje | O |
Primijenjeno zaokruživanje. Ako zbroj pozicija (bruto iznos) nije jednak iznosu uplate. Npr. 0,01 bi omogućio zaokruživanje razlika od +/-0,01 Napomena: Molimo koristite pažljivo. Visoke vrijednosti onemogućit će provjeru iznosa za iznos plaćanja / bruto vrijednost dokumenta |
|
| osnovnaVrijednost | M* | Osnovni iznos stavke prije primjene popusta (samo ako se popusti primjenjuju) | |
| vrijednost | M | Vrijednost pozicije uključujući popuste. | |
| popusti | Detalji o popustima, smanjenjima cijena itd. | ||
| vrijednostpopusta | M |
Iznos popusta / iznos povrata
Pažnja:
ako je discountType [1] = discount, iznos popusta mora biti unesen s 4 decimalna mjesta!
|
|
| natpis | O | Naziv popusta | |
| redoslijedpopusta | M* |
Označava redoslijed izračuna popusta. Prvi popust koji se uzima u obzir ima vrijednost 0. Mora biti navedeno ako se na stavku primjenjuje više popusta. |
|
| vrsta | M |
Tip popusta Enum:
|
|
| vrsta vrijednosti | M |
Vrijednost povrata (zbir smanjenja) pri [0] = Allowance: iznos popusta pri [1] = Popust: postotak (npr. 10% popusta) |
|
| ključevi promocije | OVrijednost povrata (zbir iznosa umanjenja)bei [0] = Naknada | Ključevi promocije - ako se koriste (npr. kod kupona) | |
| identifikator | O | Dodatni identifikator za popust (može se koristiti npr. za grupiranje popusta u vrste popusta). | |
| natpis | O | Naznaka položaja | |
| brojpozicije | M | Broj pozicije, počevši od 0 | |
| pozicijskiReferencija | O | Navod broja pozicije na koji se treba pozvati | |
| pozicija otkazivanja | O | "true" ako ova pozicija poništava poziciju drugog dokumenta; inače "false". | |
| izbrisanaPozicija | O | "true" ako je ova pozicija izbrisana; inače "false". | |
| datum stvaranja | O | Vrijeme snimanja položaja | |
Ovaj je članak automatski preveden.
Komentari
0 komentara
Molimo Prijavite se kako bi ostavili komentar.