finance

Documentation

Overview

Package finance 资金管理相关API

Index

• type DetailGetRequest
  • func (r DetailGetRequest) Encode() string
• type DetailGetResponse
• type DetailGetResult
• type ShareExpiringDetail
• type Transaction
• type Wallet
• type WalletGetRequest
  • func (r WalletGetRequest) Encode() string
• type WalletGetResponse

Types

type DetailGetRequest

type DetailGetRequest struct {
	// AdvertiserID 千川广告主/代理商账户id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// StartDate 开始时间，格式 2021-04-05，默认值为end_date-14
	StartDate string `json:"start_date,omitempty"`
	// EndDate 结束时间，格式 2021-04-05，默认值为当天
	EndDate string `json:"end_date,omitempty"`
	// Type 资金池类型，允许值：
	// ALL 全部（默认值）
	// DEFAULT 通用
	// BRAND 品牌
	Type qianchuan.ViewDeliveryType `json:"type,omitempty"`
	// Page 页码，默认值: 1
	// 注意：page*page_size不可大于10000
	Page int `json:"page,omitempty"`
	// PageSize 页面数据量，默认值: 10 ，上限：200
	PageSize int `json:"page_size,omitempty"`
}

DetailGetRequest 获取财务流水信息 API Request

func (DetailGetRequest) Encode

func (r DetailGetRequest) Encode() string

Encode implement GetRequest interface

type DetailGetResponse

type DetailGetResponse struct {
	model.BaseResponse
	// Date 返回数据，单位为千分之一分，即174938000.00=1749.38000元
	Data *DetailGetResult `json:"data,omitempty"`
}

DetailGetResponse 获取财务流水信息 API Response

type DetailGetResult

type DetailGetResult struct {
	PageInfo *model.PageInfo `json:"page_info,omitempty"`
	List     []Transaction   `json:"list,omitempty"`
}

type ShareExpiringDetail

type ShareExpiringDetail struct {
	// Category 类别，允许值：
	// CONFIRM 站内信息流及其他
	// DEFAULT 通用
	// SEARCH 站内搜索
	// UNION 网盟穿山甲
	Category string `json:"category,omitempty"`
	// Amount 金额
	Amount float64 `json:"amount,omitempty"`
	// ExpireTime 到期时间
	ExpireTime int64 `json:"expire_time,omitempty"`
}

ShareExpiringDetail 共享赠款余额到期详情

type Transaction

type Transaction struct {
	// Date 日期，格式 2021-04-05
	Date string `json:"date,omitempty"`
	// ViewDeliveryType 资金池类型，枚举值：
	// ALL 全部（默认值）
	// DEFAULT 通用
	// BRAND 品牌
	ViewDeliveryType qianchuan.ViewDeliveryType `json:"view_delivery_type,omitempty"`
	// DeductionCost 消返红包消耗
	DeductionCost float64 `json:"deduction_cost,omitempty"`
	// Cost 账户余额总消耗，不包括消返红包消耗和共享赠款消耗
	Cost float64 `json:"cost,omitempty"`
	// ShareCost 共享赠款消耗
	ShareCost float64 `json:"share_cost,omitempty"`
	// CashCost 非赠款消耗
	CashCost float64 `json:"cash_cost,omitempty"`
	// GrantCost 赠款消耗
	GrantCost float64 `json:"grant_cost,omitempty"`
	// Income 总存入
	Income float64 `json:"income,omitempty"`
	// TransferIn 总转入
	TransferIn float64 `json:"transfer_in,omitempty"`
	// TransferOut 总转出
	TransferOut float64 `json:"transfer_out,omitempty"`
	// CashBalance 非赠款余额
	CashBalance float64 `json:"cash_balance,omitempty"`
	// GrantBalance 赠款余额
	GrantBalance float64 `json:"grant_balance,omitempty"`
	// TotalBalance 总余额
	TotalBalance float64 `json:"total_balance,omitempty"`
	// QcAwemeCost 随心推消耗
	QcAwemeCost float64 `json:"qc_aweme_cost,omitempty"`
	// QcAwemeCashCost 随心推余额消耗
	QcAwemeCashCost float64 `json:"qc_aweme_cash_cost,omitempty"`
	// QcAwemeGrantCost 随心推赠款消耗
	QcAwemeGrantCost float64 `json:"qc_aweme_grant_cost,omitempty"`
}

Transaction 财务流水

type Wallet

