Quotation Enquiry - Gofive OpenAPI

การเรียกดูข้อมูลใบเสนอราคา โดยแสดงผลเป็นชุดใบเสนอราคา

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

Example:

Body Params application/json

take

integer

required

จำนวนรายการที่ต้องการแสดง

skip

integer | null

optional

จำนวนรายการที่ต้องการข้าม

quotationNo

string | null

optional

รหัสใบเสนอราคา

quotationStatus

integer | null

optional

สถานะใบเสนอราคา
1 = ร่าง
2= รออนุมัติ
3 = รอส่ง
4 = ส่งแล้ว
5 = เสร็จสิ้น
6 = ปฏิเสธ
7 = ยกเลิก

staffCode

string | null

optional

รหัสพนักงานขาย

customerCode

string | null

optional

รหัสลูกค้า

quotationDate

string | null

optional

วันที่สร้างใบเสนอราคา โดยมี Format : YYYY-MM-DD

createdByStaffCode

string | null

optional

รหัสพนักงานที่สร้างใบเสนอราคา

Example

{
    "quotationDate" : "<datetime>",//วันที่สร้างใบเสนอราคา  
    "staffCode" : "<string>",//รหัสพนักงานขาย 
    "quotationNo" : "<string>",//รหัสใบเสนอราคา 
    "customerCode" : "<string>", ///รหัสลูกค้า 
    "quotationStatus" :2,//สถานะใบเสนอราคา <integer>
    "take" : 5,//จำนวนรายการที่อยากแสดง  required **จำเป็นต้องใส่<decimal>
    "skip" : 0, //จำนวนรายการที่อยากข้าม  <decimal>
    "createdByStaffCode": "<string>" //รหัสพนักงานที่สร้างใบ
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

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

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 | null

optional

ยอดรวมสินค้าหลังหักส่วนลด

totalVat

number

required

ยอดรวมภาษี

grandTotal

number

required

ยอดรวมที่ต้องจ่าย

remark

string | null

optional

หมายเหตุใบเสนอราคา

headerTemplateId

integer | null

optional

หัวเอกสารในpdf

Example

{
    "status": {
        "code": "1000",
        "description": "Success"
    },
    "data": [
        {
            "quotationSubject": "Bff test create quotation",
            "quotationNo": "DRAFT2212000100",
            "quotationDate": "2022-12-16T00:00:00+0700",
            "quotationValidUntil": "2023-12-16T00:00:00+0700",
            "customerCode": "daisy",
            "recipientName": "Mook",
            "recipientAddress": "Chanthaburi",
            "quotationDetails": [
                {
                    "productCode": "ROG001",
                    "productName": "ROG Phone 6 Pro [Default]",
                    "price": 5000,
                    "qty": 6,
                    "productDescription": "Good product",
                    "discountValue": 1,
                    "discountType": true,
                    "vatTaxValue": 3,
                    "whtTaxValue": 1,
                    "totalPrice": 29700
                }
            ],
            "currencyCode": "THB",
            "vatCalculation": true,
            "discountName": "just discount test",
            "discountType": true,
            "discountValue": 7,
            "paymentTerm": "1 month test",
            "remark": "Remember this for test",
            "quotationNote": "test 13dec2022",
            "staffCode": "Admin01",
            "quotationStatus": 1,
            "subTotal": 29700,
            "subTotalWithDiscount": 27621,
            "totalVat": 828.63,
            "grandTotal": 28449.63
        }
    ]
}

🟠401Unauthorized

🟢200Bad Request

🟠401User authentication required V2.