Guide - Feature Overview - Intershop Commerce Pro 1.1 for Adobe

1 Introduction

The present document is primarily addressed to business users who want to inform themselves about the available features and have a quick access on how to use these features.

1.1 Software Version Information

The content of the present document is valid for the following combinations of software versions:

IntershopAEM ConnectorAdobe Experience Manager
7.4
7.4 CI
1.16.0

1.2 References

Documentation: eCommerce Integration with Intershop

The documentation of the eCommerce integration with Intershop is attached to this page. These information are especially important for the product and catalog import: For example: How to configure the catalog importer?

The following information can be found there:

  • Deploying eCommerce with Intershop
    • Setup Geometrixx in Intershop 7
    • Installation of eCommerce with Intershop
  • Concepts of eCommerce with Intershop
    • Page and Components
    • Roles - Products and Product Variants
    • Data Synchronization
    • Shopping Cart Content Overview
    • Product Catalog Sections
    • Product Information with Color Variants
    • Customer Registration and Accounts
    • Customer-Specific Pricing
    • Order Fulfillment and Tracking
    • Anonymous Customers
    • Registered Customers
    • Catalog Importer
    • Configure the Catalog Importer
    • Configure the Product Attributes to Load
  • Developing eCommerce with Intershop

2 Import Product & Catalog Data

There is a variety of ways to import product and catalog data. The product and catalog data can be imported when initially setting up the environment, or after changes have been made in the Intershop data.
Product and catalog data is maintained in Intershop 7 and can be imported into the AEM system via different import modes:

  • Full Import
  • Incremental Import
  • Express Update

Actual product information imported from Intershop or any other source is held in the CRX repository under:

/etc/commerce/products

The Intershop Product und Catalog Importer is available under:

http://localhost:4502/etc/importers/intershop.html

2.1 Full Import

As the name says, full import means an import of all online catalog and product data from IS7 into the AEM. The current version does not take care for the deletion of obsolete catalogs & products.

Example:

Delete the existing product data from the AEM

If required, before the actual import, delete all existing product data using CRXDE Lite:

  1. In CRXDE Lite, navigate to the sub-tree holding the product data:
    /etc/commerce/products

  2. Delete the node that holds your product data; for example, Outdoors.

  3. Click Save All to persist the change.

Preconditions:

  • The connection between AEM and IS7 is already prepared.
     
  • In the Intershop system the Outdoors catalog exists.
  1. Open the Intershop importer in AEM:
    Navigate to /etc/importers/intershop.html or
    http://localhost:4502/etc/importers/intershop.html and
  2.  Configure the parameters as required, e.g.:
  3. Click Import Catalog to start the import.
    The products are imported in the AEM and are available in the CRX repository under: /etc/commerce/products/outdoors/outdoors/en.
    When complete, you can verify the data imported at: http://localhost:4502/crx/de/index.jsp#/etc/commerce/products.

2.2 Incremental Import

Imports all product and catalog data which were changed since the last import.

  1. Check the information held in AEM for the relevant product(s), in the appropriate sub-tree under:
    /etc/commerce/products

  2. In Intershop 7 system: update the information held on the relevant product(s).

  3. Open the Intershop importer in AEM:
    /etc/importers/intershop.html

  4. Select the checkbox Incremental Import.

  5. Click Import Catalog to start the import.

    When complete, you can verify the data imported at: http://localhost:4502/crx/de/index.jsp#/etc/commerce/products.

2.3 Express Update

The import process can take a long time so you can select specific areas of the catalog for an express update that is triggered manually. This uses the export feed together with the standard attributes configuration.
The products which will be part of the next express update can be selected manually within the product section in the Intershop 7.

  1. Check the information held in AEM for the relevant product(s), in the appropriate sub-tree under:
    /etc/commerce/products

  2. In Intershop enter a product detail page and use the checkbox Express Update to mark a product for Express Update in AEM:

  3. Open the Intershop importer in AEM:
    /etc/importers/intershop.html
  4. Select the checkbox Express Update.           
  5. Click Import Catalog to start the import.
    When complete, you can verify the data imported at: http://localhost:4502/crx/de/index.jsp#/etc/commerce/products.

