Collapse AllExpand All

2.2. New Sales Order

Creating a new Sales Order requires a detailed mix of Customer, Sales Representative, and Shipping information. To access the Sales Order area, select the "New Sales Order" option. The following screen will appear:

Create New Sales Order

Tip

Be sure to close all Sales Order windows before exiting the system. This will prevent the creation of orphaned Sales Order records.

When creating a new Sales Order, you are presented with the following options:

Order #

Next available Sales Order Number will automatically display, unless your system requires you to enter Sales Order Numbers manually. Default values and input parameters for Sales Order Numbers are configurable at the system level.

Order Date

Displays current day's date.

Scheduled Date

Displays the Order's earliest scheduled date. The scheduled date corresponds to the earliest scheduled date for an included Sales Order Item. If there are no existing Line Items, the date entered here will become the default schedule date for the first one. If Line Items do exist and the date is changed, you will be asked whether you want all editable lines to change. If the change affects pricing, you will be asked whether you want Prices to be updated as well. If hidden, this field can be viewed by selecting the MORE button.

Pack Date

The pack date is the same date as the ship date. Because the field can be edited, you have the ability to change the pack date and make it different from the ship date. This field can be viewed by selecting the MORE button.

Print on Save

Select to automatically print the Sales Order when it is saved.

Note

If the Customer specified on the Sales Order has an EDI Profile attached, you may encounter an EDI processing interface when printing the Sales Order.

Customer #

Enter the Customer Number of the Customer to be billed for the sale. The lookup feature located to the right of the field leads to a searchable Customers list. You may also access this list using the keyboard shortcut "CTRL + L". Once a Customer Number is entered, the Customer name and billing address will display. Select the "?" or "$" symbol to view Customer information for the specified Customer. If a Customer's credit is "In Good Standing," the button will feature a black question mark ("?") icon. If the icon turns to an orange dollar sign ("$"), the Customer's credit Status is "On Credit Warning." A red dollar sign ("$") indicates the Customer's credit Status is "On Credit Hold." You may also create a new Customer record by selecting the "+" button.

Tip

A valid Customer Number must be entered in the "Customer #" field before Line Items can be added to a Sales Order. If no valid Customer Number is entered, you will not be able to add Line Items to the Sales Order. Additionally, Sales Orders may only be entered for active Customers.

Note

Sales Orders may not be entered for Customers whose credit status is either "On Credit Warning" or "On Credit Hold." Only users with special privileges may override these credit settings.

Name

The Customer name is displayed in an editable text field.

Ship-To #

Enter the number of the preferred Ship-To Address. Customers may maintain multiple Ship-To Addresses. If the Customer master for the specified Customer indicates that free-form Ship-To's are allowed, then any address may be entered. If free-form Ship-To's are not allowed, then the Ship-To Address must be entered using the browse button located to the right of the field.

Name

The Ship-To name is displayed.

Cust. PO #

Enter a Customer Purchase Order Number, as needed.

Note

You will be required to enter a Customer Purchase Order Number for Customers who require them. If required, duplicate numbers will only be allowed if the Customer uses blanket Purchase Orders. All Customer requirements are specified on the Customer master.

Hold Type

Specify a hold type (if any) from the available options:

None

Indicates no hold is applied, meaning the Order may be processed and shipped.

Credit

Indicates the open balance for the Customer has exceeded the credit limit defined on their Customer master record. Users will be prevented from issuing Stock to Shipping with this hold type.

Note

If the Sales Order is paid in full, as in a counter sales scenario for cash-only Customers, the order may be issued to Shipping.

Shipping

Indicates a Shipping hold has been placed on the Order. Users who attempt to ship an Order on Shipping hold will be prevented from doing so.

Packing

Indicates a Packing hold has been placed on the Order. Users who attempt to issue stock to Shipping for an Order on Packing hold will be prevented from doing so.

Return

This hold type is set automatically when a Sales Order is created from a Return Authorization and the disposition requires Inventory to be received before the replacement Order can be shipped.

Site

Specify the shipping Site associated with the Sales Order. The Site selected here acts as the default free on board (FOB) location. A Site may be designated as a shipping Site on the Site master. This field can be viewed upon selecting the MORE button.

