Odoo eCommerce Mobile App documentation

1. Unzip the package. Inside is taqnix_ecommerce_app.zip; unzip it to get the folder taqnix_ecommerce_app.
2. Copy the folder into one of the addons_path folders of your Odoo server and restart Odoo.
3. Log in as an administrator, activate Developer mode, open Apps and press Update Apps List.
4. Remove the “Apps” filter, search eCommerce Mobile App Connector and press Install.

# or from the command line
./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_ecommerce_app --stop-after-init

1. In Odoo open Website → Configuration → Payment Providers (or Accounting → Configuration → Payment Providers).
2. Choose a provider (Stripe, PayPal, Adyen, Razorpay, Mollie, Paymob, Flutterwave, Authorize.Net, Worldline, Mercado Pago, Xendit and others), enter the keys they give you and set the state to Test first, then Enabled.
3. Switch Published on, choose the payment methods and the countries and currencies it accepts.
4. In Mobile App → Settings → Payments leave Online payment methods empty to offer them all, or pick the ones the app shows.
5. Place a test order from the app and check the payment in Mobile App → Orders from the app.

1. Create a project at console.firebase.google.com and add an Android app (your package name) and an iOS app (your bundle ID).
2. In Odoo, Mobile App → Settings → Notifications, copy the project ID, the app IDs of the Android and the iOS app, the API key and the sender ID (Project settings → General).
3. In Firebase open Project settings → Service accounts → Generate new private key and paste the whole JSON file in Service account JSON in Odoo. It stays on the server.
4. For iPhone, upload an APNs authentication key in Firebase (Project settings → Cloud Messaging) and enable Push Notifications for the app ID at Apple.
5. Customers allow notifications the first time they sign in. Use Mobile App → Send a notification for a message to all devices or to chosen customers.

1. Install Flutter from flutter.dev (version 3.41 or newer) and run flutter doctor; fix what it reports.
2. Android: install Android Studio, open it once, install the Android SDK and accept the licences with flutter doctor --android-licenses.
3. iPhone (Mac only): install Xcode from the App Store, open it once to accept the licence, install the command line tools (xcode-select --install) and CocoaPods (sudo gem install cocoapods or brew install cocoapods).
4. Unzip flutter-app-source.zip in a folder without spaces, then run flutter pub get inside it.

dart run tools/setup.dart --url https://shop.example.com --package com.yourcompany.shop

flutter pub get
dart run flutter_launcher_icons
dart run flutter_native_splash:create

1. Start an Android emulator or an iPhone simulator, or plug in your phone.
2. Run flutter run (add --dart-define=SITE_URL=... if you did not use the setup script).
3. Walk through: home page, a category, search and filters, a product with options, cart, coupon, checkout with cash on delivery and with an online provider in test mode, orders, wishlist, sign-in and sign-up.
4. In Odoo check Mobile App → Orders from the app and Devices.

1. Create the signing key once and keep it safe (without it you can never update the app): keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload.
2. Create android/key.properties with storePassword, keyPassword, keyAlias=upload and storeFile (the path of the keystore). The app README shows the exact lines.
3. Build: flutter build appbundle --release --dart-define=SITE_URL=https://shop.example.com. The file is build/app/outputs/bundle/release/app-release.aab.
4. In Google Play Console create the app, fill the store listing (name, description, icon 512 × 512, feature graphic 1024 × 500, phone screenshots), the Data safety form, the content rating and the privacy policy URL.
5. Upload the .aab to a testing track first. New personal developer accounts must run a closed test with at least 12 testers for 14 days before applying for production; organization accounts do not.
6. Send the release for review and publish.

1. In developer.apple.com create an App ID with your bundle ID and the capabilities you use: Sign in with Apple and Push Notifications.
2. In App Store Connect create the app with the same bundle ID.
3. Open ios/Runner.xcworkspace in Xcode, select the Runner target → Signing & Capabilities, choose your team and enable Automatically manage signing.
4. Build: flutter build ipa --release --dart-define=SITE_URL=https://shop.example.com, then upload with Xcode (Window → Organizer → Distribute App) or the Transporter app.
5. In TestFlight test the build, then in App Store Connect fill the listing, screenshots, privacy details and the review information, and submit for review.

Replace the module folder with the new version, restart Odoo and run -u taqnix_ecommerce_app; your settings, layouts and devices are kept. For the app, unzip the new source next to your project, keep your android/key.properties and keystore, run the setup script again (it rewrites the shop address, the package name and the branding) and build. Keep the build number higher than the published one (version: in pubspec.yaml).

curl https://shop.example.com/mo-app/v1/ping
# {"ok": true, "api_version": 1}
curl https://shop.example.com/mo-app/v1/homepage
curl "https://shop.example.com/mo-app/v1/products?per_page=5&orderby=price&order=asc"
curl -X POST https://shop.example.com/mo-app/v1/auth/login -H 'Content-Type: application/json' -d '{"email": "sara@example.com", "password": "..."}'

Installation help and bug fixes are included for 6 months, with lifetime updates. Contact us through the marketplace page where you bought the module or write to support@taqnix.com with your Odoo version and a screenshot.