# Convert Quotation To SalesOrder ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/{quotationNo}/convert-to-salesorder: post: summary: Convert Quotation To SalesOrder deprecated: false description: การเปลี่ยนใบเสนอราคาให้กล้ายเป็นใบสั่งขาย convert to salesorder tags: - Venio/Quotation parameters: - name: quotationNo in: path description: '' required: true schema: type: string - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Ocp-Apim-Subscription-Key in: header description: รหัส subscription key ลูกค้า required: true example: schema: type: string responses: '200': description: '' content: application/json: schema: type: object properties: status: type: object properties: code: type: string description: "

สถานะของ\_Business\_Code\_ถ้า
Success\_=\_1000
Error\_1\_ตัว\_=\_4001
Error\_มากกว่า\_1\_ตัว\_=\_4002\_\_\_\_
หรือเป็น\_Subcode\_ที่ต้องการจะแสดงเพื่อสื่อความหมายของ\_Error\_โดย\_subcode\_จะเป็นตัวเดียวกับ\_business\_error\_code\_หรือไม่ก็ได้\_เพื่อความสะดวกในการแสดงผล

" description: type: string description: คำอธิบายข้อความที่จะแสดง x-apidog-orders: - code - description required: - code - description data: type: object properties: salesOrderSubject: type: string description: "หัวเรื่องใบออเดอร์\_Required" salesOrderNo: type: string description: เลขใบออเดอร์ salesOrderDate: type: string description: "วันที่ออเดอร์\_Required\_โดยมี\_Format\_:\_\"YYYY-MM-DD\"" referenceNo: type: boolean description: เลขที่อ้างอิง customerCode: type: string description: >- รหัสลูกค้า Required [ตอน Update SalesOrder ไม่สามารถเปลี่ยน Customer ได้] contactId: type: integer description: ' รหัสผู้ติดต่อ' nullable: true recipientName: type: string description: ชื่อผู้รับสินค้า nullable: true recipientAddress: type: string description: ที่อยู่จัดส่งสินค้า nullable: true headerTemplateId: type: integer description: >- หัวเอกสารใน PDF [ถ้าไม่ส่งค่ามาให้เท่ากับ header default company] nullable: true vatCalculation: type: boolean description: >-

การคำนวณภาษีมูลค่าเพิ่ม Required [
true = ไม่รวมภาษีมูลค่าเพิ่ม
false = รวมภาษีมูลค่าเพิ่ม]

discountName: type: string description: ชื่อส่วนลดสินค้า nullable: true discountValue: type: number description: >- ส่วนลดสินค้า (*ตัว Discount ต้องมีค่าไม่เกิน ราคาของสินค้าทั้งหมด) nullable: true discountType: type: boolean description: >-

ประเภทส่วนลด [
true = percentage
false = amount]
(*ระบบจะ required เมื่อมีการใส่ discountValue)

nullable: true paymentTerm: type: string description: เงื่อนไขการชำระเงิน nullable: true remark: type: string description: หมายเหตุใบออเดอร์ nullable: true staffCode: type: string description: รหัสพนักงานขาย salesOrderStatus: type: integer description: >-

สถานะใบออเดอร์ [
1 = draft
2 = open
3 = completed
4 = rejected
5 = cancelled]

