วิธีใช้ Postman สร้างใบเสร็จรับเงิน/ใบกำกับภาษี อย่างย่อ Leceipt API

วิธีใช้ Postman สร้างใบเสร็จรับเงิน/ใบกำกับภาษีอย่างย่อ ผ่าน Leceipt API

หากท่านต้องการที่จะสร้างเอกสาร etax ผ่านระบบของท่าน คู่มือนี้จะสอนวิธีการสร้างเอกสาร etax ผ่าน Postman แบบง่ายๆพร้อมตัวอย่างโค้ดเพื่อให้ท่านได้เข้าใจได้อย่างง่าย

ท่านสามารถ import collection ได้ด้วย Link ด้านล่าง

https://www.getpostman.com/collections/e42fe4deea6b7517f7ab

การสร้างเอกสาร etax จะมีตามขั้นตอนต่อไปนี้

1. สร้าง API Key

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

3. ใช้ Postman ส่ง Request

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

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

ตัวอย่าง

{ 
    "items": [ 
        { 
            "number": 1, 
            "description": "ค่าอาหารและเครื่องดื่ม", 
            "quantity": 1, 
            "unitName": "ชิ้น/อัน", 
            "price": 1500, 
            "discount": 0, 
            "percentVat": 0 
        }, 
        { 
            "number": 2, 
            "description": "ค่าอาหารและเครื่องดื่ม", 
            "quantity": 1, 
            "unitName": "", 
            "price": 1000, 
            "discount": 0, 
            "percentVat": 7 
        } 
    ] 
}

refer

refer ในที่นี้หมายถึงเอกสารอ้างอิง หากไม่มีการออกเอกสารแทนใบเดิม ไม่จำเป็นต้องกรอกข้อมูลในส่วนนี้

Parameters	Require	Type	Meaning
number	yes	string	เลขที่เอกสารอ้างถึง
dateBE	yes	string	วัน เดือน ปี (พ.ศ.) ที่ออกเอกสารอ้างถึง
reasonCode	yes	string	รหัสสาเหตุการออก
specificReason	yes (ถ้า reasonCode เป็น TIVC99)	string	สาเหตุอื่น ๆ

ตัวอย่าง

{ 
    "refer": { 
        "number": "TIV20210300000", 
        "dateBE": "18/03/2564", 
        "reasonCode": "TIVC01" 
    } 
}

data

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

ตัวอย่าง

{ 
    "number": "TIV20210300001", 
    "dateBE": "23/03/2564", 
    "includeVat": false, 
    "items": [ 
        { 
            "number": 1, 
            "description": "ค่าอาหารและเครื่องดื่ม", 
            "quantity": 1, 
            "unitName": "ชิ้น/อัน", 
            "price": 1500, 
            "discount": 0, 
            "percentVat": 0,
        }, 
        { 
            "number": 2, 
            "description": "ค่าอาหารและเครื่องดื่ม", 
            "quantity": 1, 
            "unitName": "", 
            "price": 1000, 
            "discount": 0, 
            "percentVat": 7 
        } 
    ], 
    "discount": 0, 
    "language": "th", 
    "note": "ทดสอบหมายเหตุ", 
    "receivedBy": "สมชาย", 
    "reIssue": true, 
    "refer": { 
        "number": "TIV20210300000", 
        "dateBE": "18/03/2564", 
        "reasonCode": "TIVC01" 
    } 
}