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_code | Product code for the goods or services purchased. |
description | Description of the goods or services purchased. |
quantity | Decimal number in string format of units of the goods or services purchased. |
amount | Decimal 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_number | Number 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. |
fuel | Information 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. |
odometer | Number 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_type | Type of fuel service rendered (e.g. self service). Possible values may be referenced below in Enumerations. |
vehicle_number | Number 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 Type | Regular 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 |
FuelUnitOfMeasure | Gallons Liters Pounds Kilograms Imperial gallons Not Applicable Unknown |
FuelServiceType | Unknown Undefined Self-service Full service Non-fuel only |
Updated 5 months ago