使用Avalara Avatax服务计算销售税
项目描述
Odoo提供了与Avalara（Avalara提供的一款税解决方案软件）的集成，该软件包括所有美国州和地区以及所有加拿大省和地区的销售税计算（包括GST、PST和HST）。
此模块能够自动检测来源（输出仓库）和目的地（客户地址），然后计算并向用户的Avalara账户报告税费，同时在Odoo ERP中记录已验证地址的正确销售税。
此模块与Odoo企业版和odoo社区版都兼容。
需要一个Avatax账户。可以通过Avalara网站在此处获取访问Avatax仪表板的账户信息：[https://www.avalara.com/products/avatax/](https://www.avalara.com/products/avatax/)
配置完成后，该模块在后台运行，并无缝地执行计算和报告到AvaTax服务器。
本指南包括以下元素的说明
激活您组织的Avatax账户并下载产品
将Avatax凭据输入到您的Odoo数据库中，并将其配置为在Odoo中使用Avatax服务和功能
注意：在部署到生产环境之前，请测试模块。所有AvaTax设置的更改都必须由具有管理员访问权限的用户执行。
重要 - 解决与Odoo EE的名称冲突
Avatax支持已添加到Odoo EE 14和15。遗憾的是，使用的模块名称与OCA相同，因此由于名称冲突，OCA模块被迫更改名称。
主模块的名称已从account_avatax（现在由Odoo EE使用）更改为account_avatax_oca。
将此更改应用于您的 Odoo 数据库，并继续使用 OCA Avalara 认证连接器
- 确保您拥有 OCA 的最新版本，并且您在应用程序列表中看到 account_avatax_oca
。
安装新的 account_avatax_oca 模块
卸载 account_avatax 模块
- 确认您的配置已安全保存，特别是
Avatax API、默认“Avatax”会计位置和默认“Avatax”税务记录。
目录
安装
安装此应用程序
下载 AvaTax 模块
解压下载的文件
将解压的目录上传到您的 Odoo 模块/附加组件目录
重新启动您的 Odoo 实例
以管理员身份登录
导航到“应用程序”并在搜索字段中搜索“AvaTax”
单击安装按钮
配置
配置 AvaTax API
导航到：会计或发票应用程序 >> 配置 >> AvaTax >> AvaTax API
单击创建按钮。
取消选中“禁用 AvaTax 计算”框
- 使用与您的 Avalara 账户一起提供的公司代码、账户号码和许可证密钥填写表单
。
选择 Avalara 提供的适当服务 URL：测试或生产。
单击测试连接按钮
单击保存按钮
其他 Avatax API 高级配置
适配器
请求超时 – 默认为 300ms
启用日志记录 – 启用应用程序内的详细 AvaTax 交易日志记录
地址验证
禁用地址验证
在保存客户配置文件时进行地址验证 – 在创建和更新客户配置文件时自动尝试验证，最后验证日期将可见并保存
强制地址验证 – 如果需要客户验证但无效，则强制进行验证
以大写形式返回验证结果 – 验证结果将以大写形式返回
自动生成客户代码 – 在创建和更新客户配置文件时生成客户代码
Avalara 提交/交易
禁用 Avalara 税务提交 – 验证的发票不会被发送到 Avalara
启用 UPC 税务性 – 这将传输 Odoo 的产品 ean13 号码而不是其内部参考。如果没有 ean13，则自动发送内部参考。
根据发货地址隐藏免税和税务 – 这将使用户能够在发票级别隐藏或显示“免税”和“根据发货地址的税务”字段。
国家/地区
添加或删除适用的国家/地区 – 计算器不会为列表外的国家/地区计算。
配置免税代码
- 允许用户在适用情况下使用免税代码（例如，政府实体）。
导航到：会计或发票应用程序 >> 配置 >> AvaTax >> 免税代码
- 模块已安装 16 个预定义的免税代码。
您可以添加、删除和修改免税代码。
产品税务代码
创建产品税务代码以分配给产品和/或产品类别。导航到：会计或发票应用程序 >> 配置 >> AvaTax >> 产品税务代码。
从这里，您可以添加、删除和修改产品税务代码。
配置税务
AvaTax 模块已集成到 Odoo 的税务计算中。AVATAX 将自动添加为要应用的税种类型。您可以配置 AVATAX 如何在 Odoo 系统中集成。
配置 AVATAX 税种类型
导航到：会计或发票应用程序 >> 配置 >> 会计 >> 税收
从列表视图中选择 AVATAX（在模块安装时自动添加）。
点击“编辑”按钮，配置AVATAX税种，并为您的系统设置正确的税账户配置。
注意：在首次安装后，设置将保持空白。图片显示了演示配置。
产品类别配置
Odoo中的产品通常被分配到产品类别。创建产品类别时，也可以将AvaTax设置分配给产品类别。
创建新产品类别
导航到：库存 >>> 配置 >>> 产品 >>> 产品类别
点击创建按钮
配置产品类别税码
在AvaTax属性 >>> 税码下
选择所需的税码
公司配置
与AvaTax关联的每个公司及其关联的仓库都应配置正确，以确保对所有交易计算和应用的税是正确的。
仓库配置
导航到：库存 >>> 配置 >>> 仓库管理 >>> 仓库
选择与您的公司关联的仓库
在地址下，点击链接以跳转到您的仓库资料
配置仓库地址
输入仓库地址
在AvaTax >>> 验证下，点击验证按钮
客户配置
正确配置每个客户确保对所有交易计算和应用的税是正确的。
创建新客户
导航到联系人
点击创建按钮
配置和验证客户地址
输入客户地址
在AvaTax >>> 验证下，点击验证按钮
AvaTax模块将尝试将您输入的地址与其数据库中的有效地址进行匹配。如果地址有效，请点击“接受”按钮。
免税状态
如果客户免税，请在AvaTax >>> 免税 >>> 是否免税下勾选复选框
从下拉菜单中选择所需的免税代码。
使用方法
客户发票
AvaTax模块集成到销售发票中，并应用于每个交易。AvaTax仪表板中的交易日志显示了发票详情，并显示交易处于未提交或已提交状态。
已验证的发票将显示为已提交状态，已取消的发票将显示为作废状态。
模块将检查是否选择了仓库，并将自动确定仓库地址和起源地。如果未分配仓库地址，则使用公司地址。
折扣在Odoo设置中启用时进行处理。它们被视为在将总计发送到AvaTax之前对行项目成本的净扣除。
创建新的客户发票
导航到：会计或发票 >>> 客户 >>> 发票。
点击创建按钮。
验证发票
确保已勾选基于发货地址的税。
行项目应在税下选择AVATAX以供内部记录。
要完成发票，请点击验证按钮。
销售订单现在将出现在AvaTax仪表板中。
登记付款
点击“登记付款”按钮以最终确定发票。
客户退款
Odoo在会计模块中应用退款而不是作废。与客户发票一样，AvaTax模块集成到客户退款中，并应用于每个交易。
- 退款发票交易将在AvaTax界面中
以负总计表示。
启动客户退款
导航到：会计或发票 >>> 客户 >>> 发票
选择您希望退款的发票
点击“添加贷项通知单”按钮
创建贷项通知单
在贷项方法下，选择创建草稿贷项通知单。
输入原因。
点击“添加贷项通知单”按钮。
注意：您将被带到贷项通知单列表视图
验证退款
选择您希望验证的贷项通知单，审查后点击验证按钮。
登记退款付款
点击“登记付款”按钮以完成退款
销售订单
AvaTax模块集成到销售订单中，允许计算税额。销售订单交易不会显示在AvaTax界面中。
- 在销售订单中输入的信息将自动传递到发票中
在Avalara服务器上，并且可以在AvaTax控制面板中查看。
当在Odoo设置中启用折扣时，将处理折扣。它们将作为净扣除报告在行项目成本中。
创建新的销售订单
导航到：销售 >> 订单 >> 订单
点击创建按钮
使用AvaTax计算税费
当确认销售订单或通过导航到操作 >> 使用AvaTax更新税费时，模块将计算税费。在此步骤中，销售订单将从Avalara检索税费金额，但不会向AvaTax仪表板报告交易。只有发票、退款和付款活动会报告到仪表板。
模块将检查是否选择了仓库，并将自动确定仓库地址和来源位置。如果没有分配仓库地址，则模块将自动使用公司地址作为其来源。位置代码将自动填充为仓库代码，但如有需要可以修改。
已知问题/路线图
此模块的开发是由美国公司推动的，用于计算销售税。
然而，Avatax服务支持更多用例，可以添加
添加对欧盟增值税的支持
添加对购买/供应商账单上美国使用税的支持
可以添加的其他改进
检测并警告客户所在州不是当前账户可用的枢纽
错误跟踪器
错误在 GitHub Issues 上跟踪。如果在出现问题时，请检查是否已经报告了您的问题。如果您是第一个发现的，请通过提供详细且受欢迎的 反馈 来帮助我们解决问题。
请不要直接联系贡献者以获取支持或技术问题的帮助。
致谢
贡献者
Odoo SA
Fabrice Henrion
开源集成商 (https://opensourceintegrators.com)
Daniel Reis <dreis@opensourceintegrators.com>
Bhavesh Odedra <bodedra@opensourceintegrators.com>
Sandip Mangukiya <smangukiya@opensourceintegrators.com>
Serpent CS
Murtuza Saleh
Sodexis
Atchuthan Ubendran
其他致谢
此模块最初由Fabrice Henrion在Odoo SA开发，并维护到版本11。
对于版本12，Fabrice邀请了合作伙伴迁移此模块到更高版本，并维护它。
开源集成商完成了到Odoo 12的迁移，并随后添加了对更新的REST API的支持，同时保留了对传统SOAP API的支持。
随着REST API的添加，引入了深度重构，将税务计算方法从仅设置总税额更改为将税率添加到每个文件行，然后由Odoo执行所有其他计算。
对于Odoo 13，支持了传统的SOAP支持，并对模块进行了额外的重构，以便将其贡献给Odoo社区协会。
维护者
此模块由OCA维护。
OCA，或Odoo社区协会，是一个非营利组织，其使命是支持Odoo功能的协作开发并促进其广泛使用。
当前 维护者
此模块是GitHub上 OCA/account-fiscal-rule 项目的组成部分。
欢迎您贡献力量。要了解如何操作，请访问 https://odoo-community.org/page/Contribute。
哈希值 for odoo14_addon_account_avatax_oca-14.0.4.0.4-py3-none-any.whl
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 93400d05d8515532118701ad1a4cee4c1e8a61196d21fa9b95eb349ec9f38a5c |
|
| MD5 | 874323135d988983457f93e3faf6abf6 |
|
| BLAKE2b-256 | ad3c8311974a927ee316d273880639eff85602cd6c8b406dd81869e3dd18e553 |