Can I integrate a custom shopping cart?

Introduction

Connex allows third parties to build a custom store integration. Our site will ping a page on your website.

How do users authenticate to my application?

At our my connections page, chosoe custom store. You will see a form with a user name, password, and URL fields. The user name and password will be sent to your website using basic authentication. Our tool will try to access /authenticatetowebservice. During our pairing process, you are asked for the URL of your API. It could be https://www.mysite.com/api/v1. If it was successful, return OK. Otherwise, return an error message. It could say user name and password is incorrect.

How should I build my API?

Here is a spec. The spec lists the parameters and how our fields map.

Does the sync run automatically?

After the sync has completed, Connex updates the sync timers to an hour ago and tomorrow. The timers use UTC format. The timers are located under the transaction tab of our configure page. If you want recent orders, then let Connex run hourly.

How should the data appear?

Our software created an intermediary called JMAUser, which is translated into QuickBooks XML. Here is how our data appears

What URL does your site use to sync orders?

Our tool is looking for an endpoint called orders. If your API is located at https://www.mysite.com/api/v1, our site would check https://www.mysite.com/api/v1/orders. Our site uses GET to add parameters.

How do I sync updates to orders?

Login to Connex. Click configure. Click the second tab. In the order status field, enter a comma separated list of order statuses. Our software will add the date_modified_min and date_modified_max to your URL:

https://www.mysite.com/api/v1/orders?date_modified_min=2009-11-13T10:39:35Z&date_modified_max=2009-12-13T10:39:35Z&orderStatus=shipped

How do I sync orders from a certain store?

Login to Connex. Click configure. Click the second tab. In the order store field, enter a comma separated list of stores. Our software will add the date_modified_min and date_modified_max to your URL:

https://www.mysite.com/api/v1/orders?date_modified_min=2009-11-13T10:39:35Z&date_modified_max=2009-12-13T10:39:35Z&storeName=Amazon

Do I need to add payments to the JMAUser object?

If you sync sales receipts or sales orders, then the software assumes the orders are paid. If you are syncing invoices, you must include the JMAPayment object. Here are the required fields:

  • PaymentAmount
  • CreditCardName
  • PaymentDate
  • ReferenceNumber (can be the order number, usually comes from the payment processor)

Populate the JMAOrder object order number field only. An order can include multiple payments. One payment could be for $100 paid by cash. Another payment could be $50 by credit card.\

Here is how your JMAPayment should appear:

{
"Payments": [
{
"CreditCardName": "Visa",
"Id": 100114,
"PaymentAmount": 18.75,
"PaymentDate": "/Date(1494338312000)/",
"ReferenceNumber": "R1062",
"Order": [
{
"OrderNumber:"R1062"
]
"ModifiedDate": "/Date(1494338312000)/"
}
]
}

Can you sync inventory updates from QB to my site?

Please contact us about building this feature.

Can you sync purchase orders from my website to QB?

Please contact us.

Have more questions? Submit a request
Powered by Zendesk