Fuel is one of the biggest recurring expenses in trucking, so managing it efficiently in your TMS isn’t just helpful, it’s critical. Alvys supports fuel card integrations with providers like EFS, Comdata, TCS, QuickQ/Love’s, and Compass, offering automatic and manual fuel uploads, deductions, and clean reporting.
🔌 Step 1: Connect Your Fuel Provider
To begin using fuel features in Alvys, you’ll first need to connect your fuel card provider.
Go to Integrations
Select the Fuel category
Find your provider and click the Pencil button
Enter the required credentials (provided by your fuel card company)
Choose the subsidiaries this provider should apply to
Click Save
📚 Need help setting this up for a specific provider? View our integration guide collection
Some providers (like QuickQ and EFS) require you to contact their support and request API credentials or enable partner access before integration. Don’t skip this step — your credentials won’t work otherwise.
👤 Step 2: Link Fuel Cards to Drivers
Once the integration is active, Alvys needs to know which driver is using which fuel card.
Go to Assets → Drivers
Select a driver and open their profile
Click the “Fuel Card Numbers +” button
Enter:
The fuel card number
The provider (e.g., Comdata, EFS, Love's, etc.)
Whether fuel is discounted or needs to be deducted from the driver
Click Save
Repeat for all drivers using fuel cards.
📝 Some providers (like TCS) only require partial card numbers (e.g., last 4 digits). Double-check formatting guidelines in the integration article if unsure.
📥 Step 3: Import Fuel Transactions
You can upload fuel data in two ways — automatic sync (if supported) or manual import.
Manual Upload
Most providers support manual uploads via CSV:
Download the fuel transaction file from your fuel card portal
Go to Reports → Fuel Report
Click Transaction File Upload
Select your provider from the dropdown
Upload your CSV file
Alvys automatically matches transactions to drivers using card numbers, so make sure that part's configured beforehand.
Automatic Upload
If your provider supports it (like EFS or Love’s), Alvys can pull transactions daily at a scheduled time (usually around 1–2 AM EST).
Once enabled:
Alvys will sync fuel transactions from the last 1–2 days
Transactions are auto-mapped to your drivers
No need for manual uploads
⏱️ Time Zone Handling
Fuel providers use different time formats — some store transactions in UTC, others in local time. Alvys standardizes everything in UTC, but displays it in your local time zone based on your user profile settings.
This makes filtering and reporting more accurate, especially when working with multiple providers across time zones.
⏳ Heads up: You may need to expand your date filters by +/-1 day to catch edge-case transactions depending on your location.
Fuel management in Alvys is built to simplify what’s usually a messy, manual process. Whether you’re using full API integrations or uploading reports by hand, Alvys helps you keep fuel expenses organized, accurate, and tied to the right drivers.