3 Get Prices Dynamically from Intershop 7

Currently all product prices within the Geometrixx demo store are updated dynamically from the IS7.

  1. Navigate to a product on the Geometrixx outdoor demo storefront and memorize the product and the price.
  2. Move to the IS7 system and change the price of the recently viewed product.
  3. Navigate back to the product page in the Geometrixx Outdoors demo storefront: The recently updated price appears without any update or import effort.

4 Product Page

4.1 Add a Product to the Cart

A customer can add a product to the cart while browsing the according product detail page (Geometrixx Outdoors).

Note

There is currently no error handling implemented regarding max. quantity or something else. Only wrong formats are handled by a customer notification.

Example:

  1. Navigate to a product within the Geometrixx Outdoors storefront.
  2. Add a quantity of a product to the cart (ensure that this amount is valid - check within the IS7)  and
    Click ADD TO CART.

  3. If the format was correct, the cart page holding the expected amount of the added product is displayed.

5 Cart

5.1 Cart Page

Every customer has its own cart. So the customer can find all relevant information about the current shopping session:

The upper left section of the shopping cart displays all information about the existing items in the basket:

  • Quantity of items in the shopping cart
  • Product information
    • Product image
    • Name (links to the product detail page)
    • Short description
    • Size
  • Quantity
  • Price

Below the cart all order promotion messages are currently displayed, if there are any applied to the cart (see also section Promotions).

5.2 Cart Summary

The cart summary is available on the cart page, all checkout step pages as well as on the order details page (my account).
There you can find the cart overview including information like taxes, shipping & costs and so on.
Dependent on the storefront site, which uses the cart summary, different information appear on the cart summary.

5.2.1 Cart Page

  • Item subtotal
  • Order Promotions
  • Tax
  • Shipping costs (currently the hard coded shipping method Standard Ground is used)
  • Shipping Promotions
  • Add coupon code functionality (without any result notification - in case of success or failure)
  • Checkout link which leads to the first checkout page
  • Total in $

Example:

5.2.2 Checkout Step 1-4

The first checkout page shows on the right side the cart summary with the following information:

  • Item subtotal
  • Order Promotions
  • Tax
  • Shipping costs (currently the hard coded shipping method Standard Ground is used)
  • Shipping Promotions
  • Add coupon code functionality (without any result notification - in case of success or failure)
  • Total in $

Example:

5.2.3 Checkout Step 5 / Submit Order

The second checkout page shows on the right side the cart summary with the following information:

  • Item subtotal
  • Order promotions
  • Tax
  • Shipping costs (currently the hard coded shipping method Standard Ground is used)
  • shipping promotions
  • Total in $
  • Add coupon code functionality (without any result notification - in case of success or failure)

Example:

5.2.4 Order Detail Page

The order detail page (part of my account - order history - order detail page) shows on the right side the cart summary with the following information:

  • Item subtotal
  • Order promotions
  • Tax
  • Shipping costs (currently the hard coded shipping method Standard Ground is used)
  • Shipping promotions
  • Total in $

Example:

5.3 Remove Items from Cart

A customer can remove an item from the cart. Afterwards the cart summary is updated directly.

Note

There is currently no confirmation question available. A click on the remove button removes the item immediately.

Example:

  1. Navigate to the cart page.
  2. Click on the remove button next to the product image of a line item.

    As a result the product is removed from the cart.

5.4 Change Quantity of Cart Items

A customer can change the quantity of cart item. If a customer sets the quantity to "0", the item will be removed from the cart.
In case the customer tries to set an invalid character (only positive numbers are allowed), an user notification appears:


Example:

  1. Navigate to the cart page including at least one product.
  2. Change the quantity of a product and click Set.

    The quantity has changed.

6 Customer Registration

A customer can register himself on the storefront of the Geometrixx Outdoors store and thus create an account. The following information can be entered while the registration:

  • E-Mail
  • Password
  • Confirm Password
  • Last Name

The password and the password confirmation must match. Otherwise a user notification appears and the registration is not finished:


After the registration a confirmation page appears (see example - step 3).

Note

Currently it is possible to register plenty of accounts with the same e-mail address. There is no error handling while the registration process implemented to avoid that - a confirmation page appears if the user types in:

  • at least a password length of one character
  • the same password twice (password confirmation matches)
  • an email address containing at least one character

An error handling is available later while the login process (only the first registered e-mail address is valid). After the registration a customer is not automatically logged in.
Furthermore, the account is not created within the Intershop system. This needs a login downstream.

There is currently officially no field mandatory, but later the login needs a valid e-mail and a password (the last name must currently not exist).

Example:

  1. Navigate to the Geometrixx Outdoors registration form:
  2. Enter an e-mail address, last name as well as a password:

  3. Click on register:

6.1 Login

A customer can log in if an account was created before. The customer has to enter an e-mail address and the corresponding valid password. After a successful login the customer is lead to the already opened storefront page (see section customer registration - example - step 1).
If the customer does not exist within the IS7, he will be created with some predefined attributes, which are displayed in the screenshots (step 3) below.
If the last name is not available for the first login, the Intershop system uses the e-mail address to create the account with all mandatory fields (also for the last name).

Example:

  1. Navigate to the login page (login light box) and enter a already registered user name and the corresponding password.
     
  2. Click Sign In.
    The registration form is displayed.

  3. If the customer does not exist in the Intershop system (e-mail address), the customer will be created there with some predefined attributes:


6.2 Logout

An already logged in customer (in the Geometrixx Outdoors storefront) can log off himself. This process deletes the current session.

Example:

  1. Login into the Geometrixx Outdoors demo store.
  2. Click Sign Out.

    The customer is now logged out and the session is not available anymore.

7 Basket Handling

7.1 Basket Takeover After Login

A customer can reuse an anonymously created basket after logging in. This way a customer can easily continue shopping without adding again all products to the cart.

If the customer has an already existing cart, the items are automatically added to the personalized cart.

7.2 Basket Recovery After Cart Abandoning

A registered customer will get an abandoned basket after the next login. Therefore no existing cookies (including the basket ID) are needed.

8 Checkout as a Registered Customer

Note

Currently only a checkout as a registered user is supported. An unregistered checkout leads currently to some errors.

A user can trigger the checkout process via:

  • The mini cart checkout link
    • Only available if at least one product exists in the cart
  • The checkout link on the cart page
    • Always available, but throws a customer notification in case there is no product available within the cart:

      Click OK and the cart page is again displayed.

8.1 Set Billing/Invoice Address

A customer has to enter a billing address while the first checkout step. Therefore the following information must be entered:

  • First Name (mandatory)
  • Last Name (mandatory)
  • Street Address 1 (mandatory)
  • Street Address 2 (optional)
  • City (mandatory)
  • State / Province (mandatory)
  • Postal / Zip Code (mandatory)
  • Country (drop-down box - the first entry is preselected)

Note

All mandatory fields are already pre-filled with the stored information in the IS7 (see screenshot above).

The entered invoice address will be part of the created order.

A simple input validation, which ensures that all mandatory input fields have at least one character entered, is triggered by the Next button.
The first found empty input field will be mentioned in the upcoming customer notification:

Example:

  1. Navigate to the Geometrixx storefront.
  2. Put at least one product into the cart.
  3. Proceed to checkout and fill out the form.

8.2 Set Shipping Address

During the 2-step-checkout the customer has to enter the shipping address for his whole order. Per default the shipping address is equal to the invoice address.

