Logo
Section 1 / 3

公司

学习如何使用AvaTax API来管理与您的业务相关的公司。

导入

公司

学习如何使用AvaTax API来管理与您的业务相关的公司。

Avalara 可以满足几乎任何企业的税务需求，无论是个体经营户还是大型跨国公司（MNC）。但在开始处理税务交易之前，我们必须在 Avalara 中为我们的企业创建一个公司账户。我们使用 https://sandbox-rest.avatax.com/api/v2/companies/ 端点来管理公司账户。

通过公司账户，我们可以将正确的税款归属到特定的企业。这在管理拥有多个子公司的企业时非常有用。

代码示例

1https://sandbox-rest.avatax.com/api/v2/companies

请求参数

参数名类型参数类型分类说明
id整数请求体必填指定要创建的公司的唯一标识符（UUID）。
accountId整数请求体必填指定拥有该公司的 Avalara 账户的唯一标识符（UUID）。
companyCode字符串请求体可选指定该公司的唯一编码，便于在 Avalara 中快速引用该公司。
name字符串请求体必填指定该公司的名称。
isDefault布尔值请求体可选布尔值，指定所创建的公司是否为 Avalara 账户的默认公司。
isActive布尔值请求体可选布尔值，指定 Avalara 是否可以为此公司执行税务交易。设为 true 时，Avalara 将开始为此公司处理税务交易。
defaultCountry字符串请求体必填指定该公司默认所在的国家。这有助于 Avalara 在为其创建税务交易时，默认应用该国家的税则。需传入国家的两位 ISO-3166 编码。
contacts联系人对象数组请求体可选指定该公司的联系人列表。
items商品对象数组请求体可选指定该公司的商品和服务列表，代表公司提供的产品与服务。
locations地点对象数组请求体可选指定该公司的经营地点列表。
1# 账户 ID 和许可证密钥
2account_id = "{{ACCOUNT_ID}}"
3license_key = "{{LICENSE_KEY}}"
4
5# 端点地址
6endpoint_url = "https://sandbox-rest.avatax.com/api/v2/companies"
7
8# 使用账户 ID 和许可证密钥创建基础认证令牌
9auth_token = requests.auth.HTTPBasicAuth(account_id, license_key)
10
11# 定义公司信息
12data_obj = {
13    "accountId": int(account_id),
14    "name": f"公司 {random.randint(0,9999999)}",
15    "isDefault": False,
16    "isActive": True,
17    "hasProfile": True,
18    "defaultCountry": "US",
19    "baseCurrencyCode": "USD",
20    "isTest": True,
21}
22
23# 向 AvaTax API 发送 POST 请求
24response = requests.post(url=endpoint_url, auth=auth_token,
25                         data=json.dumps(data_obj))
26
27# 输出响应结果
28print_response(response)

代码示例

1https://sandbox-rest.avatax.com/api/v2/companies/{{id}}
1# 账户 ID 和许可证密钥
2account_id = "{{ACCOUNT_ID}}"
3license_key = "{{LICENSE_KEY}}"
4
5# 公司 ID
6company_id = {{COMPANY_ID}}
7
8# 端点地址
9endpoint_url = f"https://sandbox-rest.avatax.com/api/v2/companies/{company_id}"
10
11# 使用账户 ID 和许可证密钥创建基础认证令牌
12auth_token = requests.auth.HTTPBasicAuth(account_id, license_key)
13
14# 定义公司信息
15data_obj = {
16    "id": company_id,
17    "accountId": int(account_id),
18    "companyCode": f"{random.randint(0,9999999)}",
19    "name": "示例公司",
20    "isDefault": False,
21    "isActive": True,
22    "hasProfile": True,
23    "defaultCountry": "US",
24    "baseCurrencyCode": "USD",
25    "isTest": True,
26}
27
28# 向 AvaTax API 发送 PUT 请求
29response = requests.put(url=endpoint_url, auth=auth_token,
30                        data=json.dumps(data_obj))
31
32# 输出响应结果
33print_response(response)

代码示例

1https://sandbox-rest.avatax.com/api/v2/companies

请求参数

参数名类型参数类型分类说明
$top整数查询参数可选指定要获取的公司结果数量上限。
$skip整数查询参数可选指定跳过多少条公司结果。
1# 账户 ID 和许可证密钥
2account_id = "{{ACCOUNT_ID}}"
3license_key = "{{LICENSE_KEY}}"
4
5# 端点地址
6endpoint_url = f"https://sandbox-rest.avatax.com/api/v2/companies"
7
8# 使用账户 ID 和许可证密钥创建基础认证令牌
9auth_token = requests.auth.HTTPBasicAuth(account_id, license_key)
10
11# 定义查询参数
12parameters = {
13    "$top": 20,
14}
15
16# 向 AvaTax API 发送 GET 请求
17response = requests.get(url=endpoint_url, auth=auth_token,
18                        params=parameters)
19
20# 输出响应结果
21print_response(response)

代码示例

1https://sandbox-rest.avatax.com/api/v2/companies/{{id}}

请求参数

参数名类型参数类型分类说明
id整数路径参数必填指定要获取的公司的唯一标识符（UUID）。
$include字符串查询参数可选指定在获取公司对象的同时，还应一并获取哪些嵌套对象。
1# 账户 ID 和许可证密钥
2account_id = "{{ACCOUNT_ID}}"
3license_key = "{{LICENSE_KEY}}"
4
5# 公司 ID
6company_id = {{COMPANY_ID}}
7
8# 端点地址
9endpoint_url = f"https://sandbox-rest.avatax.com/api/v2/companies/{company_id}"
10
11# 使用账户 ID 和许可证密钥创建基础认证令牌
12auth_token = requests.auth.HTTPBasicAuth(account_id, license_key)
13
14# 定义查询参数
15parameters = {
16    "$include": "Locations",
17}
18
19# 向 AvaTax API 发送 GET 请求
20response = requests.get(url=endpoint_url, auth=auth_token,
21                        params=parameters)
22
23# 输出响应结果
24print_response(response)

简介

商品税码