Skip to main content

ภาพรวม Document API

warning

เนื้อหานี้สำหรับการใช้งาน Document API ผ่าน /:document สำหรับเอกสาร Simple และ /:document/inline สำหรับ เอกสาร inline เท่านั้น

การคำนวณค่าในเอกสาร จะแบ่งตามประเภทของบริษัท และประเภทของเอกสารที่สร้าง ได้ดังนี้

  1. บริษัทไม่จดภาษี (Non vat registered company) โดยสามารถสร้างเอกสารได้ 2 แบบ คือ
    • สร้างเอกสาร (Simple Document)
    • สร้างเอกสาร แบบส่วนลด แยกตามรายการสินค้า (Inline Discount Document)
  2. บริษัทจดภาษี (Vat registered company) โดยสามารถสร้างเอกสารได้ 3 แบบ คือ
    • สร้างเอกสาร (Simple Document)
    • สร้างเอกสาร แบบส่วนลด แยกตามรายการสินค้า (Inline Discount Document)
    • สร้างเอกสาร แบบส่วนลดและภาษี แยกตามรายการสินค้า (Inline Discount and Vat Document)

การใช้งานฟังก์ชั่นของ เอกสาร​

FieldTypeDescription
isVatbooleanตั้งค่าการเปิดใช้งานการคำนวณภาษีมูลค่าเพิ่มของเอกสาร
- ป้อนค่า true เมื่อมีการคำนวณภาษีมูลค่าเพิ่ม โดยที่ isVatInclusive สามารถป้อนค่าเป็น true หรือ false ก็ได้
- ป้อนค่า false เมื่อไม่มีการคำนวณภาษีมูลค่าเพิ่ม โดยที่ isVatInclusive ต้องป้อนค่าเป็น false เท่านั้น
isVatInclusivebooleanตั้งค่าการเปิดใช้งานภาษีมูลค่าเพิ่มแบบรวมในราคาต่อหน่วย
- ป้อนค่า true เมื่อราคาต่อหน่วยของสินค้าได้รวมภาษีมูลค่าเพิ่มแล้ว
- ป้อนค่า false เมื่อราคาต่อหน่วยของสินค้ายังไม่รวมภาษีมูลค่าเพิ่ม (ไม่รวมภาษีมูลค่าเพิ่ม)
useReceiptDeductionbooleanตั้งค่าการใช้งานฟังก์ชั่น ปรับลดท้ายเอกสาร
(เฉพาะเอกสารใบกำกับภาษี / ใบเสร็จรับเงิน และ ใบเสร็จรับเงิน / เอกสารขายเงินสด)
useInlineDiscountbooleanตั้งค่าการใช้งานฟังก์ชั่น ส่วนลดแยกรายการ
จะมีค่าคงที่เป็น true เกี่ยวข้องกับ discountAmount
useInlineVatbooleanตั้งค่าการใช้งาน ภาษีมูลค่าเพิ่ม แยกรายการ
ที่เกี่ยวข้องกับ vatRate ในสินค้า
discountTypenumberรูปแบบส่วนลดในเอกสาร
กรณีใช้รูปแบบ Inline ส่วนลด หรือ ภาษี แยกตามรายการสินค้า สามารถเลือกรูปแบบส่วนลดได้
1 = เปอร์เซ็นต์
3 = จำนวน (บาท)

Product items List​

FieldTypeDescriptionDecimal support
pricePerUnitnumberราคาต่อหน่วยของสินค้า4 decimal
quantitynumberจำนวนสินค้า4 decimal
discountAmountnumberส่วนลดสินค้า2 decimal
totalnumberราคารวมในระดับรายการสินค้า2 decimal

Document​

FieldTypeDescriptionDecimal support
discountPercentagenumberเปอร์เซ็นต์ส่วนลด2 decimal
subTotalnumberยอดรวมหักส่วนลดอื่นๆ ยังไม่รวม VAT หรือส่วนลดเพิ่มเติม2 decimal
totalAfterDiscountnumberยอดรวมหลังหักส่วนลด2 decimal
discountAmountnumberส่วนลดรวม2 decimal
vatableAmountnumberจำนวนเงินที่ต้องเสีย VAT2 decimal
vatAmountnumberจำนวน VAT ทั้งหมด2 decimal
exemptAmountnumberจำนวนเงินที่ได้รับการยกเว้นจาก VAT2 decimal
grandTotalnumberยอดรวมสุทธิหลังรวม VAT และส่วนลด2 decimal

Payment / Receipt​

FieldTypeDescriptionDecimal support
paymentAmountnumberจำนวนเงินที่ต้องชำระ2 decimal
paymentWithHeldnumberจำนวนเงินที่ถูกหัก ณ ที่จ่าย2 decimal
remainingCollectednumberจำนวน ยอดเงินขาด หรือ เงินเกิน2 decimal
collectednumberจำนวนเงินที่ได้รับหรือจ่ายแล้ว2 decimal
deductionAmountnumberจำนวนเงินที่ถูกหัก2 decimal
chargenumberค่าธรรมเนียม4 decimal
info
  • ค่าการคำนวณทางบัญชีที่ต้องใส่ให้ถูกต้อง Decimal ที่กำหนด
{
    "recordId": 0,
    "contactCode": "001",
    "contactName": "บริษัท ลูกค้า จำกัด, คุณลูกค้า ซื้อประจำ",
    "contactAddress": "ที่อยู่ ลูกค้า/ผู้จำหน่าย",
    "contactTaxId": "1234567890123",
    "contactBranch": "สำนักงาน/สาขา",
    "contactPerson": "ลูกค้า",
    "contactEmail": "contact@email.com",
    "contactNumber": "099-999-9999",
    "contactZipCode": "12345",
    "contactGroup": 1,
    "publishedOn": "2021-01-01",
    "creditType": 1,
    "creditDays": 30,
    "dueDate": "2021-01-31",
    "salesName": "พนักงาน ขายหน้าร้าน",
    "projectName": "project A",
    "reference": "INV2020010001",
    "isVatInclusive": false,
    "useReceiptDeduction": false,
    "subTotal": 100.01,
    "discountPercentage": 100.0001,
    "discountAmount": 100.01,
    "totalAfterDiscount": 10.51,
    "isVat": false,
    "vatAmount": 10.51,
    "grandTotal": 321.01,
    "documentShowWithholdingTax": false,
    "documentWithholdingTaxPercentage": 0,
    "documentWithholdingTaxAmount": 0,
    "documentDeductionType": 0,
    "documentDeductionAmount": 0,
    "remarks": "remarks",
    "internalNotes": "note",
    "showSignatureOrStamp": true,
    "documentStructureType": "SimpleDocument",
    "saleAndPurchaseChannel": "",
    "items": [
        {
            "id": 1,
            "type": 1,
            "name": "Service",
            "description": "Type service",
            "quantity": 1.1234,
            "unitName": "บริการ",
            "pricePerUnit": 100.0001,
            "total": 100.01,
            "sellChartOfAccountCode": "41210",
            "buyChartOfAccountCode": ""
        }
    ]
}