Skip to main content
Sign in

Fuel-retailer-integration

Marisa Potgieter
  • Updated

FCPlus Integration with fuel retailers

FCPlus has integrated with some automotive fuel retailers to allow fuel expenses to be posted directly to the customer's account whenever fuel is purchased. Each retailer requires individual FCPlus account configuration and/or retailer site account configuration to benefit from automated fuel import. 

FCPlus is integrated with the following retailers:

  • Neste (LT, LV, EE, FI)
  • Circle K (Baltics)
  • Alexela (EE)
  • Terminal Oil (EE), possibility to configure for other countries.
  • LDT, VIADA, OLEREX

Configuration of integrations with fuel retailers takes place on retailer side and on the Fleet Complete side. Please get in touch with your FCPlus account manager or sales representative to find out more and set up the required integration(s).

To use integration with fuel stations Vehicles MUST have fueling cards assigned to them. You can assign fueling cards to vehicles in FCPlus -> Settings module -> Vehicles tab -> Properties -> Fuel card number.

NESTE fueling stations integration

Ask your sales person to activate the option to setup NESTE expense integration.

You need to obtain client id, client secret, audience, user id, account number from Neste fuel station for the integration.

Once you received the necessary details from NESTE, follow these steps to activate the Neste provider integration in FCPlus:  

  1. Go to the Settings module and open the Organization settings.
  2. Find Neste expenses subsection.
  3. Add Client id, client secret, audience, user id, account number and click on the Save button.

If you're confused, which values go where, here's description how they usually look like.

  • client ID is 32-digit hexadecimal value like 338ecff9345e6bc4dfa71d20238bcefb
  • client secret is 72-digit hexadecimal value
  • audience is hyphenated hexadecimal string in UUID format (8-4-4-4-12), like f836a2fc-027c-49d7-9249-ff079cc06fcb
  • user id is another uuid string, like audience
  • account number 8-digit number, like 01234567
  • country: currently allowed values are EE, LT, LV, FI

Once account is fully set up, expenses will automatically be collected from Neste and populated to FCPlus expenses module. Neste expense pull happens once every hour.

ALEXELA fueling stations integration

Ask your sales person to activate the option to setup Alexela expense integration.

Once option is activated, please follow the steps below to activate Alexela fuel station integration in FCPlus:

  1. Go to Settings module
  2. Open Organization settings
  3. Find Alexela expenses subsection.
  4. Add Customer ID, API Key, Contact numbers. Customer ID and API key should be provided by Alexela to end-customer. Contract numbers can be provided either by Alexela or customer can read them from Alexela customer portal. If there is more than one contract number, then numbers should be separated by semicolon “;”.

  • customer ID is 5-digit number starting with L, like L12345. You can write multiple customer ID-s separated with semicolon.
  • API key is long string with random characters, maybe over 100 characters long
  • contract numbers are 5-digit numbers like 12345. If you have more than one, separate them with semicolons.

Once ALL OF THE ABOVE STEPS are completed all transactions posted by Alexela will automatically be posted directly to customer account under Expenses module.

CIRCLE K fueling stations integration

You need API key, what you can ask from your customer manager of FCPlus account. What they do is create standard FCPlus user, and assign API key for it (what is not visible in FCPlus people settings). You can see this API user and its assigned role from FCPlus.

This user must have access to expenses module, and permission to edit expenses:

Once you got API key, you need to configure a setup on Circle K website:

  1. Login in to Circle K Pro self-service portal
  2. Go to Notification setup in the left menu
  3. Click on  Add Subscription and choose Transaction Feed.

  1. Enter the Name of the subscription
  2. Click on the Add system button

  1. Add System name and User (use special API user created in FC+ step 1)
  2. Add URL: https://app.ecofleet.com/services/api/circlek/expenses/add
  3. Add password (use API Key)

9. Select the context for the transaction feed, then submit.

Once ALL OF THE ABOVE STEPS are completed all transactions posted by Circle K will automatically be posted directly to customer account under Expenses module.

Please note: In the Expenses module columns TOTAL and TOTAL WITHOUT VAT are the same amount – this is due to limitation on Circle K side. Circle K only share TOTAL sum with all taxes already included.

OLEREX fueling stations integration

Ask your sales person to activate option to setup Olerex expense integration.

If you want to start using service you will need to activate Fleet Complete service on Olerex self sevice webportal https://login.olerex.ee/et and share Olerex Account ID with your FC+ sales manager for the setup.

Once setup is complete, you need to add fuel card numbers to your company vehicles in the FCPlus (see above).

Once ALL OF THE ABOVE STEPS are completed all transactions posted by Olerex will automatically be posted directly to customer account under Expenses module.

LDT fuel cards integration

Please note only LDT fuel cards are accepted for this integration (expenses acquired using Rotada or other cards will not be posted).

Ask your sales person to activate the option to setup LDT expense integration.

Once option is activated, please follow the steps below to activate LDT fuel cards integration in FCPlus:

  1. Get your LDT account details from LDT website  https://ldtinklas.eu/savitarna/login

Once logged in go to your profile view and click API link in lower right corner.

In API screen you will see API call URL containing user name and password

2. Login to FC+ and go to Settings module.     3. Open Organization settings.     4. Find LDT expenses subsection.      5. Add Username and Password as copied from LDT API call.     6. Save.

Once ALL OF THE ABOVE STEPS are completed all transactions completed using LDT cards at partner stations will automatically be posted directly to customer account under Expenses module. 

Travelcard Integration

FC+ has integrated with TravelCard to help you manage your fueling expenses. Travelcard can be used at over 800000 locations across Europe to refueling, charging, parking or car washing.

Travelcard pushes all accumulated expenses to amazon SQS queue where FC+ pulls them from and based on fuel card number, FC+ locates the vehicle associated with the card and posts expenses to relevant company account.

How to start using the Travelcard integration?

  1. To start using service ask your sales representative to activate "Use Travelcard fuel import" under your account.
  2. Orgnization vehicle(s) MUST have Travelcard card number added under Settings-> Vehicles->Properties -> FuelCard Number.

The integration works as follows:

  1. travelcard sends expense to sqs
  2. FC+ queries expense from sqs
  3. FC+ check if any vehicle has same fuel card number that expense has and then add expense to FC+ database
  4. delete expense from sqs
  • When pulling expense from SQS system will check which vehicle has same card number as transaction and will check if the customer is using Travelcard integration. If vehicle is found and customer uses integration - expense is posted to associated vehicle. If card not found then no expense is posted and transaction deleted from SQS.

* If 2 vehicles are found with same card number and in both cases customer using travel card integration - no transaction gets posted (internal logs will be addedwhere the error is logged that same card is added to 2 vehicles).

* If 2 vehicles are found with same card number and one of the customers is using Travelcard integration - transaction gets posted for that customer’s vehicle.

Powered by Zendesk