Tenant Configuration
This guide explains how to configure essential tenant-level settings for your courier business. These settings control how your system operates and what information is displayed to your customers.
Overview
Tenant configuration allows you to fine-tune advanced settings for your courier operations, including company information, branding, liquidation policies, customs integration, and customer-facing features. These settings are found in the General Settings section of your admin dashboard.
Prerequisites
Before you begin, ensure you have:
- ✅ Admin access to your Courier Connect Systems account
- ✅ Company details and branding assets
- ✅ Policy documents (if available)
- ✅ Business registration information
- ✅ ASYCUDA credentials (if applicable)
Step 1: Login to Your Tenant
- Navigate to your Courier Connect Systems login page
- Enter your admin username and password
- Click Sign In to access your admin dashboard
Step 2: Access General Settings
- From your Admin Dashboard, click on Settings in the navigation menu
- Click on General Settings
- You'll see multiple configuration sections
Configuration Sections
The General Settings page contains eight key sections that control different aspects of your system:
1. Company Information
This section contains basic administrative information about your company used for billing and internal purposes.
Legal Name
Field: Legal Name
Enter your company's official registered business name.
Example: Speedy Courier Services Limited
Contact Person's Name
Field: Name
Enter the name of the primary contact person for administrative matters.
Example: John Smith
Billing Email
Field: Email
Enter the email address where Postage Logistics Group or the Package Management System will send:
- Bill reminders
- Subscription invoices
- Important account notifications
- System updates
Example: billing@speedycourier.com
Important
Ensure this email is actively monitored as it will receive critical billing and subscription information.
2. Business Information
This section contains public-facing information that your customers will see. All fields here are visible to customers.
Courier Name
Field: Courier Name
Enter the public-facing name of your courier business (may differ from legal name).
Example: Speedy Courier
Tax Registration Number (TRN)
Field: Tax Registration Number
Enter your business tax registration number.
When to Fill This:
- Master Couriers - If you have access to ASYCUDA and will be doing your own manifest uploads to Jamaica Customs, this field is required
- Co-loading Couriers - If you're co-loading with another courier, this field is optional
Example: 123456789
Master Courier vs Co-loading
- Master Courier: You handle your own customs clearance and manifest uploads directly to ASYCUDA
- Co-loading: You ship through another courier who handles customs clearance
Phone Number
Field: Phone Number
Enter your business phone number for customer contact.
Example: +1-876-555-1234
Business Email
Field: Business Email
Enter your customer-facing email address for general inquiries.
Example: info@speedycourier.com
External Website
Field: External Website
Enter your company website URL (if you have one).
Example: https://www.speedycourier.com
Address
Field: Address
Enter your complete business address including:
- Street address
- City/Parish
- Postal code
- Country
Example:
123 Main Street
Kingston 10
JamaicaPublic Information
Remember that all information in the Business Information section is public and customer-facing. Ensure accuracy and professionalism.
3. Branding
Upload your business logos in various formats for different parts of the system.
Logo Formats Required
1. Dark Theme Version
- Used when the system is in dark mode
- Should be visible on dark backgrounds
- Recommended: Light-colored logo
- Format: PNG with transparent background
2. Login Logo
- Displayed on the login page if "Authentication Aside" is enabled
- Appears on the left side of the authentication pages
- Format: PNG or SVG
3. Regular Light Version
- Used in normal light mode throughout the system
- Should be visible on light backgrounds
- This is your primary logo
- Format: PNG with transparent background
4. Favicon
- Small icon displayed in browser tabs
- Recommended size: 32x32 or 64x64 pixels
- Format: ICO, PNG, or SVG
Upload Instructions
- Click Choose File next to each logo type
- Select your logo file from your computer
- Preview the uploaded logo
- Click Save to apply changes
Logo Best Practices
- Use consistent branding across all logo versions
- Ensure logos are clearly visible on their respective backgrounds
- Keep file sizes reasonable (under 2MB)
- Test how logos appear in both light and dark modes
4. Legal Information
Add URLs to your company's policy documents. These links are displayed to customers in your portal.
Policy URLs
Terms of Service
- URL to your terms of service page
- Example:
https://yourcompany.com/terms-of-service
Privacy Policy
- URL to your privacy policy
- Example:
https://yourcompany.com/privacy-policy
Storage Fee Policy
- URL to your package storage and fee policy
- Example:
https://yourcompany.com/storage-policy
Package Discard Policy
- URL to your unclaimed package disposal policy
- Example:
https://yourcompany.com/discard-policy
Optional Fields
If you don't have these policies in place yet, feel free to leave these fields blank. You can add them later when your policies are ready.
5. Dashboard Settings
Configure the appearance and features of the customer dashboard.
Enable Authentication Aside
Toggle: Enable Authentication Aside
Turn this ON to display an aside design on authentication pages (login, signup, password reset) with your logo on the left side and the form on the right.
- ON (Green) - Authentication pages show aside layout with logo
- OFF (Gray) - Standard centered authentication layout
Visual Appeal
The aside layout creates a more professional, branded experience on login pages. Recommended if you have a good-quality logo.
Enable Dashboard Message
Toggle: Enable Dashboard Message
Turn this ON to display a custom message to all customers when they log into their dashboard.
- ON (Green) - Dashboard message is visible to customers
- OFF (Gray) - No dashboard message displayed
Dashboard Message Content
Field: Dashboard Message
Enter the message you want to display to customers on their dashboard.
Use Cases:
- System maintenance announcements
- Holiday shipping deadlines
- Important updates or changes
- Promotional messages
- Service disruption notices
Example:
Important: Our offices will be closed December 25-26 for Christmas.
Normal operations resume December 27.Message Visibility
Remember that this message is visible to ALL customers when enabled. Keep it professional, concise, and relevant to all users.
6. Liquidation Policy
Configure automatic liquidation of delinquent packages.
What is Liquidation?
Liquidation is the process of disposing of or selling unclaimed packages that have exceeded the allowed storage period. This section controls how and when packages are automatically liquidated.
Auto-Liquidate Delinquent Packages
Toggle: Auto-Liquidate Delinquent Packages
Turn this ON to enable automatic liquidation of packages that exceed the grace period.
- ON (Green) - System automatically liquidates overdue packages
- OFF (Gray) - Manual liquidation only
Liquidation Grace Period (Days)
Field: Liquidation Grace Period Days
Enter the number of days a package can remain unpaid before entering the liquidation process.
Example: 30 (packages unpaid for 30+ days start liquidation)
Setting Grace Period
Consider your market and customer base when setting this. Too short may alienate customers; too long ties up warehouse space.
Final Notice (Days Before Liquidation)
Field: Final Notice
Enter how many days before liquidation a final notice reminder email is sent to the customer.
Example: 7 (customer receives final notice 7 days before liquidation)
How it Works:
- Package is 23 days overdue
- Grace period is 30 days
- Final notice is 7 days
- Customer receives final notice at day 23 (7 days before liquidation at day 30)
Liquidation Hold (Hours)
Field: Liquidation Hold
Enter the number of hours to keep a package in "Liquidation Hold" state before it is actually liquidated by the system.
Example: 48 (package stays in hold status for 48 hours)
Purpose: This hold period gives customers and staff a final chance to intervene before liquidation is completed.
High Value Threshold Amount (USD)
Field: High Value Threshold Amount
Enter the USD value that determines whether a manager's approval is required to liquidate high-value items.
Example: 500 (packages valued over $500 USD require manager approval for liquidation)
How it Works:
- Package value: $300 USD → Auto-liquidates (if threshold is $500)
- Package value: $600 USD → Requires manager approval before liquidation
Protect High-Value Items
Set an appropriate threshold to ensure expensive packages don't get liquidated without proper oversight.
7. ASYCUDA Settings
Configure customs integration settings for master couriers.
What is ASYCUDA?
ASYCUDA (Automated System for Customs Data) is the customs management system used in Jamaica and other Caribbean countries. This section is only relevant for master couriers who handle their own customs clearance.
When to Configure ASYCUDA Settings
Configure if:
- ✅ You are a master courier
- ✅ You have access to ASYCUDA
- ✅ You handle your own manifest uploads to Jamaica Customs
- ✅ You directly interact with customs authorities
Leave blank if:
- ❌ You are co-loading with another courier
- ❌ Another company handles your customs clearance
- ❌ You don't have ASYCUDA access
Agent Name
Field: Agent Name
Enter the name of your customs agent as registered with ASYCUDA.
Example: Speedy Courier Services Limited
Agent Tax Registration Number
Field: Agent Tax Registration Number
Enter your tax registration number as it appears in ASYCUDA records.
Example: 123456789
Must Match ASYCUDA Records
Ensure this exactly matches your registration in the ASYCUDA system to avoid customs clearance issues.
Agent Address
Field: Agent Address
Enter your business address as registered with customs authorities.
Example:
123 Main Street
Kingston 10
JamaicaNeed Help with ASYCUDA?
If you are a master courier with access to ASYCUDA and need assistance configuring these settings correctly, please reach out to our support team:
- Email: support@postagelogistics.com
- Phone: +1-876-613-9146
8. Other Settings
Additional system configuration options.
Require Payment Proof File
Toggle: Require Payment Proof File
Turn this ON to require customers to upload proof of payment (e.g., transfer receipt) when completing transactions using bank transfer as the payment method.
- ON (Green) - Proof of payment upload is required for bank transfers
- OFF (Gray) - Proof of payment is optional
When to Enable:
- You frequently receive bank transfer payments
- You need verification before processing packages
- You want to reduce payment disputes
- You need receipts for accounting purposes
When to Disable:
- You primarily use other payment methods
- You trust your customer base
- You verify payments through other means
Recommended Setting
Enabling this setting is recommended to maintain proper payment records and reduce disputes about payment status.
Saving Your Configuration
After configuring each section:
- Review all entered information for accuracy
- Scroll to the bottom of the General Settings page
- Click Save All Settings or Update
- Wait for confirmation message: "Settings saved successfully"
Save Regularly
Save your settings after configuring each section to avoid losing your work. Some sections may have individual save buttons.
Verification Checklist
Before completing tenant configuration, verify that you've:
- [ ] Updated company information with accurate billing details
- [ ] Completed business information with customer-facing details
- [ ] Uploaded all required logo formats
- [ ] Added policy URLs (or noted to add later)
- [ ] Configured dashboard settings and message (if needed)
- [ ] Set up liquidation policy with appropriate grace periods
- [ ] Configured ASYCUDA settings (if you're a master courier)
- [ ] Set payment proof requirements based on your business needs
- [ ] Saved all changes successfully
Common Issues & Solutions
Issue: Logo Not Displaying Correctly
Solution:
- Check file format (PNG, SVG, or ICO)
- Ensure file size is under 2MB
- Verify logo has proper contrast for its background
- Try clearing browser cache and reloading
Issue: Dashboard Message Not Showing
Solution:
- Ensure "Enable Dashboard Message" toggle is ON
- Check that message field is not empty
- Save settings and have customers log out and back in
- Clear browser cache
Issue: Liquidation Not Working
Solution:
- Verify "Auto-Liquidate Delinquent Packages" toggle is ON
- Check grace period is set to a reasonable number
- Ensure packages meet the criteria (overdue + grace period exceeded)
- Contact support if issues persist
Issue: ASYCUDA Settings Not Saving
Solution:
- Verify you have the correct permissions
- Ensure all required fields are filled out
- Check that TRN matches your registration
- Contact support for ASYCUDA configuration assistance
Best Practices
Company & Business Information
- Keep contact information current and monitored
- Use professional email addresses
- Update address if you relocate
- Review information quarterly for accuracy
Branding
- Maintain consistent branding across all logo versions
- Update logos if you rebrand
- Test logos in both light and dark modes
- Use high-quality images for professional appearance
Dashboard Messages
- Keep messages concise and relevant
- Update regularly (don't leave outdated messages)
- Use professional language
- Remove messages when no longer applicable
Liquidation Policy
- Review grace periods periodically
- Adjust based on customer feedback and business needs
- Monitor liquidation reports
- Ensure high-value threshold protects valuable items
ASYCUDA Settings
- Keep agent information synchronized with customs records
- Update immediately if registration details change
- Maintain backup of ASYCUDA credentials
- Test manifest uploads after any changes
Next Steps
Once you've completed tenant configuration, your system is fully set up! You can now:
- Create test packages to verify your configuration
- Invite team members to start using the system
- Begin onboarding customers to the platform
- Configure additional advanced settings as needed
Need Help?
If you encounter any issues during tenant configuration:
- Email: support@postagelogistics.com
- Phone: +1-876-613-9146
- WhatsApp: Message us
- Support Hours: Mon-Fri 8am-8pm, Sat 10am-4pm (Jamaica Time)
Our support team can assist with:
- Configuration guidance
- ASYCUDA setup for master couriers
- Branding and logo issues
- Liquidation policy recommendations
- Any other tenant configuration concerns
Congratulations!
You've completed the Getting Started setup process for Courier Connect Systems. Your system is now configured and ready to use. Explore the rest of the documentation to learn about daily operations, package management, invoicing, and advanced features.