Sale Type

Specify the Sales Type. Sales account assignments by Sales Type are available.

Note

If the Sales Order setup setting "Display Sales Order Line Items Tab by Default" is checked, the "Line Items" tab will be displayed on the opening window for Sales Order entry.

Terms

Specify the billing Terms associated with the Order. By default, the Customer's standard billing Terms will appear in the field.

Sales Rep.

Specify the Sales Representative―or Outside Rep, in the Distribution Edition―associated with the Order. Sales Representatives are linked to a Customer on the Customer master—either by a default setting or through the assignment of Ship-To Addresses. Each Ship-To Address may have a different Sales Representative associated with it. Consequently, the name of the Sales Representative appearing on the Sales Order header will be the same as specified for the Ship-To Address being used. If you are using the Enhanced Commissions package, the Sales Rep information is moved to a separate tab.

Note

When creating a new Sales Order, only active Sales Reps will be available for selection. For future changes to an existing Sales Order, all Sales Reps (active and inactive) will be listed to ensure that the original Sales Rep will still appear.

Commission

By default, the commission percentage recorded on the Customer master will be automatically entered in this field. If for some reason you select a non-default Sales Representative at Order entry, the commission rate will not change. To adjust the commission rate, you must make the change manually. This field can be viewed by selecting the MORE button.

Tax Zone

Specify the Tax Zone associated with the Sales Order. The Tax Zone for the specified Ship-To Address will be entered here by default. Otherwise, the primary Tax Zone for the Customer will be entered. This field can be viewed upon selecting the MORE button.

F.O.B.

Enter free on board (FOB) Terms for the Order. By default, FOB. Terms entered on the Shipping Site master will appear in this field. The default Terms may be changed during Order entry—and also at later stages during the billing cycle.

Ship Via

The preferred Ship Via method for the Customer will appear in the field. You may change the default Ship Via using the list. You may also enter a free-form Ship Via simply by typing the name of the Ship Via into the field.

Tip

The system supports up-to-date shipment tracking with links to the websites of many leading shipping companies (i.e., "Ship Vias").

Shipping Form

Specify the Shipping Form associated with the Order. The preferred Shipping Form for the Customer will appear in the field. This field is optional and can be viewed upon selecting the MORE button.

Note

Shipping defaults specified on the Customer master will transfer to the Sales Order header when a new Sales Order is entered for a Customer.

Shipping Chgs.

Specify the Shipping charges associated with the Order. The preferred Shipping Charges Type for the Customer will appear in the field. This field can be viewed upon selecting the MORE button.

Shipping Zone

Specify the Shipping Zone. Sales account assignments by Shipping Zone are available.

Ship Complete

Select to require that all Sales Order Line Item quantities be issued to Shipping before the Order is shipped. This feature is designed to prevent partial shipments. If selected, users will be prevented from shipping the Order unless all Line Item quantities have been issued to Shipping. If not selected, partial shipments for the Order will be allowed.

Bill-To

Specify the Customer billing information below:

Address

Displays the Customer's Bill-To Address. You may manually override the displayed Address information in the fields below—or use the lookup feature to select another Address. If a new Address is manually entered here, that Address will be added automatically to the master list of Addresses. For additional documentation related to creating Addresses, see Section 8.1, “ New Address”.

Billing Contact

Displays the Customer's billing Contact. You may manually override the displayed Contact information in the fields below—or use the lookup feature to select another Contact. If a new Contact is manually entered here, that Contact will be added automatically to the master list of Contacts. For additional documentation related to creating Addresses, see Section 7.1, “New Contact”.

Copy to Ship-to ->

Select to copy contents of billing address into Ship-To address field. This option is enabled if the Customer master for the specified Customer indicates that free-form Ship-To's are allowed.

Ship-To

Specify shipping details below:

Address

Displays the specified Ship-To Address. You may manually override the displayed Address information in the fields below—or use the lookup feature to select another Address. If a new Address is manually entered here, that Address will be added automatically to the master list of Addresses. For additional documentation related to creating Addresses, see Section 7.1, “New Contact”.

