APOGEE > Apogee StoreFront Online Help Addendum
APOGEEnetwork New Document = New content

Apogee StoreFront & Asanti StoreFront
Online Help Addendum

This page contains last-minute updates to the information available in the Online Help of Apogee StoreFront and Asanti StoreFront. Administrators can access the Online Help by clicking the 'Help' link in the navigation bar at the top of StoreCenter.

The information is split up in the following sections:


Full HTTPS support

Stores make full use of the secure, encrypted HTTPS protocol for data communication. For stores that use a custom domain name, there is no need to purchase a separate SSL-certificate. StoreFront automatically takes care of this using 'Let's Encrypt' certificates. When accessing any page in a store, the browser will show the 'secure' green lock icon.

Showing separate VAT rates

An order can consist of multiple items that use different VAT or tax rates. StoreFront can show the split on the order details page, the order confirmation email and the invoice. Quotes also show split rates. The separate VAT rates are shown for every store, regardless of whether it uses a price list that includes or excludes taxes. You need to enable this in the 'Payment and Pricing' settings of the store in StoreCenter.


The Online Help is up to date.

Products & Product Templates

Combine kits and non-print

StoreFront can automatically combine multiple items in the same packing unit. Three stacks of 250 brochures can, for example, be put in the same large box to save on shipping costs. From version 4.5 onwards StoreFront can also group kits and non-print items in a box.

  • Multiple product kits can be combined in a single box, based on them using either the same template or having the same size.
  • The same is also true for non-print items, which can also be combined if they use the same template or share the same size. This works for both box and roll-based packaging units.

Define packing measurements for a media type option

When you sell large flags in a store and give customers a choice of three types of canvas, the shipping cost may vary depending on the choice of textile. The thin canvas allows you to fold flags five times and fit 20 in a box whereas the thick canvas flags should only be folded four times so fewer fit in the same box. In StoreFront v4.5 you can now change the shipping volume per media type. This is done in the 'Packing Measurements' tab of the 'Media Type Option Value' window in Product Templates > Product Options.

Online Editor

HTML5-based Online Editor

The Flash-based Online Editor is still available but from StoreFront version 4.5.3 onward you can also set up customizable and VDP products using a new HTML5-based editor. This enables you to set up stores that no longer require Adobe Flash. Security conscious customers may insist on this. More and more browsers are also dropping support for Flash which has never even been available on tablets like the iPad.

Customizable documents can use either the Flash or HTML5-based editor. Which technology is used is determined in the 'Upload Files' window of the product wizard. In the list of products a small 'f' in the product icon indicates which products still rely on Flash.

StoreFront 4.5 choose Flash or HTML5

The toolbar at the bottom of the Products window has a migration button, allowing you to convert all or selected customizable products to the new HTML5 editor. In general we recommend sticking to Flash for complex documents that use the 'Advanced' or 'Expert' workspaces. The HTML5 editor has mainly been tested with forms-based documents and is currently more suitable for such documents. With future updates the HTML5 editor will evolve until it can fully replace the Flash version. At that point in time we will inform all users that the Flash-based Editor will be phased out.

StoreFront 4.5 convert to HTML5

This is the recommended procedure for converting an existing document from Flash to HTML5:

  1. Duplicate the customizable product.
  2. Convert the copied document to HTML5 and add it to the store. If you have a MallPack Silver or Gold license use an access label to temporarily hide the product for the users.
  3. Do a check in the store that the product can be visualized and edited properly.
  4. Add the product to the card and generate a softproof from within the shopping cart to validate that a correct PDF file will be generated.
  5. Only make the product available to end users once it has passed these two tests.

When editing a document in StoreCenter, please avoid switching back and forth between the HTML5 and Flash-based editor. Once a document is configured to use the HTML5 editor, continue using that editor. Continuous conversions may lead to unexpected changes in the document.

The Flash and HTML5 editors are not completely identical. We strive to make them as similar as possible but some functions are not yet implemented in the HTML5 version.

