Skip to content

M
meibuyu-rpc
Commit 57b0d1f7 authored by carlos's avatar carlos
Browse files
Options

所有仓库rpc接口

parent 43eee149
Hide whitespace changes
Inline Side-by-side
Showing with 356 additions and 349 deletions
src/Service/Interfaces/Store/StoreServiceInterface.php
View file @ 57b0d1f7
<?php <?php
/** /**
* Created by PhpStorm. * Created by PhpStorm.
* User: 王源 * User: 王源
* Date: 2020/3/16 * Date: 2020/3/16
* Time: 15:07 * Time: 15:07
*/ */
namespace Meibuyu\Rpc\Service\Interfaces\Store; namespace Meibuyu\Rpc\Service\Interfaces\Store;
interface StoreServiceInterface interface StoreServiceInterface
{ {
/** /**
* 通过id列表获取仓库名称 * 通过id列表获取仓库名称
* @param array $idList 仓库id的列表, 默认去重 * @param array $idList 仓库id的列表, 默认去重
* @param array $columns 仓库表的字段，默认显示全部 * @param array $columns 仓库表的字段，默认显示全部
* @return array 默认keyBy('id') * @return array 默认keyBy('id')
*/ */
public function getByIdList(array $idList, array $columns = ['*']): array; public function getByIdList(array $idList, array $columns = ['*']): array;
/** /**
* description:通过产品id数组获取库存列表 给订单系统查询的接口 * description:通过产品id数组获取库存列表 给订单系统查询的接口
* author: fuyunnan * author: fuyunnan
* @param array $ids 产品ids 数组 * @param array $ids 产品ids 数组
* @param int $wareId 仓库id * @param int $wareId 仓库id
* @param array $notWareId 仓库id * @param array $notWareId 仓库id
* @return array * @return array
* @throws * @throws
* Date: 2020/7/27 * Date: 2020/7/27
*/ */
public function getListStock($ids, $wareId = 0, $notWareId = []): array; public function getListStock($ids, $wareId = 0, $notWareId = []): array;
/** /**
* description:根据筛选条件获取仓库的库存列表 对库存筛选实现大一统 * description:根据筛选条件获取仓库的库存列表 对库存筛选实现大一统
* 参数格式 不需要可不传入对应的键 * 参数格式 不需要可不传入对应的键
* $args['inTeamIds'] =[]; * $args['inTeamIds'] =[];
* $args['notInTeamIds'] = []; * $args['notInTeamIds'] = [];
* $args['inWhIds'] = []; //仓库id * $args['inWhIds'] = []; //仓库id
* $args['notInWhIds'] = []; * $args['notInWhIds'] = [];
* $args['inProductIds'] = []; * $args['inProductIds'] = [];
* $args['notInProductIds'] = []; * $args['notInProductIds'] = [];
* $args['where'] = []; * $args['where'] = [];
* $args['group'] = ['product_id'];//默认['product_id'] * $args['group'] = ['product_id'];//默认['product_id']
* $args['keyBy'] = 'product_id';//默认排序 * $args['keyBy'] = 'product_id';//默认排序
* $args['isKeyBy'] = $condition['isKeyBy'] ?? true;//是否加keyBy; * $args['isKeyBy'] = $condition['isKeyBy'] ?? true;//是否加keyBy;
* $args['isGroupBy'] = $condition['isGroupBy'] ?? true;//是否加分组; * $args['isGroupBy'] = $condition['isGroupBy'] ?? true;//是否加分组;
* *
* author: fuyunnan * author: fuyunnan
* @param array $condition 筛选条件 * @param array $condition 筛选条件
* @return array * @return array
* @throws * @throws
* Date: 2020/7/27 * Date: 2020/7/27
*/ */
public function getListStockWhere($condition): array; public function getListStockWhere($condition): array;
/** /**
* description:检查是否有库存，有就返回库存数量（有记录） 给产品系统使用 * description:检查是否有库存，有就返回库存数量（有记录） 给产品系统使用
* author: fuyunnan * author: fuyunnan
* @param array $ids 仓库产品的id数组 * @param array $ids 仓库产品的id数组
* @return array * @return array
* @throws * @throws
* Date: 2020/7/31 * Date: 2020/7/31
*/ */
public function checkStock($ids): array; public function checkStock($ids): array;
/** /**
* description:创建入库单 * description:创建入库单
* author: fuyunnan * author: fuyunnan
* @param array $data 需要入库的数组 格式 入库添加 * @param array $data 需要入库的数组 格式 入库添加
* * * *
* data[master][warehousing_date]:2020-01-08 入库时间 * data[master][warehousing_date]:2020-01-08 入库时间
* data[master][creator_id]:12 创建人id * data[master][creator_id]:12 创建人id
* data[master][warehouse_id]:2 仓库id * data[master][warehouse_id]:2 仓库id
* data[master][type_id]:1 入库单类型 * data[master][type_id]:1 入库单类型
* data[master][source_no]:no_121333 来源单号 （选填） * data[master][source_no]:no_121333 来源单号 （选填）
* data[master][stock_up_status]:1二次质检状态 （选填） * data[master][stock_up_status]:1二次质检状态 （选填）
* data[master][remark]:备注 （选填） * data[master][remark]:备注 （选填）
* data[master][status]:2 状态 （选填 不填默认1） * data[master][status]:2 状态 （选填 不填默认1）
* *
* 产品二维数组 * 产品二维数组
* data[goods][0][product_id]:16 产品id * data[goods][0][product_id]:16 产品id
* data[goods][0][should_cnt]:133 应入数量 * data[goods][0][should_cnt]:133 应入数量
* data[goods][0][real_cnt]:10 实入数量 * data[goods][0][real_cnt]:10 实入数量
* data[goods][1][product_id]:18 * data[goods][1][product_id]:18
* data[goods][1][should_cnt]:10 * data[goods][1][should_cnt]:10
* data[goods][1][real_cnt]:15 * data[goods][1][real_cnt]:15
* *
* 或者参考yapi http://api.huaperfect.com/project/38/interface/api/1617 * 或者参考yapi http://api.huaperfect.com/project/38/interface/api/1617
* *
* @return array * @return array
* @throws * @throws
* Date: 2020/7/6 * Date: 2020/7/6
*/ */
public function createWarehousing(array $data): array; public function createWarehousing(array $data): array;
/** /**
* description:批量创建出库单 * description:批量创建出库单
* author: fuyunnan * author: fuyunnan
* [ * [
* 'main' => [ * 'main' => [
*     'creator_id' => 1, *     'creator_id' => 1,
*     'warehouse_id' => 1, *     'warehouse_id' => 1,
*     'type' => 5, *     'type' => 5,
* ], * ],
* 'products' => [ * 'products' => [
* [ * [
*     'source_no' => 1, *     'source_no' => 1,
*     'product_id' => 1, *     'product_id' => 1,
*     'real_cnt' => 1 *     'real_cnt' => 1
* ], * ],
* [ * [
*     'source_no' => 1, *     'source_no' => 1,
*     'product_id' => 1, *     'product_id' => 1,
*     'real_cnt' => 1 *     'real_cnt' => 1
* ] * ]
* ] * ]
* ] * ]
* *
* @param array $attributes 提交的数组 或参考yapi http://api.huaperfect.com/project/38/interface/api/6968 * @param array $attributes 提交的数组 或参考yapi http://api.huaperfect.com/project/38/interface/api/6968
* @return bool * @return bool
* @throws * @throws
* Date: 2020/8/8 * Date: 2020/8/8
*/ */
public function createBatchWarehousing(array $attributes): bool; public function createBatchWarehousing(array $attributes): bool;
/** /**
* description:根据入库单状态，判断是否生成出库单 * description:根据入库单状态，判断是否生成出库单
* author: fuyunnan * author: fuyunnan
* @param array $data 需要入库或者出库的数据 * @param array $data 需要入库或者出库的数据
* @return bool * @return bool
* @throws * @throws
* Date: 2021/5/25 * Date: 2021/5/25
*/ */
public function createInOrOutOrder(array $data): bool; public function createInOrOutOrder(array $data): bool;
/** /**
* description:创建入库单 支持自定义 入库单状态和仓位 * description:创建入库单 支持自定义 入库单状态和仓位
* author: fuyunnan * author: fuyunnan
* @param array $attributes 需要入库的数组 格式请参考yapi 入库添加 * @param array $attributes 需要入库的数组 格式请参考yapi 入库添加
* @return bool * @return bool
* @throws * @throws
* Date: 2020/7/6 * Date: 2020/7/6
*/ */
public function createWarehousingStatus(array $attributes): bool; public function createWarehousingStatus(array $attributes): bool;
/** /**
* description:批量创建出库单,多个仓库 直接出虚拟仓 * description:批量创建出库单,多个仓库 直接出虚拟仓
* author: fuyunnan * author: fuyunnan
* @param array $attributes 提交的数组 参考yapi http://api.huaperfect.com/project/38/interface/api/6968 * @param array $attributes 提交的数组 参考yapi http://api.huaperfect.com/project/38/interface/api/6968
* @return bool * @return bool
* @throws * @throws
* Date: 2020/8/8 * Date: 2020/8/8
*/ */
public function createBatchWarehousingStatus(array $attributes): bool; public function createBatchWarehousingStatus(array $attributes): bool;
/** /**
* description:批量创建出库单,出库单直接出库 * description:批量创建出库单,出库单直接出库
* author: fuyunnan * author: fuyunnan
* @param array $attributes 提交的数组 参考yapi http://api.huaperfect.com/project/38/interface/api/6968 * @param array $attributes 提交的数组 参考yapi http://api.huaperfect.com/project/38/interface/api/6968
* @return bool * @return bool
* @throws * @throws
* Date: 2020/8/8 * Date: 2020/8/8
*/ */
public function createBatchExComplete(array $attributes): bool; public function createBatchExComplete(array $attributes): bool;
/** /**
* description:批量创建入库单 * description:批量创建入库单
* author: fuyunnan * author: fuyunnan
* @param array $attributes 需要入库的数组 格式请参考yapi 入库添加 * @param array $attributes 需要入库的数组 格式请参考yapi 入库添加
* @return bool * @return bool
* @throws * @throws
* Date: 2020/7/6 * Date: 2020/7/6
*/ */
public function createBatchInOrder(array $attributes): bool; public function createBatchInOrder(array $attributes): bool;
/** /**
* description:批量创建入库单,能自定义入库单状态 * description:批量创建入库单,能自定义入库单状态
* author: fuyunnan * author: fuyunnan
* @param array $attributes 需要入库的数组 格式请参考yapi 入库添加 * @param array $attributes 需要入库的数组 格式请参考yapi 入库添加
* @return bool * @return bool
* @throws * @throws
* Date: 2020/7/6 * Date: 2020/7/6
*/ */
public function createBatchInOrderStatus(array $attributes): bool; public function createBatchInOrderStatus(array $attributes): bool;
/** /**
* description:生产单结束获取统计单号值 * description:生产单结束获取统计单号值
* author: fuyunnan * author: fuyunnan
* @param string $sourceNo 生产单号 * @param string $sourceNo 生产单号
* @return array * @return array
* @throws * @throws
* Date: 2020/7/10 * Date: 2020/7/10
*/ */
public function CntSourceNoOrder($sourceNo): array; public function CntSourceNoOrder($sourceNo): array;
/** /**
* description:通过来源单号获取产品列表 * description:通过来源单号获取产品列表
* author: fuyunnan * author: fuyunnan
* @param string $sourceNo 生产单号 * @param string $sourceNo 生产单号
* @return array * @return array
* @throws * @throws
* Date: 2020/7/10 * Date: 2020/7/10
*/ */
public function listSourceNoProduct($sourceNo): array; public function listSourceNoProduct($sourceNo): array;
/** /**
* description:根据来源单号，获取分组后的入库单 * description:根据来源单号，获取分组后的入库单
* author: fuyunnan * author: fuyunnan
* @param array $sourceNoList 单号列表 * @param array $sourceNoList 单号列表
* @param array $where 刷选列表 * @param array $where 刷选列表
* @return array * @return array
* @throws * @throws
* Date: 2020/7/11 * Date: 2020/7/11
*/ */
public function listGroupOrder($sourceNoList, $where = []): array; public function listGroupOrder($sourceNoList, $where = []): array;
/** /**
* description:根据条件查询入库单信息 * description:根据条件查询入库单信息
* author: fuyunnan * author: fuyunnan
* 参数注意 必须这样传!!! * 参数注意 必须这样传!!!
* $condition = [ * $condition = [
* 'warehousing_order_ids' =>$ids 可选 入库单ids数组 * 'warehousing_order_ids' =>$ids 可选 入库单ids数组
* ] * ]
* @param array $condition 条件 * @param array $condition 条件
* @return array * @return array
* @throws * @throws
* Date: 2020/7/11 * Date: 2020/7/11
*/ */
public function getListInOrder($condition): array; public function getListInOrder($condition): array;
/** /**
* description:通过入库单id数组获取产品列表 * description:通过入库单id数组获取产品列表
* author: fuyunnan * author: fuyunnan
* @param array $ids 入库单ids 数组 * @param array $ids 入库单ids 数组
* @return array * @return array
* @throws * @throws
* Date: 2020/7/10 * Date: 2020/7/10
*/ */
public function listIdsProduct($ids): array; public function listIdsProduct($ids): array;
/** /**
* description:修改二次质检状态 * description:修改二次质检状态
* author: fuyunnan * author: fuyunnan
* @param int $orderId 入库单id * @param int $orderId 入库单id
* @param array $update 修改数组 * @param array $update 修改数组
* @return int * @return int
* @throws * @throws
* Date: 2020/7/14 * Date: 2020/7/14
*/ */
public function updateQualityStatus($orderId, $update): int; public function updateQualityStatus($orderId, $update): int;
/** /**
* description:修改二次质检状态 * description:修改二次质检状态
* author: fuyunnan * author: fuyunnan
* @param array $orderIds 入库单id数组 * @param array $orderIds 入库单id数组
* @param array $update 修改数组 * @param array $update 修改数组
* @return int * @return int
* @throws * @throws
* Date: 2020/7/14 * Date: 2020/7/14
*/ */
public function updateListQualityStatus($orderIds, $update): int; public function updateListQualityStatus($orderIds, $update): int;
/** /**
* description:出库单 恢复库存 出库单定为已取消 * description:出库单 恢复库存 出库单定为已取消
* author: fuyunnan * author: fuyunnan
* @param array $sourceNo 来源单号数组 * @param array $sourceNo 来源单号数组
* @return int * @return int
* @throws * @throws
* Date: 2020/9/7 * Date: 2020/9/7
*/ */
public function restoreStock($sourceNo): int; public function restoreStock($sourceNo): int;
/** /**
* description:通过出库来源单号获取-对应的信息 * description:通过出库来源单号获取-对应的信息
* author: fuyunnan * author: fuyunnan
* @param array $sources 来源单号数组 * @param array $sources 来源单号数组
* @param array $status 出库单状态 * @param array $status 出库单状态
* @param array $where 查询条件数组 * @param array $where 查询条件数组
* @return array * @return array
* @throws * @throws
* Date: 2020/11/5 * Date: 2020/11/5
*/ */
public function getByExSourceList($sources, $status = [], $where = []): array; public function getByExSourceList($sources, $status = [], $where = []): array;
/** /**
* description:自动返回匹配的符合当前sku * description:自动返回匹配的符合当前sku
* author: fuyunnan * author: fuyunnan
* @param array $data sku数组 * @param array $data sku数组
* @return array * @return array
* @throws * @throws
* Date: 2020/11/25 * Date: 2020/11/25
*/ */
public function autoSkuStock($data): array; public function autoSkuStock($data): array;
/** /**
* description:订单通知取消更改字段 不在生成出库单 * description:订单通知取消更改字段 不在生成出库单
* author: fuyunnan * author: fuyunnan
* @param string $sourceNos 来源单号 * @param string $sourceNos 来源单号
* @param array $field 修改字段 * @param array $field 修改字段
* @return int * @return int
* @throws * @throws
* Date: 2020/12/14 * Date: 2020/12/14
*/ */
public function cancelOrderDeliver($sourceNos, $field): int; public function cancelOrderDeliver($sourceNos, $field): int;
/** /**
* 通过仓库区域id获取仓库区域信息 * 通过仓库区域id获取仓库区域信息
* @param array $ids * @param array $ids
* @return array * @return array
*/ */
public function getWarehouseAreaByIdList(array $ids = []): array; public function getWarehouseAreaByIdList(array $ids = []): array;
/** /**
* 获取样品仓库列表 * 获取样品仓库列表
* *
* @param array $columns 字段数组 * @param array $columns 字段数组
* @return array * @return array
*/ */
public function getSampleWarehouseList(array $columns = ['id', 'name']): array; public function getSampleWarehouseList(array $columns = ['id', 'name']): array;
/** /**
* 备货发货接收对应的明细数据 * 备货发货接收对应的明细数据
* @param array $params * @param array $params
* @return array * @return array
*/ */
public function stockUpDeliveryDispatched(array $params): array; public function stockUpDeliveryDispatched(array $params): array;
/** /**
* 取消备货发货记录 * 取消备货发货记录
* @param array $params * @param array $params
* @return array * @return array
*/ */
public function cancelStockUpDelivery(array $params): array; public function cancelStockUpDelivery(array $params): array;
/** /**
* 备货相关异常接收对应的指令 * 备货相关异常接收对应的指令
* @param $commandType * @param $commandType
* @param $payload * @param $payload
* @return mixed * @return mixed
*/ */
public function receiveCommand4StockUp($commandType, $payload); public function receiveCommand4StockUp($commandType, $payload);
}
/**
* description:获取仓库所有名称 keyBy(id)
* @param array $columns 字段
* @return array
*/
public function listWarehouse($columns = ['id', 'name', 'locked']): array;
}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment