This page describes how a merchant may enter orders using the back end secure.ultracart.com.
- 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.
You need a modern browser to use this web application properly.
Consider visiting http://browsehappy.com/ 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.
Back End Order Entry - allows a user to run the BEOE tool.
Edit Order - allows a user to edit an order.
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
- 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
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
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 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
Deleting a Template
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.
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
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 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.
Editing Quick Items
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.
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.
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.
|SBT/Storefront||Select the SBT/Storefront with which the order should be associated.|
|RTG Code||If 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 Source||If applicable, select the advertising source from the drop-down list. |
|Affiliate Priority Code||This 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
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 Message||For 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 Certificate||When applicable, enter the gift certificate here.|
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 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 charge||This 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 processing||When 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 Score||When 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.
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.