Gofive OpenAPI

Create Invoice

POST

https://api.gofive.co.th/etaxgo/Documents/Invoice

Documents

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Ocp-Apim-Subscription-Key

string

required

Example:

รหัส subscription key ของลูกค้า

Content-Type

string

optional

Example:

application/json

Body Params application/json

SellerKey

string

required

ข้อมูลที่ลูกค้าต้องกรอก รับเป็น TaxId ของ company 13 หลัก

BranchCode

string

required

โค้ดย่อย 5 ตัวหลังของ company (SellerKey)

DocumentNo

string

required

เลขเอกสาร

CreatedDate

string

required

วันที่สร้างเอกสาร

IssueDateTime

string

required

วันที่ออกเอกสาร

TemplateToken

string

required

เทมเพลตโทเค็น

BuyerDetail

object

required

ข้อมูลผู้ซื้อ

CustomerType

string

required

ประเภทลูกค้า ให้ใส่ข้อมูลเป็นโค้ด บุคคลธรรมดา(NIDN) นิติบุคคล(TXID) ชาวต่างชาติ(CCPT)

TaxId

string

required

เลขประจำตัวผู้เสียภาษี

CustomerName

string

required

ชื่อลูกค้า

Address

string

required

ที่อยู่

SubDistrict

string

required

แขวง/ตำบล

District

string

required

เขต/อำเภอ

Province

string

required

จังหวัด

PostCode

string

required

รหัสไปรษณีย์

Mobile

string

required

เบอร์โทร

string

required

อีเมล

ItemProducts

array [object {11}]

required

รายการสินค้า

Number

string

required

ลำดับรายการสินค้า

ProductCode

string

required

รหัสสินค้า

ProductName

string

required

ชื่อสินค้า

Quantity

string

required

จำนวนสินค้า

UnitName

string

required

หน่วย

PricePerItem

string

required

ราคาต่อหน่วย

Discount

string

required

ส่วนลด

PercentVat

string

required

เปอร์เซ็นต์ภาษีมูลค่าเพิ่ม

TotalAmount

string

required

ผลการคำนวณภาษีมูลค่าเพิ่ม

TotalVatAmount

string

required

การคำนวณราคาพร้อมภาษีมูลค่าเพิ่ม

TotalNetAmount

string

required

จำนวนเงินพร้อมภาษีมูลค่าเพิ่มและไม่รวมภาษีมูลค่าเพิ่ม

IncludedVat

boolean

required

ราคาสินค้าหรือบริการรวม Vat แล้ว includeVat = true, ราคาสินค้าหรือบริการยังไม่รวม Vat includeVat = false(default)

OriginalAmount

string

required

ยอดต้นฉบับ

DifferenceAmount

string

required

ยอดขายส่วนต่าง

TotalItemAmount

string

required

ผลรวมของ TotalAmount ทั้งหมด

TaxBasisTotalAmount

string

required

TotalItemAmount ลบกับส่วนลด

TaxTotalAmount

string

required

vat ของ TaxBasisTotalAmount

GrandTotal

string

required

ผลรวมของ TaxBasisTotalAmount + TaxTotalAmount

DisCount

object

required

ส่วนลด

Description

string

required

เหตุผลในการลด

Amount

string

required

ส่วนลดท้ายรายการ

PdfFile

string

optional

เพิ่ม pdf สำหรับ sign CA

Example

