AvaTax 整合功能

Avalara 的 AvaTax 是一款基於雲端的稅務軟體。當使用者在 Odoo 中銷售、購買商品並開立發票時， AvaTax 與 Odoo 的整合功能可提供即時及特定區域的稅務計算。所有聯合國會員國家都支援 AvaTax 稅務計算，包括跨境交易。

重要

AvaTax is only available for integration with databases/companies that have locations in the United States, Canada, and Brazil. This means the fiscal position/country of a database can only be set to the United States, Canada, or Brazil. For more information, reference this documentation: 財政國家/地區.

AvaTax 考慮了各省/州、市、縣基於地理位置的稅率。它通過密切關注法律、規則、管轄範圍和特殊情況（如免稅期和產品免稅），以提高匯款的準確性。與 AvaTax 整合的公司可利用這種簡單的 API 整合，保持對內部稅收計算的控制。

重要

在使用 AvaTax 进行税务计算时，Odoo 存在一些限制：

• AvaTax 默认使用公司地址。要使用仓库地址，请在 POS 应用程序设置中启用 允许稍后发货 。

• **不支持**对某些特定商品（如烟草、燃料等）征收的补充税费。

也參考

Avalara 的支持文档：关于 AvaTax

在 AvaTax 上設置

要使用 AvaTax ，你需要在 Avalara 開設帳戶進行設置。如果尚未建立帳戶，請與 Avalara 聯絡，購買許可證：Avalara：和我們談談。

小訣竅

Upon account setup, take note of the AvaTax Account ID. This will be needed in the Odoo setup. In Odoo, this number is the API ID.

然后，创建基本的公司简介。

建立基本公司檔案

為下一步收集必要的企業詳細資料：徵稅地區、銷售的產品/服務（及其銷售地點）以及客戶免稅情況（如適用）。按照 Avalara 的使用說明，建立基本公司檔案：

1. 添加公司信息.

2. 告诉我们公司在哪里收税和缴税。

3. 验证税务辖区并激活公司。

4. 添加其他营业场所实现分地区申报。

5. 在公司简介中添加市场。

連接至 AvaTax

在 Avalara 中建立基本公司檔案後，連線至 AvaTax 。此步驟會雙向連接 Odoo 及 AvaTax 。

前往 Avalara 的 沙盒 或 正式運行 環境（視乎公司希望整合哪種類型的 Avalara 帳戶）。

也參考

Avalara 中的沙盒與正式運行環境。

登入以建立 許可證密鑰。前往 設定 ‣ 許可證及 API 密鑰。按一下 產生許可證密鑰。

重要

系統會顯示警告提示：如果你的商業應用程式已連接至 Avalara 解決方案，該連接將會中斷，直至你使用新的許可證密鑰更新應用程式。此操作無法還原。

產生新的許可證密鑰，會中斷與使用 AvaTax 整合功能的現有商業應用程式的連接。請確保使用新的許可證密鑰，更新這些應用程式。

若是首次進行 AvaTax 與 Odoo 之間的 API 整合，請按一下 產生許可證密鑰。

若是額外的許可證密鑰，請確保可以斷開之前的連接。每個 Avalara 沙盒或正式運行帳戶， 只能有 一個已關聯的許可證密鑰。

警告

将此密钥复制到安全的地方。强烈建议备份许可证密钥，以备将来参考。离开此屏幕后将**无法**检索此密钥。

Odoo 配置

使用 AvaTax 之前，還需要在 Odoo 中進行一些額外配置，以確保稅務計算準確。

請驗證 Odoo 資料庫是否已有需要的數據。資料庫初始設定的國家/地區會決定財務規則，並幫助 AvaTax 計算準確的稅率。

財政國家/地區

要設定 財政國家/地區，請前往 會計應用程式 ‣ 配置 ‣ 設定。

也參考

財政本地化功能

在 稅務 部分，將 財政國家/地區 項目設為 美國、加拿大 或 巴西，然後按一下 儲存。

公司設定

以 Odoo 資料庫運行的所有公司，都應在設定中設置完整的地址。請前往 設定應用程式，在 公司 部分下，確保只有一家公司在運行 Odoo 資料庫。按一下 更新資訊，以開啟更新公司詳細資料的獨立頁面。

如果資料庫內有多間公司，請按一下 管理公司，以載入公司列表供選擇。按一下需要設定的公司，然後更新公司資料。

資料庫管理員應確保公司的 街道⋯、街道第二行⋯、城市、州/省、郵遞區號 及 國家/地區 都是最新資料。

這樣可確保稅務計算準確，以及年終會計操作順暢。

也參考

• 公司

• 開始

安裝模組