Shipping Contact

Displays the shipping Contact for the Ship-To Address. You may manually override the displayed Contact information in the fields below—or use the lookup feature to select another Contact. If a new Contact is manually entered here, that Contact will be added automatically to the master list of Contacts. For additional documentation related to creating Addresses, see Section 7.1, “New Contact”.

The following buttons are unique to this screen:

CLEAR

Select to refresh the Sales Order screen so that you can enter a new Sales Order. Using the CLEAR button does not erase or in any way change the information on the Sales Order you are clearing.

SAVE AND ADD TO PACKING LIST BATCH

Creates the Sales Order, saves it, and adds it to the list of Orders available for printing on the Packing List Batch.

MORE

Select to display extra information related to the Sales Order. To hide the extra information, simply select the MORE button again.

Note

If the Customer specified on the Sales Order has an EDI Profile attached, you may encounter an EDI processing interface when printing the Sales Order.

To create or modify Sales Order Line Items, select the "Line Items" tab at on the "Sales Order" screen. The following will be displayed:

Sales Order Line Items

When creating or modifying Sales Order Line Items, you are presented with the following options:

Line Items

Display lists Line Items for this Sales Order. A valid Customer Number must be entered in the "Customer #" field before Line Items can be added to the Order. The Shipping-related columns will not be visible if the system is configured to hide Shipping options at Sales Order entry. However, if the Shipping options are enabled, the Line Items may display in different colors, depending on their scheduling. If the Scheduled Date for an unshipped Line Item is in the future, the date will display in green text. If the Scheduled Date for an unshipped Line Item is not in the future, the date will display in red text. Once shipped, all Line Items revert to black text. For Kit Items, the Kit components will be given sub line numbers which will be displayed in an indented view. If a Line Item is firmed, that means it cannot be edited. Firmed Line Items must be softened before they can be edited.

Note

Sales Order Line Items may exist in any of the following statuses:

  • "O" = Open

  • "C" = Closed

  • "X" = Cancelled

  • "R" = Ready for Shipment (i.e., quantity available)

  • "I" = Invoiced

  • "P" = Partially-invoiced

  • "H" = On credit hold (added to others)

  • "F" = Firm (added to others)

Require sufficient Inventory

Select to ensure you have enough Quantity on Hand (QOH) in stock of a Line Item prior to issuing Stock to Shipping. If selected, this option will prevent you from issuing Line Item quantity to Shipping if doing so would force QOH for the Item Site to fall below zero. Not selecting this option means issuing Stock to Shipping may drive Item Site QOH negative. This option will not be visible if the system is configured to hide Shipping options at Sales Order entry.

Show Canceled Line Items

Select to include in the Line Items display Sales Order Line Items which have been specifically canceled. Displaying canceled Line Items can provide useful Customer and Order history information.

Misc. Charge Description

Enter a description to identify the miscellaneous charge.

Misc. Charge Sales Account

Enter a Sales Account to assign the miscellaneous charge to.

Allocated CM/Invoice

Displays the monetary value of any Credit Memos and/or Credit Card charges which have been specifically allocated to the Sales Order. If your system is configured to automatically allocate open Credit Memo balances to new Sales Orders, then the monetary value of these allocated Credit Memos—plus any Credit Card charges applied to the Order—will display here. You can also select the "Allocated Credit" link to manually allocate Credit Memos to the Sales Order.

Note

The automatic allocation of available Credit Memos occurs only once—when a Sales Order is saved for the first time. After that first save, any additional allocations will need to be applied manually.

Outstanding Credit

Displays the total monetary value of all unallocated Credit Memos for the Customer.

Authorized CC Payments

Displays the monetary value of any credit card pre-authorizations for the Order. Credit Card charges may be pre-authorized using the options found under the "Payment" tab. When a Credit Card charge is pre-authorized, the authorization is stored and may later be posted as a completed charge using the Receivables Workbench.

Freight Weight

Displays the combined weight of all Sales Order Line Items. Freight weight represents the sum of an Item's product weight and packaging weight, both of which are defined on the Item master. The per unit freight weight multiplied by the quantity per gives you the Line Item freight weight. The sum of all Line Item freight weights is the combined weight for the Order.

