Back End Order Entry (BEOE) v2

This page describes how a merchant may enter orders using the back end

Change Log

  • Added an additional permission requirement to the Customer REST API. It's called "REST Customer Profiles". The change was implemented to address a concern of having third party call centers using the BEOE. With it, they could perform wildcard searches and access a merchant's entire customer database. Without this permission, the BEOE still works, but the customer search will not.
  • When a item is added with free promotional items, the free items are automatically added as well.


The Back End Order Entry (referred to as BEOE hereafter) is a web application allowing merchants to enter orders for customers.  It is commonly used for phone and email orders and is popular among call centers.

Launching the BEOE

The BEOE is a web application and runs without plugins in any modern browser.

Navigate to:


You need a modern browser to use this web application properly.  

Consider visiting and comparing your browser to their list.  If you are using an old browser, please upgrade.

UltraCart Support will not respond to issues caused by old browsers. If you find an issue that cannot be replicated on a browser listed on browse happy, it will not be addressed.



There are three User Permissions that govern the use of the BEOE tool.

  1. Back End Order Entry - allows a user to run the BEOE tool.
  2. Edit Order - allows a user to edit an order.
  3. REST Customer Profiles - allows a user to run wildcard searches against the customer database.

1 & 2 are required to use the BEOE.  

#3 above is a new permission as of 7/24/13, created to address the issue of allowing a call center full access to a merchant's customer database through wildcard searches.

If a user lacks REST Customer Profiles, they can still link an email to a profile (this is the little chain link icon that appears next to an email).  However, they cannot perform searches.


The BEOE does not handle the following:

  • Auto Order Items (except Auto Upsell)
  • Gift Certificates
  • Affiliate Transactions
  • Special Shipping Instructions
  • PayPal Orders

Important Reminders

  • Calculate your shipping!  There are many fields that affect shipping.  Before you finalize your order, consider re-calculating your shipping to ensure it's accurate.  
  • The BEOE does not keep field values if you navigate away from the page.  If you start an order, get half way through, and accidentally hit the back button, you'll probably lose your work.  The BEOE is self contained and there is no need to navigate away from the page while entering orders.

Ways to start an Order

New Order

When the BEOE is opened, you should be presented with a new (blank) order form.  If not, click the New button at the top left of the screen to begin

Clone Order

To clone an existing order, click the Clone button.  A Search form will appear below the Clone button where you may search and select an order to clone.  You can search by Email, Order ID, First Name, Last Name or Company Name.

If found the Search will display a list of matching orders.  You will have three actions you can take for each result.  You may view the order, clone it entirely, or clone it minus items.

Order Templates

Order templates were designed to pre-populate fields quickly.  They are used heavily by merchants with physical stores taking walk in's. The templates allow them to fill out most fields with "in store" details and quickly record a sale.

Creating a Template

Creating a template is easy.  At whatever point you're satisfied with the information you've entered and wish to create a template, click the Save as Template button at the bottom of the screen.   Give the template a short name and you're done.  

The newly created template will appear at the top of the screen as a button.

You may have up to 5 templates.

Using a Template

To use a template, just click the template button.

Deleting a Template

Click Edit Templates at the top of the screen, select the template you wish to delete, and click the Delete Selected button.    If you need to change a template, delete it and re-save it.

Item Management

Manual Entry

To add a single item to an order, use the entry field on the main item table.

As you type, the BEOE will search for matching items.  A list will appear below the field with a relevancy score and description.  Click on an item from the list to select it.   

Hitting enter in the Item ID field will add the item with a default quantity of 1. This is a quick way to add an item.

Adding Multiple Items at once

To add multiple items at once, click the Add Multiple Items button above the Item table.  From there, enter the items and click Apply

This is a legacy feature from version 1. It used to be a lot quicker than adding a single item one at a time. It's not so much anymore. The single add is much faster. You may use the multiple add field if you like, but it's not a tremendous time saver.

Item Search

Item search provides "look-up as you type" searching for items displaying a larger table of results.  This screen is useful if you have long item descriptions.

Quick Items

Editing Quick Items

Click the Edit Quick Items button at the top of the screen.  A panel will display allowing you to add or remove quick items.  You may define multiple quick items for the same item using different quantities.  This is very popular with merchant at trade shows who are selling a few items in different quantities.

Using Quick Items

  • Click the Quick Items button.
  • Select one or more Quick Items.  They will turn green when selected.
  • Click the Add Selected button to add those items to the cart.

Customer Management

Search for an Existing Customer

To create an order tied to an existing customer, click the Customer Search button at the top of the screen.

Enter your search criteria and click the search button to find the customer.  One or more listings (if found) will be displayed. 

Click to select the appropriate one. 

Selecting a Customer Profile Address

Most customers will have more than one address.  After activating a customer profile,the addresses button will appear above the shipping and billing sections.

