RFQs

Create and submit RFQ

Create a new RFQ in Submitted status with strict validation.

Required fields:

client_id: Client requesting the quote
pic_id: Person in charge (staff member)
requested_by_id: Contact who requested this RFQ
requested_response_date: When client needs response
planned_response_date: When you plan to respond
note: RFQ description/notes
line_items: At least 1 line item required

Optional fields:

ref_id: Client reference number
attachment_link: URL to supporting documents

Use this when:

RFQ is complete and ready for processing
All required information is available
Client has been notified

Line Item Status:

All line items automatically set to “Submitted”

Example:

{
    "client_id": "client-uuid",
    "pic_id": "user-uuid",
    "requested_by_id": "contact-uuid",
    "requested_response_date": "2024-03-15",
    "planned_response_date": "2024-03-10",
    "note": "Urgent spring collection request",
    "line_items": [
        {
            "master_style_id": "style-uuid",
            "pic_id": "user-uuid",
            "moq": 100
        }
    ]
}

POST

rfqs

submit

Create and submit RFQ

curl --request POST \
  --url https://vinmake-erp.onrender.com/rfqs/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_id": "client-uuid-123",
  "line_items": [
    {
      "master_style_id": "style-uuid-001",
      "moq": 100,
      "note": "Red variant needed",
      "pic_id": "user-uuid-456"
    },
    {
      "master_style_id": "style-uuid-002",
      "moq": 200,
      "note": "Blue variant needed",
      "pic_id": "user-uuid-789"
    }
  ],
  "note": "Urgent request for spring collection",
  "pic_id": "user-uuid-456",
  "planned_response_date": "2024-02-10",
  "ref_id": "CLIENT-REF-001",
  "requested_by_id": "contact-uuid-789",
  "requested_response_date": "2024-02-15"
}
'

import requests

url = "https://vinmake-erp.onrender.com/rfqs/submit"

payload = {
    "client_id": "client-uuid-123",
    "line_items": [
        {
            "master_style_id": "style-uuid-001",
            "moq": 100,
            "note": "Red variant needed",
            "pic_id": "user-uuid-456"
        },
        {
            "master_style_id": "style-uuid-002",
            "moq": 200,
            "note": "Blue variant needed",
            "pic_id": "user-uuid-789"
        }
    ],
    "note": "Urgent request for spring collection",
    "pic_id": "user-uuid-456",
    "planned_response_date": "2024-02-10",
    "ref_id": "CLIENT-REF-001",
    "requested_by_id": "contact-uuid-789",
    "requested_response_date": "2024-02-15"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    client_id: 'client-uuid-123',
    line_items: [
      {
        master_style_id: 'style-uuid-001',
        moq: 100,
        note: 'Red variant needed',
        pic_id: 'user-uuid-456'
      },
      {
        master_style_id: 'style-uuid-002',
        moq: 200,
        note: 'Blue variant needed',
        pic_id: 'user-uuid-789'
      }
    ],
    note: 'Urgent request for spring collection',
    pic_id: 'user-uuid-456',
    planned_response_date: '2024-02-10',
    ref_id: 'CLIENT-REF-001',
    requested_by_id: 'contact-uuid-789',
    requested_response_date: '2024-02-15'
  })
};

