Referenčni objekt dokumenta »documentReference« – RetailForce

Ta članek obravnava referenčni objekt dokumenta »documentReference« znotraj objekta Document.

Celoten opis modela RetailForce DOM (Document Object Model) ter opis posameznih elementov najdete v rubriki za prenose na RetailForce website (Object model documentation.pdf) v ustreznem imeniku različic.

Objekt »documentReference« se uporablja za sklicevanje na druge, že ustvarjene (izdane) dokumente. Običajno gre za prej izdan dokument, ki ga je treba v celoti razveljaviti, ali pa za sklicevanje na ustrezen prodajni dokument v okviru vračila blaga ali storitev.

Objekt »documentReference«

Naslednji objekt sklicevanja na dokument vsebuje vzorčne podatke.

"documentReference": {
   "referenceType": "[0] = Cancellation",
   "storeNumber": "999",
   "terminalNumber": "03",
   "documentType": "[0] = Receipt",
   "documentNumber": "2023000748605",
   "documentNumberSeries": "YYYYASCNO",
   "fiscalDocumentNumber": 0,
   "documentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
   "documentId": "999-2023000748605",
   "documentBookDate": "2023-04-27T17:27:12.541Z",
   "returnReasonType": "userMistake",
   "returnReasonText": "cashier error"
},

Objekt za sklicevanje na dokument vsebuje naslednje informacije.

Podatki v stolpcu »Type«:

M ... obvezno / zahtevano
M* ... obvezno / zahtevano v nekaterih državah ali pod določenimi pogoji
R ... priporočeno
O... neobvezno

Elementi		Tip	Opis
documentReference		M*	documentReference je v osnovi neobvezni niz. V nekaterih državah je sklicevanje na druge dokumente običajna praksa in pogosto tudi obvezno. Če se uporablja, so potrebne določene specifikacije.
	ReferenceType	M	Vrsta sklicevanja na dokument. Enum: [0] = Preklic (sklicuje se na preklican dokument / preklicano postavko v dokumentu) [1] = Predhodnik (sklicuje se na prejšnji dokument)
	storeNumber		Številka podružnice / trgovine, kjer je bil izdan dokument, na katerega se sklicuje.
	terminalNumber		Številka blagajne, na kateri je bil izdan dokument, na katerega se nanaša sklic.
	documentType		Vrsta navedenega dokumenta.
	DocumentNumber		Številka navedenega dokumenta.
	documentNumberSeries		Številčno območje sklicanega dokumenta.
	fiscalDocumentNumber		Fiskalna številka sklicnega dokumenta.
	DocumentGuid		GUID / UUID sklicnega dokumenta.
	DocumentId		Edinstvena številka sklicanega dokumenta (največ 40 znakov).
	DocumentBookDate		Datum in čas rezervacije sklicanega dokumenta.
	ReturnReasonType		Razlog za vrnitev Enum: CustomerComplaint – pritožbe strank (tudi v primeru garancijskih zahtevkov) CustomerDiscount – Stranka želi popust na ceno izdelka CustomerReturn – Stranka želi vrniti izdelek (brez razloga za pritožbo) MasterDataWrong – Podatki o izdelku (osnovni podatki) so bili napačni (napačni podatki o izdelku) UserMistake – Blagajnik je naredil napako, ki jo je treba / bi jo bilo treba popraviti.
	returnReasonText		Opis razloga za vrnitev.

Ta članek je bil samodejno preveden.

Objekt »documentReference«

Sorodni sklopi