Vendor Purchasing and Catalog Integrating with RepairShopr

vendor_purchasing_guide.md

So you want to get your catalog into RepairShopr or integrate automated ordering?

Last Revision: 2015-08-27, Troy

There are 2 primary ways RepairShopr can work with a Vendor (supplier, distributor, etc).

1. We can maintain a catalog of your available products with SKUs and all the details, and make that available for our users to one-click import.
2. We can tie into your ordering system so our users can one-click to send their Purchase Orders into your ordering system to generate a live order. (Fully Automated re-ordering is coming very soon too)

Product Catalog

For the product catalog integration we just need a feed with all available details, including your retail price (or standard price), and we will facilitate imports at a reasonable frequency and make this catalog available to our users.

Please contact us via the feedback widget on our site to inquire about getting your catalog into RepairShopr, if you have a feed already, please include that.

(eg, the feed you already use for froogle might work, xml is fine)

Electronic Ordering

We will only integrate if there is a ruby library to talk to your ordering endpoint, or it's a simple HTTP endpoint on your end. Most e-commerce systems already have a REST API for ordering - and we are happy to build integrations to those.

If you don't have something already available, here is what we have done in the past:

1. We add the app card and have it generate an authentication token in RepairShopr
2. We ask the user to copy/paste that into their profile on your site
3. When they want to send an order, we will make an HTTP POST to your site with a payload that looks like this:

{
    "email": "customer@theirdomain.com",
    "auth-token": "THE-TOKEN-GOES-HERE",
    "po-number": "F-20150803-1",
      "products": [
        {
            "itemcode": "ABC_YOURSKU",
            "quantity": 1
        } 
    ]
} 

If you can return us a success or fail with errors, we'll get those surfaced to the user.

In the future we'll use the reorder levels to automatically make orders based on some rules.