type Wallet struct {
	// TotalBalanceAbs 账户总余额
	TotalBalanceAbs float64 `json:"total_balance_abs,omitempty"`
	// GrantBalance 赠款余额
	GrantBalance float64 `json:"grant_balance,omitempty"`
	// UnionValidGrantBalance 赠款余额-穿山甲-可用
	UnionValidGrantBalance float64 `json:"union_valid_grant_balance,omitempty"`
	// SearchValidGrantBalance 赠款余额-巨量搜索广告-可用
	SearchValidGrantBalance float64 `json:"search_valid_grant_balance,omitempty"`
	// CommonValidGrantBalance 赠款余额-巨量信息流广告-可用
	CommonValidGrantBalance float64 `json:"common_valid_grant_balance,omitempty"`
	// DefaultValidGrantBalance 赠款余额-通用-可用
	DefaultValidGrantBalance float64 `json:"default_valid_grant_balance,omitempty"`
	// GeneralTotalBalance 通用余额
	GeneralTotalBalance float64 `json:"general_total_balance,omitempty"`
	// GeneralBalanceValid 通用余额-可用余额
	GeneralBalanceValid float64 `json:"general_balance_valid,omitempty"`
	// GeneralBalanceValidNoGrant 通用余额-可用余额-非赠款
	GeneralBalanceValidNoGrant float64 `json:"general_balance_valid_no_grant,omitempty"`
	// GeneralBalanceValidGrantUnion 通用余额-可用余额-赠款-穿山甲
	GeneralBalanceValidGrantUnion float64 `json:"general_balance_valid_grant_union,omitempty"`
	// GeneralBalanceValidGrantSearch 通用余额-可用余额-赠款-巨量搜索广告
	GeneralBalanceValidGrantSearch float64 `json:"general_balance_valid_grant_search,omitempty"`
	// GeneralBalanceValidGrantCommon 通用余额-可用余额-赠款-巨量信息流广告
	GeneralBalanceValidGrantCommon float64 `json:"general_balance_valid_grant_common,omitempty"`
	// GeneralBalanceValidGrantDefault 通用余额-可用余额-赠款-通用
	GeneralBalanceValidGrantDefault float64 `json:"general_balance_valid_grant_default,omitempty"`
	// GeneralBalanceInvalid 通用余额-不可用余额
	GeneralBalanceInvalid float64 `json:"general_balance_invalid,omitempty"`
	// GeneralBalanceInvalidOrder 通用余额-不可用余额-随心推已下单
	GeneralBalanceInvalidOrder float64 `json:"general_balance_invalid_order,omitempty"`
	// GeneralBalanceInvalidFrozen 通用余额-不可用余额-冻结
	GeneralBalanceInvalidFrozen float64 `json:"general_balance_invalid_frozen,omitempty"`
	// BrandBalance 品牌余额
	BrandBalance float64 `json:"brand_balance,omitempty"`
	// BrandBalanceValid 品牌余额-可用
	BrandBalanceValid float64 `json:"brand_balance_valid,omitempty"`
	// BrandBalanceValidNoGrant 品牌余额-可用-非赠款
	BrandBalanceValidNoGrant float64 `json:"brand_balance_valid_no_grant,omitempty"`
	// BrandBalanceValidGrant 品牌余额-可用余额-赠款
	BrandBalanceValidGrant float64 `json:"brand_balance_valid_grant,omitempty"`
	// BrandBalanceInvalid 品牌余额-不可用余额
	BrandBalanceInvalid float64 `json:"brand_balance_invalid,omitempty"`
	// BrandBalanceInvalidFrozen 品牌余额-不可用余额-冻结
	BrandBalanceInvalidFrozen float64 `json:"brand_balance_invalid_frozen,omitempty"`
	// DeductionCouponBalance 消返红包余额
	DeductionCouponBalance float64 `json:"deduction_coupon_balance,omitempty"`
	// DeductionCouponBalanceAll 消返红包余额（通用）
	DeductionCouponBalanceAll float64 `json:"deduction_coupon_balance_all,omitempty"`
	// DeductionCouponBalanceOther 消返红包余额（代投）
	DeductionCouponBalanceOther float64 `json:"deduction_coupon_balance_other,omitempty"`
	// DeductionCouponBalanceSelf 消返红包余额（自投）
	DeductionCouponBalanceSelf float64 `json:"deduction_coupon_balance_self,omitempty"`
	// GrantExpiring 15天内赠款到期金额
	GrantExpiring float64 `json:"grant_expiring,omitempty"`
	// ShareBalance 共享赠款余额
	ShareBalance float64 `json:"share_balance,omitempty"`
	// ShareBalanceValidGrantUnion 共享赠款余额-可用余额-赠款-穿山甲
	ShareBalanceValidGrantUnion float64 `json:"share_balance_valid_grant_union,omitempty"`
	// ShareBalanceValidGrantSearch 共享赠款余额-可用余额-赠款-巨量搜索广告
	ShareBalanceValidGrantSearch float64 `json:"share_balance_valid_grant_search,omitempty"`
	// ShareBalanceValidGrantCommon 共享赠款余额-可用余额-赠款-巨量信息流广告
	ShareBalanceValidGrantCommon float64 `json:"share_balance_valid_grant_common,omitempty"`
	// ShareBalanceValidGrantDefault 共享赠款余额-可用余额-赠款-通用
	ShareBalanceValidGrantDefault float64 `json:"share_balance_valid_grant_default,omitempty"`
	// ShareBalanceValid 共享赠款余额-可用余额
	ShareBalanceValid float64 `json:"share_balance_valid,omitempty"`
	// ShareBalanceExpiring 共享赠款余额-30天内到期余额
	ShareBalanceExpiring float64 `json:"share_balance_expiring,omitempty"`
	// ShareExpiringDetailList 共享赠款余额到期详情
	ShareExpiringDetailList *ShareExpiringDetail `json:"share_expiring_detail_list,omitempty"`
}

Wallet 账户钱包信息

type WalletGetRequest

type WalletGetRequest struct {
	// AdvertiserID 千川广告主/代理商账户id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
}

WalletGetRequest 获取账户钱包信息 API Request

func (WalletGetRequest) Encode

func (r WalletGetRequest) Encode() string

Encode implement GetRequest interface

type WalletGetResponse

type WalletGetResponse struct {
	model.BaseResponse
	// Data 返回数据，单位为千分之一分，即174938000.00=1749.38000元
	Data *Wallet `json:"data,omitempty"`
}

WalletGetResponse 获取账户钱包信息 API Response