Dokumentreferenceobjekt »documentReference« – RetailForce

Denne artikel omhandler dokumentreferenceobjektet »documentReference« inden for Document-objektet.

En fuldstændig beskrivelse af RetailForce DOM (Document Object Model) samt en beskrivelse af de enkelte elementer findes i downloadområdet på RetailForce website (Object model documentation.pdf) i det respektive versionsbibliotek.

Objektet »documentReference« bruges til at henvise til andre, allerede oprettede (udstedte) dokumenter. Dette er typisk et tidligere udstedt dokument, der skal annulleres i sin helhed, eller hvis der skal henvises til et tilsvarende salgsdokument i forbindelse med en returnering af varer eller tjenesteydelser.

documentReference-objekt

Følgende dokumentreferenceobjekt indeholder eksempeldata.

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

Dokumentreferenceobjektet indeholder følgende oplysninger.

Oplysninger i kolonnen »Type«:

M ... obligatorisk / påkrævet
M* ... obligatorisk / påkrævet i visse lande eller under visse betingelser
R ... anbefalet
O... valgfrit

Elementer		Type	Beskrivelse
documentReference		M*	documentReference er grundlæggende en valgfri array. I nogle lande er det almindelig praksis og ofte også obligatorisk at henvise til andre dokumenter. Hvis den anvendes, er visse specifikationer nødvendige.
	ReferenceType	M	Type af dokumenthenvisning. Enum: [0] = Annullering (henviser til et annulleret dokument / et annulleret dokumentelement) [1] = Forgænger (henviser til det forrige dokument)
	storeNumber		Filial-/butiksnummeret, hvor det refererede dokument blev udstedt.
	terminalNumber		Det kasseapparatnummer, hvor det refererede dokument blev udstedt.
	documentType		Dokumenttypen for det refererede dokument.
	DocumentNumber		Dokumentnummeret for det dokument, der henvises til.
	documentNumberSeries		Nummerinterval for det refererede dokument.
	fiscalDocumentNumber		Regnskabsdokumentnummer for det refererede dokument.
	DocumentGuid		GUID/UUID for det refererede dokument.
	DocumentId		Unikt dokumentnummer for det refererede dokument (maks. 40 tegn).
	DocumentBookDate		Reservationsdato og -tidspunkt for det refererede dokument.
	ReturnReasonType		Årsag til retur Enum: CustomerComplaint – Kundeklager (også i tilfælde af garantikrav) CustomerDiscount – Kunden ønsker rabat på varens pris CustomerReturn – Kunden ønsker at returnere varen (uden klageårsag) MasterDataWrong – Vare(stamme)data var forkerte (forkerte varedata) UserMistake - Kassemedarbejderen har begået en fejl, som skal/bør rettes.
	returnReasonText		Beskrivelse af årsagen til returneringen.

Denne artikel er oversat automatisk.

documentReference-objekt

Relaterede artikler