Particularities of a fuel card sale

In a sale using a fuel card, the POS is asked for field 1115, where the list must be entered. of products that total the sales value. The product list must be in the format:

item 1 ;item 2 ;...;item n ;
where each item is of the form:
<CodProd>,<DescProd>,<Qty>,<TotalValue>;

where <CodProd> is the product code according to the authorizing network; <DescProd> is the description of the product; <Qty> is the quantity; <Total Value> is the total amount to be paid for this product (without 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 product list (Field 1115) be 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 product list.

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 file clisitef.ini:

[FuelCard]
ColetaDadosProdutoSeparadamente=1

If the above configuration is carried out, then, for each product, the capture of fields 1026 (Product code), 1025 (Description), 1027 (Quantity), 2083 (Total value) will be requested. To end product capture and proceed with the execution of the transaction, when capturing field 1026 (Product code) a null string must be provided.

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 most 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.


For more details regarding the flow of a Fuel transaction, see the document: Cartão Combustivel - Clisitef.pdf