AvaTax API：您的下一个销售税集成变得更加容易
0/5 (0投票)
在本文中，我将解释 AvaTax API 如何将一项可能困难且令人沮丧的任务——即构建销售税计算集成——变得非常快速和简单。（剧透警告：详细的文档和大量的示例代码非常有帮助。）
引言
“我只需要获取一个邮政编码的税率！”
当人们刚开始接触销售税集成项目时，我经常听到这句话。我完全理解这种先入为主的观念——我以前也这么想！——但这是一种很久以前的思维方式，那时计算机只能根据邮政编码匹配税率。
从那时起，技术能力和税收法律都发生了很大的变化，我们构建 AvaTax API 来跟上这种复杂性和可能性。
如今，不同的产品税率差异很大——无论是软饮料、软件还是滑雪靴——而且并不总是清楚何时需要根据目的地或原产地征税。为了让您大致了解税收合规的复杂性，我们的 API 在两千到三千个不同的产品类别之间进行核对，所有这些类别在超过 10,000 个独立的（但经常重叠的）税收管辖区（从城市、县到州、国家）都有不同的税率。
基本上，AvaTax API 将混乱的税收合规性问题简化，使其对开发人员来说变得轻松，从而可以轻松地将强大而准确的税收计算集成到任何会计系统中。
场景 1：毛衣销售
那么 AvaTax API 是如何工作的，它又比标准的现成税收解决方案好在哪里呢？通过几个例子来解释可能最容易理解。
在下面的示例场景中，我们可以看到 API 如何准确计算将一件 100 美元的布毛衣从加利福尼亚州运往纽约州的税费。您知道纽约州对服装产品有特殊的税收规定吗？AvaTax 知道——毛衣特定的 taxCode 值 利用了 Avalara 内容团队的持续工作，该团队监控世界各地的政府，并追踪特定产品或服务税收规则或税率的任何变化。
同样，postalCode 值 确保税费根据不同税收管辖区的规则正确计算，无论您是从加利福尼亚州运往纽约州，还是反之亦然。
POST /api/v2/transactions/create
{
"lines": [{
"amount": 100,
"taxCode": "PC040100"
}],
"type": "SalesInvoice",
"companyCode": "DEFAULT",
"date": "2017-10-02",
"customerCode": "ABC",
"addresses": {
"shipFrom": { "postalCode": "90210" },
"shipTo": { "postalCode": "10010" }
}
}
这些值的使用方式还有一个很棒的地方是，随着公司税收情况变得更加复杂，AvaTax API 也会随之发展。Avalara 内容团队一直在研究税法变更，并确保这些变更反映在 API 中——因此，无论情况多么复杂，税费都能准确计算。
场景 2：多个供应商
假设您正在尝试构建下一代 Etsy 或 eBay，并且想要开设一个拥有多个卖家（供应商）的市场。税法要求每个交易单独申报——但如果您的市场希望为客户提供便利，AvaTax 可以提供帮助。
如果有人登录您的商店并从三个不同的供应商处购买了三件不同的商品，AvaTax API 可以将一个多公司交易分解为单独的交易，以便您的每个卖家都可以单独申报税款，如下所示。
POST /api/v2/transactions/multidocument
{
"lines": [{
"amount": 100,
"taxCode": "PC040100",
"companyCode": "SELLER1"
},{
"amount": 100,
"taxCode": "PC040100",
"companyCode": "SELLER2"
},{
"amount": 100,
"taxCode": "PC040100",
"companyCode": "SELLER3"
}],
"type": "SalesInvoice",
"date": "2017-10-02",
"customerCode": "ABC",
"addresses": {
"shipFrom": { "postalCode": "90210" },
"shipTo": { "postalCode": "10010" }
}
}
易于集成
和我的团队中的大多数人一样，在加入 Avalara 之前，我是一名开发人员和顾问，所以我们都知道构建集成的感受，无论是为小型公司还是为企业构建。这意味着我们一直在绞尽脑汁，力求使税收计算尽可能简单和自助服务，并赋予开发人员尽可能多的控制权。这也是我们文档和示例代码背后的理念。
从一开始，我们就努力使 AvaTax API 易于使用，我最喜欢的集成故事之一发生在去年：我们正在与一个大型合作伙伴合作，一家企业级电子商务公司，他们希望在整个市场平台中实施该 API。高管们在周末达成了口头协议，然后他们以为集成将需要两到三个月。但合作伙伴在 *下一个星期一* 就回来了，说：“我想我们不需要任何帮助了。我们把它交给了一些初级程序员，他们一个周末就搞定了。”是的，我们对我们的文档感到自豪。
迈出下一步：亲自尝试
在过去那种“我只需要一个邮政编码的税率！”的税收合规时代，在一个月结束时，已收取的税款与应缴税款之间常常存在很大差异——不出所料，这意味着公司更容易受到审计，并可能面临罚款和利息。
凭借现在可能实现的快速和精确，我们的 API 使公司能够将税款收取和汇款值精确到一美元以内——考虑到涉及的所有舍入和复杂性，这相当令人惊讶。（这种准确性意味着公司通常不会受到审计，或者即使受到审计，也不会产生负面结果。）
如果您正在构建任何类型的税收集成，我邀请您查看 我们的开发者指南，查看 我们的 SDK（包括 C#、JRE、PHP、Ruby 和 JavaScript），并注册 一个免费的 60 天生产账户 来亲自试用 AvaTax API。您会发现该 API 也可以帮助处理其他复杂的任务，例如自动化豁免证书管理流程。
仍然有问题？来与我和我的团队聊聊吧！我们已经开始每周举行一次开放式的 在线答疑会，专门为开发人员和工程师提供。无论您是 Avalara 平台的新用户，还是有兴趣添加功能或增强能力，我们都知道如何完成工作，并且乐于为您提供帮助。