Documentation

The Bitter Shop System is a powerful and, most of all, expandable shop system which builds opon the core of concrete5. In this documentation you will learn about the concepts and how you can maintain, extend and adapt the system.

Table of Contents

Requirements

The Bitter Shop System has only two requirements:

  1. At least you need concrete5 version 8.0. Older versions are not supported.

  2. Your active theme must be Bootstrap-based.

Suggested Add-ons

PDF Designer

If you want PDF order confirmations to be automatically generated as email attachments, you need to download and install the PDF Designer extension from the Marketplace. The Bitter Shop System was designed for seamless integration. We guarantee!

Bitter Theme

If you do not have a theme yet, feel free to take a look at the Bitter Theme. It also includes many customizations in order to enable a seamless integration of the Bitter Shop System.

Structure and basic concepts

All data from the Shop System such as items or orders are stored in concrete5 express data objects. It is not the only advantage that a powerful data-managing back-end is already integrated in concrete5. The main advantage is that the models can be expanded as desired. This is especially useful if you, for example, want to add new attributes to your products, such as size, weight or other helpful attributes.

The user management system also relies on the existing concrete5 user management system. You will learn about that later in the documentation.

Caution: Reinstalling the Bitter Shop System can restore changed express data objects and user attributes added by the installation to its original state. You should therefore create a backup prior to your reinstallation. Updates are not affected by this issue.

General settings

You can define all basic settings of your shop in the general settings. The basic settings include:

  • Information on the currency and formatting of the prices
  • Saving of tax information
  • Saving of PDF files for document creation
  • Payment Methods
  • Shipping Costs
  • Number ranges

By the way: The Bitter Shop System is a steadily growing project. Benefit from the system updates and keep an eye on the concrete5 marketplace for extensions that build upon the shop system. There are many enhancements planned, such as the implementation of new payment methods, import and export interfaces to other portals and more.

Number ranges

The "Bitter Shop System" has an innovative ability to manage number ranges. A number range is a counter number that is incremented each time it is needed, e.g. whenever an order is generated a new order number is requested.

A number range can be formatted as desired and contains placeholders such as year, month, counter number etc. Number ranges can also be changed in the general settings under the tab "number ranges".

Enter tax information

Most countries are taxable. In order to be able to use the Bitter Shop System in every country, you have the possibility to define a tax rate and the name of the tax in the dashboard page "Settings > Tax Rates". The tax rate is global and will be applied to all items.

Enabling the Advanced Tax Model

The Bitter Shop System has two different models for calculating taxes. The simple model which consists only of the tax rate and the name of the tax and the Advanced Tax Model.

If you want to use regionally different tax rates, you have to enable the Advanced Tax Model. The tax rate will be calculated based on the shipping address of the customer. And this is how you can activate the advanced tax model:

  1. Go to the settings of the Bitter Shop System
  2. In the "Use Advanced Tax Model" dropdown, select "Yes" and click Save.
  3. Now go to the Dashboard page "Bitter Shop System Tax Rates" and click on the button "Add Tax Rate"
  4. Fill out the form and click Save.
  5. Repeat steps 3 and 4 as often as you like until you have entered all required tax rates.
  6. Once you have created all tax rates, click on the "General" tab and select a standard tax rate and click on save again.

Address formatting

In the settings you can edit the address formatting. You can use the following placehodlers:

  • company
  • title
  • firstname
  • lastname
  • address (fo the full address)
  • address1
  • address2
  • postalCode
  • city
  • state
  • country

Currency formatting

Dollar, Euro or maybe Yeng? Each currency has its own characteristic features. Some have the currency symbol on the left side, others on the right side. Some use a dot as a separator, others a comma. With the Bitter Shop System you have the possibility to define a currency. The currency formatting settings are applied everywhere in the shop where a price is visible.

Shipping Costs

The administration of the shipping costs in the Bitter Shop System is similar to the tax model. You can activate the simple mode and simply enter a global value for shipping costs.

