Category Archives: New Features

User Experience Open House – Part Deux

openhouseIn the last few years we updated and polished the look and feel of our web site and branding but the actual product’s look and feel hasn’t gotten a lot of love from our design team. That’s about to change in a major way – we’re working on a significant refresh of the MerchantOS look-and-feel and we want to get your input early and often as we work towards releasing this exciting update to MerchantOS.

We will host our second online “User Experience Open House” on Tuesday, April 16, 2013 at 3:00 PM (PDT). This is where you can see a preview of the new user interface, ask questions and make suggestions about what you’d like to see in both this current project and future ones.

Technical Note: We’re reworking our online presentations to (hopefully) offer much better audio and video quality as well as high-quality recording so you can check out the open house content later even if you can’t make it to live event.

New Feature: Master Order

Centralized ordering has come to MerchantOS! The model behind this feature is having one location (warehouse or distribution center) that handles everything your business needs to (re)order across all shops. The Master Order feature can be utilized by single location shops to easily manage orders between multiple vendors.

It wasn’t impossible to do this before, it just wasn’t easy. What I’m about to cover now is just how easy it is to order inventory from one location, yet manage multiple stores. If the shelves are looking bare at your shop, you can use transfers to place your order from your warehouse instead of your vendor. This can save your business the shipping expenses and the time it takes to manage your warehouse.

Read all about Master Orders in MerchantOS Help →

While we do have a help article covering the basics, I’m sure some of you will have questions or feedback about Master Orders. Feel free to leave them in the comments below or contact support at support@merchantos.com or chat now with one of our reps.

Cheers!

Better Tagging!

Tagging gives you the ability to organize your products by putting them under one or more tags. We’ve had the ability to tag items for sometime but with the next release you’ll be able tag customers and filter most reports by tag.

Filtering

In listings you can now filter for records with and without tags. For example you could find all items tagged “food” and exclude all items with the tag “organic”.

Tag:Groups

We’ve also added tag groups. Simply prefix any tag with a group name and “:”. For example you might tag a few items with the following tags: “bike:road”, “bike:mountain”, “bike:bmx”. If you searched for “bike:” in the item listing, you’d see everything tagged with the “bike” group. If you searched for “bike:bmx”, you’d see just items tagged with that specific tag.

Customer Tagging

Customer records can now be tagged! You can use tag groups with customers as well. You might use tags to separate customers into lists you will target with various marketing campaigns.

Removing: Season, Department, Shelf Location, Model Year

New accounts will not have season, department, shelf location, and model year. Existing accounts will keep all of these fields for now. Down the road we will be migrating data stored in these fields into tags, and eventually turning these fields off for all accounts.

You will be able to choose when to make the transition for your shop during a transition period. You’ll receive notices and instructions on how to convert when it’s time. All the filtering you do now with your the existing fields will be possible with tagging and more.

We’ll do our best to help all customers with the transition to tagging.

Serial Number Tagging

We plan to add tagging for serial number records in the near future. This will help track the status of serial numbered items that may need to be built or have other statuses.

The BIG Template Update

Luke Stached Away These Template Updates

While some of you have been enjoying personalizing your receipts and labels there was a large demand for several changes that needed to be implemented. The main criticism of receipt templates was that the credit card receipts did not print out a signature copy. Great news, that works now.

We fixed some other buzz-killing issues in our latest revamped template code:

  • Per-line discount is now a special template in GitHub. You can show the breakdown of each item if they have varying levels of discounts. In the default.tpl it just groups all the discounts in the subtotal.
  • Timezones are now accurately reflected. This was only broken for a very small window, but it didn’t go unnoticed.
  • Fixed the requirement for HTML <br> tags in shop headers. If you have those in Admin > Shop Settings / Setup Shops > Receipt Setup, you’ll want to remove them.
  • Account Deposits and Charges now shows correctly.
  • Fixed an odd formatting issue that involved padding – this should correct the issue where wouldn’t utilize the full paper width.
  • Gift Receipts never revealed prices, but they would show discount names, now they won’t (this is true of non-template generated receipts as well).
  • Remaining balance now displays the correct amount. Earlier it did not subtract the amount On Deposit from the Open Orders.
  • Totals for Open Orders now include the discounts.

It was a long road to fixing all of these and it wouldn’t have been possible without the awesomeness that is Luke Bowerman. It only took a few weeks of Luke’s time, a kilometer of receipt paper, and several death threats by mail directly to our office to fix these issues but that’s all behind us now. There is a lot of potential in using templates to personalize your storefront. I recommend starting with our default.tpl, see how it looks and then move on to one of our other print templates or start editing your own.

One note: our support staff cannot help you with designing custom templates - we love all our customers but designing custom templates is simply too time-intensive for us to offer. If you’re having issues with printing receipts we should be able to help, we just can’t help with per-customer tweaks to the templates. With that said don’t hesitate to send us an email or give us a call at 866-554-2453 ext. 0

Cheers!

Giant Bicycles Real-Time Stock Check

