+1-757-461-3022 x124

Library

Primary tabs

Are shifts required?

No, shifts are not required. If your company doesn't use shifts, then you do not need to add them—or assign them to employees.

Was this Helpful?
up
717 users have voted.

What are some examples of sale types?

Because sale types are user-defined, you can set them up any way you want to. Some examples of sale types might include in-networkout-of-networkretailwholesale, etc. Depending on how granular you want your revenue reporting to be, you can link your sale types to different revenue accounts using the sales account assignment interface.

Was this Helpful?
up
717 users have voted.

How are shifts used?

Shifts are used to track employees' weekly hours, including break periods and overtime hours. Shifts get assigned to employees on the employee master record. When employees clock into a shift—or to work orders during their shift—the rules of the shift are applied. The rules of a shift include pre-defined start/end times, break times, labor rate, etc.

Was this Helpful?
up
714 users have voted.

What is a characteristic role?

Characteristic roles define where characteristics can be used. For example, if you want a characteristic to be associated with contact records, you would select the contact role. Item characteristics would require the item role. And so on. Individual characteristics may be associated with multiple roles. The same characteristic might apply to contacts and addresses and opportunities. If you are having trouble finding a characteristic to associate, it's likely the characteristic role isn't defined properly.

Was this Helpful?
up
710 users have voted.

How do shipment numbers get generated?

Shipment numbers are generated as soon as you issue stock to shipping for an order. The shipment number is pulled from the shipping configuration panel. During configuration, you define the initial shipment number—and then every shipment automatically increments the base shipping number by one. For example, if your starting shipment number is 60001, the second will be 60002, the third 60003, etc.

Was this Helpful?
up
694 users have voted.

Our xTupleCommerce website is down. What do we do?

If you are hosting your website on your own web server, we suggest you try rebooting your server. If your website is being hosted on the xTuple cloud, please report an incident and we will reboot it for you.

Was this Helpful?
up
693 users have voted.

Why do items require units?

Items require units for two primary reasons. First, units are needed to fully describe item quantities. For example, it is not enough to say, "We have 25 sodas in stock." You would expect instead to hear, "We have 25 cases of soda in stock." Second, units make it possible for the system to convert items from one unit to another. If you stock items in one unit and sell them in a different unit, then the conversion is only possible if units are assigned in the first place.

Was this Helpful?
up
693 users have voted.

What's the difference between a context and a source?

When using Qt Linguist for translation work, you will see references to "contexts" and "sources."

  • context is a business object, like the contact screen or the bill of materials screen.

  • source is a specific string of text within a context. For example the “Bill of Materials” context contains 56 sources, including “Print”, “Save”, “Revision Date”, etc.

Was this Helpful?
up
690 users have voted.

What is the goal of project accounting?

The Project Accounting add-on package for xTuple is a solution especially designed for professional services companies, non-profit groups who need fund accounting and manufacturers or distributors with advanced project accounting requirements. At the heart of Project Accounting is the concept of the "virtual" General Ledger (G/L) Account. With Project Accounting, virtual G/L Accounts are built dynamically or "on-the-fly" using a combination of existing G/L Account Numbers and the linked Project Name. Transactions flowing from Project-related Sales Orders, Purchase Orders and Work Orders are generally supported by Project Accounting.

Was this Helpful?
up
689 users have voted.

How do I handle deferred revenue?

To handle deferred revenue, enter a cash receipt and specify you want the balance applied as a customer deposit. Doing this will ensure the cash balance is posted to the deferred revenue account, as defined in the receivables account assignments setup.

Was this Helpful?
up
688 users have voted.

Why can't I ship my transfer order?

If you are trying to ship a transfer order but it doesn't appear in the list of orders to be shipped, there's a good chance the transfer order has not been released yet. Transfer orders must be open/released before they can be shipped. To release a transfer order, change its status from unreleased to open.

Was this Helpful?
up
688 users have voted.

Are opportunity stages required?

Yes, an opportunity stage is required when creating an opportunity. That means you must have opportunity stages defined before you can successfully save an opportunity.

Was this Helpful?
up
686 users have voted.

What API keys and fields are required to use FedEx with xTupleCommerce?

If you want to include FedEx in the list of shipping options for your xTupleCommerce customers, you'll need to acquire API keys from FedEx, for both your production and development environments. Once you have the information and have added the keys to the ERP, the keys will need to be added to the xTupleCommerce website.

Here is an outline of the fields you need for both the production and development keys: 

Production Keys

  • Account Username
  • Account Password
  • Authentication Key
  • Meter Number
  • Account Number
  • Production API Password
  • Production URL

Development Keys

  • Account Username
  • Account Password
  • Test Key
  • Test Key Password
  • Test Account Number
  • Test Meter Number
  • Test URL
Was this Helpful?
up
682 users have voted.

Where are sale types used?

Sale types are used on sales orders to declare the type of sale being made. The sale type might indicate, for example, whether you are selling to a retail customer or a wholesale customer. The sale type you choose can impact how sales revenue is reported. The link between sale types and revenue accounts is made on the sales assignment interface.

Was this Helpful?
up
680 users have voted.

How do I import data into xTuple?

There are two methods for importing data into the database of xTuple ERP.

  • CSVimp
    First, xTuple offers a free application called CSVimp that is designed to migrate Comma Separated Value (CSV) files into the database for the xTuple Applications (The same tool works for PostBooks®, Standard and Manufacturing Editions). You can download CSVimp from our SourceForge project site. And detailed instructions for using CSVimp are available in our documents section.
  • xTuple API
    The second method is to use the API. The goal of the xTuple Application Programmer Interface (API) is to make migrating data directly into the database much safer and easier than it is going directly into the regular table structure. Our appoach is to allow users to create, access, and update xTuple documents using a special database schema that closely mirrors the graphical user interface (GUI). You can read more about using the API to import data into xTuple ERP in the docs section.