A customer can specify a differing address.

  1. Deselect the checkbox Same as billing and
  2. Enter the shipping address data.

  • First Name (mandatory)
  • Last Name (mandatory)
  • Street Address 1 (mandatory)
  • Street Address 2 (optional)
  • City (mandatory)
  • State / Province (mandatory)
  • Postal / Zip Code (mandatory)
  • Country (drop-down box - the first entry is preselected)

Note

All mandatory fields are already pre-filled with the stored information in the IS7 (see screenshot above).

The entered shipping address will be part of the created order.

A simple input validation, which ensures that all mandatory input fields have at least one character entered, is triggered by the Next button.

The first found empty input field will be mentioned in the upcoming customer notification:

Example:

  1. Navigate to the Geometrixx storefront.
  2. Put at least one product into the cart.
  3. Proceed to checkout and fill out the form.

8.3 Set Shipping / Delivery Method

At the moment a customer has to select a delivery method while the checkout process. Predefined are the following dummy shipping methods:

  • Domestic Ground Shipping - $10.00
  • Flat Rate 3-day UPS Shipping - $20.00
  • Flat Rate FedEx Overnight Shipping - $40.00

Example:

The choice of the selected shipping method within the storefront has currently no influences on the used shipping method, because the shipping method Standard Ground is hard coded.
Therefore this shipping method has to be defined in the Intershop system:

If the shipping method Standard Ground does not exist or has the status inactive, an error will occur while the submit order process:

Note

The cart summary and order calculation uses the set shipping costs managed by the Intershop system.

8.4 Set Payment Method

At the moment a customer has to select a payment method while the checkout process. For demo purposes only the payment method credit cart is implemented as a dummy component.
The customer can choose between three different credit cards and has to enter the following information on the first step of the checkout:

  • Credit Card Type (Maestro, Switch, Master Card/Eurocard) (mandatory)
  • Credit Card Number (mandatory)
  • Name on Card (mandatory)
  • Exp Month (mandatory)
  • Exp Year (mandatory)

At the second step of the checkout process, the customer has to enter the corresponding Card Verifiable Certificates (CVC) before the order can be submited:


The choice of the selected payment method within the storefront has currently no influences on the used payment method, because the payment method BPS_INVOICE is hard coded.

Therefore this payment method has to be defined in the Intershop system:


If the shipping method BPS_INVOICE does not exist or has the status inactive, an error will occur after an order is submited.

For all input fields exists a validation, which is triggered by the Next button.

The validation checks the following input:

  • Is any mandatory field empty?
    If yes, a customer information message appears:

  • Is the entered credit card valid?
    If not, a customer information message appears:
  • Is the entered expiration month and year of the credit card valid?
    If not, an appropriate notification appears:

    or

8.5 Submit Order

On the second checkout step, the customer has the possibility to review the current order. All important information about the current order are displayed:

  • The amount of items in the shopping cart
  • Information about the products in the shopping cart including:
    • Product
      • Name (links to the product detail page)
      • Short Description
      • Size
    • Quantity
    • Price
  • Billing address
  • Shipping address
  • Cart summary

Currently only the payment method credit card is implemented. Due to this fact, the customer has to enter a valid CVC-Number. Elsewise, the following customer notification appears after a clicking Submit Order.

If a valid CVC-Number was entered and the customer clicks Submit Order a customer confirmation page is displayed:

Additionally, the order is created in the Intershop system:

General tab of the order:

Promotions tab of the order:

Payment tab of the order

The order confirmation page provides a link to the Order History page, where all orders are listed, sorted by the creation date (see section My Account for more detailed information).

If the Intershop system is correctly configured an order confirmation e-mail is sent to the customers e-mail address.

9 Promotion

Preamble : Since a sync between Intershop and Adobe Promotions is yet to be implemented, promotions need to be maintained on both systems to display some promotion specific content.

Documentation: Create a promotion in AEM.