Functions that are not yet available in the HTML5 editor:

  • The flipbook function that allows users to browse multi-page documents. The button is available in the bottom toolbar but it does not yet work.
  • browse through document pages

  • The path editor for editing shape frames
  • edit vector paths

  • Custom baseline grids - the Text > Frame Custom BaseLine Grip pane does not yet allow you to define a baseline grip
  • Hyphenation for any language except English. The 'Language' selector in the Text > Text Frame Settings pane is not yet available. All text is considered to be English when you use the hyphenation function.
  • Spell checker
  • When editing variables of a form a new Notes field is available. You cannot add any text to it yet.
  • add notes to a variable

Known issues when working with forms:

  • The date picker does not properly display disabled days and allows users to select them.
  • An admin could previously add a variable to a text frame by double-clicking the name of the variable. Now you need to use the 'Insert Variable' button.
  • Editing the values for a list variable can be very slow.
  • A new series of variable types are available which have not yet been fully tested: Table, Color, Paragraph Style, Character Style, Font and Coordinate. We recommend not to use these yet.
  • Info text about a variable can really slow down the browser when the input fields are drawn.
  • The Editor may fail to warn users that mandatory fields have not been filled in.

Known issues when working with text:

  • When working with tabbed text, the text cursor is not always shown at the correct position when you hit the Tab key to jump to the next tab.
  • Text may flow differently in the HTML5 editor because of differences in font handling, kerning or hyphenation. Please check all text after converting documents.
  • Text indent and margins modified in the ruler are only applied to one line.

Known issues when working with images:

  • When an administrator uploads new images to the store or product images library, they will only show up when the refresh button is clicked.
  • In image libraries the Search function can be slow because the entire library is reloaded when you switch to the Search tab.
  • Admins cannot yet use the 'Delete' button to remove images from the store or product images library. This is only possible in the Flash-based editor.
  • When image variables are used, these need to be linked to a library. The button to assign the library, shown below, does not work. This is not really an issue since you will be asked to pick a library when closing the document. It can be tricky, however, if you pick the wrong library or want to switch to another library afterward. This is only possible in the Flash-based editor.
  • The link button does not work

  • The bottom right handle to crop images does not scale the image properly. The three other handles do work fine. This is just a visual glitch which may confuse users.
  • bottom right handle

  • Insets on image frames are not applied correctly when the fitting mode "Manual" or "Proportional, Outside" is selected.

Other general limitations:

  • By default frames on a locked layer are not locked. You need to manually lock them one by one prior to making the document available to users.
  • Oversized images that extends beyond the bleed of the page may also partly appear on the next or previous page if they are that big. This is purely a visual glitch that does not affect the PDF sent to the workflow. Below you see how the tip of the Agfa rhombus appears on the front page of the business card.
  • confusing artefact

  • Small visual artefacts may show up when converting documents from the Flash to the HTML5 based version.
  • Sometimes the Online Editor reacts slowly to commands and it takes a while before it catches up.

Ordering & Checkout

Estimated shipping date

For each shipping service you can now optionally define how many days it takes to get an order ready for shipment. If you set this to '2 days' then StoreFront will indicate to the shopper who orders on Monday morning that the order will ship on Wednesday. During checkout it shows the actual date instead of a more confusing 'within 2 days' message.

StoreFront 4.5 available shipping dates

Configuring the duration is done in the Advanced > Shipping > Shipping Services window. In the general settings for each shipping service there is a 'Time to ship' checkbox. When activated, you can specify how many days it will take to ship an order.

The 'Shipping Info' tab can be used to add a short descriptive text that will be shown to the shopper during checkout. This is also the case when no time to ship is defined. If you do define a target shipping date, three variables can be inserted in the message:

  • {estimatedshippingdate} inserts the date when the order is expected to be shipped, e.g. '10/10/2017'. The date formatting depends on the regional settings of the store.
  • {orderdeadline} inserts the cut-off time, as described below, e.g. '11:30 AM'
  • {shippingdays} inserts the number of days before orders will be shipped, e.g. '4'

