Yahoo!

Order Management Module

Direct Feed
Setup and Daily Use
Prerequisites:
1. A Yahoo! Store, Yahoo! Pro or Enterprise account to use Yahoo! Real Time Link
(recommended) and a login ID that has the appropriate access rights.
2. Mail Order Manager 5.4 or later with the Yahoo! Order Management Module.
3. An intermediary server ( a server provided by a hosting company, or your own server with a
public IP address) for file hosting and FTP access.
4. A Secure Socket Layer Certificate may be required to allow secure access to ASP files. It is
required if you would like credit card information to be passed to the XML order file.

Yahoo! Direct Feed Block Diagram

The Intermediary
Yahoo! Server IS NOT
Store Hosted by
Dydacomp
4

1
Intermediary Server
GetOrder.asp
Inventory.asp
Order.asp
Order XML files

2
3
3 1 4

Legend
Symbol Count Description
1 M.O.M User
1 Internet Customer
1. Red – Downloading Orders Via Real Time Link

2. Purple – Download Orders Via Flat File (XML)

3. Orange – E-mail Tracking Update

4. Blue – Real Time Inventory Synchronization

1
Block Diagram Feature Descriptions

Feature #1 – The M.O.M. user wants to download Yahoo! Orders via Real Time Link. When he/she
chooses this option, M.O.M. calls the script files located on the intermediary server to pull the
XML order files from the FTP location. At this time, these XML order files are imported into
M.O.M. and deleted from the intermediary server. An exception report will be generated if there
are any import mismatches.

Feature #2 – The M.O.M. user does not want to use the Real Time Link to download orders. He/she can
still export orders out of the Yahoo! Store in XML format. Once orders are exported they must be
placed in the Yahoo subfolder in the Momwin folder. Choose the option “Download New Orders
via Flat File (XML)” to start the import.

Feature #3 – The M.O.M. user wants to send an e-mail tracking update to the buyer about his/her package.
When the order has already been shipped in M.O.M. and this option is chosen, M.O.M. will send
an e-mail with the tracking information to Yahoo! Once the tracking information is processed
Yahoo! will e-mail the customer the tracking information.

Feature #4 – The M.O.M. user wants to synchronize inventory between M.O.M. and his Yahoo! store.
When this option is chosen, M.O.M. will send inventory information to the Yahoo! for all
products that are marked as available for Yahoo! with Units available to sell. This inventory
quantity will show up when the buyer adds an item to their basket.

Please Note: If you do not use the Yahoo! Real Time Link please skip the Yahoo! Store setup (pages 4-5)
and continue through the setup. The section entitled Processing Download New Orders via Flat File
(XML) contains the procedure that allows XML order files to be imported into M.O.M.

Workstation Setup

1.) Navigate to www.dydacomp.com.

2.) From the main menu, select Support Login and choose Log into Dydacomp Tech Support.

3.) Log in by entering your M.O.M. License # and Zip Code and choose Verify.

2
 4.) Select Miscellaneous Utilities and choose Go. (Note: Your version of M.O.M. will automatically
be selected for you based on your license information.)

5.) Under the list of utilities, select the Yahoo! Direct Feed Utility.
6.) Once yahooutility.exe is downloaded you can double click the file and follow the onscreen
instructions to extract the files. By default the utility looks to extract these files into
“C:\Momwin\Yahoo”. Change the path to match the path to your Momwin folder, be sure
that the “\Yahoo” remains.

Please Note: These asp files have to be placed on the intermediary server and allowed access over the
Internet via a secure socket layer (SSL certificate), if you wish to import in the full credit card
number to be charged in M.O.M.
Yahoo! Store Setup

1.) Navigate to http://smallbusiness.yahoo.com/

2.) Select Small Business and login.

3
3.) If on the Small Business Home Page, choose Store Control Panel.

4.) Click on Real Time Link under the Order Settings section. You may be prompted to enter your
Security Key.
5.) Under Real Time Delivery you need to specify the location of Order.asp. The web address to
Order.asp should be from your Yahoo! store. For example
https://yahoo.usasportinggoods.com/Order.asp

