{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"a3d532fb-de1d-43ec-b162-3cf9f8f1946a","name":"Fuel Management","description":"The Fuel Management Project, developed in collaboration with Carefer, is an innovative platform aimed at optimizing the fuel management process within corporate fleets. This system integrates vehicles, drivers, and devices into a unified management platform, automating and streamlining operations to enhance efficiency, accuracy, and security.\n\n### Project Overview\n\nThe core of the Fuel Management System lies in its ability to provide a comprehensive solution for monitoring fuel consumption, managing vehicle utilization, and coordinating driver assignments through a centralized digital interface. The automation of these key processes significantly reduces manual oversight, fostering a more efficient and error-free operation.\n\n### Base URL for API Access\n\nTo interact with the Fuel Management System, two base URLs are provided, catering to different stages of development and deployment:\n\n- **Test Environment**: `https://fuel.test.carefer.co/api` - This URL is intended for development and testing purposes, allowing users to test API requests without affecting live data.\n- **Production Environment**: `https://fuel.carefer.co/api` - This URL is used for live operations, handling real data transactions and interactions in the production environment.\n    \n\n### Importing API Collection\n\nDevelopers can streamline their workflow by directly importing the Postman collection for all APIs using the following link, which avoids the need to manually add each API:  \n[Download Postman Collection](https://www.dropbox.com/scl/fi/odef34jte3z0ignyrwgxe/Fuel-Management.postman_collection.json?rlkey=93e7wx5c3ibxtot0lp27somhi&dl=1)\n\n### Journey for Adding a Fuel Filling Request\n\n1. **User Login**: The process begins with users securely logging into the system using credentials provided by Carefer, establishing authenticated access to the platform's features.\n2. **Adding Assets (Vehicle, Driver, Device)**: Users can proceed to add vehicles, drivers, and devices to the system in no particular order. Each entity is added independently:\n    - **Vehicles** are registered with details like make, model, and fuel type, integrating them into the fleet management system.\n    - **Drivers** are added by inputting their identification and contact information, making them available for assignments.\n    - **Devices**, equipped with unique identifiers such as IMEI, are linked to vehicles for enhanced tracking and operational management.\n3. **Creating a Subscription**: After the assets are registered, a subscription is created to associate a vehicle, its driver, and the device under one operational unit. This subscription facilitates streamlined management and access to platform services.\n4. **Obtaining an API-Key**: An API-key is generated specifically for the subscription. This key is crucial for authorizing secure API interactions, particularly for submitting fuel filling requests.\n5. **Adding a Fuel Filling Request**: With the API-key in place, the device can add a fuel filling request. This step involves detailing the required fuel amount, vehicle's location, and the device's IMEI to ensure the request is accurately processed according to the linked subscription.\n    \n\nThe described journey underscores the system's flexibility in managing assets and subscriptions, emphasizing the independence of adding vehicles, drivers, and devices. By adhering to this workflow, developers can efficiently integrate and manage fleet operations, leveraging automated processes to optimize fuel management tasks.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"12751377","team":1273208,"collectionId":"a3d532fb-de1d-43ec-b162-3cf9f8f1946a","publishedId":"2sA2rFQehT","public":true,"publicUrl":"https://doc.fuel.carefer.co","privateUrl":"https://go.postman.co/documentation/12751377-a3d532fb-de1d-43ec-b162-3cf9f8f1946a","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"fc451a"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/ce4c6580-6cc0-4ce8-b598-688e84bd5305/Q2FyZWZlciBMb2dvcy0wMS5wbmc=","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"fc451a"}},{"name":"light","logo":"https://content.pstmn.io/3ff45676-c51d-41a1-84a0-466c3d03f8e1/Q2FyZWZlciBMb2dvcy0wMS5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"fc451a"}}]}},"version":"8.10.1","publishDate":"2024-02-28T06:23:34.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/3ff45676-c51d-41a1-84a0-466c3d03f8e1/Q2FyZWZlciBMb2dvcy0wMS5wbmc=","logoDark":"https://content.pstmn.io/ce4c6580-6cc0-4ce8-b598-688e84bd5305/Q2FyZWZlciBMb2dvcy0wMS5wbmc="}},"statusCode":200},"environments":[{"name":"Fuel-Manag-Test","id":"a7a413a8-0050-4e3c-969f-d887330d01f6","owner":"33083272","values":[{"key":"URL","value":"https://fuel.test.carefer.co/api","enabled":true,"type":"default"},{"key":"V","value":"v1","enabled":true,"type":"default"},{"key":"TOKEN","value":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzA5NDYwODEzLCJpYXQiOjE3MDg1OTY4MTMsImp0aSI6IjdhOWNjZDJkZGNlMjQ4Y2RhNGM4NDU5ZTRlNjM5ODdkIiwidXNlcl9pZCI6MiwidXNlcm5hbWUiOm51bGx9.7SCMnyEEBgvWagbuFXbMVyUrLGkJ5Ij_-_oOJazJ3o4","enabled":true,"type":"secret"},{"key":"API-KEY","value":"50jlBtsV.ejgqjZrg8VRHBL6I5PESV8Qa3plpIoPF","enabled":true,"type":"any"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/9cc60280ce40a5486143ed1547e59a6112c89aaec017d1b8e04d1b450af0f79a","favicon":"https://carefer.co/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Fuel-Manag-Test","value":"33083272-a7a413a8-0050-4e3c-969f-d887330d01f6"}],"canonicalUrl":"https://doc.fuel.carefer.co/view/metadata/2sA2rFQehT"}