Quote line items

The workflows below are for draft quotes. Update line items before issuing the quote.

Update quote line items

To add, replace, or remove line items while updating other quote fields, call PATCH /receivables/{receivable_id}. The response for every quote line item includes a stable id; use that ID when replacing or removing an existing item. The line_items object can contain add, replace, and remove operations in the same request. Each item in add and replace[].data uses the complete line item shape accepted by the replace line items endpoint. A replace operation keeps the existing line item’s ID.

curl -X PATCH 'https://api.sandbox.tesouro.com/finops/v1/receivables/411dc6eb...6289b3' \
     -H 'X-Finops-Version: 2025-06-23' \
     -H 'X-Organization-Id: ORGANIZATION_ID' \
     -H 'Authorization: Bearer ACCESS_TOKEN' \
     -H 'Content-Type: application/json' \
     -d '{
       "quote": {
         "memo": "Updated implementation estimate",
         "line_items": {
           "add": [
             {
               "quantity": 1,
               "product_id": "fb2cc78f-3396-42e1-a69f-04b1931e4a84",
               "vat_rate_id": "8d4c2c10-f7d7-4d7c-a1f5-5f3a9d56371e"
             }
           ],
           "replace": [
             {
               "id": "5c4798b6-4b3f-4b0c-9ed6-5242c144a0c1",
               "data": {
                 "quantity": 3,
                 "product_id": "d1bc6df0-1571-457c-8407-7cf42aceb5dd",
                 "vat_rate_id": "8d4c2c10-f7d7-4d7c-a1f5-5f3a9d56371e"
               }
             }
           ],
           "remove": ["cd9e0e72-8a6c-4f09-8b62-5e63f6320a5d"]
         }
       }
     }'

Include at least one operation. Do not use the same line item ID more than once or in both replace and remove. The final quote must contain at least one line item. Tesouro recalculates the totals from the resulting list and records the header and line-item changes in one history entry.

Replace all quote line items

To replace the entire list in a separate request, send a PUT request to the /receivables/{receivable_id}/line-items endpoint. In the request body, use the data field to specify the quote’s new line items. This endpoint is unchanged.

curl -X PUT 'https://api.sandbox.tesouro.com/finops/v1/receivables/411dc6eb...6289b3/line-items' \
     -H 'X-Finops-Version: 2025-06-23' \
     -H 'X-Organization-Id: ORGANIZATION_ID' \
     -H 'Authorization: Bearer ACCESS_TOKEN' \
     -H 'Content-Type: application/json' \
     -d '{
       "data": [
         {
           "quantity": 2,
           "product_id": "fb2cc78f-3396-42e1-a69f-04b1931e4a84",
           "vat_rate_id": "8d4c2c10-f7d7-4d7c-a1f5-5f3a9d56371e",
           "discount": {
             "type": "amount",
             "amount": 0
           }
         },
         {
           "quantity": 4,
           "product_id": "d1bc6df0-1571-457c-8407-7cf42aceb5dd",
           "vat_rate_id":"8d4c2c10-f7d7-4d7c-a1f5-5f3a9d56371e",
           "discount": {
             "type":"amount",
             "amount":0
           }
         }
       ]
     }'

A successful request overwrites the quote’s existing line items and replaces them with the newly defined array of line item objects.

Getting started

Embedded components

Authentication

Roles & permissions

Manage organizations

Common objects

Accounts payable

Accounts receivable

Expense management

Payments

Advanced

Accounting integrations

Quote line items

Update quote line items

Replace all quote line items

​Update quote line items

​Replace all quote line items

Update quote line items

Replace all quote line items