6.) The format should be XML. Delivery Rate should be One at a time.
7.) Under Real Time Inventory Checking you need to specify the location of Inventory.asp. You
can additionally specify options on how to display inventory, whether or not you want to allow
orders if the quantity exceeds availability, and to accept or reject orders based on server
availability.

4
 8.) Once you are finished with the other options click on Update.
9.) Select Configure Inventory under the Order Settings section.
10.) Choose Real-time Inventory and specify the location of Inventory.asp under Settings->Call
Script. Again you can set options for Display Inventory Column, Quantity can Exceed
Availability, and If my server is unreachable.

Please Note: If the “Yes with Quantity” option is chosen for the Display Inventory Column and the
“Real Time Inventory Synchronization” feed is processed, customers will be able to see accurate
product inventory when products are added to their shopping cart.

M.O.M. Setup

1.) Open M.O.M.

5
2.) In the Main M.O.M screen go to Options->eCommerce Management->Define eCommerce
Settings.
3.) Click on the Yahoo tab.

4.) On the General Information Tab, you can enter the Yahoo! Store Account Name by logging
back into your Yahoo! account and clicking on Store Account Info under Site Settings.

5.) Within Store Account Information, you will see Store Account Name. This is the Yahoo! Store
Account Name. Also Store Title corresponds to Yahoo! Store Title. You can add the Yahoo!

6
 Store Account by selecting Add a New Store. Skip steps 6 & 7 if you do not have Use Shipment
Tracking features enabled in Yahoo!.

6.) To add the Email Tracking Password go back to your Yahoo! account and click on Shipment &
Order Status under Order Settings.

7.) On the next screen check the option Use Shipping Tracking Features under Shipment
Tracking. Then click on Email Tracking Password under XML Updates.

8.) Now go back to M.O.M and click on the Real Time Link tab under Yahoo in the eCommerce
Merchants Settings. Since you have entered in the Yahoo! Store Account Name, fields like
Script URL FTP Server Name, Username will be selectable. Script URL should be the location

7
 of the ASP files. For example https://yahoo.usasportingoods.com. You need to enter in an FTP
server name to handle file addition and deletion with regards to importing Yahoo! orders. Ideally it
should be what you’ve entered in the script url. Using the example the entry would be
yahoo.usasportingoods.com. Do not enter “ftp://’. You can also enter in the IP address. Then
proceed to enter a username and password to log into that FTP.

9.) Now click on the Test Connection to Yahoo! Real Time Link button to test the connection.

10.) Below the Yahoo! Real Time Link – Secure Web Server Setting are the options for Default for
Downloading Orders from Yahoo! Enter a default shipping method and a product on the fly,
these fields are required these will be used by M.O.M. for orders that have shipping methods or
products that are not recognized by M.O.M. Click Save when you are done.

11.) Select the default Payment Method to be used for payments that are not recognized by M.O.M.

12.) Use the Yahoo Order Activity Report button to see a listing of reports generated by Yahoo.

8
Shipping Method Setup

1.) To access the shipping method creation in Yahoo!, return to the Yahoo! store account. Under
Order Settings choose Shipping Manager.

2.) On the next screen chose Shipping Methods.

3.) On the next screen it will show any shipping method that has been created. Click on Edit
Methods. On the following screen you will be able to create a new shipping method by typing in
the shipping method code and clicking on the Add button. It is recommended that you name the
shipping method by using a three character code followed by a dash and then the description of the
service. In the following screen shot below you can see UPS-Ground Residential. Do not make
the Yahoo! shipping method names longer than 50 characters.

9
 4.) To change the rates of those newly created shipping methods go back to the screen where you
chose Shipping Methods and choose Shipping Rates instead.

5.) In M.O.M, it is critical that you begin the shipping method description with “Yahoo ”. There is a
space after Yahoo and then you need to follow it with the name of the shipping method. In our
example we have “Yahoo UPS-Ground Residential”.

Payment Method Setup

