Active-ecommerce-delivery-boy-flutter-app.zip <Top ✔>

Before you download and attempt to build the active-ecommerce-delivery-boy-flutter-app.zip, ensure your stack matches these prerequisites.

| Requirement | Specification | | :--- | :--- | | Backend CMS | Active eCommerce CMS (v6.0 or higher recommended) | | PHP Version | 7.4 or 8.0 (with cURL, OpenSSL, BCMath) | | Flutter SDK | Version 3.0+ (Dart 2.17+) | | IDE | Android Studio / VS Code (with Flutter & Dart plugins) | | API Configuration | Active eCommerce must have "Delivery Boy" API module enabled in Admin > Addons | | Firebase Project | For Push Notifications (FCM - Firebase Cloud Messaging) | | Google Cloud Billing | Enabled for Maps SDK & Directions API |

Critical Note: You cannot run this app without the Active eCommerce backend. The app is a client; it relies entirely on the REST API endpoints provided by the CMS. If you do not own a license for Active eCommerce, this zip file is useless.

If you were to compile the code inside this zip and run it on a phone, you would see the world through the eyes of the courier.

The code dictates a UI designed for utility over vanity.

Delivery boys receive real-time push notifications when a new order is assigned to them. They can accept or reject the order based on their current workload.

By default, the delivery fee might be fixed. You can customize lib/services/payment_service.dart to implement dynamic commission (e.g., 10% of cart value + base fee).

How do you turn the .zip file into a working app on a phone? Follow this 6-step pipeline:

Even experienced developers hit snags. Here are the top 3 errors when compiling this zip file:

| Error Message | Likely Cause | Solution | | :--- | :--- | :--- | | SSL Handshake failed | Backend uses HTTP instead of HTTPS, or expired cert | Force HTTPS on server or add http to allowed domains in network_security_config.xml | | NoSuchMethodError: getString | API response structure changed after an Active eCommerce update | Compare your backend's API JSON output with the OrderModel.dart class; add missing fields | | Google Maps shows grey screen | Missing billing on Google Cloud or wrong API key restrictions | Enable Maps SDK for Android/iOS in GCP Console; key must have no referer restriction for mobile apps | | Firebase notification not received | Missing google-services.json or wrong package name | Re-download config file from Firebase Console matching your app's applicationId |

Log into your Active eCommerce Admin panel.

For Cash on Delivery (COD) orders, the app includes a secure counter. The delivery boy logs the collected amount. The app generates a daily summary (total collected, total delivered, total returned), which syncs with the admin panel for payroll calculation.