README

管家婆ERP 管家婆章鱼侠API.

应该是目前第一个比较完善的支持管家婆 ERP、章鱼侠 ERP 的第三方扩展包了。在使用本扩展之前，请务必确认您已经在 管家婆-章鱼侠 获取了接口调用权限！

安装

$ composer require imactool/gjpzyx:dev-main -vvv

具体的参数要求和返回参数请查阅产品文档

管家婆ERP文档：点击查看

章鱼侠ERP文档：点击查看

使用方法

管家婆

• 初始化

require './vendor/autoload.php';
use Imactool\Gjpzyx\Factory;

$config = [
    'debug'=>false, //是否在测试环境下测试,线上必须设置 false
    'appKey' 	=> '',
    'appSecret' => '',
    'signKey'   => '',
    'token'		=> '',
    'shopKey'	=> '',
    //公司名称
    'CompanyName'=>'',
    //用户名
    'UserId'	=> '',
    //密码
    'Password'	=> '',
    'refreshToken' => '',
    //线上登录获取授权认证码的地址
    'loginUrl'=>'',
    //线上接口调用的地址
    'apiUrl'=>'http://ca.mygjp.com:8002/api/', //注意，需要 / 结尾
    //线上章鱼侠云erp登录地址
    'onlineLoginUrl'=>''
];
 
$app = Factory::Gjp($config);
如果是章鱼侠ERP
$app = Factory::Zyx($config);
其他调用方式都是一模一样

• querySaleQty() 批量获取ERP商品基本资料的库存信息

$parsm = [
    'numid'=>'324324324324',
    'ktypeids'=>[154274961429839227,154274961429839299],
    'iscalcsaleqty'=>true,
    'pagesize'=>100,
    'pageno' => 1
];
$productquery = $app->querySaleQty($parsm);

• pushStoreInfo() 上载门店信息

$storeArr = [
	'Id' =>1,
	'storecode'=>'sdf',
	'storename'=>'测试',
	'storetype'=>3,
	'image'=>'',
	'storephonenumber'=>'18355522221',
	'storeaddress'=>'门店地址'
];

$store = $app->pushStoreInfo($storeArr);

• pushOrderRefund() 添加售后单

$refundOrder = [
	'refundnumber' =>'1154654656151',
	'tradeid'=>'123123151561561',
	'refundcreatetime'=>'2017-07-11 11:11:11',
	'refundtype'=>0,
	'refundstatus'=>1,
	'oid'=>'2345446546',
	'qty'=>1,
    'refundfee'=>100,
    //...其他参数
];

$result = $app->pushOrderRefund($refundOrder);

管家婆API 列表

商品管理

• pushProduct() 宝贝上载
• queryProduct() 商品详情查询

订单交易

• pushOrder() 订单批量上载/更新接口
• queryOrderStatus() 查询订单处理状态
• querySaleOrder() 订单查询

售后场景

• pushOrderRefund() 售后单上载
• queryOrderRefund() 查询售后详情

库存管理

• queryQtyInfo() 仓库详情查询
• querySaleQty() 商品库存查询
• queryMoreSaleQty() 批量库存查询

全渠道场景/门店

• pushStoreInfo() 门店信息上载

分割线：由于章鱼侠相关的测试接口无法正常使用，目前暂不支持。管家婆相关接口正常。

##章鱼侠 API 列表

商品管理

• pushProduct() 宝贝上载
• queryProduct() 商品详情查询

订单交易

• pushOrder() 订单批量上载/更新接口
• queryOrderStatus() 查询订单处理状态
• querySaleOrder() 订单查询

售后场景

• pushOrderRefund() 售后单上载
• queryOrderRefund() 查询售后详情

库存管理

• queryQtyInfo() 仓库详情查询
• querySaleQty() 商品库存查询
• queryMoreSaleQty() 批量库存查询

全渠道场景/门店

• pushStoreInfo() 门店信息上载

TODO

• 目前参数没有做过滤处理
• 文档完善
• 代码完善
• tests

贡献

您可以通过以下三种方式之一进行贡献

1. 使用 问题跟踪器 提交错误报告。
2. 在 问题跟踪器 上回答问题或修复错误。
3. 贡献新功能或更新wiki。

代码贡献过程并不非常正式。您只需确保遵循 PSR-0、PSR-1 和 PSR-2 编码规范。任何新的代码贡献都必须附带适用的单元测试。

许可证

MIT