# erpnextpda

**Repository Path**: jyinet/erpnextpda

## Basic Information

- **Project Name**: erpnextpda
- **Description**: ERPNext PDA Android app for warehouse operations
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2026-03-21
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ERPNext PDA

ERPNext PDA is an Android warehouse handheld app built for ERPNext / Frappe sites.

It focuses on real PDA workflows instead of generic mobile ERP browsing:

- Warehouse workbench
- Inbound receipt
- Purchase-order-based receiving
- Internal transfer
- Stock counting
- Picking board
- Replenishment tasks
- Inventory lookup
- Label preview
- Offline retry queue
- Scanner broadcast support

## Screenshots

### Workspace

![Workspace](docs/screenshots/workspace.png)

### Manual Inbound

![Manual Inbound](docs/screenshots/inbound-manual.png)

### Purchase Order Receipt

![PO Receipt](docs/screenshots/inbound-po.png)

## Main Features

- Chinese PDA-oriented UI
- ERPNext login and session restore
- Scanner-friendly warehouse operations
- Item barcode to item-code resolution
- Batch / serial number aware forms
- Offline queue for failed submissions
- Purchase Order to Purchase Receipt workflow
- Local cache for key lists

## Inbound Modes

The inbound module currently supports two flows:

1. Direct inbound
   Creates `Stock Entry / Material Receipt`
2. Purchase order receipt
   Creates `Purchase Receipt` from `Purchase Order`

## Tech Stack

- Kotlin
- Jetpack Compose
- Android ViewModel
- Retrofit
- Kotlinx Serialization
- SharedPreferences

## Project Structure

```text
app/src/main/java/com/example/erpnextmobile
├─ data
│  ├─ model
│  ├─ remote
│  └─ repository
├─ ui
│  ├─ login
│  ├─ pda
│  ├─ inventory
│  ├─ sales
│  └─ tasks
└─ MainActivity.kt
```

## Build

### Android Studio

1. Open this project in Android Studio
2. Let Gradle sync
3. Run the `app` module

### Windows CLI

This machine builds successfully through the helper script:

```powershell
powershell -ExecutionPolicy Bypass -File D:\新项目\scripts\build-android.ps1
```

Debug APK output:

- `D:\erpnext-android-build\app\build\outputs\apk\debug\app-debug.apk`
- `D:\新项目\dist\app-debug.apk`

## ERPNext Resources Used

- `Task`
- `Customer`
- `Company`
- `Sales Order`
- `Warehouse`
- `Bin`
- `Item`
- `Item Barcode`
- `Stock Entry`
- `Stock Reconciliation`
- `Purchase Order`
- `Purchase Receipt`

## Known Limitations

- Some historical Chinese strings still need cleanup
- Purchase order receiving can be enhanced with richer line selection
- Current published APKs are intended for testing and internal rollout

## Roadmap

- Better purchase order search and line selection
- Hardware-specific scanner tuning
- Printer integration
- Harder industrial PDA visual style
- Signed production release package