But you can also enable the "Advanced Shipping Cost model" and set up individual shipping costs for different states / countries & postal codes. Follow these steps to set up the Advanced Mode:

  1. Go into the settings of the Bitter Shop System
    1. Select Yes in the "Use Advanced Shipping Cost Model" drop-down and click the save-button in the bottom-right corner.
  2. Now go to the dashboard page "Bitter Shop System > Shipping Costs" and click on the button "Add Shipping Cost"
  3. Fill out the form and confirm by clicking the "save"-button.
  4. Repeat step 3 and 4 for all the individual shipping costs you want to define.
  5. Now go back to the tab "General" and select the default shipping costs. This rate always applies if no individual shipping could be determined by the customers shipping address.

Furthermore, you have the option to activate free shipping for both options of a certain value. Simply enter the minimum order value from which the delivery costs are for free.

Important note: Depending on the the setting "Display Prices in Admin mode" you have to enter the prices including or excluding tax.

Configure the email service

It is important that you have enabled the email service on your page. The email service is required to send order confirmations.

To configure the email service go to the dashboard page "System & Settings > Email > SMTP Method" and enter (if necessary) the access data of your SMTP server.

If you want to change the email sender address you can take a look here.

Multilingual setup

Since version 1.0.5 the Bitter Shop System supports multilingualism. This means that you can link products to countries. If the multilingual mode is activated, only the products for the respective country are displayed. In addition, you can declare separate currencies, taxes and shipping costs for each country.

To activate the multilingual mode, proceed as follows:

  1. Create different languages ​​in concrete5. You can do this from the Multilingual Setup dashboard page.
  2. Copy the page tree for all target languages ​​on the dashboard page "Multilingual Setup" so that the required pages of the shop system are available in the target languages.
  3. Go to the settings of the Bitter Shop systems.
  4. Activate the field "Multi Language Mode" and click save.
  5. Now define the individual currencies for each country in the Currencies section.
  6. Navigate to the Tax Dashboard page and define each tax rate for each country.
  7. Navigate to the shipping cost dashboard page and define the individual shipping costs for each country.
  8. Now edit the individual products. Adjust the prices and select the country to display the product.
  9. Repeat the process for all products.

Special thanks to the concrete5 member NUL76 who has financially supported the development of this feature.

Payment Methods

The Bitter Shop System comes with three payment providers. In this section, you will learn how to configure the payment providers.

Important Note: For almost all payment providers, it is important that you use canonical URLs. If this option is not activated, concrete5 will only generate relative URLs. The forwarding from the payment provider back to the shop can not take place. Please activate canonical URLs if you want to use another payment provider as "Bank Transfer". In addition, the URL of the shop must be accessible in most cases from outside. Therefore, localhost is not accepted. Use a server, a hoster or a DynDNS provider to use and configure the payment providers. To enable canonical URLs please go to the dasboard page "System & Settings > SEO & Statistics > URLs and Redirection"

Bank transfer

This is the default payment method and needs no configuration.

Authorize.Net

Authorize.Net is a established payment provider for credit card payments in the USA.

Login to your Authorize.Net account.

Copy the values ​​of the fields "Api Login ID" and "Transaction Key" and "Key" and paste them onto the configuration page of the Bitter Shop System under the tab "Payment Methods", section "Authorize.Net" and confirm with save.

Congratulations. You are now able to make payments through Authorize.Net.

PayPal

PayPal is the largest payment provider worldwide, along with credit card payments.

Prerequisites: Please note that your server / hosting environment must fulfil certain requirements in order to accept PayPal payments. PayPal complies with the requirements of the Payment Card Industry (PCI) Committee. For you, this means that your server needs TLS 1.2. In addition, HTTP / 1.1 is required for all connections. This applies both to the test environment of PayPal (sandbox) and to the production environment.

To use the PayPal interface you need to create a PayPal Developer account. Go to: https://developer.paypal.com/

Once you have registered, click on "My Apps & Credentials" on the left sidebar. Scroll down to the "REST API apps" section and create a new app by clicking on the "Create App"-button.

On the following page, enter a name for the app and submit the form by clicking on the "Create App"-button.

On the following pages your required configuration data will be displayed.

Copy the values ​​of the fields "Client ID" and "Secret" and paste them onto the configuration page of the Bitter Shop System under the tab "Payment Methods", section "PayPal" and confirm with save.

Congratulations. You are now able to make payments through PayPal.

Online Bank Transfer

