NAV
shell

Introduction

ยินดีต้อนรับสู่ Leceipt API!

ท่านสามารถใช้ API ของเรา โดยการเรียกใช้งาน Leceipt API endpoint ซึ่งใช้ในการสร้างเอกสาร e-Tax Invoice & e-Receipt

Leceipt API สร้างขึ้นจากพื้นฐานของ REST API โดยมีการรับข้อมูลจาก request bodies และส่งข้อมูล responses กลับ เป็นข้อมูลแบบ JSON และใช้มาตรฐาน HTTP response codes ในการตอบกลับ

ท่านสามารถใช้ Leceipt API ทดสอบการสร้างใบเสร็จรับเงินอิเล็กทรอนิกส์หรือใบกำกับภาษีอิเล็กทรอนิกส์ (e-Tax Invoice & e-Receipt) ได้ทันที หลังจากสร้างบัญชีผู้ใช้งาน ใบเสร็จรับเงินอิเล็กทรอนิกส์หรือใบกำกับภาษีอิเล็กทรอนิกส์ (e-Tax Invoice & e-Receipt) จะถูกสร้างจากใบรับรองอิเล็กทรอนิกส์สำหรับทดสอบ (Test Certificate) ซึ่งจะไม่ใช่ใบกำกับภาษีจริง และไม่ได้ส่งข้อมูลเข้าระบบของกรมสรรพากร

ใบเสร็จรับเงินอิเล็กทรอนิกส์หรือใบกำกับภาษีอิเล็กทรอนิกส์จะเป็นของจริงก็ต่อเมื่อท่านใช้ใบรับรองอิเล็กทรอนิกส์จริง ในการลงลายเซ็นดิจิทัล ซึ่งท่านสามารถติดตั้งใบรับรองอิเล็กทรอนิกส์จริงได้ในบัญชีของท่าน

Authentication

การทำ Authorization ใช้ Code ข้างล่างนี้:

# With shell, you can just pass the correct header with each request
curl "<api endpoint here>" \
  -H "API-Key: <your api key>"

ท่านต้องเปลี่ยน <your api key> เป็น API Key ของท่าน

Leceipt API ใช้ API Key ในการอนุญาตให้เรียกใช้ API ท่านสามารถดู API Key ของท่านได้ในบัญชีผู้ใช้งานของท่าน

API Key ของท่านมีความสำคัญมากเปรียบเสมือน Username และ Password โปรดเก็บรักษามันไว้ให้ดี และอย่าเก็บมันไว้ในที่คนอื่นเข้าถึงได้ เช่น บัญชีการใช้งานสาธารณะ GitHub หรือ Client Side Code

การเรียกใช้งาน Leceipt API ต้องใส่ API Key มาใน Header ด้วยทุกครั้ง ตามตัวอย่างนี้:

API-Key: <your api key>

ทุกๆ API request ต้องทำผ่าน HTTPS หากเรียกใช้งาน API ผ่าน HTTP การเรียกใช้งานจะถูกปฏิเสธ

Receipts/Tax Invoices

Create a Receipt/Tax Invoice

POST /etax/documents/receipts-taxinvoices

curl "https://api.leceipt.com/etax/documents/receipts-taxinvoices?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบไม่มีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "addressLineOne": "99 หมู่ 99 ถ.สาทร 99",
    "addressLineTwo": "แขวงสีลม เขตบางรัก กรุงเทพมหานคร",   
    "postcode": "10500",
    "branchNumber": "00000",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com"
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย" 
}

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบมีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "buildingNumber": "99",
    "address": "หมู่ที่ 99",
    "streetPrefix": "ถนน",
    "streetName": "สาทร 99",
    "branchNumber": "00000",
    "subDistrictPrefix": "แขวง",
    "subDistrictCode": "100402",
    "districtPrefix": "เขต",
    "districtCode": "1004",
    "provincePrefix": "",
    "provinceCode": "10",
    "postcode": "10500",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com",
    "unstructure": false
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย" 
}

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

ท่านสามารถนำ id ของ Job ไปสอบถามการสร้างไฟล์ ได้ที่ Endpoint Jobs

{
  "id": "f718ec36-05be-4321-a037-3611dd978643",  
  "createdTime": "2021-03-23T14:47:03.3419559Z",    
  "status": "processing"
}

Endpoint นี้ ใช้สำหรับสร้าง ใบเสร็จรับเงิน/ใบกำกับภาษี เอกสารที่สร้างจะเป็นไฟล์ PDF และไฟล์ XML

เอกสารจะถูกลงลายมือชื่อดิจิทัลด้วยใบรับรองอิเล็กทรอนิกส์ที่ท่านติดตั้งไว้ในบัญชีของท่าน

HTTP Request

POST https://api.leceipt.com/etax/documents/receipts-taxinvoices?api-version=2022-07-12

JSON Body Parameters

Parameter Type Description Required
number String เลขที่ ใบเสร็จรับเงิน/ใบกำกับภาษี Yes
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกใบเสร็จรับเงิน/ใบกำกับภาษี Yes
reference String เลขที่เอกสารอ้างอิง No
customer Object รายละเอียดผู้ซื้อสินค้าหรือบริการ Yes
items Array รายละเอียดสินค้าหรือบริการ Yes
discount Integer ส่วนลด No
note String หมายเหตุ ที่ต้องการแสดงในใบเสร็จรับเงิน/ใบกำกับภาษี No
receivedBy String ชื่อผู้รับเงิน No
includeVat Boolean ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat=true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat=false (default) No

Customer (ผู้ซื้อ)

รูปแบบที่อยู่ แบบไม่มีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
addressLineOne String ที่อยู่ บรรทัดที่ 1 Yes
addressLineTwo String ที่อยู่ บรรทัดที่ 2 No
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบไม่มีโครงสร้าง unstructure=true No