Things have been busy around MerchantOS lately and we’re proud to announce a new feature for our integration with Giant Bicycles. We have added real-time stock checking to purchase orders with Giant when you use our integration with them. Previously we updated stock information once daily. By the time you created your Purchase Order in MerchantOS the stock levels could have been hours out of date.

Real-time stock checking will allow you to see the actual stock availability for the products you are ordering as you are creating your order. This allows you to know if a product would be back ordered or if there are more available for you to purchase for your shop. You can find information about setting up the Giant integration in the MerchantOS Manual.

We are also working on several updates to existing integrations and a few new vendor integrations in several different industries. Check back on our blog for updates as we release them.

New Login Page

You’ll soon be greeted by a different looking login page. Don’t panic, nothing catastrophic has happened. Here’s what it will look like:

You may also notice that when you login you are directed to a different URL (address) than before. Something like “east1.merchantos.com” instead of the normal “shop.merchantos.com”. We’re making this change so we can better handle our growing customer base and give you better reliability.

We’ve found that the biggest reliability issue is your internet connection. Sometimes your provider will lose connectivity to a portion of the internet, and sometimes this includes the data center where our system runs. We’ve designed the new login page to help work around these problems. After we phase in the new look/feel of the login page we’ll be turning on this new feature.

Use Your Email Address As A Login

We’re switching to email addresses as the primary way to login in to MerchantOS. For now this is optional and you can keep your normal login name. But we are going to encourage you to go to Admin->Employee Setup and change your employee logins over to their email addresses.

Why? We are adding the ability to reset your password via email. The easiest and most straight forward way to do this is to have your login name be your email address. This is also becoming a fairly standard practice across the internet so this should be comfortable to most users.

We are also implementing a Users email list that you will have the option to subscribe to. We’ll email you about once every 3 months to let you know about changes to the system and other important news. We won’t spam you every day or week with it. Promise! You can unsubscribe at any time.

For The Geeks

The login page uses some clever javascript to detect which of our data centers you have connectivity to. It will then direct you to our preferred datacenter if you can connect, but if you don’t have connectivity there it will use a proxy in our secondary data center to get you there. This means that if you can connect to at least one of our data centers you’ll be good to go.

At first we are just turning on the new look/feel of the login page but keeping it hosted at our primary data center. Meaning this new whiz-bang functionality won’t get you much benefit. But over the course of the next month or so we’ll be moving the login page to a more high availability setup that you should be able to access even if you have limited internet connectivity.

Exporting UPC’s to Shopify

Using the Shopify integration, MerchantOS can keep your product descriptions, cost, and inventory in sync between the physical inventory in your store and your E-commerce storefront. We’ve had several requests from our customers to send more information, like the product’s UPC, over to Shopify.

With our latest release we are now sending product UPCs, EANs, manufacturer product numbers, and custom SKUs to Shopify in what are known as Metafields. Metafields are a special object on Shopify that allow us to store information that otherwise isn’t supported in the Shopify API. Metafields are not visible in the Shopify interface, but they can be accessed using the Liquid templating language.

Metafields have a namespace and are attached to specific resources in Shopify. We are using the “merchantos” namespace to send our Metafield information and are attaching it to variants.

So to display the UPC information for all of a product’s variants in your Liquid template you could use code similar to:

 {% for variant in product.variants %} {{variant.metafields.merchantos.upc}} {% endfor %} 

You must save a product in MerchantOS for the new Metafields data to be exported.

We are always looking for ways to improve our integrations, and appreciate your feedback. We are working on more improvements to our Shopify integration and will be posting more information when it becomes available.

If you have any questions feel free to contact us.

API Updates

We’ve been getting lots of great feed back about our API. There are several projects that have been using it and we’ve been working with them to answer their questions and solve some problems that they have been running into.

In our latest release we’ve made a few adjustments to how the API works. None of these changes should break compatibility.

Reduced API Rate Limit Penalty

We had a penalty included in our API for when an application went over their call limit. We had found that this penalty was too harsh and we’ve reworked it to allow applications using our API to hit the call limit occasionally without penalizing them.

Return 503 When Over Rate Limit

Previously we had been returning a 500 error when an application went over it’s call limit. We’ve changed that to a 503 Service Unavailable error as that better reflects the error.

JSON input and output

We’ve also been working on adding JSON input and output for requests. Previously we could output JSON, but now we can accept JSON for requests that require a request body.

Disabled WWW-Authenticate header for AJAX Requests

If you are sending an AJAX request we will no longer be sending the WWW-Authenticate header as this causes UI issues with browsers. All other clients will still receive the WWW-Authenticate header when their request could not be authenticated.

Setting a Default Limit on Listing Requests

