Appe - Setup

Setting up the Appe App is quick and effortless! Just follow the steps below to connect your Frappe/ERPNext server with the Appe Mobile Application.


1. πŸ”‘ Prerequisites

Before you begin, make sure you have the following ready:

  1. ERPNext/Frappe Instance

    • Your ERPNext site should be accessible via public IP or domain name (e.g., https://erp.yourcompany.com).
    • The site must be live on the internet (not just localhost) if you want to connect from outside.
  2. Frappe User Account

    • You must have a valid Frappe User created.
    • User should be linked with an Employee OR Appe Employee.
  3. Login Credentials

    • Keep your domain/IP, username, and password ready.
    • Example:

      • Domain/IP β†’ https://erp.yourcompany.com
      • Username β†’ employee@company.com
      • Password β†’ ********

2. 🌐 Domain Registration

To enable seamless communication between ERPNext/Frappe and the Appe Mobile Application, you need to register your ERPNext site domain or public IP.

  1. Open the Domain Registration Form provided within the Appe setup.
  2. Enter your ERPNext site details:

    • Domain/IP (example: https://erp.mycompany.com)
    • Site Name (optional, for your reference)
  3. Save and submit the form.

πŸ‘‰ Once registered, Appe will recognize your ERPNext instance for login and data sync.


3. πŸ“² Logging into the Mobile App

After completing domain registration and prerequisites, follow these steps:

  1. Open the Appe Mobile App on your Android device.
  2. On the login screen, enter:

    • Domain/IP β†’ Your ERPNext domain (e.g., https://erp.yourcompany.com)
    • Username β†’ ERPNext login ID
    • Password β†’ ERPNext account password
  3. Tap on Login.

βœ… If your domain and credentials are correct, you will be logged in successfully.


4. πŸš€ Post-Login Setup

Once logged in, you can:

  • Access ERPNext Doctypes (Sales Order, Purchase Order, Employee, etc.) directly on mobile.
  • Use any custom Frappe app features available in your ERPNext site.
  • Receive real-time notifications and manage approvals.
  • Use Face Recognition Services if enabled in your system.

5. ⚠️ Troubleshooting

  • Invalid Domain/IP Error β†’ Check if your ERPNext site is publicly accessible. If using HTTPS, ensure SSL is properly configured.
  • Invalid Credentials β†’ Make sure the ERPNext User is active and linked to an Employee record.
  • App Not Syncing β†’ Restart your bench (bench restart) and confirm API access is enabled.

6. 🎯 Summary

  1. Register your ERPNext Domain/IP using the provided form.
  2. Ensure you have a valid User linked with an Employee.
  3. Login from the Appe mobile app with your Domain/IP, Username, Password.
  4. Start managing your ERPNext/Frappe system anytime, anywhere.

Discard
Save

On this page

Review Changes ← Back to Content
Message Status Space Raised By Last update on