currencyCode: type: string description: ' สกุลเงิน เช่น "THB" , "USD" [ถ้าไม่ส่ง หรือ null ระบบจะหยิบ System Currency ของ Company นั้นๆให้]' subTotal: type: number description: ยอดรวมสินค้า subTotalWithDiscount: type: number description: ยอดรวมหลังหักส่วนลด totalVat: type: number description: ยอดรวมภาษีมูลลค่าเพิ่ม grandTotal: type: number description: ยอดรวมสรุปที่ต้องจ่าย salesorderDetails: type: array items: type: object properties: productCode: type: string description: รหัสสินค้า Required productName: type: string description: ' ชื่อสินค้าที่ต้องการกำหนด [null = ชื่อสินค้าตามในระบบ]' price: type: number description: ' ราคาสินค้าที่ต้องการกำหนด [null = ราคาสินค้าตามในระบบ]' qty: type: number description: >- จำนวนสินค้า (*กรอกจำนวนได้ไม่เกินสินค้าที่มีใน stock จนกว่าจะมีการเปิด Permission บน Web) productUnitName: type: string description: >- หน่วยสินค้า [null = หน่วยสินค้าตามในระบบ] (*ถ้าใส่ค่า Unit ไม่ตรงกับระบบ ให้ error) productDescription: type: string description: >- รายละเอียดสินค้า [null = ราคาละเอียดสินค้าตามในระบบ] nullable: true discountValue: type: number description: >- ส่วนลดสินค้า (*ตัว Discount ต้องมีค่าไม่เกิน ราคาของสินค้านั้น) เมื่อ DiscountBasisType = 360002 (ต่อหน่วย) จะเป็นส่วนลดต่อหน่วย, เมื่อ = 360001 (ต่อรายการ) จะเป็นส่วนลดของทั้งบรรทัด nullable: true discountType: type: boolean description: >-

ประเภทส่วนลด
true = percentage
false = amount
(*ระบบจะ required เมื่อมีการใส่ discountValue)

