Skip to main content

​
Welcome to Tanqueo Backend API

The Tanqueo Backend API is a comprehensive fleet management system designed to track fuel consumption (tanqueos), vehicle maintenance (engrases), documentation, budgets, and operational metrics for transportation and heavy equipment fleets.

​
Overview

Tanqueo Backend provides a robust REST API built with modern technologies to manage all aspects of fleet operations, from fuel tracking to maintenance scheduling and budget management.

​
Key Features

Fuel Management

Track fuel consumption, costs, and pump operations with detailed analytics and filtering

Maintenance Tracking

Monitor vehicle maintenance, lubrication services, and operational expenses

Document Management

Manage vehicle documentation including SOAT, RTM, insurance policies, and property cards

Budget Planning

Create and manage operational budgets with detailed line items and approval workflows

Fleet Administration

Complete vehicle fleet management with specifications, classifications, and operational areas

Authentication & Security

Secure API with Supabase authentication, JWT tokens, and Row Level Security (RLS)

​
Technology Stack

The Tanqueo Backend is built with a modern, production-ready stack:
  • Runtime: Node.js with TypeScript
  • Framework: Express.js 5.x
  • Database: PostgreSQL via Supabase
  • Authentication: Supabase Auth with JWT tokens
  • File Uploads: Multer for document handling
  • Validation: TypeScript interfaces and runtime validation

​
Core Dependencies

{
  "@supabase/supabase-js": "^2.89.0",
  "express": "^5.2.1",
  "typescript": "^5.9.3",
  "cors": "^2.8.5",
  "multer": "^2.0.2"
}

​
API Modules

The API is organized into the following modules:
ModuleEndpointDescription
Authentication/api/authUser login, logout, and token management
Tanqueos/api/tanqueosFuel tracking and pump operations
Engrases/api/engrasesMaintenance and lubrication services
Documents/api/documentosVehicle documentation management
Fleet/api/flotaVehicle and equipment management
Maintenance/api/mantenimientoMaintenance planning and tracking
Budgets/api/presupuestosBudget creation and management
Catalogs/api/catalogosMaster data catalogs
Uploads/api/uploadFile upload handling
Pump Balances/api/saldos-bombasFuel pump balance tracking

Quickstart

Get started with installation and your first API request

Authentication

Learn how to authenticate and secure your API requests

Architecture

Understand the system architecture and design patterns

Data Models

Explore the core data models and TypeScript interfaces

​
Health Check

Verify the API is running with the health check endpoint: 
curl https://your-api-url.com/api/health
Response: 
{
  "status": "OK",
  "message": "Servidor funcionando correctamente",
  "timestamp": "2026-03-04T12:00:00.000Z"
}

​
Support & Resources

For questions, issues, or feature requests, please contact your system administrator or refer to the internal documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us