Merge pull request #225 from ecosoft-odoo/15.0-add-readme-frappe-etax…

…-service

[15.0][ADD] frappe_etax_service: add readme

frappe_etax_service/README.rst

@@ -0,0 +1,97 @@
+================================
+Connector to Frappe eTax service
+================================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:163e8ccd6191b1516eb365390c750218e7eda5ce567826874343c157af1d92a4
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-ecosoft--odoo%2Fecosoft--addons-lightgray.png?logo=github
+    :target: https://github.com/ecosoft-odoo/ecosoft-addons/tree/15.0/frappe_etax_service
+    :alt: ecosoft-odoo/ecosoft-addons
+
+|badge1| |badge2| |badge3|
+
+This module provide a feature to integrate with Frappe e-Tax Service. It will send the tax invoice to Frappe server and get the signed e-Tax invoice back.
+
+#. At Vendor Bill, after posted vendor bill with tax, Etax invoice button will display on screen.
+#. Then click Etax Invoice buttton
+#. Check e-Tax status on e-Tax Info tab if status is success frappe server will return the signed e-Tax invoice attachment as pdf file and xml file back to odoo.
+#. You can download the signed e-Tax invoice from the attachment.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+Set up Frappe Server URL and Frappe Auth Token
+
+#. Go to menu > Invoicing > Configurations > Settings
+#. On title Ecosoft e-Tax Services set up Frappe Server URL and Frappe Auth Token
+
+Note:
+Frappe Server URL is the URL of the Frappe server where the e-Tax Service is installed. Frappe Auth Token is the token generated from the Frappe server.
+Contract to the provider of the e-Tax Service for the Frappe Server URL and Frappe Auth Token.
+
+
+Configurations Form template
+
+#. Go to menu > Invoicing > Configurations > Etax Service > Doctype Code
+#. Form name is name of odoo/frappe form, you need to use the same name as in odoo/frappe
+#. Doctype code: This is the code with send to Frappe server which represent variant of tax invoice following:
+    * 388: ใบกำกับภาษี
+    * T02: ใบแจ้งหนี้/ใบกำกับภาษี
+    * T03: ใบเสร็จรับเงิน/ใบกำกับภาษี
+    * T04: ใบส่งของ/ใบกำกับภาษี
+    * T05: ใบกำกับภาษีอย่างย่อ
+    * T01: ใบรับ (ใบเสร็จรับเงิน)
+    * 80: ใบเพิ่มหนี้
+    * 81: ใบลดหนี้
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/ecosoft-odoo/ecosoft-addons/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 <https://github.com/ecosoft-odoo/ecosoft-addons/issues/new?body=module:%20frappe_etax_service%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+~~~~~~~
+
+* Kitti U.
+* Ecosoft
+
+Contributors
+~~~~~~~~~~~~
+
+* `Ecosoft <http://ecosoft.co.th>`__:
+
+  * Kitti U. <[email protected]>
+  * Saran Lim. <[email protected]>
+  * Theerayut A. <[email protected]>
+
+Maintainers
+~~~~~~~~~~~
+
+This module is part of the `ecosoft-odoo/ecosoft-addons <https://github.com/ecosoft-odoo/ecosoft-addons/tree/15.0/frappe_etax_service>`_ project on GitHub.
+
+You are welcome to contribute.

frappe_etax_service/inet/inet_data_template.py

@@ -62,7 +62,7 @@ def prepare_data_invoice(doc):
     ):
         doc_lines.append(
             {
-                "product_code": line.product_id and line.product_id.default_code,
+                "product_code": line.product_id and line.product_id.default_code or "",
                 "product_name": line.product_id and line.product_id.name or line.name,
                 "product_price": line.price_unit,
                 "product_quantity": line.quantity,

frappe_etax_service/readme/CONFIGURE.rst

@@ -0,0 +1,23 @@
+Set up Frappe Server URL and Frappe Auth Token
+
+#. Go to menu > Invoicing > Configurations > Settings
+#. On title Ecosoft e-Tax Services set up Frappe Server URL and Frappe Auth Token
+
+Note:
+Frappe Server URL is the URL of the Frappe server where the e-Tax Service is installed. Frappe Auth Token is the token generated from the Frappe server.
+Contract to the provider of the e-Tax Service for the Frappe Server URL and Frappe Auth Token.
+
+
+Configurations Form template
+
+#. Go to menu > Invoicing > Configurations > Etax Service > Doctype Code
+#. Form name is name of odoo/frappe form, you need to use the same name as in odoo/frappe
+#. Doctype code: This is the code with send to Frappe server which represent variant of tax invoice following:
+    * 388: ใบกำกับภาษี
+    * T02: ใบแจ้งหนี้/ใบกำกับภาษี
+    * T03: ใบเสร็จรับเงิน/ใบกำกับภาษี
+    * T04: ใบส่งของ/ใบกำกับภาษี
+    * T05: ใบกำกับภาษีอย่างย่อ
+    * T01: ใบรับ (ใบเสร็จรับเงิน)
+    * 80: ใบเพิ่มหนี้
+    * 81: ใบลดหนี้

frappe_etax_service/readme/CONTRIBUTORS.rst

@@ -0,0 +1,5 @@
+* `Ecosoft <http://ecosoft.co.th>`__:
+
+  * Kitti U. <[email protected]>
+  * Saran Lim. <[email protected]>
+  * Theerayut A. <[email protected]>

frappe_etax_service/readme/DESCRIPTION.rst

@@ -0,0 +1,6 @@
+This module provide a feature to integrate with Frappe e-Tax Service. It will send the tax invoice to Frappe server and get the signed e-Tax invoice back.
+
+#. At Vendor Bill, after posted vendor bill with tax, Etax invoice button will display on screen.
+#. Then click Etax Invoice buttton
+#. Check e-Tax status on e-Tax Info tab if status is success frappe server will return the signed e-Tax invoice attachment as pdf file and xml file back to odoo.
+#. You can download the signed e-Tax invoice from the attachment.