รูปแบบที่อยู่ แบบมีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
buildingNumber String บ้านเลขที่ Yes
address String ที่อยู่ Yes
streetPrefix String คำนำหน้าชื่อถนน เช่น ถนน ถ. (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
streetName String ชื่อถนน No
subDistrictPrefix String คำนำหน้าชื่อตำบล เช่น ตำบล ต. แขวง (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
subDistrictCode String รหัสตำบล Yes
districtPrefix String คำนำหน้าชื่ออำเภอ เช่น อำเภอ อ. เขต (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
districtCode String รหัสอำเภอ Yes
provincePrefix String คำนำหน้าชื่อจังหวัด เช่น จังหวัด (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
provinceCode String รหัสจังหวัด Yes
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบมีโครงสร้าง unstructure=false Yes

Items (รายละเอียดสินค้าหรือบริการ)

Parameter Type Description Required
number String ลำดับรายการสินค้าหรือบริการ Yes
description String รายละเอียดสินค้าหรือบริการ Yes
quantity Number จำนวนสินค้า Yes
unitName String หน่วยสินค้า No
price Number ราคาสินค้าหรือบริการ Yes
discount Number ส่วนลด No
percentVat Number เปอร์เซ็นภาษีมูลค่าเพิ่ม Yes

Tax Number Type (รหัสประเภทผู้เสียภาษี)

Tax Number Type Description
TXID ถ้า taxNumberType = "TXID" ให้ใส่ค่า taxId = เลขประจำตัวผู้เสียภาษีอาการสำหรับนิติบุคคล 13 หลัก
NIDN ถ้า taxNumberType = "NIDN" ให้ใส่ค่า taxId = เลขประจำตัวประชาชน 13 หลัก (สำหรับบุคคลธรรมดา)
CCPT ถ้า taxNumberType = "CCPT" ให้ใส่ค่า taxId = เลขหนังสือเดินทาง (Passport)
OTHR ถ้า taxNumberType = "OTHR" ให้ใส่ค่า taxId = หากไม่ต้องการระบุให้ระบุเป็น N/A

Unit Name (หน่วยสินค้า)

Unit Name (ภาษาไทย) Unit Name (ภาษาอังกฤษ)
- -
ชิ้น/อัน EA
กล่อง BX
แพ็ค PACK
หน่วย AU
ถุง BAG
ปี๊บ BKT
ขวด BT
กระป๋อง CAN
เซลล์ CELL
วัน DAY
ถัง DR
โหล DZ
แกลลอน GLL
งาน JOB
ชิ้น PCS
ชุด SET
เมตร METRE
หลา YARD

Percent Vat (เปอร์เซ็นภาษีมูลค่าเพิ่ม)

Percent Vat Description
-1 สินค้าหรือบริการได้รับยกเว้นภาษี
0 สินค้าหรือบริการมีภาษี 0%
7 สินค้าหรือบริการมีภาษี 7%

Receipts/Tax Invoices Abb

Create a Receipt/Tax Invoice Abb

POST /etax/documents/receipts-taxinvoices-abb

curl "https://api.leceipt.com/etax/documents/receipts-taxinvoices-abb?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบไม่มีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย" 
}

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบมีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",  
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย" 
}

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

ท่านสามารถนำ id ของ Job ไปสอบถามการสร้างไฟล์ ได้ที่ Endpoint Jobs

{
  "id": "f718ec36-05be-4321-a037-3611dd978643",  
  "createdTime": "2021-03-23T14:47:03.3419559Z",    
  "status": "processing"
}

Endpoint นี้ ใช้สำหรับสร้าง ใบเสร็จรับเงิน/ใบกำกับภาษีอย่างย่อ เอกสารที่สร้างจะเป็นไฟล์ PDF และไฟล์ XML

เอกสารจะถูกลงลายมือชื่อดิจิทัลด้วยใบรับรองอิเล็กทรอนิกส์ที่ท่านติดตั้งไว้ในบัญชีของท่าน

HTTP Request

POST https://api.leceipt.com/etax/documents/receipts-taxinvoices-abb?api-version=2022-07-12

JSON Body Parameters

Parameter Type Description Required
number String เลขที่ ใบเสร็จรับเงิน/ใบกำกับภาษี Yes
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกใบเสร็จรับเงิน/ใบกำกับภาษี Yes
items Array รายละเอียดสินค้าหรือบริการ Yes
discount Integer ส่วนลด No
note String หมายเหตุ ที่ต้องการแสดงในใบเสร็จรับเงิน/ใบกำกับภาษีอย่างย่อ No
receivedBy String ชื่อผู้รับเงิน No
includeVat Boolean ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat=true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat=false (default) No

Items (รายละเอียดสินค้าหรือบริการ)

Parameter Type Description Required
number String ลำดับรายการสินค้าหรือบริการ Yes
description String รายละเอียดสินค้าหรือบริการ Yes
quantity Number จำนวนสินค้า Yes
unitName String หน่วยสินค้า No
price Number ราคาสินค้าหรือบริการ Yes
discount Number ส่วนลด No
percentVat Number เปอร์เซ็นภาษีมูลค่าเพิ่ม Yes

Tax Number Type (รหัสประเภทผู้เสียภาษี)

Tax Number Type Description
TXID ถ้า taxNumberType = "TXID" ให้ใส่ค่า taxId = เลขประจำตัวผู้เสียภาษีอาการสำหรับนิติบุคคล 13 หลัก
NIDN ถ้า taxNumberType = "NIDN" ให้ใส่ค่า taxId = เลขประจำตัวประชาชน 13 หลัก (สำหรับบุคคลธรรมดา)
CCPT ถ้า taxNumberType = "CCPT" ให้ใส่ค่า taxId = เลขหนังสือเดินทาง (Passport)
OTHR ถ้า taxNumberType = "OTHR" ให้ใส่ค่า taxId = หากไม่ต้องการระบุให้ระบุเป็น N/A

Unit Name (หน่วยสินค้า)

Unit Name (ภาษาไทย) Unit Name (ภาษาอังกฤษ)
- -
ชิ้น/อัน EA
กล่อง BX
แพ็ค PACK
หน่วย AU
ถุง BAG
ปี๊บ BKT
ขวด BT
กระป๋อง CAN
เซลล์ CELL
วัน DAY
ถัง DR
โหล DZ
แกลลอน GLL
งาน JOB
ชิ้น PCS
ชุด SET
เมตร METRE
หลา YARD

Percent Vat (เปอร์เซ็นภาษีมูลค่าเพิ่ม)

Percent Vat Description
-1 สินค้าหรือบริการได้รับยกเว้นภาษี
0 สินค้าหรือบริการมีภาษี 0%
7 สินค้าหรือบริการมีภาษี 7%

Receipts

Create a Receipt

POST /etax/documents/receipts

curl "https://api.leceipt.com/etax/documents/receipts?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบไม่มีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "addressLineOne": "99 หมู่ 99 ถ.สาทร 99",
    "addressLineTwo": "แขวงสีลม เขตบางรัก กรุงเทพมหานคร",   
    "postcode": "10500",
    "branchNumber": "00000",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com"
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย" 
}

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบมีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "buildingNumber": "99",
    "address": "หมู่ที่ 99",
    "streetPrefix": "ถนน",
    "streetName": "สาทร 99",
    "branchNumber": "00000",
    "subDistrictPrefix": "แขวง",
    "subDistrictCode": "100402",
    "districtPrefix": "เขต",
    "districtCode": "1004",
    "provincePrefix": "",
    "provinceCode": "10",
    "postcode": "10500",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com",
    "unstructure": false
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย" 
}

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

ท่านสามารถนำ id ของ Job ไปสอบถามการสร้างไฟล์ ได้ที่ Endpoint Jobs

{
  "id": "f718ec36-05be-4321-a037-3611dd978643",  
  "createdTime": "2021-03-23T14:47:03.3419559Z",    
  "status": "processing"
}

Endpoint นี้ ใช้สำหรับสร้าง ใบเสร็จรับเงิน เอกสารที่สร้างจะเป็นไฟล์ PDF และไฟล์ XML

เอกสารจะถูกลงลายมือชื่อดิจิทัลด้วยใบรับรองอิเล็กทรอนิกส์ที่ท่านติดตั้งไว้ในบัญชีของท่าน

HTTP Request

POST https://api.leceipt.com/etax/documents/receipts?api-version=2022-07-12

JSON Body Parameters

