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
API key นี้จะใช้ในการเชื่อมต่อ API กับระบบ Leceipt โดยวิธีการสร้างจะอยู่ใน link ด้านล่าง
วิธีสร้าง API Key: https://www.leceipt.com/docs/etax/api-key
2. ระบุข้อมูล
ระบุข้อมูลที่สำคัญเพื่อที่จะสร้างเอกสารต่างๆบน Leceipt ท่านสามารถดูตัวอย่างข้อมูลได้ที่ Github
customer (ผู้ซื้อ)
แบบมีโครงสร้าง
ตัวอย่าง
![](https://www.leceipt.com/wp-content/uploads/2022/08/ใบส่งของ-ใบกำกับภาษี-1.png)
แบบไม่มีโครงสร้าง
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 | เบอร์โทรศัพท์ |
no | string | อีเมล | |
unstructure | no | string | ระบุเป็น true หากเป็นที่อยู่แบบไม่มีโครงสร้าง |
ตัวอย่าง
![](https://www.leceipt.com/wp-content/uploads/2022/08/ใบส่งของ-ใบกำกับภาษี-2.png)
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 |
ตัวอย่าง
![](https://www.leceipt.com/wp-content/uploads/2022/08/API-ใบเสร็จรับเงิน-ใบกำกับภาษี-2.png)
data
Parameters | Require | Type | Meaning |
---|---|---|---|
number | yes | string | เลขที่ ใบเสนอราคา |
reference | no | string | เลขที่อ้างอิง |
dateBE | yes | string | วัน เดือน ปี (พ.ศ.) ที่ออกใบเสนอราคา |
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 | ชื่อผู้จัดทำ |
reIssue | no | boolean | หากออกเอกสารแทนใบเดิม ให้ระบุเป็น true หากไม่ ให้ระบุเป็น false (default) |
refer | yes (ถ้า reIssue เป็น true) | object | เอกสารอ้างถึง |
ตัวอย่าง
![](https://www.leceipt.com/wp-content/uploads/2022/08/ใบกำกับภาษี-2-1.png)
3. ส่ง Request ไปที่ Endpoint
Endpoint: https://api.leceipt.com/documents/quotations
Method: Post
ส่ง data ที่อยู่ในข้อ 2. ไปที่ endpoint ด้านบน แนะนำให้ใช้เป็น axios ในการส่ง request เพื่อความง่าย
ตัวอย่างการส่ง
![](https://www.leceipt.com/wp-content/uploads/2022/08/ใบกำกับภาษี-3.png)
Response:
![](https://www.leceipt.com/wp-content/uploads/2022/09/API-ใบเสนอราคา-7.png)
เมื่อทำการส่ง request เรียบร้อยแล้ว ระบบ Leceipt จะทำการสร้างเอกสาร ถือว่าเป็นอันเสร็จสิ้น
แต่หากท่านต้องการ download ไฟล์ pdf ให้ดูขั้นตอนต่อไป
4. เก็บ FileId เพื่อทำการ Download
Endpoint: https://api.leceipt.com/etax/jobs/{id}
Method: Get
ส่ง get request ไปที่ endpoint ด้านบนโดย id เอามาจาก response ในข้อ 3.
![](https://www.leceipt.com/wp-content/uploads/2022/09/API-ใบเสนอราคา-2-1.png)
ตัวอย่าง
![](https://www.leceipt.com/wp-content/uploads/2022/08/ใบส่งของ-ใบกำกับภาษี-10.png)
นำ id นี้ไปไว้ด้านท้ายของ endpoint (ไม่ต้องเอา ” รอบ id)
Response:
![](https://www.leceipt.com/wp-content/uploads/2022/09/API-ใบเสนอราคา-4.png)
เมื่อได้ response มา ให้นำ fileId ไปใช้ในขั้นตอนถัดไป
5. Download ไฟล์ PDF
Endpoint: https://api.leceipt.com/etax/files/{fileId}/?api-version=2022-07-12
Method: Get
fileId เอามาจาก response ในข้อ 4.
![](https://www.leceipt.com/wp-content/uploads/2022/09/API-ใบเสนอราคา-5.png)
ตัวอย่าง
![](https://www.leceipt.com/wp-content/uploads/2022/09/API-ใบเสนอราคา-6.png)
ใช้ fs.createWriteStream เพื่อสร้างเป็นไฟล์ pdf
หากถ้ายังมีความสงสัย สามารถดู source code บน Github ที่ให้ไว้ด้านบน