Download the PHP package spinen/connectwise-php-client without Composer

SPINEN's ConnectWise PHP Client

PHP client for the RESTful ConnectWise APIs.

We solely use Laravel for our applications, so there are some Laravel specific files that you can use if you are using this client in a Laravel application. We have tried to make sure that you can use the client outside of Laravel, and have some documentation about it below.

Build Status

Branch	Status	Coverage	Code Quality
Develop
Master

Note about the integration

We are using the "Member Impersonation" model where you set up an integrator username & password with access to the "Member API", which makes all calls to ConnectWise performed under the permission of the user (member id) of the application.

We make all of our ConnectWise users' member ID equal to their email (i.e. [email protected] has a member ID of joedoe in ConnectWise) [NOTE: The "." was removed from joe.doe as ConnectWise does not allow periods in the member ID]. By following this convention, we can infer the member ID from the logged in user's email address in our applications. We have included a trait that you can use on the User model that will perform the logic above.

As of 2019.3, they require a clientId when connecting to the API, so you will need to register for one here...

https://developer.connectwise.com/ClientID

Supported Actions

The client supports the standard http verbs plus one extra one...

• delete
• get (ConnectWise default pagination is 25 records, so unless you specify a different pageSize, you will get 25 records)
• getAll (Makes as many needed API calls to get all of the records in the collection. You should be very careful when using this method as your system may run out of memory.)
• head
• put
• post
• patch

Models

The responses are cast into models with the properties cast into the types as defined in the Swagger documentation. You can review the models in the src/Models folder. There is a property named casts on each model that instructs the factory on how to cast the properties from the response. If the casts property is empty, then the properties are not defined in the swagger, so an array is returned.

Relationships

Some of the responses have links to the related resource. If a property has a relationship, you can call it as a method, and the additional calls are automatically made & returned. The value is stored in place of the original data, so once it is loaded it is cached.

There are may also be "related" properties in the "_info" property that you can have the system load for you. [NOTE: This does a getAll for the related properties, so it will make as many API calls as needed to get all of the related items]

Install

Install the ConnectWise PHP Client:

Laravel Configuration and Usage

For >= Laravel 5.5, you are done with the installation

The package uses the auto registration feature of Laravel 5.

For < Laravel 5.5, you have to register the Service Provider

1. Add the provider to

2. [Optional] Add the alias to

Configuration

1. Add the following to ...

2. Add the appropriate values to your ...

3. Use the trait on the User model, which is located at , if your ConnectWise member_id is a match to your email as described above. If you do not follow that convention, then you can define your own accessor on the User model or just add a column to your user table that you populate with the appropriate values.

Usage

Here is an example of getting the system information...

As of version 3.1.0, the response is either a Laravel collection of models or a single model. You can see the models in . They all extend , so you can see the methods that they provide.

Same call using the facade...

Non-Laravel Usage

To use the client outside of Laravel, you just need to new-up the objects...

Supported API Model Versions

You can specify the version of the models you want in 1 of 3 ways...

1. The 4th parameter in the Client constructor
2. Calling the setVersion method on the client object
3. [Laravel only] Setting the version property in the config

The supported versions are:

• 2018.4
• 2018.5
• 2018.6
• 2019.1
• 2019.2
• 2019.3
• 2019.4
• 2019.5 (default)

You can see the differences of the models by looking at the casts property on the individual models in src/Models/<version> directory.