跳至內容

如何在 Odoo 設定地址格式?

依國家調整報表地址順序,附台灣地址設定範例。

在地化 · ODOO

不同國家的地址書寫順序不同。台灣通常先寫縣市,再寫鄉鎮市區與街路門牌;美國地址則通常先寫街道,再寫城市、州與郵遞區號。Odoo 可依聯絡人的國家,調整報表上的地址格式。

修改前,先確認目前的國家設定

Odoo 原生的地址顯示方式,會採用聯絡人所選國家的地址格式;沒有可用的國家格式時,才使用標準排列方式。在地化模組或先前的設定,可能已經調整過格式,因此應先檢查目前內容,不能認定每個資料庫的排列都相同。

這項設定只改變地址的顯示方式,不會改寫聯絡人的街道、城市、州/省或郵遞區號。國家資料通常由同一資料庫內的各家公司共用,修改後可能影響不只一家公司使用的報表。

在哪裡設定報表的地址格式?

  1. 具備設定權限後,開啟「聯絡人 → 設定 → 在地化 → 國家」(Contacts → Configuration → Localization → Countries)。實際選單位置可能依已安裝的應用程式與權限有所不同。
  2. 開啟要調整的國家,例如台灣,查看「報表中的版面配置」(Layout in Reports)。若也需要檢查「輸入檢視」(Input View)等技術欄位,可啟用開發者模式。
  3. 修改前先備份原本的格式,再依報表需求調整支援的欄位代碼與換行,確認後儲存設定。
  4. 確認測試聯絡人的國家與地址欄位正確,再重新產生使用原生地址元件的報價單、發票或出貨報表。
  5. 分別檢查帳單地址、送貨地址與公司地址,也要確認其他語言與共用同一國家設定的公司是否受到影響。
Odoo 台灣國家設定表單,顯示報表版面配置與輸入檢視欄位
開發資料庫中的台灣國家設定表單。截圖使用英文介面,擷取時未更動任何國家設定。

常用地址欄位代碼

請保留範例中的代碼語法:欄位名稱放在括號內,後方接小寫 s。不要將代碼中的欄位名稱改成中文標籤。

國家地址格式可使用的常見欄位
欄位代碼用途
%(country_name)s國家名稱
%(country_code)s兩碼國家代碼,例如 TW
%(state_name)s州/省名稱;台灣可用來存放縣市
%(state_code)s州/省代碼,不一定是完整名稱
%(city)s城市欄位;台灣可依資料規劃存放鄉鎮市區
%(zip)s郵遞區號
%(street)s街路門牌地址
%(street2)s地址第二行

台灣地址格式範例

如果資料一致地將縣市放在「州/省」、鄉鎮市區放在「城市」,其餘地址放在「街道」,可以參考以下排列方式。這是設定範例,不是強制的國家標準,仍應依郵寄與單據需求調整。

如果州/省選單尚未建立台灣縣市,請先由管理員建立屬於台灣的縣市資料。聯絡人未填寫或選取的縣市名稱,不會只因修改地址格式就自動出現。

%(zip)s %(state_name)s%(city)s%(street)s
%(street2)s
%(country_name)s

假設示範資料的郵遞區號為 100、州/省為「臺北市」、城市為「中正區」、街道為「範例路 1 號」、地址第二行為「5 樓」,且國家名稱以中文顯示,地址部分會呈現如下:

100 臺北市中正區範例路 1 號
5 樓
台灣

以上是示意資料,並非真實投遞地址,請為每位聯絡人填入正確的郵遞區號。避免在不同欄位重複填入縣市或鄉鎮市區,也要測試地址第二行留空的情況。公司或聯絡人名稱可能由報表另外顯示,加入地址格式前,應先確認是否會重複。

報表排列與輸入表單,是不同的設定

「報表中的版面配置」控制原生地址的顯示方式;「輸入檢視」則指定聯絡人表單的檢視,調整地址欄位的輸入方式。修改報表格式,不會自動重排輸入欄位、增加鄉鎮市區選單,或驗證郵遞區號,這些需求要另外處理。

中文與英文地址,要分開考慮

一筆國家資料只有一組報表地址格式,並不是每種語言各有一組。報表的語言設定可以影響已翻譯的國家名稱,但不會自動將中文街道或鄉鎮市區轉成英文郵寄地址。地址排列與地址翻譯,是不同的需求。

如果同時需要國內使用的中文單據,以及給海外收件人的英文單據,應先規劃兩種地址如何儲存,以及各報表何時使用哪一種。只修改國家的地址格式,不一定能滿足這個需求。

為什麼報表仍是原本的順序?

  • 確認報表實際使用的是哪一筆資料:客戶、帳單地址、送貨地址,還是自己的公司。
  • 檢查聯絡人的國家是否正確,以及地址欄位是否依約定的方式填寫。
  • 重新產生報表,不要只開啟先前儲存的 PDF;部分報表會沿用已儲存的附件。
  • 檢查客製化 QWeb 報表與外部物流串接。若範本直接列印個別欄位,或介面自行組合地址字串,就不一定會採用國家的報表地址格式。

單純調整地址順序,可先使用原生的國家設定。若還需要中英文地址、鄉鎮市區主檔,或物流商專用標籤,則應一併評估資料欄位、報表與串接方式。

與 RichSoda 討論地址與報表在地化需求

參考資料: Odoo 國家地址格式欄位; 原生聯絡人地址顯示邏輯; 聯絡人設定選單.

如何在 Odoo 設定欄位預設值?
善用 Odoo 原生預設值,減少重複輸入。