Odoo eTax Service
เอกสารประกอบการใช้งานการเชื่อมต่อ INET eTax Service สำหรับ Odoo 15
Modules
โมดูลที่ต้องติดตั้ง
- Odoo :
frappe_etax_service
- Frappe :
etax_inet
ภาพรวมการทำงาน
Odoo เป็นระบบต้นทางที่มีเอกสารทางบัญชี (Tax Invoice) เมื่อต้องการ sign eTax จะส่ง API พร้อมข้อมูลของเอกสารทั้งหมดไปที่ Frappe eTax Server ซึ่งทำหน้าที่เป็นตัวกลาง (proxy) Frappe จะส่ง API ต่อไป eTax Server ของ INET เพื่อทำการ sign เอกสารและคืนกลับมาเป็นเอกสารที่ signed เรียบร้อยแล้ว จากนั้นจึงคืนกลับไปยังต้นทาง
เหตุผลที่มี Frappe eTax Server มาขั้นกลาง?
- ทำหน้าที่เป็นจุดศูนย์รวมของเอกสาร Invoice ทั้งหมด ซึ่งจะมีประโยชน์ในกรณีที่มีมากกว่า 1 ระบบต้นทาง (หลาย ERP หลาย Companies)
- มีรายงานภาพรวมของ eTax ของทุกบริษัท
- มี API ในการเชื่อมต่อที่ง่ายกว่าการเชื่อมต่อกับระบบ eTax INET โดยตรง
- มี Print Format สำหรับออกแบบ Inovice Form (PDF) ในกรณีที่ระบบต้นทางไม่มี Tools ในการทำ Form
- เป็นเสมือน History Log ของระบบซึ่งจะเก็บทั้งเอกสารที่มี Error และเอกสารที่ Success
- อนาคตสามารถเพิ่มบริการที่มากกว่า INET ได้
การตั้งค่าการเชื่อมต่อบน Frappe Server
INET ETax Setting
ตั้งค่า URL (API endpoint) ที่ Frappe จะต้องส่ง API ข้อมูลเอกสารที่ได้รับมาจากระบบต้นทาง (เช่น Odoo) ต่อไปยัง INET
- Mode (Stop, Test, Production)
- URL Sign Document สำหรับกรณี Test และ Production
- URL Get Document Status สำหรับกรณี Test และ Production
INET ETax Service
ตั้งค่า Service Account สำหรับแต่ละ บริษัท-สาขา (มีได้มากกว่า 1) โดยข้อมูลนี้เป็นข้อมูลที่ได้รับจาก INET เมื่อสมัครใช้งาน เพื่อเชื่อต่อเข้าระบบ INET eTax Server
- User บน Frappe ซึ่งเป็น Account สำหรับให้ระบบปลายทางเข้ามาเชื่อมต่อ (ผ่าน Auth Token ที่สร้างได้จากหน้าต่าง User)
- ส่วนของข้อมูลการเชื่อต่อที่ได้รับมาจากทาง INET สำหรับแต่ละ บริษัท-สาขา
หมายเหตุ: Auth Token <API Key>:<API Secret>
สร้างโดยการกดปุ่ม Generate key ที่ส่วน API Access ของ User ที่ใช้งาน
การตั้งค่าระบบ Odoo
การตั้งค่าการเชื่อมต่อ
หลังจากได้รับ Auth Token
- URL ของ Frappe Server
- Auth Token ในรูปแบบ
: - Setting กรณีต้องการให้ระบบ INET ส่งเมล์ให้กับ Customer หลังจากเอกสาร signed แล้ว
การตั้งค่า Doctype Code
ในส่วนนี้เป็นการตั้งค่า Doctype Code สำหรับเอกสารแต่ละประเภท
- Doctype Code คือ code ประเภทเอกสารในการ sign ตาม INET ต้องสอดคล้องกับประเภทเอกสารของระบบ (Customer Invoice, Debit Note หรือ Credit Note)
- เช่น 388 คือใบกำกับภาษีให้เลือก Type = Customer Invoice
- แต่ละ Doctype เลือก Invoice Template โดยระบบจะใช้ในการสร้าง PDF เพื่อส่งไปยัง Frappe Server
- กรณีที่ต้องการใช้ Print Format จากระบบ Frappe ให้เลือก Invoice Template Source = Frappe แทน Odoo โดย Name จะเป็นชือของ Print Format
การทำงานของระบบบน Odoo
แน่นอนว่าการ sign eTax จะใช้สำหรับเอกสาร Customer Invoice ที่มี VAT มาเกี่ยวข้องเท่านั้น ในที่นี้ขอแบ่งการทำงานเป็น 3 กรณี
1. Sign Customer Invoice
กรณีนี้เป็นกรณีที่ปกติที่สุด เมื่อต้องการ Sign Customer Invoice
เอกสารที่ Posted แล้วและมีภาษีมาเกี่ยวข้องจะปรากฏปุ่ม Sign e-Tax Invoice
เลือกประเภทเอกสารและกดปุม Sign
เมื่อการ Sign เสร้จสมบูรณ์จะมีแถวแสดงสถานะ และมี Transaction Code กลับมาจากระบบ INET
เอกสารที่ได้รับการ Sign แล้วจะแนบกลับมาที่ระบบ
2. Sign Credit Note / Debit Note
กรณีที่ต้องการเปลี่ยนแปลง กรณี Credit Note หรือ Debit Note
ต่อเนื่องจากเอกสารที่ได้รับการ Sign เรียบร้อยแล้ว กดปุ่ม Create Credit Note (หรือ Debit Note)
กดปุ่ม Reverse เพื่อสร้าง Credit Note (หรือ Debit Note) ตามขั้นตอนปกติ
ที่เอกสาร Credit Note ทำการ Post เอกสารตามปกติ จากนั้นกดปุ่ม Sign e-Tax Invoice
เนื่องจากเป็น Credit Note ระบบจะให้เลือก Invoice Template แบบ Credit Note มาเกี่ยวข้องเท่านั้น กดปุ่ม Sign
เช่นเดี่ยวกับกรณี Customer Invoice เมื่อการ Sign เสร้จสมบูรณ์จะมีแถวแสดงสถานะ และมี Transaction Code กลับมาจากระบบ INET
3. Sign เอกสารทดแทนกรณี เปลี่ยนชื่อ / เปลี่ยนที่อยู่
กรณีสุดท้ายเป็นกรณีที่เอกสารที่เอกสาร Customer Invoice ที่ส่ง Sign ไปแล้วมีความผิดพลาด เช่น ที่อยู่ผิด กรณีเช่นนี้ต้องสร้างเอกสารทดแทน
ต่อเนื่องจากเอกสารที่ได้รับการ Sign เรียบร้อยแล้ว กดปุ่ม Create Replacement e-Tax
การสร้างเอกสารทดแทนจะไม่เหมือนกรณี Credit Note / Debit Note ตรงที่เอกสารเดิมจะถูกยกเลิกทันที ทำให้บน Wizard จะมีข้อความเตือน ว่าหลังจากสร้างเอกสารทดแทนแล้ว ผู้ใช้งานจำต้องยืนยันเอกสารและ Sign เอกสารให้เร็วที่สุด เพื่อให้ระบบ INET eTax Server ได้รับการทำเอกสารทดแทนเช่นเดียวกับระบบ ERP
เลือกเหตุผลที่ต้องทำเอกสารทดแทน และกดปุ่ม Create Replacement
ระบบจะสร้างเอกสารใหม่เพื่อทดแทนเอกสารเดิม โดยจะใช้เลขที่เอกสารเดิม แต่มี -R1 เพื่อระบบ Revision
ทำการยืนยันเอกสาร และทำการ Sign e-Tax Invoice ตามขึ้นตอนปกติ จะสังเกตุได้ว่า เอกสารนี้จะมี Purpose Code และการอ้างอิงถึงเอสารเดิม ข้อมูลนี้เองที่บอกว่าเอกสารนี้เป็นเอกสารทดแทนไปที่ INET eTax Server เช่นเดียวกัน
จบการทำงาน
No comments yet. Login to start a new discussion Start a new discussion