Enhanced Commercial Data (L2/L3)

Enhanced commercial data (L2/L3 data) allows Lithic customers to get a deeper view of end-user purchasing behavior, enabling better support for corporate expense programs, fleet cards, and more.

Level 2 (L2) data includes general purchase data which typically describes the transaction as a whole, for example total tax amount or fuel type for a fuel-only fleet transaction. Level 3 (L3) data includes more granular information which describes individual elements within a transaction. Users can think of L3 data as a digital receipt containing item descriptions, item quantities, and product codes.

Typically merchants only include L2/L3 data for transactions on commercial BINs. They provide this data in an attempt to qualify for cheaper interchange rates. In return for less interchange, issuers are provided enhanced reconciliation and visibility into program spend.

Types of Enhanced Commercial Data

L2 Tax Data

L2 commercial data enhances transaction details by providing more descriptive information, including tax details, which are essential for businesses to streamline their accounting and tax reporting processes. When a cardholder uses a card which supports L2 data, transactions capture additional information such as sales tax amount, customer code, purchase order number, and tax identification number. This detailed data helps businesses comply with tax regulations, simplify tax preparation, and improve financial transparency.

Industry-Specific Data

Enhanced commercial data can provide more granular transaction information tailored to specific industries, including fleet, lodging, vehicle rental, passenger transport, and shipping. This enhanced data helps businesses manage expenses more efficiently, comply with industry regulations, and improve operational transparency.

For the fleet industry, L2 data includes fuel type, vehicle identification number (VIN), driver ID, and odometer readings, enabling precise tracking of fuel expenses and vehicle usage. In lodging, enhanced commercial data covers room rates, number of nights, check-in/check-out dates, and folio numbers, facilitating accurate expense management and compliance with travel policies.

Vehicle rental transactions benefit from enhanced commercial data by capturing rental duration, vehicle type, and additional charges, while passenger transport data includes passenger details, travel dates, and route information. Shipping industry transactions gain from enhanced commercial data with shipment details, weight, and delivery dates, improving cost allocation and operational efficiency.

L3 Line-item Data

L3 commercial data provides the highest level of transaction detail, including line-item information that is essential for comprehensive expense management. This data is particularly beneficial for industries that require detailed purchase breakdowns, such as government, manufacturing, and retail.

L3 data includes specific details about each item in a transaction, such as item description, quantity, unit price, total price, and tax amount. This granularity allows businesses to track spending at the item level, facilitating accurate cost allocation and inventory management. For example, in manufacturing, L3 data helps track the purchase of raw materials and components, ensuring precise cost control and efficient production planning.

In government and retail sectors, L3 line-item data aids in compliance with stringent reporting requirements and internal audit processes. Detailed transaction information supports better procurement practices, fraud detection, and improved vendor management. Additionally, it enhances the accuracy of financial reporting and budgeting by providing a clear view of all purchased items.

Get Enhanced Data for a Specific Transaction

API Reference: List Enhanced Commercial Data

GET https://api.lithic.com/v1/transactions/{transaction_token}/enhanced_commercial_data

Sample Request

curl https://api.lithic.com/v1/transactions/764fa5a3-2371-40f0-8cbb-9a2e1230d955/enhanced_commercial_data
  -H "Authorization: YOUR_API_KEY"

Sample Response

{
    "data": [
        {
            "token": "fda41769-2a3f-5532-898f-0d2034f2da85",
            "transaction_token": "6b79924e-0f01-4bdf-9485-9f6da44b6be2",
            "event_token": "49bbd49c-dfe1-56db-86ad-98c7c2bd75e4",
            "common": {
                "customer_reference_number": null,
                "merchant_reference_number": null,
                "order_date": null,
                "line_items": [],
                "tax": {
                    "merchant_tax_id": "521236050",
                    "amount": null,
                    "exempt": null
                }
            },
            "fleet": [
                {
                    "service_type": "SELF_SERVICE",
                    "driver_number": null,
                    "vehicle_number": "012345",
                    "odometer": 12345,
                    "amount_totals": {
                        "gross_sale": 104,
                        "discount": null,
                        "net_sale": 104
                    },
                    "fuel": {
                        "quantity": "0.24300",
                        "type": "PREMIUM_SUPER",
                        "unit_of_measure": "GALLONS",
                        "unit_price": 4300
                    }
                }
            ]
        }
    ]
}
transaction_token (required, path parameter)Globally unique identifier for the transaction to be returned.
_String. Permitted values: 36-digit version 4 UUID (including hyphens).

Get Enhanced Data for a Specific Event

API Reference: Get Enhanced Commercial Data

GET https://api.lithic.com/v1/transactions/{event_token}/enhanced_commercial_data

Sample Request

