Skip to content

zmoyi/jushuitan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

94 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

聚水潭 php SDK

已升级 SDK,此版本不在维护,望周知

Latest Stable Version Total Downloads License PHP Version Require

聚水潭的php-sdk

要求

  • php>=7.4.3

安装

composer require zmoyi/jushuitan 

配置以及使用

config全局配置

$config = [
    'authUrl' => 'https://openweb.jushuitan.com/auth',
    'baseUrl' =>'https://dev-api.jushuitan.com/',
    'app_Key' => 'b0b7d1db226d4216a3d58df9ffa2dde5',
    'app_Secret'=> '99c4cef262f34ca882975a7064de0b87',
    'access_token' => 'b7e3b1e24e174593af8ca5c397e53dad'
];

api调用

use zmoyi\JuShuiTan\Api\ApiRequest;
use zmoyi\JuShuiTan\Api\Common\ServeHttp;

$data = [
    'shop_id' => '123456'
]; 
$apiRequest = new ApiRequest($config);
/**
* ServeHttp::XXX为内部定义的接口路由常量
* 也可以直接传路由地址,如:/open/orders/out/simple/query
*/
$response = $apiRequest->request(ServeHttp::QUERY_SKUMAP,$data);

auth调用

use zmoyi\JuShuiTan\Auth\Auth;
/**
* config同上
 */
$Auth = new Auth($config);
/**
* 生成授权链接
 */
$url = $Auth->createUrl();
/**
* code换取Access_Token
 * 请自行处理返回数据
 */
$AccessToken = $Auth->getAccessToken($code);
/**
* 刷新令牌
 * 请自行处理返回数据
 */
$refToken = $Auth->refreshToken($accessToken);

路由定义如下

