Gofive OpenAPI
empeoVenioeTaxGo
empeoVenioeTaxGo
  1. Quotation
  • Introduction
  • Activity
    • Get a Activity
      GET
    • Activities Enquiry
      POST
  • Authentication API
    • Authorization
      POST
  • Customer
    • Create or Update customer
      POST
    • Get a Customer By CustomerCode
      GET
    • Customers Enquiry
      POST
    • Get a Customer By CustomerName
      GET
    • Create Customer Satisfaction
      POST
    • Add Customer Event
      POST
    • Get Customer Events by Customer Code
      GET
    • Edit Customer Event
      PUT
    • Delete Customer Event
      DELETE
    • Get Customer Event Types
      GET
  • Case
    • Add Case
      POST
    • Edit Case by CaseNo
      PUT
    • Get Case by CaseNo
      GET
    • Get Case Categories
      GET
  • Deal
    • Create Deal
      POST
    • Update Deal
      PUT
    • Deal Enquiry
      POST
    • Get Deal
      GET
    • Get Deal Board
      GET
    • Get Deal Stage
      GET
    • Get Deal Interest
      GET
    • Get DealLabel
      GET
    • Get Deal Missed Reason Categories
      GET
  • Employee
    • Employees Enquiry
    • Get a Employee
  • Expense
    • Create Expense
    • Update Expense
    • Expense Enquiry
    • Get a Expense
  • Product
    • Create Or Update Products
    • Get a Product Ticket
    • Get Products With Take & Status
    • Get a Product by ProductCode
    • Get Product Groups
    • Get Product Properties
    • Get Products By Filter
    • Verify Serial Number
    • /v3/Products/serials/status
    • Create or Update Codeguard Products
    • Update Product Stock
    • /v1/products/units
    • /v1/products/units Copy
  • Quotation
    • Create Update Quotation
      POST
    • Convert Quotation To SalesOrder
      POST
    • Quotation Enquiry
      POST
    • Get a Quotation By QuotationNo
      GET
    • Cancel Quotation
      POST
  • SalesOrder
    • Create Or Update SalesOrder
    • Get a SalesOrders By Id
    • Get a SalesOrder By SalesOrderNo
    • Get Sale Order Attachment
    • Reject SaleOrder
    • Approve Sale Order
    • Update SalesOrder Payment
    • Update SalesOrder Tracking Number
  • Webhooks
    • Webhook Payload
  • Task
    • CreateTask
  • Setting
    • Get HeaderTemplate
  1. Quotation

Create Update Quotation

