巴西¶
簡介¶
透過巴西本地化，可以自動計算銷售稅，並可以透過 API 呼叫使用 AvaTax (Avalara) 發送商品 (NF-e) 和服務 (NFS-e) 的電子發票。此外，還可以配置服務稅。
對於商品和服務稅計算和電子發票流程，您需要配置 聯絡人、公司、產品，以及 在 AvaTax 中建立一個帳戶，此操作需要在一般設定中進行配置。
對於服務稅，你可直接從 Odoo 建立和配置它們，而無需使用 AvaTax 進行計算。
本地化套裝還包括稅項及會計賬目總表範本，可根據需要進行修改。
也參考
Links to helpful resources for the Brazilian localization, including onboarding materials and videos:
配置¶
模組安裝¶
安裝 以下模組，以獲得巴西本地化的所有功能：
名稱 |
技術名稱 |
說明 |
|---|---|---|
巴西 - 會計 |
|
預設的 財政本地化功能套裝，此套裝表示擁有通用巴西會計科目表和稅收，以及文件類型和識別類型。 |
巴西 - 會計報告 |
|
巴西的會計報告。 |
AvaTax 巴西 及 AvaTax 巴西 - 服務 |
|
透過 Avalara 計算商品和服務稅。 |
巴西會計 EDI 及 巴西會計 EDI - 服務 |
|
透過 AvaTax 為巴西提供商品和服務的電子發票。 |
巴西 Pix 二維碼 |
|
為巴西市場實施 Pix 二維碼。 |
配置你的公司¶
要設定你的公司資訊，請前往 應用程式，並搜尋為你公司指定的名稱。
選擇頁面頂部的 公司 選項，然後配置以下欄位：
名稱
地址：加入 城市、州/省、郵遞區號、國家/地區
在 街道 欄位中，輸入街道名稱、門牌號碼及其他地址資訊。
在 街道第二行 欄位中，輸入分區名稱。
識別號碼：CNPJ 或 CPF
稅務識別號：與識別類型相關
IE：州/省註冊
IM：市級登記
SUFRAMA 編碼：馬瑙斯自由貿易區監管 - 如適用可加入
電話
電郵
在 銷售及採購 分頁中，配置 財務資訊：
加入 AvaTax 巴西 適用的 財務規則。
稅務制度：聯邦稅務制度
ICMS 納稅人類型：表示 ICMS 制度、豁免地位，或 非納稅人
主要活動行業
如果您要發行 NFS-e，請配置以下額外的 財務資訊：
加入 AvaTax 巴西 適用的 財務規則。
COFINS 詳細資訊：應課稅、非課稅、應稅稅率為 0%、豁免繳稅、暫停繳稅
PIS 詳細資訊：應課稅、非課稅、應稅稅率為 0%、豁免繳稅、暫停繳稅
CSLL 應納稅：公司是否受 CSLL 監管.
最後，上載公司標誌，並儲存聯絡人。
備註
如果您使用簡化製度，則需要在 下，設定 ICMS 稅率。
配置 AvaTax 整合¶
Avalara AvaTax 是一個稅項計算及電子發票服務商，可以整合至 Odoo，透過考慮公司、聯絡人（即客戶）、產品及交易資訊，自動計算稅項，從而找出要使用的正確稅項，然後處理向政府開立電子發票。
使用此整合功能，需要使用 應用程式內購買（IAP） 去計算稅費並發送電子發票。每當您計算稅款、發送電子文檔（NF-e、NFS-e 等）或執行任何電子流程（NF-e 取消、更正信、無效發票編號範圍）時，都會使用您 IAP點數餘額 的點數，進行 API 呼叫。
備註
Odoo 是 Avalara 巴西的已認證合作夥伴。
创建时，新数据库可免费获得 500 点数。
憑證配置¶
要在 Odoo 中啟動 AvaTax，您需要建立一個帳戶。為此，請前往 ，然後在 AvaTax 巴西 部分中，在 AvaTax 門戶電郵 中，新增用於 AvaTax 門戶網站的管理電子郵件地址，然後按一下 建立帳戶。
警告
在沙盒或生產資料庫中 測試 或 建立正式運行 的 AvaTax 門戶電郵 整合時，請使用真實的電子郵件地址，因為需要登入 Avalara 門戶網站，並設定證書，無論您是想測試還是在正式運行環境中使用。
有兩種不同的 Avalara 門戶，一種用於測試，一種用於正式運行：
當您從 Odoo 建立帳戶時，請務必選擇正確的環境。此外，用於開立帳戶的電子郵件不能用於開設其他帳戶。當您從 Odoo 建立帳戶時，請儲存您的 API ID 和 API 密鑰。
在 Odoo 建立帳戶後，你需要前往 Avalara 門戶網站設定密碼：
進入 Avalara 門戶網站。
按一下 Meu primeiro acesso。
在 Odoo 中新增您用於建立 Avalara/AvaTax 帳戶的電子郵件地址，然後按一下 Solicitar Senha。
你將會收到一封電子郵件，其中包括登入權杖及建立密碼的連結。按一下此連結，並複製及貼上該權杖，以設定你想使用的密碼。
小訣竅
若未建立密碼或在 Odoo 資料庫中存取 Avalara 門戶網站，你 只可 在 Odoo 內使用 AvaTax 進行稅項計算。不過，若要使用電子發票服務，你 必須 存取 AvaTax 門戶網站，並在該處上載你的登入憑證。
備註
你可轉移 API 憑證。請只在你已於另一個 Odoo 安裝個體建立了帳戶，並希望重複使用時，才使用此選項。
上載 A1 證書¶
要開立電子發票，你須將憑證上載至 AvaTax 門戶網站。
只要 AvaTax 門戶網站中的外部識別碼與 CNPJ 號碼相符（不計特殊字元），而且 Odoo 中的識別號碼（CNPJ）與 AvaTax 中的 CNPJ 相符，證書便會自動與 Odoo 同步。
重要
要頒發 NFS-e，某些城市要求您在從 Odoo 頒發 NFS-e 之前先在城市門戶系統中，連結證書。
如果您收到來自城市的錯誤訊息，顯示 您的憑證未連結到使用者，則表示此過程需要在城市入口網站中完成。
配置主數據¶
賬目總表¶
賬目總表 預設會作為本地化模組所包含資料集的一部份去安裝。帳戶會自動配對至對應的稅項以及預設的應付款項及應收款項欄位。
備註
巴西賬目總表是建基於 SPED 的賬目總表，它提供了巴西市場所需的基礎帳戶。
你可根據公司的需求，新增或刪除帳戶。
日記賬¶
在巴西， 系列 編號與電子發票的序號範圍相關聯。系列號碼可在 Odoo 內銷售日記賬的 系列 欄位設定。如果需要使用多個系列，便需要為所需的每個系列建立一個新的銷售日記賬，再向其分配一個新的系列號碼。
需要選取 使用文件 欄位。開立電子或非電子發票時，類型 欄位會選擇建立發票時使用的文件類型。只有在日記賬選擇了 使用文件 欄位時，才會顯示 類型 欄位。
備註
建立日記賬時，請確保不要選取 專用貸記單序列 欄位，因為在巴西，發票、貸記單及借記單的序列，是按每個序列號碼（即每個日記賬）共用。
稅項¶
安裝巴西本地化套裝時，會自動建立稅項。稅項已經配置，部份會在計算銷售訂單或發票稅項時，由 Avalara 使用。
稅項可以編輯，也可加入更多稅項。例如，一些用於服務的稅項需要手動新增及配置，因為稅率可能會根據提供服務的城市而有所不同。
重要
如果您決定手動繳納服務稅，您將無法簽發 NFS-e。要以電子方式發送 NFS-e，您需要使用 Avalara 計算稅費。
警告
請不要刪除稅項，因為它們會用於 AvaTax 稅項計算。如果刪除，Odoo 會在銷售訂單（SO）或發票使用這些稅項時，再次建立它們，並使用 AvaTax 計算稅項。不過，你需要重新配置用作記錄稅項的賬戶，方法是在稅項的 定義 分頁內，在 發票分配 及 退款分配 部份下，執行此操作。
也參考
產品¶
若要在銷售訂單和發票上使用 AvaTax 集成，請先根據產品的預期用途指定產品的下列資訊：
貨物電子發票 (NF-e)¶
CEST 代碼：需進行 ICMS 稅替代的產品代碼
Mercosul NCM 代碼：南方共同市場通用命名法產品代碼
原產地：表示產品的原產地，可以是國外或國內，以及其他可能的選項，取決於具體用例
SPED 財政產品類型：根據 SPED 清單的財政產品類型
使用目的：指定本產品的預期使用目的
備註
Odoo 會自動建立三種產品，處理銷售相關的運輸成本，分別稱為 運費、保險 及 其他成本。它們已經配置好，如果需要建立更多，可複製並使用相同的配置（所需配置為：產品類型、服務、運輸成本類型、保險、運費 或 其他成本）。
服務電子發票 (NFS-e)¶
Mercosul NCM 代碼：南方共同市場通用命名法產品代碼
使用目的：指定本產品的預期使用目的
服務代碼來源：提供者註冊的城市服務代碼
服務代碼：提供服務的城市服務代碼，如果不新增代碼，將使用始發城市代碼
勞動力分配：定義您的服務是否包含勞動力
聯絡人¶
使用整合功能前，請為聯絡人設定以下資訊：
有關聯絡人的一般資訊：
對於擁有稅務識別碼（CNPJ）的聯絡人，請選擇 公司 選項；擁有 CPF 的聯絡人，則選取 個人。
名稱
地址：加入 城市、州/省、郵遞區號、國家/地區
在 街道 欄位中，輸入街道、門牌號碼及其他地址資訊。
在 街道第二行 欄位中，輸入分區名稱。
識別號碼：CNPJ 或 CPF
稅務識別號：與識別類型相關
IE：州或省級稅務識別號
IM：市級稅務識別號
SUFRAMA 代碼：SUFRAMA 註冊號碼
電話
電郵
備註
除非 國家/地區 設為
巴西，否則 CPF、IE、IM 及 SUFRAMA 代碼 欄位都不會顯示。在 銷售及採購 分頁下，有關聯絡人的財政資訊：
財務規則：加入 AvaTax 財務規則，以自動計算銷售訂單及發票的稅項
稅制：聯邦稅制
ICMS 納稅人類型：納稅人類型，決定聯絡人是否屬於 ICMS 制度、豁免身分 或 非納稅人
主要活動行業：聯絡人主要活動行業的清單
如果您要發行 NFS-e，請配置以下額外的 財務資訊：
加入 AvaTax 巴西 適用的 財務規則。
COFINS 詳細資訊：應課稅、非課稅、應稅稅率為 0%、豁免繳稅、暫停繳稅
PIS 詳細資訊：應課稅、非課稅、應稅稅率為 0%、豁免繳稅、暫停繳稅
CSLL 應納稅：公司是否受 CSLL 監管.
財務規則¶
要計算稅項並發送銷售訂單及發票的電子發票，需要在 財務規則 中，啟用 自動偵測 及 使用 AvaTax API 選項。
財務規則 可以在 聯絡人 上配置，也可以在建立銷售訂單或發票時選擇。
工作流程¶
本節概述觸發 API 呼叫 進行稅務計算的操作，以及有關如何發送貨物 (NF-e) 和服務 (NFS-e) 電子發票以供政府驗證的說明。
警告
請注意，每次 API 呼叫都會產生費用。請留意觸發這些呼叫的操作，以有效管理成本。
稅項計算¶
報價單及銷售訂單的稅務計算¶
你可透過下列任何方式觸發 API 呼叫，以使用 AvaTax 自動計算報價單或銷售訂單的稅項：
- 確認報價單
確認報價單，將之轉換為銷售訂單。
- 手動觸發
按一下 使用 AvaTax 計算稅項。
- 預覽
按一下 預覽 按鈕。
- 以電郵發送報價單/銷售訂單
透過電子郵件，向客戶發送報價單或銷售訂單。
- 網上存取報價單
客戶在網上存取報價單時（經客戶頁面檢視畫面），會觸發 API 呼叫。
發票稅項計算¶
透過以下任一方式觸發 API 呼叫，使用 AvaTax 自動計算客戶發票的稅金：
- 手動觸發
按一下 使用 AvaTax 計算稅項。
- 預覽
按一下 預覽 按鈕。
- 網上存取發票
當客戶在線(通過門戶視圖)訪問發票時，就會觸發 API 調用。
備註
必須將 財務規則 設為 自動稅收映射(Avalara Brazil)，這些操作才能自動計算稅款。
電子文件¶
客戶發票¶
要處理貨物 (NF-e) 或服務 (NFS-e) 的電子發票，發票需要由 Avalara 確認併計算稅費。完成該步驟後，按一下左上角的 傳送並列印 按鈕。在出現的彈出視窗中，按一下 處理電子發票 和任何其他選項 - 下載 或 電子郵件。最後，按一下 發送並列印 以向政府處理發票。
在發送貨物 (NF-e) 或服務 (NFS-e) 電子發票之前，需要在發票上填寫一些欄位：
客戶，包含所有客戶資訊
付款方式：巴西：打算如何支付發票款項
財務規則 設置為 自動稅收映射(Avalara 巴西) 。
文件類型：設定為 (55) 電子發票 (NF-e) 或 (SE) 電子服務發票 (NFS-e)
這些是根據交易性質而定的一些可選欄位。這些字段不是必填欄位，因此在大多數情況下，如果不填入這些可選欄位，不會顯示政府錯誤。
貨運模式,決定了計劃運輸貨物的方式-國內運輸
巴西運輸商:決定由誰進行運輸
備註
如果需要，用於開立電子發票的發票上的所有欄位，也可在銷售訂單上使用。建立第一張發票時，會顯示 文件號碼 欄位，並將其分配為第一個編號, 在後續發票中按順序使用。
貸記單¶
如果需要登記銷售退貨，則可在 Odoo 中建立貸記單，發送給政府進行驗證。
備註
貸記單僅適用於貨物電子發票 (NF-e)。
也參考
借記單¶
如果需要提供更多資訊，或需要更正原始發票中未準確提供的價值，可發出借記單。
備註
借記單僅適用於貨物電子發票 (NF-e)。
只有原始發票中包含的產品才能成為借記單的一部份。雖然可以更改產品單價或數量，但 不可 將產品加入至借記單中。本文件的目的僅是聲明您要向原始發票添加的金額, 用於相同數量或更少的產品。
取消發票¶
你可註銷已經由政府驗證的電子發票。
備註
檢查電子發票是否仍在取消期限內。各州/省的法律規定可能有所不同。
貨物電子發票 (NF-e)¶
要在 Odoo 中取消貨物電子發票 (NF-e)，方法是按一下 請求取消，並在出現的彈出視窗中新增取消 原因。如果您想透過電子郵件將此取消原因傳送給客戶，請選取 電子郵件 勾選方格。
備註
這是一種電子取消，意味 Odoo 將向政府發送取消 NF-e 的請求，然後在發生 API 呼叫時，消耗一個 IAP 點數。
服務電子發票 (NFS-e)¶
透過點選 請求取消 取消 Odoo 中的服務電子發票 (NFS-e)。在這種情況下，沒有電子取消流程，因為並非每個城市都提供此服務。用戶需要在城市入口網站上手動取消此NFS-e。完成該步驟後，他們可以在 Odoo 中請求取消，這將取消發票。
更正信函¶
可以建立更正信並將其連結到經政府驗證的電子貨物發票 (NF-e)。
在 Odoo 中點擊 更正信函 並在彈出的窗口中，加入更正 原因 即可。要通過電子郵件將更正原因發送給客戶,請啟動 電郵 勾選方格。
備註
更正信僅適用於貨物電子發票 (NF-e)。
將發票號碼範圍設為無效¶
已分配予銷售日記賬的序號範圍，如果目前未有使用， 而且確定 將來也不會使用，可通知政府將其設為無效。要執行此操作，請前往相關日記賬，按一下 。在 號碼範圍設為無效（巴西） 精靈中，加入要取消範圍的 起首編號 及 結束編號，然後輸入設為失效的 原因。
備註
無效發票編號範圍文件僅適用於貨物電子發票 (NF-e)。
備註
被取消的編號以及 XML 文件，會記錄在日記賬的聊天視窗中。
供應商賬單¶
至於供應商賬單，收到供應商發票時，你可在 Odoo 內為賬單編碼，方法是將所有商業資訊，以及與 客戶發票 上的記錄相同的巴西市場適用資訊，一起加入至賬單中。
所謂巴西市場適用資訊，相關欄位如下：