Референтен обект на документа „documentReference“ – RetailForce

Настоящата статия разглежда обекта за препратка към документ „documentReference“ в рамките на обекта „Document“.

Пълно описание на RetailForce DOM (Document Object Model), както и описание на отделните елементи, можете да намерите в раздела за изтегляне на RetailForce website (Object model documentation.pdf) в съответната директория за версии.

Обектът „documentReference“ се използва за препратка към други, вече създадени (издадени) документи. Обикновено това е предишно издаден документ, който трябва да бъде анулиран изцяло, или когато се налага препратка към съответен документ за продажба в рамките на връщане на стоки или услуги.

Обект „documentReference“

Следващият обект „documentReference“ съдържа примерни данни.

"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"
},

Обектът за препратка към документ съдържа следната информация.

Информация в колоната „Тип“:

M ... задължително / изисквано
M* ... задължително / изисква се в определени държави или при определени условия
R ... препоръчително
O... по избор

Елементи		Тип	Описание
documentReference		M*	documentReference е по същество незадължителен масив. В някои страни позоваването на други документи е обичайна практика, а често и задължително. Ако се използва, са необходими определени спецификации.
	ReferenceType	M	Тип на препратката към документ. Enum: [0] = Отмяна (позовава се на отменен документ / отменена позиция от документ) [1] = Предшественик (позовава се на предишния документ)
	storeNumber		Номерът на клона/магазина, където е издаден документът, към който се отнася препратката.
	terminalNumber		Номерът на касовия апарат, на който е издаден посоченият документ.
	documentType		Тип на посочения документ.
	DocumentNumber		Номерът на посочения документ.
	documentNumberSeries		Номерен диапазон на документа, към който се прави препратка.
	fiscalDocumentNumber		Номер на фискалния документ, към който се прави препратка.
	DocumentGuid		GUID / UUID на документа, към който се прави препратка.
	DocumentId		Уникален номер на цитирания документ (макс. 40 символа).
	DocumentBookDate		Дата и час на резервацията на посочения документ.
	ReturnReasonType		Причина за връщане Enum: CustomerComplaint – Жалби от клиенти (включително при рекламации по гаранция) CustomerDiscount – Клиентът иска отстъпка от цената на артикула CustomerReturn – Клиентът желае да върне стоката (без причина за рекламация) MasterDataWrong – Данните за артикула (основни данни) са били грешни (грешни данни за артикула) UserMistake – Касиерът е допуснал грешка, която трябва/следва да бъде коригирана.
	returnReasonText		Описание на причината за връщането.

Тази статия е преведена автоматично.

Обект „documentReference“

Подобни статии