+1-757-461-3022 x124

Library

Primary tabs

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

Do you have basic project management information?

The topic of project basics is covered in some detail in the manual Managing Projects with xTuple. The book can be read online for free or purchased for download through the xTuple MarketPlace.

Was this Helpful?
up
673 users have voted.

How do I add contacts to an account?

You can add contacts to an account in either of two ways: 1) Start on the account screen and attach existing or create new contacts from there or 2) start on the contact screen and link to an account from that direction.

Keep in mind that individual contacts may only be associated with one account at a time. However, accounts may have unlimited contacts attached to them.

Accounts feature primary and secondary contacts. These can be the two contacts you work with most often. However, you can add as many additional contacts as you like to the account. 

Was this Helpful?
up
673 users have voted.

What are due days?

Due days refers to the number of days after the document date (i.e., invoice date, voucher date) when payment is considered overdue. For example, if the invoice date is May 10 and the due days = 10, then payment would be due 10 days later, on May 20. For proximo terms, the due days refers to the day of the month when payment is due—that is, due days = 10 means due on the 10th day of the month.

Was this Helpful?
up
672 users have voted.

Are employee and user the same thing?

Employee and user are not necessarily the same thing. An employee is a person who works for your company. A user is a person who has an account allowing them to access your xTuple database. There are scenarios where database users would not also be employees. For example, you may give user access to people who are not your employees (e.g., IT consultants). Conversely, there are also scenarios where employees wouldn't need user accounts. For example, you may have employees whose job doesn't require them to use a computer—and so there would be no need for them to have a user account.

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

Can I manage my item images in the xTupleCommerce website?

Your xTupleCommerce site has the capability of hosting images, PDFs, documents and other media. Once your site is live you can associate these files with Items and Item Groups in the ERP. For instance, you can associate product images with Items in the ERP. Or you can associate Marketing PDFs with Items in the ERP. These images and PDFs will be displayed with the products on the xTupleCommerce site.

If your site is still in the development or testing phases (aka, you are still going to a stage.domain.xtuple.net URL to view your site), we encourage you to use a service such as Cloudinary to host your images and determine URLs.

However, if your xTupleCommerce website has gone live, you can begin using the site to host files and create the URLs needed for the document in the ERP. 

Uploading the files to your xTupleCommerce site :

  1. Go to your xTupleCommerce website and login as a manager or editor. 
  2. Navigate Admin > Content > Files.
  3. Click ADD FILE
  4. Select and upload the image. Typically files must be less than 8MB. 
  5. Click NEXT
  6. Leave the radio button selected for public local files and click NEXT.
  7. Update and fill in the fields for name and file name. The name will show up in the URL path of the image. 
  8. Click SAVE. 
  9. Highlight the path of the image-most recently added files are on the top of the list-and copy.

Associate files with Items or Item Groups in the ERP

  1. Login to your ERP.
  2. Open an Item or Item Group
  3. Go to the documents tab
  4. Click Attach
  5. Choose Web Site from the drop down
  6. Give the file a name in the Name field
  7. Paste the URL into the URL Field
  8. The URL should include your website domain followed by the path that you copied.  
    Example: https://www.yourwebsite.com/files/public/content/media/image.jpg
  9. Click Save 
  10. Save and close the Item and Item Group

Check your work

Navigate to the Item or Item Group where the file should appear on the website

The file should appear. If the file does not appear, you may need to flush the cache on the website.

Was this Helpful?
up
670 users have voted.

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
668 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
665 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
664 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
663 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
662 users have voted.

What are planner codes?

Planner codes provide a mechanism for categorizing items for planning purposes. For example, let's say you want to develop separate plans for raw materials versus finished goods. To do so, you would first create separate planner codes: one for materials and one for finished goods. You would then link the materials planner code to the item sites for your materials—and the finished goods planner code to the item sites for your finished goods. From that point on, you can run the planning systems and planning reports by individual planner codes to see the detail separately for each.

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

Does the sale type impact pricing?

No, there is no correlation between sale types and pricing. The sale type is used to declare how sales revenue will be accounted for in the general ledger.

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

How do I filter results?

When analyzing your data you can filter the results in several ways. For dimensions, select the dimension name in the rows or columns—then select the available members to show. You can also filter results by dragging dimensions to the filter section, and from there selecting the available members to show.

Was this Helpful?
up
653 users have voted.

Where are priorities used?

Priorities are used by incidents. The priority assigned to an incident helps determine the relative importance of the incident. Sample priorities might include "Very Low," "Low," "Normal," "High" and "Very High."

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