+1-757-461-3022 x124

Library

Primary tabs

How far back does xTuple support old versions?

The older versions supported by xTuple will vary depending on the current shipping release of the product. To learn more, please visit xTuple's Supported Versions (and End of Life policy) page.

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

Why am I no longer able to print from xTuple?

If you have recently upgraded your xTuple version and you find you can no longer print reports from xTuple (but you could before you upgraded), you may need to reinstall your print drivers. Another thing to check is your user profile. Try creating a new user profile and test whether you can print from that new user profile.

Was this Helpful?
up
1083 users have voted.

How do I export data from xTuple?

The quick answer is you can right click and use the Export As option to export data from any list in xTuple ERP. The more advanced option is to use the xTuple API.

To learn more, please see the article about using the API to export from xTuple ERP.

Was this Helpful?
up
1053 users have voted.

How do I purchase support for xTuple?

Commercial support is available for xTuple products. Please see the support options page for more detailed information.

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

My company has an xTuple support contract. How do I contact xTuple support?

If your company has a support contract with xTuple, you can reach the xTuple support team either by phone or by opening a support ticket using the online ticketing system. Each support contract with xTuple specifies two "named support contacts." The named support contacts are the people at your company who are eligible to contact the xTuple support team for help. If you are not a named support contact but still need help, you should address your questions to the named support contacts at your company. Your named support contacts will either know the answers to your questions—or they will be able to contact the xTuple support team to help get you the assistance you need.

Note: Ticket-only support is included for xTuple Cloud customers and also customers who have purchased Commercial PostBooks®. Ticket-only support allows for one named support contact per company and does not include phone support.

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

Why can't I de-select a costing method?

If you have item sites using a costing method, you cannot de-select that costing method on the inventory configuration. Removing the costing method from item sites where it is used will release the costing method—and allow you to disable it.

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

What is XTN?

XTN (xTuple Network) is a commercial business continuity service, featuring off-site backup and xTuple ERP version upgrades. Please follow this link to learn more about xTuple's XTN service.

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

How are the change log options used?

The change log options, if enabled, provide a mechanism for recording changes made to item site and/or site records. For example, if a user modifies the parameters on an item site, the change log for that item site would include a record of who made the change and when it was made. If these options are not enabled, changes made to item site and site records will not be tracked in the change logs.

Was this Helpful?
up
777 users have voted.

