税率计算流程

税率计算流程（买家与平台运营 / 海外前台与管理后台）

根据目的地匹配税率规则，从平台配置表或第三方税务引擎获取税率，按价内税或价外税计算并展示税费明细。管理端可配置国家、类目与免税规则；第三方失败时降级到平台配置表。

参与角色：平台管理员、买家/消费者

flowchart TD
    Start([买家浏览/下单]) --> IdentifyDestination[识别目的地信息]
    IdentifyDestination --> DestSource{目的地来源}
    DestSource -->|收货地址| FromAddress[从收货地址获取国家/地区]
    DestSource -->|IP定位| FromIP[从IP地址估算国家]
    DestSource -->|用户手动选择| FromManual[用户选择国家/地区]

    FromAddress --> MatchTaxRule
    FromIP --> MatchTaxRule
    FromManual --> MatchTaxRule

    MatchTaxRule[匹配税率规则] --> RuleSource{税率数据来源}
    RuleSource -->|平台配置表| ConfigTable["查询平台税率配置：\n按国家设置税率\n按商品类目设置税率"]
    RuleSource -->|第三方税务引擎| ThirdPartyAPI[调用第三方税率API]

    ConfigTable --> CheckMatch{是否匹配到税率}
    CheckMatch -->|是| LoadRate[加载税率]
    CheckMatch -->|否| DefaultRate[使用默认税率/免税]

    ThirdPartyAPI --> APIResult{API是否返回}
    APIResult -->|成功| LoadRate
    APIResult -->|失败| FallbackConfig[降级为平台配置表]
    FallbackConfig --> ConfigTable

    LoadRate --> CalcTax["计算税额"]
    DefaultRate --> CalcTax

    CalcTax --> TaxMethod{税率计算方式}
    TaxMethod -->|含税价（价内税）| InclusiveTax["税已含在商品价格中：\n商品价 = 含税价\n税额 = 含税价 × 税率 ÷ (1+税率)"]
    TaxMethod -->|不含税（价外税）| ExclusiveTax["税额额外收取：\n税额 = 商品价 × 税率\n应付 = 商品价 + 税额"]

    InclusiveTax --> RoundTax[税额取整/四舍五入]
    ExclusiveTax --> RoundTax

    RoundTax --> ShowTaxBreakdown["展示税费明细"]

    %% 商品浏览时
    ShowTaxBreakdown --> BrowseScene{场景}
    BrowseScene -->|商品列表/详情| ShowPriceWithTax["商品价格展示：\n含/不含税价标注\n预估税额提示"]

    %% 结算时
    BrowseScene -->|结算页面| OrderTaxDetail["订单税费明细：\n每件商品税额\n总税额\n税率说明"]
    OrderTaxDetail --> TotalCalc["订单总额计算：\n商品金额\n+ 运费\n+ 税费\n= 应付总额"]

    %% 运营配置视角
    AdminConfig([平台管理员配置]) --> TaxConfig[税率配置管理]
    TaxConfig --> ConfigActions{配置操作}
    ConfigActions -->|按国家配置| CountryTax["设置各国税率：\n国家 → 税率（%）"]
    ConfigActions -->|按类目配置| CategoryTax["设置类目税率：\n商品类目 → 税率（%）"]
    ConfigActions -->|免税设置| TaxExemption["设置免税规则：\n免税国家\n免税商品类目\n免税金额门槛"]
    CountryTax --> SaveConfig[保存税率配置]
    CategoryTax --> SaveConfig
    TaxExemption --> SaveConfig

    TotalCalc --> End1([提交订单])
    ShowPriceWithTax --> End2([继续浏览])

步骤说明

买家浏览或下单时识别目的地信息，来源可为收货地址、IP 定位或用户手动选择的国家或地区。
匹配税率规则并选择数据来源：平台配置表或第三方税务引擎。
若使用平台配置表，则查询按国家、类目等配置的税率，判断是否匹配到税率：若匹配则加载税率；若不匹配则使用默认税率或免税。
若使用第三方 API，则判断 API 是否返回成功：若成功则加载税率；若失败则降级为平台配置表并回到上述匹配逻辑。
加载税率或默认规则后计算税额，并选择计算方式为价内税（含税价）或价外税（不含税），对税额取整或四舍五入后展示税费明细。
按场景分支：在商品列表或详情页展示含/不含税价标注与预估税额，可继续浏览；在结算页展示订单税费明细（每件税额、总税额、税率说明）并计算应付总额（商品金额加运费加税费），可提交订单。
平台管理员侧可独立进入税率配置管理，按国家、按类目或免税规则（国家、类目、金额门槛）进行配置并保存。
买家侧浏览或提交订单路径结束为继续浏览或提交订单；配置保存为管理端操作节点。
流程结束。