个税试算

POST

/merchantapi/v2/settlements/taxTrial

创建结算单前，按结算明细试算个人所得税、个人增值税和附加税。该接口不创建结算单、不占用额度、不触发支付；仅支持直营税地。receiveMethod 必须为当前项目已配置且可用的收款方式，否则返回 40109 PROJECT_PAYMENT_ACCOUNT_NOT_CONFIGURED。个税金额复用平台真实结算时的统一税费计算组件，试算接口本身不维护独立个税算法。

POST 请求实际传输加密外壳 {"encryptedData":"..."}；x-business-request-example 为加密前业务 JSON。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "encryptedData": "U2FsdGVkX1+..."
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/merchantapi/v2/settlements/taxTrial' \
--header 'X-App-Id;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Sign;' \
--header 'X-Encrypt-Type;' \
--header 'Content-Type: application/json' \
--data '{
    "encryptedData": "U2FsdGVkX1+..."
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "projectId": "2016422018623922178",
        "projectName": "直播活动推广项目",
        "taxCompanyName": "上海税地",
        "receiveMethod": "bank",
        "totalAmount": 5000,
        "totalCount": 1,
        "totalTax": 500,
        "totalPersonalIncomeTaxAmount": 400,
        "totalPersonalValueAddedTaxAmount": 80,
        "totalSurtaxAmount": 20,
        "totalNetAmount": 4520,
        "calculationTime": "2026-06-24 15:30:00",
        "details": [
            {
                "merchantDetailNo": "MERCHANT_DETAIL_001",
                "amount": 5000,
                "tax": 500,
                "personalIncomeTaxAmount": 400,
                "personalValueAddedTaxAmount": 80,
                "surtaxAmount": 20,
                "feeAmount": 20,
                "serviceFeeAmount": 30,
                "bankFeeAmount": 2,
                "netAmount": 4520
            }
        ]
    }
}

修改于 2026-09-24 04:26:20

查询结算单详情

提交验收凭证