Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt

This page explains which are the Push and Pull methods supported by ConnectWise connector. Push are the methods where interworks.cloud platform sends information to ConnectWise  and pull are the methods where we get information from ConnectWise . For each method the data transformation schema is explained.


PushPull

CreateUpdateDeleteCreateUpdate
Account


Contact


Invoices




Orders




Products




Payments




Subscriptons





Rw ui textbox macro
typewarning

If you want to push Contacts from BSS to CW platform, the related field under Account > Demographics > Type needs to be filled on contact's account.


Properties Mappings

...

Rw ui expands macro

Rw expand
titleAccount Entity

For BSS Account entities we support both push and pull methods.

Below table presents property mapping between BSS Account entity and ConnectWise Customer entity

Account (BSS entity)Company (ConnectWise entity)

Id

Identifier
NameName

ServerVariables
ImportStatus

Status
Lookup value
Type.IntegrationId
TypeIds
Address.Address1AddressLine1
Address.Address2AddressLine2
Address.CityCity
PreSynchronization
State Code taken from API according to state name
State
Address.PostCodeZip
PreSynchronization
Country ID taken from API according to country name
Country
PhonePhoneNumber
FaxFaxNumber
WebSiteWebSite
Contact.IntegrationIdDefaultContact
ParentAccount.IntegrationIdParentCompany
IntetgrationIdBillToCompany
Currency.IntegrationIdCurrency
CodeAccountNumber


Rw ui textbox macro
typeinfo

Address

  • ConnectWise accepts only one address and due to this restriction, only billing address is used for the synchronization
  • On pull method the ConnectWise address is set automatically as billing Address
  • ConnectWise accepts multiple Type Ids, but only one is stored in BSS. In case of pull, the first of many is saved back to BSS


Rw expand
titleContact Entity

For BSS Contact entities we support only push and pull methods.

Below table presents property mapping between BSS Contact entity and ConnectWise Contact entity

Contact (BSS entity)Account (ConnectWise entity)

FirstName

FirstName
LastNameLastName

Account.IntegrationId

Company
JobTitleTitle

A 4 cell array containing the communication properties that are stored in BSS, Phone/Email/MobilePhone/Fax. In case of Push/Editing, a preSynchronization Action (OriginalData) fetches the Ids of these so that they can be properly matched and edited

CommunicationItems


Rw expand
titleProduct Entity

For BSS Product entities we support only push method.

Below table presents property mapping between BSS Product entity and ConnectWise Product entity

Product (BSS entity)Product (ConnectWise entity)

Id

Identifier
NameDescription
IsActivatedInActiveFlag
LookUp
Unit.Type.Integration
ServerVariable(if above lookup do not exist) ProductSubCategoryId
Sub Category
LookUp
ProductType.IntegrationId
Type
"Service"Product Class
NameCustomer Description
ServerVariable
ProductCategoryId
Category
SalesPricePrice
PurchasePriceCost
ServerVariable
UnitOfMeasure
Unit of measure
isTaxabletaxableFlag


Rw expand
titleInvoice Entity

For BSS Invoice entities we support only push method.

Below table presents property mapping between BSS Invoice entity and ConnectWise Invoice entity

Invoice (BSS entity)Invoice (ConnectWise entity)

LookUp
Type.IntegrationId

Type
LookUp
Stage.IntegrationId
Status
Account.IntegrationIdCompany
BillingAccount.IntegrationIdBill To Company
LookUp
Currency.IntegrationId (Taken from BillingAccount)
Currency
DueDateDueDate
TotalAmountTotal
BalanceBalance


Rw expand
titleInvoice Item Entity

For BSS Invoice item entities we support only push method.

Below table presents property mapping between BSS Invoice entity and ConnectWise Product Item entity

Invoice Item(BSS entity)Product Item (ConnectWise entity)

Product.IntegrationId

Catalog Item
QuantityQuantity
FinalPricePrice
CostPriceCost
ServerVariables
BillableOption
Billable Option
Invoice.IntegrationIdInvoice
IsTaxabletaxableFlag


Rw expand
titleOrder Entity

For BSS Order entities we support only push method.

Below table presents property mapping between BSS Order entity and ConnectWise Invoice entity

Order (BSS entity)Order (ConnectWise entity)

Account.IntegrationId

Company
Contact.IntegrationIdContact
LookUp
Stage.IntegrationId
Status
OrderDateOrderDate
DueDateDueDate
Customer.IntegrationIdBill To Company
LookUp
Currency.IntegrationId (Taken from Customer)
Currency
ServerVariables
SalesRepId
SalesRep


Rw expand
titleOrder Item Entity

For BSS Invoice item entities we support only push method.

Below table presents property mapping between BSS Invoice entity and ConnectWise Product Item entity

Invoice Item(BSS entity)Product Item (ConnectWise entity)

Product.IntegrationId

Catalog Item
Invoice.IntegrationIdCharge to Id
"SalesOrder"Charge to type
QuantityQuantity
FinalPricePrice
CostPriceCost
ServerVariables
BillableOption
Billable Option


Rw expand
titlePayment Entity

For BSS Payments entities we support only push method.

Below table presents property mapping between BSS Payment entity and ConnectWise Invoice payment entity

Payment (BSS entity)Payment (ConnectWise entity)

Payment.Type.Name

Type
Invoice.IntegrationIdInvoice
Payment.AmountAmount
PaymentDate

PaymentDate


Rw ui textbox macro
typewarning

Payments
ConnectWise supports only one payment per invoice. Due to this restriction, when a second payment is sent for a specific invoice, the amount of that payment is added to the amount of the first payment.

Rw expand
titleSubscription Entity

For BSS Subscription entities we support the push method only.

The table below shows the property mapping between the BSS Subscription entity and ConnectWise Addition entity:

Addition (ConnectWise)Subscription (BSS)
Product name*Product name
Total quantity*Quantity
Less Included (is always equal to 0)*
Unit PriceFinal Unit Price
Taxable (is inherited from product)
Effective Date*Start Date
Cancelled DateWhen the status is set to Cancelled
Product Invoice Description (is filled in ConnectWise)
Bill Customer* (is the first available value in the dropdown list)

Subscription Name (custom field)

Subscription Name

Subscription ID (custom field)

Subscription ID

Fields with an asterisk * are required.



...