Difference between revisions of "Create New Facility"

From Opentaps Wiki
Jump to navigationJump to search
('''opentaps''' Store Setup)
('''opentaps''' Store Setup)
 
(11 intermediate revisions by the same user not shown)
Line 39: Line 39:
  
  
==Warehouse Setup==
+
==Create a New Warehouse==
  
 
From the Main Navigation screen proceed to:  
 
From the Main Navigation screen proceed to:  
Line 46: Line 46:
 
  * Click: [Create a New Warehouse]  link
 
  * Click: [Create a New Warehouse]  link
  
to be continued
+
This link is incomplete, use the method described in the previous section.
  
 
==Backup Warehouse Setup==
 
==Backup Warehouse Setup==
Line 54: Line 54:
 
=='''opentaps''' Store Setup==
 
=='''opentaps''' Store Setup==
  
'''Configuring Product Stores'''
+
====About the Stores in '''opentaps'''====
 +
The Store in '''opentaps''' is a database container for a group of your products sold together under the same policies. Your company can to set up multiple stores, each with its warehouses, fulfillment policies, currencies, languages, promotions, and look-and-feel. You can have  stores in different countries with various different policies, shipping, taxation or other rules. 
  
The “Stores” tab in the catalog manager is used to define all the properties of a working store, is a
+
The stores you set up can be for the support of various real stores, such as web-based businss to business stores, or consumer e-commerce stores, or internal order entry applications, and also Point Of Sale applications.
group of products sold together under the same policies. It is possible for a company to set up
 
multiple stores, each with its warehouses, fulfillment policies, currencies, languages, promotions,
 
and look-and-feel. These stores can web-based b2b or consumer ecommerce stores or to
 
internal order entry and POS applications. They could even be in different countries with different
 
shipping and taxation rules.
 
  
When you click on “Stores,” you will see a list of product stores that have been defined. Click on
+
====Where the Store(s) are Configured====
one and you will see several tabs for administering different aspects of that store.
+
To configure a Store, from the Main Navigation screen, proceed as follows:
Store. The main product store tab is used for defining general store properties:
+
Click: Catalog Icon > Stores Tab, the Product Store list opens, which is a table showing your
 +
    existing Stores, and can be used to select one for editing.
 +
Click: any Store Name (ID) in the table to edit all the properties of a working store.
 +
The "Store For your_store_name page" opens to the [Store] sub-tab showing a long list of store
 +
    attributes and several more tabs for administering different characteristics of that store.
  
* Primary store group id. What group this store belongs to. As mentioned in the section above on pricing, stores can be grouped together with a price for each store group. It can be left blank if there are no store groups set up. Store groups cannot be set up in the catalog manager and must be inserted directly into the database.
+
====Detailed Guidance on Store Set-up====
* Store name, company name, title, subtitle. Used for display on the product store's
+
Please see the User Guide Section [[Working_with_the_Product_Store(s)]] for details on store set-up. For details on set-up of the Website Store, refer to the section [[Web-Site_Online_Stores_for_your_Catalogs_and_Products]].
website.
 
*· Pay to partyId. A party (see Party Manager) where store payments will be credited to.
 
*· Days to Cancel Non Pay. There is an automated service that can be scheduled (see Job
 
Scheduler in Webtools) nightly to cancel orders which have not been paid. This defines
 
how many days an order can be outstanding and unpaid before it is canceled. A value of
 
zero here will leave all orders open indefinitely.
 
*· Prorate Shipping. Controls whether shipping charges from an order are billed to first
 
invoice of an invoice, or whether it is pro-rated on each invoice.
 
*· View cart on add. Controls whether the user get taken to the shopping cart immediately
 
after adding a product to his cart.
 
*· Auto approve reviews. If the site allows users to enter product reviews, this controls
 
whether the reviews must be approved (see “Product reviews” below), or whether they
 
are automatically shown on the site.
 
*· Inventory Facility Id. The facility (see Facility Manager) where the products sold on the
 
store are kept. Used for knowing where to change product inventory as items are sold.
 
*· Check Inventory. Once an order is placed, this causes the store to check for inventory
 
availability.
 
*· Reserve Inventory. Causes inventory to be reserved for items ordered in the store. The
 
inventory may still be on hand but will no longer be available for other orders. If there is
 
no inventory, new inventory items with negative quantities will be created. If you do not
 
reserve inventory, then you will not be able to create Shipments and assign order
 
items to shipments later.
 
*· Reserve order enum id. Choose how inventory should be reserved. The options are:
 
*· FIFO Received (default) – Inventory items are reserved based on the date time
 
received flag of Inventory Item. The earliest received item is reserved first.
 
*· FIFO Expire – InventoryItem with earliest expireDate is reserved first.
 
*· LIFO Received – InventoryItem with latest date time received flag is reserved first.
 
