ViKING transaction types | FiftyTwo | 52ViKING Developer Platform

You can view individual tags under each segment (for example the SalesTransaction segment) after the transaction types table.

Transaction code	Description	XML/JSON tag
01	Article sale	SalesTransaction - ItemSale
02	Line VAT (only used when selling without VAT)
03	Article transferred to next/other receipt (only used when splitting receipts)
04	(not in use)
05	Price guarantee information (only used when matching prices against competitors)
06	Article discount	DiscountTransaction - booked
07	Non-returned article discount	DiscountTransaction - Linked
08	(not in use)
09	End of receipt	/Transaction
10	Exchange stickers
13	Additional article information
14	Issued/redeemed vouchers
15-17	(not in use)
18	Data carrier for additional information about discount family/discount group number of a given discount	DiscountTransaction – Info
19	Data carrier for additional information about printed discount line	DiscountTransaction – Printed / Hidden
20	Service	SalesTransaction – GiftCertificate / Finance
21	Receipt total – VAT information
22	Receipt total – receipt statistics	ReceiptTotal
23	Payment that does not involve credit cards or foreign currencies	PaymentTransaction
24	Payment with credit card	PaymentTransaction
25	Payment with foreign currency	PaymentTransaction
26	Payment with bonus points
27	(not in use)
28	Additional information on line level	TransactionMisc – AddInfo
31	Header for reprint	TransactionMisc – Reprint
32	Additional information on order or receipt level	TransactionMisc – Customer / Requisition / Order
33	Issued stamps	TransactionMisc – Stamps
34	Header for return lines on line level	TransactionMisc – Return
35	Header for correction receipt	TransactionMisc – Correction
36	Header for receipt retrieved after parking	TransactionMisc – Retrieve
37	Additional information for payments	TransactionMisc – TenderAddon / FlexiAddon
38	Manually registered text ID	TransactionMisc – AddonText
39	Drawer open (zero sale)	TransactionMisc – DrawerOpen
40	Transfer of cash statement (tender declaration) data to operator	TransactionMisc – TransferCashier
41	Sign-on or sign-on attempts	TransactionMisc – SignOn
42	Sign-off	TransactionMisc – SignOff
43	Adding or removal of money	PaymentTransaction – TenderRemoval / TenderAdded
44	Bag number	TransactionMisc – BagNumber
45	Cash statement (tender declaration)	PaymentTransaction – TenderDeclaration
46	Balance inquiry	TransactionMisc – BalanceInquiry
47	Additional sales information about staff, special customer groups, club membership, bonus program,external customer ID, cardholder ID, bonus point balance from external system, or project number	TransactionMisc – Staff / Customer / Club / Bonus / ExternalCustId / CardHolderId
48	Customer survey	TransactionMisc - CustomerAnalyze
49	(not in use)
50	(not in use)
51	(not in use)
52	(not in use)
53	Stock adjustment/stocktaking	StockTransaction – Taking / Discrepancy / Movement
54-60	(not in use)
61	Remarks (free text)	TransactionText
62	Credit card magnetic stripe track 2 information
63	Voucher issue information	TransactionMisc – Voucher
64	VAT transaction	TransactionMisc – VAT
65	Key (physical key for allowing action) activated/deactivated (see also 67)	TransactionMisc – Key
66	Voucher ID	TransactionMisc – Goyada / Lotto / Blackhawk
67	Key (card number scanned or entered for allowing action) activated/deactivated (see also 65)
68	Agreed price (price list)
69-71	(not in use)
72	CMS (Cash Management System) data	TransactionMisc –
73-96	(not in use)
97	End of file for subordinate unit in arrangements where one controller controls another
98	End of session (a session is a sales day in a store)
99	End of file (always last record in file)
Transaction types without XML/JSON tags are currently not exported.

Tags under header segment

