Connect Etsy to Craftybase
Learn how Craftybase pulls your Etsy data.
This article will guide you through how to connect to Etsy and what types of data we can pull into your Craftybase account.
Etsy is a third-party e-commerce platform that makes it easier for small creators and businesses to expand their reach.
Our Etsy ➝ Craftybase integration allows you to pull your products and orders data into Craftybase so that you can be sure that your inventory levels are always automatically factoring in sales from this source.
In this article:
- How to connect your Etsy shop
- How we pull data from Etsy
- Pulling your Etsy Listings
- Pulling your Etsy orders
- Pulling your Etsy fees
- Pulling your purchases from Etsy
- FAQs
How to connect your Etsy shop
To connect your Etsy store to Craftybase, follow the directions in our help article: Connect your Etsy Shop →
How we pull data from Etsy
Once you have successfully created your connection, data pulls from Etsy will occur automatically each day at 5 a.m. in your local time zone. You can also run a manual data pull, if required, between the daily scheduled data pulls.
Your first data pull will, by default, attempt to download all data from your Account Start Date.
Note: Regardless of the date range selected, Craftybase will pull all listings found on Etsy and create these as products as they are required for linking to past and future orders/fees. If you do not wish to track some of these products, you can archive these and they will be removed from most views and reports.
It is recommended that you always create your products on Etsy where possible and then pull them into Craftybase. This will minimize potential manual structuring and merging down the line.
Pulling your Etsy listings
Listings from Etsy will be pulled as both Products and Listings in Craftybase.
More details on the general rules we apply can be found here: How does Craftybase pull products from my integrated e-commerce integration?
The current status of the listing on Etsy will be used only on the very first pull to set the default status for the product in Craftybase:
| Etsy Status | Craftybase Status |
|---|---|
| active | active |
| inactive | archived |
| sold_out | active |
| draft | draft |
| expired | active |
Note: Product statuses are not updated on subsequent pulls from Etsy. This is because products in Craftybase can be linked to more than one sales channel, so automatically changing statuses on each pull could cause conflicts or overwrite settings.
Product statuses can be changed once imported via the product edit form or your product bulk update options.
It is strongly recommended that listings not be reused for different products on Etsy. Doing so breaches the Etsy TOC and will significantly impact your ability to track this product in Craftybase.
Etsy Variations
As part of pulling your listings, Craftybase will also pull your configured Etsy Listing Variation Properties and will map these against each of your Products. Combinations of these properties are used to create Craftybase Variations.
EXAMPLE: Mary has two listing variation properties called “Size” and “Color” for the listing called “Handmade Dog Collar”. For the “Size” property, there are three options configured: Small, Medium, and Large. For the “Color” property, there are also three options: Red, Green, and Blue.
In Craftybase, there would potentially be 3 × 3 Variations created for this product to represent every combination that can possibly be sold:
Red | Small
Red | Medium
Red | Large
Green | Small
Green | Medium
Green | Large
Blue | Small
Blue | Medium
Blue | Large
Whenever you sell a Listing with configured variation properties on Etsy, the variation selected by the customer is linked to your Order Line Item in Craftybase via the Craftybase Variation.
EXAMPLE: John purchases the Red Large variation of the “Handmade Dog Collar”. In Craftybase, the “Red | Large” variation for the product is created, and the order line item is associated with both the “Handmade Dog Collar” product and the “Red | Large” Variation.
Pulling your Etsy orders
Each sale you make on Etsy will be pulled into Craftybase as an Order. The Etsy Receipt ID will be set as the Order Code for easy reference.
As part of our automatic daily data pulls, we attempt to identify any orders that have been canceled or adjusted on Etsy.
The total tax paid by the customer on the order will be recorded in the Tax summary. Please note that this amount will include both automatically remitted marketplace facilitator tax and/or taxes directly collected by the seller.
Note: as of Oct 21, 2024 Shipping address data will no longer be importable via the Etsy API for new connections in the US, France and Germany.
Etsy Personalization Options
Craftybase will ignore the Etsy Personalization attribute when creating new variation attributes and variations.
We will, however, include this information in the Order Line Item notes so you can include it in your fulfillment process.
Pulling your Etsy fees
Our Etsy importer checks for any valid and available fees in your Etsy Ledger and pulls them according to the help article here: About Imported Etsy Fees.
Please note: not all fees charged by Etsy to sellers are currently available to us via the API.
Pulling your purchases from Etsy
Purchases made via Etsy will not be pulled.
FAQs
How does Craftybase handle different currencies on Etsy?
Craftybase automatically converts your prices when you pull Etsy information in a currency other than the one you have set as your default Craftybase currency. Conversions are calculated based on the European Central Bank's published daily conversion rate for the date the order was created.
Can Craftybase sync stock updates back to Etsy?
Yes! Craftybase now supports pushing stock levels back to Etsy using our Stock Push feature. Your inventory counts can be automatically updated based on your manufacturing or order activity in Craftybase — helping you avoid overselling and keep everything in sync, effortlessly.