How do I retrieve API keys from within Authorize.net?

    Neither the xTupleCommerce system nor the ERP stores plain text credit card information in the database. Both systems integrate with Authorize.net via the Authorize.net API. To retrieve API keys from Authorize.net, follow these steps:

    1. Go to Authorize.net 
    2. Log into your account as an admin
    3. Click ACCOUNT in the main menu
    4. In the Security Settings area click on API LOGIN ID and TRANSACTION KEY
    5. Enter the answer to your account’s Secret Question
    6. Click SUBMIT
    7. Capture the keys
    8. Deliver the keys to xTuple - follow the instructions for Sharing API Keys from the bottom of this article

    Note: Every time you create an API key the old key expires within 24 hours. Your keys may be used in various locations (website, ERP, etc). Please save the keys in a secure location (LastPass.com, 1Password, etc) so you don’t have to recreate keys in the future.

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

    What tokens can I use to build my email profiles?

    As a general rule, any property on the source document (e.g., incident, customer, order, etc.) is available to be used as a token. For example, to get the email address of a contact on an incident, you would use the following token: {contact.primaryEmail}

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

    Can I add multiple email recipients?

    Yes, to add multiple email addresses to any field (e.g., Cc:, Bcc:), simply separate the addresses with commas, as in the following example: "jsmith@company.com,rjones@company.com".

    Tip: Consider using a generalized distribution email address if you have multiple recipients who need to be copied.

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

    How do I stop the PostgreSQL service on a Mac?

    When using the PostBooks® Installer to install xTuple ERP on a Mac, you may run into an issue if you have a previous instance of PostgreSQL running. If you get an error message during the installation that says:

    "There has been an error. There is not enough shared memory. PostgreSQL component requires a minimum shared memory segment of 32MB. Please increase "shmmax" kernel parameter (in /etc/sysctl.conf) or close any other PostgreSQL instances before restarting installation."

    You can use the Terminal application on Mac OS X to run commands to stop the database service. You'll give yourself Superuser privileges, then switch yourself to the postgres user, then stop the service.

    1. Make sure you've closed all connections to the postgres database, such as PGAdmin or xTuple.
    2. Go to Terminal (It's in Applications/Utilities)
    3. Type: sudo su -
    4. Enter the password you use to login to your Mac
    5. Type: cd /Applications/xTuple/postgresql/bin/ (assuming you installed xTuple in the default directory. If not, you'll need to change the path to where you installed it).
    6. Type: sudo -u postgres ./pg_ctl -D /Applications/xTuple/postgresql/data stop
    7. You can start up the database in the same way, using the start command: sudo -u postgres ./pg_ctl -D /Applications/xTuple/postgresql/data start
    Was this Helpful?
    up
    737 users have voted, including you.

    Are employee groups required?

    No, employee groups are not required. Only use them if you find they will help you organize your employees into different categories.

    Was this Helpful?
    up
    696 users have voted.

    Can I select multiple costing methods?

    Yes, you can enable all of the available costing methods—if that's what your business requires. However, in many cases, one of the costing methods (average or standard) is generally sufficient. When you enable a costing method, that means item sites will be able to use that costing method. Inventory costing is specified at the item site level.

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

    What does require standard cost mean?

    If you configure purchasing to require standard costs, every item you receive into inventory through purchasing will be required to have a standard cost. This feature will be desirable in companies where standard costing is the norm. However, companies using the average (or other) costing method should not set this flag, since it will prevent you from receiving average-cost items into inventory.

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

    Can employees belong to more than one employee group?

    Yes, there is no limit to the number of employee groups an employee can belong to.

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

    What does this error mean: "connection to specified xtuple erp server cannot be made"?

    We have spoken with various users who encountered this error and discovered something in common with both. Both had prior installs of other Open Source solutions on their computer, prior to installing PostBooks®. In both cases the the other product also installed an instance of PostgreSQL. It appears the two installations of Postgres are conflicting, and preventing the PostBooks® installer from finishing the install. If you are done for the moment evaluating the other Postgres-powered application, try uninstalling it, and then running the PostBooks® installer again

    Was this Helpful?
    up
    637 users have voted.

    What is the earliest available date?

    The earliest date is derived from the item source lead time. The earliest available date is determined by adding the item source lead time to the current date. If you don't configure purchasing to use the earliest date, the due date field will be left blank when entering purchase order line items—requiring users to enter the date manually.

    Note: The earliest date configuration applies only to manually-entered purchase orders. This option does not impact the scheduling of purchase orders generated by the MRP planning system.

    Was this Helpful?
    up
    598 users have voted.

    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
    595 users have voted.

    What IP address should I put in my pg_hba.conf file?

    That's called CIDR notation. Here's a handly calculator for figuring out an appropriate value: http://www.subnet-calculator.com/cidr.php.

    You need to know a little about the network you're setting the server up on and a bit about subnetting. A client may need to allow various networks to connect - they may have several subnets, etc - each network from where you want to allow connections from needs to have an entry in the pg_hba.conf, or at least a rule that fits. 0.0.0.0 is a catch-all - any address will match with that rule.

    But, suppose you have a remote office, with a fixed IP on their router - all traffic from inside the office goes out with the same WAN IP of that router, say the WAN IP is 129.42.60.216 - that's a single address from a single device. So, on your postgres server where they are connecting to you would create a pg_hba.conf entry similar to:

    host all all 129.42.60.216/32 md5 /32
    is the same as
    255.255.255.255 ( 1 address) /24
    is the same as
    255.255.255.0 (254 addresses)

    Also, keep in mind that the pg_hba.conf file is read top to bottom. As soon as Postgres finds a rule that allows access, it stops reading rules - so make sure your access rules make sense. You can do all sorts of interesting things with the pg_hba.conf. Read the comments at the top of that file.

    Was this Helpful?
    up
    581 users have voted.

    What are email profiles?

    Email profiles are templates used to format the presentation of outgoing email messages. The profiles can be configured to use contact names, email addresses, and other CRM information stored in the database—thereby increasing automation and reducing the opportunity for errors. Using email profiles, you can standardize your communications with your customers and vendors.

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

    What is the xTuple REST API?

    To answer that question, first we have to answer a few other questions.

    What is an Interface?

    An Interface is where two things interact. An object's interface is what it presents to the outside world or other objects as the way to interact with it. We incounter interfaces everywhere in the world. A door handle is an interface. You car's stearing wheel is an interface. Writing on a piece of paper with a pen is using an interface. A keyboard, mouse and screen are interfaces to computers.

    What is an API?

    An API by definition is an Application Programming Interface. Most of the computer applicaitons you work with every day present a User Interface where you can click, type and/or touch things to interact with the application. That interface is for users, people, to interact with the applicaiton. People are not the only things that need to use applications. Other applications may need to use a feature of a different application. Other computers or systems may need to use that feature. An example of this is sending an email. The email client on your phone or computer doesn't actually send emails to other people, it uses an email servers API to send emails.

    To make sending emails easy, email servers have defined a standard and implemented and API that conforms to that standard. That allows all kinds of other applications to be able to consistently send email no matter what or where the server is. The email server has an API that any client applications can use. Client applications can be programmed to use that API so they can send emails using that email server.

    What is REST?

    REST stands for REpresentational State Transfer, which doesn't really tell the average user anything about what REST is. To understand REST, the best analogy is your computer's browser. When you visit a website, you are acessing a web server's API. That API implements a standard called HTTP. REST leverages the HTTP standard to present an API for some application.

    So what is the xTuple REST API?

    xTuple has build a web server that presents a REST API that client applications can use to interact with the xTuple ERP system. This allows client applications to get data like Products, Customers, Contacts, Addresses, etc. Those client applications can be built to do all kinds of different things with this data. One example of that is the xTupleCommece system. It is a client of the xTuple REST API. xTupleCommerce uses the xTuple REST API to present an eCommerce website to consumers. See the xTuple REST API wiki to learn more about how to use it.

    Was this Helpful?
    up
    573 users have voted.

    What is the contractor option on employee records used for?

    The contractor option should be selected and used for employees who are not on your payroll. Time logged by contract employees is accounted for differently than it is for regular employees. The main difference is that contractor time is not considered a labor cost, as it is for employees. Instead, contractor time is considered an expense which can be vouchered and then paid by check. Just as you can for regular employees, contractor time and expenses can also be billed to customers.

    Was this Helpful?
    up
    568 users have voted.

    How do I configure my system?

    Each database used by your organization has various extensions associated with it. These extensions may be modules (e.g., CRM) or other free or commercial add-ons. For each extension there will be configuration options. In most cases, your system administrator will be responsible for configuring your extensions. However, anyone with the appropriate privileges may also configure extensions.

    Was this Helpful?
    up
    564 users have voted.

    Do I need xTuple Connect in order to send emails?

    xTuple Connect is required when you send email notifications using the xTuple Desktop. 

    Was this Helpful?
    up
    554 users have voted.