feat: Thai language for every customization

- translations/th.csv: custom field labels, messages, print format and
  letter head text, the 22 Tax Withholding Category names; overrides the
  upstream Thai for the standard labels the print formats show
- print formats embed Sarabun (public/fonts, OFL) so PDFs render Thai on
  servers without a Thai font
- letter head labels go through _()
- withholding row description is translated when stored
- in_words: Thai "...บาทถ้วน" wording via num2words when the language is
  Thai (ThaiSalesInvoice.set_total_in_words); print formats re-derive it
  in the print language (get_in_words)
- fixture `modified` bumped so migrate re-imports the changed documents

README.md

@@ -12,6 +12,14 @@ bench get-app $URL_OF_THIS_REPO --branch develop
 bench install-app default_thai_company
 ```
 
+### Thai language
+
+Every string the app adds (custom field labels, messages, print format and letter head
+text, Tax Withholding Category names) is translated in `translations/th.csv`; the same
+file overrides the upstream Thai for the standard labels the print formats show. The
+print formats embed Sarabun (`public/fonts`, OFL) so PDFs render Thai on servers
+without a Thai system font. Switch a user or the print language to `th` to use it.
+
 ### Contributing
 
 This app uses `pre-commit` for code formatting and linting. Please [install pre-commit](https://pre-commit.com/#installation) and enable it for this repository:

default_thai_company/fixtures/letter_head.json

@@ -1,7 +1,7 @@
 [
  {
   "align": "Left",
-  "content": "<style>\n    .bpt-title {\n        display: -webkit-box;\n        display: flex;\n        -webkit-box-align: center;\n        align-items: center;\n        width: 100%;\n    }\n    .bpt-title img {\n        margin-right: 1em;\n    }\n    .bpt-title .bpt-company {\n        -webkit-box-flex: 1;\n        flex: 1;\n        text-align: right;\n    }\n</style>\n{% set company = get_letter_head_company(doc) %}\n{% if company %}\n<div class=\"bpt-title\">\n    {% if company.company_logo %}\n    <img alt=\"{{ company.company_name }}\" height=\"125\" src=\"{{ company.company_logo }}\">\n    {% endif %}\n    <div class=\"bpt-company\">\n        <h1>{{ company.company_name }}</h1>\n        <small>\n            {% if company.tax_id %}<div>Tax ID: {{ company.tax_id }}</div>{% endif %}\n            {% if company.address %}<div>{{ company.address }}</div>{% endif %}\n            {% if company.phone_no %}<div>Phone: {{ company.phone_no }}</div>{% endif %}\n            {% if company.email %}<div>Email: {{ company.email }}</div>{% endif %}\n        </small>\n    </div>\n</div>\n{% endif %}\n",
+  "content": "<style>\n    .bpt-title {\n        display: -webkit-box;\n        display: flex;\n        -webkit-box-align: center;\n        align-items: center;\n        width: 100%;\n    }\n    .bpt-title img {\n        margin-right: 1em;\n    }\n    .bpt-title .bpt-company {\n        -webkit-box-flex: 1;\n        flex: 1;\n        text-align: right;\n    }\n</style>\n{% set company = get_letter_head_company(doc) %}\n{% if company %}\n<div class=\"bpt-title\">\n    {% if company.company_logo %}\n    <img alt=\"{{ company.company_name }}\" height=\"125\" src=\"{{ company.company_logo }}\">\n    {% endif %}\n    <div class=\"bpt-company\">\n        <h1>{{ company.company_name }}</h1>\n        <small>\n            {% if company.tax_id %}<div>{{ _(\"Tax ID\") }}: {{ company.tax_id }}</div>{% endif %}\n            {% if company.address %}<div>{{ company.address }}</div>{% endif %}\n            {% if company.phone_no %}<div>{{ _(\"Phone\") }}: {{ company.phone_no }}</div>{% endif %}\n            {% if company.email %}<div>{{ _(\"Email\") }}: {{ company.email }}</div>{% endif %}\n        </small>\n    </div>\n</div>\n{% endif %}\n",
   "disabled": 0,
   "docstatus": 0,
   "doctype": "Letter Head",
@@ -18,7 +18,7 @@
   "image_width": 0.0,
   "is_default": 1,
   "letter_head_name": "Default Letter Head",
-  "modified": "2026-09-10 09:51:23.933752",
+  "modified": "2026-09-15 06:44:37.653888",
   "name": "Default Letter Head",
   "source": "HTML"
  }

default_thai_company/hooks.py

@@ -78,6 +78,7 @@ jinja = {
 	"methods": [
 		"default_thai_company.utils.get_letter_head_company",
 		"default_thai_company.utils.get_company_bank_account",
+		"default_thai_company.utils.get_in_words",
 	],
 }
 

default_thai_company/public/fonts/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2018 The Sarabun Project Authors (https://github.com/cadsondemak/Sarabun)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

default_thai_company/tax_withholding.py

@@ -10,6 +10,8 @@ from erpnext.accounts.doctype.tax_withholding_category.tax_withholding_category
 from frappe import _
 from frappe.utils import cint, flt
 
+from default_thai_company.utils import money_in_words
+
 # Liability: tax we withhold from suppliers and remit on P.N.D.3/53 (linked on every category).
 # Asset: tax customers withhold from us, creditable against corporate income tax.
 LIABILITY_ACCOUNT = "Withholding Tax Payable"
@@ -158,6 +160,17 @@ class ThaiSalesInvoice(SalesInvoice):
 				self.precision("amount_after_withholding"),
 			)
 
+	def set_total_in_words(self):
+		"""SellingController's version, with Thai wording when the saving user's
+		language is Thai. Print formats re-derive the text per print language
+		(`get_in_words`)."""
+		base_amount = abs(
+			self.base_grand_total if self.is_rounded_total_disabled() else self.base_rounded_total
+		)
+		self.base_in_words = money_in_words(base_amount, self.company_currency)
+		amount = abs(self.grand_total if self.is_rounded_total_disabled() else self.rounded_total)
+		self.in_words = money_in_words(amount, self.currency)
+
 
 class ThaiPaymentEntry(PaymentEntry):
 	def build_gl_map(self):
@@ -333,7 +346,8 @@ def get_customer_withholding(doc):
 		total += withholding_on(details_by_category[category], base_taxable, base_taxable, precision)
 
 	if len(details_by_category) == 1:
-		description = next(iter(details_by_category.values())).description
+		# category_name; translations/th.csv carries the fixture categories
+		description = _(next(iter(details_by_category.values())).description)
 	else:
 		description = _("Withholding tax deducted by customer")
 	return flt(total, precision), description

default_thai_company/translations/th.csv

@@ -0,0 +1,55 @@
+Net Payable After Withholding Tax,ยอดชำระสุทธิหลังหักภาษี ณ ที่จ่าย
+Withholding Tax,ภาษีหัก ณ ที่จ่าย
+Tax Withholding Category,ประเภทภาษีหัก ณ ที่จ่าย
+Withholding tax deducted by customer,ภาษีหัก ณ ที่จ่ายที่ลูกค้าหักไว้
+Tax Withholding Category {0} has no account for Company {1},ประเภทภาษีหัก ณ ที่จ่าย {0} ไม่มีบัญชีสำหรับบริษัท {1}
+Account {0} not found for Company {1},ไม่พบบัญชี {0} สำหรับบริษัท {1}
+Please set Tax Withholding Category on {0} {1} or on this Payment Entry,กรุณาระบุประเภทภาษีหัก ณ ที่จ่ายใน {0} {1} หรือในรายการชำระเงินนี้
+Tax ID,เลขประจำตัวผู้เสียภาษี
+Tax Id,เลขประจำตัวผู้เสียภาษี
+Signatures,ลายเซ็น
+On behalf of,ในนาม
+Receiver,ผู้รับ
+Issuer,ผู้ออก
+Tax Invoice,ใบกำกับภาษี
+Tax Invoice/Receipt,ใบกำกับภาษี/ใบเสร็จรับเงิน
+"Commission, brokerage, agency fees - Sec. 40(2), juristic payee (P.N.D.53)",ค่านายหน้า ค่าตัวแทน - มาตรา 40(2) ผู้รับเป็นนิติบุคคล (ภ.ง.ด.53)
+"Royalties, goodwill, copyright, other rights - Sec. 40(3), juristic payee (P.N.D.53)",ค่าแห่งกู๊ดวิลล์ ค่าลิขสิทธิ์ หรือสิทธิอย่างอื่น - มาตรา 40(3) ผู้รับเป็นนิติบุคคล (ภ.ง.ด.53)
+"Interest - Sec. 40(4)(a), juristic payee excl. banks/finance companies (P.N.D.53)",ดอกเบี้ย - มาตรา 40(4)(ก) ผู้รับเป็นนิติบุคคล ยกเว้นธนาคาร/บริษัทเงินทุน (ภ.ง.ด.53)
+"Interest - Sec. 40(4)(a), individual payee, Sec. 50(2) (P.N.D.2)",ดอกเบี้ย - มาตรา 40(4)(ก) ผู้รับเป็นบุคคลธรรมดา มาตรา 50(2) (ภ.ง.ด.2)
+"Dividends, share of profits - Sec. 40(4)(b) (P.N.D.2 / P.N.D.53)",เงินปันผล เงินส่วนแบ่งของกำไร - มาตรา 40(4)(ข) (ภ.ง.ด.2 / ภ.ง.ด.53)
+"Rent of property, hire-purchase of movable property - Sec. 40(5) (P.N.D.3 / P.N.D.53)",ค่าเช่าทรัพย์สิน ค่าเช่าซื้อสังหาริมทรัพย์ - มาตรา 40(5) (ภ.ง.ด.3 / ภ.ง.ด.53)
+Rent of ships under the Merchant Marine Promotion Act - Sec. 40(5) (P.N.D.53),ค่าเช่าเรือตามกฎหมายว่าด้วยการส่งเสริมการพาณิชยนาวี - มาตรา 40(5) (ภ.ง.ด.53)
+"Law, medicine, engineering, architecture, accounting, fine arts - Sec. 40(6) (P.N.D.3 / P.N.D.53)",วิชาชีพอิสระ กฎหมาย การประกอบโรคศิลปะ วิศวกรรม สถาปัตยกรรม การบัญชี ประณีตศิลปกรรม - มาตรา 40(6) (ภ.ง.ด.3 / ภ.ง.ด.53)
+"Contract work, contractor supplies essential materials - Sec. 40(7) (P.N.D.3 / P.N.D.53)",ค่ารับเหมาที่ผู้รับเหมาต้องลงทุนจัดหาสัมภาระในส่วนสำคัญ - มาตรา 40(7) (ภ.ง.ด.3 / ภ.ง.ด.53)
+"Hire of work, service fees - Sec. 40(8) (P.N.D.3 / P.N.D.53)",ค่าจ้างทำของ ค่าบริการ - มาตรา 40(8) (ภ.ง.ด.3 / ภ.ง.ด.53)
+"Rewards, discounts, sales promotion benefits - Sec. 40(8) (P.N.D.3 / P.N.D.53)",รางวัล ส่วนลด หรือประโยชน์ใด ๆ เนื่องจากการส่งเสริมการขาย - มาตรา 40(8) (ภ.ง.ด.3 / ภ.ง.ด.53)
+Advertising fees - Sec. 40(8) (P.N.D.3 / P.N.D.53),ค่าโฆษณา - มาตรา 40(8) (ภ.ง.ด.3 / ภ.ง.ด.53)
+"Transport of goods or passengers, excl. public transport - Sec. 40(8) (P.N.D.3 / P.N.D.53)",ค่าขนส่งสินค้าหรือผู้โดยสาร ยกเว้นการขนส่งสาธารณะ - มาตรา 40(8) (ภ.ง.ด.3 / ภ.ง.ด.53)
+Non-life insurance premiums - Sec. 40(8) (P.N.D.53),ค่าเบี้ยประกันวินาศภัย - มาตรา 40(8) (ภ.ง.ด.53)
+"Prizes from contests, competitions, lucky draws - Sec. 40(8) (P.N.D.3 / P.N.D.53)",รางวัลจากการประกวด การแข่งขัน การชิงโชค - มาตรา 40(8) (ภ.ง.ด.3 / ภ.ง.ด.53)
+Public entertainers resident in Thailand - Sec. 40(8) (P.N.D.3),นักแสดงสาธารณะที่มีภูมิลำเนาในประเทศไทย - มาตรา 40(8) (ภ.ง.ด.3)
+"Rubber, cassava, jute, rice, maize, sugarcane, coffee beans, oil palm - Sec. 40(8) (P.N.D.3 / P.N.D.53)",ยางแผ่น มันสำปะหลัง ปอ ข้าว ข้าวโพด อ้อย เมล็ดกาแฟ ปาล์มน้ำมัน - มาตรา 40(8) (ภ.ง.ด.3 / ภ.ง.ด.53)
+Aquatic animals bought from non-registered sellers - Sec. 40(8) (P.N.D.3 / P.N.D.53),สัตว์น้ำที่ซื้อจากผู้ขายที่ไม่ได้จดทะเบียนภาษีมูลค่าเพิ่ม - มาตรา 40(8) (ภ.ง.ด.3 / ภ.ง.ด.53)
+"Sale of immovable property, juristic seller - Sec. 69 Ter (remitted at the Land Office)",การขายอสังหาริมทรัพย์ ผู้ขายเป็นนิติบุคคล - มาตรา 69 ตรี (นำส่ง ณ สำนักงานที่ดิน)
+Sec. 40(2)-(6) income paid to non-resident individuals - Sec. 50(2) (P.N.D.3),เงินได้ตามมาตรา 40(2)-(6) จ่ายให้บุคคลธรรมดาที่มิได้เป็นผู้อยู่ในประเทศไทย - มาตรา 50(2) (ภ.ง.ด.3)
+"Sec. 40(2)-(6) income excl. dividends to foreign companies not doing business in Thailand - Sec. 70, pre-DTA (P.N.D.54)",เงินได้ตามมาตรา 40(2)-(6) ยกเว้นเงินปันผล จ่ายให้บริษัทต่างประเทศที่มิได้ประกอบกิจการในประเทศไทย - มาตรา 70 ก่อนใช้อนุสัญญาภาษีซ้อน (ภ.ง.ด.54)
+"Dividends to foreign companies not doing business in Thailand - Sec. 70, pre-DTA (P.N.D.54)",เงินปันผลจ่ายให้บริษัทต่างประเทศที่มิได้ประกอบกิจการในประเทศไทย - มาตรา 70 ก่อนใช้อนุสัญญาภาษีซ้อน (ภ.ง.ด.54)
+Sales Invoice,ใบแจ้งหนี้
+Sales Order,ใบสั่งขาย
+Posting Date,วันที่
+Payment Due Date,วันครบกำหนดชำระ
+Contact Person,ผู้ติดต่อ
+Mobile No,โทรศัพท์มือถือ
+Contact Email,อีเมล
+Description,รายละเอียด
+Rate,ราคาต่อหน่วย
+Amount,จำนวนเงิน
+Total,รวม
+Total (Without Tax),รวมก่อนภาษี
+Net Total,ยอดรวมสุทธิ
+Total Taxes and Charges,รวมภาษีและค่าธรรมเนียม
+Grand Total,ยอดรวมทั้งสิ้น
+Rounded Total,ยอดรวมปัดเศษ
+Terms and Conditions Details,รายละเอียดข้อตกลงและเงื่อนไข
+Page {0} of {1},หน้า {0} จาก {1}

default_thai_company/utils.py

@@ -1,6 +1,30 @@
 import frappe
+import frappe.utils
 from erpnext import get_default_company
 from frappe.contacts.doctype.address.address import get_default_address, render_address
+from num2words import num2words
+
+
+def money_in_words(amount, currency):
+	"""Amount in words for the active language.
+
+	frappe.utils.money_in_words renders "<currency> <words> only." in every
+	language; Thai documents write "<words>บาทถ้วน" or "<words>บาท<words>สตางค์".
+	Currencies num2words cannot spell in Thai keep frappe's wording.
+	"""
+	if frappe.local.lang == "th":
+		try:
+			return num2words(amount, lang="th", to="currency", currency=currency)
+		except NotImplementedError:
+			pass
+	return frappe.utils.money_in_words(amount, currency)
+
+
+def get_in_words(doc):
+	"""`in_words` for print formats: re-derived in the print language instead
+	of the language of whoever saved the document."""
+	amount = abs(doc.grand_total if doc.is_rounded_total_disabled() else doc.rounded_total)
+	return money_in_words(amount, doc.currency)
 
 
 def get_letter_head_company(doc=None):