+1-757-461-3022 x124

Library

Primary tabs

How do I link a project to a customer?

Projects can be linked to customers using the relationships link on the customer screen. Simply locate the CRM account for the customer and then save the project once you've entered the information. When you link projects and customers you gain the ability to specify special billing rates for customers by project. You can also report on projects by customer.

Was this Helpful?
up
584 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
584 users have voted.

What if an employee changes shifts?

If an employee is going to be changing shifts, a manager or other administrator needs to assign the new shift to the employee's master record. If the new shift isn't assigned to the employee, the rules of the old shift will continue to apply to the employee.

Was this Helpful?
up
584 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
583 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
583 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
582 users have voted.

Can I create simple invoices?

Yes, if you don't want or need to use sales orders or shipping, you can create simple invoices and get them out to your customers quickly. Just enter an invoice and fill out your line items. You can even update your inventory when the invoice is posted, if you need to.

Was this Helpful?
up
576 users have voted.

Do I need to assign priorities?

No, you are not required to set a priority when creating an incident. Priorities are optional. If you don't want or need to assign priorities to incidents then you can simply ignore them.

Was this Helpful?
up
575 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
574 users have voted.

Does Connect support SSL or TLS?

Yes, beginning with xTuple Connect version 3.8, support is available for SSL and TLS encryption for email sent over SMTP.

Was this Helpful?
up
569 users have voted.

When will the next xTuple ERP release come out?

See our Product Roadmap for a general idea of when xTuple ERP will be released next and what the major upcoming features will be.

Our goal is to have two features releases a year (x.y.0), one in June and the other in December, plus a few bug-fix releases. This schedule is not exact. Feature releases will be published when their defining features are complete. Bug-fix releases will be published as needed. Between August 2007 and July 2016 we published a release on average every 8 weeks, not counting betas and release candidates. That included 21 feature and 38 bug-fix releases (on average a little more frequently than 6 months and 3 months, respectively).

Was this Helpful?
up
569 users have voted.

How can we post transactions between two different companies?

If you are making journal entries across different companies, you are now forced to keep each company in balance and make your entries happen with standard inter-company accounting procedures. For each company you would create matching Due To/From accounts on the balance sheet. There are lots of ways to set this up but here is a quick example:

Lets assume you are only using the company segment and the account number

Company 01 would need an asset account - 01-1501 Due To/From Company 02
Company 02 would need an asset account - 02-1501 Due To/From Company 01

Now instead of one journal entry you make two, one journal entry per company. Say, for example, we posted some G&A expense to company 01 and need to move it to company 02.

Credit 01-6500 $500
Debit 01-1501 $500

Credit 02-1501 $500
Debit 02-6500 $500

If our inter-company (Due to/from) account started at $0 we would now see a $500 balance in the account for company 01 and a ($500) balance for company 02.

The inter-company account(s) must remain in balance at all times, no exceptions. Any entry made to an inter-company account requires that a corresponding entry be made to the other inter-company account immediately. Any individual using inter-company account must know that they are not allowed to leave their desk if the inter-company accounts are out of balance, no exceptions. Inter-company accounts can really get out of control if people are not careful.

Was this Helpful?
up
566 users have voted.

What address do I enter in the billing configuration?

The address you should enter in the billing configuration is your remit-to address. This address is used in multiple reports, including invoices.

Was this Helpful?
up
564 users have voted.

Why are some users inactive?

There are times when you may want to disable a user account. This may be true, for example, when employees leave your company. Even though you no longer employ the person, you may still need reporting related to them. Making a user inactive also gives you the flexibility to make the user active at a later date. By contrast, when you delete a user from the database, records related to them are lost.

Was this Helpful?
up
564 users have voted.

How do we boot a user from the database?

In order to forcefully disconnect a user from the database, you have to find the Process ID (pid) for the backend connection of that user. Each user connection to the database spawns a backend process for their connection. Once you know the pid for the process, you can kill the process. On unix the command would be "kill [pid]" while other OSes may have different ways to kill a process. In order to find the pid you can look at the pg_stat_activity table and the column procid should contain the number you need.

Was this Helpful?
up
563 users have voted.

What is an honorific?

An honorific is a word (often abbreviated) added to the front of a person's name as a form of esteem or respect for that person. For example, if John Smith is a doctor, you might refer to him as Dr. John Smith. In this example, the introductory Dr. is an honorific. Other common honorifics include Mr., Mrs., Ms.

Note: Honorifics are user-defined. They may be long or short, abbreviated or not.

