Overview

Fetch all the fuel purchases of your company

  • Endpoint: v1/fuel_purchases
  • Description: Retrieves a complete list of all fuel purchase transactions made by the company. This can include details like purchase date, fuel type, volume, price, and the associated vehicle or driver.
  • Use Case: Fleet managers or financial teams can review and analyze fuel expenses over a certain period, track consumption, and manage fuel budgets effectively.

View the fuel purchases by an ID

  • Endpoint: v1/fuel_purchases/{id}
  • Description: Fetches details for a specific fuel purchase by its unique transaction ID, allowing access to purchase details like fuel type, volume, and transaction date.
  • Use Case: A manager might use this to verify individual transactions, validate data for reporting, or troubleshoot any discrepancies in specific fuel purchases.

Create a new fuel purchase transaction

  • Endpoint: v1/fuel_purchases
  • Description: Adds a new fuel purchase transaction into the system with all required details such as fuel type, purchase volume, price, and date.
  • Use Case: This endpoint is used when a company records a new fuel transaction, either manually by admin entry or automatically through integrated fuel card purchases.

Import fuel purchases via CSV upload

  • Endpoint: v1/fuel_purchase_imports
  • Description: Allows bulk import of multiple fuel purchase records through a CSV file, streamlining data entry for large volumes of transactions.
  • Use Case: Companies with numerous daily fuel transactions can efficiently upload them in bulk from a fuel provider’s CSV report, saving time and ensuring accurate data records.

Update an existing fuel purchase

  • Endpoint: v1/fuel_purchases/{id}
  • Description: Modifies details for an existing fuel purchase transaction, allowing corrections or updates to information like purchase date, price, or fuel volume.
  • Use Case: If a transaction was entered incorrectly or if adjustments are needed after a review, admins can update it directly instead of re-entering the data.

Delete a specific fuel purchase

  • Endpoint: v1/fuel_purchase?{id}
  • Description: Removes a specific fuel purchase record from the system using its unique ID, effectively deleting it from company records.
  • Use Case: This endpoint is useful for removing duplicate or erroneous entries, helping maintain accurate fuel expense data in company records.