税务设置

GET accounts/:account_id/tax_settings

检索与当前账号关联的税务设置详细信息。

资源 URL

https://ads-api.twitter.com/8/accounts/:account_id/tax_settings

参数

名称 说明
account_id
必需

所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。

类型:string

示例:18ce54d4x5t

请求示例

GET https://ads-api.twitter.com/8/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/8/accounts/:account_id/tax_settings

参数

名称 说明
account_id
必需

所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。

类型:string

示例:18ce54d4x5t

address_city
可选

账号拥有者地址所在城市。

类型:string

示例:San Francisco

address_country
可选

账号所有者地址的两个字母的国家/地区代码。

类型:string

示例:US

address_email
可选

与账号所有者地址关联的邮件。

类型:string

示例:api@mctestface.com

address_first_name
可选

账号所有者地址中的名字。

类型:string

示例:API

address_last_name
可选

账号所有者地址中的姓氏。

类型:string

示例:McTestface

address_name
可选

账号所有者地址中的公司名称。

类型:string

示例:ABC, Co.

address_postal_code
可选

账号所有者地址中的邮政编码。

类型:string

示例:94102

address_region
可选

账号所有者地址所在地区。

类型:string

示例:California

address_street1
可选

账号所有者地址的街道行。

类型:string

示例:21 March St

address_street2
可选

账号所有者地址的第二街道行。

类型:string

示例:Suite 99

bill_to
可选

计费实体。

类型:enum

可能值:ADVERTISERAGENCY

business_relationship
可选

账号归广告商还是代理所有。

类型:enum

可能值:AGENCYSELF

client_address_city
可选

广告商地址所在城市。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:Toronto

client_address_country
可选

广告商地址的两个字母的国家/地区代码。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:CA

client_address_email
可选

与广告商地址关联的邮件。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:ads@brand.com

client_address_first_name
可选

广告商地址中的名字。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:Brand

client_address_last_name
可选

广告商地址中的姓氏。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:Advertiser

client_address_name
可选

广告商地址中的公司名称。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:Brand, Inc.

client_address_postal_code
可选

广告商地址中的邮政编码。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:M5H 2N2

client_address_region
可选

广告商地址所在地区。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:Ontario

client_address_street1
可选

广告商地址的街道行。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:280 Queen St W

client_address_street2
可选

广告商地址的第二街道行。

如果广告账号归代理所有,则需要设置此参数。

类型:string

示例:The 6

invoice_jurisdiction
可选

发票管辖权。

类型:enum

可能值:LOI_SAPINNONENOT_SET

tax_category
可选

税费属于个人还是企业税务。

类型:enum

可能值:BUSINESS_NO_VATBUSINESS_WITH_VATINDIVIDUAL

tax_exemption_id
可选

增值税免税 ID。

类型:sting

示例:12345

tax_id
可选

增值税注册 ID。

类型:string

可能值:67890

请求示例

PUT https://ads-api.twitter.com/8/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
  }
}