+1-757-461-3022 x124

Library

Primary tabs

How do I add an item group to the product catalog for my xTupleCommerce site?

You are able to add new item groups in the xTuple ERP database via Products > Items > Groups > New. From there, fill out the appropriate fields, add any parent groups or member items, and save.

If you want the item group to have an image on the xTupleCommerce site, you are able to attach documents. Reminder: documents must be in the form of a URL.

Was this Helpful?
up
307 users have voted.

How does explosion work?

Work order explosion is the process whereby work order material (and routing) requirements are created for a work order. These requirements are pulled from the bill of materials and routing for the manufactured item. If you choose to automatically explode work orders, these requirements will be created when work orders are created. Otherwise, work orders will have to be exploded manually.

Was this Helpful?
up
306 users have voted.

How do I handle customers who have multiple tax zones?

The way to handle customers with multiple different tax zones is to use ship-to addresses. Tax zones can be defined for each ship-to address. In this way, whenever you ship to a different customer address you can be sure the correct tax zone will be used.

Was this Helpful?
up
305 users have voted.

How do I become a translator for xTuple?

If you are interested in getting involved with xTuple user interface translation, please review the following articles: Starting a new translation project and Getting and Using xTuple Translation Files. Translators will also find useful the Translation Glossary, which provides explanations of unfamiliar words/terms found in the user interface.

Was this Helpful?
up
302 users have voted.

How do I handle provinces?

Provinces are handled the same way as states in all addresses. Some countries have provinces or territories as opposed to states. For example, Québec is a province of Canada. Regardless of the country that you select from the standard country list, the relevant states or provinces will be populated in the state field of the address.

Hint: Use the limit to list setting to keep the default lists of countries, states and provinces from being changed. You can find this setting under the CRM configuration screen.

Was this Helpful?
up
301 users have voted.

How do I reverse a receivable?

Receivables can be reversed either by application or, in the case of invoices, by voiding. For example, let's say a customer has an open receivables balance of $4500. When that customer sends you a check for $4500, you can apply that cash to the invoice, thus reversing the open balance down to $0. Similarly, credit memos can be applied to invoices (or debit memos) to reduce or reverse a receivable amount. For invoices, you also have the option to void them, which reverses them back to an unposted state.

Was this Helpful?
up
301 users have voted.

When do I use tax classes?

Tax classes are needed for managing complex tax scenarios—for example, tiered, nested, or cumulative taxes. With tax classes, you can manipulate the sequence in which tax codes are applied. By applying multiple tax codes in the correct order, you can build support for even the most complicated tax requirements.

Was this Helpful?
up
300 users have voted.

Why can't I enter a credit card receipt?

When entering credit card receipts, make sure you've selected credit card as your cash receipt funds type. Second, check with your system administrator to verify your site is configured to use credit cards. Some set up may be required.

Was this Helpful?
up
300 users have voted.

Do you have any freight class examples?

The names given to freight classes are user-defined in xTuple. This means you can set up freight classes however you want to. Some examples of freight classes could include bulkbreak bulkcontainerair, etc. You could also model your freight classes after the National Motor Freight Classification (NMFC).

Was this Helpful?
up
299 users have voted.

What is a site?

Sites are locations where inventory is physically produced or stored. Item sites, site locations, and work centers all belong to sites. Examples of sites would include (but not be limited to) production facilities, shipping warehouses, storage warehouses, and quality control centers.

Was this Helpful?
up
299 users have voted.

Are item groups required?

No, unlike class codes or product categories, item groups are not required. Only use them if you need an alternate way to categorize your items not already offered by the other grouping methods.

Was this Helpful?
up
298 users have voted.

Can files be linked to opportunities?

Yes, you can link files or other documents to opportunities using the documents tab. Simply browse for files on your system and then attach them. You also can attach other documents (e.g., CRM accounts, incidents, items, etc.).

Was this Helpful?
up
298 users have voted.

Can I change the list of countries?

Yes you can add and delete countries. You can also make changes to existing countries' settings. Use this with caution though, because a non-standard country will not have the available states and provinces by default.

Hint: Use the limit to list setting in off mode to prevent changes to the list of countries.

Was this Helpful?
up
298 users have voted.

Can one item have multiple item sites?