Please Note: Users of the Yahoo! recommended payment processor Paymentech will be able to import
orders with a credit card approval; otherwise you must process credit cards through Mail Order Manager.

1.) To access the shipping method creation in Yahoo!, return to your Yahoo! store account. Under
Order Settings choose Payment Center.

2.) On the next screen click on Add/Edit Payment Options.

10
3.) On the following screen, you can add a payment option and change the display order. There
should already be some pre-defined payment methods.

4.) Below is a listing of the currently supported payment methods

-Visa
-American Express, Optima
-Discover
-MasterCard
-Diner’s Club, Carte Blanche
-JCB
-Eurocard, en Route (other private label credit cards)
-Purchase Order (will come in using the Invoice payment method)
-Bill me (will come in using the Check payment method)

5.) Yahoo! matches the Payment method against the M.O.M. Type of Credit Card.
• If you are using Purchase Order the order will import with invoice as the payment
method.
• If there is no match against any of the payment methods it will come in with an invoice
payment method.
• If there is a match against multiple credit card payment methods it will import with the
first credit card it matches against.

11
Product Setup

Each product that will be sold on Yahoo! must be checked as Available for Yahoo. M.O.M. provides tabs
that can be used to enter the Yahoo ID, the Yahoo Code, option code and option values that will be then
published to Yahoo!. M.O.M. looks to match products based on the Yahoo ID and the Yahoo Code. If you
have an existing Yahoo! store with your items already created you can put the item’s Yahoo ID in M.O.M.
to match stock #s between M.O.M. and Yahoo!. The product on the fly is used if there’s no match between
M.O.M. & Yahoo!

1.) On the Main Menu Bar, click on Product >Maintain Stock Items.
2.) Select or Create a Product you wish to publish to Yahoo!, then click on the eComM tab and then
select the Yahoo tab. Check the option Product Available for Yahoo.
3.) Both the Yahoo ID and the Yahoo Code are required for publishing.

12
4.) Click on the Extended Information tab to enter any of the following information: full
description, headline, abstract, or label.

5.) The Options tab will only be enabled for size/color items. You can only enter in characters,
numbers and the dash symbol for the Option Code.

13
Note- this is an optional code for size/color variation items. If option codes are not used, size/color options
will appear under the custom information for that line item in M.O.M when the order is imported. This will
be covered further in the Yahoo! FAQ. Click the Save button to save the item information.

6.) When all Yahoo! Products are setup, return to the Yahoo! eCommerce Settings Screen. In the
Main M.O.M screen go to Options->eCommerce Management->Define eCommerce Settings.

7.) Click on the Yahoo tab.

8.) Select the Export Product & Inventory Files to Yahoo!

14
Please Note: The Inventory file should only be created if you do not intend on using the Real Time
Inventory Link feature. Check the necessary product and inventory options, use the … button to select
a location and name your export files.

15
Uploading Product Information

1.) Return to your Yahoo! Store Control Panel.

2.) Select the Catalog Manager.

3.) In the Catalog Manager screen, select the Upload Items link.

4.) Select the Upload button.

16
5.) Select the Browse button and select the stock file exported from M.O.M. Make sure the Add
option is selected and default-table is displayed in the drop-down menu.

6.) With the file selected, choose Upload. Review a few records using the View Records section of
the screen, then select Commit when finished.

7.) In the Add Confirmation screen, choose Add.

17
Uploading Inventory Information

Users who do not wish to use the Real Time Inventory Link feature, can upload a flat file from M.O.M.
See Step 9 in the Product Setup section for instructions on creating the Inventory upload file.

Please Note: You must have your store set to use Database Inventory before you can upload Inventory
Information to Yahoo! From within your Store Manager screen, click on Configure Inventory in the
Order Settings column, and select Database Inventory as your inventory option

1.) Return to your Yahoo! Store Control Panel.

2.) Select the Catalog Manager.

3.) In the Catalog Manager screen, select the Track Your Inventory link.

18
 4.) In the Inventory screen, select Upload.

