ckoo/youzan-sdk

youzan sdk

有赞 API PHP SDK

有赞API 的PHP实现, 对有赞官方提供的 KdtApiClient 的进一步封装, _(*1)

-, _(*2)

通讯协议

目前仅支持 AppId / AppSecret 签名通讯协议 适用于：个人开发者、单店铺开发者, _(*3)

-, _(*4)

已实现接口

商品接口
kdt.item.add 新增一个商品
kdt.item.delete 删除一个商品
kdt.item.get 得到单个商品信息
kdt.item.sku.update 更新SKU信息
kdt.item.update 更新单个商品信息
kdt.item.update.delisting 商品下架
kdt.item.update.listing 商品上架
kdt.items.custom.get 根据商品货号获取商品
kdt.items.inventory.get 获取仓库中的商品列表
kdt.items.onsale.get 获取出售中的商品列表
kdt.skus.custom.get 根据外部编号取商品Sku
kdt.items.update.delisting 批量下架商品
kdt.items.update.listing 批量上架商品

商品类目接口
kdt.itemcategories.get 获取商品分类二维列表
kdt.itemcategories.promotions.get 获取商品推广栏目列表
kdt.itemcategories.tags.get 获取商品自定义标签列表
kdt.itemcategories.tags.getpage 分页获取商品自定义标签列表

物流接口
kdt.logistics.online.confirm 卖家确认发货
kdt.logistics.online.marksign 卖家标记签收
kdt.logistics.trace.search 物流流转信息查询

店铺接口
kdt.shop.basic.get 获取店铺基本信息

交易接口
kdt.trade.close 卖家关闭一笔交易
kdt.trade.get 获取单笔交易的信息
kdt.trade.memo.update 修改一笔交易备注
kdt.trades.sold.get 查询卖家已卖出的交易列表

工具接口
kdt.regions.get 获取区域地名列表信息



-
### 安装（Composer）



composer require ckoo/youzan-sdk



##### 依赖



"symfony/filesystem": "~2.8.0",
"netresearch/jsonmapper": "0.10.*"



-
### 使用方法

##### 初始化



AppId: 店铺的AppId(应用ID)
AppSecret: 店铺的AppSecret(应用密钥)
CacheDIR: 文件缓存目录

use Youzan\Youzan;
$youzan = new Youzan(AppId, AppSecret, CacheDIR);

$youzan->goods(); // 获取商品操作类 GoodsService
$youzan->trade(); // 获取订单操作类 TradeService
$youzan->itemcategory(); // 获取商品类目操作类 ItemcategoryService
$youzan->logistics(); // 获取物流操作类 ItemcategoryService
$youzan->shop(); // 获取店铺操作类 ShopService



##### 操作商品



/**
 * 获取商品列表
 */
$service = $youzan->goods(); 
list($items, $total) = $service->itemsOnsaleGet();


/**
 * 添加商品
 */

use Youzan\Service\Parameters\GoodsParamters;

// 创建商品参数对象
$parameters = new GoodsParamters();
$parameters->title = '测试商品标题';
$parameters->price = '999.00';
$parameters->images = array(
    'http://aaa.jpg',
    'http://bbb.jpg',
    '/path/xxxx/images/ccc.jpg'
);
// 添加商品
$item = $service->itemAdd($parameters);




##### 操作订单



/**
 * 获取订单列表
 */

use Youzan\Model\TradeStatus

$service = $youzan->trade();
list($result, $total) = $service->tradesSoldGet(TradeStatus::WAIT_BUYER_CONFIRM_GOODS);



##### 操作订单



/**
 * 上一次API请求的错误信息
 */

$error = $service->getLastError();