AvaTax 整合功能

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

重要

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

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

重要

使用 AvaTax 進行稅務計算時,Odoo 有一些限制:

  • Odoo 的 POS 應用程式 不支援 AvaTax ,因為對於只有單一個送貨地址的交易而言(如商店或餐廳),無需使用動態稅款計算模型。

  • AvaTax 與 Odoo 使用的是公司地址,而 不是 倉庫地址。

  • 系統亦 不支援 部份商品(例如煙草、電子煙、燃料等行業)徵收的特殊稅費。

也參考

Avalara 的支援文件:關於 AvaTax

在 AvaTax 上設置

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

小訣竅

設置帳戶時,請留意 AvaTax 帳戶識別碼`(:guilabel:`Account ID)。在 Odoo 設定 內,需要使用該 ID。在 Odoo 中,此數字為 API ID

然後,建立一个基本的公司檔案

建立基本公司檔案

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

  1. 加入公司資訊

  2. 告訴我們公司收稅和繳稅的地區

  3. 核實管轄區及啟動公司.

  4. 加入其他公司地點,用作基於位置的申報

  5. 在公司檔案加入市集

連接至 AvaTax

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

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

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

備註

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

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

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

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

重要

將此密鑰複製至安全的地方。 強烈建議 為許可證密鑰製作備份,以供日後參考。請注意:離開此畫面後,將無法再查閱此密鑰。

Odoo 配置

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

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

會計國家/地區

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

Under the Taxes section, set the Fiscal Country feature to United States or Canada. Then, click Save.

公司設定

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

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

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

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

也參考

安裝模組

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

名稱

技術名稱

說明

Avatax

account_avatax

預設的 AvaTax 模組,加入 AvaTax 的基本計稅功能。

Avatax 銷售訂單

account_avatax_sale

包括在 Odoo 中計算銷售訂單稅款所需的資訊。

Avatax for Subscriptions

account_avatax_sale_subscription

This module includes the features required for tax calculation on subscriptions in Odoo.

Account Avatax - Ecommerce

website_sale_account_avatax

Includes tax calculation features for the checkout process on Odoo eCommerce.

Account AvaTax - Ecommerce - Delivery

website_sale_delivery_avatax

Includes tax calculation features for the delivery process on Odoo eCommerce.

Click the Install button on the module labeled Avatax: account_avatax. Doing so installs the following modules:

  • Avataxaccount_avatax

  • Avatax 銷售訂單account_avatax_sale

  • Account Avatax - Ecommerce: website_sale_account_avatax

Should AvaTax be needed for Odoo Subscriptions, or for delivery tax in Odoo eCommerce, then install those modules individually by clicking on Install.

Odoo AvaTax 設定

To integrate the AvaTax API with Odoo, go to Accounting app ‣ Configuration ‣ Settings section. The AvaTax fields in the Taxes section is where the AvaTax configurations are made and the credentials are entered in.

配置 Avatax 設定

先決條件

首先,選擇公司希望使用 AvaTax環境:可以是 沙盒正式運行

也參考

如在決定使用哪種 AvaTax 環境(正式運行沙盒)方面需要協助,請參閱: 沙盒與正式運行環境比較

授權認證

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

重要

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

要訪問 許可證密鑰 請參閱此文檔: 連接至 AvaTax

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

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

AvaTax 公司代碼突出顯示在公司詳細信息頁面上。

交易選項

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

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

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

地址驗證

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

重要

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

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

重要

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

保存 設置以執行配置。

小訣竅

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

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

在 Odoo 中彈出的驗證地址視窗中,「保存已驗證」 按鈕和 「已驗證 地址」 突出顯示。

警告

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

測試連線

將上述所有信息輸入 Odoo 上的 AvaTax 設定後,點擊 測試連接。這將確保 API IDAPI 密鑰 正確無誤,並在 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 類別,具體取決於所選的路線。