文档中心 > API类目 > 本地生活商户基础API

alibaba.alsc.merchant.ext.ticketcode.send (异步发码)

外部券异步发码

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
send_request ExternalTicketSendRequest 必须 外部券异步发码
  • └ order_no
  • String
  • 必须
  • 20180404111040030100130500594477
  • 口碑子订单号, 即alsc_sub_order_no
  • └ ticket_request_id
  • String
  • 可选
  • 20161029032144700000000001467823
  • 请求id,唯一标识一次请求
  • └ valid_start
  • Date
  • 可选
  • 2017-09-09 12:12:12
  • 券生效时间,默认为口碑商品配置生效时间
  • └ valid_end
  • Date
  • 可选
  • 2017-09-10 12:12:12
  • 券过期时间,默认为口碑商品配置失效时间
  • └ send_token
  • String
  • 必须
  • eed3206686d349d2a22c3d9ada35c0f8
  • 口碑发码通知透传码商,码商需要跟发码通知获取到的参数一致
  • external_ticket_codes
  • ExternalTicketCode []
  • 必须
  • []
  • 需要发送的码列表,其中code表示串码码值,num表示码的可核销份数
  • └ num
  • String
  • 必须
  • 2
  • 码的可核销份数
  • └ code
  • String
  • 可选
  • GAL358309629
  • 凭证码值,必填。核销二维码生成规则:优先用url生成,url为空,再用code生成。
  • └ ticket_id
  • String
  • 可选
  • xxxxx
  • 本地生活凭证id(奇门发码通知中的ticketId),必填
  • └ url
  • String
  • 可选
  • url
  • 支持核销的三方url。核销二维码生成规则:优先用url生成,url为空,再用code生成。
  • └ send_order_no
  • String
  • 必须
  • 20170428001640010400000000006800
  • 口碑商品发货单号
  • └ deliver_code_success
  • String
  • 必须
  • success
  • 三方异步发码是否成功,值为success 代表发码成功,external_ticket_codes 不能为空,fail代表三方发码失败,本地侧凭证发放状态推进到发码失败

响应参数

名称 类型 示例值 描述
ticket_request_id String 20161029032144700000000001467823 请求id
biz_code String BIZ_ALREADY_SUCCESS 该字段用于描述本次返回中的业务属性,现有:BIZ_ALREADY_SUCCESS(幂等业务码)。

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlscMerchantExtTicketcodeSendRequest req = new AlibabaAlscMerchantExtTicketcodeSendRequest();
AlibabaAlscMerchantExtTicketcodeSendRequest.ExternalTicketSendRequest obj1 = new AlibabaAlscMerchantExtTicketcodeSendRequest.ExternalTicketSendRequest();
obj1.setOrderNo("20180404111040030100130500594477");
obj1.setTicketRequestId("20161029032144700000000001467823");
obj1.setValidStart(StringUtils.parseDateTime("2017-09-09 12:12:12"));
obj1.setValidEnd(StringUtils.parseDateTime("2017-09-10 12:12:12"));
obj1.setSendToken("eed3206686d349d2a22c3d9ada35c0f8");
List<AlibabaAlscMerchantExtTicketcodeSendRequest.ExternalTicketCode> list3 = new ArrayList<AlibabaAlscMerchantExtTicketcodeSendRequest.ExternalTicketCode>();
AlibabaAlscMerchantExtTicketcodeSendRequest.ExternalTicketCode obj4 = new AlibabaAlscMerchantExtTicketcodeSendRequest.ExternalTicketCode();
list3.add(obj4);
obj4.setNum("2");
obj4.setCode("GAL358309629");
obj4.setTicketId("xxxxx");
obj4.setUrl("url");
obj1.setExternalTicketCodes(list3);
obj1.setSendOrderNo("20170428001640010400000000006800");
obj1.setDeliverCodeSuccess("success");
req.setSendRequest(obj1);
AlibabaAlscMerchantExtTicketcodeSendResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alsc_merchant_ext_ticketcode_send_response>
    <ticket_request_id>20161029032144700000000001467823</ticket_request_id>
    <biz_code>BIZ_ALREADY_SUCCESS</biz_code>
</alibaba_alsc_merchant_ext_ticketcode_send_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部