Author: |
Poonlap V. |
License: |
AGPL-3 |
Branch: |
16.0 |
Repository: |
poonlap/odoo-th |
Dependencies: |
base,
and
th_address |
Languages: |
HTML (391, 52.3%),
Python (222, 29.7%),
XML (17, 2.3%),
YAML (48, 6.4%),
and
reStructuredText (69, 9.2%) |
Other branches: |
14.0,
15.0,
and
modules |
<h1 class="title">Thai address completion by Tax ID (VAT)</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Alpha" src="https://img.shields.io/badge/maturity-Alpha-red.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/poonlap/odoo-th/tree/14.0/th_address_vat"><img alt="poonlap/odoo-th" src="https://img.shields.io/badge/github-poonlap%2Fodoo--th-lightgray.png?logo=github" /></a></p>
<p>โมดูลนี้ใช้สำหรับกรอกที่อยู่ของลูกค้าอัตโนมัติ จากเลขประจำตัวผู้เสียภาษี (VAT 13 หลัก).
โดยจะใช้เลขประจำตัวผู้เสียภาษี นำไปหาที่อยู่มาให้จาก <a class="reference external" href="http://www.rd.go.th/publish/42546.0.html">web service ของกรมสรรพากร</a>.
หากเลขประจำตัวผู้เสียภาษีหรือเลขที่สาขาไม่ถูกต้อง โมดูลนี้จะแจ้งให้ผู้ใช้ทราบ</p>
<a name="th-address-vat-docker-image"></a>
<h2>ลองใช้งาน th_address_vat จาก docker image</h2>
<p>โมดูลนี้รวมไว้ใน <a class="reference external" href="https://github.com/poonlap/odoo-th">docker odoo-th</a> แล้ว สามารถลองใช้ได้ทันที.:</p>
<pre>
<code>$ git clone https://github.com/poonlap/odoo-th.git
$ cd odoo-th/docker
$ docker-compose up</code>
</pre>
<div class="admonition important">
<p class="first admonition-title">Important</p>
<p class="last">This is an alpha version, the data model and design can change at any time without warning.
Only for development or testing purpose, do not use in production.
<a class="reference external" href="https://odoo-community.org/page/development-status">More details on development status</a></p>
</div>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#usage" id="id2">Usage</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id3">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id4">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id5">Authors</a></li>
<li><a class="reference internal" href="#other-credits" id="id6">Other credits</a></li>
<li><a class="reference internal" href="#maintainers" id="id7">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="usage"></a>
<h3><a class="toc-backref" href="#id2">Usage</a></h3>
<p>โมดูลนี้ตั้งอยู่บนสมมติฐานที่ว่า รู้เลขประจำตัวผู้เสียภาษี 13 หลักของลูกค้าอยู่แล้ว และต้องการให้ระบบหาและกรอกที่อยู่ให้อัตโนมัติ.</p>
<ul class="simple">
<li>ไปหน้า Contacts และสร้างลูกค้าใหม่.</li>
<li>ไม่ต้องการชื่อบริษัท กรอกเลขประจำตัวผู้เสียภาษี 13 หลักที่ช่อง Tax ID</li>
</ul>
<div class="figure align-center">
<img alt="Input Tax Indentification Number, VAT" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address_vat/static/description/input_tin.png" style="width: 80%;" />
</div>
<ul class="simple">
<li>กดคีย์บอร์ด <cite>Tab</cite> หรือคลิกไปที่ช่องข้อมูลอื่น. ระบบจะติดต่อกับเว็บเซอร์วิสของกรมสรรพกร เช็คเลขประจำตัวผู้เสียภาษีว่ามีอยู่จริงหรือไม่.</li>
<li>ถ้าเลขประจำตัวผู้เสียภาษีถูกต้อง โมดูลนี้จะใส่ ชื่อบริษัทและที่อยู่ที่ได้จากเว็บเซอร์วิสของกรมสรรพากรให้ตามช่องข้อมูลที่เหมาะสมอัตโนมัติ</li>
</ul>
<div class="figure align-center">
<img alt="Auto-fill result" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address_vat/static/description/autofill_sample.png" style="width: 80%;" />
</div>
<ul class="simple">
<li>โมดูลนี้จะกรอกข้อมูลเป็นสำนักงานใหญ่ เลขสาขา 00000 เป็นค่าเริ่มต้น.</li>
<li>กรณีที่บริษัทมีหลายสาขา สาขาหาที่อยู่ของสาขาอื่นๆได้โดยเปลี่ยนเลขสาขาในช่องสาขา แล้วกดคีย์ <cite>Tab</cite></li>
</ul>
<div class="figure align-center">
<img alt="Main branch" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address_vat/static/description/main_branch.png" style="width: 80%;" />
</div>
<div class="figure align-center">
<img alt="Another branch" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address_vat/static/description/another_branch.png" style="width: 80%;" />
</div>
<ul class="simple">
<li>แจ้งเตือนกรณีเลขประจำตัวผู้เสียภาษีไม่ถูกต้อง</li>
</ul>
<div class="figure align-center">
<img alt="Validate TIN" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address_vat/static/description/tin_validation.png" style="width: 80%;" />
</div>
<ul class="simple">
<li>แจ้งเตือนกรณีเลขที่สาขาไม่ถูกต้อง หรือไม่มีเลขที่สาขานั้นๆ</li>
</ul>
<div class="figure align-center">
<img alt="Validate Branch" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address_vat/static/description/branch_validation.png" style="width: 80%;" />
</div>
<ul class="simple">
<li>แจ้งเตือนกรณีเลขที่สาขาไม่ใช่ตัวเลขหรือเลขไม่ครบ 5 หลัก</li>
</ul>
<div class="figure align-center">
<img alt="Verify Branch number format" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address_vat/static/description/branch_format.png" style="width: 80%;" />
</div>
<a name="bug-tracker"></a>
<h3><a class="toc-backref" href="#id3">Bug Tracker</a></h3>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/poonlap/odoo-th/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/poonlap/odoo-th/issues/new?body=module:%20th_address_vat%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h3><a class="toc-backref" href="#id4">Credits</a></h3>
<a name="authors"></a>
<h4><a class="toc-backref" href="#id5">Authors</a></h4>
<ul class="simple">
<li>Poonlap V.</li>
</ul>
<a name="other-credits"></a>
<h4><a class="toc-backref" href="#id6">Other credits</a></h4>
<ul class="simple">
<li><a class="reference external" href="https://medium.com/@mchayapol/ดึงข้อมูลผู้เสียภาษีจากเลขประจำตัวผู้เสียภาษีจากWebServiceของกรมสรรพากรด้วยPythonZeep-9048c1ae3252">ดึงข้อมูลผู้เสียภาษี จากเลขประจำตัวผู้เสียภาษี จาก WebService ของกรมสรรพากร ด้วย Python Zeep</a></li>
<li><a class="reference external" href="http://www.rd.go.th/publish/42546.0.html">เว็บเซอร์วิสของกรมสรรพากร</a></li>
</ul>
<a name="maintainers"></a>
<h4><a class="toc-backref" href="#id7">Maintainers</a></h4>
<p>Current maintainer:</p>
<p><a class="reference external" href="https://github.com/poonlap"><img alt="poonlap" src="https://github.com/poonlap.png?size=40px" /></a></p>
<p>This module is part of the <a class="reference external" href="https://github.com/poonlap/odoo-th/tree/14.0/th_address_vat">poonlap/odoo-th</a> project on GitHub.</p>
<p>You are welcome to contribute.</p>