About Klarna Group

Klarna is one of Europe’s leading payment providers and a newly-licensed bank, which wants to revolutionise the payment experience for shoppers and merchants alike. Founded in Stockholm, Sweden, in 2005, Klarna gives online consumers the option to pay now, pay later or over time ‒ offering a simple, safe and smoooth checkout experience. In 2014 Klarna joined forces with Sofort and formed Klarna Group. Klarna now works with 70,000 merchants to offer solutions to more than 60 million of users in Europe and North America. Klarna has 1,700 employees and is active in 18 countries."

Attractive

  • Cost savings through low fees
  • Credited funds are irreversible
  • Low default risk
  • Low storage costs thanks to short processing times

Easy

  • Automated and transparent processes
  • Easy integration thanks to more than 100 plug-ins for standardized shop systems as well as an efficient API for individual shop systems
  • Convenient for your customers as they can use their online banking details
  • No eWallet and thus no registration required for your customers

Fast

  • Funds are transferred directly from customer’s online banking account to your bank account
  • Real-time transaction notification after the transfer has been listed
  • All within one process - faster than advanced payment (by bank transfer)
  • Fast cash flow, high liquidity

Secure

  • Data is transferred in an encrypted form via secured connections
  • Payment system certified by TÜV Saarland with a certified data protection (TÜV Saarland is a German, state-approved monitoring body for the inspection and maintenance of security standards)
  • Data processing centre in Germany in accordance with strict banking standards

To use the payment service provider in the Bitter Shop System, you need a merchant account, which you can create under www.sofort.com.

A merchant account is associated with fees. After you have registered you must navigate to the menu item "Product activation". Activate the product "SOFORT - The TÜV Certified Direct Transfer Method. ".

After you have activated the product and have submitted your documents for verification, copy the configuration key from www.sofort.com and add the key on the configuration page of the Bitter Shop System under the tab " Payment Methods ", section" Online Bank Transfer" and confirm with save.

Congratulations. You are now able to accept payments via Online Bank Transfer.

Mollie / Credit Cards

Credit cards are accepted in more then 210 countries. Thus, credit card payment is still the most common payment method worldwide.

As the default payment provider for credit card payments Mollie is integrated in the the Bitter Shop System. The configuration is very easy. All you have to do is insert the API key in the settings. Mollie offers support for VISA, Mastercard and American Express.

Express data objects

All further information (except the customer data) is stored in concrete5 express data objects and must be managed via the interface of concrete5. If you are not familiar with the topic, consult the concrete5 documentation to learn more about express data objects and how to handle them

Insert/Update Products

In the dashboard, go to the "Express" page and click on the "Product" entry. This opens up a list view with all items already entered items. There you have the opportunity to insert new products, view existing products, edit and remove them.

To add a new product, click on the link "New Product" at the top of the search box. Fill out the form and confirm with "Add Product".

It is important that you complete the required information. These are:

  • Name
  • Short Description
  • Price
  • SKU
  • Quantity

If you do not have a quantity limit you can simply enter a high value such as 9999. You need to do this because the shop system decrements the value after every order.

You also have the possibility to add up to 8 product photos, as well as one main photo and a long description.

Important note: Depending on the the setting "Display Prices in Admin mode" you have to enter the prices including or excluding tax.

You also have the option to extend the product object with custom attributes.

Editing prices

You have the possibility to enter all prices including taxes or excluding taxes. This depends on the "Use Display Prices in Admin Mode" setting from The Bitter Shop System Settings page.

Complex price types

Since version 0.9.7.0, the Bitter Shop System supports complex price types. This means that in addition to the simple price input field it is now possible to define product variations or a price matrix.

Complex price types - Price variations

For most products it is elementary to define variations. For example If you want to sell a T-Shirt which is available in different colors and sizes. With the Bitter Shop System it is possible to create any kind of variations. To create a price variation, edit an product and click on "Change price type" below the price input field. In the upcoming popup, select the Price Variation type and click Save. Another dialog will be open up in where you can define the options and values.

The option name would be e.g. "Color" or "Size". For the option values, you can enter comma-separated options, such as the sizes. As soon as you press Save, a price input table will be generated for you. You can now enter a price for each combination of options.

