跳转到内容
返回官网

抖店资金流水明细接口(境内)

资金流水明细接口(境内)查询资金流水明细,查询方式为时间轮训方式,数据T+1生成,建议第二天15点之后查询。如因任务积压导致延迟的情况,建议重试。

版本描述: 新增以旧换新补贴追缴用户退回平台,以旧换新商户红包补贴发放,以旧换新商户红包补贴退回动账场景

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/dd/order/getShopAccountItem

公共参数

参数名称参数类型是否必须示例值参数描述
appidString合作伙伴AppId
timestampString1657525936当前Unix时间戳,秒
seller_nickStringoms38173182抖店的账号,对应蜂巢授权返回doudianseller字段
signString

业务参数

参数名称参数类型是否必须示例值参数描述
start_timeString2021-10-01 00:00:00开始时间
end_timeString2021-10-01 23:59:59结束时间
order_idString4847151209529677080订单号(如果订单号未传,则时间必须传)
sizeNumber100查询数量
account_typeNumber0动账账户 0: 所有 1: 微信 2:支付宝 3:合众支付 4:聚合支付
biz_typeNumber0计费类型 0:全部 1:鲁班广告 2:精选联盟 3:值点商城 4:小店自卖 5:橙子建站 6:POI 7:抖+ 8:穿山甲 9:服务市场 10:服务市场外包客服 11:学浪
time_typeNumber0时间类型 0 动账时间 1 下单时间
start_indexStringd746da31eee45e65d07b20f87d6844bbf72041350acc66af1711408070b62428开始下标 请求值为上一次响应参数的next_index,第一次请求不传
product_idString33323233产品id

二、请求示例代码

Java

@Test
public void DDGetShopAccountItemRequest() throws Exception {
Map<String, Object> data = new HashMap<String, Object>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("seller_nick", Config.DDSellerNick);
data.put("start_time", "2024-06-01 00:00:00");
data.put("end_time", "2024-06-06 00:00:00");
data.put("size", "50");
data.put("sign", Sign(data,Config.AppSecret));
// 调用服务API
String resp = doHttpRequest(Config.DDGetShopAccountItemUrl, data);
System.out.println(resp);
}
}

三、返回结果

{
"code": 0,
"message": "ok",
"data": {
"code": "100000",
"code_msg": "SUCCESS",
"data": [
{
"account_amount": 1,
"account_bill_desc": "订单结算",
"account_bill_desc_tag": 3,
"account_trade_no": "2024060111215809733742435497",
"account_type": 4,
"account_type_desc": "聚合账户",
"actual_zr_pay_promotion": 0,
"actual_zt_pay_promotion": 0,
"after_sale_service_no": "SS73716358276199101830124",
"author_coupon_subsidy": 0,
"bank_pay_promotion_amount": 0,
"bill_time": "2024-06-01 11:22:05",
"biz_type": 4,
"biz_type_desc": "小店自卖",
"business_order_create_time": "2024-04-30 09:50:57",
"channel_fee": 0,
"channel_promotion_fee": 0,
"colonel_service_fee": 0,
"commission": 0,
"free_commission_flag": "",
"fund_flow": 0,
"fund_flow_desc": "入账",
"order_id": "6929324550160192580",
"order_type": 0,
"order_type_desc": "普通订单",
"other_sharing_amount": 0,
"partner_commission": 0,
"pay_amount": 1,
"platform_service_fee": 0,
"post_amount": 0,
"post_promotion_amount": 0,
"product_id": "3631673195792310979",
"promotion_amount": 0,
"real_free_commission_amount": 0,
"recycler_amount": 0,
"refund_amount": 0,
"remark": "",
"shop_id": "4463798",
"shop_order_id": "6929324550160127044",
"trans_scene": "货款结算入账",
"trans_scene_tag": 30
},
{
"account_amount": 1,
"account_bill_desc": "订单结算",
"account_bill_desc_tag": 3,
"account_trade_no": "2024060111215728733283845497",
"account_type": 4,
"account_type_desc": "聚合账户",
"actual_zr_pay_promotion": 0,
"actual_zt_pay_promotion": 0,
"after_sale_service_no": "SS73716608816854676980017",
"author_coupon_subsidy": 0,
"bank_pay_promotion_amount": 0,
"bill_time": "2024-06-01 11:22:05",
"biz_type": 4,
"biz_type_desc": "小店自卖",
"business_order_create_time": "2024-04-30 11:27:51",
"channel_fee": 0,
"channel_promotion_fee": 0,
"colonel_service_fee": 0,
"commission": 0,
"free_commission_flag": "",
"fund_flow": 0,
"fund_flow_desc": "入账",
"order_id": "6929337635426931780",
"order_type": 0,
"order_type_desc": "普通订单",
"other_sharing_amount": 0,
"partner_commission": 0,
"pay_amount": 1,
"platform_service_fee": 0,
"post_amount": 0,
"post_promotion_amount": 0,
"product_id": "3631673195792310979",
"promotion_amount": 0,
"real_free_commission_amount": 0,
"recycler_amount": 0,
"refund_amount": 0,
"remark": "",
"shop_id": "4463798",
"shop_order_id": "6929337635426866244",
"trans_scene": "货款结算入账",
"trans_scene_tag": 30
}
],
"data_size": 2,
"is_end": 0,
"next_start_index": "432456478",
"next_start_time": "2024-06-01 11:22:05",
"size": 2
}
}

四、返回参数说明

说明: 外层code为0表示接口级成功,非0为失败,message会包含失败原因。 业务上的成功与否请判断内层的code 100000为成功,其他为失败。