Was this Helpful?
up
563 users have voted.

How do I associate contacts with accounts?

You can associate contacts with accounts in either of two ways: 1) When you are editing a contact record you can specify the account relationship it belongs to or 2) you can attach contacts to an account when you are editing the account. Contacts can only be attached to one account at a time. However, single accounts can have multiple contacts (i.e., the people who work there) attached to them. You can also highlight on the account screen any especially important contacts by listing them as the primary contact or the secondary contact.

Was this Helpful?
up
562 users have voted.

As a translator, which xTuple version should I work on?

Generally you should work on translating the most current version of the software. xTuple regularly releases updates to our products, identified by version numbers. Each version may contain new sections or changes to old sections. Generally, translators should translate the most recent version of the product, but if your installation uses an older version of the product you may want to work on translating that version.

Was this Helpful?
up
561 users have voted.

Do I need more than one cost category?

You can certainly run your business using only one cost category. That's all you need to set up item sites and track inventory movements in the general ledger. If you want more detailed inventory accounting, though, you should consider implementing multiple cost categories. For example, you might have a cost category for finished goods and a different one for raw materials. In this way you can track particular item types or groups by different accounts—thus leading to more detailed financial reporting.

Was this Helpful?
up
561 users have voted.

How can I make items tax exempt?

The easiest way to make an item tax-exempt is to make sure it is not linked to a tax type. For an item to be taxable, it must have a tax type associated with it. If there's no tax type linked to an item, then tax won't be charged.

Was this Helpful?
up
561 users have voted.

What type of security is used on xTupleCommerce and the ERP?

Our systems, both xTupleCommerce and the xTuple REST API, require an SSL (Secure Sockets Layer) certificate to function. SSL is a standard security technology for creating and encrypted connection between a server and a client (for example, between a user's browser and the webserver). It allows sensitive information to be transferred in a secure fashion. Without an SSL the data would be sent between the server and client in plain text, which is not secure. In plain text an attacker could intercept the plain text data and have access to sensitive information.

Neither the xTupleCommerce system or the ERP stores plain text credit card information in the database. Both systems integrate with Authorize.net via their API. The same SSL technology is used to encrypt and send information to and from Authorize.net and we rely on Authorize.net to store credit card information in a secure fashion.

When storing a credit card on file we use Authorize.net tokens that represent the credit card information and customer data. On the ERP Postgres database we use the Blowfish Security algorithm for encrypting sensitive information. This ensures that the customer information is never passed or stored as plain text, but rather a encrypted string of letters and numbers that serve as a key to unlock that information. Without a direct connection to the Authorize.net system through the API integration, the keys are worthless which prevent attackers from obtaining the sensitive information.

Additional Resources

Authorize.net - how credit card processing works

Authorize.net - storing customer data

SSL information

Authorize.net API Reference Guide

Understanding PCI Compliance

Postgres Blowfish Security Algorithm

Was this Helpful?
up
561 users have voted.

Why should I enable customer deposits?

Enabling customer deposits makes it possible to account for deferred revenue—that is, cash receipts that are not applied to open invoices when they are received. When this option is enabled, two things will happen: 1) a customer deposit option will appear on the cash receipt screen and 2) your receivables account assignments screen will include a deferred revenue account option. This deferred revenue account will be used when customer deposits are posted. If you don't enable customer deposits, unapplied cash receipts will be distributed to a credit memo, which can be applied to an invoice at a later date.

Was this Helpful?
up
561 users have voted.

How are customer groups used?

Customer groups are used for reporting purposes. By associating similar customers with the same customer group, you can generate sales reporting and analysis for the entire group.

Was this Helpful?
up
558 users have voted.

How do I add tasks to a project?

To add tasks to a project, double-click on the project to display the project detail. Navigate to the tasks tab and press new. Fill in the detail for the task. After you've added tasks to a project, you can also view them on the project tasks master list.

Was this Helpful?
up
558 users have voted.

How do I handle Purchase Order Returns (i.e., rejects) in the vouchering process?

If you are having trouble vouchering a Purchase Order because there are Returns logged against it, then you probably left out an important step: Creating a Credit Memo for the Return. To do this, go to the "Uninvoiced Receipts/Returns" report screen and right-click on the Return record. In the right-click menu is the option to create a Credit Memo for the Return. Once the Credit Memo has been created, you should be able to continue processing your Voucher. Later, you can apply the Credit Memo to an open Voucher.

Was this Helpful?
up
558 users have voted.