POST
https://api.gofive.co.th/v2/quotation
เพิ่ม แก้ไขข้อมูลใบเสนอราคา ที่อยู่ในสถานะ ร่าง รออนุมัติ และรอส่ง

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
Content-Type
string 
required
Example:
application/json
Ocp-Apim-Subscription-Key
string 
required
รหัส subscription key ลูกค้า
Example:
<Your subscription-key>
Body Params application/json
quotationSubject
string 
required
ชื่อหัวข้อใบเสนอราคา
quotationDate
string 
required
วันที่สร้างใบเสนอราคา โดยมี Format : YYYY-MM-DD
quotationValidUntil
string 
required
วันที่สิ้นสุด โดยมี Format : YYYY-MM-DD
quotationStatus
integer 
required
สถานะใบเสนอราคา
1 = ร่าง
2=  รออนุมัติ
3 = รอส่ง
4 = ส่งแล้ว
5 = เสร็จสิ้น
6 = ปฏิเสธ
7 = ยกเลิก
customerCode
string 
required
รหัสลูกค้า
staffCode
string 
required
รหัสพนักงานขาย
quotationNo
string  | null 
optional
รหัสใบเสนอราคา ต้องใส่กรณีทำการ แก้ไขupdate
referenceNo
string  | null 
optional
เลขที่อ้างอิ้ง
vatCalculation
boolean 
required
การคำนวณภาษีมูลลค่าเพิ่ม
quotationDetails
array [object {10}] 
required
รายการสินค้า
productCode
string 
required
รหัสสินค้า
productName
string  | null 
optional
ชื่อสินค้า
price
number  | null 
optional
ราคากำหนดต่อหน่วย
qty
number 
required
จำนวน จำเป็นต้องใส่ ห้ามใส่เกินจำนวนที่มีในstock
productUnitName
string  | null 
optional
หน่วยสินค้า
productDescription
string  | null 
optional
รายละเอียดสินค้า
discountType
boolean  | null 
optional
ประเภทส่วนลด
True คือคิดเป็น %,
False คิดเป็นบาท
discountValue
number  | null 
optional
ส่วนลด
vatTaxValue
number  | null 
optional
ภาษี มูลลค่าเพิ่ม
whTaxValue
number  | null 
optional
ภาษี ณ ที่จ่าย
discountType
boolean  | null 
optional
ประเภทส่วนลด
True คือคิดเป็น %,
False คิดเป็นบาท
discountValue
number  | null 
optional
ส่วนลด
headerTemplateId
integer  | null 
optional
หัวเอกสารในpdf
currencyCode
string  | null 
optional
สกุลเงิน เช่น "THB" , "USD" [ถ้าไม่ส่ง หรือ null ระบบจะหยิบ System Currency ของ Company นั้นๆให้] optional
remark
string  | null 
optional
หมายเหตุใบเสนอราคา
discountName
string  | null 
optional
ชื่อส่วนลด
paymentTerm
string  | null 
optional
เงื่อนไขการชำระเงิน
quotationNote
string  | null 
optional
รายละเอียดเพิ่มเติม
contactName
string  | null 
optional
ชื่อผู้ติดต่อ
recipientName
string  | null 
optional
ชื่อผู้รับ
recipientAddress
string  | null 
optional
ที่อยู่ผู้รับ
Example
{
            "quotationSubject":"<string> ",//ชื่อหัวข้อใบเสนอราคา required **จำเป็นต้องใส่มา 
            "ReferenceNo": "<string>",//เลขอ้างอิง
            "quotationNo":"<string>",//รหัสใบเสนอราคา  required กรณีแก้ไข ถ้าสร้างไม่ใส่ ต้องเป็นรหัสใบเสนอราคาที่อยู่ในบริษัท
            "quotationDate": "<datetime>",//วันที่สร้างใบเสนอราคา  required **จำเป็นต้องใส่มา
            "quotationValidUntil": "<datetime>",//วันที่สิ้นสุดใบเสนอราคา  required **จำเป็นต้องใส่มา
            "customerCode": "<string>",//รหัสลูกค้า  required **จำเป็นต้องใส่มา
            "contactName": "<string>",//ชื่อผู้ติดต่อ  optional
            "recipientName": "<string>",//ชื่อผู้รับ  optional
            "recipientAddress": "<string>",//ที่อยู่ผู้รับ  optional
            "quotationDetails": [
                //รายการสินค้า
                {
                    "productCode": "<string>",//รหัสสินค้า  required **จำเป็นต้องใส่มา ต้องเป็นรหัสที่มีอยู่ในบริษัทและactive
                    "productName": "<string>",//ชื่อสินค้า  optional
                    "price":0.0,//ราคาาำหนดต่อหน่วย  optional <decimal>
                    "qty":0.0,//จำนวนสินค้า required **จำเป็นต้องใส่มา <decimal>
                    "productUnitName": "<string>",//หน่วยสินค้า  optional
                    "productDescription": "<string>",//รายละเอียดสินค้า  optional
                    "discountValue": 0.0,//ส่วนลดสินค้าถ้าหากประเภทสินค้าเป็น%คิดเป็น%  ถ้าไม่ใช่คิดเป็นบาท  optional ห้ามใส่เกิน100%หรือมากกว่ายอดรวมสินค้า <decimal>
                    "vatTaxValue": 0.0,//ภาษีมูลค่าเพิ่ม  required ห้ามใส่เกิน1000 <decimal>
                    "discountType":false,//ประเภทส่วนลด ถ้าtrueเป็น% ไม่ใช่เป็นบาท  optional <bool>
                    "whtTaxValue":0.0//ภาษี ณ ที่จ่าย ต้องเป็นภาษี ณ ที่จ่ายที่มีอยู่ในบริษัทและactiveอยู่ <decimal>
              
                }
            ],
            "currencyCode": "<string>",// สกุลเงิน เช่น "THB" , "USD" [ถ้าไม่ส่ง หรือ null ระบบจะหยิบ System Currency ของ Company นั้นๆให้] optional
            "vatCalculation": true,//การคำนวณภาษีมูลค่าเพิ่ม  required **จำเป็นต้องใส่มา <bool>
            "discountName": "<string>",//ชื่อส่วนลด  optional
            "discountType": false,//ประเภทส่วนลด ถ้าtrueเป็น% ไม่ใช่เป็นบาท  optional <bool>
            "discountValue": 0.0,//ส่วนลดสินค้าถ้าหากประเภทสินค้าเป็น%คิดเป็น% ถ้าไม่ใช่คิดเป็นบาท  optional ห้ามใส่เกิน100%หรือมากกว่ายอดรวมสินค้า <decimal>
            "paymentTerm": "<string>",//เงื่อนไขการชำระเงิน  optional
            "remark": "<string>",//หมายเหตุใบเสนอราคา  optional
            "quotationNote": "<string>",//รายละเอียดเพิ่มเติม  optional
            "staffCode": "<string>",//รหัสพนักงาน  required **จำเป็นต้องใส่มา ต้องเป็นรหัสที่มีอยู่ในบริษัทและactive
            "quotationStatus":1
            ,//สถานะใบเสนอราคา required **จำเป็นต้องใส่มา สามารถสร้างสถานะเป็น 1 darf ใบร่าง, 2 waiting approve รอให้อนุมัติ, 3 pending sent รอส่ง
            "headerTemplate":1 
            //หัวกระดาษในpdf <integer>
        
        }

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.gofive.co.th/v2/quotation' \
--header 'Ocp-Apim-Subscription-Key: <Your subscription-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
            "quotationSubject":"<string> ",//ชื่อหัวข้อใบเสนอราคา required **จำเป็นต้องใส่มา 
            "ReferenceNo": "<string>",//เลขอ้างอิง
            "quotationNo":"<string>",//รหัสใบเสนอราคา  required กรณีแก้ไข ถ้าสร้างไม่ใส่ ต้องเป็นรหัสใบเสนอราคาที่อยู่ในบริษัท
            "quotationDate": "<datetime>",//วันที่สร้างใบเสนอราคา  required **จำเป็นต้องใส่มา
            "quotationValidUntil": "<datetime>",//วันที่สิ้นสุดใบเสนอราคา  required **จำเป็นต้องใส่มา
            "customerCode": "<string>",//รหัสลูกค้า  required **จำเป็นต้องใส่มา
            "contactName": "<string>",//ชื่อผู้ติดต่อ  optional
            "recipientName": "<string>",//ชื่อผู้รับ  optional
            "recipientAddress": "<string>",//ที่อยู่ผู้รับ  optional
            "quotationDetails": [
                //รายการสินค้า
                {
                    "productCode": "<string>",//รหัสสินค้า  required **จำเป็นต้องใส่มา ต้องเป็นรหัสที่มีอยู่ในบริษัทและactive
                    "productName": "<string>",//ชื่อสินค้า  optional
                    "price":0.0,//ราคาาำหนดต่อหน่วย  optional <decimal>
                    "qty":0.0,//จำนวนสินค้า required **จำเป็นต้องใส่มา <decimal>
                    "productUnitName": "<string>",//หน่วยสินค้า  optional
                    "productDescription": "<string>",//รายละเอียดสินค้า  optional
                    "discountValue": 0.0,//ส่วนลดสินค้าถ้าหากประเภทสินค้าเป็น%คิดเป็น%  ถ้าไม่ใช่คิดเป็นบาท  optional ห้ามใส่เกิน100%หรือมากกว่ายอดรวมสินค้า <decimal>
                    "vatTaxValue": 0.0,//ภาษีมูลค่าเพิ่ม  required ห้ามใส่เกิน1000 <decimal>
                    "discountType":false,//ประเภทส่วนลด ถ้าtrueเป็น% ไม่ใช่เป็นบาท  optional <bool>
                    "whtTaxValue":0.0//ภาษี ณ ที่จ่าย ต้องเป็นภาษี ณ ที่จ่ายที่มีอยู่ในบริษัทและactiveอยู่ <decimal>
              
                }
            ],
            "currencyCode": "<string>",// สกุลเงิน เช่น "THB" , "USD" [ถ้าไม่ส่ง หรือ null ระบบจะหยิบ System Currency ของ Company นั้นๆให้] optional
            "vatCalculation": true,//การคำนวณภาษีมูลค่าเพิ่ม  required **จำเป็นต้องใส่มา <bool>
            "discountName": "<string>",//ชื่อส่วนลด  optional
            "discountType": false,//ประเภทส่วนลด ถ้าtrueเป็น% ไม่ใช่เป็นบาท  optional <bool>
            "discountValue": 0.0,//ส่วนลดสินค้าถ้าหากประเภทสินค้าเป็น%คิดเป็น% ถ้าไม่ใช่คิดเป็นบาท  optional ห้ามใส่เกิน100%หรือมากกว่ายอดรวมสินค้า <decimal>
            "paymentTerm": "<string>",//เงื่อนไขการชำระเงิน  optional
            "remark": "<string>",//หมายเหตุใบเสนอราคา  optional
            "quotationNote": "<string>",//รายละเอียดเพิ่มเติม  optional
            "staffCode": "<string>",//รหัสพนักงาน  required **จำเป็นต้องใส่มา ต้องเป็นรหัสที่มีอยู่ในบริษัทและactive
            "quotationStatus":1
            ,//สถานะใบเสนอราคา required **จำเป็นต้องใส่มา สามารถสร้างสถานะเป็น 1 darf ใบร่าง, 2 waiting approve รอให้อนุมัติ, 3 pending sent รอส่ง
            "headerTemplate":1 
            //หัวกระดาษในpdf <integer>
        
        }'

