Report Elements and Sub-Elements
The following section explains the elements and sub-elements in a Fleet EDS report. See the Fleet EDS Report Example and the Fleet EDS Schema for example and schema details.
Transaction Element
The Transaction element includes basic details of the transaction. Both the TransactionID and TransactionDate sub-elements in Transaction are required.
There are other sub-elements under Transaction which include:
FleetData-
PromptData -
EVData -
LineItems
|
Category Name |
Description |
Field Definition |
Permitted Values/Constraints |
|---|---|---|---|
|
TransactionID |
The Transaction ID of the Fleet EDS transaction. |
xs:long |
|
|
TransactionDate |
The date and time in which the transaction was processed. |
xs:dateTime |
Format YYYY-MM-DD |
|
FleetData |
Includes Fleet EDS information for the transaction, such as the total price of the fuel and/or non-fuel purchase. |
See Fleet Data |
|
|
PromptData |
Consists of Fleet EDS details that are captured on a POS machine. For example, this sub-element includes any Fleet EDS IDs that are recorded for the fuel or non-fuel purchase. |
See PromptData |
|
|
EVData |
Includes specific information on electrical vehicle charging. |
See EVData |
|
|
LineItems |
Contains the InvoiceLineItem sub-element that has invoice information on the Fleet EDS transaction. LineItems is only populated if the Transaction Type of the Fleet EDS transaction is a Presentment. A single transaction may contain separate line items, such as for petrol, food and drink purchases. |
See InvoiceLineItem |
|
Example
<?xml version="1.0" encoding="utf-8"?>
<Transactions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Transaction>
<TransactionId>6152571162</TransactionId>
<TransactionDate>2026-02-22T06:36:04.887</TransactionDate>
<FleetData>
...detail omitted...
</FleetData>
<PromptData>
...detail omitted...
<FleetAdditionalPromptData2>PROMPTDATA0987654321</FleetAdditionalPromptData2>
</PromptData>
<EVData>
...detail omitted...
</EVData>
<LineItems>
...detail omitted...
</LineItems>
</Transaction>
</transactions>
FleetData Sub-Element
The following table includes settings that describe Fleet EDS information.
|
Element |
Description |
Data Type |
Permitted Values/Constraints |
|---|---|---|---|
|
TypeOfPurchase |
The type of purchase in the Fleet EDS transaction. For example, the cardholder purchased fuel and non-fuel products. |
xs:string |
1 character. The options are: 1 = single fuel code 2 = non-fuel purchase 3 = fuel and non-fuel purchase |
|
ServiceType |
Defines the category of the service. For example, the cardholder used Self Service. |
xs:string |
1 character. The options are: F = Full Service S = Self Service H = High speed dispense
|
|
FuelType |
The type of fuel. Refer to Appendix H of the Fleet EDS 2.0 Implementation Guide, |
xs:string |
2 character code |
|
ExpandedFuelType |
Includes the same values in Fuel Type. Four digit values are included to allow for more fuel types in the future. |
xs:string |
4 character code |
|
UnitOfMeasure |
The measurement unit for the type of purchase, such as petrol or EV charging. For example, US Gallon for the USA. |
xs:string |
1 character. The options are: C = Charging minutes G =US Gallon I = Imperial Gallon L = Litre P = Pound |
|
Quantity |
Quantity of the fuel. |
xs:decimal |
Value up to four decimal places |
|
UnitCost |
Unit cost in the transaction currency. |
xs:decimal |
Value up to four decimal places |
|
GrossFuelPrice |
Fuel price in the transaction currency before any deductions. |
xs:decimal |
Value up to four decimal places |
|
NetFuelPrice |
Fuel price in the transaction currency after any deductions. |
xs:decimal |
Value up to four decimal places |
|
GrossNonFuelPrice |
Price of item that is not fuel in the transaction currency, e.g., parking. The price is before any deductions. |
xs:decimal |
Value up to four decimal places |
|
NetNonFuelPrice |
Price of a non- fuel item in the transaction currency, e.g., parking. The price is after any deductions. |
xs:decimal |
Value up to four decimal places |
|
LocalTaxIncluded |
Indicates if a local tax is included in the price, e,g., a state tax. |
xs:string |
1 character. The options are: 0 = Tax not included 1 = State or provincial tax |
|
LocalTax |
If LocalTaxIncluded is set, the price of the fuel that includes the local tax amount. |
xs:decimal |
Value up to four decimal places |
|
NationalTaxIncluded |
Indicates if a national tax is included in the price, e.g., state income tax. |
xs:string |
1 character. The options are: 0 = Not subject to tax 1 = Subject to tax
|
|
NationalTax |
If NationalTaxIncluded is set, the price of the fuel that includes the national tax amount. |
xs:decimal |
Value up to four decimal places |
|
OtherTax |
The fuel price that includes tax amounts that are other than the previously-mentioned categories. |
xs:decimal |
Value up to four decimal places |
|
VatTaxRate |
The amount of VAT that is included with the fuel price. |
xs:decimal |
Value up to two decimal places |
|
VatDocumentationIndicator |
Indicates if the merchant has approved an invoice that is provided directly by the Issuer. |
xs:string |
2 characters |
|
VatText |
Description of the VAT, such as how it is issued. |
xs:string |
256 characters |
|
NonFuelProductCode1 |
Product code of the non-fuel product that is part of the purchase. Up to eight entries exist for the different types of product purchases that can exist in a transaction.
|
xs:string |
2 character code
|
|
NonFuelProductCode2 |
|||
|
NonFuelProductCode3 |
|||
|
NonFuelProductCode4 |
|||
|
NonFuelProductCode5 |
|||
|
NonFuelProductCode6 |
|||
|
NonFuelProductCode7 |
|||
|
NonFuelProductCode8 |
Example
<FleetData>
<TypeOfPurchase>F</TypeOfPurchase>
<ServiceType>S</ServiceType>
<FuelType>FA</FuelType>
<ExpandedFuelType>DIES</ExpandedFuelType>
<UnitOfMeasure>W</UnitOfMeasure>
<Quantity>313</Quantity>
<UnitCost>0.1458</UnitCost>
<GrossFuelPrice>456.35</GrossFuelPrice>
<NetFuelPrice>365.08</NetFuelPrice>
<GrossNonFuelPrice>250.00</GrossNonFuelPrice>
<NetNonFuelPrice>200.00</NetNonFuelPrice>
<LocalTaxIncluded>N</LocalTaxIncluded>
<LocalTax></LocalTax>
<NationalTaxIncluded>N</NationalTaxIncluded>
<NationalTax></NationalTax>
<OtherTax>12.55</OtherTax>
<VatTaxRate>20.00</VatTaxRate>
<VatDocumentationIndicator>11</VatDocumentationIndicator>
<VatText />
<NonFuelProductCode1>41</NonFuelProductCode1>
<NonFuelProductCode2></NonFuelProductCode2>
<NonFuelProductCode3></NonFuelProductCode3>
<NonFuelProductCode4></NonFuelProductCode4>
<NonFuelProductCode5></NonFuelProductCode5>
<NonFuelProductCode6></NonFuelProductCode6>
<NonFuelProductCode7></NonFuelProductCode7>
<NonFuelProductCode8></NonFuelProductCode8>
</FleetData>
PromptData Sub-Element
The following table includes settings that describe Fleet EDS information that is captured on a POS system.
|
Element |
Description |
Data Type |
Permitted Values/Data constraints |
|---|---|---|---|
|
OdometerReading |
Odometer reading at the time of the transaction. |
xs:string |
7 characters |
|
VisaFleetServiceId |
Vehicle ID, Driver ID or generic ID used in the transaction. |
xs:string |
20 characters |
|
FleetWorkOrderNumber |
Number at the prompt to identify the Fleet EDS order/purchase. |
xs:string |
30 characters |
|
FleetEmployeeNumber |
Employee number for the Fleet EDS cardholder. |
xs:string |
12 characters |
|
FleetTrailerNumber |
Number assigned to the Fleet EDS trailer. |
xs:string |
16 characters |
|
FleetAdditionalPromptData1 |
Contains information that the cardholder provides at the POS for issuer and employer purposes. |
xs:string |
20 characters |
|
FleetAdditionalPromptData2 |
Contains information that the cardholder provides at the POS for issuer and employer purposes. |
xs:string |
20 characters |
Example
<PromptData>
<OdometerReading>1234567</OdometerReading>
<VisaFleetServiceId>VS123456789012345678</VisaFleetServiceId>
<FleetWorkOrderNumber>WO1234567890123456789012345678</FleetWorkOrderNumber>
<FleetEmployeeNumber>EMP123456789</FleetEmployeeNumber>
<FleetTrailerNumber>TRAILER123456789</FleetTrailerNumber>
<FleetAdditionalPromptData1>PROMPTDATA1234567890</FleetAdditionalPromptData1>
<FleetAdditionalPromptData2>PROMPTDATA0987654321</FleetAdditionalPromptData2>
</PromptData>
EVData Sub-Element
The following table includes settings that describe EV data.
|
Element |
Description |
Data Type |
Permitted Values/Data constraints |
|---|---|---|---|
|
ChargingPowerOutputCapacity |
The charging station power output capacity in kWh. |
integer |
|
|
ChargingReasonCode |
Reason code that provides the status of the charging session. Includes any charging issues if these exist. |
xs:string |
6 characters |
|
MaximumPowerDispensed |
The maximum power dispensed during the specific session from the charging station. This can be different from the power output capacity of the station based on power management by the site operator. |
integer |
|
|
ConnectorType |
A Visa-defined code for a specific connector type for the electrical vehicle charging. Identifies the connection/electrical vehicle for the charge session. |
xs:string |
3 characters |
|
TotalTimePluggedIn |
The total time the power device is plugged in to the vehicle. |
xs:string |
Format: hhmmss |
|
TotalChargingTime |
The total time for EV charging. This may/may not be the same as the TotalTimePluggedIn. |
xs:string |
Format: hhmmss |
|
StartTimeOfCharge |
The start time of EV charging. |
xs:string |
Format: hhmmss |
|
FinishTimeOfCharge |
The finish time of EV charging. |
xs:string |
Format: hhmmss |
|
EstimatedKmMilesAdded |
Estimate of the total distance added in km/miles, Based on the kWh added, and the type of vehicle engine charged. |
integer |
|
|
CarbonFootprint |
Provides the Carbon Footprint avoidance measurement for the purchase, indicating how much was saved from the charge. Measured in grams of carbon dioxide equivalent (CO2e). |
integer |
|
|
EstimatedKmMilesAvailable |
Estimate of the total distance added in km/miles, Based on the kWh added, and the type of vehicle engine charged. |
integer |
|
|
MessageIdentifierTC50 |
The clearing record format used by Acquirers to transmit extended data to Visa. |
xs:string |
15 characters |
Example
<EVData>
<ChargingPowerOutputCapacity>352</ChargingPowerOutputCapacity>
<ChargingReasonCode>100</ChargingReasonCode>
<MaximumPowerDispensed>313</MaximumPowerDispensed>
<ConnectorType>C12</ConnectorType>
<TotalTimePluggedIn>011229</TotalTimePluggedIn>
<TotalChargingTime>011055</TotalChargingTime>
<StartTimeOfCharge>140612</StartTimeOfCharge>
<FinishTimeOfCharge>151707</FinishTimeOfCharge>
<EstimatedKmMilesAdded>478</EstimatedKmMilesAdded>
<CarbonFootprint>3186982</CarbonFootprint>
<EstimatedKmMilesAvailable>534</EstimatedKmMilesAvailable>
<MessageIdentifierTc50>601248719022567</MessageIdentifierTc50>
</EVData>
LineItems Sub-Element
The following table includes settings that describe invoice information.
|
Element |
Description |
Data Type |
Required |
Constraints/Permitted Values |
|---|---|---|---|---|
|
InvoiceLineItem |
Item that is invoiced. There are one or more occurrences of the InvoiceLineItem element corresponding to each item that is invoiced. For example, the InvoiceLineItem can have multiple entries for petrol, food, and drink. |
<InvoiceLineItem> |
Yes |
See InvoiceLineItem |
InvoiceLineItem Sub-Element
The InvoiceLineItem sub-element includes information that is used in the invoice such as the total cost of the line item. The sub-element also includes tax information.
|
Element |
Description |
Field Definition |
Constraints/Permitted Values |
|---|---|---|---|
|
ItemSequenceNumber |
The sequence number of the product in the invoice. |
numeric |
|
|
ItemDescription |
The description of the item in the invoice. |
xs:string |
26 characters |
|
ProductCode |
The code of the product in the invoice. |
xs:string |
12 characters |
|
CommodityCode |
Description of the product. |
xs:string |
12 characters |
|
Quantity |
Quantity of the fuel. |
xs:decimal |
Value up to four decimal places |
|
UnitOfMeasure |
The measurement unit for the type of purchase. For example, for petrol purchases in the USA, it is US Gallon. |
xs:string |
12 characters |
|
UnitCost |
Unit cost in the transaction currency, allowing up to four decimal places. |
xs:decimal |
Value up to four decimal places |
|
DiscountPerLineItem |
The discount of the line item as a percentage. |
xs:decimal |
Value up to four decimal places |
|
LineItemTotal |
The total amount of the line item in the transaction currency. |
xs:decimal |
Value up to four decimal places |
|
VatTaxAmount |
Value-added tax amount for the fuel purchased in the transaction currency. |
xs:decimal |
Value up to four decimal places |
|
VatRate |
Value-added tax rate for the fuel purchased in the transaction currency. |
xs:decimal |
Value up to two decimal places |
Example
<LineItems>
<InvoiceLineItem>
<ItemSequenceNumber>101</ItemSequenceNumber>
<ItemDescription>Fuel</ItemDescription>
<ProductCode>PRDCOD500001</ProductCode>
<CommodityCode>AAbbCCddEE11</CommodityCode>
<Quantity>20.0000</Quantity>
<UnitOfMeasure>Gallo1</UnitOfMeasure>
<UnitCost>1.5001</UnitCost>
<DiscountPerLineItem>2.0100</DiscountPerLineItem>
<LineItemTotal>30.0100</LineItemTotal>
<VatTaxAmount>2.2100</VatTaxAmount>
<VatRate>1.51</VatRate>
</InvoiceLineItem>
</LineItems>