mengdodo / ngpopen
管家婆
Installs: 2
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Type:libray
Requires
- php: ^8.1
This package is auto-updated.
Last update: 2025-06-10 07:28:15 UTC
README
管家婆云仓自动发货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接口中列表的元素IDGUANJIAPO_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:网店 => 订单处理策略 => 审核策略 => 自动审核(自动执行策略审核) => 开启自动审核
-
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"}