Margin

Displays the total profit margin for the Order. The profit margin is based on the following formula:

Order Subtotal - Total Standard Costs for all Line Items

Margin %

Displays the profit margin percentage for the Order.

At Shipping

Displays the monetary value of Sales Order Line Items at Shipping. The shipment value represents the total of the extended prices for all Items included in the Shipment. The amount does not include freight or Tax. This displayed information will not be visible if the system is configured to hide Shipping options at Sales Order entry.

Subtotal

Displays the subtotal for the Sales Order Line Items.

Misc. Charge

Enter the amount of any miscellaneous charge. Examples of miscellaneous charges include palletization costs, co-op refund, etc. Before entering a miscellaneous charge amount, you must first assign the charge to a Sales Account and also enter a description of the charge.

Tip

If you do not use Miscellaneous Charges at your site, you can hide these fields so they are not visible when entering Sales Orders. To do so, simply select the "Hide Misc. Charges" option in the system-level configuration.

Freight

Manually enter the amount of freight charges to be added to the specified Order, unless the freight amount is automatically calculated. The freight amount displayed here represents the total for all Line Items. To get a detailed view of the freight calculation, click on the Freight link using your mouse. Freight charges may be entered during the creation or modification of a Sales Order—or at the time of shipment. The system can be configured to automatically calculate freight amounts per quantity and Shipment. To learn more about freight configuration, see Freight Pricing.

Note

If you are manually entering freight, all freight charges will be added to the initial Shipment for an Order. Any subsequent backorder Shipments will not include freight.

Tax

Displays the total amount of Tax to be charged on the Sales Order. Sales Tax is calculated at the Sales Order Line Item level. The Tax amount displayed here represents the total for all Line Item Tax amounts. To get a detailed view of the Tax calculation, click on the Tax link using your mouse.

Total

Displays the total amount of the Sales Order.

Tip

If the Sales Order is paid in full, the order can be shipped even though the Customer may be on credit hold. This is to accommodate cash Customers who do not typically have a credit limit.

Balance

Displays the projected total due for the Sales Order. The outstanding balance represents the amount the Customer would owe if all allocated and outstanding Credit Memos and Credit Card pre-authorizations were applied to the Order.

Quick Item Entry

Distribution Edition users will have the option to enter Line Items quickly on this screen, without having to first open the Sales Order Item screen:

Item Number

Enter the Item Number of the Item you want to sell. The Item list will contain sold Items available for sale to the specified Customer. The list of available Items may vary from Customer to Customer, depending on how Pricing Schedules are implemented at your site. Once an Item Number is entered, the Inventory Unit of Measure and Item description will automatically appear.

Site

Specify the Site the Sales Order Item is sold from. Items may be supplied to Sales Orders from multiple Item Sites. After an Item Number is entered above, the system checks for available Item Sites for the Item. Any Item Sites having the "Sold from" flag set on them will be selectable from this Site list. By default, the Item Site having the highest Ranking will be selected as the first available Site. If more than one Item Site share a Ranking of "1," the Sites will be sorted in alphabetical order. Item Site Rankings are set on the Item Site master.

Qty. Ordered

Enter the quantity of the specified Item being ordered. The quantity will be set to "1" by default.

Scheduled Date

The scheduled date is the date when the Line Item quantity should be shipped. The user who enters the Line Item is responsible for determining the scheduled date. After entering the scheduled date, hit the TAB key on your keyboard to display values in the remaining display only fields.

Net Unit Price

Displays the Unit Price for the Sales Order Item. By default, the system will choose the lower of the following two Prices: A) The most-specific Pricing Schedule Assignment or B) any Sale in effect at the time of Order entry. The specificity of Pricing Schedule Assignments is determined in the following descending order: By Customer Ship-To Address (most specific), by Customer, by Customer Type, by Customer Type pattern, by all Customers. The lookup feature located to the right of the field leads to a Price List screen.

ADD ITEM

Select to add another Line Item to the Order.

The following buttons are unique to this screen:

FAVORITES