nullable: true vatTaxValue: type: number description: ' ภาษีมูลค่าเพิ่ม(%) (*ถ้าไม่มีอยู่ในระบบ ให้สร้างใหม่ กรณี inactive ระบบ จะแสดง error) [ถ้าส่ง Null มา ระบบจะ Set เป็น No Vat]' nullable: true whtTaxValue: type: number description: >- ภาษีหัก ณ ที่จ่าย(%) (*ถ้าไม่มีอยู่ในระบบ จะแสดง error) [ถ้าส่ง Null มา ระบบจะ Set เป็น none] nullable: true totalPrice: type: number description: ยอดรวมสินค้า warehouseCode: type: string description: รหัสคลังสินค้า nullable: true unitId: type: integer description: ID หน่วยสินค้า isShipping: type: boolean description: มีการจัดส่งหรือไม่ discountBasisType: type: integer enum: - 360001 - 360002 x-apidog-enum: - value: 360001 name: PerItem description: คิดส่วนลดแบบต่อรายการ/ทั้งบรรทัด - value: 360002 name: PerUnit description: คิดส่วนลดแบบต่อหน่วย required: - productCode - productName - price - qty - productUnitName - totalPrice - unitId - isShipping - discountBasisType x-apidog-orders: - productCode - productName - price - qty - productUnitName - productDescription - discountValue - discountType - vatTaxValue - whtTaxValue - totalPrice - unitId - isShipping - warehouseCode - discountBasisType description: รายการสินค้า warehouseCode: type: string description: รหัสคลังสินค้า nullable: true customerId: type: number payment: type: object properties: valueType: type: integer description: >- ประเภทการคำนวณงวด: 0 = None, 1 = Number (จำนวนงวด), 2 = Percent schedulePayments: type: array items: type: object properties: installmentNumber: type: integer description: ลำดับงวด status: type: integer description: 1 = Paid, 2 = Unpaid installmentAmount: type: number description: จำนวนเงินงวดนี้ (บาท) installmentPercent: type: number description: '% ของยอดรวม' x-apidog-orders: - installmentNumber - status - installmentAmount - installmentPercent required: - installmentNumber - status - installmentAmount - installmentPercent description: รายการงวดชำระ x-apidog-orders: - valueType - schedulePayments description: ข้อมูลการชำระเงิน required: - valueType - schedulePayments privateNote: type: string description: หมายเหตุภายใน invoiceInfo: type: object properties: id: type: number description: ID invoice (integration) integrationPlatform: type: integer description: 400020 = Shopee, 400027 = NocNoc integrationBuyerId: type: string description: Buyer ID จาก platform type: type: integer description: 'ประเภทลูกค้า: 13001 = Individual, 13002 = Business' customerName: type: string description: ชื่อลูกค้า taxId: type: string description: เลขประจำตัวผู้เสียภาษี isEtax: type: boolean description: ใช้ e-Tax หรือไม่ isHeadOffice: type: boolean description: สำนักงานใหญ่หรือไม่ branch: type: string description: ชื่อสาขา branchCode: type: string description: รหัสสาขา country: type: string description: ประเทศ province: type: string description: จังหวัด district: type: string description: อำเภอ/เขต subDistrict: type: string description: ตำบล/แขวง zipCode: type: string description: รหัสไปรษณีย์ phone: type: string description: เบอร์โทรศัพท์ address: type: string description: ที่อยู่ email: type: string description: อีเมล x-apidog-orders: - id - integrationPlatform - integrationBuyerId - type - customerName - taxId - isEtax - isHeadOffice - branch - branchCode - country - province - district - subDistrict - zipCode - phone - address - email description: ข้อมูล Invoice (integration) required: - id - integrationPlatform - integrationBuyerId - type - customerName - taxId - isEtax - isHeadOffice - branch - branchCode - country - province - district - subDistrict - zipCode - phone - address - email shippingDocumentUrl: type: string description: URL เอกสารจัดส่ง trackingNo: type: string description: เลขพัสดุ discounts: type: array items: type: object properties: discountName: type: string description: ชื่อส่วนลด discountValue: type: number description: มูลค่าส่วนลด discountType: type: number description: true = %, false = บาท x-apidog-orders: - discountName - discountValue - discountType required: - discountName - discountValue - discountType description: รายการส่วนลดแบบ multi customerAddressId: type: number description: ID ที่อยู่ลูกค้า salesOrderId: type: number description: ID ใบสั่งขาย (internal) integrationPlatform: type: integer description: Platform integration (Shopee ฯลฯ) recipient: type: object properties: name: type: string description: ชื่อผู้รับ email: type: string description: อีเมลผู้รับ phone: type: string description: เบอร์โทรผู้รับ country: type: string description: ประเทศ province: type: string description: จังหวัด district: type: string description: อำเภอ/เขต subDistrict: type: string description: ตำบล/แขวง zipCode: type: string description: รหัสไปรษณีย์ address: type: string description: ที่อยู่เต็ม x-apidog-orders: - name - email - phone - country - province - district - subDistrict - zipCode - address description: ข้อมูลผู้รับ (integration) required: - name - email - phone - country - province - district - subDistrict - zipCode - address isIntegrationOrderPaid: type: boolean description: ชำระเงินแล้ว (integration) salesOrderCustomerAddress: type: object properties: addressId: type: number description: ID ที่อยู่ลูกค้า locationName: type: string description: ชื่อสถานที่ location: type: string description: ที่อยู่ (ภาษาไทย) locationEN: type: string description: ที่อยู่ (ภาษาอังกฤษ) fullAddress: type: string description: ที่อยู่เต็ม (ภาษาไทย) fullAddressEN: type: string description: ที่อยู่เต็ม (ภาษาอังกฤษ) subdistrict: type: string description: ตำบล/แขวง (ไทย) subdistrictEN: type: string description: ตำบล/แขวง (อังกฤษ) district: type: string description: อำเภอ/เขต (ไทย) districtEN: type: string description: อำเภอ/เขต (อังกฤษ) province: type: string description: จังหวัด (ไทย) provinceEN: type: string description: จังหวัด (อังกฤษ) zipCode: type: string description: รหัสไปรษณีย์ phone: type: string description: เบอร์โทรศัพท์ x-apidog-orders: - addressId - locationName - location - locationEN - fullAddress - fullAddressEN - subdistrict - subdistrictEN - district - districtEN - province - provinceEN - zipCode - phone description: ที่อยู่ลูกค้าแบบ structured required: - addressId - locationName - location - locationEN - fullAddress - fullAddressEN - subdistrict - subdistrictEN - district - districtEN - province - provinceEN - zipCode - phone x-apidog-orders: - salesOrderSubject - customerCode - customerId - salesOrderNo - salesOrderStatus - salesOrderDate - recipientName - recipientAddress - headerTemplateId - warehouseCode - salesorderDetails - discountName - discountValue - discountType - paymentTerm - remark - staffCode - vatCalculation - subTotal - subTotalWithDiscount - grandTotal - payment - privateNote - invoiceInfo - shippingDocumentUrl - trackingNo - discounts - referenceNo - contactId - customerAddressId - currencyCode - salesOrderId - totalVat - integrationPlatform - recipient - isIntegrationOrderPaid - salesOrderCustomerAddress required: - salesOrderSubject - salesOrderNo - salesOrderStatus - salesOrderDate - referenceNo - customerCode - staffCode - vatCalculation - subTotal - subTotalWithDiscount - totalVat - grandTotal - salesorderDetails - currencyCode - customerId - payment - privateNote - invoiceInfo - shippingDocumentUrl - trackingNo - discounts - customerAddressId - salesOrderId - integrationPlatform - recipient - isIntegrationOrderPaid - salesOrderCustomerAddress x-apidog-orders: - status - data required: - status - data examples: '1': summary: OK (200) value: status: code: '1000' description: Success data: salesOrderSubject: ใบสั่งขายจากใบเสนอราคา QT-2025-00123 customerCode: C001 customerId: 5001 salesOrderNo: SO-2025-00456 salesOrderStatus: 1 salesOrderDate: '2025-04-21T00:00:00' recipientName: คุณสมชาย ใจดี recipientAddress: 123 ถนนสุขุมวิท แขวงคลองเตย กรุงเทพฯ 10110 headerTemplateId: 3 warehouseCode: WH-01 salesorderDetails: - productCode: PRD-001 productName: สินค้าตัวอย่าง A price: 1000 qty: 2 productUnitName: ชิ้น productDescription: รายละเอียดสินค้า A discountValue: 50 discountType: false vatTaxValue: 7 whtTaxValue: null totalPrice: 1950 unitId: 1 isShipping: true warehouseCode: WH-01 discountName: ส่วนลดพิเศษ discountValue: 100 discountType: false paymentTerm: ชำระภายใน 30 วัน remark: กรุณาจัดส่งภายในวันศุกร์ staffCode: EMP-001 vatCalculation: true subTotal: 2000 subTotalWithDiscount: 1900 grandTotal: 2033 payment: valueType: 1 schedulePayments: - installmentNumber: 1 status: 2 installmentAmount: 1016.5 installmentPercent: 50 - installmentNumber: 2 status: 2 installmentAmount: 1016.5 installmentPercent: 50 privateNote: หมายเหตุที่ไม่แสดงให้ลูกค้าเห็น invoiceInfo: id: 9001 integrationPlatform: 400020 integrationBuyerId: SHOPEE-BUY-12345 type: 13001 customerName: สมชาย ใจดี taxId: '1234567890123' isEtax: true isHeadOffice: true branch: สำนักงานใหญ่ branchCode: '00000' country: Thailand province: กรุงเทพมหานคร district: คลองเตย subDistrict: คลองเตย zipCode: '10110' phone: '0812345678' address: 123 ถนนสุขุมวิท email: somchai@example.com shippingDocumentUrl: https://storage.example.com/shipping/doc-001.pdf trackingNo: TH123456789 discounts: - discountName: ส่วนลดสมาชิก discountValue: 50 discountType: false - discountName: ส่วนลดตามปริมาณ discountValue: 5 discountType: true referenceNo: REF-2025-001 contactId: 101 customerAddressId: 201 currencyCode: THB salesOrderId: 277474 totalVat: 133 integrationPlatform: 400020 recipient: name: คุณสมชาย ใจดี email: somchai@example.com phone: '0812345678' country: Thailand province: กรุงเทพมหานคร district: คลองเตย subDistrict: คลองเตย zipCode: '10110' address: 123 ถนนสุขุมวิท แขวงคลองเตย isIntegrationOrderPaid: false salesOrderCustomerAddress: addressId: 201 locationName: สำนักงานใหญ่ location: 123 ถนนสุขุมวิท แขวงคลองเตย เขตคลองเตย กรุงเทพฯ 10110 locationEN: 123 Sukhumvit Rd, Khlong Toei, Bangkok 10110 fullAddress: >- 123 ถนนสุขุมวิท แขวงคลองเตย เขตคลองเตย กรุงเทพมหานคร 10110 fullAddressEN: >- 123 Sukhumvit Rd, Khlong Toei Sub-district, Khlong Toei District, Bangkok 10110 subdistrict: คลองเตย subdistrictEN: Khlong Toei district: คลองเตย districtEN: Khlong Toei province: กรุงเทพมหานคร provinceEN: Bangkok zipCode: '10110' phone: '021234567' '2': summary: Bad Request (400) value: status: code: '4001' description: Business error with 1 or more errors data: errors: - subCode: E1102 description: QuotationStatus must be in status sent! metadata: E1102 - subCode: E1102 description: QuotationNo doesn't exists! '3': summary: Unauthorized (401) value: statusCode: 401 message: >- Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription. headers: {} x-apidog-name: OK '401': description: '' content: application/json: schema: type: object properties: statusCode: type: integer description: |- สถานะ code ของ httpเช่น 200 Ok 201 Created 400 BadRequest 401 Unauthorized 404 Record not found 500 Internal Server Error message: type: string description: คำบรรยาย error x-apidog-orders: - statusCode - message required: - statusCode - message headers: {} x-apidog-name: Unauthorized x-200:Bad Request: description: '' content: application/json: schema: type: object properties: status: type: object properties: code: type: string description: "

