税务设置
GET accounts/:account_id/tax_settings¶
检索与当前账号关联的税务设置详细信息。
资源 URL¶
https://ads-api.twitter.com/10/accounts/:account_id/tax_settings
参数¶
名称 | 说明 |
---|---|
account_id 必需 |
所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。 类型:string 示例: |
请求示例¶
GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/tax_settings
响应示例¶
{
"request": {
"params": {
"account_id": "18ce54d4x5t"
}
},
"data": {
"tax_id": "GB896391250",
"address_city": "London",
"business_relationship": "SELF",
"address_street1": "21 March St",
"address_last_name": null,
"address_company": "ABC, Inc.",
"tax_category": "BUSINESS_WITH_VAT",
"address_postal_code": "SW1A 1AA",
"bill_to": "NOT_SET",
"address_region": "London",
"address_country": "GB",
"address_first_name": null,
"invoice_jurisdiction": "NOT_SET",
"address_street2": null,
"address_email": null
}
}
PUT accounts/:account_id/tax_settings¶
更新当前账号的税务设置。
资源 URL¶
https://ads-api.twitter.com/10/accounts/:account_id/tax_settings
参数¶
名称 | 说明 |
---|---|
account_id 必需 |
所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。 类型:string 示例: |
address_city 可选 |
账号拥有者地址所在城市。 类型:string 示例: |
address_country 可选 |
账号所有者地址的两个字母的国家/地区代码。 类型:string 示例: |
address_email 可选 |
与账号所有者地址关联的邮件。 类型:string 示例: |
address_first_name 可选 |
账号所有者地址中的名字。 类型:string 示例: |
address_last_name 可选 |
账号所有者地址中的姓氏。 类型:string 示例: |
address_name 可选 |
账号所有者地址中的公司名称。 类型:string 示例: |
address_postal_code 可选 |
账号所有者地址中的邮政编码。 类型:string 示例: |
address_region 可选 |
账号所有者地址所在地区。 类型:string 示例: |
address_street1 可选 |
账号所有者地址的街道行。 类型:string 示例: |
address_street2 可选 |
账号所有者地址的第二街道行。 类型:string 示例: |
bill_to 可选 |
计费实体。 类型:enum 可能值: |
business_relationship 可选 |
账号归广告商还是代理所有。 类型:enum 可能值: |
client_address_city 可选 |
广告商地址所在城市。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
client_address_country 可选 |
广告商地址的两个字母的国家/地区代码。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
client_address_email 可选 |
与广告商地址关联的邮件。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
client_address_first_name 可选 |
广告商地址中的名字。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
client_address_last_name 可选 |
广告商地址中的姓氏。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
client_address_name 可选 |
广告商地址中的公司名称。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
client_address_postal_code 可选 |
广告商地址中的邮政编码。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
client_address_region 可选 |
广告商地址所在地区。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
client_address_street1 可选 |
广告商地址的街道行。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
client_address_street2 可选 |
广告商地址的第二街道行。 如果广告账号归代理所有,则需要设置此参数。 类型:string 示例: |
invoice_jurisdiction 可选 |
发票管辖权。 类型:enum 可能值: |
tax_category 可选 |
税费属于个人还是企业税务。 类型:enum 可能值: |
tax_exemption_id 可选 |
增值税免税 ID。 类型:sting 示例: |
tax_id 可选 |
增值税注册 ID。 类型:string 可能值: |
请求示例¶
PUT https://ads-api.twitter.com/10/accounts/18ce54d4x5t/tax_settings?address_name=ABC, Co.
响应示例¶
{
"request": {
"params": {
"account_id": "18ce54d4x5t",
"address_name": "ABC Co."
}
},
"data": {
"tax_id": "GB896391250",
"address_city": "London",
"business_relationship": "SELF",
"address_street1": "21 March St",
"address_last_name": null,
"address_company": "ABC, Co.",
"tax_category": "BUSINESS_WITH_VAT",
"address_postal_code": "SW1A 1AA",
"bill_to": "NOT_SET",
"address_region": "London",
"address_country": "GB",
"address_first_name": null,
"invoice_jurisdiction": "NOT_SET",
"address_street2": null,
"address_email": null
}
}