XML/JSON tag	Field type	Example value	Description
Session	Num (4)	2070	The day’s session. A session is a sequential numbering of sales days. The session can be translated to an opening date.
StoreId	Num (4)	5266	ViKING store ID. All transactions generated in a store are tagged with the store’s ID.
ExternalStoreId	Char (10)	Free text	Alternative to ViKING store ID.
TillNo	Num (3)	1	Till number in store.
ReceiptNo	Num (4)	1	Individual till’s receipt number. Starts at 1 every day.
TimeStamp	Num (10)	1414580210	Linux timestamp in number of seconds since 1st January 1970 (also known as epoch).
TransactionTime	Char (25)	2014-10-29T11:56:50+01:00	XML/JSON-formatted timestamp of transaction start.
Cashier	Num (5)	12345	Operator that transaction is recorded on. An operator (also known as a cashier) is responsible for the content of the till’s cash drawer. An operator can only be active on one till at a time, because there’s a one-to-one relation between the operator and the money in the cash drawer that the operator uses. Only operators can make cash statements on tills. Multiple operators may use the same till during a day, but in that case they’ll remove their cash drawer and make a cash statement when they finish working at the till. When another operator begins working at the till, they’ll bring their own cash drawer.
SalesPerson	Num (5)	56789	ID of salesperson that transaction is recorded on. A salesperson doesn’t have personal responsibility for the content of the till’s cash drawer. Salespersons are typically used when multiple shop assistants share a till and log in to the till at the beginning of each sale. Note that even though a till is used by multiple shop assistants who log in as salespersons, the till can still have a fixed operator, that is an operator (see Cashier in the previous) who’s permanently logged in to the till.
Training	Boolean		Flag that indicates if transaction was made in training mode and shouldn’t be recorded.
ReceiptCancelled	Boolean		Flag that indicates if transaction was canceled and shouldn’t be recorded.
ReceiptParked	Boolean		Flag that indicates if transaction was parked and shouldn’t be recorded.
RefundReceipt	Boolean		Flag that indicates if transaction was a refund receipt. Only used where it’s not allowed to mix refunds and sales on the same receipt.
ExchangeReceipt	Boolean		Exchange transaction between two means of payment. Stores typically use the exchange feature if a customer wants to buy cash with their credit card.

Tags under SalesTransaction segment

XML/JSON tag	Field type	Example value	Description
TypeId	Num (2)	1	Transaction type ID (see list of transaction types).
SubType	Bin (8)	0	Eight bits, each with their own significance: Bit OFF ON 0 Article number entered Scanned 1 Sale Return 2 Normal Inquiry 3 Automatic Manual (price) 4 Normal Price correction 5 Normal Self-scanned 6 Normal Void 7 Normal Cancel	Bit	OFF	ON	0	Article number entered	Scanned	1	Sale	Return	2	Normal	Inquiry	3	Automatic	Manual (price)	4	Normal	Price correction	5	Normal	Self-scanned	6	Normal	Void	7	Normal	Cancel
Bit	OFF	ON
0	Article number entered	Scanned
1	Sale	Return
2	Normal	Inquiry
3	Automatic	Manual (price)
4	Normal	Price correction
5	Normal	Self-scanned
6	Normal	Void
7	Normal	Cancel
Seqno	Num (4)	1	Line number in transaction.
TransactionTime	Char (25)	2014-10-29T11:56:50+01:00	XML/JSON-formatted timestamp of sale of article.
SalesType	Char	ItemSale	Possible values: ItemSale GiftCertificate Finance
ArticleNumber	Num (13)	95400	Article number of sold article.
ReceiptText	Char (30)		Article receipt text.
Quantity	Num (-8,3)	1	Sold quantity (or sold number of meters, etc.).
UnitSalesPrice	Num (-8,2)	57.95	Unit price.
QtySalesPrice	Num (-8,2)	57.95	Total price for registered quantity.
VatAmount	Num (-8,2)	11.59	VAT for line in question.
Void	Boolean		Flag that indicates if transaction was a canceling of an earlier registered line on the receipt in question.
Refund	Boolean		Flag that indicates if the transaction was a refund.
Inquiry	Boolean		Flag that indicates if the transaction was a price query and shouldn’t be recorded. Quantity and price is 0.
PriceChange	Boolean		Flag that indicates if price was entered manually.
ArticleGroup	Num (6)		Article group that article belongs in.
ReasonCode	Num		The ID of the reason code supplied if the transaction required staff to provide a reason code

Tags under DiscountTransaction segment