/**
* 调用示例
 */
 \zmoyi\JuShuiTan\Api\Common\ServeHttp::QUERY_AFTERSALE_RECEIVED;
  /**
     * 基础API路由
     */
    /**
     * 店铺查询
     */
    const QUERY_SHOPS = 'open/shops/query';

    /**
     * 物流公司查询
     */
    const QUERY_LOGISTICSCOMPANY = 'open/logisticscompany/query';

    /**
     * 仓库查询
     */
    const QUERY_PARTNER_WMS = 'open/wms/partner/query';

    /**
     * 分销商查询列表
     */
    const QUERY_DISTRIBUTOR = 'open/jushuitan/distributor/query';

    /**
     * 基础API路由end
     * ------------------------------------------------------------------
     * 商品API路由
     */

    /**
     * 普通商品资料上传
     */
    const UPLOAD_ITEMSKU = '/open/jushuitan/itemsku/upload';

    /**
     * 店铺商品资料上传
     */
    const UPLOAD_SKUMAP = '/open/jushuitan/skumap/upload';

    /**
     * 组合装商品上传
     */
    const UPLOAD_COMBINESKU_ITEM = '/open/jushuitan/item/combinesku/upload';

    /**
     * 店铺商品资料查询
     */
    const QUERY_SKUMAP = '/open/skumap/query';

    /**
     *组合装商品查询
     */
    const QUERY_COMBINE_SKU = '/open/combine/sku/query';

    /**
     * 商品类目查询
     */
    const QUERY_CATEGORY = '/open/category/query';

    /**
     * 普通商品查询(按款查询)
     */
    const QUERY_MALL_ITEM = '/open/mall/item/query';

    /**
     * 普通商品资料查询(按sku查询)
     */
    const QUERY_SKU = '/open/sku/query';

    /**
     * 商品API end
     * ————————————————————————————————————————————————
     * 库存API
     */

    /** 库存查询
     */
    const QUERY_INVENTORY = '/open/inventory/query';

    /**
     * 库存盘点查询
     */
    const QUERY_INVENTORY_COUNT = '/open/inventory/count/query';

    /**
     * 新建盘点单
     */
    const UPLOAD_INVENTORY_V2 = '/open/jushuitan/inventoryv2/upload';

    /**
     * 库存API end
     * ————————————————————————————————————————————————
     * 订单API
     */

    /**
     * 订单上传(商家自有商城、跨境线下)
     */
    const UPLOAD_ORDERS = '/open/jushuitan/orders/upload';

    /**
     * 订单取消-按内部单号取消
     */
    const CANCEL_ORDERBYOID = '/open/jushuitan/orderbyoid/cancel';

    /**
     * 订单查询
     */
    const QUERY_ORDERS_SINGLE = '/open/orders/single/query';

    /**
     * 订单发货
     */
    const UPLOAD_ORDER_SENT = '/open/order/sent/upload';

    /**
     * 订单API end
     * ————————————————————————————————————————————————
     * 物流API
     */

    /**
     * 批量快递登记
     */
    const UPLOAD_EXPRESS_REGISTER = '/open/express/register/upload';

    /**
     * 称重并发货
     */
    const UPLOAD_ORDERS_WEIGHT_SEND = '/open/orders/weight/send/upload';

    /**
     * 发货信息查询
     */
    const QUERY_LOGISTIC = '/open/logistic/query';

    /**
     * 物流API end
     * ———————————————————————————————————————————————————
     * 采购API
     */

    /**
     * 采购单查询
     */
    const QUERY_PURCHASE = '/open/purchase/query';

    /**
     * 采购单上传
     */
    const UPLOAD_PURCHASE = '/open/jushuitan/purchase/upload';

    /**
     * 供应商上传
     */
    const UPLOAD_SUPPLIER = '/open/supplier/upload';

    /**
     * 供应商查询
     */
    const QUERY_SUPPLIER = '/open/supplier/query';

    /**
     * 加工单查询
     */
    const QUERY_MANUFACTURE = '/open/jushuitan/manufacture/query';

    /**
     * 采购API end
     * ————————————————————————————————————————
     * 入库API
     */

    /**
     * 新建采购入库单
     */
    const UPLOAD_PURCHASEIN = '/open/jushuitan/purchasein/upload';

    /**
     * 采购入库查询
     */
    const QUERY_PURCHASEIN = '/open/purchasein/query';

    /**
     * 入库单确认
     */
    const UPLOAD_PURCHASEIN_RECEIVED = '/open/purchasein/received/upload';

    /**
     * 采购按箱入库
     */
    const UPLOAD_PURCHASEIN_CONFIRM = '/open/purchasein/confirm/upload';

    /**
     * 入库API end
     * ————————————————————————————————————
     * 出库API
     */

    /**
     * 销售出库查询
     */
    const QUERY_ORDER_OUT_SIMPLE = '/open/orders/out/simple/query';

    /**
     * 出库发货
     */
    const UPLOAD_ORDERS_WMS_SENT = '/open/orders/wms/sent/upload';

    /**
     * 采购退货查询
     */
    const QUERY_PURCHASEOUT = '/open/purchaseout/query';

    /**
     * 采购退货上传(新)
     */
    const UPLOAD_PURCHASEOUT = '/open/jushuitan/purchaseout/upload';

    /**
     * 出库API end
     * ————————————————————————————————————
     * 售后API
     */

    /**
     * 退货退款查询
     */
    const QUERY_REFUND_SINGLE = '/open/refund/single/query';

    /**
     * 实际收货上传
     */
    const UPLOAD_REFUND_RECEIVE = '/open/refund/receive/upload';

    /**
     * 实际收货查询
     */
    const QUERY_AFTERSALE_RECEIVED = '/open/aftersale/received/query';

    /**
     * 售后上传
     */
    const UPLOAD_AFTERSALE = '/open/aftersale/upload';

    /**
     * 售后API end
     * ————————————————————————————————————
     *其他出入库API
     */

    /**
     * 其它出入库查询
     */
    const QUERY_OTHER_INOUT = '/open/other/inout/query';

    /**
     * 新建其它出入库(新)
     */
    const UPLOAD_OTHERINOUT = '/open/jushuitan/otherinout/upload';

    /**
     * 其他出入库API end
     * ————————————————————————————————————
     *调拨API
     */

    /**
     * 调拨单查询
     */
    const QUERY_ALLOCATE = '/open/allocate/query';

    /**
     * 库存调拨上传(跨仓调拨)
     */
    const UPLOAD_ALLOCATE_KC = '/open/allocate/kc/upload';

    /**
     * 库存调拨上传(仓内调拨)
     */
    const UPLOAD_ALLOCATE_IN = '/open/jushuitan/allocate/in/upload';

开源协议

遵循MIT开源协议

使用交流

QQ

About

聚水潭 php sdk

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages