Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/JorLOrT/rappi2/llms.txt

Use this file to discover all available pages before exploring further.

Rappi2 is a production-ready logistics API built with FastAPI that manages the full delivery lifecycle — from order creation and driver assignment through GPS tracking, route planning, and financial reporting. It uses a hybrid persistence model: PostgreSQL handles transactional data (orders, users, payments) while MongoDB handles geospatial data, audit logs, and multimedia evidence.

Quickstart

Deploy Rappi2 with Docker and make your first API call in minutes

Authentication

Get a JWT token and authenticate your requests

Order Lifecycle

Manage orders from creation through delivery

API Reference

Explore every endpoint with request and response schemas

​
What Rappi2 does

Rappi2 covers all the operations a logistics platform needs:
  • Order management — Create orders, track status through Pendiente → En Proceso → En Tránsito → Entregado, manage payments and invoices
  • Driver & vehicle operations — Maintain a fleet of drivers and vehicles, assign them to orders with availability checks
  • GPS tracking — Record real-time GPS pings, query driver proximity, and check geofence containment
  • Route planning — Integrate with OpenRouteService to calculate optimal routes and automatically generate geofences along corridors
  • Security — JWT access tokens (15-min expiry) with rotating refresh tokens, RBAC with resource/action permissions
  • Analytics — Dashboard KPIs, SLA reporting, driver efficiency, sales trends, and geographic distribution

​
Architecture at a glance

Architecture

Modular FastAPI monolith with hybrid database

Data model

PostgreSQL schemas and MongoDB collections

RBAC

Role-based access control with wildcard permissions

Deployment

Docker Compose setup with PostgreSQL and MongoDB

​
Guides

GPS tracking

Send pings, query nearby drivers, check geofences

Route planning

Plan routes via OpenRouteService and auto-generate geofences

Reports & analytics

Query KPIs, SLA metrics, and driver efficiency

Order lifecycle

Step-by-step order flow from creation to delivery

Build docs developers (and LLMs) love

Get started for freeTalk to us