*· LIFO Expire – InventoryItem with the latest expireDate is reserved first.
 
*· Greater Unit Cost – InventoryItem with the highest unitCost is reserved first.
 
*· Lesser Unit Cost – InventoryItem with the lowest unitCost is reserved first.
 
Note that the unit cost reservation methods do not do currency conversions.
 
*· Requirement method enum. Used to specify a default type of inventory requirements
 
when the product does not itself have one specified.
 
*· Default sales channel. Used to specify the sales channel for the store’s orders.
 
*· Require inventory. If set to “Y,” products will automatically become unavailable when
 
there is no inventory in the facility.
 
*· Order number prefix. All orders will be prefixed by this. Useful for grouping orders from
 
multiple stores.
 
*· Default locale string. Default locale, for language, number, and currency formats.
 
*· Default currency uom id. Currency for the store's products.
 
*· Check gc balance.
 
*· Retry failed auths.
 
*· Header and item status. What to set order header and order items when orders are
 
approved, declined, or canceled. Based on the standard defined status codes in Open
 
for Business. By default, the codes used are ORDER_APPROVED and
 
ITEM_APPROVED and are set in OrderChangeHelper.approveOrder.
 
*· Messages. What messages to sent to the user when their order has been declined or
 
viewed as fraudulent.
 
*· Style sheet, logos, and background. For controlling the look and feel and a web-based
 
store. You can define the stylesheet (CSS) and images for the store here.
 
*· Show Prices with VAT. Useful in countries where the price includes VAT. Set to N in the
 
United States, where prices exclude sales tax.
 
  
Roles. Defines parties with specific roles for this store. For an employee to be able to take
+
'''Overview of Store Set-up and Configuration Items'''
 +
 
 +
The following Sub-Tabs offer functions that configure the store and how it will function:
 +
 
 +
'''[Store Tab]'''. Sets the values for a long list of store general properties which control how processing is to be done, and how various options are to be used.  For details, refer to [[Store General Properties Screen]].
 +
 
 +
'''[Roles Tab]'''. Defines parties with specific roles for this store. For an employee to be able to take
 
orders using the internal order manager application, he must be defined as a “Sales
 
orders using the internal order manager application, he must be defined as a “Sales
 
Representative” here.
 
Representative” here.
  
Promos. Shows a list of active promotions for this store.
+
'''[Promos Tab]'''. Shows a list of active promotions for this store.
  
Catalogs. Catalogs which are available for the current store and the sequence in which they are
+
'''[Catalogs Tab]'''. Catalogs which are available for the current store and the sequence in which they are
 
to be shown to the user in a navigation menu.
 
to be shown to the user in a navigation menu.
  
Web Sites. Websites which are related to this store. This is directly used to link a store to a web
+
'''[Web Sites Tab]'''. Websites which are related to this store. This is directly used to link a store to a web
 
application. Each web application has a configuration file called web.xml, and it is defined to
 
application. Each web application has a configuration file called web.xml, and it is defined to
 
reference a particular web site. The web site in turn is defined to relate to a product store. Thus,
 
reference a particular web site. The web site in turn is defined to relate to a product store. Thus,
Line 143: Line 97:
 
Apache httpd server instead of the embedded Tomcat server.
 
Apache httpd server instead of the embedded Tomcat server.
  
Shipping. This page shows the shipping options available to store customers. A list of shipping
+
'''[Shipping Tab]'''. This page shows the shipping options available to store customers. A list of shipping
 
options and their pricing is shown. Click on “View” for a shipping option shows all the settings for
 
options and their pricing is shown. Click on “View” for a shipping option shows all the settings for
 
this shipping option. At this point, this tab can only view shipping options available and not be
 
this shipping option. At this point, this tab can only view shipping options available and not be
 
used to define them.
 
used to define them.
  
Payment. This is used to set up payment processing for the store. The payment processing
+
'''[Payment Tab]'''. This is used to set up payment processing for the store. The payment processing
 
interfaces are defined as services. Each payment method will have a series of service types
 
interfaces are defined as services. Each payment method will have a series of service types
 
available to it, such as for authorizing, capturing, and refunding payment. This page links the
 
available to it, such as for authorizing, capturing, and refunding payment. This page links the
Line 154: Line 108:
 
credit card authorizations, another for credit card capture, and so forth.
 
credit card authorizations, another for credit card capture, and so forth.
  
Emails. This defines emails which the store would send to customers. The actual email services
+
'''[Emails Tab]'''. This defines emails which the store would send to customers. The actual email services
 
are either mounted in the controller, such as the order confirmation email, or from scheduled
 
are either mounted in the controller, such as the order confirmation email, or from scheduled
 
services, such as back order notifications. This page defines where the template for the email is
 
