Setting Up DEAR Systems

Integration Specs:

Additional Fee

DEAR charges an additional $50 per month per connection.

Step-by-step guide

  1. To find your Account ID and API Key login to Dear Systems and click Integration > DEAR API Setup
  2. Click + next to Overview in the upper left to add a New API Application. Enter a name like CartRover
  3. Copy down the Account ID and Key which will be entered into CartRover
  4. Click Save


You can come back to this page any time to look up your existing credentials or reset them if needed.

Dear Sale Status List

StatusDescription

DRAFT

No data is added to sale details. Quote and order are empty and not authorised

VOIDED

Task has been voided

ESTIMATING

QuoteStatus = DRAFT, OrderStatus = NOT AVAILABLE

ESTIMATED

QuoteStatus = AUTHORISED or Skip Quote=true, OrderStatus = NOT AVAILABLE

ORDERING

OrderStatus = DRAFT

ORDERED

OrderStatus = AUTHORISED, all products in sale order are in stock, no backordering.

PickStatus = NOT AVAILABLE

BACKORDERED


OrderStatus = AUTHORISED, at least one product in sale order has been backordered

PickStatus = NOT AVAILABLE

PICKING

PickStatus = DRAFT

PICKED

PickStatus = AUTHORISED, PackStatus = NOT AVAILABLE

PACKING

PackStatus = DRAFT

PACKED

PackStatus = AUTHORISED, ShipStatus = NOT AVAILABLE

SHIPPING

ShipStatus = DRAFT

INVOICING

OrderStatus=AUTHORISED, ShipStatus=AUTHORISED, InvoiceStatus=DRAFT

INVOICED

ShipStatus=AUTHORISED, InvoiceStatus = AUTHORISED or InvoiceStatus = PAID, TotalInvoice – TotalPaid <> 0

CREDITED

CreditNoteStatus = AUTHORISED, TotalInvoice – TotalPaid <> 0

COMPLETED

InvoiceStatus = PAID, ShipStatus=AUTHORISED, TotalInvoice – TotalPaid = 0

Address Issues

A very common issue is that the Addresses Dear sends to CartRover don't match what is displayed on the screen in Dear. This is caused by editing the address in Dear by just overwriting the address field on the order. DO NOT DO THIS! Be sure to add the corrected address to the system and use the new address with the order as it is the only way CartRover can get the corrected address information.


General Integration Guidelines

Unable to render {include} The included page could not be found.