+
ERPNext + atoship
免费开源的 ERPNext 物流应用。在销售订单里比较各大承运商的实时运费，一键或批量购买折扣面单，并把追踪单号自动回写到订单。
Ship Queue 发货工作台 —— 一张表发完所有订单,全程不离开 ERPNext。
在任意销售订单里查看实时运费 —— 比价后直接下单,就在订单页内完成。
工作原理
三条命令装好应用，打出第一张面单用不了几分钟
用 git 安装应用
atoship for ERPNext 是一个自托管的 Frappe 应用，通过 git 安装——无需应用市场，也不用 OAuth 授权。在你的服务器上执行三条 bench 命令即可：
- $bench get-app https://github.com/atoship/atoship-for-erpnext
- $bench --site your-site install-app atoship_shipping
- $bench --site your-site migrate
配置 Atoship Settings
在 ERPNext 中打开 Atoship Settings，粘贴你的 atoship API 密钥并点击 Test Connection。随后设置发货地址（Ship-From）、默认包裹尺寸/重量以及面单格式。
在销售订单上发货
打开任意销售订单，点击「Ship with atoship」拉取各大承运商的实时运费，选择后一键购买。之后即可打印面单、更新与追踪单号——运费已缓存，再次打开立即显示。
批量发货
在销售订单列表选中多单，通过 Actions >「Ship with atoship」批量出单；或点「Open Ship Queue」进入发货工作台，把所有待发订单集中处理。
在 ERPNext 发货所需的一切
一套完整的发货流程，直接嵌入你现有的 ERPNext 系统
开源，git 安装
通过 bench get-app 从 GitHub 安装，MIT 许可，代码完全公开。自托管或 Frappe Cloud 皆可，不依赖任何应用市场或授权码。
多承运商运费比价
在销售订单里并排比较各大承运商的实时运费。一键选择最便宜或最快的方案。
一键 + 批量购买面单
单个订单一键出单；也可在列表或 Ship Queue 里选中多单，从底部批量操作栏一次买齐所有面单。
追踪单号自动回写
购买面单后，追踪单号与承运商会自动写回对应的销售订单，团队在 ERPNext 里随时可查、可追踪。
签名、保险、作废退款
按需为每一单勾选签名或保险。已发货的订单可一键作废面单并自动退款，全程留在 ERPNext 内完成。
折扣运费，无月费
使用 atoship 议定的折扣运费，按单从钱包扣费——没有每张面单的月度订阅费，用多少付多少。
手动发货 vs. atoship
看看每一单能为你省下多少时间
| 任务 | 手动流程 | 使用 atoship |
|---|---|---|
| 录入订单 | 手动抄录销售订单信息 | 直接读取销售订单 |
| 运费比价 | 逐一打开各承运商官网 | 各大承运商一屏尽览 |
| 生成面单 | 在承运商网站手动填地址 | 销售订单一键出单 |
| 追踪更新 | 手动把单号填回订单 | 自动回写到销售订单 |
| 批量发货 | 一次只能处理一单 | Ship Queue 全选，一键批量 |
| 计费方式 | 各承运商分别开户结算 | 折扣运费，钱包统一扣费 |
技术细节
面向开发者和系统管理员的技术说明
开源 · MIT 许可
应用代码公开托管在 GitHub，采用 bench 命令安装：
- bench get-app atoship-for-erpnext
- install-app atoship_shipping
要求 ERPNext v15+（自托管或 Frappe Cloud），以及一个有余额的 atoship 钱包和 API 密钥。
Ship Queue 工作台
原生页面 /app/atoship-ship 把所有已提交、未发货的订单汇总到一张表：逐行发货地址、可编辑重量/尺寸、自动获取且可切换的运费、签名与保险开关，一键发货；选中多单即可从置顶批量栏一次买齐。已发货行显示追踪、打印与作废（作废并退款）。
thin client 架构
所有比价、承运商路由与面单生成都运行在 atoship 的 v1 API 上，界面只展示真实、名牌的承运商，而非后端聚合商。运费会被缓存，重新打开订单即刻显示。用 ak_test_ 密钥可空跑演练，ak_live_ 密钥为真实下单。
常见问题
如何安装 atoship for ERPNext？
它是一个通过 git 安装的自托管 Frappe 应用，不走 OAuth 或应用市场。在你的服务器上依次执行 bench get-app https://github.com/atoship/atoship-for-erpnext、bench --site your-site install-app atoship_shipping、bench --site your-site migrate 即可。前提是 ERPNext v15+（自托管或 Frappe Cloud）以及一个有余额的 atoship 钱包和 API 密钥。
支持哪些 ERPNext / Frappe 版本？
应用面向 ERPNext v15 及以上版本，兼容自托管部署与 Frappe Cloud。代码以 MIT 许可开源，托管在 GitHub 上，可自由审阅与二次开发。
它处理的是哪种单据？
销售订单（Sales Order）——ERPNext 的销售出货单据。流程与 Shopify / WooCommerce 应用发货店铺订单完全一致：订单进来 → 发货 → 追踪单号回写到订单。工作台只会列出已提交、尚未发货的销售订单。
在哪里发货、有哪些界面？
三处入口：① 销售订单表单上的「Ship with atoship」按钮，拉取运费、选择、购买，然后打印面单 / 更新追踪 / 追踪包裹；② 销售订单列表通过 Actions 批量出单，并有「Open Ship Queue」入口；③ Ship Queue 发货工作台（原生页面 /app/atoship-ship），把所有待发订单集中到一张表里，支持逐行发货地址、可编辑重量/尺寸、自动获取并可切换的运费、签名与保险开关，以及一键发货和底部批量操作栏。
支持哪些承运商？
各大真实、知名的承运商。atoship 是一个 thin client：所有比价、承运商路由与面单生成都在 atoship 的 v1 API 上完成，界面上始终只展示真实、名牌的承运商，而非后端聚合商。仅支持包裹（parcel）运输，不含 freight / LTL 整车零担。
收费吗？可以先测试吗？
应用本身开源免费，没有每张面单的月度订阅费。购买面单时从 atoship 钱包按折扣运费扣费。你可以先用 ak_test_ 开头的测试密钥空跑演练，不产生真实面单和扣费；换成 ak_live_ 密钥后即为真实下单。