Working Offline

Overview

MotorDesk is built with offline-first architecture, meaning you can continue working even without internet connectivity. All critical operations are saved locally and automatically sync when your connection is restored.

MotorDesk is described in its configuration as an “offline-first” fleet management and electronic billing system, ensuring uninterrupted operations in the field.

How Offline Mode Works

Automatic Detection

The system automatically detects your connectivity status:

Online: All operations sync immediately to the server
Offline: Operations are saved locally with PENDING sync status
Reconnected: Pending items automatically sync in the background

Sync Architecture

MotorDesk uses Redux state management with sagas for sync operations:

// Sales are tagged with sync status
interface Sale {
    id: string;
    clienteId: string;
    montoTotal: number;
    sync_status: 'PENDING' | 'SYNCED';
}

When you create an invoice offline:

Invoice is saved locally with sync_status: 'PENDING'
You can continue working immediately
System monitors for reconnection
When online, syncPendingSales() function triggers
Pending items sync to server
Status updates to SYNCED

What Works Offline

Invoice Creation

Fully Functional:

Create new invoices and sales receipts
Add products from cached inventory
Select customers from local database
Calculate totals and taxes
Save documents with PENDING status

Use frequent products feature for faster offline invoicing - no search required.

Customer Management

Available:

View existing customer directory
Edit customer information
Search through customer records
Create invoices for existing customers

Limited:

❌ API validation (RUC/DNI lookup) requires internet
✅ Manual customer registration still works

Fleet Management

Fully Functional:

View vehicle fleet
Add new vehicles
Edit vehicle information
Update odometer readings
View maintenance alerts
Search and filter vehicles

Product Catalog

Available:

Browse products
Search by name or barcode
View prices and descriptions
Add products to invoices

The product catalog is cached locally, so you have access to your full inventory offline.

What Requires Internet

The following features require an active internet connection:

API Document Validation: RUC/DNI lookup from SUNAT/RENIEC
SUNAT Submission: Electronic invoice submission to tax authority
Real-time Sync: Immediate server synchronization
Cloud Backups: Automatic backup to cloud storage
Multi-device Sync: Syncing data across multiple devices/locations

Offline Sync Process

Work Offline

Continue your normal operations:

Create invoices
Register vehicles
Update customer information
Process sales

Each operation is saved locally with appropriate sync markers.

Monitor Sync Status

The system shows pending sync items:

Look for sync status indicators in the UI
Pending items are marked clearly
You can see what’s waiting to sync

Check the sync indicator regularly to know when you have pending operations.

Reconnect to Internet

When your connection is restored:

System detects the RECONNECTED event
syncPendingSales() saga triggers automatically
All PENDING items queue for sync
Progress indicators show sync status

Automatic Sync

The system processes pending items:

Sends data to server in order
Updates sync_status from PENDING → SYNCED
Confirms successful sync
Resolves any conflicts automatically

You don’t need to do anything - sync happens automatically in the background.

Before Going Offline

Pre-Offline Checklist

Sync Recent Changes

Ensure all recent work is synced:

Check sync status indicator shows no pending items
Wait for any in-progress syncs to complete
Verify recent invoices show SYNCED status

Verify Local Data

Confirm you have the data you need:

Customer directory is current
Product catalog is up to date
Vehicle information is recent
Pricing is correct

Check Device Storage

Ensure adequate space:

Local database has room to grow
Enough space for new invoices
Room for cached data

Logging Out Offline

When you log out with pending sync items:

A special modal appears:¿Cerrar Sesión?“Estás a punto de salir del sistema. Si tienes transacciones offline pendientes de sincronizar, se guardarán de forma segura en este dispositivo.”

Your pending transactions:

✅ Are saved securely on the device
✅ Will sync next time you log in (when online)
✅ Won’t be lost during logout
✅ Remain associated with your account

Best Practices for Offline Work

Data Management

Keep Local Cache Fresh
- Sync regularly when online
- Update product catalog before going offline
- Refresh customer data periodically
Monitor Storage
- Check device storage regularly
- Clear old cached data if needed
- Ensure adequate space for operations
Sync Frequently
- Don’t accumulate too many pending items
- Sync daily if possible
- Process pending queue regularly

Workflow Tips

