Platform

Changes to REST API

Read bookings using SuiteProjects Pro REST API and use new extensions to the expansion feature.

The following resource is now available: Booking — See Bookings and Booking object properties.

The following endpoints and methods are now available:

GET /bookings/ — See Get the List of Bookings
GET /bookings/{id} — See Get a Booking

The Referenced Objects and Expansion feature can be used to expand the name of the referenced booking type when reading bookings, the name of the referenced job code when reading bookings, time entries and users, and the name of the referenced expense item when reading receipts. The expand parameter now supports the object attributes listed in the following table. For more information about the expansion feature, see Referenced Objects and Expansion.

Main response object	Attribute	Referenced object type
`Attachment`	`attachmentCategoryId`	`attachmentCategory`
`Booking`	`bookingTypeID`	`bookingTypeDisplayName`
`Booking`	`jobCodeID`	`jobCodeDisplayName`
`Receipt`	`itemId`	`itemDisplayName`
`TimeEntry`	`jobCodeID`	`jobCodeDisplayName`
`User`	`jobCodeID`	`jobCodeDisplayName`

Main response object

Attribute

Referenced object type

Attachment

attachmentCategoryId

attachmentCategory

Booking

bookingTypeID

bookingTypeDisplayName

Booking

jobCodeID

jobCodeDisplayName

Receipt

itemId

itemDisplayName

TimeEntry

jobCodeID

jobCodeDisplayName

User

jobCodeID

jobCodeDisplayName

The following object properties are now available. See Attachment object properties, Project object properties, ProjectMilestone Object Properties, ProjectPhase Object Properties, and ProjectTask Object Properties.

Object type	Property	Description
`Attachment`	`parentId`	The internal ID of the parent attachment. `0` or `Null` if the attachments has no ancestors (top-level attachment or folder).
`Project`	`discussionMessageCount`	The number of messages in the project discussion for the project. For more information about the Project Discussions feature, see Project Discussions.
`Project`	`originatingId`	The internal ID of the source project, if this project was copied from an existing project. `0` if this project was created from blank.
`ProjectMilestone`	`originatingId`	The internal ID of the source project, if this project milestone was copied from an existing project milestone. `0` if this project milestone was created from blank.
`ProjectPhase`	`originatingId`	The internal ID of the source project, if this project phase was copied from an existing project phase. `0` if this project phase was created from blank.
`ProjectTask`	`originatingId`	The internal ID of the source project task, if this project task was copied from an existing project task. `0` if this project task was created from blank.

Object type

Property

Description

Attachment

parentId

The internal ID of the parent attachment. 0 or Null if the attachments has no ancestors (top-level attachment or folder).

Project

discussionMessageCount

The number of messages in the project discussion for the project.

For more information about the Project Discussions feature, see Project Discussions.

Project

originatingId

The internal ID of the source project, if this project was copied from an existing project. 0 if this project was created from blank.

ProjectMilestone

originatingId

The internal ID of the source project, if this project milestone was copied from an existing project milestone. 0 if this project milestone was created from blank.

ProjectPhase

originatingId

The internal ID of the source project, if this project phase was copied from an existing project phase. 0 if this project phase was created from blank.

ProjectTask

originatingId

The internal ID of the source project task, if this project task was copied from an existing project task. 0 if this project task was created from blank.

Changes to XML API and SOAP API

Submit, approve or reject time-off requests (schedule requests) using the XML API or SOAP API.

The Schedulerequest object type now supports commands Submit, Approve, and Reject (XML API) and submit(), approve(), and reject() (SOAP API).

In addition:

The following object properties are now available.

Object type	Property	Description
`Project`	`originating_id`	The internal ID of the source project, if this project was copied from an existing project. `0` if this project was created from blank.
`Projecttask`	`originating_id`	The internal ID of the source project task, if this project task was copied from an existing project task. `0` if this project task was created from blank.

Object type

Property

Description

Project

originating_id

The internal ID of the source project, if this project was copied from an existing project. 0 if this project was created from blank.

Projecttask

originating_id

The internal ID of the source project task, if this project task was copied from an existing project task. 0 if this project task was created from blank.

Adding, modifying, upserting, or deleting a payment using the XML API or SOAP API also updates the associated invoice so that the change is recorded on the invoice history tab in SuiteProjects Pro.