To calculate the expected shipping date, StoreFront needs to know your production schedule. This is defined in the new Advanced > Production Settings > Production Calendar window.

  • You can specify on which weekdays no production takes place.
  • You can also define holiday periods and other dates when no orders are processed.
  • A threshold ordering hour, the 'Order Deadline' can be defined. If you set this cut-off time to 12:00 it means the current day is still considered a production day for any orders that are submitted before twelve o'clock.

Estimated shipping dates are shown:

  • During checkout in the Shipping tab
  • On the order confirmation page and the order confirmation e-mail
  • On the order details page
  • In the 'Pending Orders' window in StoreCenter the target shipping date will be shown greyed out and in italics in the 'Shipped' column. You can sort on this column to see which orders should get priority. Once an order is shipped, the actual shipping date is shown in the regular font. For shipments that are overdue the date is marked in red.

Keep in mind that the shipping time is not dependent on ordered quantities or time-consuming finishing options that the shopper may have selected. It also does not take into account that your team also produces jobs that did not originate in StoreFront. You may want to add a disclaimer that the target shipping date is a 'best effort estimate' and that customers will be informed if there are delays.

Extended quote function

StoreFront 4.0 included a new function to create price quotes. 'Quoting' is available for MallPack Gold or Platinum licensees and it has been extended in this new version.

  • Customers who are allowed to create quotes will now automatically get an e-mail with a link to each quote they make. This means StoreFront stores the data for each quote, allowing the user to go back and check older quotes. They can do this by clicking the link in the e-mail they received.
  • Printer administrators can ask to also get an e-mail with a link to each quote. This allows your sales people to monitor which customers create quotes and follow up on them.
  • In the Store > Pages > Legal tab you can specify a 'Custom Quote Information' text that will be seen in the Quote list (Shopping Cart), the Quote checkout flow and in the Quote Details.
  • The creation date is now also added to each quote.

Order Fulfillment & Shipping

Order Fulfilment & Shipping

StoreFront automatically generates an ID number for each new order. Version 4.5 offers more options to configure ID numbers.

  • In the Advanced > Production Settings > Production Center window you can define the structure of order ID numbers, invoice ID numbers and quote ID numbers. .
    Since orders, invoices and quotes can now be numbered separately, this enables you to operate multiple stores but if only one of them generates invoices, its numbers will be consecutive. This is a legal requirement in many countries.
    Another advantage of a separate invoice number is that you now can avoid gaps in your order administration since cancelled orders will no longer be included. The invoice counter only increments when the invoice is actually created, which is when you mark an order as 'Shipped'.
    The PDF Form templates already had the variable 'ASF_INVOICE_NR' which used to be resolved to the order number. StoreFront will now use the invoice number instead. To include the order number, use the new variable 'ASF_ORDER_NR' instead.
  • On the store level you can separately set the counter used for numbering to a specific value. If a store should have its own order ID numbering starting from 1, you can do this. On New Year's day you may want to reset the counters to 1 so that StoreFront starts numbering from scratch again.

Revised order statuses for payment by bank transfer

Orders paid by bank transfer now get the status 'Awaiting Payment' as long as the printer hasn't updated the payment status of the order in StoreCenter. Previously they were immediately marked as 'In Production', which confused shoppers.

Download invoices in StoreCenter

In the Dashboard > Order Reports window administrators can now download all the invoices from a certain period in time in a ZIP or a single PDF file. For legal reasons it is a good idea to archive invoices on a regular basis.

In the Orders window in StoreCenter there is a new button to generate (or re-generate) the invoice in case invoice creation was not enabled for a store, or in case the style of the template changed in the meantime.

Easy order cleanup

