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

Copy
<?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
4 = fuel purchase (multiple fuel codes)

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
K = Kilowatt per hour

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

Copy
<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

Copy
<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

Copy
<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

Copy
<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>