{
    "SellerKey": "9876543210987",
    "BranchCode": "00000",
    "DocumentNo": "XYZ987654321",
    "CreatedDate": "2025-01-01T12:00:00",
    "IssueDateTime": "2025-01-01T14:00:00",
    "TemplateToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "BuyerDetail": {
        "CustomerType": "NIDN",
        "TaxID": "45678912345",
        "CustomerName": "บริษัท เอ็กซแซมเปิ้ล จำกัด",
        "Address": "123/321",
        "SubDistrict": "พระบรมมหาราชวัง",
        "District": "พระนคร",
        "Province": "กรุงเทพมหานคร",
        "PostCode": "10010"
    },
    "Mobile": "0812345679",
    "Email": "[email protected]",
    "ItemProducts": [
        {
            "Number": "1",
            "ProductCode": "001",
            "ProductName": "oneone",
            "Quantity": "100",
            "UnitName": "Unit",
            "PricePerItem": "99",
            "Discount": "0",
            "PercentVAT": "7",
            "TotalAmount": "9900",
            "TotalVATAmount": "693",
            "TotalNetAmount": "10593"
        }
    ],
    "IncludedVAT": false,
    "OriginalAmount": "10700",
    "DifferenceAmount": "800",
    "TotalItemAmount": "9900",
    "TaxBasisTotalAmount": "800",
    "TaxTotalAmount": "56.00",
    "GrandTotal": "856",
    "DisCount": {
        "Description": "ส่วนลดพิเศษ",
        "Amount": "10.00"
    },
    "PdfFile": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.gofive.co.th/etaxgo/Documents/Invoice' \
--header 'Ocp-Apim-Subscription-Key: รหัส subscription key ของลูกค้า' \
--header 'Content-Type: application/json' \
--data-raw '{
    "SellerKey": "9876543210987",
    "BranchCode": "00000",
    "DocumentNo": "XYZ987654321",
    "CreatedDate": "2025-01-01T12:00:00",
    "IssueDateTime": "2025-01-01T14:00:00",
    "TemplateToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "BuyerDetail": {
        "CustomerType": "NIDN",
        "TaxID": "45678912345",
        "CustomerName": "บริษัท เอ็กซแซมเปิ้ล จำกัด",
        "Address": "123/321",
        "SubDistrict": "พระบรมมหาราชวัง",
        "District": "พระนคร",
        "Province": "กรุงเทพมหานคร",
        "PostCode": "10010"
    },
    "Mobile": "0812345679",
    "Email": "[email protected]",
    "ItemProducts": [
        {
            "Number": "1",
            "ProductCode": "001",
            "ProductName": "oneone",
            "Quantity": "100",
            "UnitName": "Unit",
            "PricePerItem": "99",
            "Discount": "0",
            "PercentVAT": "7",
            "TotalAmount": "9900",
            "TotalVATAmount": "693",
            "TotalNetAmount": "10593"
        }
    ],
    "IncludedVAT": false,
    "OriginalAmount": "10700",
    "DifferenceAmount": "800",
    "TotalItemAmount": "9900",
    "TaxBasisTotalAmount": "800",
    "TaxTotalAmount": "56.00",
    "GrandTotal": "856",
    "DisCount": {
        "Description": "ส่วนลดพิเศษ",
        "Amount": "10.00"
    },
    "PdfFile": "string"
}'

Responses

🟢200Success

application/json

Body

status

object

required

isSuccess

boolean

required

บอกสถานะ

data

object

required

validate

boolean

required

ผลตรวจสอบข้อมูล

validateEmail

boolean

required

ผลตรวจสอบอีเมล

validateSms

boolean

required

ผลตรวจสอบเบอร์สำหรับส่ง SMS

warningMessage

string

required

ข้อความ Error: แจ้งผลการตรวจสอบข้อมูลล้มเหลง (ข้อมูลไม่ตรงหรือผิด) โดยจะบอกข้อผิดพลาดทั้งหมดในข้อมูลที่ส่งมา

pdf

string

required

ไฟล์ PDF ที่ถูก Encode มาเป็น Base64

isSuccess

boolean

required

สร้างเอกสารสำเร็จหรือไม่

Example

{
    "status": {
        "isSuccess": true
    },
    "data": {
        "validate": true,
        "validateEmail": true,
        "validateSms": true,
        "warningMessage": "",
        "pdf": "",
        "isSuccess": true
    }
}

🟠401Unauthorized

🟠401User authentication required V2.

Modified at 2025-01-23 04:35:34

Create Credit Note

Create Receipt