services, such as back order notifications. This page defines where the template for the email is
Line 160: Line 114:
 
can be left blank.)
 
can be left blank.)
  
Surveys. This page is for adding surveys to the store. Surveys can be associated with certain
+
'''[Surveys Tab]'''. This page is for adding surveys to the store. Surveys can be associated with certain
 
events or with products and categories.
 
events or with products and categories.
  
'''Setting Up Multiple Stores'''
+
==Setting Up Multiple Stores -- For Technical System Administrators==
  
 
It is possible to set up multiple stores in the system which sell the same products on different
 
It is possible to set up multiple stores in the system which sell the same products on different
Line 172: Line 126:
 
  1. Create multiple Product Stores in the Catalog Manager
 
  1. Create multiple Product Stores in the Catalog Manager
 
  2. Create catalogs and associate them with your stores
 
  2. Create catalogs and associate them with your stores
  3. Create WebSites in the content manager, and associate those Websites with your
+
  3. Create WebSites in the content manager, and associate those Websites with your ProductStores.
ProductStores.
+
  4. Copy the online store in applications/ecommerce/ to separate directories to your hotdeploy directory,  
  4. Copy the online store in applications/ecommerce/ to separate directories to your hotdeploy
+
      one for each store
directory, one for each store
+
  5. For each of your stores, edit its webapp/WEB-INF/web.xml file and change the webSiteId to point to one  
  5. For each of your stores, edit its webapp/WEB-INF/web.xml file and change the webSiteId
+
      of the WebSites you defined for your ProductStore.
to point to one of the WebSites you defined for your ProductStore.
+
  6. You can edit base/config/ofbiz-containers.xml to set up different Tomcat servers or AJP13 listeners on  
  6. You can edit base/config/ofbiz-containers.xml to set up different Tomcat servers or
+
      different ports, and then configure each of your stores to use a different server in its  
AJP13 listeners on different ports, and then configure each of your stores to use a
+
      ofbiz-component.xml file. At this point, each store can be configured to its own IP address or web URL.
different server in its ofbiz-component.xml file. At this point, each store can be configured
+
 
to its own IP address or web URL.
+
'''Navigation into the opentaps Setup chapter:'''
 +
 
 +
Manual pages >> [[Store General Properties Screen]]
 +
 
 +
Section pages >> [[Setup for opentaps email Handling]]
 +
 
 +
'''Navigation into the opentaps Fulfillment chapter:
 +
'''
 +
Manual pages >> [[Backup Warehouses|Create a Backup Warehouse]]
 +
 
 +
[[Shipping Process|Shipping Tab]] << Tab pages
 +
 
 +
[[Shipping Process|Shipping Processes]] << Section pages >> [[Warehouses Organization]]

Latest revision as of 13:22, 27 May 2010

_

_

Creating your facilities is part of the opentaps system configuration, often performed by a System Administrator. The general method (using the server URL/Facility) is the most flexible and general method for creating facilities and fully describing them, but there are also end-user methods, that do not require System Administrator assistance. These end-user methods can be used for creating retail stores, web stores, warehouses, and backup warehouse facilities. These methods are located in various parts of the opentaps system related to each facility type, and we will explain each one of them in the following sections. We will discuss the general method first.

Using the General Method for Facilities

The general method uses a section of the system which is located at the following address on your opentaps server:

 /facility/control/login
 (Example of the address might be this type of URL: 
     https/your_server_name:port_number/facility/control/login).
*  Using your system URL, and port number, open the /facility/control/login page and 
      log in to the system 
*  The "Facility Manager Application" screen opens
*  The screen displays the Facilities List of all your current facilities 
     (stores and warehouses).
