diff --git a/docs/行业电子凭证/1.快手通知商家发码.md b/docs/行业电子凭证/1.1快手通知商家发码.md similarity index 100% rename from docs/行业电子凭证/1.快手通知商家发码.md rename to docs/行业电子凭证/1.1快手通知商家发码.md diff --git a/docs/行业电子凭证/1.2电子凭证发货回调接口.md b/docs/行业电子凭证/1.2电子凭证发货回调接口.md new file mode 100644 index 00000000..0af5531d --- /dev/null +++ b/docs/行业电子凭证/1.2电子凭证发货回调接口.md @@ -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 是 [{}] 电子凭证列表 +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 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,店铺管理-短信营销,店铺管理-订单管理,店铺管理-评价管理,店铺管理-财务管理,店铺管理-质检品控,快分销,快手微应用-货源工具,快赚客应用,直播服务-直播工具,直播服务-直播间装修,营销管理-主图水印,营销管理-促销工具,营销管理-分销管理,营销管理-劵码发卡,营销管理-吸粉引流,营销管理-快分销工具,营销管理-折扣管理,营销管理-直播营销工具,装修市场-设计工具,视频摄影-视频工具