Oggetto di riferimento del documento «documentReference» – RetailForce

Il presente articolo tratta dell’oggetto di riferimento al documento «documentReference» all’interno dell’oggetto Document.

Una descrizione completa del RetailForce DOM (Document Object Model), nonché una descrizione dei singoli elementi, è disponibile nell’area download del sito web di RetailForce (Documentazione sul modello a oggetti.pdf) nella rispettiva directory delle versioni.

L’oggetto «documentReference» viene utilizzato per fare riferimento ad altri documenti già creati (emessi). Si tratta solitamente di un documento emesso in precedenza che deve essere annullato nella sua interezza, oppure nel caso in cui si debba fare riferimento a un documento di vendita corrispondente nel corso di un reso di beni o servizi.

Oggetto documentReference

L’oggetto di riferimento al documento seguente contiene dati di esempio.

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

L’oggetto di riferimento al documento contiene le seguenti informazioni.

Informazioni nella colonna «Tipo»:

M ... obbligatorio / richiesto
M* ... obbligatorio / richiesto in determinati paesi o a determinate condizioni
R ... raccomandato
O... facoltativo

Elementi		Tipo	Descrizione
documentReference		M*	documentReference è fondamentalmente un array facoltativo. In alcuni paesi il riferimento ad altri documenti è una pratica comune e spesso anche obbligatoria. Se viene utilizzato, sono necessarie determinate specifiche.
	ReferenceType	M	Tipo di riferimento al documento. Enum: [0] = Annullamento (fa riferimento a un documento annullato / a una voce di documento annullata) [1] = Predecessore (si riferisce al documento precedente)
	storeNumber		Il numero della filiale o del punto vendita presso cui è stato emesso il documento a cui si fa riferimento.
	terminalNumber		Il numero del registratore di cassa presso il quale è stato emesso il documento di riferimento.
	documentType		Tipo di documento a cui si fa riferimento.
	DocumentNumber		Numero del documento a cui si fa riferimento.
	documentNumberSeries		Intervallo numerico del documento di riferimento.
	fiscalDocumentNumber		Numero del documento fiscale del documento di riferimento.
	DocumentGuid		GUID/UUID del documento di riferimento.
	DocumentId		Numero univoco del documento di riferimento (max. 40 caratteri).
	DocumentBookDate		Data e ora di registrazione del documento di riferimento.
	ReturnReasonType		Motivo del reso Enum: CustomerComplaint - Reclami del cliente (anche in caso di richieste di intervento in garanzia) CustomerDiscount - Il cliente richiede uno sconto sul prezzo dell’articolo CustomerReturn - Il cliente desidera restituire l'articolo (senza motivo di reclamo) MasterDataWrong - I dati anagrafici dell’articolo erano errati Errore dell’operatore - Il personale di cassa ha commesso un errore che deve/dovrebbe essere corretto.
	returnReasonText		Descrizione del motivo del reso.

Questo articolo è stato tradotto automaticamente.

Oggetto documentReference

Articoli correlati