# erpnextpda

**Repository Path**: snlianqi/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**: 2
- **Forks**: 6
- **Created**: 2026-03-20
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LQ-ERPNEXTPDA

中文说明 | English below

面向 ERPNext / Frappe 的 Android PDA 仓库手持终端应用。  
这个项目更偏向真实仓库 PDA 作业，而不是通用移动端 ERP 浏览。

## 欢迎提需求

非常欢迎提需求、提问题、提现场场景。

如果你在下面这些方向有实际业务需求，尤其欢迎直接提：

- 采购收货
- 入库上架
- 库内移库
- 库存盘点
- 出库拣货
- 补货任务
- 条码 / 批次 / 序列号
- PDA 扫码枪兼容
- 标签打印
- 离线补提
- 不同行业仓库流程定制

不管是：

- 想增加一个新功能
- 想把界面改得更像你们现场 PDA
- 想适配你们 ERPNext 的字段规则
- 想接你们现有扫码设备或打印机

都欢迎直接提 Issue 或反馈需求。  
这个仓库就是按“边用边提、边反馈边迭代”的思路在持续完善。

### 建议反馈时尽量带上这些信息

- 你的行业或仓库场景
- 你希望解决的具体问题
- 当前 ERPNext 里的相关单据或字段
- 扫码枪 / PDA / 打印机型号
- 你期望的操作流程
- 界面参考图或现场照片

这样我会更容易把需求快速落地成可用功能。

## 项目定位

当前项目重点放在仓库现场作业：

- PDA 工作台
- 直接入库
- 按采购订单收货
- 库内移库
- 库存盘点
- 出库拣货看板
- 补货任务
- 库位查询
- 标签预览
- 失败补提队列
- 扫码广播兼容

## 应用信息

- 应用名：`LQ-ERPNEXTPDA`
- Android 包名：`com.lianqi.erpnextpda`
- 技术栈：Kotlin、Jetpack Compose、Retrofit、Kotlinx Serialization

## 截图

### 工作台

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

### 直接入库

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

### 采购订单收货

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

## 主要功能

- 中文 PDA 风格界面
- ERPNext 登录与会话恢复
- 扫码友好的仓储作业流程
- 条码反查物料编码
- 批次号 / 序列号动态表单
- 弱网失败补提
- 采购订单转采购收货
- 本地缓存关键列表数据

## 入库模式

当前入库模块支持两种流程：

1. 直接入库  
   创建 `Stock Entry / Material Receipt`

2. 采购订单收货  
   基于 `Purchase Order` 创建 `Purchase Receipt`

## 项目结构

```text
app/src/main/java/com/lianqi/erpnextpda
|-- data
|   |-- model
|   |-- remote
|   `-- repository
|-- ui
|   |-- login
|   |-- pda
|   |-- inventory
|   |-- sales
|   `-- tasks
`-- MainActivity.kt
```

## 构建方式

### Android Studio

1. 用 Android Studio 打开项目
2. 等待 Gradle 同步
3. 运行 `app` 模块

### Windows 命令行

当前机器可以通过下面脚本稳定构建：

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

APK 输出：

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

## ERPNext 对接说明

- 默认通过 ERPNext / Frappe REST API 访问
- 登录使用 `form-urlencoded` 登录接口
- 列表数据优先走标准资源接口
- 仓储作业优先对接 `Stock Entry`、`Stock Reconciliation`、`Purchase Receipt`

## 已知说明

- 当前 release 包为已签名测试分发包，适合内部安装验证
- 不同 ERPNext 站点可能要求额外字段，例如 `company`、`warehouse`、税模板、价格表
- 如果你们现场 PDA 扫码广播格式特殊，欢迎直接提需求，我可以继续适配

## English

LQ-ERPNEXTPDA is an Android PDA app for ERPNext / Frappe warehouse operations.  
It is designed for real warehouse handheld workflows instead of a generic mobile ERP browser.

## Feature Requests Are Very Welcome

Requests, workflow ideas, device compatibility issues, and field-level ERPNext requirements are all welcome.

Especially welcome:

- Purchase receiving
- Putaway / inbound shelving
- Internal transfer
- Stock counting
- Picking
- Replenishment
- Barcode / batch / serial support
- PDA scanner compatibility
- Label printing
- Offline retry queue
- Industry-specific warehouse flow customization

If you want:

- A new feature
- A UI closer to your real PDA devices
- ERPNext field rule adaptation
- Integration with your current scanner or printer

please open an Issue and describe the scenario.  
This project is meant to evolve through real usage feedback.

### Helpful information to include in a request

- Your warehouse or industry scenario
- The exact problem you want to solve
- Related ERPNext doctypes or fields
- Scanner / PDA / printer model
- Expected operation flow
- UI references or on-site photos

## App Info

- App name: `LQ-ERPNEXTPDA`
- Android package: `com.lianqi.erpnextpda`

## Core Scope

- PDA workspace
- Direct inbound
- Purchase-order-based receiving
- Internal transfer
- Stock counting
- Picking board
- Replenishment tasks
- Bin lookup
- Label preview
- Failed submission retry queue
- Scanner broadcast compatibility

## Build

Open the project in Android Studio or build on Windows with:

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

## Repository Goal

This repository welcomes feature requests and real warehouse feedback.  
If you have an ERPNext PDA scenario to implement, please open an Issue.