如何为AvaTax API的api/v2/companies接口设置筛选查询公司ID等数据
AvaTax
api/v2/companies 接口筛选配置方法 筛选条件配置规则
AvaTax v2 系列接口统一使用$filter查询参数实现条件筛选,语法遵循标准OData规范,你需要的筛选场景配置方法如下:
- 按指定Account ID查询:直接在
$filter参数中写入accountId eq 你的目标账户ID即可,eq是等于判断操作符,Account ID为数字类型,无需额外加引号 - 按其他公司属性查询:支持的常用可筛选属性包含
companyCode(公司编码)、name(公司名称)、isActive(激活状态)、taxpayerIdNumber(税号)等,多条件可以用and/or逻辑符拼接,比如筛选Account ID为123456且已激活的公司,参数为$filter=accountId eq 123456 and isActive eq true
注意事项
- 字符串类型的属性值需要用单引号包裹,例如按公司名称筛选的参数为
$filter=name eq '测试公司' - 筛选条件的属性名大小写不敏感,建议和接口返回的字段名保持一致避免报错
官方参考说明
Avalara官方开发者文档中心有该接口的完整参数说明,包含所有可筛选字段的类型、支持的操作符列表,以及不同复杂度的筛选场景示例,你可以在Avalara开发者平台搜索「AvaTax v2 Companies API」「REST API Filtering」获取对应的官方参考内容。
请求示例
# 替换占位符为你实际的授权凭证、查询参数即可发起请求 curl --location 'https://rest.avatax.com/api/v2/companies?$filter=accountId eq 123456' \ --header 'Authorization: Basic 你的授权Token'
内容的提问来源于stack exchange,提问作者Avalara-Developer
相关产品推荐
相关产品推荐