To add some promotion specific content on the Geometrixx Outdoors storefront, it is currently necessary to create the promotion also in the AEM.
Therefore, a Marketing Manager has to create a customer segment within the AEM, which serves as a promotion rule.
Afterwards a campaign is needed to cluster all promotion specific content, which is related to a defined customer segment.

You can find all information about the creation of a promotion in the AEM here: Create a Promotion in Adobe

Due to the fact that the Intershop system handles the basket calculation, it is also necessary to create and manage the promotions in the Intershop system.

Up to now these promotion discount types are working:

  • Order promotions
  • Shipping promotions

Note

Free gift promotions and line item promotions are not implemented yet.

If a promotion applies to the cart, the only text that occurs in the Adobe Geometrixx Outdoor storefront is the description below the cart (hard coded within the JSP file - no component available), managed by the Intershop system:

The promotion description displayed on the cart page and the submit order page if the promotion is triggered.

Example (cart):

Example (submit order page):


The promotion discounts for free shipping and order promotions are displayed on the cart summary:


Note

Promotions with Promotion Code are not displayed below the cart. They are interpreted as voucher and therefore displayed within the cart summary (see section Promotion Code).

Limitations of the promotion functionality

  • Adding promotions by Adobe is not supported.
  • The message defined in Discount Rules > Message is not transmitted.
  • Images in message texts are not supported at Intershop adapter side.
  • Only order and shipping promotions (item promotions are not available via rest) are available.
  • Automatic gift promotions are not supported.

9.1 Promotion Code

At the moment a customer can add a promotion code on the cart page and during checkout.

Example: Cart

Example: Checkout step 1

Example: Checkout step 2 / submit order

After a promotion code is successfully added, the promotion is displayed within the cart summary on the cart page and on both checkout pages (for example: Checkout step 2 / submit order).
The current displayed name consists of the "Promotion Code" + ": " + "Promotion Description" (these information are managed by the Intershop system).

Note

At the moment it is not possible to remove a promotion code.

10 My Account 

The my account section allows the Geometrixx Outdoors customer to see all available order information stored in the Intershop system. The account settings and profile information were not touched by the Intershop implementation yet.

10.1 Open Orders

The Open Orders section can be reached via the Open Orders link in the My Account section:

  1. Click Open Orders link.

    A page displays all open orders sorted descending by the creation date.

Definition of an open order: status in pending, in progress or new
The following information are available in the list view:

  • Date
  • Summary
    • Quantity of items and the names of the items in brackets
      If there is not enough place to display all products in the brackets the list is cut and "..." is shown
    • A link to the order detail page (see section order detail page)
  • Price
  • Status

On the right side recently viewed items are displayed with some information (image, name, price).

10.2 Order History

The Order History section can be reached via the Order History link within the My Account section or via the order number link of the order confirmation page.

Example: Open orders link (my account)

Example: Order confirmation page (after submit order)

Both links lead to the order history list holding all orders placed within the last 12 months.

The following information are available in the list view:

  • Date
  • Summary
    • Amount of items and the names of the items in brackets
      If there is not enough place to display all products in the brackets the list is cut and "..." is shown.
    • A link to the order detail page (see section order detail page)
  • Price
  • Status

On the right side recently viewed items are displayed with some information (image, name, price).

10.3 Order Detail Page

The order detail page shows some information about a selected order. Use teh links from the Order History page or the Open Orders page (see above).
The following information about the order are available:

  • Placed order date
  • Current status
  • Billing Address
  • Shipping Address
  • Cart
    • Product
      • Product image
      • Product name
      • Short description
      • Size
    • Quantity
  • Order summary
    • Item subtotal
    • Order Promotions
    • Shipping costs (currently the hard coded shipping method Standard Ground is used)
    • Shipping Promotions
    • Tax
    • Total in $

Note

Promotion messages are not displayed at the moment.

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources
Support Tickets