Connector to Frappe eTax service
This module integrates Odoo with the Frappe e-Tax Service (INET) to sign and retrieve certified e-Tax documents.
Key features:
Sign e-Tax Invoice - Send a posted customer invoice/tax invoice to Frappe server and receive the signed PDF and XML attachments back.
Sign Debit Note - Send a posted debit note (ใบเพิ่มหนี้) to Frappe server.
Sign Credit Note - Send a posted credit note (ใบลดหนี้) to Frappe server, with purpose code selection.
Replacement e-Tax Invoice - Create a replacement document for an already-signed invoice and re-sign with Frappe.
e-Tax Status Tracking - Track signing status (Success, Processing, Error, Replaced) on each invoice.
Purpose Code - Select an INET-standard purpose code when creating credit notes or debit notes.
Workflow:
Post a customer invoice, debit note, or credit note.
Click the e-Tax Invoice button on the document.
Select the e-Tax document type (e.g. ใบกำกับภาษี, ใบแจ้งหนี้/ใบกำกับภาษี) and confirm.
The system sends the document to Frappe server for signing.
Check the e-Tax Status on the e-Tax Info tab - when Success, the signed PDF and XML are attached automatically.
If a signed invoice needs correction, use Create Replacement to create a replacement document, then sign the replacement.
Table of contents
Configuration
1. Frappe Connection
Go to Invoicing -> Configurations -> e-Tax Service -> Frappe Connections.
Create a connection for the company:
Frappe Server URL - Base URL of the Frappe server where the e-Tax Service is installed. Do not include the API route.
Frappe Auth Token - Token generated from the Frappe server in api_key:api_secret format.
Go to Invoicing -> Configurations -> Settings, section Ecosoft e-Tax Services.
Enable e-Tax and select the Frappe e-Tax Connection for the company.
The connection is selected per company and shared by every Frappe e-Tax API operation. Contact your e-Tax Service provider for the URL and token.
2. Document Type Code (etax.doctype.code)
Standard INET document type codes are pre-loaded:
Code |
Description |
|---|---|
380 |
ใบแจ้งหนี้ |
388 |
ใบกำกับภาษี |
T01 |
ใบรับ (ใบเสร็จรับเงิน) |
T02 |
ใบแจ้งหนี้/ใบกำกับภาษี |
T03 |
ใบเสร็จรับเงิน/ใบกำกับภาษี |
T04 |
ใบส่งของ/ใบกำกับภาษี |
T05 |
ใบกำกับภาษีอย่างย่อ |
80 |
ใบเพิ่มหนี้ |
81 |
ใบลดหนี้ |
Go to Invoicing -> Configurations -> e-Tax Service -> Document Type Code to view or add codes.
3. e-Tax Document Type (etax.doctype)
Map each Odoo document type to its INET document type code and report template.
Go to Invoicing -> Configurations -> e-Tax Service -> e-Tax Doctype and create records:
Form Name - Name of the Odoo/Frappe form template (must match exactly).
Type - Odoo document type: Customer Invoice, Credit Note, Debit Note, or Payment.
Invoice Template Source - odoo (render PDF from Odoo) or frappe (use Frappe template).
Document Type Code - Select the matching INET code (e.g. T02 for ใบแจ้งหนี้/ใบกำกับภาษี).
Example setup:
Form Name |
Type |
Code |
|---|---|---|
ใบกำกับภาษี |
Customer Invoice |
388 |
ใบแจ้งหนี้/ใบกำกับภาษี |
Customer Invoice |
T02 |
ใบเพิ่มหนี้ |
Customer Debit Note |
80 |
ใบลดหนี้ |
Customer Credit Note |
81 |
4. Purpose Code (etax.purpose.code)
Purpose codes are pre-loaded following INET convention and are linked to applicable document type codes.
Go to Invoicing -> Configurations -> e-Tax Service -> Purpose Code to view all codes.
Key groups:
TIVC - Tax Invoice replacement (applicable to 388, T02, T03, T04, T05)
DBNG / DBNS - Debit Note Goods/Services (applicable to 80)
CDNG / CDNS - Credit Note Goods/Services (applicable to 81)
RCTC - Receipt replacement (applicable to T01)
Purpose codes are automatically filtered by document type when creating a credit note or debit note.
5. Replacement Lock Date
Go to Invoicing -> Configurations -> Settings, section Ecosoft e-Tax Services:
Replacement Lock Date - Day of month after which creating a replacement e-Tax document is no longer allowed (counted from the 1st of the following month). Default is 1.
Bug Tracker
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
Credits
Contributors
-
Kitti U. <kittiu@ecosoft.co.th>
Saran Lim. <saranl@ecosoft.co.th>
Theerayut A. <theerayuta@ecosoft.co.th>
Maintainers
Current maintainer:
This module is part of the ecosoft-odoo/ecosoft-addons project on GitHub.
You are welcome to contribute.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file odoo_addon_frappe_etax_service-18.0.1.5.0-py3-none-any.whl.
File metadata
- Download URL: odoo_addon_frappe_etax_service-18.0.1.5.0-py3-none-any.whl
- Upload date:
- Size: 69.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
489c53e0062efc56b126ce8285984fe965e12f6851898341329adf68b9107242
|
|
| MD5 |
185bdfcb9acf63c54e0406bbab70b12e
|
|
| BLAKE2b-256 |
217aec63bd6e00b5be8afd4ae18e47fac1a8e42553f897fa5e28ea3963ee46d1
|