5.) Use the Browse… button to select the inventory file exported from M.O.M. Select Upload when
finished, then select Save.

Daily Use

The eCommerce Management Station allows you to manage the different Order Management Module
Feeds and the sequence in which each feed is processed. If you have multiple Order Management Modules,
you can mix the different feeds from each module on this screen.

1.) On the Main Menu click on Options >eCommerce Management >eCommerce Manager’s
Station
2.) Optionally, select a feed and click on the up or down arrow buttons to change the sequence that
each feed will be processed in batch.
3.) Select Save to save the changes to the sequences, or Restore Default to change them back to the
sequence set in the Merchant Settings.
4.) Optionally, check the box to Continually Upload and Download Data Every ____ Minute(s),
and specify the minutes. This will make the eCommerce Manager’s Station process the feeds at
the time interval that you specify.

Please Note: In order for this to work, the eCommerce Manager’s Station needs to be left open
on a workstation.

5.) Choose Process One to process just the selected feed, or choose Process Batch to process all the
feeds in sequence.
6.) Click on Print to print the exception report, listing product publishing and order import exceptions

Please Note: You may choose to exit the eCommerce Manager’s Station by clicking on the Close
button. However, if there are any publishing or import exceptions, the eCommerce Manager’s
Station will always prompt you to print the exception report before exiting out.

19
Yahoo! Order Management Feed Manager

Please note: If you are not using the Yahoo! Real Time Link and plan to use the Download New Orders
via Flat File (XML) jump to section Processing Download New Orders via Flat File (XML) directly
below; otherwise skip to the Processing Yahoo! Feeds section on page 21.

Processing Download New Orders via Flat File (XML)

1.) To start the process of exporting orders from Yahoo! you will need to log into your Yahoo! store
account. Navigate to http://smallbusiness.Yahoo.com/
2.) Select Small Business and login.

3.) Click on the Store Control Panel listed under modules, you will be taken to Small Business
Home.

20
4.) Click on Orders under Process. This will bring you to the following screen:

5.) Use the View option to check which orders you want to export.
6.) Enter in the order number range across from the Export option
7.) Do not click on the Options button, which applies to the M.O.M. Yahoo! Stores flat csv file.
8.) Choose XML as the format type and then click Export.
9.) Once you click on Export you will be able to see the contents of the XML file. If you are using
Internet Explorer 6.0 go to File->Save As. The default should be orderlist.xml. If you are using
Internet Explorer 7.0 go to the Page button and choose Save As. If you have Firefox go to File-
>Save Page as. Make sure the type is “Web Page, XML only”.
10.) This XML file must be placed in the Yahoo directory within your MOM folder on the server
before you can process the Download New Orders via Flat File (XML) feed.

21
Processing Yahoo! Feeds

1.) On the Main Menu, click on Options >eCommerce Management >eCommerce Manager’s
Station. The eCommerce Manager’s Station is displayed.

2.) Choose the feed you wish to process and click on the Process One button, or click on the Process
Batch button to process all the feeds in sequence.

Yahoo! Feed

Feed Title Description

Download New Orders via Real Retrieve new orders on your Yahoo!
Time Link store.

Download New Orders via Flat Import orders via an XML flat file.
File (XML)

Email Tracking Update Sends a notification to Yahoo! when an

order has been shipped.

Real Time Inventory Matches the inventory in Yahoo! with the

Synchronization inventory in M.O.M.

22
FAQ (Frequently Asked Questions)

1. Do promotions work with the Yahoo! Order Management Direct Feed

Module?
Yes, as long as they are set up in the Yahoo! store. Upon import, the
promotions will show up as additional line items in M.O.M.

2. What about gift certificates?

Gift certificates are not supported with this module.

3. What are the Product Option Codes? Why do you allow only three?
The Product Option Codes are selection criteria that enable the Yahoo!
customer to select a specific size or color of the product. For example, if you
have a Yahoo! store that sells men’s dress shirts, you may want a way to
select a particular shirt based on collar size, sleeve size, or brand. Product
Option Codes are recommended if you have stock inventory for each
particular size/color variation. If you choose to use the Product Options Codes
but do not associate the MOM product with the Yahoo! product with an
option code, these items will import in with the product option codes listed in
the line item detail of each ordered item.

