Skip to content

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

  1. Navigate to your Courier Connect Systems login page
  2. Enter your admin username and password
  3. Click Sign In to access your admin dashboard

Step 2: Access General Settings

  1. From your Admin Dashboard, click on Settings in the navigation menu
  2. Click on General Settings
  3. 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.

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
Jamaica

Public 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

  1. Click Choose File next to each logo type
  2. Select your logo file from your computer
  3. Preview the uploaded logo
  4. 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

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
Jamaica

Need 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:


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:

  1. Review all entered information for accuracy
  2. Scroll to the bottom of the General Settings page
  3. Click Save All Settings or Update
  4. 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:

  1. Create test packages to verify your configuration
  2. Invite team members to start using the system
  3. Begin onboarding customers to the platform
  4. Configure additional advanced settings as needed

Need Help?

If you encounter any issues during tenant configuration:

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.

Documentation for Courier Connect Systems by Ardura Technologies Limited