First-Time Setup Guide

Point your browser at your domain with /install appended, for example https://your-domain.com/install. If the application hasn't been installed yet, this screen appears automatically — you'll see the welcome screen below. Click Next to begin.

The installer automatically checks that your server is correctly set up to run ABICex. Every row needs a green checkmark before you continue.

• If any item is marked with a red cross, that's a server configuration issue, not something you fix on this screen — send the item name to your hosting provider or developer, then reload the page once it's fixed.
• You don't need to click anything on this step besides Next once everything is green.

Enter the connection details for the database you created before starting. The installer saves these for you automatically, so double-check them before continuing.

• Database Host — usually localhost unless your host gives you a different address.
• Database User / Password — a MySQL user with full privileges on the database below.
• Database Name — the empty database you created for ABICex.

Create the very first account for the system — the Super Admin who manages the whole platform (all companies/tenants, plans, subscriptions, and global settings). This is the login you'll actually use afterwards, not any of the demo credentials shown elsewhere.

• Use a real email address you control — it becomes your login username.
• Choose a strong password; you'll type it in on the next step, then use it to sign in once setup finishes.

Paste the purchase code from your order confirmation, then click Finish.

1. The code is verified online.
2. Your database is set up and populated with default data.
3. The administrator account you entered in step 4 is saved.
4. Setup is marked complete, and you're redirected straight to the login page.

Sign in with the email and password you set in step 4. You'll land on the Super Admin dashboard, showing your platform's companies, plans and subscriptions at a glance.

Go to Setting → General Settings. This is the first thing to fill in — your logo and colors appear across the admin panel and on customer-facing pages from here on.

• Logo, Light Logo (for dark backgrounds) and Favicon — upload each separately.
• Application Name, Phone, Email, Address, Copyright text.
• Currency — set this early; it's used everywhere money is shown.
• Parcel Tracking Prefix / Invoice Prefix — a short code stamped on every tracking ID and invoice you generate (e.g. NF-).
• Primary Color / Text Color — re-themes the admin panel to match your brand.

Every company on ABICex gets its own public website — the page your customers land on to learn about your service and track their parcel. You don't build this from scratch: it's already there, and Front Web (in the sidebar, just above Setting) is where you edit its content.

• Pages — About Us, Contact Us, FAQ, Privacy & Policy, Terms & Conditions, ready to edit.
• Section — the homepage's blocks (hero banner, highlights, etc.).
• Service, Why Courier, Partner, Blogs, FAQ, Social Link — supporting content blocks and lists shown on the site.

The site itself is already live at your company's domain. The Tracking page is the important one operationally — it's what you hand customers so they can check a parcel's status themselves without calling you.

A branch (called a "hub" internally) is a physical location parcels move through — a warehouse, sorting office, or pickup point. Go to Branch Manage → Branch → Add New.

• Fill in the branch's name, phone and address — parcels and delivery men get assigned against this.
• You need at least one branch before you can add a delivery man or move a parcel through the system.

Once created, open the branch and assign it a branch manager ("hub in-charge") — the staff member responsible for that location's day-to-day operations.

A merchant is a client of yours who ships parcels through your company — an online shop, for instance. Go to Merchant Manage → Merchants → Add New.

• Business Name, contact Name, Email, Phone, Password (their login to the separate Merchant Panel) and Hub (their home branch).
• COD Charge — your cash-on-delivery handling fee, set separately for inside city / sub city / outside city parcels.
• Return Charges (%) — what you charge the merchant when a parcel comes back undelivered.
• Optional: reference contact, payment period, wallet activation, NID/trade license uploads.

Go to Team → Delivery Man → Add New.

• Name, Phone, Email, Password (their login to the Delivery mobile app), Hub (their assigned branch), Address.
• Delivery Charge / Pickup Charge — what you pay them per parcel delivered or picked up.
• Return Charge, Opening Balance, Salary if you pay a base salary too.
• Driving License upload, optional.