If you do not enter a price, it also means that the item is not available in the combination.

Complex price types - Price matrix

To create a price matrix, edit an product and click on "Change price type" below the price input field. In the popup, select the Pricing Matrix type and click on Save. This open up another dialog where you can define the matrix.

You can decide if you want to use only one or two coordinates. For each coordinate, you can specify a name (e.g. width or height), a unit of measure (e.g. cm or m), and a start and end value and also a step size. As soon as you press Save, the matrix is drawn. You can now enter the prices.

If you do not enter a price this also means that the item is not available in the dimensions.

Add attributes to products

You can extend products with custom attributes. The special feature is that the products are automatically displayed in the front-end under the "Additional information" tab.

To expand an express object go to the dashboard page "System & Settings > Express > Data Objects". Click on the entry "Product" on the following page.

Then click on "Attributes" in the sidebar on the left. Scroll down to the "Add Attributes" section and click on the "Choose Type" box. Now select what you want to add for a data type. In most cases, the field text is completely sufficient.

In this how-to we add a field called "Weight". So we choose the "text" type. On the following page all relevant information must now be made to define the new field. The required information is "Handle", as well as the name. Enter the name in lowercase in the "Handle" field.

Naming Tips for the Handle Field: Never use spaces or special characters. Instead of spaces, you can use a underline char.

Enter the name, as it should also be displayed in the front-end and back-end. In our example so "weight".

As soon as all information is given, click on the button "Add" in the lower-right corner.

Now, you have to add the new field to the edit form, in order to be able to use the new attribute in your products. To do this, click on "Forms" on the left sidebar and. Then, click on the new page on the entry "Form". Next to the gray area called "Basics", click on the plus icon. This will open up a pop-up. Click on the tab "Attributes". There, select the newly added entry named "Weight". That's it. You are now able to assign a weight to all of your products and the best thing about it is that this value, as well as all other manually added attributes, are automatically displayed in the front-end.

You can repeat this step as many times as you like for any attribute you want to add. The procedure is always the same.

Customization of the product detail page + the product overview page

If you are not satisfied with the visualisation or if you would like to customize the complete layout and / or structure of the product detail page or the product overview page, you can do so by creating custom templates. Both pages initially contain only modified versions of the concrete5 Express core block elements. You can use the custom template of the Bitter Shop System as your template boilerplate. Feel free to modify it, and turn it into your own custom template. Thus, you have the ability to completely influence the layout and even the structure of the pages with just a few code lines.

The user management system

Each shop system requests customer data for the order, as well as the Bitter Shop system. In order to seamlessly integrate the shop system extension into concrete5, the concrete5's user system is used. This means that every customer, who wants to order something through your shop, must create a concrete5 user account.

We did not reinvent the wheel intentionally and did not create a separate second user system. This is a significant advantage for you because you can use all enhancements of the marketplace for the shop system - such as a social login or CSV import / export of customer data via the dashboard. Benefit from numerous enhancements of the community! Furthermore, all user accounts are located in one place and can be managed via the existing back-end of concrete5!

However, this option of connectivity also has a slight visual disadvantage: it requires a little bit of know-how to adapt the design of the login and register pages. What you need to do in order to customize the design of the pages is explained below. However, the advantages by far outweigh the little disadvantage and this is why we opted for this solution.

The shop system installation routine adds all the necessary advanced user attributes which are needed to store the customer data. In addition, the option of "public registration" for your website is automatically activated during installation. This is necessary so that customers can register themselves on their site when completing the order!

In order that the system works properly, it is important that you:

  • Have enabled the possibility of public registrations on your page.
  • Remove the unnecessary user attributes that the installer added.

If you have accidentally deleted a user’s attribute used by the shop system, this is most unfortunate, but not the end of the world. Contact me for assistance.

* Add user attributes *

If you need additional information from your customers that needs to be provided at the checkout, you can do this by adding custom user attributes:

  1. Go to the dashboard page "Members > Attributes"
  2. Scroll down to the bottom of the page and click on the drop-down "Choose Type" under the "Add Attribute" section
  3. Select an appropriate data type
  4. Fill in all required fields and select the value "Bitter Shop System User Attributes" for the dropdown "Set".
  5. Activate the checkboxes "Editable in Profile" and if you want to make it required "Editable and Required in Profile." too
  6. Click on the "Add" button at the bottom right