Yes, items can be located in multiple sites. For example, in a manufacturing environment, you might require an item to be located in a factory, a quality shop, and a storage warehouse. Distribution companies locate items in multiple warehouses, allowing them to transfer inventory between sites as the need arises. Keep in mind, though, you must be running a commercial edition of xTuple to have access to multiple sites. You can read more about the different xTuple editions on our comparison page.

Was this Helpful?
up
298 users have voted.

If I don't manage inventory do I need cost categories—or item sites?

The short answer is, no. If managing inventory is not part of your business, then you don't need cost categories—or by extension, item sites. It is possible, of course, to have a mixed environment. Many service businesses will handle some inventory. And inventory-focused businesses will have some number on non-inventory parts. xTuple supports all these scenarios.

Was this Helpful?
up
298 users have voted.

Do I need to configure each database separately?

Yes, the configuration of extensions (e.g., modules, like CRM) needs to be performed on each database used by your company. This flexibility allows you to configure different databases for different purposes. For example, let's say you want to pilot new features in a sandbox database. You would want to enable those new features in the sandbox for testing purposes. However, you wouldn't want to turn those features on in your production database until after you have piloted them.

Was this Helpful?
up
297 users have voted.

How long can my item numbers be?

There is no limit to the length of item numbers.

Was this Helpful?
up
297 users have voted.

Why do I need opportunity sources?

Opportunity sources are valuable because they tell you where your leads are originating from. By analyzing your lead source information, you can identify which opportunity sources are the most (or least) successful for you. For example, if you're running a commercial on the radio--and it's generating dozens of opportunities for you--then you might want to consider buying radio ads. 

Was this Helpful?
up
297 users have voted.

How do I enter my opening balances in the General Ledger?

We recommend entering G/L Chart of Account opening balances using one of two possible methods described in the document Entering Opening Balances.

Was this Helpful?
up
296 users have voted.

How do translation files work?

To learn more about how translation files work, please see the article "Getting and Using xTuple Translation Files."

Was this Helpful?
up
296 users have voted.

What does "Error on socket 0" mean?

That error typically indicates there is either an incorrect mail server configuration or a network problem of some kind. Check the mail server options in the xTuple Connect menu. Also check your mail server and network routing to make sure all is in order.

Was this Helpful?
up
296 users have voted.

What is OAuth?

OAuth is a protocol (or framework) that supports authorization workflows. OAuth is not an API or a service: it is an open standard for authorization that any developer can implement. It gives you a way to ensure that a specific user has permissions to do something.

This protocol allows third-party applications to grant limited access to an HTTP service, either on behalf of a resource owner or by allowing the third-party application to obtain access on its own behalf. Access is requested by a client, which can be a website or a mobile application, for example.

xTuple uses OAuth2 (or OAuth 2.0), the second version of the OAuth protocol. OAuth2 simplifies the previous version and facilitates interoperability between different applications. OAuth1 adn OAuth2 specifications are completely different from one another, and cannot be used together: there is no backwards compatibility between them. 

The OAuth2 protocol is constantly evolving and acclaimed by Internet giants such as Google and Facebook.

More on OAuth 2.0 Standards available at Internet Engineering Task Force (IETF).

Was this Helpful?
up
295 users have voted.

Can the customer number be different from the CRM account number?

No, the customer number and the CRM account number are linked and must be the same. The CRM account serves as a kind of parent having several different possible children. Because of this linkage, a single business entity can be stored in xTuple as both a customer and a vendor. This helps to simply and cover the cases where you sell to one company as a customer, but you also buy from them as a vendor.

Was this Helpful?
up
294 users have voted.

How are commissions calculated?

At the most basic level, sales commissions are calculated as a percentage of the extended price for sales order line items. Each sales rep has a default commission percentage, which is defined on the sales rep record. However, this percentage can be modified at the customer or ship-to address levels. Individual sales rep commissions can also be impacted if you are using the Enhanced Commissions package.

Was this Helpful?
up
294 users have voted.

What are characteristic types?

Characteristic types control the behavior of characteristics—and also their fomatting. The following characteristic types are supported: text, list, and date. The text type is a free-form text string. Text type characteristics have access to the input mask and validator options. The list type should be used to present a list of possible values. The date type supports date strings. The formatting of date type characteristics conforms to the user's locale.

Was this Helpful?
up
294 users have voted.