fetch('https://vinmake-erp.onrender.com/rfqs/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://vinmake-erp.onrender.com/rfqs/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'client_id' => 'client-uuid-123',
    'line_items' => [
        [
                'master_style_id' => 'style-uuid-001',
                'moq' => 100,
                'note' => 'Red variant needed',
                'pic_id' => 'user-uuid-456'
        ],
        [
                'master_style_id' => 'style-uuid-002',
                'moq' => 200,
                'note' => 'Blue variant needed',
                'pic_id' => 'user-uuid-789'
        ]
    ],
    'note' => 'Urgent request for spring collection',
    'pic_id' => 'user-uuid-456',
    'planned_response_date' => '2024-02-10',
    'ref_id' => 'CLIENT-REF-001',
    'requested_by_id' => 'contact-uuid-789',
    'requested_response_date' => '2024-02-15'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://vinmake-erp.onrender.com/rfqs/submit"

	payload := strings.NewReader("{\n  \"client_id\": \"client-uuid-123\",\n  \"line_items\": [\n    {\n      \"master_style_id\": \"style-uuid-001\",\n      \"moq\": 100,\n      \"note\": \"Red variant needed\",\n      \"pic_id\": \"user-uuid-456\"\n    },\n    {\n      \"master_style_id\": \"style-uuid-002\",\n      \"moq\": 200,\n      \"note\": \"Blue variant needed\",\n      \"pic_id\": \"user-uuid-789\"\n    }\n  ],\n  \"note\": \"Urgent request for spring collection\",\n  \"pic_id\": \"user-uuid-456\",\n  \"planned_response_date\": \"2024-02-10\",\n  \"ref_id\": \"CLIENT-REF-001\",\n  \"requested_by_id\": \"contact-uuid-789\",\n  \"requested_response_date\": \"2024-02-15\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://vinmake-erp.onrender.com/rfqs/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"client_id\": \"client-uuid-123\",\n  \"line_items\": [\n    {\n      \"master_style_id\": \"style-uuid-001\",\n      \"moq\": 100,\n      \"note\": \"Red variant needed\",\n      \"pic_id\": \"user-uuid-456\"\n    },\n    {\n      \"master_style_id\": \"style-uuid-002\",\n      \"moq\": 200,\n      \"note\": \"Blue variant needed\",\n      \"pic_id\": \"user-uuid-789\"\n    }\n  ],\n  \"note\": \"Urgent request for spring collection\",\n  \"pic_id\": \"user-uuid-456\",\n  \"planned_response_date\": \"2024-02-10\",\n  \"ref_id\": \"CLIENT-REF-001\",\n  \"requested_by_id\": \"contact-uuid-789\",\n  \"requested_response_date\": \"2024-02-15\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://vinmake-erp.onrender.com/rfqs/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"client_id\": \"client-uuid-123\",\n  \"line_items\": [\n    {\n      \"master_style_id\": \"style-uuid-001\",\n      \"moq\": 100,\n      \"note\": \"Red variant needed\",\n      \"pic_id\": \"user-uuid-456\"\n    },\n    {\n      \"master_style_id\": \"style-uuid-002\",\n      \"moq\": 200,\n      \"note\": \"Blue variant needed\",\n      \"pic_id\": \"user-uuid-789\"\n    }\n  ],\n  \"note\": \"Urgent request for spring collection\",\n  \"pic_id\": \"user-uuid-456\",\n  \"planned_response_date\": \"2024-02-10\",\n  \"ref_id\": \"CLIENT-REF-001\",\n  \"requested_by_id\": \"contact-uuid-789\",\n  \"requested_response_date\": \"2024-02-15\"\n}"

response = http.request(request)
puts response.read_body

{
  "document_id": "vin_RFQ_0001",
  "message": "RFQ created successfully",
  "rfq_id": "uuid-123-456",
  "status": " ",
  "success": true
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Schema for creating a submitted RFQ (strict validation)

client_id

string

required

Client ID (required)

pic_id

string

required

Person in charge (required)

requested_by_id

string

required

Contact who requested the RFQ (required)

requested_response_date

string<date>

required

Response date required for submission

planned_response_date

string<date>

required

Planned date required for submission

note

string

required

RFQ notes/description (required)

line_items

RFQLineItemCreate · object[]

required

At least one line item required for submission

Minimum array length: 1

Show child attributes

ref_id

string | null

attachment_link

string | null

Response

Successful Response

Response schema for RFQ creation

success

boolean

required

message

string

required

document_id

string

required

rfq_id

string

required

status

string

required

List all RFQs with paginationRetrieve a paginated list of RFQs with filtering, sorting, and search capabilities. **Query Parameters:** - `page`: Page number (default: 1) - `limit`: Items per page (default: 10, max: 100) - `status`: Filter by RFQ status - `sort`: Sort field (prefix with `-` for descending, e.g., `-created_at`) - `search`: Search in document_id **Available Status Values:** - Draft - Submitted - Work in progress - Partially approved - Approved - Rejected **Sort Fields:** - `created_at` (default: `-created_at` - newest first) - `planned_response_date` - `document_id` - `status` **Examples:** - Get first page: `GET /rfqs` - Filter by status: `GET /rfqs?status=Submitted` - Search: `GET /rfqs?search=vin_RFQ_0001` - Sort by date ascending: `GET /rfqs?sort=created_at` - Combine filters: `GET /rfqs?status=Submitted&page=2&limit=20&sort=-created_at`

Create and submit RFQ

curl --request POST \
  --url https://vinmake-erp.onrender.com/rfqs/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_id": "client-uuid-123",
  "line_items": [
    {
      "master_style_id": "style-uuid-001",
      "moq": 100,
      "note": "Red variant needed",
      "pic_id": "user-uuid-456"
    },
    {
      "master_style_id": "style-uuid-002",
      "moq": 200,
      "note": "Blue variant needed",
      "pic_id": "user-uuid-789"
    }
  ],
  "note": "Urgent request for spring collection",
  "pic_id": "user-uuid-456",
  "planned_response_date": "2024-02-10",
  "ref_id": "CLIENT-REF-001",
  "requested_by_id": "contact-uuid-789",
  "requested_response_date": "2024-02-15"
}
'

import requests

url = "https://vinmake-erp.onrender.com/rfqs/submit"

payload = {
    "client_id": "client-uuid-123",
    "line_items": [
        {
            "master_style_id": "style-uuid-001",
            "moq": 100,
            "note": "Red variant needed",
            "pic_id": "user-uuid-456"
        },
        {
            "master_style_id": "style-uuid-002",
            "moq": 200,
            "note": "Blue variant needed",
            "pic_id": "user-uuid-789"
        }
    ],
    "note": "Urgent request for spring collection",
    "pic_id": "user-uuid-456",
    "planned_response_date": "2024-02-10",
    "ref_id": "CLIENT-REF-001",
    "requested_by_id": "contact-uuid-789",
    "requested_response_date": "2024-02-15"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    client_id: 'client-uuid-123',
    line_items: [
      {
        master_style_id: 'style-uuid-001',
        moq: 100,
        note: 'Red variant needed',
        pic_id: 'user-uuid-456'
      },
      {
        master_style_id: 'style-uuid-002',
        moq: 200,
        note: 'Blue variant needed',
        pic_id: 'user-uuid-789'
      }
    ],
    note: 'Urgent request for spring collection',
    pic_id: 'user-uuid-456',
    planned_response_date: '2024-02-10',
    ref_id: 'CLIENT-REF-001',
    requested_by_id: 'contact-uuid-789',
    requested_response_date: '2024-02-15'
  })
};