Once orders are marked as 'Completed' they move from the 'Pending' tab to the 'Complete' tab in the StoreCenter order list. Manually changing order statuses can be cumbersome so in Storefront v4.5 you can change the status of all old orders to 'Completed' with just a few clicks.

  • Click the new 'Mark pending orders as completed' button.
  • A window pops up that allows you to pick a 'Created before' date.
  • Click 'OK' to confirm that all orders created prior to this date can be marked as 'Completed'.
  • StoreFront will mark all orders with status 'Available' or 'Shipped' and created before this selected date as 'Completed'. This will also happen for orders that were not yet marked as 'Shipped'. For orders that were not yet marked as 'Shipped', no shipping confirmation mails will be sent.

By activating and filling in the 'Created after' field in the above window you can clean up orders created within a specific date range.

To avoid processing bottlenecks StoreFront will process batches of orders. This may take some time, depending on the number of orders that need to be marked as 'Completed'.

Additional variables for invoices

Additional variables are available to format shipping and billing addresses on invoices. They can be used to insert the street, postal code, city and country separately.

  • #ASF_SHIPMENT_ADDRESSLINES# (this combines both address lines in a single variable to avoid empty lines)
  • #ASF_BILLING_ADDRESSLINES# (this combines both address lines in a single variable to avoid empty lines)

Online Payment

MercadoPago payment gateway

MercadoPago is a popular payment service provider in Latin-America. Stores that operate in Argentina, Brazil and Mexico can now make use of MercadoPago payments.

  • For Argentina the following cards have been tested: Amex, Argencard, Cabal, Censosud, Diners, Mastercard, Naranja, Nativa MasterCard and Visa.
  • For Brazil the following cards have been tested: Amex, Diners, Elo, Hipercard, MasterCard and Visa.
  • For Mexico the following cards have been tested: MasterCard, Mastercard D&‌eacute;bito, Tarjeta MercadoPago and Visa D&‌eacute;bito.
  • In each country other cards may work but should be tested before you allow their use.
  • Both direct and deferred payments are supported.

A future update will include support for this payment service provider in other Latin-American countries.


System integration

Each media variant, such as '220 gram Antalis Luxo paper', can have an ID code associated with it. This MIS ID code is included in the JDF order data and can be used to inform an MIS or ERP system which media is used for the order item. It is also displayed on the order item details page.

Enhanced JDF data

To facilitate data exchange with MIS or ERP systems, the JDF file generated for each order item now contains a structured comment XML element. This contains info that was already available in text format in the comment tag. By structuring the data using XML tags it becomes much easier to retrieve specific data. The JDFserver of Apogee or Asanti allows you to map the value of tags to Prepress variables.

Known issues & limitations
  • Invoices can contain the order ID code but they do not make use of their own invoice ID code. Order IDs are not necessarily consecutive numbers because order IDs are used across all the stores of the account and orders can be rejected during an approval cycle. Local tax legislation may demand that invoices use a continuous numbering system.
  • Formatted text will not be formatted in the generated PDF for Variable Data Products (AWP-13886)
  • The price of a Product Kit in the Product Category may be different from the price on the product page due to rounding differences (AWP-13329)
  • Shipping Services with Calculation Method "Percentage on order total" are calculated on the total order price without taking a possible promotion code into account. (AWP-13306)
  • Some fonts do not support all currencies correctly in PDF Invoices. This is for example the case with the currency symbol of CZK when using the Helvetica font. (AWP-10984)
  • The maximum type size that can be used in the Online Editor is 720 points.
  • Empty image frames in InDesign become plain rectangular frames in the Online Editor (AWP-9620).
  • With the plugin for CC 2014 an incorrect package is created when an InDesign page contains at least 3 times the same image. In the Online Editor some of the image frames may be blank. (AWP-11703).
  • Some Photoshop clipping paths are incorrectly converted by the Online Editor (AWP-5656).
  • Compound German words are not always recognized by the spell checker and will all be considered as incorrect (AWP-5760).