สถานะของ\_Business\_Code\_ถ้า
Success\_=\_1000
Error\_1\_ตัว\_=\_4001
Error\_มากกว่า\_1\_ตัว\_=\_4002\_\_\_\_
หรือเป็น\_Subcode\_ที่ต้องการจะแสดงเพื่อสื่อความหมายของ\_Error\_โดย\_subcode\_จะเป็นตัวเดียวกับ\_business\_error\_code\_หรือไม่ก็ได้\_เพื่อความสะดวกในการแสดงผล

" description: type: string description: คำอธิบายข้อความที่จะแสดง x-apidog-orders: - code - description required: - code - description data: type: object properties: errors: type: array items: type: object properties: subCode: type: string description: >- เป็น Subcode ที่ต้องการจะแสดงเพื่อมีความหมายสำหรับ Module ของเจ้าของในการดู Error โดย subcode จะเป็นตัวเดียวกับ business erroe code หรือไม่ก็ได้ เพื่อความสะดวกในการแสดงผล description: type: string description: คำอธิบายข้อความที่จะแสดง metadata: type: string description: >- เป็น metadata สำหรับแสดงผลของ Business นั้นๆ ไม่ Fix x-apidog-orders: - subCode - description - metadata required: - description description: >- เป็นส่วนแสดงผล Error ที่พบว่ามีจำนวนกี่ชุดก็ได้ไม่จำกัดเพื่อความสะดวกในการจัดการกับ Error x-apidog-orders: - errors required: - errors description: >- ข้อมูลที่จะแสดง ไม่จำกัดรูปแบบว่าจะเป็นเช่นไร ตอนเรียกออกมาสามารเป็น Array และ Object ได้ x-apidog-orders: - status - data required: - status - data headers: {} x-apidog-name: Bad Request security: - bearer: [] x-apidog-folder: Venio/Quotation x-apidog-status: developing x-run-in-apidog: https://app.apidog.com/web/project/351895/apis/api-3590356-run components: schemas: {} securitySchemes: bearerAuth: type: jwt scheme: bearer bearerFormat: JWT description: ใส่ JWT Token ในรูปแบบ Bearer {token} bearer: type: http scheme: bearer servers: - url: https://api.gofive.co.th description: Production security: - bearerAuth: [] x-apidog: schemeGroups: - id: uyL_cJmK7q60QJZRTi5ot schemeIds: - bearerAuth required: true use: id: uyL_cJmK7q60QJZRTi5ot scopes: uyL_cJmK7q60QJZRTi5ot: bearerAuth: [] ```