fetch('https://vinmake-erp.onrender.com/rfqs/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://vinmake-erp.onrender.com/rfqs/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'client_id' => 'client-uuid-123',
    'line_items' => [
        [
                'master_style_id' => 'style-uuid-001',
                'moq' => 100,
                'note' => 'Red variant needed',
                'pic_id' => 'user-uuid-456'
        ],
        [
                'master_style_id' => 'style-uuid-002',
                'moq' => 200,
                'note' => 'Blue variant needed',
                'pic_id' => 'user-uuid-789'
        ]
    ],
    'note' => 'Urgent request for spring collection',
    'pic_id' => 'user-uuid-456',
    'planned_response_date' => '2024-02-10',
    'ref_id' => 'CLIENT-REF-001',
    'requested_by_id' => 'contact-uuid-789',
    'requested_response_date' => '2024-02-15'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://vinmake-erp.onrender.com/rfqs/submit"

	payload := strings.NewReader("{\n  \"client_id\": \"client-uuid-123\",\n  \"line_items\": [\n    {\n      \"master_style_id\": \"style-uuid-001\",\n      \"moq\": 100,\n      \"note\": \"Red variant needed\",\n      \"pic_id\": \"user-uuid-456\"\n    },\n    {\n      \"master_style_id\": \"style-uuid-002\",\n      \"moq\": 200,\n      \"note\": \"Blue variant needed\",\n      \"pic_id\": \"user-uuid-789\"\n    }\n  ],\n  \"note\": \"Urgent request for spring collection\",\n  \"pic_id\": \"user-uuid-456\",\n  \"planned_response_date\": \"2024-02-10\",\n  \"ref_id\": \"CLIENT-REF-001\",\n  \"requested_by_id\": \"contact-uuid-789\",\n  \"requested_response_date\": \"2024-02-15\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://vinmake-erp.onrender.com/rfqs/submit")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"client_id\": \"client-uuid-123\",\n  \"line_items\": [\n    {\n      \"master_style_id\": \"style-uuid-001\",\n      \"moq\": 100,\n      \"note\": \"Red variant needed\",\n      \"pic_id\": \"user-uuid-456\"\n    },\n    {\n      \"master_style_id\": \"style-uuid-002\",\n      \"moq\": 200,\n      \"note\": \"Blue variant needed\",\n      \"pic_id\": \"user-uuid-789\"\n    }\n  ],\n  \"note\": \"Urgent request for spring collection\",\n  \"pic_id\": \"user-uuid-456\",\n  \"planned_response_date\": \"2024-02-10\",\n  \"ref_id\": \"CLIENT-REF-001\",\n  \"requested_by_id\": \"contact-uuid-789\",\n  \"requested_response_date\": \"2024-02-15\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://vinmake-erp.onrender.com/rfqs/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"client_id\": \"client-uuid-123\",\n  \"line_items\": [\n    {\n      \"master_style_id\": \"style-uuid-001\",\n      \"moq\": 100,\n      \"note\": \"Red variant needed\",\n      \"pic_id\": \"user-uuid-456\"\n    },\n    {\n      \"master_style_id\": \"style-uuid-002\",\n      \"moq\": 200,\n      \"note\": \"Blue variant needed\",\n      \"pic_id\": \"user-uuid-789\"\n    }\n  ],\n  \"note\": \"Urgent request for spring collection\",\n  \"pic_id\": \"user-uuid-456\",\n  \"planned_response_date\": \"2024-02-10\",\n  \"ref_id\": \"CLIENT-REF-001\",\n  \"requested_by_id\": \"contact-uuid-789\",\n  \"requested_response_date\": \"2024-02-15\"\n}"

response = http.request(request)
puts response.read_body

{
  "document_id": "vin_RFQ_0001",
  "message": "RFQ created successfully",
  "rfq_id": "uuid-123-456",
  "status": " ",
  "success": true
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}