非官方聚水潭开放平台 SDK
初始化：
JstConfiguration configuration = JstConfiguration.builder()
.endpoint("https://openapi.jushuitan.com")
.credential("Your App Key", "Your App Secret")
.build();
JstClient client = new DefaultJstClient(configuration);方式一：
JstBaseClient baseClient = client.base();
JstQueryShopsRequest request = JstQueryShopsRequest.builder()
.shopIds(Arrays.asList(12343451, 17138865))
.build();
JstQueryShopsResponse response = baseClient.queryShops(request);方式二：
JstQueryShopsResponse response = client.base()
.queryShops()
.shopIds(Arrays.asList(12343451, 17138865))
.response();配置 JstClient：
jst:
endpoint: https://openapi.jushuitan.com
credential:
app-key: Your App Key
app-secret: Your App Secret
token-store:
# 默认为 caffeine
type: jedis
# 当仅当 type 为 jedis 时需要配置
jedis:
host: 127.0.0.1
port: 6379
database: 0
user: redis user
password: redis password
sslEnabled: true自定义 JstClient：
@Bean
public JstConfigurationBuilderCustomizer customizer() {
return builder -> {
builder.httpClientFactory(
new DefaultJstHttpClientFactory()
.httpRequestFactory(
new OkHttp3JstHttpRequestFactory()
)
);
};
}注入 JstClient：
@Resource
JstClient jstClient;| API | 接口路径 | 接口名称 | 方法名称 |
|---|---|---|---|
| 基础API | /open/shops/query | 店铺查询 | JstClient.base().queryShops() |
| /open/logisticscompany/query | 物流公司查询 | JstClient.base().queryLogisticsCompany() | |
| /open/wms/partner/query | 仓库查询 | JstClient.base().queryWmsPartner() | |
| /open/api/company/inneropen/partner/channel/querymysupplier | 供销商查询 | JstClient.base().queryMySupplierByPartnerChannel() | |
| /open/webapi/userapi/company/getcompanyusers | 商家用户信息 | JstClient.base().getCompanyUsers() | |
| /open/api/drp/inneropen/partner/supplier/querymychannel | 分销商查询 | JstClient.base().queryMyChannelBySupplier() | |
| 商品API | /open/webapi/itemapi/suppliersku/getsupplierskulist | 商品多供应商查询 | JstClient.item().getSupplierSkuList() |
| /open/webapi/itemapi/itemsku/setskubins | 更新商品库容信息 | JstClient.item().setSkuBins() | |
| /open/jushuitan/itemsku/costprice/upload | 商品历史成本价上传 | JstClient.item().uploadItemSkuCostPrice() | |
| /open/webapi/itemapi/bom/save | BOM信息上传 | JstClient.item().saveBom() | |
| /open/webapi/itemapi/category/addorupdate | 商品类目上传/更新 | JstClient.item().addOrUpdateCategory() | |
| /open/webapi/itemapi/suppliersku/save | 新增/修改商品多供应商 | JstClient.item().saveSupplierSku() | |
| /open/jushuitan/itemsku/upload | 普通商品资料上传 | JstClient.item().uploadItemSku() | |
| /open/webapi/itemapi/itemsku/gethistorycostpricev2 | 获取商品历史成本价 | JstClient.item().getHistoryCostPriceV2() | |
| /open/webapi/itemapi/bom/getskubompagelist | 商品BOM信息查询 | JstClient.item().getSkuBomPageList() | |
| /open/item/combinesku/upload | 组合装商品上传（批量上传） | JstClient.item().uploadCombineSku() | |
| /open/sku/query | 普通商品资料查询（按sku查询） | JstClient.item().querySku() | |
| /open/mall/item/query | 普通商品查询（按款查询） | JstClient.item().queryMallItem() | |
| /open/category/query | 商品类目查询 | JstClient.item().queryCategory() | |
| /open/combine/sku/query | 组合装商品查询 | JstClient.item().queryCombineSku() | |
| /open/skumap/query | 店铺商品资料查询 | JstClient.item().querySkuMap() | |
| /open/jushuitan/skumap/upload | 店铺商品资料上传 | JstClient.item().uploadSkuMap() | |
| 库存API | /open/inventory/query | 商品库存查询 | JstClient.inventory().queryInventory() |
| /open/inventory/count/query | 库存盘点查询 | JstClient.inventory().queryInventoryCount() | |
| /open/pack/query | 箱及仓位库存查询 | JstClient.inventory().queryPack() | |
| /open/jushuitan/inventoryv2/upload | 新建盘点单-修改库存 | JstClient.inventory().uploadInventoryV2() | |
| /open/webapi/itemapi/iteminventory/batchupdatewmsvirtualqtys | 导入/更新虚拟库存 | JstClient.inventory().batchUpdateWmsVirtualQtys() | |
| 订单API | /open/webapi/orderapi/modifyorder/saveremark | 修改订单卖家备注（按线上单号） | JstClient.order().saveOrderRemark() |
| /open/orders/modifywms/upload | 订单指定发货仓 | JstClient.order().uploadModifyWmsOrder() | |
| /open/webapi/orderapi/questionorder/questions | 订单转异常 | JstClient.order().getQuestionOrderQuestions() | |
| /open/jushuitan/orders/upload | 订单上传(商家自有商城、跨境线下) | JstClient.order().uploadOrders() | |
| /open/jushuitan/drporder/split | 订单拆分 | JstClient.order().splitDrpOrder() | |
| /open/jushuitan/order/remark/upload | 修改订单卖家备注（按内部单号） | JstClient.order().uploadOrderRemark() | |
| /open/order/node/soid/set | 通过订单号修改线下备注 | JstClient.order().setOrderNodeBySoid() | |
| /open/jushuitan/order/label/upload | 订单标签（新增/移除） | JstClient.order().uploadOrderLabel() | |
| /open/order/sent/upload | 订单发货-新 | JstClient.order().uploadOrderSent() | |
| /open/orders/single/query | 订单查询（自有商城、跨境下线） | JstClient.order().querySingleOrder() | |
| /open/order/action/query | 订单操作日志查询 | JstClient.order().queryOrderAction() | |
| /open/jushuitan/orderbyoid/cancel | 订单取消-按内部单号取消 | JstClient.order().cancelOrderByOid() | |
| 物流API | /open/express/register/upload | 批量快递登记 | JstClient.logistics().uploadExpressRegister() |
| /open/orders/weight/send/upload | 称重并发货/快递分拣 | JstClient.logistics().uploadOrderWeightSend() | |
| /open/logistic/query | 发货信息查询 | JstClient.logistics().queryLogistic() | |
| 采购API | /open/purchase/query | 采购单查询 | JstClient.purchase().queryPurchase() |
| /open/jushuitan/purchase/upload | 采购单上传 | JstClient.purchase().uploadPurchase() | |
| /open/supplier/upload | 供应商上传 | JstClient.purchase().uploadSupplier() | |
| /open/supplier/query | 供应商查询 | JstClient.purchase().querySupplier() | |
| /open/jushuitan/manufacture/query | 加工单查询 | JstClient.purchase().queryManufacture() | |
| /open/jushuitan/manufacture/upload | 加工单上传 | JstClient.purchase().uploadManufacture() | |
| /open/jushuitan/purchaselabel/upload | 采购单加工单标签（新增/移除） | JstClient.purchase().uploadPurchaseLabel() | |
| /open/jushuitan/appointmentin/upload | 预约入库上传 | JstClient.purchase().uploadAppointmentIn() | |
| /open/jushuitan/purchasebooking/query | 预约入库查询列表 | JstClient.purchase().queryPurchaseBooking() | |
| /open/jushuitan/purchase/change/status | 变更采购单状态 | JstClient.purchase().changePurchaseStatus() | |
| /open/webapi/wmsapi/purchase/cancel | 采购单/加工单/预约入库单作废 | JstClient.purchase().cancelPurchase() | |
| /open/webapi/wmsapi/openpurchase/editpurchase | 修改采购单 | JstClient.purchase().editPurchase() | |
| 入库API | /open/purchasein/query | 采购入库查询 | JstClient.stockIn().queryPurchaseIn() |
| /open/purchasein/received/upload | 入库单确认 | JstClient.stockIn().uploadPurchaseInReceived() | |
| /open/webapi/wmsapi/purchasein/createbatch | 生成采购入库单-支持批量 | JstClient.stockIn().createPurchaseInBatch() | |
| /open/webapi/wmsapi/skusn/batchadd/simple | 批量录入唯一码 | JstClient.stockIn().batchAddSkusnSimple() | |
| /open/webapi/wmsapi/packsn/batchadd | 批量录入箱唯一码 | JstClient.stockIn().batchAddPacksn() | |
| /open/webapi/wmsapi/purchasein/purchaseinquery | 采购入库查询 | JstClient.stockIn().queryPurchaseInDetails() | |
| 出库API | /open/orders/out/simple/query | 销售出库查询 | JstClient.stockOut().queryOrderOutSimple() |
| /open/orders/wms/sent/upload | 出库发货 | JstClient.stockOut().uploadWmsSentOrders() | |
| /open/purchaseout/query | 采购退货查询 | JstClient.stockOut().queryPurchaseOut() | |
| /open/jushuitan/purchaseout/cancel | 采购退货取消 | JstClient.stockOut().cancelPurchaseOut() | |
| /open/webapi/wmsapi/purchaseout/createbatch | 生成采购退货单-支持批量 | JstClient.stockOut().createPurchaseOutBatch() | |
| 售后API | /open/refund/single/query | 退货退款查询 | JstClient.afterSale().querySingleRefund() |
| /open/aftersale/received/query | 实际收货查询 | JstClient.afterSale().queryAfterSaleReceived() | |
| /open/aftersale/upload | 售后上传 | JstClient.afterSale().uploadAfterSale() | |
| /open/aftersale/noinfo/upload | 售后上传（无信息件) | JstClient.afterSale().uploadNoInfoAfterSale() | |
| /open/webapi/aftersaleapi/confirmgoods | 售后-确认收到货物（可分批确认） | JstClient.afterSale().confirmAfterSaleGoods() | |
| /open/webapi/aftersaleapi/open/unconfirm | 售后单反确认 | JstClient.afterSale().unconfirmAfterSale() | |
| /open/webapi/aftersaleapi/open/confirm | 售后单确认 | JstClient.afterSale().confirmAfterSale() | |
| /open/webapi/aftersaleapi/confirmgoodsbyskusns | 唯一码批量确认收货 | JstClient.afterSale().confirmGoodsBySkusns() | |
| /open/webapi/aftersaleapi/pay/payqueryasmodified | 退款单查询 | JstClient.afterSale().payQueryAsModifiedAfterSale() | |
| 其它出入库API | /open/other/inout/query | 其它出入库查询 | JstClient.otherStocking().queryOtherInOut() |
| /open/jushuitan/otherinout/upload | 新建其它出入库 | JstClient.otherStocking().uploadOtherInOut() | |
| /open/jushuitan/otherinout/cancel | 其它出入库状态变更 | JstClient.otherStocking().cancelOtherInOut() | |
| 调拨API | /open/allocate/query | 调拨单查询 | JstClient.allocate().queryAllocate() |
| /open/allocate/kc/upload | 库存调拨上传（跨仓调拨） | JstClient.allocate().uploadKcAllocate() | |
| /open/jushuitan/allocate/in/upload | 库存调拨上传（仓内调拨） | JstClient.allocate().uploadInAllocate() | |
| /open/jushuitan/allocate/confirm | 调拨单确认 | JstClient.allocate().confirmAllocate() | |
| /open/jushuitan/allocate/cancel/v2 | 调拨单取消 | JstClient.allocate().cancelAllocateV2() | |
| /open/jushuitan/diffallocate/create | 创建调拨差异单 | JstClient.allocate().createDiffAllocate() | |
| 虚拟仓API | /open/webapi/itemapi/lockwarehouse/getlwhallocationlist | 虚拟仓调拨单据分页接口 | JstClient.warehouse().getLwhAllocationList() |
| /open/webapi/itemapi/lockwarehouse/getlwhoperationlist | 虚拟仓分配归还单据分页接口 | JstClient.warehouse().getLwhOperationList() | |
| /open/webapi/itemapi/lockwarehouse/lwhallocationcreate | 虚拟仓调拨单创建接口 | JstClient.warehouse().createLwhAllocation() | |
| /open/webapi/itemapi/lockwarehouse/lwhoperationcreate | 虚拟仓分配/归还单据创建接口 | JstClient.warehouse().createLwhOperation() | |
| /open/webapi/itemapi/lockwarehouse/getwarehouselist | 获取虚拟仓列表 | JstClient.warehouse().getWarehouseList() | |
| /open/webapi/itemapi/iteminventory/getvirtualstock | 虚拟仓商品库存查询 | JstClient.warehouse().getVirtualStock() | |
| /open/webapi/itemapi/lockwarehouse/lockpurchase/createorupdatepurchase | 创建/更新虚拟仓采购申请 | JstClient.warehouse().createOrUpdateLockPurchase() | |
| /open/webapi/itemapi/lockwarehouse/lockpurchase/getpagelockpurchases | 查询虚拟仓采购单 | JstClient.warehouse().getPageLockPurchases() | |
| 跨境API | /open/webapi/cb/cborder/getrefunds | 跨境售后单查询 | JstClient.crossBorder().getCbRefunds() |
| /open/webapi/cb/cborder/getorders | 跨境订单查询 | JstClient.crossBorder().getCbOrders() | |
| /open/webapi/cb/cbfirsttrip/createfirsttrip | 创建头程单 | JstClient.crossBorder().createFirstCbTrip() | |
| /open/webapi/cblogisticsapi/cblogistics/gettrackdetail | 【收费】获取跨境轨迹详情 | JstClient.crossBorder().getCbLogisticsTrackDetail() | |
| /open/webapi/globalapi/skumap/mapping | 1688商品映射推送 | JstClient.crossBorder().mapSkuMap() | |
| /open/webapi/cblogisticsapi/cbexpressstatement/savefee | 尾程运费回写接口 | JstClient.crossBorder().saveCbExpressStatementFee() | |
| /open/webapi/wmsapi/allocate/loadallocatefee | 查询调拨单头程费用 | JstClient.crossBorder().loadAllocateFee() | |
| 聚工单开放API | /open/api/gd/open/workorder/updateworkorder | 商家更新工单数据 | JstClient.workOrder().updateWorkOrder() |
| 财务API | /open/jushuitan/shengsuan/payment/query | 付款单查询 | JstClient.finance().queryShengsuanPayment() |
| /open/jushuitan/shengsuan/payable/query | 应付单查询 | JstClient.finance().queryShengsuanPayable() | |
| 播种API | /open/webapi/wmsapi/wave/bindbinidcarryid | 绑定播种车 | JstClient.seed().bindBinIdCarryIdToWave() |
| /open/jushuitan/wave/get | 获取播种批次信息（支持新版三方仓查询） | JstClient.seed().getJushuitanWave() | |
| /open/jushuitan/seed/callback | 播种回传（出库） | JstClient.seed().callbackSeed() | |
| /open/webapi/wmsapi/wave/unbindinoutbycarryid | 根据播种车号解绑出库单 | JstClient.seed().unbindInOutByCarryId() | |
| /open/jushuitan/seed/return | 播种回传（不出库） | JstClient.seed().returnSeed() | |
| /open/webapi/wmsapi/wave/unbindwavecarryid | 解绑批次拣货车/播种车 | JstClient.seed().unbindWaveCarryId() | |
| /open/jushuitan/binid/carryid/bind | 绑定播种柜号和播种车 | JstClient.seed().bindBinIdCarryId() | |
| /open/jushuitan/carryid/check | 校验播种车的状态是否可用 | JstClient.seed().checkCarryId() | |
| 胜算API | /open/webapi/pfopen/pfopenalifee/getopenalipaybillrecords | 获取胜算平台原始账单 | JstClient.shengsuan().getOpenAlipayBillRecords() |
| /open/webapi/pfopen/pfopenalifee/getopenalipaypromotionfee | 获取胜算店铺级推广费 | JstClient.shengsuan().getOpenAlipayPromotionFee() | |
| /open/webapi/pfopen/pfopenalifee/getopenpfpromotionshopitem | 获取胜算链接级推广费数据 | JstClient.shengsuan().getOpenPfPromotionShopItem() | |
| /open/webapi/pfopen/pfopenorderfee/getopenfeeflowing | 获取胜算日常记账数据 | JstClient.shengsuan().getOpenFeeFlowing() | |
| 供应链对外开放API | /open/api/goods/inneropen/category/querycategorybypid | 通用资料根据父类目ID查询子类目 | JstClient.supplyChainOpen().queryCategoryByPid() |
| /open/api/goods/inneropen/supplier/goods/querydiserpgoodsdata | 供应商价格及库存商品列表 | JstClient.supplyChainOpen().queryDiserpGoodsData() | |
| /open/api/goods/inneropen/oss/uploadimage | 生成商品图片链接 | JstClient.supplyChainOpen().uploadImageToOss() | |
| /open/api/goods/inneropen/goods/batchupdatedistributionstatus | 批量更新商品分销状态 | JstClient.supplyChainOpen().batchUpdateDistributionStatus() | |
| /open/api/goods/inneropen/goods/updategoods | 更新通用商品资料 | JstClient.supplyChainOpen().updateGoods() | |
| /open/api/goods/inneropen/goods/querygoodslist | 查询通用商品资料列表 | JstClient.supplyChainOpen().queryGoodsList() | |
| /open/api/goods/inneropen/goods/querygoodsdetail | 查询通用商品资料详情 | JstClient.supplyChainOpen().queryGoodsDetail() | |
| /open/api/goods/inneropen/goods/addgoods | 添加通用商品资料 | JstClient.supplyChainOpen().addGoods() | |
| /open/api/goods/inneropen/oss/queryosssignature | 查询OSS授权信息 | JstClient.supplyChainOpen().queryOssSignature() | |
| WMSAPI | /open/jushuitan/quicksale/arrival | 快销到货 | JstClient.wms().quickSaleArrival() |
| /open/webapi/wmsapi/openskubinquery/findskubin | 根据箱号查询箱内商品推荐仓位 | JstClient.wms().findSkuBin() | |
| /open/webapi/wmsapi/checkoutopen/singleorderconfirms | 发货-强制审核单件商品缺货订单 | JstClient.wms().confirmSingleOrderCheckout() | |
| /open/jushuitan/recommend/bin/get | 获取推荐仓位 | JstClient.wms().getRecommendBin() | |
| /open/webapi/wmsapi/checkout/getfastdeliveryordercount | 查询极速发货订单数 | JstClient.wms().getFastDeliveryOrderCount() | |
| /open/webapi/wmsapi/shippingpack/addshippingpack | 发货装箱 | JstClient.wms().addShippingPack() | |
| /open/webapi/wmsapi/skusn/queryinoutitemskusns | 唯一码进出流水查询 | JstClient.wms().queryInOutItemSkusns() | |
| /open/webapi/wmsapi/packageentries/saveipcvediorecord | 打包机保存视频记录 | JstClient.wms().saveIpcVedioRecord() | |
| /open/jushuitan/wavestatus/upload | 更新批次拣货状态 | JstClient.wms().uploadWaveStatus() | |
| /open/jushuitan/order/single/confirm | 强制审核单件商品缺货订单并入库 | JstClient.wms().confirmSingleOrder() | |
| /open/webapi/wmsapi/worklog/getworklog | 查询WMS工作日志 | JstClient.wms().getWorkLog() | |
| /open/webapi/wmsapi/wavequery/loadwavesbyfilter | 拣货批次管理查询 | JstClient.wms().loadWavesByFilter() | |
| /open/webapi/wmsapi/worklog/workloadappend | 工作量补入 | JstClient.wms().appendWorkload() | |
| /open/jushuitan/pickwave/query | 机器人获取批次 | JstClient.wms().queryPickWave() | |
| /open/jushuitan/prereducewave/query | 批次预占重算 | JstClient.wms().queryPreReduceWave() | |
| /open/jushuitan/reducestock/waitpick/get | 获取正在等待拣货的预占信息 | JstClient.wms().getWaitPickReduceStock() | |
| /open/jushuitan/agv/wave/assign | 指定机器人批次 | JstClient.wms().assignAgvWave() | |
| /open/jushuitan/skusn/load | 查询快销唯一码信息 | JstClient.wms().loadSkusn() | |
| /open/jushuitan/inout/water/query | 进出仓流水 | JstClient.wms().queryInOutWater() | |
| /open/webapi/wmsapi/openp2dskusn/loadorderchangestatistics | 快销-获取订单替换商品分析 | JstClient.wms().loadOrderChangeStatistics() | |
| /open/jushuitan/skusn/query | 跟踪信息查询 | JstClient.wms().querySkusn() | |
| /open/webapi/wmsapi/openp2dskusn/createskusn | 生成快销标签 | JstClient.wms().createSkusn() |