XML/JSON tag	Field type	Example value	Description
TypeId	Num (2)	6	Transaction type ID (see list of transaction types).
SubType	Bin (8)	0	Bit OFF ON 0 Article number entered Scanned 1 Sale Refund 2 Discount in currency Discount in % 3 Automatic Manual 4 Normal discount Club discount 5 Normal Self-scanned	Bit	OFF	ON	0	Article number entered	Scanned	1	Sale	Refund	2	Discount in currency	Discount in %	3	Automatic	Manual	4	Normal discount	Club discount	5	Normal	Self-scanned
Bit	OFF	ON
0	Article number entered	Scanned
1	Sale	Refund
2	Discount in currency	Discount in %
3	Automatic	Manual
4	Normal discount	Club discount
5	Normal	Self-scanned
Seqno	Num (4)	1	Line number in transaction.
TransactionTime	Char (25)	2014-10-29T11:56:50+01:00	XML/JSON-formatted timestamp of sale of article.
DiscountStatus	Char	Booked	Can have the following values: Booked Linked Info Printed Hidden
ArticleNumber	Num (13)	1	Article number that discount should be applied on.
DiscountType	Num (2)		0 = Based on article 1 = Based on payment method 2 = Based on till 3 = Based on receipt total 4 = (not used) 5 = Basket discount 6 = Voucher discount 7 = Price guarantee discount 8 = Markdown discount 9 = Customer/article discount 10 = External discount 11 = Club discount 12 = Free/complimentary article 13 = Point-based discount 14 = Total discount (via a special key with <TOTD> precoding) 15 = Customer list-based discount 16 = Best price discount (for customers collecting orders to get best price based on what’s calculated at order creation time and at order collection time) 17 = Manual group discount, also known as smart discount (where shop assistants can select a number of article lines on the till’s journal and give a discount on the selected lines)
DiscountReasonCode	Num (3)		ID of reason code that explains reason for granting the discount in question
DiscountAmount	Num (-8,2)	-48.00	Discount given, including VAT.
VatAmount	Num (-8,2)	-9.60	VAT of discount.
Reference	Num (10)		Currently used for optional discount group.
CampaignId	Num (10)		ID of campaign that has triggered the discount in question. A value of 0 means that discount wasn’t triggered by a campaign.
DiscountedLine	Num (4)		Reference to the sales transaction line number that the discount concerns.

Tags under PaymentTransaction segment

XML/JSON tag	Field type	Example value	Description
TypeId	Num (2)	23	Transaction type ID (see list of transaction types).
SubType	Bin (8)	0	Bit OFF ON 0 Normal CMS (Cash Management System) 6 Normal Void 7 Normal Cancel	Bit	OFF	ON	0	Normal	CMS (Cash Management System)	6	Normal	Void	7	Normal	Cancel
Bit	OFF	ON
0	Normal	CMS (Cash Management System)
6	Normal	Void
7	Normal	Cancel
Seqno	Num (4)	1	Line number in transaction.
TransactionType	Char	Payment	Indicates that transaction is a payment transaction.
TenderType	Num (3)	0	Payment method code.
TenderText	Char (20)	Cash	Receipt text from means of payment.
PaidAmount	Num (-8,2)	100.00	Total amount.
Currency	Char (3)	EUR	ISO 4217 currency code of received payment.
ExchangeRate	Num (8,3)	0.000	Exchange rate. No exchange rate if payment is in local currency.
PaidCurrency	Num (-8,2)	0.00	Paid amount in foreign currency. No currency amount if payment is in local currency.
CashBack	Num (-8,2)	33.50	Change given. Always in local currency.
Rounding	Num (4,2)	0.00	Rounding.
TenderInfo	Num (8)		Optionally registered information.
Issuer	Char (4)	VIDK	Credit card issuer identifier. Only available if relevant.
AccountNo	Num (10)		Account number for debtor sales. Only available if relevant.
VoiucherId	Num (10)		Voucher/credit note number. Only available if relevant.
Points	Num (8)		Number of points used.
CustomerId	Num (10)		ID of customer who spent points.
TenderRefNo	Num (2)		ID for collecting stamps.
CashManagement	Boolean		Indicates if payment was made through a CMS (Cash Management System).
ExtPaymentNum	Num (2)		Reference to third-party means of payment.
CardNo	Num (19)	Currently always empty

Tags under ReceiptTotal segment

XML/JSON tag	Field type	Example value	Description
TypeId	Num (2)	22	Transaction type ID (see list of transaction types).
SubType	Bin (8)	0	Not used.
LineNumber	Num (4)	1	Line number in transaction.
ReceiptTotal	Num (8,2)		Receipt total.
NumberArticles	Num (4)		Number of articles on receipt.
NumberPackages	Num (4)		Number of packages.
NumberCancelledArticles	Num (4)		Number of canceled article sales lines on receipt.
CancelAmount	Num (8,2)		Canceled amount.
HandlingTime	Num (6)		Time spent on selling articles.
TenderTime	Num (6)		Time spent on registering payment.

Related: ViKING