Use Frequent Products
- Pre-configure common service items
- Speeds up offline invoice creation
- Reduces search requirements
Register Customers in Advance
- Add customers when online (for API validation)
- Build customer directory before field work
- Verify all information is complete
Update Vehicle Data Online
- Complete vehicle registrations when connected
- Ensures all data is properly synced
- Reduces offline data entry
Preview Before Processing
- Use VISTA PREVIA for complex invoices
- Verify all information is correct
- Catch errors before creating PENDING items

Field Service Scenarios

Mobile Service Technician:

Sync data at start of day (at office with WiFi)
Drive to customer locations (offline)
Create invoices on-site (saved as PENDING)
Continue to next customer
Return to office, auto-sync all invoices

Remote Branch Office:

Work normally despite intermittent connectivity
System handles connection drops gracefully
Operations never interrupted
Automatic sync when connection available
Central office receives all data

Troubleshooting Offline Mode

Pending Items Not Syncing

Check Connection

Verify internet connectivity:

Test other websites/apps
Check WiFi or mobile data
Confirm no firewall blocking

Review Sync Status

Look for error indicators:

Failed sync messages
Connection timeout warnings
Server unavailable notices

Manual Retry

If auto-sync fails:

Look for manual sync button
Trigger sync from settings
Check sync queue status

Data Conflicts

If the same record is edited offline and online:

System uses timestamp-based conflict resolution
More recent changes typically win
Critical data may require manual review
Conflict notifications appear in UI

Avoid editing the same invoices on multiple devices simultaneously to prevent conflicts.

Storage Issues

If device storage is full:

Pending syncs may fail to save
New invoices can’t be created
Error message indicates storage problem

Solution:

Free up device storage
Sync and clear old cached data
Consider archiving old records

Understanding Sync Status

Status Indicators

Status	Meaning	Action Required
SYNCED	Data is on server	None
PENDING	Waiting to sync	Connect to internet
SYNCING	Currently uploading	Wait for completion
FAILED	Sync error occurred	Review and retry

Timestamping

The system tracks:

syncedAt: When item last synced to server
Created timestamp: Original creation time
Modified timestamp: Last edit time

{
    id: "V-001",
    placa: "ABC-123",
    kmActual: 45000,
    syncedAt: "2023-10-25T10:01:00Z"  // Last sync time
}

Security in Offline Mode

Your data remains secure offline:

✅ Local database is encrypted
✅ Authentication tokens cached securely
✅ No data accessible without login
✅ Device-level security applies
✅ Data syncs over encrypted connection

Always log out on shared devices, even with pending syncs. The data remains secure and will sync when the authorized user logs back in.

Next Steps

Learn to Create Invoices in offline mode
Manage your Vehicle Fleet offline
Set up Customer Registration for offline work

Overview

Getting Started

Core Features

User Guides

Overview

How Offline Mode Works

Automatic Detection

Sync Architecture

What Works Offline

What Requires Internet

Offline Sync Process

Before Going Offline

Pre-Offline Checklist

Logging Out Offline

Best Practices for Offline Work

Data Management

Workflow Tips

Field Service Scenarios

Troubleshooting Offline Mode

Pending Items Not Syncing

Data Conflicts

Storage Issues

Understanding Sync Status

Status Indicators

Timestamping

Security in Offline Mode

Next Steps

Build docs developers (and LLMs) love

Overview

Getting Started

Core Features

User Guides

​Overview

​How Offline Mode Works

​Automatic Detection

​Sync Architecture

​What Works Offline

​What Requires Internet

​Offline Sync Process

​Before Going Offline

​Pre-Offline Checklist

​Logging Out Offline

​Best Practices for Offline Work

​Data Management

​Workflow Tips

​Field Service Scenarios

​Troubleshooting Offline Mode

​Pending Items Not Syncing

​Data Conflicts

​Storage Issues

​Understanding Sync Status

​Status Indicators

​Timestamping

​Security in Offline Mode

​Next Steps

Build docs developers (and LLMs) love

Overview

How Offline Mode Works

Automatic Detection

Sync Architecture

What Works Offline

What Requires Internet

Offline Sync Process

Before Going Offline

Pre-Offline Checklist

Logging Out Offline

Best Practices for Offline Work

Data Management

Workflow Tips

Field Service Scenarios

Troubleshooting Offline Mode

Pending Items Not Syncing

Data Conflicts

Storage Issues

Understanding Sync Status

Status Indicators

Timestamping

Security in Offline Mode

Next Steps