Select this button to bring up an interactive screen showing a list of Items the Customer has purchased in the past. On the Favorites screen you'll have the option to add one or multiple Items from the Customer's traditional favorite Items.

CLOSE

Highlight a Sales Order Line Item and then select this button to close the Sales Order Line Item. If the highlighted Line Item is already closed, this button will revert to an OPEN button, which may be used to open the closed Line Item. Closing the Sales Order Line Item will remove all existing reservations.

MOVE UP

Highlight a Sales Order Line Item and then select this button to move the Line Item up the list of Line Items. Sequence numbers are automatically adjusted to reflect the change in position.

MOVE DOWN

Highlight a Sales Order Line Item and then select this button to move the Line Item down the list of Line Items. Sequence numbers are automatically adjusted to reflect the change in position.

SMOOTH MARGIN

Highlight one or multiple Sales Order Line Items and then select this button to reach the margin smoothing screen. On the Smooth Margin screen you will be given the option to smooth the margin for the selected Items by a percentage you determine.

RESERVE STOCK

Highlight a Sales Order Line Item and then select this button to reserve Inventory quantity for the Line Item.

Note

In order to manually reserve or unreserve stock for a Line Item, the Sales Configuration option "Allow Manual Reservations" must be selected.

RES. LINE BAL.

Highlight a Sales Order Line Item and then select this button to reserve Inventory quantity for the remaining Line Item balance.

ISSUE STOCK

Highlight a Sales Order Line Item and then select this button to issue quantity to Shipping. This button will not be visible if the system is configured to hide Shipping options at Sales Order entry.

Tip

You may select multiple Line Items for issuing to Shipping by highlighting them using your mouse—or a combination of your mouse and either the SHIFT or CTRL keys.

ISSUE LINE BAL.

Highlight a Sales Order Line Item and then select this button to issue the balance of the Line Item quantity to Shipping. This button will not be visible if the system is configured to hide Shipping options at Sales Order entry.

Note

The Shipping-related options will not be visible if the system is configured to hide Shipping options at Sales Order entry.

ISSUE ORDER AVAILABLE

Select this button to issue all material available to fill the current Sales Order. Only stock that is available to be issued to Shipping will be issued. If an Item is on backorder, that stock will have to be issued at a future point.

SHIP ORDER

Highlight a Sales Order Line Item and then select this button to ship the Order. This button will not be visible if the system is configured to hide Shipping options at Sales Order entry.

ISSUE AVAILABLE AND SHIP

Select this button to issue all material available and then ship the Sales Order, all in one step. Only stock that is available to be issued to Shipping will be issued. If an Item is on backorder, that stock will have to be issued at a future point.

When processing Sales Orders or Invoices, you have the option to allocate open A/R Credit Memos to the document. To allocate open Credit Memos, select the "Allocated Credit" link on the Line Items tab. The following screen will appear:

Allocate Credit Memos

When allocating Credit Memos, you are presented with the following options:

Document Total

Displays the total amount of the document being applied to.

Unallocated Balance

Displays the open balance of the document being applied to. When Credit Memos are allocated to the document, the open balance will go down by the amount of the allocations. The balance will go back up if those allocations are cleared.

Credits

Display lists the Customer's open Credit Memos. When a Credit Memo is applied to the document, the list will indicate the relationship between the two. If the allocation is cleared, the list will update to remove the relationship.

The following buttons are unique to this screen:

ALLOCATE

Highlight a Credit Memo and then select this button to allocate the Credit Memo to the document. Partial Credit Memo amounts may be allocated if the document's open balance is less than the full Credit Memo amount.

To define or maintain relationships for Sales Orders, select the "Relationships" tab. The following will be displayed:

Sales Order Relationships

When defining relationships for Sales Orders, you are presented with the following options:

Project #

If your system is configured to use Projects, select a Project Number to associate with the Sales Order. If a Sales Order is created from a converted Quote—and the Quote had a Project Number associated with it—then the Project Number from the originating Quote will automatically be entered here. Once a Project Number is associated with a Sales Order, any Work Orders or Purchase Orders created by the Sales Order demand will automatically be linked to the same Project Number as the Sales Order. In this way, Sales Orders, Work Orders, and Purchase Orders may be linked to the same Project.

