How to use Postman create e-Invoice & e-Tax Invoice via API

How to use Postman generate e-Invoice/e-Tax Invoice via Leceipt API

If you want to create e-Tax Invoice & e-Receipt documents through your system. This guide will teach you how to create a simple etax document via Postman with sample code for easy understanding.

You can import the collection using the link below.

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

1. Generate API Key

2. Provide information

3. Send Request to Postman

4. Save FileId for Download

5. Download PDF file

1. Generate API Key

This API key will be used to connect the API to the Leceipt system. The method for generating it is in the link below.

How to generate an API Key: https://www.leceipt.com/docs/etax/api-key

2. Provide information

Provide important information in order to create documents on Leceipt. You can see examples of information on Github

Customer

Structure

Parameters	Require	Type	Meaning
name	yes	string	Seller name
buildingNumber	yes	string	Building Number
address	yes	string	Address
streetprefix	no	string	Street Prefix
streetName	no	string	Street Name
subDistrictPrefix	no	string	Sub-District Prefix
subDistrictCode	yes	string	Sub-District Code
districtPrefix	no	string	District Prefix
districtCode	yes	string	District Code
provincePrefix	no	string	Province Prefix
provinceCode	yes	string	Province Code
postcode	yes	string	Postcode
branchNumber	yes	string	Branch Number
taxNumberType	yes	string	Tax Number Type
taxId	yes	string	Tax Id
phone	no	string	Phone number
email	no	string	Email
unstructure	yes	boolean	Specify “false” if it is a structure address.

Example

{ 
    "customer": { 
        "name": "Buyer Test Co.,LTD.", 
        "addressLineOne": "999 Moo 999 Sathorn Rd. 99", 
        "addressLineTwo": "Silom BanRak Bangkok", 
        "countryName": "Thailand", 
        "postcode": "10500", 
        "branchNumber": "00000", 
        "taxNumberType": "TXID", 
        "taxId": "1234567890123", 
        "phone": "0812345678", 
        "email": "test@test.com", 
        "unstructure": true 
    } 
}

Unstructure

Parameters	Require	Type	Meaning
name	yes	string	Seller name
addressLineOne	yes	string	Address Line One
addressLineTwo	no	string	Address Line Two
postcode	yes	string	Postcode
countryName	no	string	Country
branchNumber	yes	string	Branch Number
taxNumberType	yes	string	Tax Number Type
taxId	yes	string	Tax Id
phone	no	string	Phone number
email	no	string	Email
unstructure	no	string	Specify “true” if it is an unstructure address.

Example

{ 
    "customer": { 
        "name": "Buyer Test Co.,LTD.", 
        "buildingNumber": "99",
        "address": "Moo 99",
        "streetName": "Sathorn 99",
        "branchNumber": "00000",
        "subDistrictCode": "100402",
        "districtCode": "1004",
        "provinceCode": "10",
        "postcode": "10500",
        "taxNumberType": "TXID",
        "taxId": "1234567890123", 
        "phone": "0812345678", 
        "email": "test@test.com",
        "unstructure": false
    } 
}

items

This parameter is an Array. If the document contains multiple items or services, add an Object to this Array manually.

Parameters	Require	Type	Meaning
number	yes	number	Order of goods or services
description	yes	string	Product or service details
quantity	yes	number	Number of products
unitName	no	string	Product unit
price	yes	number	Price of goods or services
discount	no	number	Product or service discounts
percentVat	yes	number	The item’s tax percentage includes, if it’s a tax-exempt item, indicate -1, if it’s a 0% tax item, indicate 0, if it’s a 7% tax item, specify 7.

Example

{ 
    "items": [ 
        { 
            "number": 1, 
            "description": "Food and beverage", 
            "quantity": 1, 
            "unitName": "EA", 
            "price": 1500, 
            "discount": 0, 
            "percentVat": 0 
        }, 
        { 
            "number": 2, 
            "description": "Food and beverage", 
            "quantity": 1, 
            "unitName": "", 
            "price": 1000, 
            "discount": 0, 
            "percentVat": 7 
        } 
    ] 
}

refer

Refer here refers to the reference document. If no documents are issued in lieu of the original This section is not required to be filled out.

Parameters

Require

Type

Meaning

number

yes

string

Reference document number

dateBE

yes

string

Date, month, year (B.E.) the document was issued to refer to.

reasonCode

yes

string

Reason Code

specificReason

yes (ถ้า reasonCode เป็น TIVC99)

string

Other reason

ตัวอย่าง

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

data

Parameters	Require	Type	Meaning
number	yes	string	No. Invoice/Tax Invoice
reference	no	string	Reference number
dateBE	yes	string	Date, month, year (B.E.) the Invoice/Tax Invoice is issued.
dueDateBE	no	string	Date Month Year (B.E.) Due Date of Invoice/Tax Invoice
includeVat	no	boolean	The price of the product or service includes Vat includeVat=true, the price of the product or service does not include Vat includeVat=false (default).
customer	yes	object	Details of the purchaser of the product or service.
items	yes	array	Product or service details.
language	no	string	Language (includes th (Thai) (default) and en (English)
discount	no	number	Total discount
note	no	string	Remarks that need to be shown in the Invoice/Tax Invoice
createdBy	no	string	Created By
reIssue	no	boolean	If a document is issued in lieu of the original one, specify true, if not, specify false (default).
refer	yes (ถ้า reIssue เป็น true)	object	Reference document

Example

{ 
    "number": "TIV20210300001", 
    "dateBE": "23/03/2564", 
    "includeVat": false, 
    "items": [ 
        { 
            "number": 1, 
            "description": "Food and beverage", 
            "quantity": 1, 
            "unitName": "EA", 
            "price": 1500, 
            "discount": 0, 
            "percentVat": 0 
        }, 
        { 
            "number": 2, 
            "description": "Food and beverage", 
            "quantity": 1, 
            "unitName": "", 
            "price": 1000, 
            "discount": 0, 
            "percentVat": 7 
        } 
    ], 
    "discount": 0, 
    "language": "th", 
    "customer": { 
        "name": "Buyer Test Co.,LTD.", 
        "buildingNumber": "99", 
        "address": "Moo 99", 
        "streetName": "Sathorn 99", 
        "branchNumber": "00000", 
        "subDistrictCode": "100402", 
        "districtCode": "1004", 
        "provinceCode": "10", 
        "postcode": "10500", 
        "taxNumberType": "TXID", 
        "taxId": "1234567890123", 
        "phone": "0812345678", 
        "email": "test@test.com", 
        "unstructure": false 
    }, 
    "note": "Test Notes", 
    "createdBy": "Somchai", 
    "reIssue": true, 
    "refer": { 
        "number": "TIV20210300000", 
        "dateBE": "18/03/2564", 
        "reasonCode": "TIVC01" 
    }, 
    "reference": "" 
}