yml2213
d762b33f54
将 000064-000078 合并为 064/065/066，默认规则改为收号 35%、卖出 40%、服务费 25%。 货架调价改为增加分站 1 元兑换哈夫币比例。sql-guard 仅保护 main 已发布迁移。
261 lines
8.4 KiB
Go
261 lines
8.4 KiB
Go
package distribution
|
|
|
|
import (
|
|
"errors"
|
|
"math"
|
|
)
|
|
|
|
const (
|
|
ModeTwoPartyDistributorReceive = "two_party_distributor_receive"
|
|
ModeTwoPartyPlatformReceive = "two_party_platform_receive"
|
|
ModeThreeParty = "three_party"
|
|
// ModeSiteSelfSell 是分站卖本站货，不复用两方默认规则。
|
|
ModeSiteSelfSell = "site_self_sell"
|
|
|
|
PartyTypeSite = "site"
|
|
PartyTypePlatform = "platform"
|
|
|
|
ServiceFeeUnitPercent = "percent"
|
|
ServiceFeeUnitFixedAmount = "fixed_amount"
|
|
ServiceFeeUnitRatio = "ratio"
|
|
|
|
DefaultReceivePercent = 35.0
|
|
DefaultSellPercent = 40.0
|
|
DefaultServicePercent = 25.0
|
|
)
|
|
|
|
var (
|
|
ErrInvalidAmount = errors.New("invalid distribution amount")
|
|
ErrInvalidRate = errors.New("invalid distribution rate")
|
|
ErrInvalidServiceUnit = errors.New("invalid service fee unit")
|
|
ErrUnsupportedMode = errors.New("unsupported distribution mode")
|
|
)
|
|
|
|
// Rule 是后台可编辑的分账规则。比例字段存百分数（35/40/25），按参与方角色命名。
|
|
type Rule struct {
|
|
Mode string
|
|
PlatformReceiveRatio float64
|
|
PlatformSellRatio float64
|
|
DistributorReceiveRatio float64
|
|
DistributorSellRatio float64
|
|
DistributorARatio float64
|
|
DistributorBRatio float64
|
|
ServiceFeeValue float64
|
|
ServiceFeeUnit string
|
|
PaymentFeeBPS int64
|
|
TaxEnabled bool
|
|
TaxRateBPS int64
|
|
}
|
|
|
|
// SettlementInput 使用支付单和退款单的整数分快照计算分销费用。
|
|
type SettlementInput struct {
|
|
GrossPaidAmountCent int64
|
|
RefundAmountCent int64
|
|
OwnerRentAmountCent int64
|
|
MarkupAmountCent int64
|
|
GrossProfitByParty []PartyProfitInput
|
|
}
|
|
|
|
type PartyProfitInput struct {
|
|
PartyRole string
|
|
IncomeAmountCent int64
|
|
CostAmountCent int64
|
|
}
|
|
|
|
type PartyTaxResult struct {
|
|
PartyRole string `json:"party_role"`
|
|
GrossProfitCent int64 `json:"gross_profit_cent"`
|
|
TaxAmountCent int64 `json:"tax_amount_cent"`
|
|
}
|
|
|
|
type SettlementResult struct {
|
|
GrossPaidAmountCent int64
|
|
RefundAmountCent int64
|
|
NetPaidAmountCent int64
|
|
PaymentFeeCent int64
|
|
ServiceFeeCent int64
|
|
MarkupAmountCent int64
|
|
SplitBaseAmountCent int64
|
|
TaxAmountCent int64
|
|
TaxByParty []PartyTaxResult
|
|
}
|
|
|
|
// DefaultRule 返回已确认的默认百分比：收号 35%、卖出 40%、服务费 25%。
|
|
func DefaultRule(mode string) (Rule, error) {
|
|
base := Rule{
|
|
Mode: mode, ServiceFeeValue: DefaultServicePercent, ServiceFeeUnit: ServiceFeeUnitPercent,
|
|
PaymentFeeBPS: 50, TaxEnabled: false, TaxRateBPS: 100,
|
|
}
|
|
switch mode {
|
|
case ModeTwoPartyDistributorReceive:
|
|
base.DistributorReceiveRatio = DefaultReceivePercent
|
|
base.PlatformSellRatio = DefaultSellPercent
|
|
case ModeTwoPartyPlatformReceive:
|
|
base.PlatformReceiveRatio = DefaultReceivePercent
|
|
base.DistributorSellRatio = DefaultSellPercent
|
|
case ModeThreeParty:
|
|
base.DistributorARatio = DefaultReceivePercent
|
|
base.DistributorBRatio = DefaultSellPercent
|
|
case ModeSiteSelfSell:
|
|
return Rule{}, ErrUnsupportedMode
|
|
default:
|
|
return Rule{}, ErrUnsupportedMode
|
|
}
|
|
return base, nil
|
|
}
|
|
|
|
// NormalizeSplitPercent 把口头 3.5/4/2.5 换成 35/40/25；已经是百分数的原样保留。
|
|
func NormalizeSplitPercent(value float64) float64 {
|
|
if value <= 0 || math.IsNaN(value) || math.IsInf(value, 0) {
|
|
return 0
|
|
}
|
|
if value <= 10 {
|
|
return math.Round(value*10*10) / 10
|
|
}
|
|
return math.Round(value*10) / 10
|
|
}
|
|
|
|
func normalizeRulePercents(row *Rule) {
|
|
if row == nil {
|
|
return
|
|
}
|
|
row.PlatformReceiveRatio = NormalizeSplitPercent(row.PlatformReceiveRatio)
|
|
row.PlatformSellRatio = NormalizeSplitPercent(row.PlatformSellRatio)
|
|
row.DistributorReceiveRatio = NormalizeSplitPercent(row.DistributorReceiveRatio)
|
|
row.DistributorSellRatio = NormalizeSplitPercent(row.DistributorSellRatio)
|
|
row.DistributorARatio = NormalizeSplitPercent(row.DistributorARatio)
|
|
row.DistributorBRatio = NormalizeSplitPercent(row.DistributorBRatio)
|
|
if row.ServiceFeeUnit == ServiceFeeUnitRatio || row.ServiceFeeUnit == "" {
|
|
row.ServiceFeeUnit = ServiceFeeUnitPercent
|
|
}
|
|
if row.ServiceFeeUnit == ServiceFeeUnitPercent {
|
|
row.ServiceFeeValue = NormalizeSplitPercent(row.ServiceFeeValue)
|
|
}
|
|
}
|
|
|
|
// CalculateSettlement 先扣通道手续费和号主应得，得到利润后再按 35/40/25 切。
|
|
func CalculateSettlement(rule Rule, input SettlementInput) (SettlementResult, error) {
|
|
if input.GrossPaidAmountCent < 0 || input.RefundAmountCent < 0 || input.OwnerRentAmountCent < 0 || input.MarkupAmountCent < 0 || input.RefundAmountCent > input.GrossPaidAmountCent {
|
|
return SettlementResult{}, ErrInvalidAmount
|
|
}
|
|
if rule.PaymentFeeBPS < 0 || rule.PaymentFeeBPS > 10000 || rule.TaxRateBPS < 0 || rule.TaxRateBPS > 10000 || rule.ServiceFeeValue < 0 {
|
|
return SettlementResult{}, ErrInvalidRate
|
|
}
|
|
if rule.ServiceFeeUnit != ServiceFeeUnitPercent && rule.ServiceFeeUnit != ServiceFeeUnitFixedAmount && rule.ServiceFeeUnit != ServiceFeeUnitRatio {
|
|
return SettlementResult{}, ErrInvalidServiceUnit
|
|
}
|
|
netPaid := input.GrossPaidAmountCent - input.RefundAmountCent
|
|
paymentFee := roundHalfUp(float64(netPaid) * float64(rule.PaymentFeeBPS) / 10000)
|
|
profit := netPaid - input.OwnerRentAmountCent - paymentFee
|
|
if profit < 0 {
|
|
profit = 0
|
|
}
|
|
serviceFee, err := serviceFeeCent(rule, profit, netPaid)
|
|
if err != nil {
|
|
return SettlementResult{}, err
|
|
}
|
|
if serviceFee > profit {
|
|
serviceFee = profit
|
|
}
|
|
result := SettlementResult{
|
|
GrossPaidAmountCent: input.GrossPaidAmountCent,
|
|
RefundAmountCent: input.RefundAmountCent,
|
|
NetPaidAmountCent: netPaid,
|
|
PaymentFeeCent: paymentFee,
|
|
ServiceFeeCent: serviceFee,
|
|
MarkupAmountCent: input.MarkupAmountCent,
|
|
SplitBaseAmountCent: profit,
|
|
}
|
|
if rule.TaxEnabled {
|
|
result.TaxByParty = make([]PartyTaxResult, 0, len(input.GrossProfitByParty))
|
|
for _, party := range input.GrossProfitByParty {
|
|
profitParty := party.IncomeAmountCent - party.CostAmountCent
|
|
tax := roundHalfUp(float64(maxInt64(profitParty, 0)) * float64(rule.TaxRateBPS) / 10000)
|
|
result.TaxAmountCent += tax
|
|
result.TaxByParty = append(result.TaxByParty, PartyTaxResult{PartyRole: party.PartyRole, GrossProfitCent: profitParty, TaxAmountCent: tax})
|
|
}
|
|
}
|
|
return result, nil
|
|
}
|
|
|
|
func serviceFeeCent(rule Rule, profit, netPaid int64) (int64, error) {
|
|
switch rule.ServiceFeeUnit {
|
|
case ServiceFeeUnitPercent:
|
|
return roundHalfUp(float64(profit) * rule.ServiceFeeValue / 100), nil
|
|
case ServiceFeeUnitFixedAmount:
|
|
return roundHalfUp(rule.ServiceFeeValue * 100), nil
|
|
case ServiceFeeUnitRatio:
|
|
if rule.ServiceFeeValue <= 0 {
|
|
return 0, nil
|
|
}
|
|
return roundHalfUp(float64(netPaid) / rule.ServiceFeeValue), nil
|
|
default:
|
|
return 0, ErrInvalidServiceUnit
|
|
}
|
|
}
|
|
|
|
func roundHalfUp(value float64) int64 {
|
|
return int64(math.Floor(value + 0.5))
|
|
}
|
|
|
|
func maxInt64(a, b int64) int64 {
|
|
if a > b {
|
|
return a
|
|
}
|
|
return b
|
|
}
|
|
|
|
// PartySplit 是一次分成拆分中单个参与方的金额。
|
|
type PartySplit struct {
|
|
PartyRole string
|
|
Ratio float64
|
|
AmountCent int64
|
|
}
|
|
|
|
// SplitSettlement 按百分数切利润：收号 35%、卖出 40%。服务费 25% 记在财务快照，不并进参与方。
|
|
func SplitSettlement(rule Rule, profitCent int64) []PartySplit {
|
|
roles := []struct {
|
|
role string
|
|
ratio float64
|
|
}{}
|
|
switch rule.Mode {
|
|
case ModeTwoPartyDistributorReceive:
|
|
roles = []struct {
|
|
role string
|
|
ratio float64
|
|
}{{"distributor_receive", rule.DistributorReceiveRatio}, {"platform_sell", rule.PlatformSellRatio}}
|
|
case ModeTwoPartyPlatformReceive:
|
|
roles = []struct {
|
|
role string
|
|
ratio float64
|
|
}{{"distributor_sell", rule.DistributorSellRatio}, {"platform_receive", rule.PlatformReceiveRatio}}
|
|
case ModeThreeParty:
|
|
roles = []struct {
|
|
role string
|
|
ratio float64
|
|
}{{"distributor_a", rule.DistributorARatio}, {"distributor_b", rule.DistributorBRatio}}
|
|
default:
|
|
return nil
|
|
}
|
|
splits := make([]PartySplit, 0, len(roles))
|
|
for _, item := range roles {
|
|
amount := roundHalfUp(float64(profitCent) * item.ratio / 100)
|
|
splits = append(splits, PartySplit{PartyRole: item.role, Ratio: item.ratio, AmountCent: maxInt64(amount, 0)})
|
|
}
|
|
return splits
|
|
}
|
|
|
|
// SplitRemainderCent 返回利润扣除各方分成后的剩余（未扣服务费）。
|
|
func SplitRemainderCent(splitBase int64, splits []PartySplit) int64 {
|
|
sum := int64(0)
|
|
for _, item := range splits {
|
|
sum += item.AmountCent
|
|
}
|
|
return splitBase - sum
|
|
}
|
|
|
|
// SplitRoundingCent 返回利润扣完收号、卖出和服务费后的四舍五入尾差。
|
|
func SplitRoundingCent(profitCent, serviceFeeCent int64, splits []PartySplit) int64 {
|
|
return SplitRemainderCent(profitCent, splits) - serviceFeeCent
|
|
}
|