参数名称参数类型示例值参数描述
codeString10000返回code 100000为成功,其他为失败
code_msgStringSUCCESS返回描述
- dataList-资金流水明细,见子 json对象
next_start_indexStringd746da31eee45e65d07b2下一次请求参数start_index 的值
next_start_timeString2021-10-01 06:00:00下一次请求参数start_time的值
sizeNumber100查询数量,请求参数size传了值得话为请求参数传的值,未传的话,值为100
data_sizeNumber100返回结果data的数量
is_endNumber1判断查询是否结束。0 未结束, 1 结束。未结束时,需要把next_start_index作为下一次请求的start_index,next_start_time作为下一次请求的start_time。

上述表data的字段说明如下:

参数名称参数类型示例值参数描述
bill_timeString2021-10-01 10:10:11动账时间
fund_flowNumber1动账方向 0:入账 1:出账
fund_flow_descString出账动账方向描述 出账、入账
account_amountNumber96动账金额(分)
account_bill_descString订单结算动账摘要
account_bill_desc_tagNumber3动账摘要 0:其他 1:达人带货佣金 2:达人佣金退款 3:订单结算 4:部分结算 5:运费单结算 6:服务费返还 7:平台补贴扣回 8:退款失败退票 9:结算重复扣款调账 10:保证金退款 11:提现 12:提现退票 13:极速退款分账 14:小额打款(原因:补差价) 15:小额打款(原因:其他) 16:小额打款(原因:商品补偿) 17:小额打款(原因:运费补偿) 18:小额打款退票 19:已退款 20:运费险扣减货款 21:支付BIC服务费 22:BIC服务费退票 23: 原路退
biz_typeNumber1计费类型 0:全部 1:鲁班广告 2:精选联盟 3:值点商城 4:小店自卖 5:橙子建站 6:POI 7:抖+ 8:穿山甲 9:服务市场 10:服务市场外包客服 11:学浪
biz_type_descString鲁班广告计费类型描述
order_idString4847151209529677080订单号
shop_order_idString4847151209529677080店铺单号
after_sale_service_noStringSS7015036721667375372【商家无需使用】售后编号非售后接口的售后单id;该字段为账单售后编号id;
business_order_create_timeString2021-09-26 20:46:16下单时间
product_idString3494738440426276563商品ID
pay_amountNumber100订单实付应结,单位:分;只包含用户实际支付的金额,不含各类补贴(如:平台补贴、达人补贴、支付补贴等)
promotion_amountNumber0实际平台补贴(分)
refund_amountNumber0订单退款(分)
platform_service_feeNumber-3平台服务费(分)
commissionNumber-1佣金(分)
channel_feeNumber0渠道分成(分)
colonel_service_feeNumber0招商服务费(分)
account_typeNumber1动账账户 1: 微信 2:支付宝 3:合众支付 4:聚合支付
account_type_descString微信动账账户
author_coupon_subsidyNumber0实际达人补贴(分)
post_amountNumber0运费(分)
account_trade_noStringAS202110050707321602785799467_IN动账流水号(唯一)
order_typeNumber0订单类型 0:普通订单 1:定金(已退款) 2:定金(尾款已支付) 3:定金(尾款未支付) 4:尾款(尾款已支付) 5:尾款(已退款)
order_type_descString普通订单订单类型描述
actual_zt_pay_promotionNumber0实际抖音支付补贴(分)
actual_zr_pay_promotionNumber0实际DOU分期营销补贴(分)
channel_promotion_feeNumber0直播间站外推广(分)
other_sharing_amountNumber0其他分成金额(分)
remarkString备注
shop_idString12344店铺id
trans_sceneString消费者赔付动账场景
trans_scene_tagNumber1动账场景 0:其他 1:消费者赔付 2:小额打款 3:判罚扣款 4:物流赔付 5:充值保证金 6:权益保险 7:欠票扣款-商家开票 8:公益捐款 9:上门取件运费 10:供应链QIC费用 11:抖音支付与商家联合补贴营销活动 12:抖音月付与商家联合补贴营销活动 13:抖音月付与商家联合贴息活动 14:放心借·贷款还款 15:人工调账 16:提前收款 17:充值千川广告费 18:营销费用-评价有礼 19:年框返点 20:抖店货款充值云仓服务账户 21:供应链平台代发费用 22:退款-结算后退款-退用户 23:退款-订单退款触发-退补贴 24:退款-价保补差退回 25:退款-退转付扣减商家货款 26:退款-极速退二阶段商家资金回补 27:退款-商家赔付扣减商家货款 28:退款-极速退二次售后-退用户 29:上门取件平台分佣 30:货款结算入账 31:货款完结分账-执照注销场景 32:保证金垫付退款结算分账 33:福袋业务结算入账 34:退款-订单退款触发-分账 35:退款-订单退款触发-退分账 36:退款-价保补差 37:退款-退款失败资金退回 38:退款-赔付失败资金退回 39:上门取件结算入账 40:上门取件保司理赔金 41:上门取件平台激励金 42:上门取件平台改派补贴 43:佣金入账 44:提现 45:提现退票 46:买贵赔-平台转账 47:买贵赔-退回平台 48:以旧换新补贴追缴用户退回平台 49:以旧换新商户红包补贴发放 50:以旧换新商户红包补贴退回
free_commission_flagString是否免佣, 枚举值为”是/否”或为空
real_free_commission_amountNumber0免佣金额(分)
bank_pay_promotion_amountNumber0银行补贴(分)
recycler_amountNumber0以旧换新抵扣(分)
post_promotion_amountNumber0平台补贴运费(分)
partner_commissionNumber0服务商佣金(分)