Slip

A charge [Slip] is a customer billing entry, whether it is time, a fixed fee, an expense, or a product that is being billed. Charges are grouped into invoices.

Review the Usage Guidelines for the Slip object.

—	XML	SOAP	REST	Database table
Object	`Slip`	`oaSlip`	—	`slip`
Supported Commands	`Add`, `Read`, `Modify`, `Delete`	`add()`, `read()`, `modify()`, `upsert()`, `delete()`	—	—

—

XML

SOAP

REST

Database table

Object

Slip

oaSlip

—

slip

Supported Commands

Add, Read, Modify, Delete

add(), read(), modify(), upsert(), delete()

—

The Slip object has the following standard properties:

Note:

Slip object properties may also include custom fields. The object type supports the custom equal to read method and the enable_custom read attribute.

XML / SOAP	Database	Description
`acct_date`	`acct_date`	The accounting period date of the slip. See Date Fields
`agreementid`	`agreement_id`	The ID of the associated agreement.
`billing_contactid`	`—`	[Read-only] The ID of the billing contact associated with the invoice this charge is part of.
`category_<N>id where <N> is an integer from 1 to 5`	`category_<N>_id where <N> is an integer from 1 to 5`	The ID of the associated `category_<N>`.
`categoryid`	`category_id`	The ID of the associated category. When set, the slip is based on this category.
`city`	`city`	The slip city or location.
`cost`	`cost`	The cost per unit of measure for an E or P slip, the billing rate for an O slip, or the fixed price for a F slip. Dated by the date field.
`cost_centerid`	`cost_center_id`	The ID of the associated cost center. If not set when adding an object, it set to the internal ID of the cost center for the time entry or receipt associated with this charge.
`created`	`created`	[Read-only] Time the record was created. See Date Fields
`currency`	`currency`	Currency for the money fields in the record
`customerid`	`customer_id`	The ID of the associated customer.
`customerpoid`	`customerpo_id`	The ID of the associated customerpo.
`date`	`date`	[Required] The date of the billing slip. See Date Fields
`decimal_hours`	`—`	The number of decimal hours for a T slip.
`description`	`description`	The description of the billing slip.
`gl_code`	`—`	[Read-only] The fixed code 1234455454.
`hour`	`hour`	The number of hours for a T slip.
`id`	`id`	[Read-only] Unique ID. Automatically assigned by SuiteProjects Pro.
`invoiceid`	`invoice_id`	The ID of the associated invoice once billed.
`itemid`	`itemid`	The ID of the associated item. If this is set, the slip is based on this item. Determine the subtype using the associated item type.
`job_code_id`	`job_code_id`	The ID of the associated job code.
`minute`	`minute`	The number of minutes for a T slip.
`notes`	`notes`	Notes associated with the slip.
`originating_id`	`originating_id`	For use with split slips feature. If set, the slip.id of the originating slip for this split portion.
`payment_typeid`	`payment_type_id`	The ID of the associated payment type.
`payroll_typeid`	`payroll_type_id`	The ID of the associated payroll type.
`portfolio_projectid`	`portfolio_project_id`	The ID of the associated portfolio project.
`productid`	`product_id`	The ID of the associated product.
`project_billing_ruleid`	`—`	[Read-only] The ID of the associated project billing rule.
`projectid`	`project_id`	The ID of the associated project.
`projecttask_typeid`	`projecttask_type_id`	The ID of the projecttask_type of the associated projecttask.
`projecttaskid`	`projecttask_id`	The ID of the task within the associated project.
`quantity`	`quantity`	The quantity for an E, O, or P slip.
`rate`	`rate`	The hourly rate for a T slip. Dated by the date field.
`ref_slipid`	`ref_slipid`	For credit/rebill, ID of the original slip ID.
`shipping_contactid`	`shipping_contact_id`	[Read-only] The ID of the shipping contact associated with the invoice this charge is part of.
`skip_recognition`	`skip_recognition`	A 1/0 field indicating if this record should be recognized. Used for split charges which were already recognized.
`slip_stageid`	`slip_stage_id`	The ID of the associated slip stage.
`sold_to_contactid`	`—`	[Read-only] The ID of the sold-to contact associated with the invoice this charge is part of.
`tax_location_name`	`—`	[Read-only] The name of the tax location
`tax_rate_adjusted`	`—`	[Read-only] A 1/0 field indicating if the tax amount for this charge was adjusted to ensure that the sum of tax amounts for every charges in the invoice match the total tax amount for the invoice.
`tax_rateid`	`—`	[Read-only] The ID of the tax rate
`timer_start`	`timer_start`	The starting time of the timer. See Date Fields
`timetypeid`	`timetype_id`	The ID of the associated time type.
`total`	`total`	The total value of the slip. Dated by the date field.
`total_tax`	`total_tax_paid`	[Read-only] The total tax paid. Dated by the date field.
`total_with_tax`	`—`	[Read-only] The total value of the slip including tax.
`type`	`type`	The type of the slip: T -hourly rate slip E -expense slip F -flat price slip O -other time slip M -incomplete slip P -product slip
`unitm`	`um`	The unit of measure for an E or P slip or the rate description for an O slip.
`updated`	`updated`	[Read-only] Time the record was last updated or modified. See Date Fields
`userid`	`user_id`	[Required] The ID of the associated user.

