Return-Path: X-Original-To: apmail-ofbiz-commits-archive@www.apache.org Delivered-To: apmail-ofbiz-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 1691BE9E1 for ; Sat, 8 Dec 2012 08:22:36 +0000 (UTC) Received: (qmail 37065 invoked by uid 500); 8 Dec 2012 08:22:35 -0000 Delivered-To: apmail-ofbiz-commits-archive@ofbiz.apache.org Received: (qmail 37035 invoked by uid 500); 8 Dec 2012 08:22:35 -0000 Mailing-List: contact commits-help@ofbiz.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@ofbiz.apache.org Delivered-To: mailing list commits@ofbiz.apache.org Received: (qmail 37028 invoked by uid 99); 8 Dec 2012 08:22:35 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 08 Dec 2012 08:22:35 +0000 X-ASF-Spam-Status: No, hits=-1996.5 required=5.0 tests=ALL_TRUSTED,LOTTO_DEPT,TVD_PH_BODY_ACCOUNTS_PRE X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Sat, 08 Dec 2012 08:22:24 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 5F5402388B6C; Sat, 8 Dec 2012 08:22:01 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1418622 [2/11] - in /ofbiz/branches/webhelp-2012-12-07: ./ applications/content/ applications/content/data/helpdata/docbookhelp/ applications/content/data/helpdata/docbookhelp/accounting_en/ applications/content/data/helpdata/docbookhelp/a... Date: Sat, 08 Dec 2012 08:21:51 -0000 To: commits@ofbiz.apache.org From: jleroux@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20121208082201.5F5402388B6C@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Added: ofbiz/branches/webhelp-2012-12-07/applications/content/data/helpdata/docbookhelp/accounting_en/accounting.xml URL: http://svn.apache.org/viewvc/ofbiz/branches/webhelp-2012-12-07/applications/content/data/helpdata/docbookhelp/accounting_en/accounting.xml?rev=1418622&view=auto ============================================================================== --- ofbiz/branches/webhelp-2012-12-07/applications/content/data/helpdata/docbookhelp/accounting_en/accounting.xml (added) +++ ofbiz/branches/webhelp-2012-12-07/applications/content/data/helpdata/docbookhelp/accounting_en/accounting.xml Sat Dec 8 08:21:03 2012 @@ -0,0 +1,6497 @@ + + + + + + + OFBiz Documentation + + + + + + + + + + + + + + OFBiz Accounting Introduction + + The Accounting system is organized according to age old and + generally accepted principles such as double-entry accounting, a General + Ledger with hierarchical accounts, journals and posting of transactions + and corresponding entries. + + The structure is primary based on the OMG GL standard and the work + that was done on an AR/AP extension of the OMG GL standard. This + correlates well with other standards such as ebXML and OAGIS. + + The Accounting entities are structured such that accounts for + multiple organizations can be managed. The multiple organizations could be + multiple companies, or departments or other organizations within a + company. Each Organization can have various GL Accounts associated with it + so that it can operate with its own subset of the Master Chart of + Accounts. + + Each Organization can also have its own set of Journals for + flexibility, even though the use of Journals should be as minimal as + possible in favor of allowing the system to automatically create and post + transactions based on business events triggered by standard procedures and + documents such as purchase and sales orders, invoices, inventory + transfers, payments, receipts, and so forth. + + + + Accounting Main + + + + + + + + + + This is the default tab for the Accounting Manager application. The + screen currently shows links that will display more detailed screens + related to Agreements, Billing Accounts, Invoices and Payments. + + + + Invoices + + Sales invoices are generated when customers buy something from your + business. You will need to provide a detailed list of the items bought and + relevant taxes paid. They are often referred to a 'tax invoices' as they + contain information relating to the amount of sales tax (eg VAT / GST) + charged on the product or service. + + Purchase invoices are generated by your suppliers when you order + something from them. You may send them an order in the form of a Purchase + Order. They will then send you the products and an invoice for payment. + This invoice is the Purchase Invoice and it will contain details of the + items bought plus any taxes. + + Both of these documents are used as proof to various tax authorities + (eg Inland Revenue, Customs etc) that the required tax has been charged or + collected. + + GENERAL NOTE: The following is an extract from Ian McNulty's + documentation work on accounting: + + Invoices are created automatically by the system when certain + criteria are met for each item on an order. The criteria will vary + depending on the type of product associated with the order item, and the + type of order (ie purchase/sales). + + For Sales Orders that include digital goods, an invoice will be + created when the order is placed, and that invoice will be for all digital + goods in the order. If there are non-digital or physical goods they will + go in a separate invoice. + + For Sales Orders that include digital goods, an invoice will be + created when the order is placed, and that invoice will be for all digital + goods in the order. If there are non-digital or physical goods they will + go in a separate invoice. + + For Purchase Orders an invoice will be created from a shipment when + the shipment goes into the Received status. + + + Invoice Roles + + The Invoice Roles screen allows parties with specific roles to be + associated with and invoice. If the e-commerce or Sales Order entry + route has already been used then the invoice generated will already + contain the relevant roles from the various parties. + + For a Sales Order examples of roles will include Bill From + Customer, Bill To Customer, End User Customer,Ship To Customer + etc. + + + How do I add a party role to an invoice? + + Party roles will automatically be added to an invoices that have + been generated as a result of E-Commerce order entry or Sales Order + entry. They can also be added be added manually. + + + + Select the 'Roles' sub menu + + + + Enter or use the lookup to enter the party to be added to + the invoice in the 'Party Id' field + + + + Enter or use the lookup to enter the party to be added to + the invoice in the 'Party Id' field + + + + Leave the 'Date Time Performed' field blank + This field is optional and can be entered if required. + This field can be used to indicate the date and time this role + was performed by the party for this invoice + + + + + Leave the 'Percentage' field blank + This field is optional and can be entered if required. + If roles are shared then this field can be used to indicate + the assigned percentage for this role + + + + + Press the 'Submit' button + + + + The new role entry will be displayed on the bottom part of + the screen + If you select a role that is not associated with the + party that has been entered an error message will be + displayed. To fix it you will need to add the role to the + party or choose another party that already has that role + associated with it. + + + + + + + How do I update a party role on an invoice? + + A party role cannot be updated via the current user interface. + It can only be removed. If a party role needs to be updated then the + entry must be deleted and then re-created. + + + + How do I remove a party role from an invoice? + + + + Locate the entry that needs to be removed + + + + Locate the entry that needs to be removed + + + + The entry is now removed from the list of invoice + roles + + + + + + + New Invoice + + This screen allows the user to create a new Sales or Purchase + Invoice. Sales Invoices are created when a customer buys something from + you. Purchase Invoices are created when you buy something from a + supplier. + + + How do I create a new Sales invoice? + + + + Press the 'Create New' button + + + + The New Sales Invoice / New Purchase Invoice screen is + displayed + + + + Using the top part of the screen, leave Invoice type with + its default of 'Sales Invoice' + + + + Leave 'Organization Party Id' with its default of + 'Company' + + + + Enter or use the lookup to find the 'To Party Id' (eg + DemoCustomer) + + + + Press the 'Create' button in the top part of the + screen + + + + The invoice header has been created and the default header + screen will be displayed + + + + Details on the invoice will need to be entered via the other + sub menus (eg Items, Time Entries etc) + + + + + + How do I create a new Purchase invoice? + + + + Press the 'Create New' button + + + + The New Sales Invoice / New Purchase Invoice screen is + displayed + + + + Using the bottom part of the screen, leave Invoice type with + its default of 'Purchase Invoice' + + + + Leave 'Organization Party Id' with its default of + 'Company' + + + + Enter or use the lookup to find the 'From Party Id' (eg + DemoSupplier) + + + + Press the 'Create' button in the bottom part of the + screen + + + + The invoice header has been created and the default header + screen will be displayed + + + + Details on the invoice will need to be entered via the other + sub menus (eg Items, Time Entries etc) + + + + + + + Invoice Send Per Email + + This is used to send a copy of the invoice details to one or more + email addresses. The invoice is included as an attachment and the user + can add a simple accompanying email message. + + + How do I send a copy of an invoice via email? + + + + Select the 'Send per Email' sub menu + + + + The 'Send per Email' default screen will be displayed + + + + Enter the 'From Email Address' + CHECK: Shouldnt this be defaulted from the user + login.....???? + + + + + Leave the 'To Email Address' as it is as this will be + defaulted using the customer details from the invoice + + + + If required enter the 'Copy Email address' for anyone that + needs to be copied on the email + + + + Leave the 'Subject' as the default of 'Please find attached + invoice' + + + + Leave the 'Other Currency' box blank + CHECK: Investigate what effect this has on the + email..... + + + + + Enter a short email message in the 'Email Body' + + + + Press the 'Submit' button + + + + + + + List Invoice Items + + The Invoice Items screen displays the individual invoice line + details and allows the user to update or remove an entry. As each + invoice line is created it is allocated a specific sequence (or Item + Number) which acts as a unique identifier. + + + How do I create a new invoice line item? + + Note that only invoices that have specific statuses can have new + line items created. This means that if an invoice has already been + paid and processed OFBiz will not allow any amendments to it. + + + + Select the 'Items' sub menu for the invoice + + + + The 'Add a new invoice item' screen will be displayed + + + + Leave the 'Item No' field blank (as it will be automatically + generated) + + + + Select the 'Invoice Item Type' from the drop down box + A typical line using the demo could be 'Invoice Finished + Good Item' but ensure that it corresponds with the type of + products setup in your catalog + + + + + Enter a description describing what the line item is + If you are going to enter a product in the Product Id + field from the catalog then leave the 'Description' field + blank as it will be used to show the product + description + + + + + Leave the 'Override GL Account Id' field blank as it will + use the default account based on the Chart of Accounts + setup + + + + Use the lookup or enter a product code in the 'Product Id' + field + This can be left blank if your invoice line is not + related to a product in the catalog + + + + + Enter a number in the 'Quantity' field + + + + Enter a 'Unit Price' only if the Product Id field is + blank + If a Product Id has been entered then leave the 'Unit + Price' field blank as it will pick up the product price from + the catalog + + + + + Leave the 'Inventory Item' field blank + + + + Leave the 'Product Feature Id' field blank + + + + Leave the 'UOM' field blank + + + + Select 'Yes' for the 'Taxable Flag' field + + + + + CHECK: Need to do some tests to see what line item type needs + to be used for 'Sales Tax'. I think that it could be 'Invoice Item + Sales Tax' since tax is currently calculated at invoice item line + level. Also the automatically generated invoices from Order Entry + and E-Commerce show taxes at the invoice item line level (think + there may be some work going on - see JIRA on to consolidate + entries). Need to do some tests using 'Invoice Sales Tax' to see how + it works......... + + + + + How do I update an invoice line item? + + Not all the fields on the invoice item line can be updated. For + example Taxable Flag and Inventory Item cannot be updated. If these + fields need to be amended then the invoice item will need to be + removed and then re-created. + + + + Select the 'Items' sub menu for the invoice + + + + Any existing line items will be displayed in the 'Items' + box + + + + Amend the details in the line item that needs to be updated + (eg Quantity, Invoice Item Type, Product Id, Description, Override + GL Account, Unit Price) + + + + Press the 'Update' button displayed at the end of the line + item that has been updated + + + + + + How do I delete an invoice item? + + + + Select the 'Items' sub menu for the invoice + + + + Any existing line items will be displayed in the 'Items' + box + + + + Press the 'Remove' button displayed at the end of the line + item that needs to be deleted + + + + + + + Edit Invoice Time Entries + + The Time Entries screen displays any time logged against the + invoice. For example these time entries can be from employee or external + supplier timesheets that are tracked within OFBiz. is used to track any + individual work or billable hours against an invoice. + + + How do I add a new time entry for an invoice? + + There are two options : + + + + Add time entry to a new invoice and add time entry to an + existing invoice. + + + + Add time entry to a new invoice and add time entry to an + existing invoice. + + + + + + How do I update a time entry for an invoice? + + + To check if this can only be done via timesheets. + + + + + How do I remove a time entry from an invoice? + + + To check if this is done via timesheets + + + + + + Edit Invoice Applications + + The Invoice Applications sub menu is where payments that have been + made (or received) can be linked or allocated to an invoice. The phrase + 'applying' an amount to an invoice is often used to describe this. The + screen is divided into 3 main areas as follows. + + + + Payments Applied (which shows details of the total amount + 'Applied' and the total amount 'Open'. Note that 'Open' here means + outstanding) + + + + Possible Payments to Apply (which shows all the payments that + have been sent from the same party id as the invoice - for a sales + invoice this would be the customer party id) + + + + Assign Payment to Invoice (which allows you to manually assign + a specific payment id to this invoice) + + + + + General Ledger accounting transactions are generated during the + payment application process but unless your GL is setup with Unapplied + Cash and Applied Cash accounts - I'm not sure that there will be any + true accounting impact. In the Sales Order process the accounting + transaction generated the following GL Accounting transaction is + generated for 'Payment Applied' o add some text here. + + + DR 120000 Accounts Receivable / CR 120000 Accounts Receivable - + This transaction doesnt really do anything! + + It is used to link payments to invoices. It is also used to + allocate which part of a payment is allocated or applied to a specific + invoice. This is extremely useful if your customers pay multiple + invoices with a single payment. + + Example: + + + + A customer could send a single payment of $1000 that can be + used to pay for two invoices (eg $400 and $600) + + + + Using this applications sub menu allows you to allocate part + of the $400 to one invoice and the balance ($600) to the other + invoice + + + + By default all 'unapplied' payments that have been entered into + OFBiz from the customer will be available for selection even if they + have not yet been flagged as formally 'Received'. This means that these + are payments that have not already been linked to another invoice. If + only part of a payment amount has been linked to an invoice then the + remaining amount is left available to be allocated to another invoice. + Also note that a single invoice could be paid by multiple payments being + applied to it. + + + How do I apply a payment (or payments) to an invoice? + + + + Select the 'Applications' sub menu for the invoice + + + + A list of unapplied payments for the party id will be + displayed + + + + A list of unapplied payments for the party id will be + displayed + More than one entry may be used. Also only part of a + larger amount may be used)The Payments Applied total at the + top of the screen will be updated with the amount selected. + Also the Amount Open will be reduced by the amount + selected. + + + + + More than one entry may be used. Also only part of a larger + amount may be used)The Payments Applied total at the top of the + screen will be updated with the amount selected. Also the Amount + Open will be reduced by the amount selected. + + + + More than one entry may be used. Also only part of a larger + amount may be used)The Payments Applied total at the top of the + screen will be updated with the amount selected. Also the Amount + Open will be reduced by the amount selected. + + + + + + How do I update an applied payment for an invoice? + + + + Payments that have been applied to an invoice can be + updated. This means that you can change the details of the payment + transaction or adjust the amount that was applied to the + invoice. + + + + Select the 'Applications' sub menu for the invoice + + + + A list of payments already applied to the invoice will be + displayed in the top part of the screen + + + + Enter or use the lookup to change the 'Payment Id' if + required + + + + Enter the updated amount in the 'Amount to Apply' field if + required + + + + Press the 'Update' button + + + + + + How do I remove an applied payment (or payments) from an + invoice? + + + CHECK: It can be done before transaction has been posted to GL + but also need to check if its can be done if the transaction has + been posted. + + + + + Select the 'Applications' sub menu for the invoice + + + + Select the 'Applications' sub menu for the invoice + + + + Press the 'Remove' button next to the payment entry that + needs to be removed + + + + The entry will be removed and the top part of the screen + will be update the 'Payments Applied' total and 'Amount + Open' + + + + + + + Edit Invoice + + The Invoice Header screen is used to view or update details from + the invoice header. Examples of the type of information that can be + changed are Due Date, Description, Currency. + + + How do I update the header details for an Invoice? + + + + Select the 'Header' sub menu and the header details of the + invoice will be displayed + + + + Update the fields required + + + + Press the 'Update' button + + + + + + + Invoice Overview + + The Invoice Overview screen is used to display the summary of an + invoice in a single view. The screen is divided into sections that show + various information related to the invoice (eg Roles, Status, Terms, + Items, Payments Applied, etc). + + The following options are currently available from this + screen: + + + + The following options are currently available from this + screen: + + + + Copy (Create a copy of the current invoice) + + + + PDF (View a PDF of the current invoice) + + + + PDF default currency + CHECK: Need to see how this is different from just the PDF + view...... + + + + + Status to 'Approved' (Change the status of the current invoice + to 'Approved) + + + + Status to 'Sent' (Change the status of the current invoice to + 'Sent') + + + + Status to 'Ready' (Change the status of the current invoice to + 'Ready'. + This will create the relevant accounting transactions and + post them to the general ledger + + + + + Status to 'Cancelled' (Change the status of the current + invoice to 'Cancelled') + + + + Save as Template (NOTE TO CHECK: Save the current invoice + format as a template) + + + + + + Find Invoices + + The default screen is for the Invoices tab is 'Find Invoices'. It + is used to locate existing invoices that have been created automatically + by the system or manually by the user. It can also be used to create a + new Sales or Purchase Invoice. + + + How do I view all invoices? + + Press the 'Search' button to view all invoices + + + + How do I locate an existing invoice? + + + + Enter the 'Invoice ID' if known + + + + Enter a word from the invoice description in the + 'Description' field if known + + + + Enter the 'Invoice Type' if known + + + + Enter the 'From Party Id' if known + In most cases for a Sales Invoices this will be Company. + For Purchase Invoice it will be the supplier party id + + + + + Enter the 'Billing Account Id' if known + + + + Enter the invoice status in the 'Status Id' field if + known + + + + Enter the 'To Party Id' if known + In most cases for a Purchase Invoice this will be + company. For Sales Invoices it will be the customer party + id + + + + + Press the 'Search' button to view all invoices + + + + All invoices that meet the search criteria will be + displayed. + + + + + + How do I update an invoice? + + + + Locate the invoice using the 'Find Invoices' screen + + + + Using the relevant sub menu make the required + changes. + + + + + + How do I delete an invoice? + + Invoices cannot be deleted through the user interface. They can + only be cancelled (eg if they have been entered or created by + mistake). + They can probably be deleted using Entity Data Maintenance + in the Webtools menu but this is not recommended for 2 + reasons: + + It may cause data integrity problems. + + + + It may cause data integrity problems. + + + + + + + + + Payments + + This feature lets the user locate payments by common + criteria. + + + + Payment Group + + Find payments by group. + + + + Transactions + + + + + + Payment Gateway Config + + + + + + Billing Accounts + + A billing account is a way of allowing customers to consolidate + several invoices into an account that is paid off at a later + date.Customers can be allocated a credit limit and orders can be taken up + to the value of the credit limit without any payment being made. + Statements to the customer can then be generated (eg monthly) and payment + is made based on the outstanding amount. + + + A billing account does not change the flow of the normal Invoice + and Payment processes. It simply allows for a more structured + organisation of Invoices and Payments. + + + Billing Accounts can be used for the following: + + + + Setting credit limits for customers + + + + Keeping track of credit available to customer for purchase on + account + + + + Keeping track of payments made in advance + Could also use Financial Account for advance payments but + need to understand the differences in functionality and + process + + + + + Keeping track of a subset of payments and invoices for a + specific client, i.e. allowing them to have multiple billing + accounts. + + + + Allow multiple authorised parties to bill against the same + account which one party is responsible for paying (e.g. different + offices of the same organisation may have one single account with a + supplier to make use of order volume discounts) + + + + Managing and generating customer statements + + + + Customer specific order tracking + + + + Accounts Receivable / Debt Management + + + + Analysis and monitoring customer spending (creditworthiness / + discounts / product popularity) + + + + + A payment that is applied (or matched) to a Billing Account it + should still be applied to an invoice. In the case where the payment + arrives before the invoice has been generated then once the invoice is + generated it should be applied to the payment or payments. + + + + Billing Account Orders + + This sub menu lists the details of any Sales Orders that have been + charged to the billing account. A Sales Order is charged to a billing + account by selecting the billing account as the Payment Method. + The details displayed here in conjunction with the 'Payments' + sub menu could also be used to generate a customer statement or + account showing details of customer activity during a specified time + period. + + + + + Billing Account Payments + + This sub menu allows the creation of a payment that is + automatically applied to the billing account. + + It is used when a payment has been received from a customer that + is used to pay off the balance (or part balance) of a billing + account. + + An example of how this works is similar to a credit card statement + where a list of transactions have been incurred over the previous month + and one payment is used to settle the outstanding balance. + + + How do I add a payment to a billing account? + + + + Select the 'Payments' sub menu + + + + The 'Create Payment' screen is displayed + + + + Enter or use the lookup to enter the 'From Party Id' (NOTE: + By default this will be the Bill To Party of the Billing + Account) + + + + Select the 'Organisation Party Id' from the drop down + box + + + + Select the 'Payment Type Id' from the drop down box (NOTE: + By default this will be set to 'Customer Deposit') + + + + Leave the 'Payment Method Type' as 'Billing Account' (NOTE + TO CHECK: What happens if you do change this....) + + + + Enter the 'Amount' of the payment + + + + Press the 'Create' button + + + + The new entry is displayed at the bottom of the screen. + The total amount of the payment will be applied to the + Billing Account. This can be verified by going to Accounting / + Payments menu and locating the newly created payment. The 'Amount + to Apply' column will be zero. + + + + + How do I update a payment for a billing account? + + A payment can be updated for a billing account by amending the + amount of the payment that has been applied to the billing account. + For example if a payment of $100 has been applied to a billing account + it can be amended so that only $75 will be applied and $25 will be + available to be applied elsewhere. + + + + Click on the 'Payment Id' of the payment that needs to be + removed + + + + The 'Payment Overview' screen is displayed + + + + Press the 'Update' button in the 'Payments Applied' + box + + + + The 'Payment Applications' screen is displayed + + + + Locate the 'Billing Account Id' and 'Amount Applied' + + + + Amend the 'Amount Applied' for the billing account + + + + Press the 'Update' button next to the entry that refers to + the 'Billing Account Id' + + + + A message will be displayed saying that the payment has been + removed from the billing account + + + + How do I delete a payment from a billing account? + + A payment can be removed from billing account by removing the + link that has applied the payment to the billing account. + + Click on the 'Payment Id' of the payment that needs to be + removed + + + + The 'Payment Overview' screen is displayed + + + + Press the 'Update' button in the 'Payments Applied' + box + + + + The 'Payment Applications' screen is displayed + + + + Press the 'Remove' button next to the entry that refers to + the 'Billing Account Id' + + + + A message will be displayed saying that the payment has been + removed from the billing account + The above example was done when the payment status was at + 'Not Paid' - need to test if it still works if the payment status + is at 'Received' or 'Confirmed' too. + + + + + + Billing Account Invoices + + The Billing Account Find Invoices screen displays by default a + list of invoices that have been charged to the billing account. + + Any invoice displayed here means that its invoice amount has been + deducted from the billing account credit limit.For example: If the + Billing Account Credit Limit is $100 and the there are 2 invoices + displayed with amounts $10 and $25 then the available credit for the + billing account will be $75. + + The invoice can be at various statues and there is an option to + locate an invoice by status. + + It is also used to apply any payments that have been made into the + Billing Account to an invoice. A 'Capture' button is displayed next to + each invoice displayed that has an amount outstanding. + + Example: + + + + Two invoices are charged to a Billing Account (Invoice A $10 + and Invoice B $25) + + + + A payment of $17 has been paid into the Billing Account + + + + If the Capture button is pressed for the invoice A then $10 of + the $17 payment will be applied to this invoice and a new payment + transaction of $7 will be created and available to apply to a + different invoice + + + + + How do I locate an invoice by status? + + + + Select the 'Invoices' sub menu + + + + Use the drop down box to select the 'Status Id' for the + invoice required + + + + Press the 'Submit' button + + + + A list of invoices with the required status will be + displayed + + + + How do I capture a payment for an invoice? + + + In order for this to work a payment needs to have been made + to the billing account that has not been completely applied to any + other invoices. Payments to a billing account can be done via the + 'Payments' sub menu for the billing account or by using Accounting + / Payments menu. + + + + + Select the 'Invoices' sub menu + + + + Locate the invoice required + The 'Amount to Apply' is the same as the 'Total' + column + + + + + Press the 'Capture' button + The 'Amount to Apply' is different to the 'Total' + column + + + + + The 'Capture' button is no longer displayed next to the invoice + and an additional payments transaction will be created for any + difference between the invoice total and the amount paid (Eg Invoice + Total $100, Payment Amount $125, the new payment transaction amount + will be $25) + The above example assumes that the payment available will + cover the total amount outstanding for the invoice + + + + + + + <para/> + </sect2> + </sect1> + + <sect1> + <title>Billing Account Terms + + This sub menu allows terms to be associated with a billing + account. Currently these can be the following: + + + + payment terms (discounted if paid within specified + days) + + + + payment terms (due on a specified day per month) + + + + payment terms (net days) + + + + penalty terms (late fee) + + + + penalty terms (collection agency fee) + + + + miscellaneous (non returnable sales item) + + + + + There is an overlap here with the terms that can be specified in + an agreement. Would a billing account party also have an agreement for + payment terms...? . + + + + How do I add terms to a billing account? + + + + Select the 'Terms' sub menu + + + + Select a 'Term Type' from the drop down box (eg. Payment net + days) + + + + Leave the 'UOM' field blank + + + + Enter a number in the 'Term Value' field (eg. 30 which would + mean '30 days' when related to 'Payment net days') + + + + Press the 'Save' button + + + + The term is displayed in the top part of the screen + + + + How do I update terms for a billing account? + + Select the 'Terms' sub menu + + Press the 'Edit' button next to the entry that needs to be + amended + + + + The details are displayed in the 'Edit Billing Account + Terms' box + + + + Update the 'Term Type', 'UOM' or 'Term Value' as + required + + + + Press the 'Save' button + + + + The updated term is displayed in the top part of the + screen + + + + How do I remove terms from a billing account? + + + + Select the 'Terms' sub menu + + + + Press the 'Delete' button next to the entry that needs to be + removed + + + + + + + Billing Account Roles + + This sub menu allows parties with specific roles to be associated + with to a Billing Account. Roles allows you to specify a party + role. + + It is used to specify which party should be billed for the billing + account. It can be used as follows: + + Simple billing account for a single party + + + + More complex billing account where multiple parties (eg + company subsidiaries) charge invoices to the billing account but a + different party (eg head office) will pay the account + + + + + How do I add a party role to a billing account? + + Select the 'Roles' sub menu + + + + Enter or use the lookup to select the 'Party Id' + + + + Select the 'Role Type Id' from the drop down box (eg Bill To + Customer) + + + + Leave the 'From Date' blank (NOTE: If left blank it will + default to the current date and time) + + + + Leave the 'Thru Date' blank + + + + Press the 'Add' button + + + + The new party role is displayed at the bottom of the + screen + + + + How do I update a party role for a billing account? + + The only field that can be updated for a party role is the 'Thru + Date'. If any other details need to be amended then the entry will + need to be deleted and then recreated. + + + + Select the 'Roles' sub menu + + + + Locate the entry that needs to be amended + + + + Enter or use the lookup to enter the 'Thru Date' + + + + Press the 'Update' button for the entry + + + + + + How do I delete a party role from a billing account? + + + + Locate the entry that needs to be deleted + + + + Press the 'Delete' button next to the entry + + + + The entry will be removed from the bottom of the + screen + + + + + + + Edit Billing Account + + The 'Account' sub menu is used to enter the basic details required + for setting up a new billing account or editing an existing one. + + It can be used to create or update the following details for a + Billing Account: + + + + Billing Account Identification + + + + Party to be Billed + + + + Billing Account Limit (NOTE: This is how much credit the + customer will be given eg $5000) + + + + Currency to be used for Billing Account + + + + Start and End Dates + + + + + There are currently two ways to add a party to a billing + account. + + + + Enter a party id in the 'Party Billed To' field + + + + Use the 'Roles' sub menu to add a party id with the role of + 'Bill To Customer' + + + + If using the first method then when you press the update + button this removes the party id from this field and automatically + creates the party under the Roles sub menu with the role of 'Bill + To Customer' + + + + + + How do I create a new Billing Account? + + Example: To create a new Billing Account + + + Check if the party doesnt have the role 'Bill To Customer' is + it automatically added when the billing account is created or will + the creation fail?.. + + + + + Press the 'New' button and the 'Edit Billing Account' screen + is displayed + + + + Enter a code or number for the 'Billing Account Id' + If this is left blank a number will be automatically + generated + + + + + Enter a number for the 'Billing Account Limit' (eg + 5000) + + + + Leave the 'Account Currency UOM Id' as it is + This should be the default currency for + Company... + + + + + Enter a description that can be used to identify the Billing + Account (eg Joe Bloggs Builders Billing Account) + + + + Leave the 'Contact Mech' field as it is + This field cannot be filled in until either the 'Party + Billed To' has been filled in or a party with the role of + 'Bill To Customer' has been added under the 'Roles' sub + menu. + + + + + Enter the Billing Account start date in the 'From Date' + field. + If left blank then this will default to the current date + and time. NOTE TO CHECK: Can this date be in the + future.....? + + + + + Leave the 'Thru date' field blank + + + + Enter or use the lookup to select the 'Party Billed + To' + + + + Press the 'Update' button + + + + After the 'Update' button has been pressed then the 'Contact + Mech Id' field will either be automatically filled in or will allow + you to select a contact mech from a drop down list + + + + How do I update an existing Billing Account? + + Billing Account details can be updated. A key field that may + need to be updated is the actual Billing Account Limit if a customer + reduces or improves their credit rating + + Example: To Update a Billing Account + + + + Click on the 'Billing Account Id' of the Billing Account to + updated + + + + The 'Edit Billing Account' screen is displayed + + + + Enter the changes required + + + + Press the 'Update' button + + + + + + How do I delete a Billing Account? + + Billing Accounts cannot be deleted. They can only be expired. + This means that they will no longer be able to be used to associate + invoices or payments against. + + Example: To Expire a Billing Account + + + + Click on the 'Billing Account Id' of the Billing Account to + be expired + + + + The 'Edit Billing Account' screen is displayed + + + + Enter the current date in the 'Thru date' field + + + + Press the 'Update' button + + + + + + + Find Billing Account + + The default screen is for the Billing Account tab is 'Find Billing + Account'. It is used to locate existing billing accounts that have been + created. + + The user has the option to select an existing billing account or + create a new one by clicking on the 'New' button. + + + + + Financial Account + + A financial account is a tool (similar to bank account statement) + that is used for monitoring monetary transactions. Normally they will be + linked to a party and the various transactions details (eg payments or + receipts) will be shown as entries. + + The entries for a financial account can be displayed using the + 'Financial Account' tab in Accounting or in Party Manager if you enter a + party as the owner of the financial account. + + Currently in OFBiz financial accounts can have the following + types: + + + + Bank Account (by default this type will post to 213500 CUSTOMER + DEPOSIT ACCOUNTS) + + + + Deposit Account (by default this type will post to 213500 + CUSTOMER DEPOSIT ACCOUNTS) + + + + Gift Certificate (by default this type will post to 213200 GIFT + CERTIFICATES UNREDEEMED) + + + + Investment Account (by default this type will post to 213500 + CUSTOMER DEPOSIT ACCOUNTS) + + + + Replenish Account (no default posting account in demo data + setup) + + + + Service Credit Account (no default posting account in demo data + setup) + + + + + : + + + + In GL Account Defaults there is a specific tab 'FinAccount + Type Gl Account' for specifying which type of Financial accounts are + posted to which general ledger account. + + + + In GL Account Defaults there is also a tab 'Payment Method Id + / GL Account ID' for specifying the account to post transactions to + if 'Financial Account' is selected as the Payment Method instead of + (Cash, Cheque, Credit Card, etc). By default the demo setup posts + transactions to 111100 GENERAL CHECKING ACCOUNT. + + + + + You can also setup each financial account to post to a specific + general ledger account for each party. This is done via a specific field + during the creation or update of a financial account. This will override + the default setting by type. + + Financial Accounts can be used for the following + + + + Managing and Tracking Customer Prepaid Accounts + + + + Managing and Tracking Customer Credit Limit + Need to verify this + + + + + Managing Electronic Gift Certificates / Gift Vouchers/ Gift + Card + + + + Reload of Electronic Gift Card + + + + Company Bank Account Transaction Tracking + + + + + Financial Account Main Screen + + The default screen for Financial Accounts displays a list of any + bank accounts that have been created. Details listed include the account + the following: + + + + account name + + + + organisation the account is linked to + + + + account balances (available and actual) + + + + + + Find Financial Account Reconciliations + + This screen displays the details of any reconciliations in + progress for a financial account. Only reconciliations that have actual + transactions associated with them will be displayed. If a reconciliation + group has no transactions assigned to it then it will not be + displayed. + + + + View GL Reconciliation + + This screen gives an overview of a reconciliation group / bank + reconciliation. Note that a reconciliation must have at least one + transaction associated with it for this screen to be displayed. It is + used as follows: + + + + to view transactions associated with a reconciliation group / + bank reconciliation + + + + to remove transactions from a reconciliation group / bank + reconciliation + + + + to reconcile the reconciliation group / bank + reconciliation + + + + The screen displays the current reconciliation details plus + details of the previous reconciliation if one exists. This ensures the + closing balance of the previous reconciliation is the same as the + opening balance for the current one. + + + How do I edit reconciliation? + + + + Press the 'Edit' button in the 'Current Bank + Reconciliation'part of the screen + + + + The 'Edit Financial Account Reconciliations' screen + isdisplayed + + + + Update the details required + + + + Press the 'Update' button + + + + + + How do I remove a transaction from a bank + reconciliation? + + On the lower part of the screen a list of all transactions + associated with the reconciliation is displayed. + + + + Press the 'Remove' button next to the entry that needs to be + removed + + + + The transaction is removed + + + + + + How do I reconcile a bank reconciliation? + + + + A total of all transactions associated with the + reconciliation is shown in the lower part of the screen + + + + Press the 'Reconcile' button next to the total + + + + Each transaction status will be changed to 'Approved' and + the reconciliation / bank reconciliation status will be changed to + 'Reconciled' + This means that no new transactions can be added to this + reconciliation and it will no longer be available to assign + transactions to + + + + + + + + Edit Financial Account Reconciliations + + This screen is used to create or update a reconciliation group / + bank reconciliation. The following details can be input or updated for + the reconciliation: + + + + GL Reconciliation Name or Identifier + + + + Description for the reconciliation + + + + Organisation Party Id for the reconciliation + + + + Opening Balance for the reconciliation + + + + Reconciliation date + + + + + + Deposit Slips + + This section describes how to create, find, and edit deposit + slips. + + + New Deposit Slip + + This screen allows the user to create an Payment Group and the + transactions associated with the Payment Group will generate a deposit + slip. . + + + How do I create a New Deposit Slip? + + + + Press the 'Find' button to list all the available + transactions + + + + Select the transactions to include in the Payment Group by + using the 'Select All' or the check box that corresponds to the + transactions required + + + + Enter a 'Payment Group Name' if required (If none is + entered then by default this will be 'Payment Group + Name') + + + + Press the 'Create Batch' button + + + + A button to print the deposit slip will be displayed as + well as the edit screen to make any further changes to the + Payment Batch + + + + + + + Find Deposit Slips + + This screen is used to locate payment groups and their + associated deposit slips that have been created. Deposit slips are + created by grouping transactions together into a Payment Group. This + can be done using the 'Accounting / Payment Group' tab, the 'Financial + Account / Deposit Withdraw' tab or the 'Create New Deposit Slip' + button. + + Currently Deposit Slips are created for AR Batch Payments + only. + + The deposit slips are available in PDF format and there is an + option to cancel the batch that generated the deposit slip if + required. + + + How do I locate an existing Deposit Slip? + + Enter some characters from the 'Payment Group Id' or 'Payment + Group Name' if known + + Press the 'Search' button + + + + How do I update an existing Deposit Slip? + + + + Locate the Payment Group required + + + + Select the Payment Group by clicking on the Payment + Group Id + + The 'Edit Payment Group' screen is displayed Add any + new payment deposits or update existing deposits for the Payment + Group All changes in the Payment Group will automatically be updated + to the Deposit Slip + + + + How do I delete an existing Deposit Slip? + + A deposit slip can not be directly deleted but it is removed + when a Payment Group is cancelled Press the 'Cancel' button next to + the Payment Group required to cancel a payment group The Payment + Group is removed from the 'Find Deposits' screen and no deposit + slips can be viewed or printed. + + + + + Edit Deposit Slip + + This screen displays the details of a Payment Group and its + transactions. The Deposit Slip for the Payment Group can be printed if + required and the Payment Group itself can be updated. Details that can + be updated include the name of the Payment Group itself and the + addition, removal or update of transactions. + + + Any changes to the Payment Group will be automatically updated + to the Deposit Slip. + + + + How do I update a Deposit Slip? + + + + Select the Payment Group required + + + + Update the 'Payment Group Name' if required + + + + Use the lookup for 'Payment Id' to add new transactions to + the Payment Group if required + + + + Use the 'Cancel' button next to a particular transaction + to remove it from the Payment Group + + + + Press the 'Update' or 'Add' buttons as required + + + + Press the 'Print Deposit Slip' button + + + + The Deposit Slip will be displayed with the latest details of + the transactions for the Payment Group + + + + + + Financial Account Deposit / Withdraw + + By default this screen will display all payment transactions both + incoming and outgoing that have not already been associated with a + financial account that represents one of the company's bank + accounts. + + This screen also gives the option to create new deposit or + withdrawal payments. The user can select a number of incoming deposit + payments (eg Customer Payments etc) and group them together into a + payment group (i.e AR Batch of Payments) that will create a 'deposit + slip'. + + If you select a number of incoming payments and dont group them + then no payment group is created (and therefore not deposit slip either) + but the individual transactions will be created for the 'bank account' + financial account. + + Note that outgoing payments cannot be grouped together and will + not create a 'deposit slip'. + + + How do I list Deposit or Withdrawal Payments not linked to a + Bank Account? + + Press the 'Find' button on the 'Deposit/Withdraw' screen. + + All deposit and withdrawal transactions not associated with a + bank 'financial account' will be displayed. + + + + How do I group payments and create a deposit slip? + + + + Press 'Find' to list all Deposit or Withdrawal + payments + + + + Use the 'Select All' or click on the check box associated + with the transactions required + + + + Enter a name for the Payment Party Group Name (eg XYZ + Deposits) to group the transactions together + + + + Press the 'Deposit/Withdraw' button + + + + A deposit will be created that can be viewed under the 'Deposit + Slip' tab and grouped transaction will be created under the + 'Transactions' tab with a link to the deposit slip breakdown + + + + + Financial Account Authorizations + + An authorization is a temporary transaction showing a commitment + to take money from a financial account. It is like a 'transaction in + progress' where there can be delay between when you buy something and + the time it actually appears on your statement. + + Authorizations can be time limit specific meaning that they can be + controlled by entering a start and end date so that they are only valid + for a certain length of time. They can also be expired. When an + authorization is expired it removes the commitment from the financial + account. The history of expired authorizations are shown on the + financial account. + + + This could be very useful in ensuring that customers are not + overcommitted and keeping within their approved credit limits. + + + + How do I add an authorization? + + + + Enter an amount in the 'Amount' field (Eg 1000) + + + + Leave the 'Currency' field blank as the default currency + will be used + + + + Enter a date in the 'Authorisation Date' field + + + + Leave the 'From Date' field blank + + + + Leave the 'Thru Date' field blank + + + + Press the 'Add' button + When you now view the Financial Account detail the + 'Actual Balance' and 'Available Balance' fields will be + different. + + + + + + + How do I update an authorization? + + An authorization cannot be updated. It can only be expired. If + you have made a mistake and need to change an authorization then it + needs to expired and then re-created correctly. + + + + How do I delete an authorization? + + Authorizations are not deleted they are instead expired. This + means that the history of the authorizations will remain on the + account as an audit trail. + + Example: To expire an authorisation + + + + Select the 'Authorizations' tab for the Financial + Account + + + + Any authorizations will be displayed at the bottom of the + screen + + + + If the authorization is still current the 'Thru Date' field + will be blank + CHECK: May not always be true as you can specify a + future date for it to expire......!!! + + + + + Select the 'Expire' button next to the authorisation to be + expired + + + + The authorization is removed from the financial account and the + screen is redisplayed with the 'Thru Date' field completed + + + + + Find Financial Account Transactions + + A transaction is an entry that is shown on the financial account. + Transactions can be one of the following types: + + + + Deposits + + + + Withdrawals + + + + Adjustments + + + + Transactions are used to show entries and the financial history of + the financial account. Similar to a bank account or credit card + statement the transaction will show details of what was spent or paid + into the account. + + Some transaction totals have been added to this screen to help as + part of the reconciliation processes. Additional details available + include number of transactions, transaction totals and status. + + + How do I find transactions for a Financial Account? + + + + Press the 'Search' button + + + + A list of transactions for the financial account will be + displayed + + + + + + Financial Account Bank Reconciliation + + Bank Reconciliation is a regular task where transactions from + the company bank statement are matched against transactions that have + occurred in the General Ledger. This is done based on a specific + date(NOTE: This can be done daily, weekly but is usually an end of + month). A specific GL account is normally used to represent the + company bank account and any accounting transaction that involves the + bank account will automatically record and entry in the GL + + The bank reconciliation process ensures that the GL account and + the bank statement reconcile to the same amounts. Differences can + occur between the GL and the bank statement for a variety of valid + reasons including the following: + + + + Payments or Deposits in process (especially cheques) + + + + Interest or Bank Charges that are not known in advance but + are applied to the bank account + + + + Currency or Exchange Rate variations / charges + + + + Any outstanding + + + + + The differences will occur because of timing differences of + when and how transactions are recorded. Examples are as + follows: + + + + Bank charges are known to the bank first and only once + they have applied the charge to the bank account can the company + duplicate the transaction in the GL to make the balance + reconcile. + + + + A customer cheque payment may be recorded in the GL first + before it is paid into the bank account + + + + + + How do I create a Bank Reconciliation? + + The bank reconciliation process is made up of 3 steps. + + + + Creating an account reconciliation group + + + + Assigning transactions to the reconciliation + + + + Validating the figures and confirming the + reconciliation + + + + + + How do I create an account reconciliation group for Bank + Reconciliation? + + + + Go to the Financial Account 'Reconciliation' sub menu for + the bank account to be reconciled + + + + Press the 'Create New Financial Account Reconciliations' + button + + + + Complete the details (eg name, description, organisation + and opening balance) required on the 'Add New Financial Account + Reconciliations' screen and press the 'Create' button + + + + The new account reconciliation group is created and may be + used to assign transactions to + + + + + + How do I locate transactions that have not been assigned to a + Bank Reconciliation? + + + + Go to the Financial Account 'Transactions' sub menu of the + bank account to be reconciled + + + + The 'Find Transactions For Financial Account: XXXX' is + displayed + + + + Use the dropdown box for 'GL Reconciliation Id' field to + select 'Not Assigned' and then press the 'Search' button + + + + A list of transactions (deposits, withdrawals or + adjustments) that have not been reconciled will be displayed + (NOTE: If no transactions are displayed then there are no + transactions to reconcile) + + + + Click on the 'check box' at the end of the transaction + line that corresponds to the entry that needs to be assigned + (NOTE:More than one transaction can be selected at a + time) + + + + Above the 'check box' is the 'Assign to Reconciliation' + button and to the left of this is a dropdown box to select the + reconciliation that the transaction is to be assigned to. + + + + Using the drop down box select the reconciliation required + and press the 'Assign to Reconciliation' button + + + + The transaction is removed from the 'Not Assigned' status + and added to the specified reconciliation group + + + + + + How do I validate and confirm the Bank + Reconciliation? + + Validation can be done for individual transactions or for the + complete account reconciliation group. The user controls this by the + search criteria entered on this screen. + + + + Go to the 'Transactions' sub menu for the bank account and + press the 'Bank Reconciliation' button + + + + Select the 'GL Reconciliation Id' that is to be + reconciled + + + + Click on the 'Select All' check box on the right hand side + of the screen. (NOTE: All transactions in this group will be + reconciled) + + + + Press the 'Reconcile' button above the 'Select All' check + box + + + + + + How do I view a Bank Reconciliation? + + Once all the transactions in a reconciliation group have been + reconciled then the status of the group is changed to 'Reconciled'. + This means that no new transactions can be added to the is group and + the reconciled balance is fixed. + + + + Go to the 'Reconciliation' sub menu for the bank + account + + + + A list of all the bank reconciliation groups are displayed + with details of the status (eg Created or Reconciled) [... 3941 lines stripped ...]