Congratulations The new attribute will now be displayed in the checkout.

Design adjustments of login + register pages

Since the concrete5 user system is used, its login and register pages are also used. If you want to change the design of the pages, you have the option to define custom themes for the system pages Login + Register in the application configuration file under "applications/config/app.php". Open the file in a code editor and add the following section to the return array:

'theme_paths' => [ '/register' => 'your_theme_handle', '/login' => 'your_theme_handle' ] 

Replace "your_theme_handle" with the handle of your theme and then save. You should also deactivate the caches during development to avoid conflicts. You then have the option of using the CSS file of the specified theme to customize the design of the pages, if you do not want to use the standard pages of concrete5.

Don’t feel like programming?

If you prefer, you can also purchase a theme that already has its own login and register page, such as: the Bitter Theme. The Bitter Theme also contains further optimizations for an ideal connection of the "Bitter Shop System" and is therefore highly recommended if you want to create a nice online shop without any programming.

Coupons

To create coupons go to the dashboard page "Bitter Shop System> Coupons". Click on "Add" above and fill out the form. You have the option of the coupon code:

  • Limit the validity (From - To)
  • Limit the quantity
  • Set the minimum order value
  • Exclude discounted products from the calculation
  • Set a coupon value in percent or as a amount.
  • With percentage coupons you also have the opportunity to define a maximum coupon value

Limit delivery area

If you only want to deliver only certain countries and customize the shop settings that only deliverable countries are displayed, you can do so by editing the user attribute "Shipping Address". To do this, follow these steps:

  1. Go to the "Members > Attributes" dashboard page
  2. Click on the entry "Shipping Address"
  3. Under the "Address Options" section, you can change the countries.
  4. Click save.

Tip: You can limit the billing address as well.

PDF Designer Integration

If you want to generate beautiful PDF order confirmations, you need the PDF Designer. If you have already installed the PDF Designer before you have installed the shop system everything works fine. If you have first installed the shop system and installed the PDF Designer extension after, you must do the following steps:

  1. Go to the "PDF Designer" dashboard page.
  2. Click on the "Import Templates" button at the top.
  3. Upload the standard order confirmation template from the shop system. (You will find the file under "packages/bitter_shop_system/files/GermanInvoice.pdt")
  4. Then go into the settings of the Bitter Shop System and select the new template there and click on save.

Change the language of the Frontend

To change the frontend, it is very important to have localized language files in the target language! The package already contains a German translation.

In this section is shown how to change the frontend in German. However, the procedure is the same for each language.

  1. Go to the Dashboard page "System & Settings > Multilingual > Multilingual Setup".
  2. Click on the "Add Locale" button at the top of the page.
  3. At the first drop-down box, choose "German", in the second dropdown choose "German". Select the Pagetemplate "Full" and enter "/" as URL Slug. Confirm by clicking on the save button.
  4. Under the Settings section of Default Locale select "German (de_DE)" in the drop-down menu and click on "Save Settings"
  5. Now install the shop system.

Programmatically add products to the shopping cart

For some web applications, the presentation of products with a simple overview and detail page is not enough. For example, if the products have complex structures or if the products are very individual. Thanks to the Bitter Shop System, you can still benefit from the Shop System and make use of the checkout functionality. Thus, you save a lot of development effort and also benefit from other shop extensions such as additional payment providers. In order to add an product to the shopping cart that is not available in the Bitter Shop System backend, you have to include the following code in your web application:

\Bitter\ShopSystem\ShoppingCart::getInstance()->addManualEntry($entryId, $name, $quantity, $unitPrice, $shortDescription); 

After having programmatically added the products to the shopping cart, you can forward the user to the shopping cart. You can do this by following command:

\Concrete\Core\Routing\Redirect::to("/shop/shopping_cart")->send(); 

Events

Placed Order

If you want you can setup event listens to your custom application to get notified when a new order is placed.

Events::addListener("bitter_shop_system_order_placed", function($orderEvent) { $orderNumber = $orderEvent->getOrderNumber(); }); 

Payment Received