之後，要確保已安裝 Odoo AvaTax 模組。要執行此操作，請前往 應用程式。在 搜尋⋯ 列中，輸入 avatax，然後按 Enter 鍵。系統會顯示以下結果：

名稱	技術名稱	說明
Avatax	account_avatax	預設的 AvaTax 模組，加入 AvaTax 的基本稅務計算功能。
Avatax 地理定位	account_avatax_geolocalize	此模組包括將 AvaTax 整合至 Odoo 地理定位所需的功能。
Avatax 銷售訂單	account_avatax_sale	包括在 Odoo 中計算銷售訂單稅款所需的資訊。
Avatax 庫存	account_avatax_stock	包括 Odoo 庫存中的稅務計算。
Amazon/Avatax 橋接	sale_amazon_avatax	包括 Amazon 連接器 與 Odoo 之間的稅務計算功能。
Avatax 巴西	l10n_br_avatax	包括巴西本地化中的稅務計算資料。
Avatax 巴西 - 服務	l10n_br_avatax_services	此模組包括巴西本地化中，服務稅款計算所需的功能。
Avatax 巴西 - 銷售服務	l10n_br_edi_sale_services	此模組包括巴西本地化中，銷售服務稅務計算所需的功能，包括電子數據交換（EDI）。
AvaTax 巴西 - 測試銷售訂單	l10n_br_test_avatax_sale	此模組包括巴西本地化中，測試銷售訂單所需的功能。

在標示為 Avatax：account_avatax 的模組上，按一下 安裝 按鈕。這樣做會安裝以下模組：

• Avatax：account_avatax

• Avatax 銷售訂單：account_avatax_sale

• Avatax 庫存：account_avatax_stock

如果需要 AvaTax 用作地理定位，或與 Amazon 連接器 一起使用，請分別按一下 安裝 上的 Avatax 地理定位 或 Amazon/Avatax 橋接，以單獨安裝這些模組。

也參考

有關個別本地化功能的 AvaTax 指引，請查看以下的 財政本地化 使用說明：

• 巴西

• 美國

Odoo AvaTax 設定

要將 AvaTax API 與 Odoo 整合，請前往 會計應用程式 ‣ 配置 ‣ 設定 部分。在 稅項 部分中的 AvaTax 欄位，是為 AvaTax 進行配置及輸入憑證的地方。

首先，勾選 AvaTax 設定左側的方格，以在資料庫上啟動 AvaTax 。這是在 Odoo 資料庫上啟用及停用 AvaTax 稅務計算的快速、便捷方法。

先決條件

首先，選擇公司希望使用 AvaTax 的 環境：可以是 沙盒 或 正式運行。

也參考

如在決定使用哪種 AvaTax 環境（正式運行 或 沙盒）方面需要協助，請參閱： 沙盒與正式運行環境比較。

憑證

現在可以輸入憑證。API ID 欄位應輸入 AvaTax 帳戶識別碼`（ID）；:guilabel:`API 密鑰 欄位應輸入 許可證密鑰。

重要

登入 AvaTax 門戶網站（沙盒 或`正式運行 <https://admin.avalara.com/>`_）可找到 帳戶 ID。在右上角，點擊用戶首字母和 帳戶。首先列出的是 帳戶 ID。

To access the License Key see this documentation: 連接至 AvaTax.

在 公司代碼 欄位中，輸入所配置公司的 Avalara 公司代碼。如果未設定，Avalara 將其解釋為 預設。可以在 Avalara 管理門戶訪問 公司代碼。

首先，登入 *AvaTax*門戶網站（沙盒 或`正式運行 <https://admin.avalara.com/>`_）。然後，導航至 設置 ‣ 管理公司。公司代碼 值位於 公司 行中的 公司代碼 列。

交易選項

Odoo AvaTax 設定中有兩個交易設置可以配置：使用 UPC`和:guilabel:`承諾交易。

如果勾選了 使用 UPC 旁邊的勾選方格，交易將使用通用產品代碼（UPC），而不是 Avalara 中自定義的代碼。有關具體指導，請咨詢註冊會計師（CPA）。

如果勾選 承諾交易 勾選方格，Odoo 資料庫中的事務將被提交到 AvaTax 中進行報告。

地址驗證

地址驗證 功能可確保在 Odoo 中為聯絡人設置符合郵政標準的最新地址。這對於為客戶提供準確的稅款計算非常重要。

重要

地址驗證 功能只適用於北美地區的合作夥伴/客戶。

此外，請勾選 地址驗證 欄位旁邊的勾選方格。

重要