Was this Helpful?
up
679 users have voted.

I updated information in the ERP, but it’s not showing up on my xTupleCommerce website. What could be happening?

Some information may not show up on the xTupleCommerce website immediately. Instead, it stays in the cache. Think of the cache as a net that holds on to some of the changes.

To manually flush the cache (release the net of changes), log in to your xTupleCommerce website. Then navigate to Admin > Icon > Flush all Cache and select to flush all the cache.

Note-If after flushing the cache the formatting of the site looks like it has changed, refresh the page and it should go back to normal. 

 

Was this Helpful?
up
679 users have voted, including you.

How do I get started with sales analysis?

To get started analyzing your sales performance, follow these steps:

  1. Select a cube
  2. Select a dimension (e.g., customer)
  3. Select a dimension level (e.g., customer name) or drag the level to columns or rows
  4. Select a measure (e.g., amount, booking) or drag the measure to columns or row

You should now see a table of measures organized by the dimension you chose. You can continue selecting dimensions and measures to analyze your data in other ways.

Was this Helpful?
up
677 users have voted.

How do transfer orders differ from inter-site transfers?

Transfer orders are distinct from inter-site transfers in three primary ways. First, transfer orders allow you to move multiple items all at once between sites—instead of just one item at a time. Second, transfer orders always involve an intermediate transit site, for tracking inventory while it is "in transit." And third, there are reports (i.e., paperwork) associated with transfer orders.

Was this Helpful?
up
677 users have voted.

Can I use abbreviations for state names?

Yes, you may abbreviate state names. However, before manually adding a state (or province) you should check whether the state already exists in the database. (Hint: If you enter the country first, the corresponding states, if available, will appear.) For example, the default list of states for the United States uses the standard two-letter abbreviations. New York appears as NY and Virginia appears as VA in the list of U.S. states.

Was this Helpful?
up
676 users have voted.

How do I reimburse employees for their expenses?

To reimburse employees for their expenses, it's necessary to define employees as vendors in the system. The link between employees and vendors can be made on the CRM account screen. Once an employee is a vendor, you can create vouchers for their expenses during the worksheet approval process. Reimbursement checks can be written against these vouchers.

Was this Helpful?
up
676 users have voted.

What are the job cost recognition options?

The job cost recognition options establish the default costing behavior when creating work orders for average cost or job items. These defaults can be overridden at the item site level or at the level of specific work orders you create. If the to date option is specified, all of the WIP costs accumulated to date will be charged to the cost of sales when the item is shipped. If the proportional option is specified, a value up to the proportional value of the total quantity shipped will be charged to the cost of sales when the item is shipped. For an example of the proportional method, assume 3 items are to be shipped on a job work order and all the material has been issued—and if only 1 of the 3 is shipped—then 1/3 of the value charged to WIP at that point will be charged to the cost of sales.

Was this Helpful?
up
676 users have voted.

Can I add PDFs to an item and have them show up on my xTupleCommerce website?

Yes, you can add documents, such as PDFs, to individual items in the same way that you would add images linked to items. Like item images, the PDFs need to be stored on a separate web server, with a unique URL for each PDF. However, the ERP should contain cross references to these PDFs, via their URL.

To enter URLs for PDFs in the ERP, go to the item master for the item in question and follow these steps:

  1. Select the documents tab
  2. Choose the ATTACH button
  3. Next to the "related to" option, choose the "website" option from the list
  4. Enter the URL for the PDF
  5. Specify a name to identify it

The PDF will show up on the product page as a link for the user to view and download.

Was this Helpful?
up
675 users have voted.

How do I drill down into inventory history?

The advanced search panel gives you the most control when trying to locate specific records or groups of records in inventory history. Click on the advanced search button in the main menu to open the advanced search panel. Using advanced search, you can specify multiple different parameters—making it possible to drill down and reach the specific records you are looking for.

Was this Helpful?
up
675 users have voted.

How do I install pgcrypto?

If you are going to use credit card processing or if you're getting this message ERROR:  function decrypt(bytea, bytea, unknown) does not exist then you need to install pgcrypto. Pgcrypto is a library used for encrypting sensitive data. The pgcrypto software is a popular add-on package included with the PostgreSQL source code distribution. The pgcrypto module is used by our credit card encryption functionality.  Even if you are not processing credit cards, we still recommend that pgcrypto be installed. 

First, we need to locate the pgcrypto.sql file.  One typical path to this is:

/usr/local/pgsql/share/contrib/pgcrypto.sql

If it isn't there you can always search for the file.  You may need to perform the search as root (be patient, this takes a while):

find / | grep pgcrypto.sql

Or if you're on Windows just use the Windows file search.

Once you've located the file the next step is to install it.  The command to install pgcrypto onto your database is:

psql -U mfgadmin NameOfDB < /wherever/the/file/is/pgcrypto.sql 

Or if you prefer using pgAdmin, connect to the database you want to install pgcrypto and open/execute pgcrypto.sql through the SQL Editor.  It is also a good idea to install pgcrypto.sql on the template1 database.

Was this Helpful?
up
674 users have voted.

What are item characteristics?

Item characteristics are used to create additional layers of information about items. For example, let's say you sell toy trucks. You might use item characteristics to define the various options available on your toy trucks—such as paint color or decal kit. Taking the color example, your toy truck characteristics might include "Red," "Green," "Blue," and "Yellow." Item characteristics are useful for reporting purposes. They also play a key role in the assemble-to-order configuration system.

Was this Helpful?
up
674 users have voted.