XML / SOAP

Database

Description

acct_date

The accounting period date of the slip.

See Date Fields

agreementid

agreement_id

The ID of the associated agreement.

billing_contactid

—

[Read-only] The ID of the billing contact associated with the invoice this charge is part of.

category_<N>id where <N> is an integer from 1 to 5

category_<N>_id where <N> is an integer from 1 to 5

The ID of the associated category_<N>.

categoryid

category_id

The ID of the associated category. When set, the slip is based on this category.

city

The slip city or location.

cost

The cost per unit of measure for an E or P slip, the billing rate for an O slip, or the fixed price for a F slip. Dated by the date field.

cost_centerid

cost_center_id

The ID of the associated cost center. If not set when adding an object, it set to the internal ID of the cost center for the time entry or receipt associated with this charge.

created

[Read-only] Time the record was created.

See Date Fields

currency

Currency for the money fields in the record

customerid

customer_id

The ID of the associated customer.

customerpoid

customerpo_id

The ID of the associated customerpo.

date

[Required] The date of the billing slip.

See Date Fields

decimal_hours

—

The number of decimal hours for a T slip.

description

The description of the billing slip.

gl_code

—

[Read-only] The fixed code 1234455454.

hour

The number of hours for a T slip.

id

[Read-only] Unique ID. Automatically assigned by SuiteProjects Pro.

invoiceid

invoice_id

The ID of the associated invoice once billed.

itemid

The ID of the associated item. If this is set, the slip is based on this item. Determine the subtype using the associated item type.

job_code_id

The ID of the associated job code.

minute

The number of minutes for a T slip.

notes

Notes associated with the slip.

originating_id

For use with split slips feature. If set, the slip.id of the originating slip for this split portion.

payment_typeid

payment_type_id

The ID of the associated payment type.

payroll_typeid

payroll_type_id

The ID of the associated payroll type.

portfolio_projectid

portfolio_project_id

The ID of the associated portfolio project.

productid

product_id

The ID of the associated product.

project_billing_ruleid

—

[Read-only] The ID of the associated project billing rule.

projectid

project_id

The ID of the associated project.

projecttask_typeid

projecttask_type_id

The ID of the projecttask_type of the associated projecttask.

projecttaskid

projecttask_id

The ID of the task within the associated project.

quantity

The quantity for an E, O, or P slip.

rate

The hourly rate for a T slip. Dated by the date field.

ref_slipid

For credit/rebill, ID of the original slip ID.

shipping_contactid

shipping_contact_id

[Read-only] The ID of the shipping contact associated with the invoice this charge is part of.

skip_recognition

A 1/0 field indicating if this record should be recognized. Used for split charges which were already recognized.

slip_stageid

slip_stage_id

The ID of the associated slip stage.

sold_to_contactid

—

[Read-only] The ID of the sold-to contact associated with the invoice this charge is part of.

tax_location_name

—

[Read-only] The name of the tax location

tax_rate_adjusted

—

[Read-only] A 1/0 field indicating if the tax amount for this charge was adjusted to ensure that the sum of tax amounts for every charges in the invoice match the total tax amount for the invoice.

tax_rateid

—

[Read-only] The ID of the tax rate

timer_start

The starting time of the timer.

See Date Fields

timetypeid

timetype_id

The ID of the associated time type.

total

The total value of the slip. Dated by the date field.

total_tax

total_tax_paid

[Read-only] The total tax paid. Dated by the date field.

total_with_tax

—

[Read-only] The total value of the slip including tax.

type

The type of the slip:

T -hourly rate slip
E -expense slip
F -flat price slip
O -other time slip
M -incomplete slip
P -product slip

unitm

um

The unit of measure for an E or P slip or the rate description for an O slip.

updated

[Read-only] Time the record was last updated or modified.

See Date Fields

userid

user_id

[Required] The ID of the associated user.

Usage Guidelines

Review the following guidelines:

When reading Slip objects, if the response does not include all expected objects, verify your company's SuiteProjects Pro account configuration. The following account configuration settings, in particular, can modify the API behavior:
- The API can be configured to convert all monetary values on charges into the invoice currency. In this case, only invoiced charges are returned.
- The API can be configured to filter out charges associated with charge stages excluded from invoicing. In this case, only charges in charge stages that can be invoiced are returned
To review these and other configuration settings, contact your SuiteProjects Pro Professional Services representative or SuiteProjects Pro Support.
When adding Slip objects associated with an invoice:
- The customerid if specified must be the internal ID of the customer associated with that invoice.
- The customer associated with the invoice must be the same as the customer associated with the project with internal ID projectid, if specified.
When modifying Slip objects, invoiceid is read-only. Charges cannot be moved from one invoice to another.
Some properties are required depending on the type:
- rate and either hours, minutes or decimal_hours for a type T slip.
- cost for a type E, F, O, or P slip.
- quantity and unitm for a type E, O, or P slip.