增加文档

2026-07-08 12:33:15 +08:00
parent 588cf5f596
commit 102330d7af
2 changed files with 105 additions and 0 deletions
@@ -0,0 +1,105 @@
+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<SendCallbackETicket>	是	[{}]	电子凭证列表
+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，店铺管理-短信营销，店铺管理-订单管理，店铺管理-评价管理，店铺管理-财务管理，店铺管理-质检品控，快分销，快手微应用-货源工具，快赚客应用，直播服务-直播工具，直播服务-直播间装修，营销管理-主图水印，营销管理-促销工具，营销管理-分销管理，营销管理-劵码发卡，营销管理-吸粉引流，营销管理-快分销工具，营销管理-折扣管理，营销管理-直播营销工具，装修市场-设计工具，视频摄影-视频工具