查询开票金额信息
订单应开票金额计算, 本接口为批量接口,一次最多可查100个订单的开票金额 。
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/taobao/order/invoice/amount/get
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
sign | String | 接口签名 | 如何计算生成见示例代码 |
tids | String | 必填, 订单号,如果是多个订单,用英文逗号隔开,最多传入100个订单号 | |
sysid | String | 可空, 代表不同的应用,具体请咨询客服 |
2. 请求示例代码(Java)
@Test
public void getTradeInvoiceAmount() throws Exception {
String tb_seller_nick = Config.TBSellerNick ; //淘宝商家
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("tb_seller_nick", tb_seller_nick);
// data.put("sysid", ""); 传什么参数请咨询客服
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
// 多个订单用英文逗号隔开
data.put("tids", "1887215151362838239,1887963157835558129");
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoOrderInvoiceAmountBatchUrl ,data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": [{
"tid": "1887215151362838239", // 入参时的订单号
"code": 0,
"message": "success",
"consumer_invoice_amount": "1990", //应开票给消费者的金额,单位分
"platform_invoice_amount": "200" //应开票给平台的金额,单位分
}, {
"tid": "1887963157835558129", // 入参时的订单号
"code": 0,
"message": "success",
"consumer_invoice_amount": "1890", //应开票给消费者的金额,单位分
"platform_invoice_amount": "100" //应开票给平台的金额,单位分
}]
}
说明: 外层code为0表示成功,非0为失败,message会包含失败原因。 data字段为返回的订单集合,包含对应各个订单的开票信息。 注意:获取失败的订单也将加入返回集合,内层的code为0表示获取订单开票是否成功,0为成功。
文档更新时间: 2023-10-18 12:26 作者:admin