Particularities of a fuel card sale
In a sale using a fuel card, the POS is requested to enter field 1115, where the list of products that total the value of the sale must be entered. The product list must be in the format:
Where <CodProd> is the product code according to the authorizing network; <DescProd> is the product description; <Qty> is the quantity; <Total value> is the total amount to be paid for this product (No formatting, with the last two digits referring to cents). It is mandatory that at least one sales item is described. It is recommended that the list of
products (Field 1115) is assembled internally by the POS without the intervention of the POS operator. There cannot be duplicate product codes in the product list. In a sale, if there are two (or more) products with the same code, the POS must add the quantity and value of these products (with the same code) and generate a single record (item) in the list of products.
To facilitate the capture of product data by the POS operator, these fields can be captured separately one by one. To do this, you need to include the following configuration in the clisitef.ini file:
If the above configuration is carried out, then for each product you will be asked to capture the
fields 1026 (Product code), 1025 (Description), 1027 (Quantity), 2083 (Total value).
To end the capture of products and continue with the execution of the transaction, a null string must be provided when capturing field 1026 (Product code).
There is currently a restriction in each authorizing network on the quantity of items to be sent in a sale. Therefore, the POS must sort each item in order of priority, from the highest priority item (on the left) to the least priority item (on the right).
After requesting the card number, SiTef will be consulted with this list of products. CliSiTef will return a list of products to the POS, which may be different if there is a discrepancy in the product code or maximum quantity of products.
If the returned list is different, an error code will be returned. However, if the POS is capable and allows a partial sale of values, the sale operation can be carried out by passing the additional parameter below in the sales restrictions:
In this situation, the new payment amount will be returned in field 154, and confirmation of the operation will be requested at the POS.
The Sitef query also returns a list of questions to be collected. In this case, a description and a collection field will be sent for each question with the codes defined below:
| field | code |
|---|---|
| Boolean Field | 2060 |
| Numeric Field | 2061 |
| Alpha-Numeric Field | 2062 |
| Date field in DDMMYYY format | 2063 |
| Undefined content | -1 |
There is also a check between the sale value and the approved value. The approved value is the final value that will be used in the transaction. If the approved Value is lower than the sale value, a confirmation is presented to the operator, who may not authorize the completion of the sale. If the approved value is greater than the sale value, a confirmation is displayed to the customer, on the PinPad, so that they can authorize the debit or not. In these two cases, the approved value is returned in field 138 and the difference is returned in field 137.