POST /sales/quotes/{id}/lines

Create Quote Line

This endpoint allows you to create a Quote Line for a specific Quote.

Operation ID: createQuoteLine

lock This endpoint requires a Bearer token in the Authorization header.

Path Parameters

Name	Type	Description
`id` required path	string	The Quote ID

Request Body

Content-Type: application/json

description string

The description of the Quote Line. Required if the type is "SERVICE".

type string

Type of the item in the Quote Line.

discount integer

Discount applied to the item in the Quote Line.

material_id integer

ID of the associated Material. Required if the type is "MATERIAL".

observations string

Observation or notes of the Quote Line.

other_cost_id integer

ID of the associated Other Cost. Required if the type is "OTHER_COST".

quantity integer

Quantity of the item in the Quote Line.

received_quote_request_line_id integer | null

received_quote_request_line_uuid string | null

unit string

Units of the item in the Quote Line.

unit_price integer

Price per unit of the item in the Quote Line.

vat integer

VAT applied to the item in the Quote Line.

Responses

data object

Quote Line model structure details

id string required read-only

ID of the Quote Line

type string required read-only

Model type

quote_line

attributes object required

material_id integer | null

ID of the associated Material, if the type is "MATERIAL".

description string | null

The description of the Quote Line, if the type is "SERVICE".

type string

Type of the item in the Quote Line.

MATERIAL SERVICE OTHER_COST

base_total number

Total base price of the Quote Line.

discount number

Discount applied to the item in the Quote Line.

discount_total number

Total discount of the Quote Line.

observations string | null

Observation or notes of the Quote Line.

other_cost_id integer | null

ID of the associated Other Cost, if the type is "OTHER_COST".

quantity number

Quantity of the item in the Quote Line.

quote_line_uuid string

Uuid for Quote Line.

received_quote_request_line_id integer | null

ID of the Received Quote Request Line.

received_quote_request_line_uuid string | null

ID of the Received Quote Request Line.

total number

Total price of the Quote Line.

unit string | null

Units of the item in the Quote Line.

unit_price number

Price per unit of the item in the Quote Line.

vat number

VAT applied to the item in the Quote Line.

vat_total number

Total VAT applied to the Quote Line.

status string

error

error object

properties object

Only present when related to property validation error

dev_message string

Example: Property validation error. Check the "properties" section in the response.

http_code integer

400

message string

Example: Property validation error.

more_info string

status string

error

error object

http_code integer

401

message string

Example: Authentication token invalid.

more_info string

status string

error

error object

http_code integer

403

message string

Example: Action unauthorized

more_info string

status string

error

error object

http_code integer

429

message string

Example: Too Many Requests.

more_info string

status string

error

error object

http_code integer

500

message string

Example: An error has occurred during the request.

more_info string

play_circle Try It

Environment

Authorization

Bearer

Path Parameters

Request Body

POST https://api.sandbox.infraspeak.com/v3/sales/quotes/{id}/lines

curl -X POST \
  'https://api.sandbox.infraspeak.com/v3/sales/quotes/{id}/lines' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -d '{
    "description": "",
    "type": "",
    "discount": 0,
    "material_id": 0,
    "observations": "",
    "other_cost_id": 0,
    "quantity": 0,
    "received_quote_request_line_id": 0,
    "received_quote_request_line_uuid": "",
    "unit": "",
    "unit_price": 0,
    "vat": 0
}'

const response = await fetch('https://api.sandbox.infraspeak.com/v3/sales/quotes/{id}/lines', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN',
  },
  body: JSON.stringify({
    "description": "",
    "type": "",
    "discount": 0,
    "material_id": 0,
    "observations": "",
    "other_cost_id": 0,
    "quantity": 0,
    "received_quote_request_line_id": 0,
    "received_quote_request_line_uuid": "",
    "unit": "",
    "unit_price": 0,
    "vat": 0
}),
});

const data = await response.json();

$response = Http::withHeaders([
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
])->withToken('YOUR_API_TOKEN')
  ->post('https://api.sandbox.infraspeak.com/v3/sales/quotes/{id}/lines',
    array (
      'description' => '',
      'type' => '',
      'discount' => 0,
      'material_id' => 0,
      'observations' => '',
      'other_cost_id' => 0,
      'quantity' => 0,
      'received_quote_request_line_id' => 0,
      'received_quote_request_line_uuid' => '',
      'unit' => '',
      'unit_price' => 0,
      'vat' => 0,
    )
  );

import requests

response = requests.post(
    'https://api.sandbox.infraspeak.com/v3/sales/quotes/{id}/lines',
    headers={
        'Accept': 'application/json',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_API_TOKEN',
    },
    json={
        {
            "description": "",
            "type": "",
            "discount": 0,
            "material_id": 0,
            "observations": "",
            "other_cost_id": 0,
            "quantity": 0,
            "received_quote_request_line_id": 0,
            "received_quote_request_line_uuid": "",
            "unit": "",
            "unit_price": 0,
            "vat": 0
        }
    },
)

data = response.json()

data_object Example Response

200 OK

{
    "data": {
        "id": "string",
        "type": "quote_line",
        "attributes": {
            "material_id": 0,
            "description": "string",
            "type": "MATERIAL",
            "base_total": 0,
            "discount": 0,
            "discount_total": 0,
            "observations": "string",
            "other_cost_id": 0,
            "quantity": 0,
            "quote_line_uuid": "string",
            "received_quote_request_line_id": 0,
            "received_quote_request_line_uuid": "string",
            "total": 0,
            "unit": "string",
            "unit_price": 0,
            "vat": 0,
            "vat_total": 0
        }
    }
}

400 Bad Request. Occurs when invalid parameters are provided or on data validation errors. For example, trying to create a resource without providing required fields. In this case, you can check the `properties` attribute on the response for more details.

{
    "status": "error",
    "error": {
        "properties": {},
        "dev_message": "Property validation error. Check the \"properties\" section in the response.",
        "http_code": 400,
        "message": "Property validation error.",
        "more_info": "string"
    }
}

401 Unauthorized. Authentication or permission error. E.g.: missing, incorrect or invalid Access Token.

{
    "status": "error",
    "error": {
        "http_code": 401,
        "message": "Authentication token invalid.",
        "more_info": "string"
    }
}

403 Forbidden. The action can not be fulfilled.

{
    "status": "error",
    "error": {
        "http_code": 403,
        "message": "Action unauthorized",
        "more_info": "string"
    }
}

429 Too Many Requests. The client has sent too many requests in a given amount of time (check Throttling section).

{
    "status": "error",
    "error": {
        "http_code": 429,
        "message": "Too Many Requests.",
        "more_info": "string"
    }
}

500 Internal Server Error. Please, report us and try to provide as much information as possible, such as the endpoint, HTTP request headers and request body if applicable.

{
    "status": "error",
    "error": {
        "http_code": 500,
        "message": "An error has occurred during the request.",
        "more_info": "string"
    }
}