Previously we did not page results by default. This was causing issues with very large result sets. Now listing requests (such as requesting all items) will by default return 100 objects per request. This behavior can be over-ridden using the limit and offset query parameters (see the API search manual page: https://manual.merchantos.com/index.php/API_Searching). We are also returning the total count of objects, the current offset and limit for a request as attributes on the outer object tag when we automatically limit a request.

Tagging

We have added the ability to write tags through our API. Objects supporting tags (currently only Items) will have a Tags element containing the tags on the object if there are any. The count of the tags will be returned as an attribute of the Tags element.

Tags can be added to an Object by adding xml similar to below:

<Tags>
    <Tag>
        <name>foobar</name>
    </Tag>
</Tags>

The tag does not have to already exist in the account you are accessing, it will be generated when your object is submitted.

All Tags can be accesses through the new Account/<AccountNumber>/Tag endpoint. This will show you how many tags there are as well as what objects are associated with that tag.

Bug fix to IN queries

We fixed a bug that was preventing queries with the IN search operator from executing properly. Queries like the following should now execute:
https://api.merchantos.com/Account/<AccountNumber>/Item?itemID=IN,[2,4,6,8]

More Improvements to Come!

We’re open to your feed back. If you have any questions about the changes we’re introducing please feel free to contact us. If you are having a problem with our API let us know and we will work with you to resolve it. Thanks again to all of the developers using our API for their valuable feedback. We’re working on even more improvements and we will post again when they are released.

Templates. Have at ‘em.

templates

Templates you say?

Yes, templates I say. Our advanced users (read: tech savvy) now have a way of customizing print jobs from MerchantOS. This feature has been out for a few months now and I thought it’d be nice to give it some deserved recognition. It allows you to safely create a template for your sale receipts, product labels, transfer receipts, workorder receipts, and even purchase order receipts.

We have some stellar examples of templates in our GitHub repository to get you started making snazzier burn marks on your thermal paper.
 

What if I don’t want to make snazzy templates, how about practical ones?

Well fine! Let Uncle Sam down you unpatriotic heathens! For all you busybodies, templates are a great feature for you to experiment with. Want a Facebook footer on the bottom of your receipt? Done. Think we give too much customer information on our receipts? What do you say we hide your customers email and phone number for you? Want to include the Vendor ID on your labels? Ivan took care of that request for you.

 

WOW! Is there anything that templates can’t do for my shop?

As much as I’d like to write down “iron your clothes, babysit your kids and run your business for you” there are some actual limitations to the current build of our templates. If you are using integrated credit card processing you will notice you won’t be getting a signature copy. That is something we will be implementing in the near future. There are some other limitations, but a general rule – if it’s in the XML, it’s possible to display.

 

You didn’t answer all of my questions! Where can I find more information on templates?

Your first stop is our manual page.

If you need to learn more about the template language you’ll be writing in you can review the Twig documentation here.

Now that you understand what you’re writing in and how to implement this, the only thing you’ll need to supplement creating said snazzy templates is our API documentation.

 

We’re looking forward to seeing what you folks can come up with. Now do your patriotic duty and go make us all proud with your .tpl renditions that will help our staff get groped less by TSA agents. Or better your shop, I guess. If you feel like sharing your creativity you can send those templates to murdoc@merchantos.com and we’ll review the .tpl and host it on GitHub.

Cheers!

Automatic PO Check-in and Inventory Change Log

We’re excited to announce two new features: improved inventory logging and automatic inventory checkin for purchase orders (POs) and transfers.

How Automatic Inventory Checkins Work

When you sell inventory and you have none in stock, our system will now check if you have any inventory on your PO or transfers. If you do, the system will automatically add enough units from the PO or transfer to cover the sale. You can still check in the remaining inventory and complete your POs and transfers when you are ready. All inventory that has been automatically added from your POs and transfers can be seen in the new sales tab within the PO or transfer. For this feature to work, the PO needs to be in the status ordered or check-in. Transfers need to be in status sent.

Why is improved inventory logging important?

Every single change to your inventory is now recorded in a log. We’ve also made it easy for you to see these logs and filter them into sets of changes (for example all changes made because of sales) or by individual changes (eg. inventory automatically added for a sale).

With the new logging functionality, you’ll always know how your inventory has been affected. Also our support will be able to know exactly what’s going on with your inventory and give you more informed answers to your questions.

What has changed because of inventory logging?

Some reports have been replaced with the inventory logs report. The Inventory Adjustments, Sales, and Purchases reports have been removed. The new Inventory logs report can quickly generate the same information for you.

In the item view you’ll notice the history tab is different. There used to be four listings for the ways the item’s inventory has been affected in the past. This tab now shows only the item’s inventory log which is all the same information but will be more detailed and easy to filter for all future inventory changes.

Wording Change On Special Orders

We have made no changes to the functionality of special orders but you will notice that we have changed the wording of a special order that is ready for pickup from “complete” to “ready” or “ready for pickup”. The term complete was causing some confusion about the entire special order being complete and given to the customer when really it just meant the order process was completed and the customer could now come by and grab their order.

Development Progress

We’ve been working hard to speed up our development cycle and I’m happy to say we are at a much more acceptable pace. Expect to see some more awesome enhancements and more of your feedback in our system soon.

What do you think?

Please share your thoughts and ideas in the comments section after you’ve had a chance to check out the changes.