Welcome to ICL Cotizaciones
ICL Cotizaciones is a comprehensive freight quotation management SaaS platform designed for international logistics operations. Built with Next.js 16 and modern web technologies, it streamlines the entire quotation lifecycle from creation to closing.Quickstart
Get up and running in 5 minutes with your first quotation
Installation
Detailed setup instructions for development and production
User Roles
Understanding the 6 role-based access control levels
Quotation Management
Create and manage FCL/LCL freight quotations
Key Features
Role-Based Access Control
Role-Based Access Control
Six distinct roles with granular permissions:
- DIRECTOR: Full system access and administrative control
- GERENTE: Management-level access to all quotations
- ADMINISTRACION: Administrative functions and reporting
- COMERCIAL: Sales representatives managing their own quotations
- CSV: Customer service operations
- OPERACIONES: Operations team with quotation visibility
Freight Quotation Management
Freight Quotation Management
Complete quotation lifecycle management:
- FCL & LCL Support: Handle both Full Container Load and Less than Container Load shipments
- Auto-numbering: Automatic quote number generation with format
COT-YYMM-NNNN - Route Management: Track origin, via ports, and destination with comprehensive location database
- Cost Structure: Detailed net/sale pricing for freight and origin costs
- Status Tracking: Five-state lifecycle (En Cotización, Ganada, Perdida, Pendiente, Pend A/C)
- Profit Calculation: Automatic margin calculation between net and sale prices
Client & Agreement Management
Client & Agreement Management
Robust client relationship tools:
- Client Types: FFWW (freight forwarder), Final (end client), or Both
- Commercial Agreements: Store negotiated rates, payment terms, and special conditions
- Auto-assignment: Clients linked to their designated sales representatives
- Agreement Loading: Automatic population of fiscal deposit costs from stored agreements
Pricing Intelligence
Pricing Intelligence
Sophisticated pricing management:
- Port Rate Tables: Base tariffs by port of loading with volume-based pricing tiers
- Net Pricing Tables: Unified FCL/LCL rate management with currency support (USD, EUR, ARS)
- Auto-suggestions: System recommends freight rates based on port and cargo volume
- Rate Validity: Track pricing validity periods for compliance
Analytics & Dashboards
Analytics & Dashboards
Business intelligence at your fingertips:
- Weekly Grouping: Quotations organized by calendar week for pipeline visibility
- Multi-dimensional Filtering: Filter by date range, client, status, sales rep, and port
- Profit Analysis: Real-time margin tracking across all quotations
- Export Capabilities: Generate reports in multiple formats
Technology Stack
Frontend
- Next.js 16 (App Router)
- React 19 with Server Components
- Tailwind CSS v4
- Radix UI primitives
- TanStack Table for data grids
Backend
- Next.js API Routes
- SQLite with better-sqlite3
- Drizzle ORM
- Iron Session for auth
- bcryptjs for password hashing
DevOps
- TypeScript 5.9
- Drizzle Kit for migrations
- WAL mode for concurrent access
- Node.js runtime
Core Entities
The system manages five primary data entities:| Entity | Description | Key Fields |
|---|---|---|
| Quotations | Freight quotes with full pricing | Quote number, route, cargo details, costs, status |
| Clients | FFWW customers and end clients | Legal name, tax ID, client type, assigned sales rep |
| Commercial Agreements | Negotiated terms per client | Rate schedules, fiscal deposit costs, payment terms |
| Locations | Ports and origin cities | Name, country, region, type (origin/via) |
| Pricing Tables | Base rates and net pricing | Port rates, FCL/LCL pricing, volume tiers, validity |
All quotations include automatic profit calculation:
profit = (freight_sale - freight_net) + (origin_costs_sale - origin_costs_net)Quotation Workflow
Getting Started
Ready to deploy ICL Cotizaciones? Follow our quickstart guide to get your instance running:Quickstart Guide
Install dependencies, seed the database, and create your first quotation in under 5 minutes
Database Schema Highlights
ICL Cotizaciones uses SQLite with the following key tables:Support & Documentation
API Reference
Complete REST API documentation with examples
Deployment Guide
Production deployment best practices