With PayPal + Online Bank Transfer, the payment status will be automatically updated as soon as the payment has been approved. The "bittershopsystempaymentreceived" event will automtically triggered. This event is very helpful especially for digital products.

For the payment method "Bank Transfer" this event will be also triggered when the shop owner is manually changing the status in the backend to "Payment Received".

Events::addListener("bitter_shop_system_on_payment_received", function($orderEvent) { $orderNumber = $orderEvent->getOrderNumber(); }); 

Conversion Tracking

To enable Google Conversion Tracking you have to login into your AdWords Account and create a new Conversion. When the Code snippet is generatedyou have to copy the id number from the generated code and paste it into the field "Google Conversion Tracking Id" of the bitter shop settings. All other required values like price and currency will be dynamically inserted from the Shop System on the order success page. Caution: Your AdWords + Analytics accounts have to be associated and you need to embed Google Analytics Tracking Code into the site.

Google Sitemap Generation

concrete5 has the option to generate Google Sitemaps already implemented in the core. However, the product detail page is a dynamic page that can not be tracked by the concrete5 Sitemap Generator. For this reason, the Bitter Shop System has an export module integrated which creates a separate sitemap for the product pages in your shop.

Note: You can create as many sitemaps as you want. Google's only limitation is that individual sitemaps can not have more than 50,000 entries.

To generate the product sitemap, go to the „System & Settings > Optimization > Automated Jobs“ dashboard page and start the „Synchronize Products“-job. This job execute all export modules. In the basic version, only the export module for the sitemap generation is included, however, you can install additional export modules to export your products to Google Products, eBay, Amazon and many more.

After successfully running the job you will find the product sitemap at the following link: www.yourdomain.com/application/files/googleproductsitemap.xml

Tip: You can save your sitemaps in robots.txt. Most search bots will scan this file for available sitemaps. Simply add a the following line to robots.txt:

Sitemap: http://www.yourdomain.com/application/files/google_product_sitemap.xml 

Export interfaces

Amazon

This export interface enables an automatic synchronization of products from the Bitter Shop System with Amazon. Product data, the associated pictures, stock levels and prices are transmitted to Amazon. Product changes are automatically updated.

What makes this extension very functional: Once the extension has been set up the products get synchronised with Amazon as if by magic. On the other hand the setting is a bit tricky.

Therefore, the package is only suitable for users with the necessary technical know-how.

In case you are one of those technically less experienced users, do not hesitate to contact me. I also offer chargeable remote support for the setting.

Requirements:

  • Amazon seller account
  • Amazon Marketplace Web Service Developer Account (MWS-account).

There are no charges for Amazon MWS account, but you must have the "Professional" sales tariff to use the service. The professional tariff currently costs 39.00 € per month plus taxes (12.03.2018). In case you do not have a professional tariff, you can upgrade your standard tariff at any time in the Amazon Seller Central.

Instructions:

The instructions below explain how to link your page to the Amazon Marketplace in 21 steps and automatically sync your products.

  1. Install the package
  2. Navigate to the dashboard page „Bitter-Shop System“ > „Products“.
  3. Click on the product you want to prepare for the Amazon Export.
  4. Once you are on the detail view of the product, click on the "Edit"-button at the top of the toolbar.
  5. In the fields "Bullet Point 1" to "Bullet Point 5" you can define up to five bullet points to highlight your product.
  6. In the field "Search Terms" you can enter several semicolon-separated search terms under which your product can be found.
  7. Enter appropriate values into the field „Recommended Browse Node“ and „Product Type“ in order to classify your product. You can use the „Product Classifier“-tool to determine the appropriate values. You can find the tool under: https://sellercentral.amazon.com/hz/inventory/classify (Note: Alternatively, you can find the necessary classification information in the Help Centre where an Excel list for each country can be find).
  8. Repeat steps 3 to 8 for all items you want to export.
  9. Sign in into the Amazon Seller Center
  10. Upgrade your account to the professional tariff if you have not already done so
  11. In the „Amazon MWS Developer Permissions“ section, copy the value of the Merchant ID field.
  12. Click on the button „Login information“. In the pop-up window you receive the values from the fields “Access Key ID” and “Secret Access Key”
  13. Now go to your shop and navigate to the dashboard page "Bitter Shop System> Interfaces> Export"
  14. Click on the „Edit“ button in the „Amazon“ list entry.
  15. Paste the three previous fields from Amazon into the settings mask
  16. Now select on which marketplace you want to sell and whether you want to use the test mode or not (Sandbox = activated test mode)
  17. If you have completed all fields correctly click on "Save"
  18. In case you do not have one yet, you must enable the canonical URLs for your page. To do so, go to the Dashboard page “System Settings” > “SEO & Statistics” > “URLs and Redirection”
  19. Make sure your page is externally reachable. Otherwise Amazon can not read the product feed.
  20. Now, when all settings have been made you can start the export. To do so, go to the Dashboard page “System Settings” > “Optimization” > “Automated Jobs” and at “Export Products” click on the “Run” button.(Note: It is recommended to create a CRONJOB for this task)
  21. Congratulations. You have finally made it. Your products are now constantly syncronised with the Amazon Marketplace