Parameter Type Description Required
number String เลขที่ ใบเสร็จรับเงิน/ใบกำกับภาษี Yes
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกใบเสร็จรับเงิน/ใบกำกับภาษี Yes
reference String เลขที่เอกสารอ้างอิง No
customer Object รายละเอียดผู้ซื้อสินค้าหรือบริการ Yes
items Array รายละเอียดสินค้าหรือบริการ Yes
discount Integer ส่วนลด No
note String หมายเหตุ ที่ต้องการแสดงในใบเสร็จรับเงิน No
receivedBy String ชื่อผู้รับเงิน No
includeVat Boolean ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat=true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat=false (default) No

Customer (ผู้ซื้อ)

รูปแบบที่อยู่ แบบไม่มีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
addressLineOne String ที่อยู่ บรรทัดที่ 1 Yes
addressLineTwo String ที่อยู่ บรรทัดที่ 2 No
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบไม่มีโครงสร้าง unstructure=true No

รูปแบบที่อยู่ แบบมีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
buildingNumber String บ้านเลขที่ Yes
address String ที่อยู่ Yes
streetPrefix String คำนำหน้าชื่อถนน เช่น ถนน ถ. (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
streetName String ชื่อถนน No
subDistrictPrefix String คำนำหน้าชื่อตำบล เช่น ตำบล ต. แขวง (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
subDistrictCode String รหัสตำบล Yes
districtPrefix String คำนำหน้าชื่ออำเภอ เช่น อำเภอ อ. เขต (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
districtCode String รหัสอำเภอ Yes
provincePrefix String คำนำหน้าชื่อจังหวัด เช่น จังหวัด (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
provinceCode String รหัสจังหวัด Yes
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบมีโครงสร้าง unstructure=false Yes

Items (รายละเอียดสินค้าหรือบริการ)

Parameter Type Description Required
number String ลำดับรายการสินค้าหรือบริการ Yes
description String รายละเอียดสินค้าหรือบริการ Yes
quantity Number จำนวนสินค้า Yes
unitName String หน่วยสินค้า No
price Number ราคาสินค้าหรือบริการ Yes
discount Number ส่วนลด No
percentVat Number เปอร์เซ็นภาษีมูลค่าเพิ่ม Yes

Tax Number Type (รหัสประเภทผู้เสียภาษี)

Tax Number Type Description
TXID ถ้า taxNumberType = "TXID" ให้ใส่ค่า taxId = เลขประจำตัวผู้เสียภาษีอาการสำหรับนิติบุคคล 13 หลัก
NIDN ถ้า taxNumberType = "NIDN" ให้ใส่ค่า taxId = เลขประจำตัวประชาชน 13 หลัก (สำหรับบุคคลธรรมดา)
CCPT ถ้า taxNumberType = "CCPT" ให้ใส่ค่า taxId = เลขหนังสือเดินทาง (Passport)
OTHR ถ้า taxNumberType = "OTHR" ให้ใส่ค่า taxId = หากไม่ต้องการระบุให้ระบุเป็น N/A

Unit Name (หน่วยสินค้า)

Unit Name (ภาษาไทย) Unit Name (ภาษาอังกฤษ)
- -
ชิ้น/อัน EA
กล่อง BX
แพ็ค PACK
หน่วย AU
ถุง BAG
ปี๊บ BKT
ขวด BT
กระป๋อง CAN
เซลล์ CELL
วัน DAY
ถัง DR
โหล DZ
แกลลอน GLL
งาน JOB
ชิ้น PCS
ชุด SET
เมตร METRE
หลา YARD

Percent Vat (เปอร์เซ็นภาษีมูลค่าเพิ่ม)

Percent Vat Description
-1 สินค้าหรือบริการได้รับยกเว้นภาษี
0 สินค้าหรือบริการมีภาษี 0%
7 สินค้าหรือบริการมีภาษี 7%

Invoices/Tax Invoices

Create an Invoice/Tax Invoice

POST /etax/documents/invoices-taxinvoices

curl "https://api.leceipt.com/etax/documents/invoices-taxinvoices?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบไม่มีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "dueDateBE": "23/04/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "addressLineOne": "99 หมู่ 99 ถ.สาทร 99",
    "addressLineTwo": "แขวงสีลม เขตบางรัก กรุงเทพมหานคร",   
    "postcode": "10500",
    "branchNumber": "00000",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com"
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "createdBy": "สมชาย" 
}

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบมีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "dueDateBE": "23/04/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "buildingNumber": "99",
    "address": "หมู่ที่ 99",
    "streetPrefix": "ถนน",
    "streetName": "สาทร 99",
    "branchNumber": "00000",
    "subDistrictPrefix": "แขวง",
    "subDistrictCode": "100402",
    "districtPrefix": "เขต",
    "districtCode": "1004",
    "provincePrefix": "",
    "provinceCode": "10",
    "postcode": "10500",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com",
    "unstructure": false
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "createdBy": "สมชาย" 
}

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

ท่านสามารถนำ id ของ Job ไปสอบถามการสร้างไฟล์ ได้ที่ Endpoint Jobs

{
  "id": "f718ec36-05be-4321-a037-3611dd978643",  
  "createdTime": "2021-03-23T14:47:03.3419559Z",    
  "status": "processing"
}

Endpoint นี้ ใช้สำหรับสร้าง ใบแจ้งหนี้/ใบกำกับภาษี เอกสารที่สร้างจะเป็นไฟล์ PDF และไฟล์ XML

เอกสารจะถูกลงลายมือชื่อดิจิทัลด้วยใบรับรองอิเล็กทรอนิกส์ที่ท่านติดตั้งไว้ในบัญชีของท่าน

HTTP Request

POST https://api.leceipt.com/etax/documents/invoices-taxinvoices?api-version=2022-07-12

JSON Body Parameters

Parameter Type Description Required
number String เลขที่ ใบเสร็จรับเงิน/ใบกำกับภาษี Yes
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกใบเสร็จรับเงิน/ใบกำกับภาษี Yes
dueDateBE String วัน เดือน ปี (พ.ศ.) ที่ครบกำหนดชำระเงิน No
reference String เลขที่เอกสารอ้างอิง No
customer Object รายละเอียดผู้ซื้อสินค้าหรือบริการ Yes
items Array รายละเอียดสินค้าหรือบริการ Yes
discount Integer ส่วนลด No
note String หมายเหตุ ที่ต้องการแสดงในใบแจ้งหนี้/ใบกำกับภาษี No
createdBy String ชื่อผู้จัดทำ No
includeVat Boolean ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat=true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat=false (default) No

Customer (ผู้ซื้อ)

รูปแบบที่อยู่ แบบไม่มีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
addressLineOne String ที่อยู่ บรรทัดที่ 1 Yes
addressLineTwo String ที่อยู่ บรรทัดที่ 2 No
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบไม่มีโครงสร้าง unstructure=true No

รูปแบบที่อยู่ แบบมีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
buildingNumber String บ้านเลขที่ Yes
address String ที่อยู่ Yes
streetPrefix String คำนำหน้าชื่อถนน เช่น ถนน ถ. (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
streetName String ชื่อถนน No
subDistrictPrefix String คำนำหน้าชื่อตำบล เช่น ตำบล ต. แขวง (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
subDistrictCode String รหัสตำบล Yes
districtPrefix String คำนำหน้าชื่ออำเภอ เช่น อำเภอ อ. เขต (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
districtCode String รหัสอำเภอ Yes
provincePrefix String คำนำหน้าชื่อจังหวัด เช่น จังหวัด (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
provinceCode String รหัสจังหวัด Yes
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบมีโครงสร้าง unstructure=false Yes

Items (รายละเอียดสินค้าหรือบริการ)

Parameter Type Description Required
number String ลำดับรายการสินค้าหรือบริการ Yes
description String รายละเอียดสินค้าหรือบริการ Yes
quantity Number จำนวนสินค้า Yes
unitName String หน่วยสินค้า No
price Number ราคาสินค้าหรือบริการ Yes
discount Number ส่วนลด No
percentVat Number เปอร์เซ็นภาษีมูลค่าเพิ่ม Yes

Tax Number Type (รหัสประเภทผู้เสียภาษี)

Tax Number Type Description
TXID ถ้า taxNumberType = "TXID" ให้ใส่ค่า taxId = เลขประจำตัวผู้เสียภาษีอาการสำหรับนิติบุคคล 13 หลัก
NIDN ถ้า taxNumberType = "NIDN" ให้ใส่ค่า taxId = เลขประจำตัวประชาชน 13 หลัก (สำหรับบุคคลธรรมดา)
CCPT ถ้า taxNumberType = "CCPT" ให้ใส่ค่า taxId = เลขหนังสือเดินทาง (Passport)
OTHR ถ้า taxNumberType = "OTHR" ให้ใส่ค่า taxId = หากไม่ต้องการระบุให้ระบุเป็น N/A

Unit Name (หน่วยสินค้า)

Unit Name (ภาษาไทย) Unit Name (ภาษาอังกฤษ)
- -
ชิ้น/อัน EA
กล่อง BX
แพ็ค PACK
หน่วย AU
ถุง BAG
ปี๊บ BKT
ขวด BT
กระป๋อง CAN
เซลล์ CELL
วัน DAY
ถัง DR
โหล DZ
แกลลอน GLL
งาน JOB
ชิ้น PCS
ชุด SET
เมตร METRE
หลา YARD

Percent Vat (เปอร์เซ็นภาษีมูลค่าเพิ่ม)

Percent Vat Description
-1 สินค้าหรือบริการได้รับยกเว้นภาษี
0 สินค้าหรือบริการมีภาษี 0%
7 สินค้าหรือบริการมีภาษี 7%

Delivery Orders/Tax Invoices

Create a Delivery Orders/Tax Invoice

POST /etax/documents/deliveryorders-taxinvoices

curl "https://api.leceipt.com/etax/documents/deliveryorders-taxinvoices?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบไม่มีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "dueDateBE": "23/04/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "addressLineOne": "99 หมู่ 99 ถ.สาทร 99",
    "addressLineTwo": "แขวงสีลม เขตบางรัก กรุงเทพมหานคร",   
    "postcode": "10500",
    "branchNumber": "00000",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com"
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "createdBy": "สมชาย" 
}

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบมีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "dueDateBE": "23/04/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "buildingNumber": "99",
    "address": "หมู่ที่ 99",
    "streetPrefix": "ถนน",
    "streetName": "สาทร 99",
    "branchNumber": "00000",
    "subDistrictPrefix": "แขวง",
    "subDistrictCode": "100402",
    "districtPrefix": "เขต",
    "districtCode": "1004",
    "provincePrefix": "",
    "provinceCode": "10",
    "postcode": "10500",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com",
    "unstructure": false
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "createdBy": "สมชาย" 
}

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

ท่านสามารถนำ id ของ Job ไปสอบถามการสร้างไฟล์ ได้ที่ Endpoint Jobs

{
  "id": "f718ec36-05be-4321-a037-3611dd978643",  
  "createdTime": "2021-03-23T14:47:03.3419559Z",    
  "status": "processing"
}

Endpoint นี้ ใช้สำหรับสร้าง ใบส่งของ/ใบกำกับภาษี เอกสารที่สร้างจะเป็นไฟล์ PDF และไฟล์ XML

เอกสารจะถูกลงลายมือชื่อดิจิทัลด้วยใบรับรองอิเล็กทรอนิกส์ที่ท่านติดตั้งไว้ในบัญชีของท่าน

HTTP Request

POST https://api.leceipt.com/etax/documents/deliveryorders-taxinvoices?api-version=2022-07-12

JSON Body Parameters

Parameter Type Description Required
number String เลขที่ ใบเสร็จรับเงิน/ใบกำกับภาษี Yes
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกใบเสร็จรับเงิน/ใบกำกับภาษี Yes
dueDateBE String วัน เดือน ปี (พ.ศ.) ที่ครบกำหนดชำระเงิน No
reference String เลขที่เอกสารอ้างอิง No
customer Object รายละเอียดผู้ซื้อสินค้าหรือบริการ Yes
items Array รายละเอียดสินค้าหรือบริการ Yes
discount Integer ส่วนลด No
note String หมายเหตุ ที่ต้องการแสดงในใบส่งของ/ใบกำกับภาษี No
createdBy String ชื่อผู้จัดทำ No
includeVat Boolean ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat=true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat=false (default) No

Customer (ผู้ซื้อ)

รูปแบบที่อยู่ แบบไม่มีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
addressLineOne String ที่อยู่ บรรทัดที่ 1 Yes
addressLineTwo String ที่อยู่ บรรทัดที่ 2 No
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบไม่มีโครงสร้าง unstructure=true No

รูปแบบที่อยู่ แบบมีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
buildingNumber String บ้านเลขที่ Yes
address String ที่อยู่ Yes
streetPrefix String คำนำหน้าชื่อถนน เช่น ถนน ถ. (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
streetName String ชื่อถนน No
subDistrictPrefix String คำนำหน้าชื่อตำบล เช่น ตำบล ต. แขวง (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
subDistrictCode String รหัสตำบล Yes
districtPrefix String คำนำหน้าชื่ออำเภอ เช่น อำเภอ อ. เขต (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
districtCode String รหัสอำเภอ Yes
provincePrefix String คำนำหน้าชื่อจังหวัด เช่น จังหวัด (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
provinceCode String รหัสจังหวัด Yes
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบมีโครงสร้าง unstructure=false Yes

Items (รายละเอียดสินค้าหรือบริการ)

Parameter Type Description Required
number String ลำดับรายการสินค้าหรือบริการ Yes
description String รายละเอียดสินค้าหรือบริการ Yes
quantity Number จำนวนสินค้า Yes
unitName String หน่วยสินค้า No
price Number ราคาสินค้าหรือบริการ Yes
discount Number ส่วนลด No
percentVat Number เปอร์เซ็นภาษีมูลค่าเพิ่ม Yes

Tax Number Type (รหัสประเภทผู้เสียภาษี)

Tax Number Type Description
TXID ถ้า taxNumberType = "TXID" ให้ใส่ค่า taxId = เลขประจำตัวผู้เสียภาษีอาการสำหรับนิติบุคคล 13 หลัก
NIDN ถ้า taxNumberType = "NIDN" ให้ใส่ค่า taxId = เลขประจำตัวประชาชน 13 หลัก (สำหรับบุคคลธรรมดา)
CCPT ถ้า taxNumberType = "CCPT" ให้ใส่ค่า taxId = เลขหนังสือเดินทาง (Passport)
OTHR ถ้า taxNumberType = "OTHR" ให้ใส่ค่า taxId = หากไม่ต้องการระบุให้ระบุเป็น N/A

Unit Name (หน่วยสินค้า)

Unit Name (ภาษาไทย) Unit Name (ภาษาอังกฤษ)
- -
ชิ้น/อัน EA
กล่อง BX
แพ็ค PACK
หน่วย AU
ถุง BAG
ปี๊บ BKT
ขวด BT
กระป๋อง CAN
เซลล์ CELL
วัน DAY
ถัง DR
โหล DZ
แกลลอน GLL
งาน JOB
ชิ้น PCS
ชุด SET
เมตร METRE
หลา YARD

Percent Vat (เปอร์เซ็นภาษีมูลค่าเพิ่ม)

Percent Vat Description
-1 สินค้าหรือบริการได้รับยกเว้นภาษี
0 สินค้าหรือบริการมีภาษี 0%
7 สินค้าหรือบริการมีภาษี 7%

Tax Invoices

Create a Tax Invoice

POST /etax/documents/taxinvoices

curl "https://api.leceipt.com/etax/documents/taxinvoices?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบไม่มีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "addressLineOne": "99 หมู่ 99 ถ.สาทร 99",
    "addressLineTwo": "แขวงสีลม เขตบางรัก กรุงเทพมหานคร",   
    "postcode": "10500",
    "branchNumber": "00000",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com"
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "createdBy": "สมชาย" 
}

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบมีโครงสร้าง)

{  
  "number": "TIV20210300001",
  "dateBE": "23/03/2564",
  "reference": "PO1234",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "buildingNumber": "99",
    "address": "หมู่ที่ 99",
    "streetPrefix": "ถนน",
    "streetName": "สาทร 99",
    "branchNumber": "00000",
    "subDistrictPrefix": "แขวง",
    "subDistrictCode": "100402",
    "districtPrefix": "เขต",
    "districtCode": "1004",
    "provincePrefix": "",
    "provinceCode": "10",
    "postcode": "10500",
    "taxNumberType": "TXID",     
    "taxId": "1234567890123",       
    "phone": "0812345678",
    "email": "test@test.com",
    "unstructure": false
  },    
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 10000,
      "discount": 0,
      "percentVat": 7
    },
    {
      "number": "2",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 20000,
      "discount": 0,
      "percentVat": 7
    }  
  ],
  "note": "ทดสอบหมายเหตุ",    
  "createdBy": "สมชาย" 
}

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

ท่านสามารถนำ id ของ Job ไปสอบถามการสร้างไฟล์ ได้ที่ Endpoint Jobs

{
  "id": "f718ec36-05be-4321-a037-3611dd978643",  
  "createdTime": "2021-03-23T14:47:03.3419559Z",    
  "status": "processing"
}

Endpoint นี้ ใช้สำหรับสร้าง ใบกำกับภาษี เอกสารที่สร้างจะเป็นไฟล์ PDF และไฟล์ XML

เอกสารจะถูกลงลายมือชื่อดิจิทัลด้วยใบรับรองอิเล็กทรอนิกส์ที่ท่านติดตั้งไว้ในบัญชีของท่าน

HTTP Request

POST https://api.leceipt.com/etax/documents/taxinvoices?api-version=2022-07-12

JSON Body Parameters

Parameter Type Description Required
number String เลขที่ ใบเสร็จรับเงิน/ใบกำกับภาษี Yes
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกใบเสร็จรับเงิน/ใบกำกับภาษี Yes
reference String เลขที่เอกสารอ้างอิง No
customer Object รายละเอียดผู้ซื้อสินค้าหรือบริการ Yes
items Array รายละเอียดสินค้าหรือบริการ Yes
discount Integer ส่วนลด No
note String หมายเหตุ ที่ต้องการแสดงในใบกำกับภาษี No
createdBy String ชื่อผู้จัดทำ No
includeVat Boolean ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat=true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat=false (default) No

Customer (ผู้ซื้อ)

รูปแบบที่อยู่ แบบไม่มีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
addressLineOne String ที่อยู่ บรรทัดที่ 1 Yes
addressLineTwo String ที่อยู่ บรรทัดที่ 2 No
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบไม่มีโครงสร้าง unstructure=true No

รูปแบบที่อยู่ แบบมีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
buildingNumber String บ้านเลขที่ Yes
address String ที่อยู่ Yes
streetPrefix String คำนำหน้าชื่อถนน เช่น ถนน ถ. (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
streetName String ชื่อถนน No
subDistrictPrefix String คำนำหน้าชื่อตำบล เช่น ตำบล ต. แขวง (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
subDistrictCode String รหัสตำบล Yes
districtPrefix String คำนำหน้าชื่ออำเภอ เช่น อำเภอ อ. เขต (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
districtCode String รหัสอำเภอ Yes
provincePrefix String คำนำหน้าชื่อจังหวัด เช่น จังหวัด (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
provinceCode String รหัสจังหวัด Yes
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบมีโครงสร้าง unstructure=false Yes

Items (รายละเอียดสินค้าหรือบริการ)

Parameter Type Description Required
number String ลำดับรายการสินค้าหรือบริการ Yes
description String รายละเอียดสินค้าหรือบริการ Yes
quantity Number จำนวนสินค้า Yes
unitName String หน่วยสินค้า No
price Number ราคาสินค้าหรือบริการ Yes
discount Number ส่วนลด No
percentVat Number เปอร์เซ็นภาษีมูลค่าเพิ่ม Yes

Tax Number Type (รหัสประเภทผู้เสียภาษี)

Tax Number Type Description
TXID ถ้า taxNumberType = "TXID" ให้ใส่ค่า taxId = เลขประจำตัวผู้เสียภาษีอาการสำหรับนิติบุคคล 13 หลัก
NIDN ถ้า taxNumberType = "NIDN" ให้ใส่ค่า taxId = เลขประจำตัวประชาชน 13 หลัก (สำหรับบุคคลธรรมดา)
CCPT ถ้า taxNumberType = "CCPT" ให้ใส่ค่า taxId = เลขหนังสือเดินทาง (Passport)
OTHR ถ้า taxNumberType = "OTHR" ให้ใส่ค่า taxId = หากไม่ต้องการระบุให้ระบุเป็น N/A

Unit Name (หน่วยสินค้า)

Unit Name (ภาษาไทย) Unit Name (ภาษาอังกฤษ)
- -
ชิ้น/อัน EA
กล่อง BX
แพ็ค PACK
หน่วย AU
ถุง BAG
ปี๊บ BKT
ขวด BT
กระป๋อง CAN
เซลล์ CELL
วัน DAY
ถัง DR
โหล DZ
แกลลอน GLL
งาน JOB
ชิ้น PCS
ชุด SET
เมตร METRE
หลา YARD

Percent Vat (เปอร์เซ็นภาษีมูลค่าเพิ่ม)

Percent Vat Description
-1 สินค้าหรือบริการได้รับยกเว้นภาษี
0 สินค้าหรือบริการมีภาษี 0%
7 สินค้าหรือบริการมีภาษี 7%

Debit Notes

Create a Debit Note

POST /etax/documents/debit-notes/pdf

curl "https://api.leceipt.com/etax/documents/debit-notes?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบไม่มีโครงสร้าง)

{  
  "number": "TIV20210100001",
  "dateBE": "20/03/2564",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "addressLineOne": "99 หมู่ 99 ถ.สาทร 99",    
    "addressLineTwo": "แขวงสีลม เขตบางรัก กรุงเทพมหานคร",     
    "postcode": "10500",
    "branchNumber": "00000",
    "taxNumberType": "TXID",  
    "taxId": "1234567890123",      
    "phone": "0812345678",
    "email": "test@test.com"
  },  
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 1000,
      "total": 1000
    }
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย",  
  "refer": {
    "number": "RCT-TIV-0001",
    "dateBE": "18/03/2564",
    "typeCode": "T03",
    "reasonCode": "DBNG99",
    "specificReason": "ทดสอบสาเหตุ",    
    "amountTotal": 10,
  },
  "calculationMethod": 1
}

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบมีโครงสร้าง)

{  
  "number": "TIV20210100001",
  "dateBE": "20/03/2564",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "buildingNumber": "99",
    "address": "หมู่ที่ 99",
    "streetPrefix": "ถนน",
    "streetName": "สาทร 99",
    "branchNumber": "00000",
    "subDistrictPrefix": "แขวง",
    "subDistrictCode": "100402",
    "districtPrefix": "เขต",
    "districtCode": "1004",
    "provincePrefix": "",
    "provinceCode": "10",
    "postcode": "10500",
    "taxNumberType": "TXID",  
    "taxId": "1234567890123",      
    "phone": "0812345678",
    "email": "test@test.com",
    "unstructure": false
  },  
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 1000,
      "total": 1000
    }
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย",  
  "refer": {
    "number": "RCT-TIV-0001",
    "dateBE": "18/03/2564",
    "typeCode": "T03",
    "reasonCode": "DBNG99",
    "specificReason": "ทดสอบสาเหตุ",    
    "amountTotal": 10,
  },
  "calculationMethod": 1
}

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

ท่านสามารถนำ id ของ Job ไปสอบถามการสร้างไฟล์ ได้ที่ Endpoint Jobs

{
  "id": "6e09b9c4-c352-4fff-be6c-f0b3d15cc8d2",  
  "createdTime": "2021-03-20T15:38:20.8591569Z",    
  "status": "processing"
}

Endpoint นี้ ใช้สำหรับสร้าง ใบเพิ่มหนี้ เอกสารที่สร้างจะเป็นไฟล์ PDF และไฟล์ XML

เอกสารจะถูกลงลายมือชื่อดิจิทัลด้วยใบรับรองอิเล็กทรอนิกส์ที่ท่านติดตั้งไว้ในบัญชีของท่าน

HTTP Request

POST https://api.leceipt.com/etax/documents/debit-notes?api-version=2022-07-12

JSON Body Parameters

Parameter Type Description Required
number String เลขที่ ใบเพิ่มหนี้ Yes
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกใบเพิ่มหนี้ Yes
customer Object รายละเอียดผู้ซื้อสินค้าหรือบริการ Yes
items Array รายละเอียดสินค้าหรือบริการ Yes
note String หมายเหตุ ที่ต้องการแสดงในใบเพิ่มหนี้ No
createdBy String ชื่อผู้จัดทำ No
refer Object เอกสารอ้างถึง Yes
includeVat Boolean ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat=true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat=false (default) No
calculationMethod Number ราคาเพิ่มหนี้ calculationMethod=1 (default), ราคาจริง calculationMethod=2 No

Customer (ผู้ซื้อ)

รูปแบบที่อยู่ แบบไม่มีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
addressLineOne String ที่อยู่ บรรทัดที่ 1 Yes
addressLineTwo String ที่อยู่ บรรทัดที่ 2 No
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบไม่มีโครงสร้าง unstructure=true No

รูปแบบที่อยู่ แบบมีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
buildingNumber String บ้านเลขที่ Yes
address String ที่อยู่ Yes
streetPrefix String คำนำหน้าชื่อถนน เช่น ถนน ถ. (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
streetName String ชื่อถนน No
subDistrictPrefix String คำนำหน้าชื่อตำบล เช่น ตำบล ต. แขวง (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
subDistrictCode String รหัสตำบล Yes
districtPrefix String คำนำหน้าชื่ออำเภอ เช่น อำเภอ อ. เขต (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
districtCode String รหัสอำเภอ Yes
provincePrefix String คำนำหน้าชื่อจังหวัด เช่น จังหวัด (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
provinceCode String รหัสจังหวัด Yes
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบมีโครงสร้าง unstructure=false Yes

Items (รายละเอียดสินค้าหรือบริการ)

Parameter Type Description Required
number String ลำดับรายการสินค้าหรือบริการ Yes
description String รายละเอียดสินค้าหรือบริการ Yes
quantity Number จำนวนสินค้า Yes
unitName String หน่วยสินค้า No
price Number ราคาสินค้าหรือบริการ Yes
discount Number ส่วนลด No
percentVat Number เปอร์เซ็นต์ภาษีมูลค่าเพิ่ม Yes

Refer (เอกสารอ้างถึง)

Parameter Type Description Required
number String เลขที่เอกสารอ้างถึง Yes
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกเอกสารอ้างถึง Yes
typeCode String รหัสประเภทเอกสารอ้างถึง เช่น T03 Yes
reasonCode String รหัสสาเหตุการออกใบเพิ่มหนี้ Yes
specificReason String หากสาเหตุเป็นอื่นๆ ต้องระบุเหตุผล (Required = Yes) No
amountTotal Number มูลค่าสินค้าหรือบริการตามเอกสารเดิม Yes

Tax Number Type (รหัสประเภทผู้เสียภาษี)

Tax Number Type Description
TXID ถ้า taxNumberType = "TXID" ให้ใส่ค่า taxId = เลขประจำตัวผู้เสียภาษีอาการสำหรับนิติบุคคล 13 หลัก
NIDN ถ้า taxNumberType = "NIDN" ให้ใส่ค่า taxId = เลขประจำตัวประชาชน 13 หลัก (สำหรับบุคคลธรรมดา)
CCPT ถ้า taxNumberType = "CCPT" ให้ใส่ค่า taxId = เลขหนังสือเดินทาง (Passport)
OTHR ถ้า taxNumberType = "OTHR" ให้ใส่ค่า taxId = หากไม่ต้องการระบุให้ระบุเป็น N/A

Unit Name (หน่วยสินค้า)

Unit Name (ภาษาไทย) Unit Name (ภาษาอังกฤษ)
- -
ชิ้น/อัน EA
กล่อง BX
แพ็ค PACK
หน่วย AU
ถุง BAG
ปี๊บ BKT
ขวด BT
กระป๋อง CAN
เซลล์ CELL
วัน DAY
ถัง DR
โหล DZ
แกลลอน GLL
งาน JOB
ชิ้น PCS
ชุด SET
เมตร METRE
หลา YARD

Percent Vat (เปอร์เซ็นภาษีมูลค่าเพิ่ม)

Percent Vat Description
-1 สินค้าหรือบริการได้รับยกเว้นภาษี
0 สินค้าหรือบริการมีภาษี 0%
7 สินค้าหรือบริการมีภาษี 7%

Type Code (รหัสประเภทเอกสารอ้างถึง)

Type Code Type Name
388 ใบกำกับภาษี (Tax Invoice)
T02 ใบแจ้งหนี้/ใบกำกับภาษี (Invoice/Tax Invoice)
T03 ใบเสร็จรับเงิน/ใบกำกับภาษี (Receipt/Tax Invoice)
T04 ใบส่งของ/ใบกำกับภาษี (Delivery order/Tax Invoice)

Reason Code (รหัสสาเหตุการออกใบเพิ่มหนี้ กรณีขายสินค้า)

Reason Code Reason Name
DBNG01 มีการเพิ่มราคาค่าสินค้า (สินค้าเกินกว่าจำนวนที่ตกลงกัน)
DBNG02 คำนวณราคาสินค้า ผิดพลาดต่ำกว่าที่เป็นจริง
DBNG99 เหตุอื่นๆ (ระบุสาเหตุ)

Reason Code (รหัสสาเหตุการออกใบเพิ่มหนี้ กรณีบริการ)

Reason Code Reason Name
DBNS01 การเพิ่มราคาค่าบริการ (บริการเกินกว่าข้อกำหนดที่ตกลงกัน)
DBNS02 คำนวณราคาค่าบริการ ผิดพลาดต่ำกว่าที่เป็นจริง
DBNS99 เหตุอื่นๆ (ระบุสาเหตุ)

Credit Notes

Create a Credit Note

POST /etax/documents/credit-notes/pdf

curl "https://api.leceipt.com/etax/documents/credit-notes?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบไม่มีโครงสร้าง)

{  
  "number": "TIV20210100001",
  "dateBE": "20/03/2564",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "addressLineOne": "99 หมู่ 99 ถ.สาทร 99",    
    "addressLineTwo": "แขวงสีลม เขตบางรัก กรุงเทพมหานคร",     
    "postcode": "10500",
    "branchNumber": "00000",
    "taxNumberType": "TXID",
    "taxId": "1234567890123",        
    "phone": "0812345678",
    "email": "test@test.com",
  },  
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 1000,
      "discount": 0,
      "percentVat": 7
    }
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย",  
  "refer": {
    "number": "RCT-TIV-0001",
    "dateBE": "18/03/2564",
    "typeCode": "T03",
    "reasonCode": "CDNG99",
    "specificReason": "ทดสอบสาเหตุ",    
    "amountTotal": 1000000
  },
  "calculationMethod": 1
}

ตัวอย่าง JSON Body Parameters (ที่อยู่ แบบมีโครงสร้าง)

{  
  "number": "TIV20210100001",
  "dateBE": "20/03/2564",
  "customer": {
    "name": "บริษัท ลูกค้าทดสอบ จำกัด",
    "buildingNumber": "99",
    "address": "หมู่ที่ 99",
    "streetPrefix": "ถนน",
    "streetName": "สาทร 99",
    "branchNumber": "00000",
    "subDistrictPrefix": "แขวง",
    "subDistrictCode": "100402",
    "districtPrefix": "เขต",
    "districtCode": "1004",
    "provincePrefix": "",
    "provinceCode": "10",
    "postcode": "10500",
    "taxNumberType": "TXID",
    "taxId": "1234567890123",        
    "phone": "0812345678",
    "email": "test@test.com",
    "unstructure": false
  },  
  "items": [
    {
      "number": "1",
      "description": "ค่าอาหารและเครื่องดื่ม",
      "quantity": 1,
      "unitName": "",
      "price": 1000,
      "discount": 0,
      "percentVat": 7
    }
  ],
  "note": "ทดสอบหมายเหตุ",    
  "receivedBy": "สมชาย",  
  "refer": {
    "number": "RCT-TIV-0001",
    "dateBE": "18/03/2564",
    "typeCode": "T03",
    "reasonCode": "CDNG99",
    "specificReason": "ทดสอบสาเหตุ",    
    "amountTotal": 1000000
  },
  "calculationMethod": 1
}

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

ท่านสามารถนำ id ของ Job ไปสอบถามการสร้างไฟล์ ได้ที่ Endpoint Jobs

{
  "id": "e6d93be0-5fc7-4474-b64c-10bcd58a5bf4",  
  "createdTime": "2021-03-20T15:39:59.8281753Z",    
  "status": "processing"
}

Endpoint นี้ ใช้สำหรับสร้าง ใบลดหนี้ เอกสารที่สร้างจะเป็นไฟล์ PDF และไฟล์ XML

เอกสารจะถูกลงลายมือชื่อดิจิทัลด้วยใบรับรองอิเล็กทรอนิกส์ที่ท่านติดตั้งไว้ในบัญชีของท่าน

HTTP Request

POST https://api.leceipt.com/etax/documents/credit-notes?api-version=2022-07-12

JSON Body Parameters

Parameter Type Description Required
number String เลขที่ ใบลดหนี้ Yes
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกใบลดหนี้ Yes
customer Object รายละเอียดผู้ซื้อสินค้าหรือบริการ Yes
items Array รายละเอียดสินค้าหรือบริการ Yes
discount Number ส่วนลด No
note String หมายเหตุ ที่ต้องการแสดงในใบลดหนี้ No
createdBy String ชื่อจัดทำ No
refer Object เอกสารอ้างถึง Yes
includeVat Boolean ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat=true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat=false (default) No
calculationMethod Number ราคาลดหนี้ calculationMethod=1 (default), ราคาจริง calculationMethod=2 No

Customer (ผู้ซื้อ)

รูปแบบที่อยู่ แบบไม่มีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
addressLineOne String ที่อยู่ บรรทัดที่ 1 Yes
addressLineTwo String ที่อยู่ บรรทัดที่ 2 No
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบไม่มีโครงสร้าง unstructure=true No

รูปแบบที่อยู่ แบบมีโครงสร้าง

Parameter Type Description Required
name String ชื่อผู้ขายสินค้าหรือบริการ Yes
buildingNumber String บ้านเลขที่ Yes
address String ที่อยู่ Yes
streetPrefix String คำนำหน้าชื่อถนน เช่น ถนน ถ. (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
streetName String ชื่อถนน No
subDistrictPrefix String คำนำหน้าชื่อตำบล เช่น ตำบล ต. แขวง (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
subDistrictCode String รหัสตำบล Yes
districtPrefix String คำนำหน้าชื่ออำเภอ เช่น อำเภอ อ. เขต (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
districtCode String รหัสอำเภอ Yes
provincePrefix String คำนำหน้าชื่อจังหวัด เช่น จังหวัด (ถ้าไม่ต้องการให้แสดงให้ใส่ "") No
provinceCode String รหัสจังหวัด Yes
postcode String รหัสไปรษณีย์ Yes
countryName String ประเทศ No
branchNumber String รหัสสาขา สำนักงานใหญ่เป็น 00000 Yes
taxNumberType String รหัสประเภทผู้เสียภาษี Yes
taxId String เลขประจำตัวผู้เสียภาษี Yes
phone String เบอร์โทรศัพท์ No
email String อีเมล No
unstructure Boolean ที่อยู่แบบมีโครงสร้าง unstructure=false Yes

Items (รายละเอียดสินค้าหรือบริการ)

Parameter Type Description Required
number String ลำดับรายการสินค้าหรือบริการ Yes
description String รายละเอียดสินค้าหรือบริการ Yes
quantity Number จำนวนสินค้า Yes
unitName String หน่วยสินค้า No
price Number ราคาสินค้าหรือบริการ Yes
discount Number ส่วนลด No
percentVat Number เปอร์เซ็นต์ภาษีมูลค่าเพิ่ม Yes

Refer (เอกสารอ้างถึง)

Parameter Type Description Required
dateBE String วัน เดือน ปี (พ.ศ.) ที่ออกเอกสารอ้างถึง Yes
number String เลขที่เอกสารอ้างถึง Yes
typeCode String รหัสประเภทเอกสารอ้างถึง เช่น T03 Yes
reasonCode String รหัสสาเหตุการออกใบลดหนี้ Yes
specificReason String หากสาเหตุเป็นอื่นๆ ต้องระบุเหตุผล (Required = Yes) No
amountTotal Number มูลค่าสินค้าหรือบริการตามเอกสารเดิม Yes

Tax Number Type (รหัสประเภทผู้เสียภาษี)

Tax Number Type Description
TXID ถ้า taxNumberType = "TXID" ให้ใส่ค่า taxId = เลขประจำตัวผู้เสียภาษีอาการสำหรับนิติบุคคล 13 หลัก
NIDN ถ้า taxNumberType = "NIDN" ให้ใส่ค่า taxId = เลขประจำตัวประชาชน 13 หลัก (สำหรับบุคคลธรรมดา)
CCPT ถ้า taxNumberType = "CCPT" ให้ใส่ค่า taxId = เลขหนังสือเดินทาง (Passport)
OTHR ถ้า taxNumberType = "OTHR" ให้ใส่ค่า taxId = หากไม่ต้องการระบุให้ระบุเป็น N/A

Unit Name (หน่วยสินค้า)

Unit Name (ภาษาไทย) Unit Name (ภาษาอังกฤษ)
- -
ชิ้น/อัน EA
กล่อง BX
แพ็ค PACK
หน่วย AU
ถุง BAG
ปี๊บ BKT
ขวด BT
กระป๋อง CAN
เซลล์ CELL
วัน DAY
ถัง DR
โหล DZ
แกลลอน GLL
งาน JOB
ชิ้น PCS
ชุด SET
เมตร METRE
หลา YARD

Percent Vat (เปอร์เซ็นภาษีมูลค่าเพิ่ม)

Percent Vat Description
-1 สินค้าหรือบริการได้รับยกเว้นภาษี
0 สินค้าหรือบริการมีภาษี 0%
7 สินค้าหรือบริการมีภาษี 7%

Type Code (รหัสประเภทเอกสารอ้างถึง)

Type Code Type Name
388 ใบกำกับภาษี (Tax Invoice)
T02 ใบแจ้งหนี้/ใบกำกับภาษี (Invoice/Tax Invoice)
T03 ใบเสร็จรับเงิน/ใบกำกับภาษี (Receipt/Tax Invoice)
T04 ใบส่งของ/ใบกำกับภาษี (Delivery order/Tax Invoice)

Reason Code (รหัสสาเหตุการออกใบลดหนี้ กรณีขายสินค้า)

Reason Code Reason Name
CDNG01 ลดราคาสินค้าที่ขาย (สินค้าผิดข้อกำหนดที่ตกลงกัน)
CDNG02 สินค้าชำรุดเสียหาย
CDNG03 สินค้าขาดจำนวนตามที่ตกลงซื้อขาย
CDNG04 คำนวณราคาสินค้าผิดพลาดสูงกว่าที่เป็นจริง
CDNG05 รับคืนสินค้า (ไม่ตรงตามคำพรรณา)
CDNG99 เหตุอื่นๆ (ระบุสาเหตุ)

Reason Code (รหัสสาเหตุการออกใบลดหนี้ กรณีบริการ)

Reason Code Reason Name
CDNS01 ลดค่าบริการ (บริการผิดข้อกำหนดที่ตกลงกัน)
CDNS02 ค่าบริการขาดจำนวน
CDNS03 คำนวณราคาค่าบริการผิดพลาดสูงกว่าที่เป็นจริง
CDNS04 บอกเลิกสัญญาบริการ
CDNS99 เหตุอื่น (ระบุสาเหตุ)

Jobs

Retreive a job

GET /etax/jobs/{jobId}

curl "https://api.leceipt.com/etax/jobs/{jobId}?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

ถ้าไฟล์ยังสร้างไม่เสร็จ

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

{
  "id": "e6d93be0-5fc7-4474-b64c-10bcd58a5bf4",  
  "createdTime": "2021-03-20T15:39:59.8281753Z",    
  "status": "processing"
}

ถ้าไฟล์สร้างเสร็จแล้ว

คำสั่งด้านบนจะ Response JSON เป็นรายละเอียด Job ตามโครงสร้างข้างล่างนี้

ท่านสามารถนำ fileId ไปดาวน์โหลดไฟล์ได้ที่ Endpoint Files

{
  "id": "e6d93be0-5fc7-4474-b64c-10bcd58a5bf4",  
  "createdTime": "2021-03-20T15:39:59.8281753Z",
  "lastUpdatedTime": "2021-03-20T15:41:59.8281753Z",
  "fileId": "c2508592-90aa-45fc-af1d-ea3acd7e072b",
  "fileSize": 208825,    
  "status": "complete"
}

Endpoint นี้ ใช้สำหรับสอบถามสถานะการสร้างไฟล์

หากไฟล์สร้างเสร็จแล้ว ค่าของ status จะเป็น Complete

และจะมี fileId ซึ่งท่านสามารถนำ fileId ไปดาวน์โหลดไฟล์ได้ที่ Endpoint Files

HTTP Request

GET https://api.leceipt.com/etax/jobs/{jobId}?api-version=2022-07-12

Files

Download a file

GET /etax/files/{fileId}

curl "https://api.leceipt.com/etax/files/{fileId}?api-version=2022-07-12" \
  -H "Content-Type: application/json" \
  -H "API-Key: <your api key>"

คำสั่งด้านบนจะ Response ไฟล์กลับมา

ถ้าเป็นไฟล์ PDF จะ Response กลับมาเป็นไฟล์ PDF

{
  "$content-type": "application/pdf",
  "$content": "JVBERi0xLjQKJdPr6eEK..........."
}

ถ้าเป็นไฟล์ XML จะ Response กลับมาเป็นไฟล์ XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>...

Endpoint นี้ ใช้สำหรับดาวน์โหลดไฟล์

โดยระบุ fileId ที่ได้รับ หลังจากการสร้างเอกสารอิเล็กทรอนิกส์

HTTP Request

GET https://api.leceipt.com/etax/files/{fileId}?api-version=2022-07-12

shell