Ditat Transportation Management

Integrate With Breakthrough Fuel


Breakthrough Fuel allows daily fuel prices to be updated automatically for fuel surcharge calculations.


Account Settings

image-20250221-215813.png
Account Settings section

Field

Description

Account Id

Enter the account ID provided by Breakthrough Fuel.

Notify Group

Select the user group that should receive notifications. Users in this group who have Ditat mail forwarded to their email will receive an email with the Breakthrough Fuel Excel file.

Description

Enter a description for this account.

URL

Enter the FTP URL. Default: b2bftp.breakthroughfuel.com

Port

Enter the FTP port. Default: 21

User name

Enter the FTP username.

Password

Enter the FTP password.

Outgoing folder

Enter the outgoing folder path if one is required.

Apply mode

Select Add Only to add fuel charges only to shipments that do not already have one. If a fuel charge already exists, it will be skipped and noted in the emailed Excel file. Select Add or Update to add fuel if none exists or update the existing fuel charge if one is already present.

Note: Breakthrough Fuel notifications are sent exclusively via email and include a detailed attachment showing what was successfully applied and what was not. Users who are not configured to receive email copies will not receive these notifications. To ensure your team is informed of any items that could not be applied, it is recommended to create a dedicated user assigned only to this notify group who is set up to receive emails.


Customers/Shippers

image-20231107-132752.png
Customers/Shippers

Field

Description

BT Shipper

Enter the code that Breakthrough Fuel uses for this customer.

BT Field

Select which Breakthrough Fuel code to match to the shipment reference field below.

Customer

Select the Ditat customer to link to this Breakthrough Fuel setup.

Shipment reference

Select which shipment reference number field to match to the BT Field above.

Note: If a fuel charge already exists on a shipment, Ditat will not apply fuel from the Breakthrough Fuel file for that shipment. This will be noted in the Excel file sent via email.


Breakthrough Fuel File Requirements

Ditat is configured to download .dat files only when a corresponding .trg file is present. The .trg file should only be uploaded once the .dat file has been fully processed and is ready for download.

Both files must follow this naming format:

btf_fuel_recovery_0003_ACCOUNTID_DATESTAMP.dat