Before parcels can be priced automatically, tell ABICex what you charge. This lives under Setting.

Delivery Category first — the parcel "types" you price separately (e.g. by weight bracket, or Document / Parcel / Fragile). Then Delivery Charge — one price row per category and weight, with four prices side by side:

• Same Day, Next Day, Sub City, Outside City — your four delivery-speed/zone price columns.
• A charge row can also target a specific Region (e.g. one price for a particular city, a different one everywhere else) — rows left as "All regions" are the fallback used whenever no region-specific row matches.
• Effective Dates and Priority let you schedule a temporary rate change without deleting your normal pricing.

With a branch, a merchant and your rates in place, go to Operations → Parcels → Add.

• Merchant, Pickup Address/Phone — where the parcel is collected from.
• Cash Collection — the amount to collect from the customer on delivery (for cash-on-delivery orders).
• Category and Delivery Type — these are what your Delivery Charge table (step 12) prices the parcel against.
• Customer Name / Phone / Address — with a map picker to pin the exact delivery location.
• Tick Liquid/Fragile if it needs special handling, choose a Packaging type, and set Priority if it's urgent.
• The Charge Details panel on the right recalculates live as you fill the form — cash collection, delivery charge, COD charge, VAT and the net amount payable.

Every parcel moves through a fixed sequence of statuses, visible as a colored badge on the parcel list and updated at each handoff:

1. Pending — just created, not yet picked up.
2. Pickup Assign — a delivery man is assigned to collect it from the merchant.
3. Received by Pickup Man → Received Warehouse — it's arrived at your branch.
4. Transfer to Hub → Received by Hub — moved on to the branch that will deliver it, if different.
5. Delivery Man Assign — assigned to a delivery man for the final leg.
6. Delivered (or Partial Delivered for split shipments) — success.

If a delivery attempt fails, the parcel takes the return branch instead:

1. Return Warehouse — brought back to your branch rather than delivered.
2. Return to Courier / Return Assign to Merchant — routed back toward whoever should receive it back.
3. Returned Merchant — confirmed back with the merchant, closing the loop.

Any step can be re-scheduled (customer asked for another day) or cancelled and rolled back — cancelling a status returns the parcel to the step before it, rather than losing the parcel's history.

For merchants sending a large batch, go to Operations → Parcels → Import instead of creating each one by hand.

1. Download the sample spreadsheet from the Sample button.
2. Fill in one row per parcel, using the category and delivery-type codes listed on the page.
3. Pick the Merchant these parcels belong to, then upload the file.
4. Any rows that fail validation are listed with their row number and reason, so you can fix and re-upload just those.

When a merchant wants a parcel collected, that's a pickup request — separate from the parcel itself. ABICex tracks two kinds, each with its own screen under Operations:

• Pickup Request — Regular: standard-priority collection, scheduled in with your normal pickup routes.
• Pickup Request — Express: urgent, same-day collection requests that should jump the queue.

A Trip groups all the parcels one delivery man is carrying for one branch on one run — effectively their manifest for the day. Most trips are created automatically the moment you bulk-assign parcels to a delivery man; you can also plan one ahead of time under Operations → Trips → Add New by picking the delivery man, branch and an optional route.

Open a trip to see its full parcel manifest, print a waybill for the driver, and close it out once every parcel on it has a final status.

Day-to-day bookkeeping lives under Accounts:

• Accounts — your ledger accounts (cash, bank, mobile wallet, etc.) — set these up first.
• Income / Expense — record money in or out against one of your accounts, categorized under an Account Head.
• Fund Transfer — move money between two of your own accounts (e.g. cash to bank).
• Bank Transaction — reconcile transactions against a bank account specifically.

The dashboard you saw at first login (step 6) already had Income/Expense and revenue charts on it — once you're recording real entries here, those charts and the "Total Accounts" tile fill in automatically.