*  Click: [Create New Facility] the Facility (ID:) screen opens with a blank ID.  You can name
     the facility or let the system give it a numeric ID, but note these special rules: 
     ** Names are case sensitive
     ** Names cannot contain blank spaces -- use the underscore (_) instead of blanks
     ** Names must not contain special characters or punctuation marks (except the 
        dash (-) is acceptable.
     ** Incorrect names will cause system processes to fail, so if you are not certain, 
        let the system provide a numeric ID for you.
**  Select the Facility Type ID from the drop down box, for example "Warehouse"
**  Enter or look up the Owner = a unit of your company, or a Supplier
     who is listed in your system under Purchasing > Suppliers Tab if the facility is owned by
     the third party.
** Optionally enter a Default Weight Unit
** Select Default Inventory Item Type either serialized on non-serialized
** Supply a text Name for your new facility
** Optionally enter a Square Footage value for the facility
** Enter a Description if desired
** Enter the Default (lead time) Days To Ship from this facility after a request.
*  Click: [Update] to create the facility

The "Facility your-facility-name" page opens with a full set of facility defining tabs, but no other entries are required in this section of the system, at this time. Your facility has been created and you can return to this page to add or edit the various tabs provided.


Create a New Warehouse

From the Main Navigation screen proceed to:

* Click: Warehouse Icon
* Click: [Create a New Warehouse]  link

This link is incomplete, use the method described in the previous section.

Backup Warehouse Setup

Refer to Backup Warehouses

opentaps Store Setup

About the Stores in opentaps

The Store in opentaps is a database container for a group of your products sold together under the same policies. Your company can to set up multiple stores, each with its warehouses, fulfillment policies, currencies, languages, promotions, and look-and-feel. You can have stores in different countries with various different policies, shipping, taxation or other rules.

The stores you set up can be for the support of various real stores, such as web-based businss to business stores, or consumer e-commerce stores, or internal order entry applications, and also Point Of Sale applications.

Where the Store(s) are Configured

To configure a Store, from the Main Navigation screen, proceed as follows:
Click: Catalog Icon > Stores Tab, the Product Store list opens, which is a table showing your
   existing Stores, and can be used to select one for editing.
Click: any Store Name (ID) in the table to edit all the properties of a working store. 
The "Store For your_store_name page" opens to the [Store] sub-tab showing a long list of store 
   attributes and several more tabs for administering different characteristics of that store.

Detailed Guidance on Store Set-up

Please see the User Guide Section Working_with_the_Product_Store(s) for details on store set-up. For details on set-up of the Website Store, refer to the section Web-Site_Online_Stores_for_your_Catalogs_and_Products.

Overview of Store Set-up and Configuration Items

The following Sub-Tabs offer functions that configure the store and how it will function:

[Store Tab]. Sets the values for a long list of store general properties which control how processing is to be done, and how various options are to be used. For details, refer to Store General Properties Screen.

[Roles Tab]. Defines parties with specific roles for this store. For an employee to be able to take orders using the internal order manager application, he must be defined as a “Sales Representative” here.

[Promos Tab]. Shows a list of active promotions for this store.

[Catalogs Tab]. Catalogs which are available for the current store and the sequence in which they are to be shown to the user in a navigation menu.

[Web Sites Tab]. Websites which are related to this store. This is directly used to link a store to a web application. Each web application has a configuration file called web.xml, and it is defined to reference a particular web site. The web site in turn is defined to relate to a product store. Thus, by setting a store on a web site, it becomes “live” on that web application.

It is possible for a web application to have more than one store associated with it, as long as it knows how to use the correct one.

The WebSite screen in Content Manager can be used to configure the static http and https content URLs and ports, so you can have your static content, such as images, served up by the Apache httpd server instead of the embedded Tomcat server.

[Shipping Tab]. This page shows the shipping options available to store customers. A list of shipping options and their pricing is shown. Click on “View” for a shipping option shows all the settings for this shipping option. At this point, this tab can only view shipping options available and not be used to define them.

[Payment Tab]. This is used to set up payment processing for the store. The payment processing interfaces are defined as services. Each payment method will have a series of service types available to it, such as for authorizing, capturing, and refunding payment. This page links the payment types and the services together by their purpose. Thus, one service would be used for credit card authorizations, another for credit card capture, and so forth.

[Emails Tab]. This defines emails which the store would send to customers. The actual email services are either mounted in the controller, such as the order confirmation email, or from scheduled services, such as back order notifications. This page defines where the template for the email is located on the file system, the addresses and subject of each email, and a content type (which can be left blank.)

[Surveys Tab]. This page is for adding surveys to the store. Surveys can be associated with certain events or with products and categories.

Setting Up Multiple Stores -- For Technical System Administrators

It is possible to set up multiple stores in the system which sell the same products on different websites. (This is different than setting up completely separate companies with their own products and customers—opentaps is not a mall like Yahoo stores.) To set up multiple stores, you would need to:

1. Create multiple Product Stores in the Catalog Manager
2. Create catalogs and associate them with your stores
3. Create WebSites in the content manager, and associate those Websites with your ProductStores.
4. Copy the online store in applications/ecommerce/ to separate directories to your hotdeploy directory, 
      one for each store
5. For each of your stores, edit its webapp/WEB-INF/web.xml file and change the webSiteId to point to one 
      of the WebSites you defined for your ProductStore.
6. You can edit base/config/ofbiz-containers.xml to set up different Tomcat servers or AJP13 listeners on 
      different ports, and then configure each of your stores to use a different server in its 
      ofbiz-component.xml file. At this point, each store can be configured to its own IP address or web URL.

Navigation into the opentaps Setup chapter:

Manual pages >> Store General Properties Screen

Section pages >> Setup for opentaps email Handling

Navigation into the opentaps Fulfillment chapter: Manual pages >> Create a Backup Warehouse

Shipping Tab << Tab pages

Shipping Processes << Section pages >> Warehouses Organization