cn.binarywang.wx.miniapp.api

接口 WxMaIntracityService

所有已知实现类:

WxMaIntracityServiceImpl

public interface WxMaIntracityService

微信小程序 物流服务 同城配送服务API
*不是*即时配送接口，两个相近，容易混淆
微信相关接口
https://developers.weixin.qq.com/miniprogram/dev/platform-capabilities/industry/express/business/intracity_service.html

方法概要

限定符和类型	方法和说明
WxMaAddOrderResponse	addOrder(WxMaAddOrderRequest order) 创建配送单
void	apply() 申请开通门店权限
WxMaStoreBalance	balanceQuery(String wxStoreId, String serviceTransId, PayMode payMode) 查询门店余额
WxMaCancelOrderResponse	cancelOrderByStoreOrderId(String wxStoreId, String storeOrderId, int cancelReasonId, String cancelReason) 依据商户订单号 查询配送单
WxMaCancelOrderResponse	cancelOrderByWxOrderId(String wxOrderId, int cancelReasonId, String cancelReason) 依据微信订单号 查询配送单
String	createStore(WxMaStore store) 创建门店
List<WxMaTransCity>	getCity(String serviceTransId) 查询支持同城配送的城市
WxMaGetPayModeResponse	getPayMode() 查询扣费主体
List<WxMaStore>	listAllStores() 查询门店（列出所有门店）
WxMaPreAddOrderResponse	preAddOrder(WxMaPreAddOrderRequest request) 查询运费
WxMaStoreFlowResponse<? extends WxMaStoreFlowResponse.BasicFlowRecord>	queryFlow(WxMaQueryFlowRequest request) 门店运费流水查询
WxMaOrder	queryOrderByStoreOrderId(String wxStoreId, String storeOrderId) 依据商户订单号 查询配送单
WxMaOrder	queryOrderByWxOrderId(String wxOrderId) 查询配送单 根据wxOrderId
List<WxMaStore>	queryStoreByOutStoreId(String outStoreId) 根据 out_store_id 查询门店
WxMaStore	queryStoreByWxStoreId(String wxStoreId) 根据wx_store_id查询门店
void	setPayMode(PayMode payMode) 设置扣费主体 接口调用成功后，小程序的管理员会收到模板消息，点击模板消息确认更改门店扣费主体后，修改生效。
String	storeCharge(WxMaStoreChargeRequest request) 门店运费充值，返回充值URL
int	storeRefund(WxMaStoreRefundRequest request) 门店运费退款，返回退款金额
void	updateStore(WxMaStore store) 更新门店；只更新store中不为null的部分 wxStoreId和outStoreId至少要有一个不为null，根据这2个来更新。

方法详细资料

apply

void apply()
    throws WxErrorException

申请开通门店权限

抛出:

WxErrorException

createStore

String createStore(WxMaStore store)
            throws WxErrorException

创建门店

抛出:

WxErrorException

updateStore

void updateStore(WxMaStore store)
          throws WxErrorException

更新门店；只更新store中不为null的部分 wxStoreId和outStoreId至少要有一个不为null，根据这2个来更新。 仅支持更新 storeName orderPattern serviceTransPrefer addressInfo几个属性

抛出:

WxErrorException

listAllStores

List<WxMaStore> listAllStores()
                       throws WxErrorException

查询门店（列出所有门店）

抛出:

WxErrorException

queryStoreByWxStoreId

WxMaStore queryStoreByWxStoreId(String wxStoreId)
                         throws WxErrorException

根据wx_store_id查询门店

抛出:

WxErrorException

queryStoreByOutStoreId

List<WxMaStore> queryStoreByOutStoreId(String outStoreId)
                                throws WxErrorException

根据 out_store_id 查询门店

抛出:

WxErrorException

storeCharge

String storeCharge(WxMaStoreChargeRequest request)
            throws WxErrorException

门店运费充值，返回充值URL

抛出:

WxErrorException

storeRefund

int storeRefund(WxMaStoreRefundRequest request)
         throws WxErrorException

门店运费退款，返回退款金额

抛出:

WxErrorException

queryFlow

WxMaStoreFlowResponse<? extends WxMaStoreFlowResponse.BasicFlowRecord> queryFlow(WxMaQueryFlowRequest request)
                                                                          throws WxErrorException

门店运费流水查询

抛出:

WxErrorException

balanceQuery

WxMaStoreBalance balanceQuery(String wxStoreId,
                              String serviceTransId,
                              PayMode payMode)
                       throws WxErrorException

查询门店余额

抛出:

WxErrorException

setPayMode

void setPayMode(PayMode payMode)
         throws WxErrorException

设置扣费主体
接口调用成功后，小程序的管理员会收到模板消息，点击模板消息确认更改门店扣费主体后，修改生效。

抛出:

WxErrorException

getPayMode

WxMaGetPayModeResponse getPayMode()
                           throws WxErrorException

查询扣费主体

抛出:

WxErrorException

preAddOrder

WxMaPreAddOrderResponse preAddOrder(WxMaPreAddOrderRequest request)
                             throws WxErrorException

查询运费

抛出:

WxErrorException

addOrder

WxMaAddOrderResponse addOrder(WxMaAddOrderRequest order)
                       throws WxErrorException

创建配送单

抛出:

WxErrorException

queryOrderByWxOrderId

WxMaOrder queryOrderByWxOrderId(String wxOrderId)
                         throws WxErrorException

查询配送单 根据wxOrderId

抛出:

WxErrorException

queryOrderByStoreOrderId

WxMaOrder queryOrderByStoreOrderId(String wxStoreId,
                                   String storeOrderId)
                            throws WxErrorException

依据商户订单号 查询配送单

抛出:

WxErrorException

cancelOrderByWxOrderId

WxMaCancelOrderResponse cancelOrderByWxOrderId(String wxOrderId,
                                               int cancelReasonId,
                                               String cancelReason)
                                        throws WxErrorException

依据微信订单号 查询配送单

抛出:

WxErrorException

cancelOrderByStoreOrderId

WxMaCancelOrderResponse cancelOrderByStoreOrderId(String wxStoreId,
                                                  String storeOrderId,
                                                  int cancelReasonId,
                                                  String cancelReason)
                                           throws WxErrorException

依据商户订单号 查询配送单

抛出:

WxErrorException

getCity

List<WxMaTransCity> getCity(String serviceTransId)
                     throws WxErrorException

查询支持同城配送的城市

参数:

serviceTransId - 运力ID，传NULL则返回所有

抛出:

WxErrorException