為了準確計算稅款，最佳做法是為數據庫中保存的聯絡人輸入完整的地址。然而，AvaTax 仍可通過僅使用 國家/地區、省/州 和 郵編代碼 來盡力嘗試。這是三個最基本的必填欄位。

保存 設置以執行配置。

小訣竅

手動 驗證 地址，方法是導航到 聯絡人應用程序 並選擇聯絡人。既然 AvaTax 模塊已在數據庫中配置，驗證 按鈕就會出現在 地址 的正下方。

點擊 驗證，彈出一個視窗，列出 驗證地址 和 原始地址。如果:guilabel:已驗證地址`是正確的稅務郵寄地址，請點擊 :guilabel:`保存已驗證地址。

警告

之前在 Odoo 資料庫中輸入的所有聯絡人地址都需要使用上述手動驗證流程進行驗證。如果地址是以前輸入的，則不會自動驗證。只有在計稅時才會進行驗證。

測試連線

將上述所有信息輸入 Odoo 上的 AvaTax 設定後，點擊 測試連接。這將確保 API ID 和 API 密鑰 正確無誤，並在 Odoo 和 AvaTax 應用程序編程接口（API）之間建立連接。

同步參數

完成 AvaTax 部分的配置和設定後，點擊 同步參數 按鈕。此操作將同步 AvaTax 中的豁免代碼。

財務規則

接下來，導航至 會計應用程式 ‣ 配置 ‣ 會計：財務規則。列出一個 財務規則 名稱為 自動稅收映射（AvaTax）。點擊它以打開 AvaTax 的 財務規則配置頁面。

在此，確保選取 使用 AvaTax API 勾選方格。

可選擇勾選標有 自動檢測 欄位旁邊的勾選方格。如果勾選此選項，Odoo 將自動為 Odoo 中的交易應用此 財務規則。

啟用 自動檢測 還可顯示特定參數，如 需要增值稅、外國稅號、國家/地區組、國家/地區、聯邦州/省 或 郵編範圍。填寫這些參數可篩選 財務規則 的使用。將它們留空可確保所有計算都使用該 財務規則。

警告

如果未勾選 自動檢測 勾選方格，則每個客戶都需要在聯絡人記錄的 銷售和採購 選項卡上設置 財務規則。要執行此操作，請導航至 銷售應用程序 ‣ 訂單 ‣ 客戶 或 聯絡人應用程式 ‣ 聯絡人。然後，選擇要設置財務規則的客戶或聯絡人。

導航至 銷售和採購 選項卡，並向下導航至標有 財務規則 的部分。將 財務規則 欄位設置為客戶的財務規則。

也參考

財務規則（稅項及賬戶配對）

AvaTax 帳戶

選擇 使用 AvaTax API 勾選方格選項後，會出現一個新的 AvaTax 選項卡。點擊該選項卡可顯示兩個不同的設定。

第一個設定是 AvaTax 發票賬戶，第二個設置是 AvaTax 退稅賬戶。確保兩個賬戶都已設定，以便順利保存年終記錄。有關設置這兩個賬戶的具體指導，請咨詢註冊會計師（CPA）。

點擊 保存 以執行更改。

稅項配對

AvaTax 整合功能適用於銷售訂單和發票，並包含 AvaTax* 財務規則。

小訣竅

此外，在 自動稅項配對（AvaTax） 財務規則中，還有 稅項配對 分頁及 賬戶配對 分頁，該處也可配置產品配對。要存取 財務規則，請前往 會計應用程式 ‣ 配置 ‣ 會計：財務規則。

產品類別配對

使用整合前，請在產品類別中指定 Avatax 類別。導航至 庫存應用程式 ‣ 配置 ‣ 產品類別。選擇要添加 AvaTax 類別 的產品類別。在 AvaTax 類別 字段，從下拉菜單中選擇一個類別，或 搜索更多… 打開完整的選項列表。

產品配對

也可在單個產品上設置 AvaTax 類別。要設定 Avatax 類別，請訪問 庫存應用程序 ‣ 產品 ‣ 產品。選擇要添加 Avatax 類別 的產品。在 一般信息 選項卡的最右側，有一個標有：Avatax 類別 的選擇器欄位。最後，點擊下拉菜單，選擇一個類別，或 搜索更多… 查找未列出的類別。

備註

如果產品及其類別都設定了 AvaTax 類別，則產品的 AvaTax 類別 優先。

重要

应根据所选路径，为每个 产品 或 产品类别 完成在 产品 或 产品类别 上映射 AvaTax 类别。

也參考

• 財務規則（稅項及賬戶配對）

• 使用 AvaTax

• Avalara (Avatax) 门户网站

• 美國稅務合規：Avatax 線上學習影片

• 使用 AvaTax
• Avalara (Avatax) 门户网站