---
updatedAt: 2025-03-12T17:32:45.000Z
---

Fetch the complete documentation index at: https://roserocket.readme.io/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Financial Line Items

# Overview

Financial line item objects allow you to track and manage financial amounts throughout your system.

In Rose Rocket, the financial line item is a foundational object for any financial components. It describes a unit price for a single item of goods and services.

Financial Line Items are connected to and store the financial amounts for these objects. View the list below for information on financial line items and connected objects.

* Quotes, for partners and customers
* Driver pay
* Invoices
* Paystubs
* Bills

Quotes also contain financial line items configured by orders. Financial line items are copied to the financial document when an invoice or bill is created from an order or manifest. This confirms separate objects as their own financial totals for supporting variance analysis.

Any financial line items copied to other objects for a financial workflow have a connection using the financial line item history. Use the financial line item history to analyze states such as Quoted, Work in Progress, and Booked.

> NOTE\
> Financial line items are only synced at the single instance when converting to an invoice. These values are not automatically synced if updating an order or quote separately. Only a single financial line item can be connected to a single object. Multiple line items cannot be connected to both an invoice and a bill.

## API configuration

When using the API to make requests, see the pages below for the process. These guides walk through the requirements and setup to access the Rose Rocket API with your application.

* [Authentication](https://roserocket.readme.io/v2.0/docs/rose-rocket-api-oauth-20-authentication-guide) - Access Rose Rocket with OAuth 2.0
* [Object operations](https://roserocket.readme.io/v2.0/docs/crud-operations#http-request) - Configure your requests

## Object structure

Use the table below for information about the financial line item objects.

**Object Key Name:** `financialLineItem`

<br />

| Fields                           | Label                         | Type                                                                                                                                                   | Description                                                                                                            |
| -------------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| `id`                             | ID                            | string                                                                                                                                                 | Global unique identifier for record                                                                                    |
| `fullId`                         | Full ID                       | string                                                                                                                                                 | An auto-generated identifier for the financial line item record.                                                       |
| `type`                           | Type                          | string, enumerated                                                                                                                                     | Category definitions of financial line items, valid values: `Freight`, `fuel `, `surchargeLiftgate`                    |
| `description`                    | Description                   | string                                                                                                                                                 | Line item purpose or nature                                                                                            |
| `rate`                           | Rate                          | float                                                                                                                                                  | Per unit cost of specific service or item                                                                              |
| `quantity`                       | Quantity                      | integer                                                                                                                                                | Number of units for specific service or item                                                                           |
| `glAccount`                      | G/L Account                   | GLAccount connected object  <br /> \*See [Connected object](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations) section         | Optional connection to a G/L Account for accurate financial categorization and reporting on this line item.            |
| `order`                          | Order                         | Order connected object  <br /> \*See [Connected object](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations) section             | Order associated with financial line item                                                                              |
| `quote`                          | Quote                         | Quote connected object  <br /> \*See [Connected object](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations) section             | Quote associated with financial line item                                                                              |
| `manifest`                       | Manifest                      | Manifest connected object  <br /> \*See [Connected object](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations) section          | Manifest associated with financial line item                                                                           |
| `invoice`                        | Invoice                       | Invoice connected object  <br /> \*See [Connected object ](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations)section           | Invoice associated with financial line item                                                                            |
| `bill`                           | Bill                          | Bill connected object  <br /> \*See [Connected object ](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations)section              | Bill associated with financial line item                                                                               |
| `copiedFrom`                     | Copied From                   | financialLineItem connected object  <br /> \*See [Connected object ](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations)section | Identification of existing item generating the specific line item  <br /> \*See Copied from behavior section for more  |
| `copiedTo`                       | Copied To                     | financialLineItem connected object  <br /> \*See [Connected object](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations) section | Identification of existing item generating specific line item  <br /> See Copied from behavior section for more        |
| `category`                       | Category                      | string, enumerated                                                                                                                                     | Line item category, valid values:`revenue`, `expense`                                                                  |
| `historyState`                   | FinancialLineItemHistoryState | string, enumerated                                                                                                                                     | Indicates account step for the financial line item, valid values:`quoted, workInProgress`,` booked`                    |
| `taxRate`                        | Tax Rate                      | Tax Rate connected object  <br /> \*See [Connected object ](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations)section          | [Tax Rate](https://roserocket.readme.io/docs/tax-rate-and-tax-rate-components) associated with the financial line item |
| `user`                           | User                          | User connected object  <br /> \*See [Connected object ](https://roserocket.readme.io/v2.0/docs/object-descriptions-and-operations)section              | User associated with the financial line item                                                                           |
| `destinationFinancialObjectType` | Destination Financial Object  | string, enumerated                                                                                                                                     | The object that the financial line item will end up on, valid values: `invoice`, `bill`, `paystub`                     |

## Copied from behavior

The `copiedFrom` field displays the relationship between the line item and the original existing item. This field makes it easier to track line items throughout the process and to preserve values across the platform.

```
Financial line item 1
├── Order = Order 1
├── copiedTo = Financial line item 2
└── historyState = workInProgress

Financial line item 2
├── Invoice = Invoice 1
├── copiedFrom = Financial line item 1
└── historyState = booked
```

In the above example workflow, the values from the line item are preserved throughout the copying process. This maintains visibility for the values between work in progress statuses and booked line items in Rose Rocket.