5.3 KiB
integration.callback.virtual.eticket.send 需商家授权 POST 电子凭证发货回调接口 更新时间: 2023-07-13 16:13:24 电子凭证发货回调接口 系统环境 环境 域名 线上环境（推荐） https://openapi.kwaixiaodian.com 线上环境（备用） https://open.kwaixiaodian.com 系统参数 参数名 类型 必须 详情描述 appkey String 是 平台分配的appId timestamp Number 是 发起请求的Unix时间戳，单位为毫秒 access_token String 是 访问token，所有需用户授权API使用code模式获取，不需要用户授权API使用client_credentials获取，详情参考《授权说明》文档 version Number 是 请求的API版本号，目前版本为1 param JSON 是 业务参数，详见下方的请求入参 method String 是 请求的API英文名，详见各API定义 sign String 是 API入参的签名结果参数 signMethod String 是 签名算法，支持HMAC_SHA256和MD5，推荐使用HMAC_SHA256 请求参数 参数名 类型 必须 示例值 详情描述 oid String 是 2319400000320094 快手订单号 sendType String 是 虚拟卡-virtual 实体卡-delivery 发卡类型： 虚拟卡-virtual 实体卡-delivery（大闸蟹专用） etickets List 是 [{}] 电子凭证列表 sendNum Integer 是 10 已发货数量，必须等于etickets列表的num之和 totalGoodsValue Long 是 10 货品总价值，必须等于etickets列表的goodsValue之和 token String 是 47e70415-c799-40e7-b581-aa71fa9e7ba8 鉴权Token，订单操作维度 ext String 否 {"key":"value"} 扩展信息(JSON格式) eticketType String 否 DINING_OPEN_TICKET/DEFAULT_MEDICAL_TICKET 电子凭证类型，跟商家想要入驻的类目相关联，非必传，默认 DINING_OPEN_TICKET expressCode String 否 EMS 实体卡物流公司 expressNo String 否 123214 实体卡物流单号 返回参数 参数名 类型 示例值 详情描述 code String 1 主返回码 msg String success 主返回信息 sub_code String 1 子返回码 sub_msg String success 子返回信息 result Integer 1 1-成功；其他-失败 error_msg String success 错误信息 错误码 错误码 错误类型 错误描述 解决方法 暂无数据 请求示例 JAVA CURL package com.kuaishou.merchant.open.api.sdk.demo; import com.kuaishou.merchant.open.api.common.utils.GsonUtils; import com.kuaishou.merchant.open.api.request.virtual.IntegrationCallbackVirtualEticketSendRequest; import com.kuaishou.merchant.open.api.response.virtual.IntegrationCallbackVirtualEticketSendResponse; import com.kuaishou.merchant.open.api.client.AccessTokenKsMerchantClient;
public class AccessTokenKsMerchantClientDemo {
public static void main(String[] args) {
String url = "https://openapi.kwaixiaodian.com";
String appKey = "your appKey";
String signSecret = "your app signSecret";
String accessToken = "your accessToken";
AccessTokenKsMerchantClient client = new AccessTokenKsMerchantClient(url,appKey,signSecret);
IntegrationCallbackVirtualEticketSendRequest request = new IntegrationCallbackVirtualEticketSendRequest();
request.setAccessToken(accessToken);
request.setApiMethodVersion(1L);
request.setOid("2319400000320094");
request.setSendType("虚拟卡-virtual\n实体卡-delivery");
List<SendCallbackETicket> list1 = new ArrayList<>();
SendCallbackETicket obj1 = new SendCallbackETicket();
obj1.setId("KFC001");
obj1.setEticketSecretKey("WPUYEXSCS");
obj1.setCode("kfc0000-1");
obj1.setNum(1);
obj1.setValidStartTime(1653428402000);
obj1.setValidEndTime(1653468402000);
obj1.setGoodsValue(1);
list1.add(obj1);
request.setEtickets(list1);
request.setSendNum(10);
request.setTotalGoodsValue(10);
request.setToken("47e70415-c799-40e7-b581-aa71fa9e7ba8");
request.setExt("{\"key\":\"value\"}");
request.setEticketType("DINING_OPEN_TICKET/DEFAULT_MEDICAL_TICKET");
request.setExpressCode("EMS");
request.setExpressNo("123214");
IntegrationCallbackVirtualEticketSendResponse response = client.execute(request);
System.out.println(GsonUtils.toJSON(response));
}
}
响应示例 JSON { "result": 1, "error_msg": "success" } 权限说明 拥有此API的权限组 权限组描述 可获得/可申请此权限组的应用类型 merchant_order 电商订单信息权限 商品管理-分销铺货，商家后台，客服管理-客服应用，客服管理-客服绩效，客服管理-客服质检，客服管理-智能客服，平台对接应用，店铺服务-供货管理，店铺服务-广告投放，店铺服务-电子发票服务，店铺管理-WMS系统，店铺管理-厂商代发，店铺管理-售后管理，店铺管理-商品管理，店铺管理-客户管理，店铺管理-打单发货，店铺管理-数据分析，店铺管理-电商ERP，店铺管理-短信营销，店铺管理-订单管理，店铺管理-评价管理，店铺管理-财务管理，店铺管理-质检品控，快分销，快手微应用-货源工具，快赚客应用，直播服务-直播工具，直播服务-直播间装修，营销管理-主图水印，营销管理-促销工具，营销管理-分销管理，营销管理-劵码发卡，营销管理-吸粉引流，营销管理-快分销工具，营销管理-折扣管理，营销管理-直播营销工具，装修市场-设计工具，视频摄影-视频工具