When you have the xTuple Project Accounting package installed—and you link a Project to the Sales Order—transactions related to the Sales Order will include the Project Number as the final segment of affected G/L Account Numbers. Account Numbers related to the following transactions will include the Project Number as the final segment: Issue to Shipping, Return Stock, Ship Shipment, Recall Shipment, and Post Invoice.

Tip

If your site is configured to create Projects automatically whenever new Sales Orders or Quotes are entered, the Projects generated in this way will assume the number of the Sales Order or Quote which caused their creation.

Opportunity

Select an Opportunity to associate with the Sales Order, using the lookup feature located to the right of the field.

From Quote

If a Sales Order was converted from a Quote, the originating Quote Number will display here.

Note

If the Sales Order was generated from a Return Authorization, the Return Authorization Number will display here.

Sales Order Characteristics are user-defined definitions which may be used to provide additional layers of description about Sales Orders. These descriptions are static and not processed by the system, but are useful for informational purposes.

Tip

For configured Items, an additional pricing field will be available on the Item Characteristic screen. This pricing information will be passed to Sales Order Line Items when particular configurations are sold. The Price for configured Items may vary depending on the Characteristics selected at Sales Order entry time.

To enter Characteristics associated with a Sales Order, select the "Characteristics" tab. The following will be displayed:

Sales Order Characteristics

To create a new Characteristic for your current context, select the NEW button from the Characteristics list. The following screen will appear:

Create New Characteristic

When creating a new Characteristic, you are presented with the following options:

Characteristic

Select a Characteristic from the list of Characteristics available for your current context. To learn more about how Characteristics are linked to specific contexts, please see Section 9.2.2.1, “Characteristic”.

Value

Enter a value to associate with the Characteristic.

Default

In some contexts, the default option will appear. Select if the Value entered is the default Value for the specified Characteristic. Default Values will always be listed first where Characteristics are used.

To add Comments related to a Sales Order, select the "Comments" tab. The following will be displayed:

Sales Order Comments

When adding or reviewing Comments, you are presented with the following options:

Verbose Text

Select to display all Comments in the list in an expanded view which includes the entire text of each Comment. To edit a Comment, simply select the "Edit" link next to the Comment. That link will not be shown for Changelog Comments, which can't be edited. If the "Verbose Text" option is not selected, the Comment list will display only header level information for each Comment.

Comments

Display lists Comments related to the record.

The following buttons are available:

NEW

Opens screen for creating a new Comment.

VIEW

Highlight a Comment and then select this button to reach a read-only view of the "Edit" screen.

EDIT

Enables you to edit highlighted Comments—as long as the Comments are not "ChangeLog" Comments. ChangeLog Comments are system-generated and may not be edited. The edit screen is the same as that for creating a new Comment—except that when editing, the fields will contain Comment information. Double-clicking on a Comment will also bring you to the editing screen.

To enter a new Comment, select the NEW button. The following screen will appear:

Create New Comment
Comment Type

Select a Comment Type from the drop-down list to classify the Comment. This is a required step. Comment Types may be system-defined (i.e., "ChangeLog" and "General") or user-defined, as described in Section 13.2.2, “Comment Types”. Once you have specified a Comment Type, begin typing your Comment in the main text area. The text area features word-wrapping and scroll-bar support for longer Comments.

The following buttons are unique to this screen:

MORE

Select to show the complete list (i.e., "thread") of Comments associated with the record. To hide the list, simply select the SHOW MORE button again. The Comment thread will show the most recent Comment first.

Order Notes added to a Sales Order are used for internal purposes only. If an Invoice results from the Sales Order, these Notes will be transferred to the Invoice. To add Notes to a Sales Order, select the "Order Notes" tab on the "Sales Order" screen. The following will be displayed:

Sales Order Notes

When adding Notes to a Sales Order, you are presented with the following options:

Order Notes

This is a scrolling text field with word-wrapping for entering general Notes related to the Sales Order. These Notes are for internal use only.

Shipping Notes

