1 | CLIENT MANAGEMENT
1.1 Creating products
At the beginning your Smake System is empty and there are no products. There are several ways to get products into your Smake System. Either you choose from existing system products (button „ + Add"), create the products manually (button „+ Create") or import them via CSV file (button "Import") - here the import is the fastest way to create as many products as possible in the system).
Import via CSV - this is how it works
If you want to create multiple items in your production, you can also do this via CSV import instead of creating each product manually in a time-consuming way.
First you should get all necessary article master data from your supplier or manufacturer to maintain all data properly. Most suppliers have properly maintained lists of their assortment. Almost all the information we need can be copied from these lists.
The A&O is the clean data maintenance - EAN codes are enormously important for the scan at the goods receipt as well as the exact product allocation. But article weights also play a role in shipping.
You can either download the sample import file from the backend (you can find it under Products by clicking on the Import button on the top right) or create your own with the following columns:
|handle||"handle" includes the individual article variants in the system to one main article.Existing Handles
and therefore articles can be overwritten.
(This function is disabled by default, can be
but activate it in the import window.) To add variants
the same handle must be used.
|name||name of article|
|code||EAN, Gtin, UPC, (....)|
|weight||Weight (unit results from the selected unit for system installation)|
|country_of_origin||Country of origin, official two-letter country code|
|cost_price||Purchase price (Please fill without currency symbol)|
|price||Selling price (Please fill without currency symbol)|
|tax_rate||Tax rate (Please enter without percentage sign)|
|image_front_url||Picture path / url for front view / not necessarily to be filled. Images can also be uploaded manually after import.|
|image_back_url||Picture path / url for back view / not necessarily to be filled. Images can also be uploaded manually after import.|
|image_left_url||Picture path / url for left view / not necessarily to be filled.Images can also be uploaded manually after import.|
|image_right_url||Picture path / url for front view / not necessarily to be filled.Images can also be uploaded manually after import.|
|pubilshed||active or not active / use "yes" or "no"|
|locale||specifies the language in which you want to import.
for example: de -> german, en -> english
|is_master||Determines the basic variant of the article / with which variant
the article is displayed first in the overview. Input with
"yes" or "no".if no variant contains a "yes" so determined
the system randomly creates a base variant.
|external identifier||External, unique identifier. Not mandatory. Frequently used
for linking to other systems.
Even if not all columns are filled in, the column header must remain in the import file. Otherwise, the system does not accept the import list and displays an error message.
If everything is filled in carefully, the table is saved as "CSV (separator-separated)".
In the client administration we click on products and then on the button "import" in the upper right corner. Afterwards a mask opens where I can select my import file or drag & drop it in.
When the import is completed, you will receive a mail from the system with information on how many articles could be successfully imported. If some articles have not been imported, you can open the list called "failed entries" from the e-mail attachment and find out why the variants have not been imported successfully.
Article successfully imported - let's go on!
In order to use articles for the Designer or the Smake Shop, they must first be calibrated. If the articles are used for API or the Connector, this is not necessary. When using API and Connector, you can also completely do without using article images. (Attention: This can become confusing if there are many articles in the backend).
This manual only refers to the use of Smake in combination with the Connector and Shopify - therefore we will not explain how to measure and edit the article here.
If your import was successful and you have already set the articles in the import file to "active" you don't have to do anything else here.
1.2 Shop / App
In the client administration we have the item Shops in the menu. All installed Smake Shops are listed under this item. (Important: In the Smake system, Shops can not only be Smake Shops, but also administrations for App, API and Connector)
No shop created yet? So the system works in only 5 minutes:
If you create a new Smake Shop there are a few basic things to consider. So that you don't forget them, you will find specific instructions in the client administration.
Example: The name My Shop now becomes mein-shop.smake.cloud.
Later we can store our own domain via the shopbackend.
IMPORTANT: This setting cannot be changed afterwards!
Standards and Formats
Default settings such as currencies, language and length units are defined here.
IMPORTANT: This settings cannot be changed afterwards!
(Attention: The indication of the weights is not to be seen in the picture, is however compellingly needed for the basic equipment of the system!)
The shipping address and therefore the data of the customer / producer are stored here. This address is used as sender address for the dispatch, as long as the neutral dispatch is not selected. The address can be touched at any time at will.
These listed details can no longer be changed after the shop has been set up
- units of measurement
- Shop open / closed (invited customers only)
Once you have successfully created products and shop, you switch from client management to shop management. The fastest way to get there is to use the button "Sign in" in your shop list. This will take you to the desired shop backend with just one click.
2 | SHOP MANAGEMENT / BACKEND
The shop level is optically similar to the client level - the easiest way to remember the colours for this is to use the colours of the shop. The shop administration is always grey. At the start your backend is still completely empty. Before you get the products you want to use for the desired shop from the client level, you first have to make some basic settings.
Attention: The Smake Shop-Backend has a wide range of functions. Since this manual only refers to the use of Smake with the Connector and Shopify, only the settings necessary for this use are explained here. For information and help on all other functions and settings you can look up in our HelpCenter: https://smake.zendesk.com/hc/en-us
For the pure use of Smake with the Connector and Shopify we need Payment methods, shipping, active products (blank products) and an API token.
2.1. Payment methods
Why payment methods? The payment is made through Shopify...
That's correct! But we need a matching via the connector, because this data is also transferred with the order details from Shopify to the Smake system.
In the menu you will find under configuration the item "payment methods" you will find a list of the active payment methods. Since your shop is new, everything is empty at this point. Therefore you have to create the first one under "manual payment methods".
Adding manual payment methods
Click on the button "Create your own payment method" and you will be forwarded to the next screen. Here it is sufficient to enter the name, e.g. "invoice" and click on save.
In order for you to receive an automated shipping label, the following points must be configured:
2. your shipping service providers are registered with GoShippo
3. the GoShippo Live-Token must be deposited in your shop
4. you need API based shipping
Once you have completed all of these steps, nothing stands in the way of your automated shipping label. In the following steps we will go through the individual points in more detail.
You need a GoShippo account
GoShippo securely connects multiple shipping service providers to your Smake system. With the help of GoShippo you can automatically print out shipping labels.
Depending on the shipping service provider, there is also the possibility to reduce the shipping costs. live at checkout.
Find out how to create your GoShippo account here: Shipping GoShippo
Your shipping service providers are deposited with GoShippo
After you have created your GoShippo account, deposit your required Contract data with GoShippo. For this GoShippo offers a large collection of help contributions: GoShippo HelpCenter
The GoShippo Live-Token must be stored in your shop
In order for the Smake system to connect to your GoShippo account, you must have you only have to leave the live token behind your shop system.
Copy the live token from GoShippo here and go to your shop administration at "Configuration > Shipping" and paste it into the field "Shippo Token" one:
Then click on the "Update" button to save this change. to take over.
You need API based shipping costs
In the last step before your first order with an automated shipping label only one step is missing: You need API based shipping costs in your Shop.
Go to your shop administration and open the shipping settings under "Configuration > Shipping".
After a click on "Add tariff", all the tariffs deposited with GoShippo will be displayed. Shipping types are displayed:
After the shipping costs have been deposited, they can be used for a new order. can be used. At the shipping station, the following are automated as of this moment valid shipping labels are printed.
However, the following still applies: For shipping costs based on weight or order value and previously placed orders, no shipping labels will be printed out.
Important: The costs you can sit here at 0 €. The costs for shipping are transmitted from Shopify.
2.3 Products / target products
To link products from your Shopify store to Smake, you must first create them in your shop backend.
Go to the menu item Products. There you will find the button "Apply" in the upper right corner - visually similar to the client level. Click on it to open your product list. Here you will find all articles that are currently active in your production, can be ordered and produced. Choose your desired product - if you like you can also use the integrated search function - and transfer it to your shop.
You do not want to have all variants of the article in your shop? No problem - "Do not click on the button "add all variants" but click on "select variants" under the article. Here you can choose for example only one colour of the article or certain sizes. As soon as you have selected / clicked on variants, the button "Apply selection" appears. With a click on it the desired variants will be taken over into your shop backend.
Now your article is in the Smake Backend. In the product overview you can see by the red pencil icon that the article is still deactivated.
Open the article by clicking on the "Edit" button. On the right side under Organization you will find the setting "Available from". There the current date and time are set. With a click on "Save" the article becomes active.
Of course there are still many possibilities of editing in the article itself, but these will not be discussed in this manual. Here we explain the easiest and fastest way to use the Connector and Shopify.
2.4 Generate API Token
In the shop backend you will find the menu item API in the menu under "Developers". Here you will find the API endpoint and information about the current version of the API.
Here you can generate your API token which you need for the connection in the connector. With a click on "Create a token" a mask opens and you are asked to enter a name. After clicking on "Create" your token will be displayed.
The token cannot be called up again after closing this mask. Therefore copy it and save it temporarily. Alternatively you can generate the token only when you need it during the connector setup and copy it directly into the connector.
To use the connector, you have to update the API version if this has not already been done. You can do this on the button in the lower area.
3 | CONNECTOR
Setup connector / set up connection between Smake and Shopify
You can find the connector under the following URL: https://smake.ideashirt.pl/connect/login
If you do not have an account yet, you can register here in no time at all.
After successful registration and login, you will land in your "Dashboard". Since you have not yet connected a shop, you will see the button "Configure my store" here - click on it to open a mask.
Here you can now choose which shop system you want to connect. Currently you can choose between Mangento 2.0, Shopify and Shopware. In our case, we now choose Shopify.
If you have selected Shopify, the data of your shop will be requested. Here you also need the API Key of your Shopify Shop.
3.1 API Key from Shopify
Log in to your Shopify account and select "Apps" from the menu. Below the app listing - at the very bottom of the page - you will find the link "Manage Private Apps".
Now click on the button "Create private app".
Here you have to enter a name for the app and an e-mail address. In the field below please select "Products, Variants and Collections" and change the setting to "Read and Write: off".
Now click on the "Save" button. A window will open with a short query. Confirm it by clicking on "I understand, create the app" and your app will be created.
Then you will see the data you need for the connector. You can easily copy them.
Now insert the data in the connector correctly and click on "Connect Shopify Store". You will automatically be taken to the dashboard and will see your Shopify Store listed there.
After the connector is connected to Shopify, you have to connect Smake to the connector. For this you need the API-Point and the API Key from your Smake Backend, as already described. These you have to insert in the connector.
Click on "Settings" in the Connector and enter the data at "Smake API".
If everything was entered correctly and properly, Smake is now connected to your Shopify Shop. The green label "connected" appears
3.2 Connect Shopify products with Smake products
If you already have an existing Shopify shop, you will also have created products there. If you have opened a new store you will find https://help.shopify.com/de/manual/products/add-update-products
a help on how to create Shopify products.
In the connector you will find your connected Shopify shop. Select this shop to manage your products.
After clicking on the store you have the possibility to link your products via "Automatic Color Matching". You can predefine colors in the "automatic color matching" area. For example, in your shop the color is always "blackest black" in Smake but only "black":
Choose the button "Connect products" under the area "Store Products" to load your products from Shopify into the connector.
Here you will find your products. In the list you will see a mark whether the product is already connected or not. Since you have just started to set up the connector, you will see the label "not connected" on your products. Click on "Details" on the right side and your Shopify product will open.
Linking products - this is how it works
In the upper right area you will find the button "Connect to Smake", click on it and a new mask will open. Under "Assign Smake product" you can choose the appropriate Smake product.
Click on the button "Add view" and specify in the field below which areas are to be printed. There you can also upload the print file and a general mockup for the production. Click on "Save and Stay" to save.
Afterwards you can upload different print files and mockups for different variants such as sizes and colors under "Add variant files". So that for each color and size the appropriate file is available.¬¬¬ Click on the small arrow on the right side and select the desired variants. Then you can upload the print file and the mockup. After that you just click on "Update" or "Save and stay".
Now you see that your product is linked. It can now be ordered via Shopify.
If there are already orders via Shopify, you can see them under your shop on the right side under "Store orders". Click on the button "Synchronize orders now" and your orders will be transferred to the Smake system. Now you can find the orders with all the corresponding files1n in your shop backend and can be produced normally.
We wish you much fun with Smake & the Connector to Shopify. :-)