Transaction service

Does all the checks and functionality needed when adding a customer to a transaction including processing infocodes, getting price, discount and tax information as well as calculating the new balance of the sale.

When adding a customer to a sale in code this function should always be used

This function retrieves information about price, tax and discounts for the last item on the transaction. Despite what the name implies it does not calculate the final balance of the last item or for the entire sale. This function calls the price, tax and discount services to get the information needed for the item. To calculate the balance CalculateTotals from the Calculation service needs to be called.

When adding an item to a transaction in code this function should be called to get the price, tax and discount information for the item

For an example of how this function is used see CreateSubcodeSaleLineItem in the Infocode service

This is one of the most important functions in the LS One POS code base. This function is called once the POS has determined that the balance has been paid or that the transaction can be concluded, saved, printed and cleared from the POS.

This function goes through the transaction and calls various functions in various services to update information centrally. The information that is updated is as follows:

• Credit memo balance
• Gift card information and balance
• Loyalty information
• Parked inventory (for customer orders)
• Pharmacy information
• Serial numbers
• Calculate original number of transaction lines before saving the transaction

Some functionality is also called in this function to either conclude or kick off some functionality that is needed:

• Emailing receipts
• Fiscalization functionality
• RFID functionality
• Printing of the transaction
• Scheduling of post-sale Data director replication

This function should not be customized or changed except after careful consideration but the functions that are called in the various services can be customized in each service as needed.

This function sets all the properties on a transaction that is needed for the POS to be able to process and calculate the transaction correctly.

If a new transaction is created in code, no matter what type of transaction, this function should always be called.

This function retrieves information about price, tax and discounts for all the items on the transaction. Despite what the name implies it does not calculate the final balance of the items or for the entire sale. This function calls the price, tax and discount services to get the information needed for the items.

When changing a property on a sale that can affect prices, taxes and discounts on all the items this function should be called. Changing the customer on the sale for example would require a call to this function. See operations list below for a more comprehensive list

If a transaction that already has a receipt ID needs to be discarded or given a new receipt ID (for example in fiscalization functionality) this function should always be called for the receipt ID that has already been issued so that the next sale.

By law, in most countries, the receipt IDs that are issued have to be in the order the payments were received on each terminal so if a receipt ID is not going to be used for any reason it needs to be returned so that it can be issued again.

Depending on the parameters on the operation "Send an email receipt" this function either sends the receipt directly to be emailed or asks for information on which receipt to be emailed.

The Site service does the actual emailing so this functionality only schedules the email to be sent.