4. I still do not understand Product Option Codes and Option Values in

M.O.M. What do they correspond to in the Yahoo! store?
The M.O.M. screen shot below depicts the product, option codes, and option
values within the eComM tab in M.O.M.

The Yahoo! product page screen shot shows the options for this product

23
Under the “Options” section in the screen shot above “Size” is followed by
“Sm” (Small) and “Lg” (Large). “Size” is the general option category while
“Sm” and “Lg” represent possible options under the “Size” option category.

This matches to the “Product Option” 1 or 2 or 3 and “Option Values” in

M.O.M. respectively. It is required that the combination of “Option Values”
be a maximum of 10 characters in order for stock items to match correctly
between M.O.M. and the Yahoo! store.

5. What if the stock item imported from Yahoo! does not match any
stock item in M.O.M. what happens?
If the stock item does not match, the item on the fly will be used in its place. If
this item has a size/color variation it will appear in the custom information
under the line item detail tab.

6. There are ASP files included with the setup of the Yahoo! Order
Management Module. Can I alter the code within those files?
Unfortunately we cannot support the altering of the ASP code in the Yahoo!
Order Management module files.

7. If I am using the Download New Orders via Flat File (XML) feed,
what happens if I place duplicate XML files in the Yahoo folder?
There is a built in check to see if you have previously downloaded that
particular Yahoo! order(s). If that order already exists in the system, it will not
be imported in twice.

8. Can you pass Yahoo’s inventory levels to M.O.M. when using the Real
Time Inventory Synchronization?
No, all inventory levels originate from Mail Order Manager. Also the
inventory levels you pass from M.O.M. to the Yahoo! store are only reflected
on the cart level when a customer adds an item.

9. Why must these script files be hosted outside of the Yahoo! servers?
It is a requirement by Yahoo! if you want to use the Real Time Link feature.
Yahoo! does not allow script files to be hosted on their servers.

10. The test connection Yahoo! Real Time Link failed why?
Make sure you have followed the instructions about the setup. Also do not put
“ftp://” in front of your address, e.g.ftp.usasportinggoods.com, when you enter
the ftp address. Lastly check your computer or network firewall to make sure
inbound and outbound connections to Mail Order Manager are not being
blocked.

11. What happens if the ASP script files are not hosted on a secure
connection?

24
The credit card numbers for customer payment will not be imported into
M.O.M. Yahoo! checks to make sure it is a secure connection before posting
order information to the FTP location. If it is not secure, only the first two and
last four digits of the credit card numbers will be passed over. Everything in
between will be marked using a * symbol.

12. Can I import Yahoo! orders that come from a foreign country?
Yes, you can but make sure you have an appropriate foreign shipping method
created in M.O.M. with the appropriate zones. M.O.M. will look to make a
match with the shipping method and zone. You still may get an exception
report for some orders with foreign countries that do not have a state or
province.

13. When I import Yahoo! orders that are paid by PayPal, why is the
PayPal Account ID blank?
Currently Yahoo! does not receive or store the PayPal Account ID once
customers issues payment in their PayPal account.

14. Why do we receive posting notifications from our Yahoo! store like
the one below?

Sometimes when a customer finishes placing an order, the XML order file
will not get posted to the ftp location. You must use the “Yahoo – Download
New Orders Via Flat File (XML)” feed to import this order into M.O.M.
Remember you must first export this order in XML format and then place the
XML order file in the Yahoo sub-directory. Then process the feed. Is there a
“not too technical” reason for this?

15. If a customer places an order with multiple line items, why won’t the
order status update properly?
We are aware of this issue and have contacted Yahoo! about it.

16. What happens to orders with non-supported payment methods when

they are imported into M.O.M.?
For any orders that do not match any of the supported payment methods they
will come in with the invoice payment method.

Modified 03/31/09

25