Element "user" – RetailForce Software GmbH

The element "user" is used to provide information about the user of the electronic recording system ("cash register"). It can be used in different levels of the document model:

If the user element is used in the header, the information applies to the entire document, exceptor those areas
where a different information is given. E.g. for individual item ("positions") or payment ("payments") items.

A complete description of the RetailForce DOM (Document Object Model), as well as a description of the individual elements, can be found in the Downloads-Bereich der RetailForce Website (Object model documentation.pdf) in the respective version directory.

Example:

"user": {
   "id": "1",
   "caption": "Cashier 1",
   "firstName": "Jane",
   "lastName": "Doe",
   "taxNumber": "123456789",
   "dateOfEntry": "2022-10-01T08:00:00+01:00"
},

Sub-elements of "user" in details.

Information in "Type" column:

M ... mandatory / requird
M* ... mandatory / requird in certain countries or under certain conditions
R ... recommended
O... optional

Element		Type	Description
user		O/M*	Details of the cash register user. Instead of the "user" element, "salesPerson" can usually also be used.
	id	O/M*	ID of the (cash register) user Attention: often the user ID (or the salesPerson.Id) must follow certain rules in countries with fiscal printer connection: Italy (EPSON printers): the ID must be a number between 1-12. If no user.id or salesPerson.id is transmitted, the printer automatically assumes 01. Country details: Denmark: mandatory information ("empID" in SAF-T) Italy: mandatory information
	caption	O/M*	Designation of the (cash register) user
	firstName	O/M*	First name of (cash register) user Country details: Denmark: mandatory information ("firstName" in SAF-T)
	lastName	O/M*	Last name of (cash register) user Country details: Denmark: mandatory information ("surName" in SAF-T)
	taxNumber	O/M*	Tax number of the (cash register) user Country details: Slovenia: mandatory information (tax ID of the cashier)
	dateOfEntry	O/M*	Start of the employment relationship / time when the user was created in the system Country details: Denmark: mandatory information ("dateOfEntry" & "timeOfEntry" in SAF-T). The fields represent the time when a master data entry was made for the first time. If this information is not available in the POS system, the following values must be used: dateOfEntry: 0001-01-01, timeOfEntry: 00:00:00 and UCT-offset: +00:00 "dateOfEntry": "0001-01-01T00:00:00+00:00"

Related articles