Referenční objekt dokumentu „documentReference“ – RetailForce

Tento článek se zabývá referenčním objektem dokumentu „documentReference“ v rámci objektu Document.

Úplný popis DOM (Document Object Model) systému RetailForce, stejně jako popis jednotlivých prvků, naleznete v sekci ke stažení na webových stránkách RetailForce (Object model documentation.pdf) v příslušném adresáři verzí.

Objekt „documentReference“ se používá k odkazování na jiné, již vytvořené (vystavené) dokumenty. Obvykle se jedná o dříve vystavený dokument, který má být v plném rozsahu zrušen, nebo o případ, kdy je třeba v rámci vrácení zboží či služeb odkazovat na odpovídající prodejní doklad.

Objekt documentReference

Následující objekt odkazu na dokument obsahuje vzorová data.

"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 odkazu na dokument obsahuje následující informace.

Informace ve sloupci „Typ“:

M ... povinné / vyžadované
M* ... povinné / vyžadované v určitých zemích nebo za určitých podmínek
R ... doporučeno
O... volitelné

Prvky		Typ	Popis
documentReference		M*	documentReference je v zásadě volitelné pole. V některých zemích je odkazování na jiné dokumenty běžnou praxí a často i povinností. Pokud se používá, je nutné dodržet určité specifikace.
	referenceType	M	Typ odkazu na dokument. Výčet: [0] = Zrušení (odkazuje na zrušený dokument / zrušenou položku dokumentu) [1] = Předchůdce (odkazuje na předchozí dokument)
	storeNumber		Číslo pobočky / prodejny, kde byl odkazovaný dokument vystaven.
	terminalNumber		Číslo pokladny, na které byl uvedený doklad vystaven.
	documentType		Typ dokumentu, na který se odkazuje.
	documentNumber		Číslo uvedeného dokumentu.
	documentNumberSeries		Číselný rozsah odkazovaného dokumentu.
	fiscalDocumentNumber		Daňové číslo odkazovaného dokumentu.
	documentGuid	R	GUID / UUID odkazovaného dokumentu.
	documentId		Jedinečné číslo odkazovaného dokumentu (max. 40 znaků).
	DocumentBookDate	M	Datum a čas rezervace v odkazovaném dokumentu.
	returnReasonType		Důvod vrácení Výčet: CustomerComplaint – stížnosti zákazníků (včetně záručních reklamací) CustomerDiscount – Zákazník požaduje slevu z ceny zboží CustomerReturn – Zákazník chce zboží vrátit (bez udání důvodu) MasterDataWrong – Údaje o zboží (kmenové údaje) byly nesprávné (nesprávné údaje o zboží) UserMistake – Pokladní udělal chybu, kterou je nutné / by mělo být opraveno.
	textDůvoduVrácení		Popis důvodu vrácení.

Tento článek byl přeložen automaticky.

Objekt documentReference

Související články