Clicking an Address button will list all addresses associated with a customer profile.  Click an address to load it into the order.

Address Standardization

In the Billing Address and Shipping Address section, the blue 'S' Button to the right of the Address 1 field, is the "Standardize" button. Clicking this button will open a popup window that will show the address as entered and the suggested address based on the U.S.P.S. Address Standardization API. You can use this to update the enters address to match the way it appears in the U.S.P.S. database. 

The Standardize pop-up will appear like this:

Smart linking by Email

Simply using an existing customer's email is not enough to activate their profile! You must explicitly activate the customer. This is done to protect you, the merchant, since customer profiles are often tied to price discounts.

If you enter an email belonging to an existing customer, a link icon will appear next to the customer.

Clicking on the link will activate the customer profile for the current order. 

Creating a new Customer Profile

Creating a new customer profile is a passive act.  All that is required beyond a normal order is a password.  If you supply a password, then a customer profile is created when the order is placed.

You cannot change passwords with this field. You may only establish new customers.

The password field is disabled if there is an active customer present. This is to reinforce the "create only" nature of the field.

Removing a Customer Profile from an Order

To remove a customer profile from an order, click the Clear Profile button next to the profile indicator at the bottom of the shipping address section.

SMS Opt-in

The customer can be opted into SMS for enhanced shipment tracking as well as SMS marketing campaigns and flows via Storefront Communications.

Miscellaneous Section

Field Description
SBT/StorefrontSelect the SBT/Storefront with which the order should be associated.
RTG CodeIf you have rotating gateways configured, use this field to assign the gateway that should be use to process the order.
(If not selected, the gateway will be selected based on the traffic allocation or item level assignment.)
Advertising SourceIf applicable, select the advertising source from the drop-down list. 
Affiliate Priority CodeThis field is used to validate the a priority code that is provided by the customer.
For more regarding affiliate priority codes, see: Merchant Links#PriorityCodeScript
Pricing Tiers

Manually assign a pricing tier pricing to the order.

If no discount is applied by the pricing tier then the items on the order will not be assigned to said pricing tier.

This option only works if there is a discount applied to the items.

Gift MessageFor gift orders, enter the gift message here.

To apply regular coupon(s) to an order, one at a time, select the coupon code from the drop-down list.
To apply a one time use coupon code(s), click the pencil icon, then enter the one-time coupon code into the pop-up dialog window.

Gift CertificateWhen applicable, enter the gift certificate here.

Payment Processing

At the bottom of the BEOE application is the payment processing section.  There are a series of buttons that look like this:

To select the particular payment method that the customer would like to use, click on the blue button.  It will turn gray once selected.  Each method is described further below.

Credit Card

Credit card is your most popular form of payment.  The credit card number field can contain dashes if you like to enter the card number in that format.  While the CVV2 (Verification Number) may be required for your regular customers, you do have the option to not require it in the BEOE application.  This will skip the validation on the UltraCart side of the processing.  You payment gateway may still decline the order for CVV2 not present depending upon how it is configured.  The three checkbox options are worth elaborating on further.

No real-time chargeThis will capture all of the order information and send the order to Accounts Receivable for review and later processing. Please note that when using this option, the CVV2 will not be stored on the order for PCI compliance reasons.
Skip processingWhen this option is checked the order skips the payment processing phase and moves on to shipping. This means that you are not collecting any further payment from the customer.
Skip Fraud ScoreWhen this option is checked, all of the fraud prevention rules that you have configured on the account are bypassed.


Use this method when taking cash payments are a customer present environment.  For example if you are processing orders at a trade show booth with the BEOE running on an iPad.


When this method is used, the order will be sent to Accounts Receivable and the customer will receive a receipt with mailing instructions for the check payment.

Purchase Order

This method is great for your business customers that are allowed to purchase on credit terms.  Often times they want to provide a PO # to associate the order with.  Normally the purchase order will be approved or held for review based upon the settings of the customer profile, but you can choose to automatically approve the order by checking the box.


If the customer would like to pay with an e-check, then enter the information that they read to you off the credit into the fields provided.  You must have a payment gateway that supports e-check in order to use this feature.  For example Authorize.Net has an e-check processing option.


The final method is a quote.  This is useful for taking orders from large customers where you will need to further tune the prices, shipping, etc.  Once the quote is approved it will be sent to the customer where they can then pay for it.  If you're going to send the quote immediately, you can enter the quote expiration into the field and then click the send quote immediately button.

Printing an Order

When an order has finished, a receipt will display on the screen for easy printing.

Troubleshooting Shipping Tool

The back-end Order Entry tool is useful for troubleshooting your shipping configuration. Upon calculating shipping you find a hyperlink that will appear just below where the available shipping methods would be listed titled "Packing Solution". This link will provide you a snapshot of the underlying details used to perform the shipping estimate calculation.