curl https://api.lithic.com/v1/transactions/49bbd49c-dfe1-56db-86ad-98c7c2bd75e4/enhanced_commercial_data
  -H "Authorization: YOUR_API_KEY"

Sample Response

{
    "token": "fda41769-2a3f-5532-898f-0d2034f2da85",
    "transaction_token": "6b79924e-0f01-4bdf-9485-9f6da44b6be2",
    "event_token": "49bbd49c-dfe1-56db-86ad-98c7c2bd75e4",
    "common": {
        "customer_reference_number": null,
        "merchant_reference_number": null,
        "order_date": null,
        "line_items": [],
        "tax": {
            "merchant_tax_id": "521236050",
            "amount": null,
            "exempt": null
        }
    },
    "fleet": [
        {
            "service_type": "SELF_SERVICE",
            "driver_number": null,
            "vehicle_number": "012345",
            "odometer": 12345,
            "amount_totals": {
                "gross_sale": 104,
                "discount": null,
                "net_sale": 104
            },
            "fuel": {
                "quantity": "0.24300",
                "type": "PREMIUM_SUPER",
                "unit_of_measure": "GALLONS",
                "unit_price": 4300
            }
        }
    ]
}
event_token (required, path parameter)Globally unique identifier for the transaction to be returned.
String. Permitted values: 36-digit version 4 UUID (including hyphens).

Line Item Schema

{
    "product_code": String,
    "description": String,
    "quantity": String,
    "amount": String
}
product_codeProduct code for the goods or services purchased.
descriptionDescription of the goods or services purchased.
quantityDecimal number in string format of units of the goods or services purchased.
amountDecimal number in string format of unit cost for the goods or services purchased.

Fleet Schema

{
    "service_type": FuelServiceType,
    "vehicle_number": String,
    "driver_number": String,
    "odometer": Integer,
    "amount_totals": {
        "discount": Int,
        "gross_sale": Int,
        "net_sale": Int
    },
    "fuel": {
        "quantity": String,
        "type": FuelType,
        "unit_of_measure": FuelUnitOfMeasure,
        "unit_price": Integer
    }
}
amount_totals- discount: Amount of discount applied.
- gross_sale: Total sale amount before discounts.
- net_sale: Total sale amount after discounts.
driver_numberNumber entered by the cardholder at the terminal when Fleet card is configured to display prompts for DRIVER_NUMBER. This value is stripped of leading zeros. May be null.
fuelInformation about the fuel product purchased by the cardholder.

- fuel.quantity: Numeric quantity of fuel purchased, measured in fuel.unit_of_measure.
- fuel.total_price: Total price paid for the fuel purchased
- fuel.type: Type of fuel purchased. Possible values may be referenced below in Enumerations.
- fuel.unit_of_measure: Unit of measure of fuel purchased. Possible values may be referenced below in Enumerations.
- fuel.unit_price: Price for a single unit of fuel.
odometerNumber entered by the cardholder at the terminal when Fleet card is configured to display prompts for odometer. This value is stripped of leading zeros. May be null.
service_typeType of fuel service rendered (e.g. self service). Possible values may be referenced below in Enumerations.
vehicle_numberNumber entered by the cardholder at the terminal when Fleet card is configured to display prompts for VEHICLE_NUMBER. This value is stripped of leading zeros. May be null.

Enumerations

Fuel TypeRegular
Mid/Plus
Premium/Super
Premium/Super
Regular
Mid/Plus
Premium/Super
Premium/Super
Miscellaneous Other Fuel
Miscellaneous Other Fuel
Regular Diesel #2
Premium Diesel #2
Kerosene – Low Sulfur
Liquid Propane Gas
Compressed Natural Gas
Miscellaneous Other Fuel
E-85
Regular
Mid/Plus
Premium/Super
Premium/Super
Miscellaneous Other Fuel
Reformulated 1
Reformulated 3
Diesel #2 Off-Road (Non-Taxable)
Diesel #2 Premium Off-Road (Non-Taxable)
B100 Diesel Blend 100% Biodiesel
Regular Diesel #2
Aviation Fuel Regular
Jet Fuel
Miscellaneous Aviation Fuel
Miscellaneous Marine Fuel
Miscellaneous Fuel
Liquid Natural Gas
White Gas
Racing Fuel
EVC-1 – Level 1 charge = 110v 15 amp
EVC-2 – Level 2 charge = 240v 15-40 amp
EVC-3 – Level 3 charge = 480v 3 phase charge
Biodiesel Blend Off-Road (Non-Taxable)
Diesel #2 Off-Road (Non-Taxable)
DEF (Diesel Exhaust Fluid)
Unknown
FuelUnitOfMeasureGallons
Liters
Pounds
Kilograms
Imperial gallons
Not Applicable
Unknown
FuelServiceTypeUnknown
Undefined
Self-service
Full service
Non-fuel only