使用 Avalara Avatax 服务计算销售税
项目描述
Odoo 提供与 AvaTax 的集成，Avalara 的税务解决方案软件包括美国所有州和地区以及加拿大所有省和地区（包括 GST、PST 和 HST）的销售税计算。
该模块能够自动检测原产地（输出仓库）和目的地（客户地址），然后计算并向用户的 Avalara 帐户报告税款，并在 Odoo ERP 中为经过验证的地址记录正确的销售税。
该模块与 Odoo Enterprise 和 Odoo Community 版本兼容。
需要一个 Avatax 帐户。访问 Avatax 仪表板的账户信息可通过 Avalara 网站获取： https ://www.avalara.com/products/calculations.html
配置完成后，该模块将在后台运行，并无缝执行计算并向 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”默认税务记录。
目录
<nav class="contents local" id="contents" role="doc-toc">安装
在安装 Avatax 应用程序之前，必须在您的系统中安装 Avalara Python 客户端。它可在https://pypi.org/project/Avalara获得。
通常，它可以使用pip安装在您的系统中：
pip3 install Avalara
基础应用程序account_Avatax为客户发票添加了 Avatax 支持。在官方应用商店：https ://apps.odoo.com/apps/modules/15.0/account_avatax/
account_avatax_sale扩展增加了对报价单/销售订单的支持。在官方应用商店：https ://apps.odoo.com/apps/modules/15.0/account_avatax_sale/
在大多数情况下，您需要下载并安装这两个模块。
要安装 Avatax 应用程序：
下载 AvaTax 模块
提取下载的文件
将提取的目录上传到您的 Odoo 模块/插件目录
以管理员身份登录 Odoo 并在“设置”中启用开发人员模式
导航到“应用程序”，选择“更新应用程序列表”菜单，以列出新应用程序。
在应用程序列表中，搜索“AvaTax”
单击安装按钮。如果可用，account_avatax_sale模块也将自动安装。
配置
要将 Odoo 公司配置为使用 Avatax，请执行以下步骤。请注意，其中一些可能是针对 Odoo 默认公司开箱即用的配置。
配置 AvaTax API 连接
配置公司税
配置客户
配置产品
配置 Avatax API 连接
在配置 Odoo Avatax 连接器之前，您需要准备好一些连接细节：
导航到设置 >> 所有 AvaTax 设置。在那里您将看到公司的详细信息。
记下帐户 ID 和公司代码
导航到设置 >> 许可证和 API 密钥。在“重置许可证密钥”选项卡中，单击“生成许可证密钥”按钮，并记下它。
在 Odoo 中配置 AvaTax 连接器：
导航至：会计/发票应用 >> 配置 >> AvaTax >> AvaTax API
点击创建按钮
使用从 AvaTax 网站收集的元素填写表格：
帐户ID
注册码
服务 URL：通常是生产或 Sandox（如果有）。
公司代码
单击测试连接按钮
单击保存按钮
其他 Avatax API 高级配置：
税收计算选项卡：
禁用文档记录/提交：发票不会存储在 Avalara
启用 UPC 可征税性：这将传输 Odoo 的产品 ean13 编号而不是其内部参考。如果没有 ean13，则内部参考将自动发送。
隐藏基于送货地址的免税和税收——这将使用户能够在发票级别隐藏或显示基于送货地址的免税和税收字段。
地址验证选项卡：
自动地址验证：自动尝试验证客户记录的创建和更新，最后验证日期将可见并存储
要求验证地址：如果需要对客户进行验证但无效，则将强制验证
以大写形式返回验证结果：验证结果将以大写形式返回
高级选项卡：
自动生成缺失的客户代码：在创建和更新客户资料时生成客户代码
记录 API 请求：在应用程序中启用详细的 AvaTax 事务记录
请求超时：默认为 300ms
国家：可以使用 AvaTax 的国家。
配置公司税
每个与 AvaTax 关联的公司及其关联仓库都应进行配置，以确保为所有交易计算和应用正确的税款。
验证公司地址：
在 AvTax API 配置表单上，单击“公司地址”链接
在公司地址表格上，单击“AvaTax”选项卡中的“验证”按钮
验证仓库地址：
导航至：库存>>配置>>仓库管理>>仓库
对于每个仓库，从视图中打开对应的
在仓库表单上，单击“地址”链接
在仓库地址表单上，单击“AvaTax”选项卡中的“验证”按钮
Fiscal Positions 告诉 AvaTax 连接器是否应将 AvaTax 服务用于特定的销售订单或发票。
配置财务状况：
导航至：会计/发票应用 >> 配置 >> 会计 >> 财务职位
确保公司有财务头寸记录，并选中“使用 Avatax API”标志
当使用适当的财务状况，并从 AvaTax 中检索税率时，相应的税收会使用模板税收记录在 Odoo 中自动创建，该模板税收记录应具有适当的会计配置。
配置税收：
导航至：会计/发票应用 >> 配置 >> 会计 >> 税收
确保有公司的税务记录，并选中“Is Avatax”标志（在“高级选项”选项卡中可见）。该税应具有：
税收类型：销售
税收计算：价格百分比
金额：0.0%
发票分配：确保正确的帐户配置
信用票据的分配：确保正确的帐户配置
配置客户
- 可以申请的用户（例如政府实体）允许使用豁免代码。
导航至：会计或发票应用 >> 配置 >> AvaTax >> 豁免代码
- 该模块安装有 16 个预定义的豁免代码。
您可以添加、删除和修改豁免代码。
正确配置每个客户可确保为所有交易计算和应用正确的税款。
创建新客户
导航到联系人
单击创建按钮
配置和验证客户地址
输入客户地址
在 AvaTax >> 验证下，单击验证按钮
AvaTax 模块将尝试将您输入的地址与其数据库中的有效地址相匹配。如果地址有效，请单击接受按钮。
免税状况
如果客户免税，请勾选 AvaTax >> Tax Exemption >> Is Tax Exempt 和
从下拉菜单中选择所需的免税代码。
配置产品
创建产品税码以分配给产品和/或产品类别。导航至：会计或发票应用 >> 配置 >> AvaTax >> 产品税码。
您可以在此处添加、删除和修改产品税码。
Odoo 中的产品通常被分配到产品类别。AvaTax 设置也可以在创建产品类别时分配给产品类别。
创建新产品类别
导航至：库存 >> 配置 >> 产品 >> 产品类别
单击创建按钮
配置产品类别税码
在 AvaTax 属性下 >> 税码
选择所需的税码
用法
客户发票
AvaTax 模块集成到销售发票中并应用于每笔交易。AvaTax 仪表板中的交易日志显示发票详细信息，并显示交易是处于未提交状态还是已提交状态。
已验证的发票将具有已提交状态，已取消的发票将具有已作废状态。
模块会检查是否有选择的仓库，并会自动确定仓库的地址和原产地。如果没有为仓库分配地址，则使用公司地址。
在 Odoo 的设置中启用折扣时会处理折扣。在将总额发送到 AvaTax 之前，它们被计算为对行项目成本的净扣除。
创建新客户发票
导航至：会计或发票 >> 客户 >> 发票。
单击创建按钮。
验证发票
确保选中基于送货地址的税。
行项目应在税收下选择 AVATAX 以供内部记录。
要完成发票，请单击验证按钮。
销售订单现在将出现在 AvaTax 仪表板中。
注册付款
单击注册付款按钮以完成发票。
客户退款
Odoo 在其会计模块中应用退款而不是作废。与客户发票一样，AvaTax 模块与客户退款集成并应用于每笔交易。
- 将显示退款的发票交易
AvaTax 界面中的总计为负数。
发起客户退款
导航至：会计或发票 >> 客户 >> 发票
选择您要退款的发票
单击添加信用票据按钮
创建信用票据
在贷方方法下，选择创建草稿贷方通知单。
输入原因。
单击添加贷项通知单按钮。
注意：您将被带到信用票据列表视图
验证退款
选择您要验证的信用票据，查看，然后单击验证按钮。
注册退款支付
点击注册付款按钮完成退款
销售订单
AvaTax 模块集成到销售订单中并允许计算税款。销售订单交易不会出现在 AvaTax 界面中。
- 放置在销售订单中的信息将自动传递到发票
在 Avalara 服务器上，并且可以在 AvaTax 控制面板中查看。
在 Odoo 的设置中启用折扣时会处理折扣。它们将被报告为对行项目成本的净扣除。
创建新的销售订单
导航至：销售>>订单>>订单
单击创建按钮
使用 AvaTax 计算税收
该模块将在确认销售订单时计算税金，或者通过导航到操作 >> 使用 Avatax 更新税金。在此步骤中，销售订单将从 Avalara 检索税额，但不会将交易报告给 AvaTax 仪表板。只有发票、退款和付款活动会报告给仪表板。
模块会检查是否有选择的仓库，并会自动确定仓库的地址和原产地。如果没有为仓库分配地址，模块将自动使用公司地址作为其来源。位置代码将自动填充仓库代码，但可以根据需要进行修改。
已知问题/路线图
该模块的开发是由美国公司推动的，用于计算销售税。
但是 Avatax 服务支持更多用例，可以添加：
添加对欧盟增值税的支持
添加对美国购买/供应商账单使用税的支持
可以添加的其他改进：
如果客户状态不是当前帐户可用的关系，则检测并发出警告
错误追踪器
在GitHub 问题上跟踪错误。如果遇到问题，请检查您的问题是否已被报告。如果您首先发现它，请通过提供详细且受欢迎的 反馈来帮助我们粉碎它。
不要就技术问题的支持或帮助直接联系贡献者。
学分
贡献者
奥多公司
法布里斯·亨瑞恩
开源集成商 ( https://opensourceintegrators.com )
Daniel Reis< dreis @ opensourceintegrators 。com >
Bhavesh Odedra< bodedra @ opensourceintegrators 。com >
Sandip Mangukiya < smangukiya @opensourceintegrators 。com >
巨蛇 CS
穆尔图萨·萨利赫
索迪斯
阿楚坦·乌本德兰
其他学分
该模块最初由 Odoo SA 的 Fabrice Henrion 开发，并维护到版本 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。
odoo_addon_account_avatax_oca -15.0.2.0.0-py3-none-any.whl 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 5a8020a2d22d5d8a06818fa3430532e2ab6a28a41763f9f40650402ee3a878f0 |
|
| MD5 | 6fa7d21751e21bf8333a3824607fa41a |
|
| 布莱克2-256 | bd7d9283bfa3267387c55665b1868017a44c1075f6ed1ab921a0542f530b6ea1 |