Shipping Notes are drawn from the Customer master—specifically from the "Shipping Notes" tab on the Ship-To Address master. The Notes may vary depending on the Ship-To Address specified for the Order. These Notes provide a mechanism for transferring shipping information from the Customer master to the Sales Order. Ultimately, Shipping Notes may be printed on shipping paperwork. While Shipping Notes content may originate from the Customer master, you can edit the Notes to fit the requirements of an Order. Shipping Notes may be printed on shipping paperwork.

To associate documents with a Sales Order, select the "Documents" tab. The following will be displayed:

Sales Order Documents

When associating documents, you are presented with the following options:

NEW

Select to create a new document and associate it with the current record. You may create the following document types:

Image

Select to create a new Image association.

Fixed Asset

Select to create a new Fixed Asset association.

Maintenance Order

Select to create a new Maintenance Order association.

Incident

Select to create a new Incident and associate it.

Project

Select to create a new Project and associate it.

Opportunity

Select to create a new Opportunity and associate it.

To Do

Select to create a new To-Do and associate it.

EDIT

Enables you to edit associated documents. The edit screen is the same as that for creating a new document—except that when editing, the fields will contain document information. Double-clicking on a document will also bring you to the editing screen.

VIEW

Highlight a document and then select this button to reach a read-only view of the "Edit" screen

ATTACH

Select to associate already-existing documents. The following document types may be attached: Contact, Account, Customer, Employee, File, Image, Incident, Item, Opportunity, Project, Purchase Order, Sales Order, Vendor, Web Site, Work Order.

DETACH

Highlight a document and then select this button to remove the association.

To associate already-existing documents, select the ATTACH button. The following screen will appear:

Attach a Document

When associating already-existing documents, you are presented with the following options:

Relationship

Indicate how the document is related to the current record. The following relationship options are available: Related to, Parent of, Child of, Duplicate of.

Type

Specify the kind of document you want to associate. The following document types may be attached: Contact, Account, Customer, Employee, File, Image, Incident, Item, Opportunity, Project, Purchase Order, Sales Order, Vendor, Web Site, Work Order. When associating Files, you will also be given the option to save the File to the database.

Tip

There is no file size restriction when saving Files to the database. However, excessively large files could cause storage and performance issues.

Document

Use the lookup field to identify the specific document you want to attach. The data entry options will vary depending on the document type you select.

To receive payments for the Sales Order, select the "Payment" tab at the top of the "Sales Order" screen. To authorize or charge Customer Credit Cards, select the "Credit Card" tab in the window. The following screen will appear:

Customer Credit Card Payment

When authorizing or charging Customer Credit Cards, you are presented with the following options:

Payment

Display lists Credit Card information for the specified Customer.

The following buttons are unique to this screen:

MOVE UP

Highlight a Credit Card and then select this button to move the Credit Card up in the sequence of Credit Cards. Sequence numbers are automatically adjusted to reflect the change in position.

MOVE DOWN

Highlight a Credit Card and then select this button to move the Credit Card down the sequence of Credit Cards. Sequence numbers are automatically adjusted to reflect the change in position.

AUTHORIZE

After entering an amount below, highlight an active Credit Card and then select this button to pre-authorize the Credit Card charge for the amount specified. Pre-authorized Credit Card charges will be displayed in the "Authorized CC Payments" field on the "Line Items" tab. After a Credit Card charge has been pre-authorized, the charge may then be post-authorized using the Receivables Workbench—thereby completing the Credit Card transaction.

CHARGE

After entering an amount below, highlight an active Credit Card and then select this button to charge the Credit Card for the amount specified. When a Credit Card is charged, both a Credit Memo and a Cash Receipt are posted for the charge amount. The total due from the Customer will be automatically adjusted on the Invoice to reflect the amount of any Credit Card charges. If, by chance, you charge a Customer's Credit Card but fail to save the Sales Order, the link between the Order and the charge will be broken; however, the transactions resulting from the charge will remain in the system.

Amount

Enter the amount of the Credit Card pre-authorization or charge. By default, the outstanding balance due will be displayed here. However, you may edit the default amount.

CVV Code

Enter the Card Verification Value (CVV) Code found on the back of the specified Credit Card. This may be an optional feature at your site. Contact your Systems Administrator for details.