Responses

🟢200Created
application/json
Body
status
object 
required
code
string 
required

สถานะของ Business Code ถ้า
Success = 1000
Error 1 ตัว = 4001
Error มากกว่า 1 ตัว = 4002    
หรือเป็น Subcode ที่ต้องการจะแสดงเพื่อสื่อความหมายของ Error โดย subcode จะเป็นตัวเดียวกับ business error code หรือไม่ก็ได้ เพื่อความสะดวกในการแสดงผล

description
string 
required
คำอธิบายข้อความที่จะแสดง
data
array [object {23}] 
required
quotationSubject
string 
required
ชื่อหัวข้อใบเสนอราคา
quotationDate
string 
required
วันที่สร้างใบเสนอราคา
quotationValidUntil
string 
required
วันที่สิ้นสุด
quotationStatus
integer 
required
สถานะใบเสนอราคา
1 = ร่าง
2=  รออนุมัติ
3 = รอส่ง
4 = ส่งแล้ว
5 = เสร็จสิ้น
6 = ปฏิเสธ
7 = ยกเลิก
staffCode
string 
required
รหัสพนักงาน
customerCode
string 
required
รหัสลูกค้า
vatCalculation
boolean 
required
การคำนวณภาษีมูลลค่าเพิ่ม
quotationDetails
array [object {11}] 
required
รายการสินค้า
currencyCode
string 
required
สกุลเงิน เช่น "THB" , "USD" [ถ้าไม่ส่ง หรือ null ระบบจะหยิบ System Currency ของ Company นั้นๆให้] optional
discountName
string  | null 
optional
ชื่อส่วนลด
discountType
boolean  | null 
optional
ประเภทส่วนลด
True คือคิดเป็น %,
False คิดเป็นบาท
discountValue
number  | null 
optional
ส่วนลด
quotationNote
string  | null 
optional
รายละเอียดเพิ่มเติม
paymentTerm
string  | null 
optional
เงื่อนไขการชำระเงิน
contactName
string  | null 
optional
ชื่อผู้ติดต่อ
recipientName
string  | null 
optional
ชื่อผู้รับ
recipientAddress
string  | null 
optional
ที่อยู่
subTotal
number 
required
ยอดรวมสินค้า
subTotalWithDiscount
number 
required
ยอดรวมสินค้าหลังหักส่วนลด
totalVat
number 
required
ยอดรวมภาษี
grandTotal
number 
required
ยอดรวมที่ต้องจ่าย
remark
string  | null 
optional
หมายเหตุใบเสนอราคา
headerTemplateId
integer  | null 
optional
หัวเอกสารในpdf
Example
{
  "status": {
    "code": "1000",
    "description": "Success"
  },
  "data": [
    {
      "quotationSubject": "string",
      "quotationNo": "string",
      "quotationDate": "2022-12-16T00:00:00+0700",
      "quotationValidUntil": "2023-12-16T00:00:00+0700",
      "customerCode": "string",
      "contactName": "string",
      "recipientName": "string",
      "recipientAddress": "string",
      "quotationDetails": [
        {
          "productCode": "string",
          "productName": "string",
          "price": 10,
          "qty": 6,
          "productUnitName": "string",
          "productDescription": "string",
          "discountValue": 1,
          "vatTaxValue": 3,
          "totalPrice": 5
        }
      ],
      "currencyCode": "THB",
      "vatCalculation": true,
      "discountName": "string",
      "discountType": false,
      "discountValue": 7,
      "paymentTerm": "string",
      "remark": "string",
      "quotationNote": "string",
      "staffCode": "string",
      "quotationStatus": 3,
      "subTotal": 59,
      "subTotalWithDiscount": 52,
      "totalVat": 1.56,
      "grandTotal": 53.56
    }
  ]
}
🟢200Updated
🟠400Bad Request
🟠401Unauthorized
Previous
/v1/products/units Copy
Next
Convert Quotation To SalesOrder
Built with