Settings — Every Option Explained
A complete reference for every configuration option in Deprixa Plus.
How to Access Settings
Navigate to settings by clicking the gear icon in the sidebar, then select a section. Changes take effect immediately unless noted otherwise.
1. Company Profile
Path: Settings > Company
The Company Profile is the master record for your organization. This data appears on invoices, PDF labels, the public tracking page, and email footers.
Screenshot: Company Profile settings page
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Company Name | App branding, invoices, emails | text | required |
| Legal Name | Official documents, contracts | text | optional |
| Tax ID (NIT/RUC) | Invoice headers, tax reporting | text | optional |
| Notifications, customer contact | required | ||
| Phone | Shipment labels, tracking info | text | optional |
| Website | Public portal branding | url | optional |
| Address | Pickup locations, labels, geolocation | text | required |
| City | Pickup locations, labels, geolocation | text | required |
| State | Pickup locations, labels, geolocation | text | required |
| Country | Pickup locations, labels, geolocation | select | required |
Important
The Company Name and Address fields are printed on all customer-facing documents. Double-check spelling and formatting before going live.
2. Branding
Path: Settings > Branding
Customize the visual appearance of the entire application. Changes are applied in real time with a live preview panel before saving.
Screenshot: Branding settings page with live preview
Logos & Images
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Logo (Main) | Navigation, emails, documents | file | optional |
| Sub Logo | Compact sidebar layout | file | optional |
| Favicon | Browser tab icon | file | optional |
| Login Logo | Login page header | file | optional |
| Login Background | Login page image | file | optional |
Colors & Theme
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Primary Color | Sidebar, buttons, accents | hex color | #4F46E5 |
| Secondary Color | Secondary UI elements | hex color | #10B981 |
| Accent Color | Alerts, badges, emphasis | hex color | #F59E0B |
| UI Theme | Light / Dark / System mode | select | system |
| Sidebar Compact | Narrow sidebar toggle | boolean | false |
Typography & Layout
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Primary Font | Typography for headings and body | text | Inter |
| Secondary Font | Typography for secondary elements | text | Inter |
| Base Font Size | Text scale across the application | text | 16px |
| Layout Density | Element spacing (compact, normal, comfortable) | select | normal |
| Card Skin | Card styling (shadow, bordered, flat) | select | shadow |
| Layout Background | Page background color | color | light gray |
Login Page Customization
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Login Welcome Text | Custom login greeting message | text | optional |
| Login Form Position | Form placement on the login page | select | right |
Notification Appearance
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Notification Style | Toast notification visual style | select | toast |
| Notification Position | Where toasts appear on screen | select | top-right |
| Notification Duration | How long each toast is visible | number (ms) | 5000 |
| Max Notifications | Maximum simultaneous toasts | number | 4 |
3. Region & Formats
Path: Settings > Locale
Control the language, timezone, date/time formats, and measurement units used across the entire platform.
Screenshot: Region and Formats settings page
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Language | UI language for all labels and messages | select (en / es) | en |
| Timezone | Date/time display across the app | select | UTC |
| Date Format | All date displays and exports | text | d/m/Y |
| Time Format | Clock display (12-hour or 24-hour) | select (12h / 24h) | 24h |
| Currency | Default pricing and invoicing currency | text | USD |
| Weight Unit | Shipping weight calculations | select (kg / lb) | kg |
| Dimension Unit | Package measurements | select (cm / in) | cm |
Currency Management
The currency management sub-section allows you to:
- Toggle currencies active or inactive for use across the platform.
- Set a primary currency that is used by default on all new shipments and invoices.
- Create custom currencies with a name, ISO code, symbol, and exchange rate.
Screenshot: Currency management panel
4. Shipping Configuration
Path: Settings > Shipping Config
Define global tax, surcharge, and fallback pricing rules that apply to all shipments unless overridden by a specific rate card.
Screenshot: Shipping Configuration settings page
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Tax Name | Invoice line description for tax | text | Tax |
| Tax Rate | Tax calculation percentage on shipments | % | 0 |
| Volumetric Divisor | Density formula for dimensional weight (L × W × H / divisor) | number | 5000 |
| Base Surcharge | Fixed charge added to every shipment | number | 0 |
| Fuel Surcharge % | Dynamic percentage adjustment on shipment price | % | 0 |
| Insurance % | Optional insurance fee percentage | % | 0 |
| Default Base Price | Fallback minimum charge when no rate card matches | number | 5.00 |
| Default Price per Kg | Fallback weight-based rate when no rate card matches | number | 2.00 |
Volumetric Weight
The volumetric divisor determines how dimensional weight is calculated. A divisor of 5000 is the international standard (IATA). Some domestic carriers use 6000. The system compares actual weight vs. volumetric weight and bills whichever is greater.
5. Tracking & Numbers
Path: Settings > Tracking
Configure how tracking numbers are generated and how labels are formatted for printing.
Screenshot: Tracking and label configuration page
Tracking Number Format
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Tracking Prefix | String placed before the number (e.g., TRK00000001) | text | TRK |
| Tracking Padding | Zero-fill digit count (e.g., 8 = 00000001) | number | 8 |
| Tracking Suffix | String placed after the number | text | empty |
| Reset Rule | Auto-reset sequence frequency (never, yearly, monthly) | select | never |
Label Configuration
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Label Paper Size | Physical label dimensions for thermal/inkjet printers | select | 4×6 |
| Label Format | Output file type for generated labels | select | |
| Barcode Type | Barcode symbology on labels | select | code128 |
| Label Theme | Layout template for printed labels | select | fedex |
6. Services
Path: Settings > Services
Define the shipping service types your company offers (e.g., Express, Standard, Same-Day, Freight). Each service can have its own base price and estimated delivery time. Services appear in the shipment creation form for the operator to select.
Screenshot: Services list and create/edit form
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Name | Display name shown to operators and customers | text | required |
| Code | Unique internal identifier (e.g., EXP, STD) | text | required |
| Mode | Transport mode (air, ground, sea, multimodal) | select | ground |
| Description | Brief explanation shown in service selection | text | optional |
| Base Price | Minimum charge for this service type | number | 0 |
| Price per Kg | Weight-based rate for this service | number | 0 |
| Currency | Currency code for pricing | text | USD |
| Estimated Days | Estimated delivery time in business days | number | 1 |
| Sort Order | Display order in selection lists | number | 0 |
| Active | Whether the service is available for new shipments | boolean | true |
7. Shipment Statuses
Path: Settings > Shipment Statuses
Manage the status pipeline for shipments. Each status has a color and icon that appear in the shipment timeline, tracking page, and dashboard widgets. You can reorder statuses to match your operational flow.
Screenshot: Shipment Statuses management page
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Name | Display label (e.g., "In Transit", "Delivered") | text | required |
| Code | Unique internal code (e.g., in_transit, delivered) | text | required |
| Icon | Icon displayed in the status badge and timeline | icon picker | optional |
| Color | Badge and timeline color for this status | hex color | required |
| Order | Position in the status pipeline sequence | number | 0 |
| Active | Whether this status is available for assignment | boolean | true |
8. Notifications
Path: Settings > Notifications
Configure email (SMTP), SMS (Twilio), and WhatsApp (UltraMsg) channels. Then define which events trigger notifications and customize the message templates per channel, event, and language.
Screenshot: Notifications settings overview
SMTP (Email)
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| SMTP Host | Mail server hostname (e.g., smtp.gmail.com) | text | required |
| SMTP Port | Mail server port (465, 587, etc.) | number | 587 |
| SMTP Username | Authentication username | text | required |
| SMTP Password | Authentication password (stored encrypted) | password | required |
| Encryption | Connection encryption method | select (tls / ssl / none) | tls |
| From Email | Sender email address on outgoing mail | required | |
| From Name | Sender display name on outgoing mail | text | required |
Twilio (SMS & WhatsApp)
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Account SID | Twilio account identifier | text | required |
| Auth Token | Twilio authentication token (stored encrypted) | password | required |
| SMS From | Phone number for outgoing SMS | text | required |
| WhatsApp From | WhatsApp-enabled phone number | text | optional |
UltraMsg (WhatsApp)
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Instance ID | UltraMsg instance identifier | text | required |
| Token | UltraMsg API token (stored encrypted) | password | required |
Notification Rules
Define which events trigger notifications and on which channels. Each rule maps an event to one or more channels (email, SMS, WhatsApp).
Screenshot: Notification rules matrix
| Event | Description | Available Channels |
|---|---|---|
| shipment_created | Fires when a new shipment is created | Email, SMS, WhatsApp |
| out_for_delivery | Fires when a shipment is marked out for delivery | Email, SMS, WhatsApp |
| delivered | Fires when a shipment is confirmed delivered | Email, SMS, WhatsApp |
| exception | Fires when a shipment has a delivery exception | Email, SMS, WhatsApp |
Notification Templates
Customize message content per channel, event, and language. Each template supports the following fields:
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Channel | Which channel this template applies to | select (email / sms / whatsapp) | required |
| Event | Which event triggers this template | select | required |
| Language | Template language (en / es) | select | en |
| Subject | Email subject line (email channel only) | text | required |
| Body | Message content with variable placeholders | textarea | required |
Template Variables
Templates support placeholders such as {tracking_number}, {customer_name}, {status}, {company_name}, and {estimated_date}. See the template editor for the full list of available variables per event.
9. Integrations
Path: Settings > Integrations
Connect Deprixa Plus with third-party carriers, mapping providers, and OAuth services. Each integration card shows its connection status and can be enabled or disabled independently.
Screenshot: Integrations overview page
Carrier Accounts
Connect external carrier APIs to generate labels, fetch real-time rates, and sync tracking updates. Each carrier requires its own credentials.
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| API Key | Authentication key for carrier API | text | required |
| Account Number | Carrier account/shipper number | text | required |
| Mode | API environment (sandbox / production) | select | sandbox |
| Status | Enable or disable this carrier connection | boolean | false |
Supported carriers: DHL, FedEx, UPS, USPS. Each has its own configuration card with the fields listed above.
Maps
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Default Provider | Which map service to use across the app | select (google / mapbox) | |
| Google Maps Key | API key for Google Maps services | text | optional |
| Mapbox Token | Access token for Mapbox services | text | optional |
| Default Center | Initial map center coordinates (lat, lng) | text | 0, 0 |
| Default Zoom | Initial map zoom level | number | 5 |
Google OAuth
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Client ID | Google OAuth 2.0 client identifier | text | optional |
| Client Secret | Google OAuth 2.0 client secret (stored encrypted) | password | optional |
MercadoLibre
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| App ID | MercadoLibre application identifier | text | optional |
| Client Secret | MercadoLibre client secret (stored encrypted) | password | optional |
10. Security
Path: Settings > Security
Harden your Deprixa Plus installation with authentication policies, session controls, and access restrictions.
Screenshot: Security settings page
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Require 2FA for Admin | Forces two-factor authentication for admin users | boolean | false |
| Password Expiry Days | Number of days before passwords must be changed | number | none |
| Session Timeout | Idle time in minutes before automatic logout | number (minutes) | 30 |
| IP Whitelist | Comma-separated list of allowed IP addresses for admin access | text | none |
| Allow Google Login | Enable or disable Google OAuth sign-in | boolean | true |
IP Whitelist Caution
If you enable IP whitelisting, make sure to include your current IP address. Locking yourself out requires direct database access or server-side configuration to recover.
11. Billing
Path: Settings > Billing
Configure invoice details and connect payment gateway accounts for online payments. For detailed billing workflows, see the Billing module documentation.
Screenshot: Billing settings page
Invoice Settings
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Tax Number | Tax ID printed on generated invoices | text | optional |
| Invoice Currency | Currency used on all generated invoices | text | USD |
| Invoice Terms | Payment terms text printed on invoices (e.g., "Net 30") | text | optional |
| Footer Notes | Custom text at the bottom of each invoice | textarea | optional |
| Invoice Theme | PDF layout template for invoices | select | default |
| Signature Image | Digital signature image on invoices | file | optional |
Stripe
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Publishable Key | Stripe public key for client-side checkout | text | optional |
| Secret Key | Stripe secret key for server-side charges (stored encrypted) | password | optional |
| Enabled | Activate Stripe as a payment method | boolean | false |
| Test Mode | Use Stripe sandbox environment | boolean | true |
PayPal
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Client ID | PayPal application client ID | text | optional |
| Secret | PayPal application secret (stored encrypted) | password | optional |
| Enabled | Activate PayPal as a payment method | boolean | false |
| Test Mode | Use PayPal sandbox environment | boolean | true |
Paystack
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Public Key | Paystack public key for client-side integration | text | optional |
| Secret Key | Paystack secret key for server-side charges (stored encrypted) | password | optional |
| Enabled | Activate Paystack as a payment method | boolean | false |
| Test Mode | Use Paystack sandbox environment | boolean | true |
12. Branches
Path: Settings > Branches
Define physical office or warehouse locations. Branches can be assigned to shipments and users, enabling multi-location operations and branch-level reporting.
Screenshot: Branches management page
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Name | Branch display name | text | required |
| Code | Unique branch identifier code | text | required |
| Address | Physical street address | text | required |
| City | Branch city | text | required |
| State | Branch state or province | text | required |
| Country | Branch country | select | required |
13. Departments
Path: Settings > Departments
Organize your team into departments for internal routing and reporting purposes.
Screenshot: Departments management page
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Name | Department display name | text | required |
| Code | Unique department identifier | text | required |
| Active | Whether the department is currently in use | boolean | true |
14. HS Codes
Path: Settings > HS Codes
Manage Harmonized System codes for international shipments. HS codes are required for customs declarations and are selected during shipment creation for cross-border packages.
Screenshot: HS Codes management page
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Code | HS tariff code number | text | required |
| Description | Human-readable description of the commodity | text | required |
| Category | Grouping for easier lookup | text | optional |
| Active | Whether the code is available for selection | boolean | true |
15. Lockers Config
Path: Settings > Lockers Config
Configure the auto-generated locker codes used for parcel locker pickup points.
Screenshot: Lockers configuration page
| Setting | What It Controls | Type | Default |
|---|---|---|---|
| Code Prefix | String placed before the locker code | text | LCK |
| Code Format | Format pattern for generated codes (numeric, alphanumeric) | select | numeric |
| Code Length | Number of characters in the generated portion | number | 6 |
16. Landing Page
Path: Settings > Landing Page
Customize the public-facing landing page content, hero section, features list, and call-to-action buttons. For full details on landing page configuration, see the Landing Page module documentation.
17. Users & Team
Path: Settings > Users
Manage user accounts, assign roles, and configure team members. For complete user management documentation, see the Users & Roles documentation.
18. Roles & Permissions
Path: Settings > Roles
Create and manage roles with granular permission sets. Assign permissions per module and action (view, create, edit, delete). For complete documentation, see the Users & Roles documentation.
19. Audit Log
Path: Settings > Audit Log
A read-only log of all system actions performed by users. Every create, update, and delete operation is recorded with a timestamp, the acting user, the affected module, and the specific changes made.
Screenshot: Audit Log page with filters
The audit log is filterable by:
- Module — Filter by the affected module (e.g., Shipments, Users, Settings).
- Action — Filter by action type (create, update, delete, login, logout).
- User — Filter by the user who performed the action.
- Date Range — Narrow results to a specific time period.
Note
Audit log entries cannot be edited or deleted through the UI. They serve as an immutable record for compliance and troubleshooting purposes.
20. Maintenance
Path: Settings > Maintenance
System health tools for administrators. Use these utilities to keep the application running smoothly.
Screenshot: Maintenance tools page
| Tool | What It Does |
|---|---|
| Health Check | Runs diagnostics on database connectivity, storage permissions, queue status, and external service reachability. Displays a pass/fail summary. |
| Clear Cache | Purges the application cache, config cache, route cache, and view cache. Useful after configuration changes or deployments. |
| Export Settings | Downloads a JSON file containing all current settings. Can be used for backup or migration to another instance. |
| Import Settings | Uploads a previously exported JSON settings file to restore or migrate configuration. |
| Clear Logs | Removes old application log files to free disk space. Keeps the most recent log file intact. |
Import Caution
Importing settings will overwrite all current values. Always export your current settings as a backup before importing a new configuration file.
21. Updates
Path: Settings > Updates
Manage application updates from within the admin panel.
Screenshot: Updates page
| Tool | What It Does |
|---|---|
| Check for Updates | Queries the update server for newer versions. Displays the current version and the latest available version with release notes. |
| Apply Update | Downloads and installs the latest update. The application enters maintenance mode during the process and returns to normal operation automatically. |
| Update History | Displays a log of all previously applied updates with version numbers, dates, and status (success or failed). |
Before Updating
Always create a full database backup and export your current settings before applying an update. While the update process includes automatic rollback on failure, a manual backup ensures you can recover from any scenario.