To post a cash payment, select the "Cash" tab in the "Payments" window. The following screen will be displayed:

Customer Cash Payment

When posting cash to the Sales Order, you are presented with the following options:

Order Total

Displays the Sales Order total.

Balance

Displays the difference between the Sales Order total and any payments that have been applied.

Amount Received

Enter the cash payment amount that should be applied to the Sales Order.

Funds Type

Specify the type of the Cash Receipt. Choose from following Funds Types: Check, Certified Check, Cash, Wire Transfer, and Other.

Tip

You can use the Funds Type "Other" for entering Credit Card information if you are not using xTuple's Credit Card processing functionality at your site.

Payment/Document #

Use this field to enter the Customer's Check Number, transaction number, Credit Card number, or any other Document Number associated with the Cash Receipt.

The username of the logged-in user will display as the default document number, when the XWD package is enabled. This value can be changed, if desired.

Payment/Document Date

Use this field to specify the date on the Check you received. This is the Document date used when running the Receivables aging report.

The current date will display here, when the XWD package is enabled. This date can be changed, if desired.

Post to

Select the Bank Account you want to post the Cash Receipt to. The Asset Account used for the selected Bank Account is specified on the Bank Account master.

Tip

If your site uses a unique Bank Account for receiving Credit Card payments, make sure to select the appropriate Bank Account when entering payments from a Credit Card.

Distribution Date

Specify the date of the cash distribution. This is the date the Cash Receipt will hit the General Ledger (G/L). By default, the current day's date will appear. If the distribution date precedes the application date, the label "Apply Balance As" will change to "Record Receipt as" to clarify that the cash will be recorded as a Credit Memo or Customer Deposit until the application date arrives. On the application date, the Credit Memo or Customer Deposit will automatically be applied to its specified receivable document(s).

Application Date

Specify the date you want the cash to be applied to the selected receivables. By default, the current day's date will appear. To prevent Receivable aging and G/L balance mismatches, you may not enter an application date prior to the earliest document date of receivables the cash is being applied to.

Use Alternate Receivables Account From Sales Category

Select one of the following optional Receivables Accounts:

Sales Category

Specify a Sales Category whose Receivables Account option you want to use instead of the default Receivables Account.

Note

If an alternate Receivables Account is not specified, the system will use the default Receivables Account specified for the Customer Type under Receivables Account Assignments.

To view Shipments associated with the order, select the "Shipments" tab. The following will be displayed:

Sales Order Shipments

When viewing Shipments associated with the order, you are presented with the following options:

Sales Order #

Displays the Sales Order Number of the current Sales Order.

Order Date

Displays the Order Date of the current Sales Order.

Cust. Name

Displays the Customer Name associated with the specified Sales Order.

Cust. Phone

Displays the Customer's phone number.

P/O Number

Displays the Purchase Order Number associated with the specified Sales Order.

Shipments

Display lists Shipments for the Sales Order.

To view Email associated with the Sales Order, select the "Email" tab. The following screen will appear:

View Associated Emails

When viewing associated Emails, you are presented with the following options:

Email List

Display lists associated Emails.

Email Body

The content of a highlighted Email will be displayed here.

Limit to

Specify the maximum number of associated Emails you want to be displayed in the Email list. If the list is extremely long, you may experience some slowness when opening the screen.

Load All

Select to load all associated Emails into the list.

Search

Enter a string of letters or complete words to search for matches in the list of associated Emails. The search will scan through subject lines, to addresses, and from addresses.

The following buttons are unique to this screen:

NEW

Select to send a new Email, using the default Email program on your computer.

PRINT

Highlight an Email and then select this button to print a copy of the Email.

REPLY

Highlight an Email and then select this button to reply to the Email's sender, using the default Email program on your computer.

REPLY ALL

Highlight an Email and then select this button to reply to everyone associated with the Email, using the default Email program on your computer.

FORWARD

Highlight an Email and then select this button to forward the Email to another person(s), using the default Email program on your computer.

ATTACH

Highlight an Email and then select this button to attach an Email associated with a Contact in your Contact list.

DETACH

Highlight an Email and then select this button to remove the associated Email from the list.