LineItem

An object representing a product/service added to a project or an opportunity.

Supported API Calls: List | Get | Add | Update | Delete

Object Properties

Property

Type

Description

Id

integer

A unique ID representing the LineItem object. When adding a new LineItem the value must be 0.

ParentId

integer

ID of the parent object.

ParentObject

string (100)

Name of the parent object type. Values are Project or Opportunity.

ProductId

integer

The ID of the product that represents the line item.

PriceBookEntryId

integer

ID of the product as a price book entry.

Description

string (100)

Product description

Quantity

float

The quantity for the Edit Product Info's Quantity field. Optional. This value can be null.

UnitPrice

float

The price figure for the Edit Product Info's Unit Price field. Optional. This value can be null.

TotalPrice

float

Stores the total price.

IsStageBilling

boolean

Flag to indicate the item is stage billed.

CurrencyIsoCode

string (100)

Three letter currency code displayed on Edit Product Info dialog box.

ProductName

string (100)

Name of the product.

CanUseQuantitySchedule

boolean

Flag to indicate if the line item is billed using a quantity schedule.

UseStandardPrice

boolean

Flag to indicate the line item should use the product's default price.

NumberOfQuantityInstallment

integer

If using a quantity schedule, how many installments. This value is optional.

QuantityInstallmentPeriod

string (100)

If a repeating payment, the period. Values are: daily, weekly, monthly, quarterly, yearly.

QuantityScheduleType

string (100)

The kind of billing schedule. Values are repeat or divide.

QuantityInstallmentInterval

integer

Number of installment payments

List

Description

Returns a list of products associated with the Project.

URL

https://{company}.bluecamroo.com/api/LineItem/list?ProjectId={ProjectId}

HTTP Method

GET

Parameters

None

Data Return

Returns the list of products in the requested format (e.g., JSON or XML)

HTTP Return Status Code

200: Ok

401: Not authorized (you need to log in)

Get

Description

Returns details for the line item for the specified Project.

URL

https://{company}.bluecamroo.com/api/LineItem/get/{id}?ProjectId={ProjectId}

HTTP Method

GET

Parameters

None

Data Return

Returns the LineItem object in the requested format (e.g., JSON or XML)

HTTP Return Status Code

200: Ok

400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)

401: Not authorized (you need to log in)

403: Forbidden (you don't have permission to this resource)

Add

Description

Adds a product to a Project.

URL

https://{company}.bluecamroo.com/api/LineItem/add

HTTP Method

POST

Parameters

A LineItem object

Data Return

Returns the LineItem object in the requested format (e.g., JSON or XML)

HTTP Return Status Code

201: Created

401: Not authorized (you need to log in)

403: Forbidden (you don't have permission to this resource)

Update

Description

Updates a Project's product.

URL

https://{company}.bluecamroo.com/api/LineItem/update

HTTP Method

PUT

Parameters

A LineItem object

Data Return

Returns the LineItem object in the requested format (e.g., JSON or XML)

HTTP Return Status Code

200: Ok

400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)

401: Not authorized (you need to log in)

403: Forbidden (you don't have permission to this resource)

Delete

Description

Deletes the product associated with the Project.

URL

https://{company}.bluecamroo.com/api/LineItem/{id}?ProjectId={ProjectId}

HTTP Method

DELETE

Parameters

None

Data Return

None

HTTP Return Status Code

200: Ok

400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)

401: Not authorized (you need to log in)

403: Forbidden (you don't have permission to this resource)