eBay

This export interface for the Bitter Shop System synchronizes your articles with eBay in form of fixed price offers. Changes will be automatically updated on eBay.

Important notice: Due to the automatic advertising of the products in the production company, eBay fees will be charged! The amount of the fees depends on your sales tariff. Therefore, be sure to test the connection first in the test environment (sandbox mode).

The package is only suitable for users with the necessary technical know-how.

In case you are one of those technically less experienced users, do not hesitate to contact me. I also offer chargeable remote support for the setting.

Click on the Video to see how it works.

Requirements:

  • Ebay Merchant Account
  • Ebay Developer Account

Instructions:

The instructions below explain how to associate your page with eBay in 19 steps and sync your products automatically.

  1. Install the package
  2. Navigate to the Dashboard page „Bitter Shop System > Products“
  3. Click on Product you want to prepare for the Google export
  4. Once you are in the edit mode of the product, click the "Edit" button at the top of the toolbar.
  5. Select a category.
  6. Enter all other values. (Note: If you do not have an EAN number, enter “Does not apply” where required.
  7. Repeat step 3 to 6 for all products you want to export.
  8. Sign in into https://developer.ebay.com/
  9. For the production environment, link the account to your eBay merchant account.
  10. For the test environment, you also need to link the account. For that purpose you need to create a trial merchant account.
  11. Then copy the "Auth Token"
  12. Generate the "Application Keys" and copy the fields "App ID", "Dev ID" and "Cert ID"
  13. Then navigate to the Dashboard page "Bitter Shop System > Interfaces> Export" in your shop.
  14. Click on the "Edit" button in the "eBay" list entry
  15. Copy all the values listed above and fill in all other fields.
  16. If you have not done it yet, you'll need to enable canoic URLs for your page. Go to the Dashboard page "System & Settings> SEO & Statistics > URLs and Redirection"
  17. Make sure your page is accessible externally. Otherwise, eBay can not read the product feed.
  18. Now, when all settings have been made you can start the export. To do so, go to the Dashboard page “System Settings” > “Optimization” > “Automated Jobs” and at “Export Products” click on the “Run” button. (Note: It is recommended to create a CRONJOB for this task).
  19. Congratulations. You have finally made it. Your products are now constantly syncronised with the eBay Marketplace

Known issues: Image upload in sandbox mode is not working.

eBay Kleinanzeigen

With this export interface you can export your products directly from the Bitter Shop System to the German advertising portal eBay Kleinanzeigen. Since this is an unofficial interface, the feature is limited. In the current version, you are only able to publish new products on eBay Kleinanzeigen one-time. However, no changes can be transferred or ads removed. You need to do this manually through your eBay Kleinanzeigen profile.

Apart from that, the application is very simple. All you have to do is enter your access data into the export settings, select a suitable category for the products and mark them for export.

Click on the Video to see how it works.

Requirements:

  • eBay Kleinanzeigen-Account

Instructions:

The instructions below explain how to associate your page with eBay Kleinanzeigen in 12 steps and sync your products automatically.

  1. Install the package
  2. Navigate to the Dashboard page „Bitter Shop System > Products“
  3. Click on Product you want to prepare for the eBay Kleinanzeigen export
  4. Once you are in the edit mode of the product, click the "Edit" button at the top of the toolbar.
  5. Select a suitable category.
  6. Repeat step 3 to 5 for all products you want to export.
  7. In your shop then navigate to the Dashboard page "Bitter Shop System > Interfaces > Export"
  8. Click on the "Edit." Button in the "eBay Kleinanzeigen" list entry
  9. Insert your credentials of eBay Kleinanzeigen.
  10. Click on „Save“
  11. Now, you can start the export. To do so, go to the Dashboard page “System Settings” > “Optimization” > “Automated Jobs” and at “Export Products” click on the “Run” button. (Note: It is recommended to create a CRONJOB for this task).
  12. Congratulations. You have finally made it. Your products are now constantly syncronised with eBay Kleinanzeigen.

RSS Product Feed

With this export interface you can generate an RSS feed of your products from the Bitter Shop System. You can then use the feed from all major portals to read the data there. Very useful e.g. for portals like www.buffer.com in order to automatically share products on social media.

FastBill

This export interface for the Bitter Shop System transfers all newly placed orders to the accounting program FastBill. This is very convenient as the accounting is kept up-to-date automatically and the invoices are automatically generated.

Click on the Video to see how it works.

Requirements:

Instrucion

The instructions below explain how to link your page to the FastBill in 8 steps.

  1. Install the package
  2. Log in at https://my.fastbill.com/
  3. Go to Settings> General and copy the api key.
  4. In your shop then navigate to the Dashboard page "Bitter Shop System> Interfaces> Export"
  5. Click on the "Edit." Button in the "FastBill" list entry
  6. Insert the API key mentioned above and your email address associated with your FastBill account into the fields.
  7. Click on „Save“
  8. Congratulations. You did it. All new orders will now be transferred to FastBill.

Google products

This export interface allows you to automatically synchronize products from the Bitter Shop System with Google products which will then appear in the Google product results.

Notice that the option is available only if your Google account is connected with your AdWords account and you have deposited a budget, because these are chargeable ads. What makes this extension very functional is how easy the products are being synchronised with Google, once they have been set up.

On the other hand the setting is a bit tricky. Therefore, the package is only suitable for users with the necessary technical know-how. In case you are one of those technically less experienced users, do not hesitate to contact me. I also offer chargeable remote support.

Click on the Video to see how it works.

Requirements:

  1. You will also need a Google account with activated services Merchant Center and AdWords.

Instructions:

The instructions below explain how to link your page to Google Products in 20 steps and automatically sync your products to Google Products.

  1. Install the package
  2. Navigate to the Dashboard page "Bitter Shop Systems > Products"
  3. Click on the Product you want to export.
  4. Once you are in the edit mode, click on the "Edit" button at the top of the toolbar.
  5. Enter the suitable Google category and check export.
  6. Repeat steps 3-5 for all the products you want to export.
  7. Navigate to the Dashboard page "Bitter Shop System > Interfaces > Export"
  8. Click on the "Edit" button in the "Google" list entry
  9. Choose the country you offer shipping for and click save. (Note: In the current version you can choose only one country for shipping)
  10. If already not available you must activate the canonical URL for your page. To activate this go to the Dashboard page "System & Settings > SEO & Statitstics > URLs.
  11. Make sure your page is available externally. Otherwise, Google will not be able to fetch the product feed.
  12. Now when all settings are made you can start the export process. To do this go to the Dashboard page "System & Settings > Optimization > Automated Jobs" and click "Run".
  13. The export interface now generates a valid product feed for Google products, which you now need to add to the Google Merchant Centre. Your product feed address is: www.yoursite.com/application/files/google_product_feed.csv
  14. Navigate to Google Merchant Center in your browser which you can find at https://merchants.google.com/
  15. On the sidebar, click on "Products > Feeds" and then on the "+" button.
  16. Complete the form and click on next.
  17. Enter a feed name and select the second option "Sheduled Fetches" and click next.
  18. Enter the time at which your feed should be called up and the feed URL mentioned above. (Note: In case you have created a CRONJOB for the feed generating, the retrieval time in the merchant center should continue in the future.)
  19. Click "Next".
  20. Congratulations. You have finally made it. Your products are now constantly synchronised with the Google merchant center.