Etsy Integration Instructions

Introduction

This document is targeted for customers who have selected Etsy as their shopping cart option and outlines the steps necessary to allow EFS to collect order data from Etsy and insert it into our fulfillment system.

EFS will pull all orders from Etsy that are in a status of PAID and not SHIPPED and create matching orders in the EFS Fulfillment Control Panel (FCP). After the order ships, tracking information will be sent to Etsy and the order marked as shipped. 

 

Requirements


The eFulfillment Service APP is no longer available in the Etsy Marketplace.
However, you can reach the setup app via the following link.

https://connect.efulfillmentservice.com/etsy

This app should be used to facilitate the setup of your integration between eFulfillment Service and your Etsy store.

Before proceeding with the installation of the eFulfillment APP and setup of your integration there is a bit of information you will need to collect from your Etsy account.

1) Your Etsy shop name
2) Your Etsy User ID


You can find your Etsy shop name in the Sales Channel section of the Shop Manager sidebar.
Screen_Shot_2018-04-30_at_10.36.13_AM.png

 

USERID

Your Etsy User Id requires a couple of steps as Etsy doesn't just show you your User Id number it is 'hidden' in the URL of your site. From the top right You menu, on your Etsy site, select View Profile. 



Then, on your profile page, right click the page and choose "View Page Source" (Chrome) or "Show Page Source" (Safari).  This will open the page inspection tool in your browser (other browsers may have slightly different wording for the tool, but the results should be similar).

Once the inspector is open, you should be able to see the "data-user-id" followed by a number. This number is your User Id.

Note:  The number shown in the following image will not be your user-id.  You will need to gather your own as described above.
EtsyUserId2.png


Here is a zoomed in version of the above image.

Etsyuseridzoom.png_2018-10-23_11-05-36.png


Now, find the APP in the Etsy Marketplace and select it to add it to your store.

EtsyApp_inAppGallery.png


On the next page that opens, choose Visit Website to be taken to the eFulfillment Service website to continue setting up the connection between EFS and Etsy.

EtsyApp_Gallery_02.png

 

You will see a brief popup concerning the fact that you are temporarily leaving the Etsy site and going to our connection page.  Select Go To Site from this popup.

EtsyApp_Gallery_03.png


On the eFulfillment Connect page you will need to select the Connect button.
EtsyConnect_01.png


On the next screen you will enter your login credentials for the eFulfillment Control Panel.

EtsyConnect_03.png


This final step is the most involved, and will require you have a bit of information from your Etsy account on hand.

EtsyConnect_04.png

Once you have filled in this information and selected Finish Setup.  You can follow the link on the resulting page to view your new Integration.

Screen_Shot_2018-04-30_at_10.41.59_AM.png

Your integration between Etsy and eFulfillment is now created.

You will likely want to create your Shipping Method Mappings at this point. (See Below)
 

 

Shipment & Tracking Updates

There is an approximately 4 hour delay from the time we ship an order until we send tracking numbers back to Etsy.

Shipping Methods

When we retrieve your orders from Etsy the shipping methods are shown as strings of text such as “United States” or “Everywhere” or “USPS First Class Mail”. This text needs to be translated to our internal codes by setting up mappings within the integration configuration. Each listing in Etsy shows what ship methods are valid for that listing as shown below.

It will look like this is if you are using standard shipping per destination country:

Note: In the above example Etsy will send standard shipping regardless of the countries you have listed. So you will want to enter DOMESTIC or INTERNATIONAL in the "Cart Shipping Method" field when setting it up.

If you are using "calculated shipping profile" option then your listing will look like this:

Note: With these ship methods copy and paste the text EXACTLY how it is listed above into the "Cart Shipping Method" field.

From your Fulfillment Control Panel account choose View Integrations from the Integration menu and then click the “envelope” icon to view existing shipping mappings.

envelopeicon.png

Carefully type or “copy and paste” the exact text of your shipping method options from Etsy into the Cart Shipping Method field, then choose from the list of available shipping methods. Next, click the “Add Mapping” button, and then click the link in the success message to refresh the list (you will need to do this before you can add another method). Repeat this until all of your cart ship methods are mapped to our internal codes.

shippingmethodmaps.png

 

Optional Features

We also have a feature which will synchronize the available inventory counts from our warehouse back to your Etsy store. This is useful if you don't want to sell products that are out of stock. If you are interested in this feature you will need to abide by the the limitation mentioned earlier in this article and have a separate listing for each variation (color / size) of an item. 

If you are interested in this feature more information on Inventory Syncing can be found in our standalone guide located here.

Have more questions? Submit a request

6 Comments

  • 1
    Avatar
    Ebele Okocha

    For anyone who had a struggle like I did locating the shop/user ID number, I found this very helpful tool. Just paste your shop name and it auto generates shop ID number. 

    https://app.cartrover.com/get_etsy_shop_id.php

  • 0
    Avatar
    Stephen - Main Contact

    I can't find "contact" under the new etsy profile,  Where is that located?

  • 0
    Avatar
    Dev Team

    Stephen, 

    You should be able to find the steps to retrieve your User ID in the instructions above, beginning directly after the first image.

    Could you elaborate on your question about international orders?

    On that note, it may be simpler to address your questions in a ticket to ensure alacrity in response.

  • 0
    Avatar
    Stephen - Main Contact

    Thanks Ebele that really helped.

    Have you noticed that when Esty and EFS integrate that a new order # not in our Etsy receipts is generated?

    Also I have found it will not integrate international orders.

    Would be interested in your experiences with Etsy integration.

  • 0
    Avatar
    Stephen - Main Contact

    I searched everywhere.  I cannot find the user Id.  can you help?

  • 0
    Avatar
    Stephen - Main Contact

    Question 1:  where do you find the User Id:

    Question 2:  how to handle international orders?

Please sign in to leave a comment.
Powered by Zendesk