วิธีสร้างเอกสารใบเพิ่มหนี้ (e-Tax Invoice & e-Receipt) จาก Leceipt API

API สร้างเอกสารใบเพิ่มหนี้

หากท่านต้องการที่จะสร้างเอกสาร e-Tax Invoice & e-Receipt ผ่านระบบของท่าน คู่มือนี้จะสอนวิธีการใช้ endpoint ของ ระบบ Leceipt แบบง่ายๆพร้อมตัวอย่างโค้ดเพื่อให้ท่านได้เข้าใจได้อย่างง่าย

เพื่อความสะดวก ขอแนะนำให้ท่านดู code ตัวอย่างทาง https://github.com/frevation/leceipt-api-example-code

การสร้างเอกสาร e-Tax Invoice & e-Receipt จะมีตามขั้นตอนต่อไปนี้

1. สร้าง API Key

2. ระบุข้อมูล

3. ส่ง Request ไปที่ Endpoint

4. เก็บ FileId เพื่อทำการ Download

5. Download ไฟล์ PDF

1. สร้าง API Key

API key นี้จะใช้ในการเชื่อมต่อ API กับระบบ Leceipt โดยวิธีการสร้างจะอยู่ใน link ด้านล่าง

วิธีสร้าง API Key: https://www.leceipt.com/docs/etax/api-key

2. ระบุข้อมูล

ระบุข้อมูลที่สำคัญเพื่อที่จะสร้างเอกสารต่างๆบน Leceipt ท่านสามารถดูตัวอย่างข้อมูลได้ที่ Github

customer (ผู้ซื้อ)

แบบมีโครงสร้าง

Parameters	Require	Type	Meaning
name	yes	string	ชื่อผู้ขาย
buildingNumber	yes	string	บ้านเลขที่
address	yes	string	ที่อยู่
streetPrefix	no	string	คำนำหน้าชื่อถนน เช่น ถ. ถนน
streetName	no	string	ชื่อถนน
subDistrictPrefix	no	string	คำนำหน้าชื่อตำบล เช่น ตำบล ต. แขวง
subDistrictCode	yes	string	รหัสตำบล
districtPrefix	no	string	คำนำหน้าชื่ออำเภอ เช่น อำเภอ อ. เขต
districtCode	yes	string	รหัสอำเภอ
provincePrefix	no	string	คำนำหน้าชื่อจังหวัด เช่น จังหวัด
provinceCode	yes	string	รหัสจังหวัด
postcode	yes	string	รหัสไปรษณีย์
branchNumber	yes	string	เลขที่สาขา
taxNumberType	yes	string	ประเภทผู้เสียภาษี
taxId	yes	string	เลขประจำตัวผู้เสียภาษี
phone	no	string	เบอร์โทรศัพท์
email	no	string	อีเมล
unstructure	yes	boolean	ระบุเป็น false หากเป็นที่อยู่แบบมีโครงสร้าง

ตัวอย่าง

แบบไม่มีโครงสร้าง

Parameters	Require	Type	Meaning
name	yes	string	ชื่อผู้ขาย
addressLineOne	yes	string	ที่อยู่
addressLineTwo	no	string	ที่อยู่บรรทัดที่ 2
postcode	yes	string	รหัสไปรษณีย์
countryName	no	string	ประเทศ
branchNumber	yes	string	เลขที่สาขา
taxNumberType	yes	string	ประเภทผู้เสียภาษี
taxId	yes	string	เลขประจำตัวผู้เสียภาษี
phone	no	string	เบอร์โทรศัพท์
email	no	string	อีเมล
unstructure	no	string	ระบุเป็น true หากเป็นที่อยู่แบบไม่มีโครงสร้าง

ตัวอย่าง

items (รายการสินค้า)

parameter นี้เป็น array หากในเอกสารมีหลายรายการสินค้าหรือบริการ ให้เพิ่ม object ลงใน array นี้เพิ่มเอง

Parameters	Require	Type	Meaning
number	yes	number	ลำดับรายการสินค้าหรือบริการ
description	yes	string	รายละเอียดสินค้าหรือบริการ
quantity	yes	number	จำนวนสินค้า
unitName	no	string	หน่วยสินค้า
price	yes	number	ราคาสินค้าหรือบริการ
discount	no	number	ส่วนลดสินค้าหรือบริการ
percentVat	yes	number	เปอร์เซ็นภาษีของรายการ ประกอบด้วย หากเป็นรายการยกเว้นภาษี ระบุเป็น -1 หากเป็นรายการภาษี 0% ระบุเป็น 0 หากเป็นรายการภาษี 7% ระบุเป็น 7

ตัวอย่าง

refer

refer ในที่นี้หมายถึงเอกสารอ้างอิง

Parameters	Require	Type	Meaning
number	yes	string	เลขที่เอกสารอ้างถึง
dateBE	yes	string	วัน เดือน ปี (พ.ศ.) ที่ออกเอกสารอ้างถึง
typeCode	yes	string	รหัสประเภทเอกสารอ้างถึง เช่น T03
reasonCode	yes	string	รหัสสาเหตุการออก
specificReason	yes (ถ้า reasonCode เป็น DBNG99, DBNS99)	string	สาเหตุอื่น ๆ
amountTotal	yes	number	มูลค่าสินค้าหรือบริการตามเอกสารเดิม

ตัวอย่าง

data

Parameters	Require	Type	Meaning
number	yes	string	เลขที่ ใบเพิ่มหนี้
dateBE	yes	string	วัน เดือน ปี (พ.ศ.) ที่ออกใบเพิ่มหนี้
calculationMethod	no	number	ราคาเพิ่มหนี้ calculationMethod=1 (default), ราคาจริง calculationMethod=2
includeVat	no	boolean	ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat=true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat=false (default)
customer	yes	object	รายละเอียดผู้ซื้อสินค้าหรือบริการ
items	yes	array	รายละเอียดสินค้าหรือบริการ
language	no	string	ภาษา (ประกอบด้วย th (ภาษาไทย) (default) กับ en (ภาษาอังกฤษ)
discount	no	number	ส่วนลดรวม
note	no	string	หมายเหตุ ที่ต้องการแสดงในใบเพิ่มหนี้
createdBy	no	string	ชื่อผู้จัดทำ
refer	yes	object	เอกสารอ้างถึง