PHPackages                             mengdodo/ngpopen - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. mengdodo/ngpopen

ActiveLibray

mengdodo/ngpopen
================

管家婆

1.0.2(1y ago)03MITPHPPHP ^8.1

Since Mar 19Pushed 1y ago1 watchersCompare

[ Source](https://github.com/mengdodo/ngpopen)[ Packagist](https://packagist.org/packages/mengdodo/ngpopen)[ RSS](/packages/mengdodo-ngpopen/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

#### 管家婆云仓自动发货PHP

[](#管家婆云仓自动发货php)

- 授权接入文档：
- 接口文档：

#### 说明

[](#说明)

当前package包仅适用于自建商城对接云仓完成自动发货的动作，管家婆在两者之间起到衔接的作用。

#### 流程

[](#流程)

- 1、购买【网上管家婆云进销存/网店ERP】+ 云仓(外接wms)功能
- 2、注册成为开发者（ISV）并创建应用
- 3、composer require mengdodo/ngpopen
- 4、env配置

    - `GUANJIAPO_APP_STATE` state参数，随便给个字母数字的组合
    - `GUANJIAPO_APP_KEY` ISV应用信息
    - `GUANJIAPO_APP_SECRET` ISV应用信息
    - `GUANJIAPO_MERCHANT_ID` 登录管家婆云进销存/网店ERP, 店铺id: 管家婆erp => 资料 => 店铺 => 网店 通过浏览器开发者工具查API接口中列表的元素ID
    - `GUANJIAPO_FREIGHT_CODE` 登录管家婆云进销存/网店ERP, 物流id: 管家婆erp => 资料 => 物流 => 物流公司 通过浏览器开发者工具查API接口中列表的元素ID
- 5、浏览器访问项目下的路径 `/ngp/getAuth` ,将获取的url再次贴入浏览器地址栏回车访问并完成网页授权，完成授权后会打印 access\_token 等信息，之后关闭浏览器。
- 6、开始对接API

```
// 自建商城发货API
// https://ngpopen.wsgjp.com/#/document/2
// 1、先查询出管家婆中对应的商品信息（前提已经在管家婆中完成新增）`线上商品id` `线上商品名称 fullName` `线上商品skuid`
$goods = app('ngpSdk')->pTypeList(["pageSize" => 10, "pageIndex" => 1]);

// 2、提交订单到管家婆 【文档 14.2. 网店销售单上载】
$res = app('ngpSdk')->eshopSaleOrderUpload($data);

// $data 数据
array:2 [▼
  "otypeId" => 15500000000000000 //店铺id
  "orders" => array:1 [▼
    0 => array:15 [▼
      "tradeId" => "20250314105739724540"
      "tradeStatus" => 2
      "buyerMessage" => ""
      "tradeCreateTime" => "2025-03-14 10:57:39"
      "tradePayTime" => "2025-03-14 10:57:43"
      "freightCode" => "zto"
      "tradeType" => 0
      "tradeTotal" => "117.00"
      "sellerPreferentialTotal" => 0
      "platformPreferentialTotal" => 0
      "selfDeliveryMode" => 1
      "deliverType" => 2
      "eshopBuyer" => array:6 [▼
        "customerReceiver" => "张三"
        "customerReceiverMobile" => "13111111111"
        "customerReceiverProvince" => "湖北省"
        "customerReceiverCity" => "荆门市"
        "customerReceiverDistrict" => "掇刀区"
        "customerReceiverAddress" => "某某小区3-123"
      ]
      "invoice" => array:1 [▼
        "invoiceRequired" => false
      ]
      "orderDetails" => array:1 [▼
        0 => array:8 [▼
          "platformNumId" => "1558527555933443999" // `线上商品id`
          "platformProductName" => "仙手指物料包" // `线上商品名称 fullName`
          "oid" => "orderItem_141"
          "picUrl" => "https://www.xxx.com/images/20250301104720.jpg"
          "platformSkuId" => "15591111111111111" // `线上商品skuid`
          "tradeTotal" => "117.00"
          "unitQty" => 2 // 商品数量
          "refundStatus" => 0
        ]
      ]
    ]
  ]
]

// 提交成功后前往管家婆erp：网店 => 平台原始订单池 查看记录
```

- 7、云仓自动发货(自动拆包多个快递发货)
    - 管家婆erp：网店 => 平台原始订单池 查看记录
    - 管家婆erp：网店 => 订单处理策略 => 拆分策略 => 启用【按订单估重拆分】
    - 管家婆erp：网店 => 订单处理策略 => 审核策略 => 自动审核(自动执行策略审核) => 开启自动审核

[![Alt](./pic/chaifen.jpg)](./pic/chaifen.jpg)

[![Alt](./pic/fahuo.jpg)](./pic/fahuo.jpg)

- 8、云仓发货记录查询

    - 云仓 => 出库任务
- 9、物流状态回传

    - 登录 开发者（ISV）开发者后台
    - 选择应用 => 推送管理 => 填写线上项目用于接收物流信息回传的接口，并点击开启，最后订阅消息推送

```
// 物流回传示例
{
	"orderId": "2025011111111111",
	"splitSend": true,
	"freightInfoList": [
		{
			"freightName": "圆通速递",
			"freightCode": "yto",
			"freightBillNo": "YT111111111"
		}
	],
	"subItems": [
		{
			"subOrderId": "orderItem_141",
			"qty": 2.0
		}
	],
	"messageId": "32607736",
	"appkey": "xxxxxxxx",
	"method": "ngp.sale.order.send.sync",
	"timestamp": "1741944685431",
	"sign": "xxxxxxxx",
	"accessToken": "xxxxxxxx"
}

// 项目需要响应 {"code": 0,"message": "success"}
```

[![Alt](./pic/wuliu.jpg)](./pic/wuliu.jpg)

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance46

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

472d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/21698573?v=4)[mengdodo](/maintainers/mengdodo)[@mengdodo](https://github.com/mengdodo)

---

Top Contributors

[![mengdodo](https://avatars.githubusercontent.com/u/21698573?v=4)](https://github.com/mengdodo "mengdodo (3 commits)")

### Embed Badge

![Health badge](/badges/mengdodo-ngpopen/health.svg)

```
[![Health](https://phpackages.com/badges/mengdodo-ngpopen/health.svg)](https://phpackages.com/packages/mengdodo-ngpopen)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)