gnucash-docs maint: Multiple changes pushed
John Ralls
jralls at code.gnucash.org
Sun Sep 20 15:01:56 EDT 2015
Updated via https://github.com/Gnucash/gnucash-docs/commit/acff0249 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/8b6523c1 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/24c0c1d5 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/bbe8ccc6 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/3c6be9c5 (commit)
from https://github.com/Gnucash/gnucash-docs/commit/dafa837c (commit)
commit acff024922cb8442ea9e918aee09d413d3001533
Author: Chris Good <chris.good at ozemail.com.au>
Date: Sun Sep 20 15:38:42 2015 +1000
Help Business Setp, add ref to Pref, Business Bug 705309
diff --git a/help/C/Help_ch_Business.xml b/help/C/Help_ch_Business.xml
index 7dd5b57..7e57cbc 100644
--- a/help/C/Help_ch_Business.xml
+++ b/help/C/Help_ch_Business.xml
@@ -152,6 +152,15 @@
</para>
</sect2>
+ <sect2 id="busnss_setup_pref">
+ <title>Business Preferences</title>
+ <para>Set options on the Business tab of the <application>&app;</application> preferences, which is
+ accessed via <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>
+ (<menuchoice><guimenu>GnuCash</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> on Mac OS X).
+ See <xref linkend="prefs-biz" />.
+ </para>
+ </sect2>
+
<sect2 id="busnss-ar-setupterms">
<title>Billing Terms</title>
commit 8b6523c193e14b9e5f27cf3247c003016bd874d8
Author: Chris Good <chris.good at ozemail.com.au>
Date: Sun Sep 20 12:21:19 2015 +1000
Dummy commit to remove renamed png files Bug 705309
diff --git a/guide/C/figures/bus_ar_co_reg.png b/guide/C/figures/bus_ar_co_reg.png
deleted file mode 100644
index 60c56b6..0000000
Binary files a/guide/C/figures/bus_ar_co_reg.png and /dev/null differ
diff --git a/guide/C/figures/bus_ar_tax_main.png b/guide/C/figures/bus_ar_tax_main.png
deleted file mode 100644
index 077237e..0000000
Binary files a/guide/C/figures/bus_ar_tax_main.png and /dev/null differ
diff --git a/guide/C/figures/bus_ar_tax_new.png b/guide/C/figures/bus_ar_tax_new.png
deleted file mode 100644
index 3683251..0000000
Binary files a/guide/C/figures/bus_ar_tax_new.png and /dev/null differ
diff --git a/guide/C/figures/bus_ar_terms_main.png b/guide/C/figures/bus_ar_terms_main.png
deleted file mode 100644
index c66d47d..0000000
Binary files a/guide/C/figures/bus_ar_terms_main.png and /dev/null differ
diff --git a/guide/C/figures/bus_ar_terms_new.png b/guide/C/figures/bus_ar_terms_new.png
deleted file mode 100644
index 4e9ae3b..0000000
Binary files a/guide/C/figures/bus_ar_terms_new.png and /dev/null differ
commit 24c0c1d517ee830b74b1848f5bbb0fc3eedac577
Author: Chris Good <chris.good at ozemail.com.au>
Date: Sun Sep 20 10:39:44 2015 +1000
Document Billing Terms Editor and Tax Table Editor Bug 705309
diff --git a/guide/C/Makefile.am b/guide/C/Makefile.am
index b215ba0..b054d19 100644
--- a/guide/C/Makefile.am
+++ b/guide/C/Makefile.am
@@ -16,6 +16,8 @@ entities = \
ch_capgain.xml \
ch_currency.xml \
ch_dep.xml \
+ ch_bus_intro.xml \
+ ch_bus_setup.xml \
ch_bus_ar.xml \
ch_bus_ap.xml \
ch_bus_pay.xml \
diff --git a/guide/C/ch_bus_ap.xml b/guide/C/ch_bus_ap.xml
index 59902f5..03b2879 100644
--- a/guide/C/ch_bus_ap.xml
+++ b/guide/C/ch_bus_ap.xml
@@ -2,12 +2,13 @@
(Do not remove this comment block.)
Originally designed by Carol Champagne.
Version: 2.0.0
- Last modified: July 9th 2006
+ Last modified: Sep 19th 2015
Maintainers:
Chris Lyttle <chris at wilddev.net>
Author:
Jon Lapham <lapham at extracta.com.br>
updated Patrick Schweiger <pks at spiffykitty.com>
+ Chris Good <chris.good at ozemail.com.au>
Translators:
(translators put your name and email here)
-->
@@ -17,208 +18,117 @@ A lot of the following text is duplicated in the GnuCash help. The text here in
corrected to be less describing of the interface and more tutorial oriented
-->
- <chapter id="chapter_bus_ap">
- <title>Accounts Payable</title>
- <para>Accounts Payable (or A/P) refers to the accounting of products or services which a company has bought and needs to pay for.</para>
-
- <sect1 id="bus-ap-concepts1">
- <title>Basic Concepts</title>
- <para>This chapter focuses on Accounts Payable (or A/P). A/P refers to the accounting of products or services that your company has bought, for which payment needs to be scheduled.</para>
- </sect1>
-
- <sect1 id="bus-ap-setup1">
- <title>Initial Setup</title>
- <para>To set up <application>&app;</application> to handle accounts payable for a company, four
- preliminary things must be done. The first is to build an appropriate
- Account Hierarchy. The second is set up tax tables. The third is to register the company in
- <application>&app;</application>. The fourth is to set up billing terms.
+<chapter id="chapter_bus_ap">
+ <title>Accounts Payable</title>
+ <para>Accounts Payable (or A/P) refers to the accounting of products or services which a company has
+ bought and needs to pay for.
</para>
-
- <sect2 id="bus-ap-setupacct2">
- <title>Account Setup</title>
-
- <para>There are many different ways to set up a business account
- hierarchy. You can start with the Business Accounts setup which is
- available from the New Account Hierarchy assistant, or you could build one
- manually. To access the prebuilt Business Accounts, start <application>&app;</application> and
- click on <menuchoice><guimenu>File</guimenu><guimenuitem>New File</guimenuitem></menuchoice> and
- proceed until you see the list of available accounts, select Business
- Accounts.</para>
-
- <para>The prebuilt Business Account hierarchy will not meet your needs
- exactly. You will need make adjustments for the hierarchy to function
- well with your particular situation. It should be close enough that it
- is recommended you begin with it.</para>
-
- <para>Accounts Payable (or A/P) refers to products or services bought by your company for which payment has not yet been sent. This is represented on the balance sheet as a liability because you will have to pay for them. To use <application>&app;</application>’s integrated accounts payable system, you must first setup an account of the <emphasis>A/Payable</emphasis> type. The <emphasis>A/Payable</emphasis> account is usually a sub-account under Liabilities. It is within this account that the integrated A/P system places transactions.</para>
- <literallayout>
-Basic A/P Account Hierarchy:
-
--Assets
- -Bank
--Liabilities
- -Accounts Payable
- -Tax
- -Tax on Purchases
- -Tax on Sales
--Expenses
- -AP Expenses
- </literallayout>
-
- <para>You need to add additional asset accounts and real expense accounts to make this hierarchy useful.
- The important aspects of this hierarchy are that you need an expense account and an Accounts Payable account, with account type set to <emphasis>A/Payable</emphasis>.
- </para>
-
- <para>Transactions involving an Accounts Payable account should not be added,
- changed or deleted in any way other than by using
- <itemizedlist>
- <listitem><para>post/unpost bill/invoice/voucher or</para></listitem>
- <listitem><para>process payment</para></listitem>
- </itemizedlist>
- </para>
-
- </sect2>
-
- <sect2 id="bus-ap-setuptaxtables">
- <title>Tax Tables</title>
-
- <para>Vendor tax tables are set up in the same way as Customer tax tables. As the account tax is
- posted to, is specified on each tax table, to keep transactions for tax collected from customer sales
- separate from tax paid for vendor purchases, set up distinct tax tables for customers and vendors.
- See <xref linkend="bus-ar-setuptaxtables" />
- </para>
-
- </sect2>
-
- <sect2 id="bus-ap-setupcname2">
- <title>Company Registration</title>
-
- <para>After you have built the account structure, and defined your tax tables, register the <application>&app;</application>
- file as belonging to your company. To register your company, select the <guilabel>Business</guilabel> tab
- in the <guilabel>Book Options</guilabel> window accessible by selecting
- <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem>
- </menuchoice>:</para>
-
- <itemizedlist>
- <listitem>
- <para>Enter the name of your company along with contact information
- such as your phone number, fax number, e-mail address and website
- URL.</para>
- </listitem>
-
- <listitem>
- <para>Enter your company’s tax payer id number in the
- <guilabel>Company ID</guilabel> field.</para>
- </listitem>
-
- <listitem>
- <para>Set the default tax table applicable to most vendors.</para>
- </listitem>
-
- </itemizedlist>
- </sect2>
-
- <sect2 id="bus-ap-setupterms">
- <title>Billing Terms</title>
-
- <para>Vendor billing terms are set up in the same way as Customer billing terms.
- See <xref linkend="bus-ar-setupterms" />
+
+ <sect1 id="bus-ap-setup1">
+ <title>Initial Setup</title>
+ <para>Perform set up tasks listed in <xref linkend="chapter_bus_setup" />.
</para>
-
- </sect2>
</sect1>
<sect1 id="bus-ap-components1">
- <title>System Components</title>
- <para><application>&app;</application> has an integrated accounts payable system. The transactions generated by the A/P system are placed within the Accounts Payable account,
- as a record of what occurs. Generally you do not directly work with this account but use the four integrated <application>&app;</application> A/P application components.
- The A/P components are available from the <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu></menuchoice> sub-menu. These A/P components are:</para>
+ <title>System Components</title>
+ <para><application>&app;</application> has an integrated accounts payable system. The transactions generated by the A/P system are placed within the Accounts Payable account,
+ as a record of what occurs. Generally you do not directly work with this account but use the four integrated <application>&app;</application> A/P application components.
+ The A/P components are available from the <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu></menuchoice> sub-menu. These A/P components are:
+ </para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Vendors</guilabel> are people or companies from which you buy products or services on credit.</para>
- </listitem>
- <listitem>
- <para><guilabel>Bills</guilabel> represent the physical bills vendors send to request payment from you. A bill contains an itemized list of things you purchased.</para>
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Vendors</guilabel> are people or companies from which you buy products or services on credit.</para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Bills</guilabel> represent the physical bills vendors send to request payment from you. A bill contains an itemized list of things you purchased.</para>
<para>In addition, GnuCash also has support for <guilabel>Credit Notes</guilabel>
- which represent the inverse of Bills. A credit note is usually received from
- a vendor to correct items that were erroneously billed or returned.</para>
+ which represent the inverse of Bills. A credit note is usually received from
+ a vendor to correct items that were erroneously billed or returned.
+ </para>
<para>Both document types will be set up using the same menu items.</para>
- </listitem>
- <listitem>
- <para><guilabel>Jobs</guilabel> (optional) is where you register Vendor Jobs. Jobs are mechanism by which you can group multiple bills from a particular vendor.</para>
- </listitem>
- <listitem>
- <para><guilabel>Process Payments</guilabel> is where you register payments to a vendor to whom you owe money.</para>
- </listitem>
- </itemizedlist>
-
- <para>The following sections introduce the individual Accounts Payable application components.</para>
- </sect1>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Jobs</guilabel> (optional) is where you register Vendor Jobs. Jobs are mechanism by which you can group multiple bills from a particular vendor.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para><guilabel>Process Payments</guilabel> is where you register payments to a vendor to whom you owe money.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>The following sections introduce the individual Accounts Payable application components.</para>
+ </sect1>
<sect1 id="bus-ap-vendors1">
- <title>Vendors</title>
- <para>A vendor is a company or person from whom you purchase goods or services. Vendors must be registered within the A/P system.</para>
+ <title>Vendors</title>
+ <para>A vendor is a company or person from whom you purchase goods or services. Vendors must be registered within the A/P system.</para>
- <sect2 id="bus-ap-vendornew2">
- <title>New</title>
- <para>To register a new vendor, select the <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>New Vendor</guimenuitem></menuchoice> menu item. Fill in general information about the vendor, such as Company Name, Address, Phone, Fax, etc. Below is a list of the other options: </para>
-
- <para>This is what the New Vendor registration window looks like:</para>
- <screenshot id="bus-ap-vendornew">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/bus_ap_vendornew.png"
- srccredit="Patrick Schweiger" format="PNG"/>
- </imageobject>
- <textobject>
- <phrase>New Vendor Registration Window</phrase>
- </textobject>
- <caption>
- <para>New Vendor Registration Window
- </para>
- </caption>
- </mediaobject>
- </screenshot>
-
- </sect2>
- <sect2 id="bus-ap-vendorfind2">
- <title>Find and Edit</title>
-
- <para>To search for an existing vendor, use the <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>Find Vendor</guimenuitem></menuchoice> window. You select a vendor to <guibutton>View/Edit</guibutton> from the results of the search. This window is also used to look up a vendor when entering bills and processing payments.</para>
- <screenshot id="bus-ar-vendorfind">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/bus_ap_vendorfind.png"
- srccredit="Patrick Schweiger" format="PNG"/>
- </imageobject>
- <textobject>
- <phrase>Find Vendor Window</phrase>
- </textobject>
- <caption>
- <para>Find Vendor Window
- </para>
- </caption>
- </mediaobject>
- </screenshot>
+ <sect2 id="bus-ap-vendornew2">
+ <title>New</title>
+ <para>To register a new vendor, select the <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>
+ New Vendor</guimenuitem></menuchoice> menu item. Fill in general information about the vendor, such as Company Name, Address, Phone,
+ Fax, etc. Below is a list of the other options: </para> <para>This is what the New Vendor registration window looks like:
+ </para>
+ <screenshot id="bus-ap-vendornew">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/bus_ap_vendornew.png" srccredit="Patrick Schweiger" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>New Vendor Registration Window</phrase>
+ </textobject>
+ <caption>
+ <para>New Vendor Registration Window</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </sect2>
+
+ <sect2 id="bus-ap-vendorfind2">
+ <title>Find and Edit</title>
- <para>If many vendors match the search criteria you provide, the
+ <para>To search for an existing vendor, use the <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>
+ Find Vendor</guimenuitem></menuchoice> window. You select a vendor to <guibutton>View/Edit</guibutton> from the results of the search.
+ This window is also used to look up a vendor when entering bills and processing payments.
+ </para>
+ <screenshot id="bus-ar-vendorfind">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/bus_ap_vendorfind.png" srccredit="Patrick Schweiger" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Find Vendor Window</phrase>
+ </textobject>
+ <caption>
+ <para>Find Vendor Window</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+
+ <para>If many vendors match the search criteria you provide, the
search can be refined by running an additional search within the current
results. The current result set is searched when the <guilabel>Refine
Current Search</guilabel> radio button is selected. In fact, <application>&app;</application>
selects this option for you after you run the initial search.</para>
- <para>If the vendor you are searching for does not match the supplied
+ <para>If the vendor you are searching for does not match the supplied
search criteria, change the search criteria, click the <guilabel>New
Search</guilabel> radio button and then the <guibutton>Find</guibutton>
button. The relevant step is the <guilabel>New Search</guilabel>
selection. If the vendor is not in the result of the original search,
and you only search within this set, the vendor cannot be found,
- regardless of new search criteria.</para>
+ regardless of new search criteria.
+ </para>
- <note>
- <para>To return a list of all registered active vendors, set the search criterion to <guilabel>matches regex</guilabel>, and place a single dot <quote>.</quote> in the text field area. Make sure <guilabel>Search only active data</guilabel> is checked, then click <guibutton>Find</guibutton>. The regular expression <quote>.</quote> means to match anything.</para>
- </note>
+ <note>
+ <para>To return a list of all registered active vendors, set the search criterion to <guilabel>matches regex</guilabel>, and place a single dot <quote>.</quote> in the text field area. Make sure <guilabel>Search only active data</guilabel> is checked, then click <guibutton>Find</guibutton>. The regular expression <quote>.</quote> means to match anything.
+ </para>
+ </note>
</sect2>
</sect1>
@@ -239,72 +149,70 @@ Basic A/P Account Hierarchy:
</note>
<sect2 id="bus-ap-billnew2">
- <title>New</title>
- <para>When you receive a bill from a vendor and want to enter it into <application>&app;</application>, you must create a new bill. To create a new bill use the <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>New Bill</guimenuitem></menuchoice> menu item, and fill in the resulting window appropriately.</para>
- <screenshot id="bus-ap-billnew">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/bus_ap_billnew.png"
- srccredit="Patrick Schweiger" format="PNG"/>
- </imageobject>
- <textobject>
- <phrase>New Bill Registration Window</phrase>
- </textobject>
- <caption>
- <para>New Bill Registration Window
- </para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <para>When you click the <guibutton>OK</guibutton> the <guilabel>Edit Bill</guilabel> opens.</para>
+ <title>New</title>
+ <para>When you receive a bill from a vendor and want to enter it into <application>&app;</application>, you must create a new bill. To create a new bill use the <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>New Bill</guimenuitem></menuchoice> menu item, and fill in the resulting window appropriately.</para>
+ <screenshot id="bus-ap-billnew">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/bus_ap_billnew.png" srccredit="Patrick Schweiger" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>New Bill Registration Window</phrase>
+ </textobject>
+ <caption>
+ <para>New Bill Registration Window
+ </para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+
+ <para>When you click the <guibutton>OK</guibutton> the <guilabel>Edit Bill</guilabel> opens.</para>
</sect2>
<sect2 id="bus-ap-billedit2">
- <title>Edit</title>
- <para>From the Edit Bill window you can enter an itemized list of
+ <title>Edit</title>
+ <para>From the Edit Bill window you can enter an itemized list of
goods and services you purchased, in a manner similar to how the account
register works. For credit notes you enter an itemized list of goods and
- services the vendor refunded instead.</para>
- <screenshot id="bus-ap-billedit">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/bus_ap_billedit.png"
- srccredit="Patrick Schweiger" format="PNG"/>
- </imageobject>
- <textobject>
- <phrase>Edit Bill Window</phrase>
- </textobject>
- <caption>
- <para>Edit Bill Window</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <para>When you have finished entering all the items, <guilabel>Post</guilabel> the bill. </para>
-</sect2>
+ services the vendor refunded instead.
+ </para>
+ <screenshot id="bus-ap-billedit">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/bus_ap_billedit.png" srccredit="Patrick Schweiger" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Edit Bill Window</phrase>
+ </textobject>
+ <caption>
+ <para>Edit Bill Window</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+
+ <para>When you have finished entering all the items, <guilabel>Post</guilabel> the bill. </para>
+ </sect2>
<sect2 id="bus-ap-billpost2">
- <title>Post</title>
- <para>When you finish editing a bill, you should <guilabel>Post</guilabel> the bill. You do not have to post the bill,
+ <title>Post</title>
+ <para>When you finish editing a bill, you should <guilabel>Post</guilabel> the bill. You do not have to post the bill,
you can close it and return to it later. You have to post the bill eventually. Posting a bill places its transactions into an accounts payable account.
- The Post Bill window appears and asks you to enter information:</para>
-
- <screenshot id="bus-ap-billpost">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/bus_ap_billpost.png"
- srccredit="Patrick Schweiger" format="PNG"/>
- </imageobject>
- <textobject>
- <phrase>Post Bill Window</phrase>
- </textobject>
- <caption>
- <para>Post Bill Window
- </para>
- </caption>
- </mediaobject>
- </screenshot>
+ The Post Bill window appears and asks you to enter information:
+ </para>
+
+ <screenshot id="bus-ap-billpost">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/bus_ap_billpost.png" srccredit="Patrick Schweiger" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Post Bill Window</phrase>
+ </textobject>
+ <caption>
+ <para>Post Bill Window</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
</sect2>
<sect2 id="bus-ap-billfind2">
@@ -321,24 +229,29 @@ Basic A/P Account Hierarchy:
</sect1>
<sect1 id="bus-ap-jobs1">
- <title>Vendor Jobs</title>
- <para>Vendor Jobs are used to group multiple bills and credit notes from a single vendor. Use of the vendor jobs feature is optional. The feature is useful when you have multiple <guilabel>jobs</guilabel> for the same vendor, and would like to view all the bills and credit notes for a single job.</para>
- <para>To use vendor jobs, you must create them using the <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>New Job</guimenuitem></menuchoice> menu item. You will see the <guilabel>New Job</guilabel> window.</para>
-
- <screenshot id="bus-ap-jobnew">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/bus_ap_jobnew.png"
- srccredit="Jon Lapham" format="PNG"/>
- </imageobject>
- <textobject>
- <phrase>New Vendor Job</phrase>
- </textobject>
- <caption>
- <para>New Vendor Job</para>
- </caption>
- </mediaobject>
- </screenshot>
+ <title>Vendor Jobs</title>
+ <para>Vendor Jobs are used to group multiple bills and credit notes from a single vendor. Use of the vendor jobs feature is optional.
+ The feature is useful when you have multiple <guilabel>jobs</guilabel> for the same vendor, and would like to view all the bills and
+ credit notes for a single job.
+ </para>
+ <para>To use vendor jobs, you must create them using the
+ <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>New Job</guimenuitem>
+ </menuchoice> menu item. You will see the <guilabel>New Job</guilabel> window.
+ </para>
+
+ <screenshot id="bus-ap-jobnew">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/bus_ap_jobnew.png" srccredit="Jon Lapham" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>New Vendor Job</phrase>
+ </textobject>
+ <caption>
+ <para>New Vendor Job</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
<para>To edit an existing vendor job, use the <menuchoice>
<guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu>
@@ -356,26 +269,28 @@ Basic A/P Account Hierarchy:
</sect1>
<sect1 id="bus-ap-payment1">
- <title>Process Payment</title>
- <para>Eventually, you need to pay your bills. To do so, use the Process Payment application found in <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>Process Payment</guimenuitem></menuchoice>.</para>
+ <title>Process Payment</title>
+ <para>Eventually, you need to pay your bills. To do so, use the Process Payment application found in
+ <menuchoice><guimenu>Business</guimenu><guisubmenu>Vendor</guisubmenu><guimenuitem>Process Payment</guimenuitem>
+ </menuchoice>.
+ </para>
<para>Below is the <application>&app;</application> Accounts Receivable payment window.</para>
- <screenshot id="bus-ap-payment">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/bus_ap_payment.png"
- srccredit="Patrick Schweiger" format="PNG"/>
- </imageobject>
- <textobject>
- <phrase>Process Payment</phrase>
- </textobject>
- <caption>
- <para>Process Payment Window
- </para>
- </caption>
- </mediaobject>
- </screenshot>
+ <screenshot id="bus-ap-payment">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/bus_ap_payment.png" srccredit="Patrick Schweiger" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Process Payment</phrase>
+ </textobject>
+ <caption>
+ <para>Process Payment Window
+ </para>
+ </caption>
+ </mediaobject>
+ </screenshot>
- </sect1>
+ </sect1>
- </chapter>
+</chapter>
diff --git a/guide/C/ch_bus_ar.xml b/guide/C/ch_bus_ar.xml
index 1e14fdf..1820292 100644
--- a/guide/C/ch_bus_ar.xml
+++ b/guide/C/ch_bus_ar.xml
@@ -23,384 +23,12 @@ corrected to be less describing of the interface and more tutorial oriented
<para>Accounts Receivable (or A/R) refers to products or services provided
by your company for which payment has not yet been received.</para>
- <sect1 id="bus-ar-overview1">
- <title>Overview of Business Features</title>
-
- <para>The accounting needs of a business are quite different from that of
- a person. Businesses have customers that owe money, vendors which are owed
- money, employee payroll, more complex tax laws, etc. <application>&app;</application> offers
- business oriented features to facilitate these needs.</para>
-
- <para>Accounts Receivable (A/R) are used by businesses to record sales for
- which they are not immediately paid. Accounts Payable (A/P) record bills
- that they have received, but might not pay until later. These types of
- accounts are used primarily when you have a lot of bills and receipts
- flowing in and out, and do not want to lose track of them just because you
- do not pay or get paid right away. For most home users, A/R and A/P are
- too complicated to be worth the effort.</para>
- </sect1>
-
- <sect1 id="bus-ar-concepts1">
- <title>Basic Concepts</title>
-
- <para>Accounts Receivable (or A/R) refers to products or services provided
- by your company for which payment has not yet been received. This is
- represented on the balance sheet as an asset, because the expectation is
- that you will receive payment soon.</para>
- </sect1>
-
<sect1 id="bus-ar-setup1">
<title>Initial Setup</title>
- <para>To set up <application>&app;</application> to handle accounts receivable for a company four
- preliminary things must be done. The first is to build an appropriate
- Account Hierarchy. The second is set up tax tables. The third is to register the company in
- <application>&app;</application>. The fourth is to set up billing terms.</para>
-
- <sect2 id="bus-ar-setupacct2">
- <title>Account Setup</title>
-
- <para>There are many different ways to set up a business account
- hierarchy. You can start with the Business Accounts setup which is
- available from the New Account Hierarchy assistant, or you could build one
- manually. To access the prebuilt Business Accounts, start <application>&app;</application> and
- click on <menuchoice><guimenu>File</guimenu><guimenuitem>New File</guimenuitem></menuchoice> and
- proceed until you see the list of available accounts, select Business
- Accounts.</para>
-
- <para>The prebuilt Business Account hierarchy will not meet your needs
- exactly. You will need make adjustments for the hierarchy to function
- well with your particular situation. It should be close enough that it
- is recommended you begin with it.</para>
-
- <para>Accounts Receivable (or A/R) refers to products or services
- provided by the company on credit for which payment has not yet been
- received. This is represented on the balance sheet as an asset, because
- you expect to receive payment soon. To use <application>&app;</application>’s integrated accounts
- receivable system, you must first set up an account (usually a
- sub-account under Assets) defined with account type
- <emphasis>A/Receivable</emphasis>. It is within this account that the
- integrated A/R system will place transactions.</para>
-
- <literallayout>
-Basic A/R Account Hierarchy:
-
--Assets
- -Accounts Receivable
- -Checking
--Income
- -Sales
--Liabilities
- -Tax
- -Tax on Purchases
- -Tax on Sales
- </literallayout>
-
- <para>You need to add additional asset, expense, and income accounts to
- this hierarchy for it to be useful. The important aspects of this
- hierarchy are the use of an income account and the Accounts Receivable
- asset account, with account type set to
- <emphasis>A/Receivable</emphasis>.</para>
-
- <note>
- <para>You do not need to create an individual A/R account for each
- customer. <application>&app;</application> keeps track of customers internally and provides
- per-customer reports based on the internal tracking.
- </para>
-
- <para>
- If you deal with customers in more than one currency you will need a separate
- <emphasis>Accounts Receivable</emphasis> account for each currency.
- </para>
-
- <para>Transactions involving an Accounts Receivable account should not be added,
- changed or deleted in any way other than by using
- <itemizedlist>
- <listitem><para>post/unpost bill/invoice/voucher or</para></listitem>
- <listitem><para>process payment"</para></listitem>
- </itemizedlist>
- </para>
-
- </note>
- </sect2>
-
- <sect2 id="bus-ar-setuptaxtables">
- <title>Tax Tables</title>
-
- <para>Tax Tables can used to determine the tax for customer invoices (or vendor bills).
- </para>
-
- <para> A tax table can be assigned to an invoice line or bill line.</para>
-
- <para> The default invoice line tax table can be assigned to each customer and the default bill
- line tax table can be assigned to each vendor.
- </para>
-
- <para>The default tax table for new customers or new vendors can be specified in the <emphasis>Book Options </emphasis>
- window which can be accessed by
- <menuchoice><guimenu>File</guimenu>
- <guisubmenu>Properties</guisubmenu>
- <guimenuitem>Business tab.</guimenuitem>
- </menuchoice>
- </para>
-
- <para>Tax Tables are maintained using the <emphasis>Sales Tax Table</emphasis> editor which is accessed via menu
- <menuchoice><guimenu>Business</guimenu><guimenuitem>Sales Tax Table</guimenuitem></menuchoice>.
- </para>
-
- <figure pgwide="1">
- <title>Tax Tables</title>
- <screenshot id="bus-ar-taxmain">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/bus_ar_tax_main.png" format="PNG"
- srccredit="Chris Good" width="510px" />
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/bus_ar_tax_main.png" format="PNG"
- srccredit="Chris Good" />
- </imageobject>
-
- <textobject>
- <phrase>Sales Tax Tables Editor</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <figure pgwide="1">
- <title>New Sales Tax Table</title>
- <screenshot id="bus-ar-taxnew">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/bus_ar_tax_new.png" format="PNG"
- srccredit="Chris Good" />
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/bus_ar_tax_new.png" format="PNG"
- srccredit="Chris Good" />
- </imageobject>
-
- <textobject>
- <phrase>New Sales Tax Table</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para><guilabel>Name</guilabel> This is the tax table name.</para>
- </listitem>
- <listitem>
- <para><guilabel>Type</guilabel> Either <guilabel>Percent %</guilabel>
- or <guilabel>Value $
-</guilabel>.</para>
- </listitem>
- <listitem>
- <para><guilabel>Value
-</guilabel>This is the percentage or value depending on <guilabel>Type</guilabel>.</para>
- </listitem>
- <listitem>
- <para><guilabel>Account</guilabel> This is the account to which tax will be posted.
- For tax collected from customers, this should probably be a Liability account as it must be payed to the government.
- For tax paid to vendors, if tax laws allow tax paid to vendors to offset tax collected from customers, this should probably
- also be a Liability account (even though it will usually have a debit balance)
- so that the net tax owed to the government can be easily observed.
- </para>
- <para>If you set up Tax on Purchases and Tax on Sales as subaccounts of Liabilities:Tax then the net tax will be rolled up
- and can be seen in the <application>&app;</application> Accounts tab.
- </para>
- <para><emphasis>If unsure about tax law requirements, get professional advise. </emphasis></para>
- </listitem>
- </itemizedlist>
- </sect2>
-
- <sect2 id="bus-ar-setupcname2">
- <title>Company Registration</title>
-
- <para>After you have built the account structure and defined your tax tables, register the <application>&app;</application>
- file as belonging to your company. To register your company, select the <guilabel>Business</guilabel> tab
- in the <guilabel>Book Options</guilabel> window accessible by selecting
- <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem>
- </menuchoice>.
- </para>
-
- <figure pgwide="1">
- <title>Company Registration</title>
- <screenshot id="bus-ar-co-reg">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/bus_ar_co_reg.png" format="PNG"
- srccredit="Chris Good" width="510px" />
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/bus_ar_co_reg.png" format="PNG"
- srccredit="Chris Good" />
- </imageobject>
-
- <textobject>
- <phrase>Company Registration</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <para>Here you can:</para>
-
- <itemizedlist>
- <listitem>
- <para>Enter the name of your company along with contact information
- such as your phone number, fax number, e-mail address and website
- URL.</para>
- </listitem>
-
- <listitem>
- <para>Enter your company’s tax payer id number in the
- <guilabel>Company ID</guilabel> field.</para>
- </listitem>
+ <para>Perform set up tasks listed in <xref linkend="chapter_bus_setup" />.
+ </para>
- <listitem>
- <para>Select default tax tables applicable to your most common
- customers and vendors.</para>
- </listitem>
- </itemizedlist>
- </sect2>
-
- <sect2 id="bus-ar-setupterms">
- <title>Billing Terms</title>
-
- <para>Billing Terms can be used to determine the payment due date and be a guide for determining discount for early payment of invoices (or vendor bills).
- </para>
-
- <note>
- <para>As of <application>&app;</application> 2.6.7, Billing terms are only partially supported. Date due is calculated but discount amount is not.
- </para>
- <para>
- Discount for early invoice payment is not implemented. There are 2 ways this may be done, although neither is recommended, and
- professional advise should be used to confirm that regulations are being complied with:
- <itemizedlist>
- <listitem>
- <para>After creating and posting a payment which pays the invoice in full, manually edit the payment transaction (usually strongly discouraged)
- and split the payment to reduce it by the amount of the discount and a create a compensating split in an income (discount) account.
- </para>
- </listitem>
-
- <listitem>
- <para>Alternatively, after creating and posting a payment for the discounted amount, create a credit note for the discount using a specific negative
- sales income (discount) account for the transfer account.
- </para>
- </listitem>
- </itemizedlist>
- </para>
- </note>
-
- <para>You can specify the billing terms on each invoice/bill.
- Invoice billing terms will default from the customer billing terms.
- Bill billing terms will default from the vendor billing terms.
- </para>
-
- <para>Billing Terms are maintained using the Billing Terms Editor which is accessed via menu
- <menuchoice><guimenu>Business</guimenu><guimenuitem>Billing Terms Editor</guimenuitem></menuchoice>.
- </para>
-
- <figure pgwide="1">
- <title>Billing Terms Editor</title>
- <screenshot id="bus-ar-termsmain">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/bus_ar_terms_main.png" format="PNG"
- srccredit="Chris Good" width="510px" />
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/bus_ar_terms_main.png" format="PNG"
- srccredit="Chris Good" />
- </imageobject>
-
- <textobject>
- <phrase>Billing Terms Editor</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <figure pgwide="1">
- <title>New Billing Term</title>
- <screenshot id="bus-ar-termsnew">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/bus_ar_terms_new.png" format="PNG"
- srccredit="Chris Good" />
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/bus_ar_terms_new.png" format="PNG"
- srccredit="Chris Good" />
- </imageobject>
-
- <textobject>
- <phrase>New Billing Term</phrase>
- </textobject>
-
- </mediaobject>
- </screenshot>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para><guilabel>Name</guilabel> The internal name of the billing term. For some examples of billing term names and descriptions see
- <ulink url="http://wiki.gnucash.org/wiki/Terms" />
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Description</guilabel> The description of the billing term, printed on invoices</para>
- </listitem>
- <listitem>
- <para>There are 2 types of billing terms, with different information to be entered</para>
- <itemizedlist>
- <listitem>
- <para>Type Days</para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Due Days</guilabel> The invoice or bill is due to be paid within this number of days after the post date</para>
- </listitem>
- <listitem>
- <para><guilabel>Discount Days</guilabel> The number of days after the post date during which a discount will
- be applied for early payment
- </para>
- </listitem>
- <listitem>
- <para><guilabel>Discount %</guilabel> The percentage discount applied for early payment</para>
- </listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para>Type Proximo</para>
- <itemizedlist>
- <listitem>
- <para><guilabel>Due Day</guilabel> The day of the month bills are due</para>
- </listitem>
- <listitem>
- <para><guilabel>Discount Day</guilabel> The last day of the month for the early payment discount</para>
- </listitem>
- <listitem>
- <para><guilabel>Discount %</guilabel> The discount percentage applied if paid early</para>
- </listitem>
- <listitem>
- <para><guilabel>Cutoff Day</guilabel> The cutoff day for applying bills to the next month. After the
- cutoff, bills are applied to the following month. Negative values
- count backwards from the end of the month.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </itemizedlist>
- </listitem>
- </itemizedlist>
- </sect2>
</sect1>
<sect1 id="bus-ar-components1">
diff --git a/guide/C/ch_bus_intro.xml b/guide/C/ch_bus_intro.xml
new file mode 100644
index 0000000..f973e7f
--- /dev/null
+++ b/guide/C/ch_bus_intro.xml
@@ -0,0 +1,42 @@
+<!--
+ (Do not remove this comment block.)
+ Version: 1.0.0
+ Last modified: Sep 19th 2015
+ Maintainers:
+ Chris Good <chris.good at ozemail.com.au>
+ Author:
+ Chris Good <chris.good at ozemail.com.au>
+ updated [FirstName LastName] <name at company.com>
+ Translators:
+ (translators put your name and email here)
+-->
+
+<chapter id="chapter_bus_intro">
+ <title>Business Introduction</title>
+
+<!-- <sect1 id="bus-intro">
+ <title>Introduction to Business Features</title>
+-->
+ <para>The accounting needs of a business are quite different from that of
+ a person. Businesses have customers that owe money, vendors which are owed
+ money, employee payroll, more complex tax laws, etc. <application>&app;</application> offers
+ business oriented features to facilitate these needs.</para>
+
+ <para><emphasis>Accounts Receivable</emphasis> (A/R) are used by businesses to record sales for
+ which they are not immediately paid. This is represented on the balance sheet as an asset,
+ because the expectation is that you will receive payment soon.
+ </para>
+
+ <para><emphasis>Accounts Payable</emphasis> (A/P) record bills that businesses have received, but may not pay until later.
+ This is represented on the balance sheet as a liability because you will have to pay for them.
+ </para>
+
+ <para>A/R and A/P accounts are used primarily when you have a lot of bills and receipts
+ flowing in and out, and do not want to lose track of them just because you
+ do not pay or get paid right away. For most home users, A/R and A/P are
+ too complicated to be worthwhile.
+ </para>
+
+<!-- </sect1>
+-->
+</chapter>
diff --git a/guide/C/ch_bus_setup.xml b/guide/C/ch_bus_setup.xml
new file mode 100644
index 0000000..de895fd
--- /dev/null
+++ b/guide/C/ch_bus_setup.xml
@@ -0,0 +1,398 @@
+<!--
+ (Do not remove this comment block.)
+ Version: 1.0.0
+ Last modified: Sep 19th 2015
+ Maintainers:
+ Chris Good <chris.good at ozemail.com.au>
+ Author:
+ Chris Good <chris.good at ozemail.com.au>
+ updated [FirstName LastName] <name at company.com>
+ Translators:
+ (translators put your name and email here)
+-->
+
+<chapter id="chapter_bus_setup">
+ <title>Business Setup</title>
+
+ <para>To set up <application>&app;</application> to handle accounts receivable or accounts payable
+ for a company, these preliminary steps must be done.
+ <itemizedlist>
+ <listitem><para>Build an appropriate Account Hierarchy.</para></listitem>
+ <listitem><para>Set up Tax Tables.</para></listitem>
+ <listitem><para>Register the company in <application>&app;</application>.</para></listitem>
+ <listitem><para>Set Business Preferences.</para></listitem>
+ <listitem><para>Set up Billing Terms.</para></listitem>
+ </itemizedlist>
+ </para>
+
+ <sect1 id="bus-setupacct">
+ <title>Account Setup</title>
+
+ <para>There are many different ways to set up a business account
+ hierarchy. You can start with the Business Accounts setup which is
+ available from the New Account Hierarchy assistant, or you could build one
+ manually. To access the prebuilt Business Accounts, start <application>&app;</application> and
+ click on <menuchoice><guimenu>File</guimenu><guimenuitem>New File</guimenuitem></menuchoice> and
+ proceed until you see the list of available accounts, select Business
+ Accounts.</para>
+
+ <para>The prebuilt Business Account hierarchy will not meet your needs
+ exactly. You will need make adjustments for the hierarchy to function
+ well with your particular situation. It should be close enough that it
+ is recommended you begin with it.</para>
+
+ <para>To use <application>&app;</application>’s integrated accounts
+ receivable system, you must first set up an account (usually a
+ sub-account under Assets) defined with account type
+ <emphasis>A/Receivable</emphasis>. It is within this account that the
+ integrated A/R system will place transactions.
+ </para>
+
+ <para>To use <application>&app;</application>’s integrated accounts
+ payable system, you must first set up an account (usually a
+ sub-account under Liabilities) defined with account type
+ <emphasis>A/Payable</emphasis>. It is within this account that the
+ integrated A/P system will place transactions.
+ </para>
+
+ <literallayout>
+Basic A/R and A/P Account Hierarchy:
+
+-Assets
+ -Accounts Receivable
+ -Checking
+-Expenses
+ ...(as required)
+-Income
+ -Sales
+-Liabilities
+ -Accounts Payable
+ -Tax
+ -Tax on Purchases
+ -Tax on Sales
+ </literallayout>
+
+ <para>You need to add additional accounts to this hierarchy for it to be useful.</para>
+
+ <note>
+ <para>You do not need to create an individual A/R account for each
+ customer. <application>&app;</application> keeps track of customers internally and provides
+ per-customer reports based on the internal tracking. The same applies to A/P and vendors.
+ </para>
+
+ <para>
+ If you deal with customers in more than one currency you will need a separate
+ <emphasis>Accounts Receivable</emphasis> account for each currency.
+ </para>
+
+ <para>
+ If you deal with vendors in more than one currency you will need a separate
+ <emphasis>Accounts Payable</emphasis> account for each currency.
+ </para>
+
+ <para>Transactions involving an Accounts Receivable or Accounts Payable account should not be
+ added, changed or deleted in any way other than by using
+ <itemizedlist>
+ <listitem><para>post/unpost bill/invoice/voucher or</para></listitem>
+ <listitem><para>process payment</para></listitem>
+ </itemizedlist>
+ </para>
+
+ </note>
+ </sect1>
+
+ <sect1 id="bus-setuptaxtables">
+ <title>Tax Tables</title>
+
+ <para>Tax Tables can used to determine the tax for customer invoices (or vendor bills).
+ </para>
+
+ <para> A tax table can be assigned to an invoice line or bill line.</para>
+
+ <para>Set up distinct tax tables for customers and vendors.</para>
+
+ <para> The default invoice line tax table can be assigned to each customer and the default bill
+ line tax table can be assigned to each vendor.
+ </para>
+
+ <para>The default tax table for new customers or new vendors can be specified in the <emphasis>Book Options </emphasis>
+ window which can be accessed by
+ <menuchoice><guimenu>File</guimenu>
+ <guisubmenu>Properties</guisubmenu>
+ <guimenuitem>Business tab.</guimenuitem>
+ </menuchoice>
+ </para>
+
+ <para>Tax Tables are maintained using the <emphasis>Sales Tax Table</emphasis> editor which is accessed via menu
+ <menuchoice><guimenu>Business</guimenu><guimenuitem>Sales Tax Table</guimenuitem></menuchoice>.
+ </para>
+
+ <figure pgwide="1">
+ <title>Tax Tables</title>
+ <screenshot id="bus-taxmain">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_tax_main.png" format="PNG"
+ srccredit="Chris Good" width="510px" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_tax_main.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>Sales Tax Tables Editor</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure pgwide="1">
+ <title>New Sales Tax Table</title>
+ <screenshot id="bus-taxnew">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_tax_new.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_tax_new.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>New Sales Tax Table</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Name</guilabel> This is the tax table name.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Type</guilabel> Either <guilabel>Percent %</guilabel>
+ or <guilabel>Value $
+</guilabel>.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Value
+</guilabel>This is the percentage or value depending on <guilabel>Type</guilabel>.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Account</guilabel> This is the account to which tax will be posted.
+ For tax collected from customers, this should probably be a Liability account as it must be payed to the government.
+ For tax paid to vendors, if tax laws allow tax paid to vendors to offset tax collected from customers, this should probably
+ also be a Liability account (even though it will usually have a debit balance)
+ so that the net tax owed to the government can be easily observed.
+ </para>
+ <para>If you set up Tax on Purchases and Tax on Sales as subaccounts of Liabilities:Tax then the net tax will be rolled up
+ and can be seen in the <application>&app;</application> Accounts tab.
+ </para>
+ <para><emphasis>If unsure about tax law requirements, get professional advise. </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ </sect1>
+
+ <sect1 id="bus-setupcname">
+ <title>Company Registration</title>
+
+ <para>After you have built the account structure and defined your tax tables, register the <application>&app;</application>
+ file as belonging to your company. To register your company, select the <guilabel>Business</guilabel> tab
+ in the <guilabel>Book Options</guilabel> window accessible by selecting
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem>
+ </menuchoice>.
+ </para>
+
+ <figure pgwide="1">
+ <title>Company Registration</title>
+ <screenshot id="bus-co-reg">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_co_reg.png" format="PNG"
+ srccredit="Chris Good" width="510px" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_co_reg.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>Company Registration</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <para>Here you can:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Enter the name of your company along with contact information
+ such as your phone number, fax number, e-mail address and website
+ URL.</para>
+ </listitem>
+
+ <listitem>
+ <para>Enter your company’s tax payer id number in the
+ <guilabel>Company ID</guilabel> field.</para>
+ </listitem>
+
+ <listitem>
+ <para>Select default tax tables applicable to your most common
+ customers and vendors.</para>
+ </listitem>
+ </itemizedlist>
+
+ </sect1>
+
+ <sect1 id="bus_setup_pref">
+ <title>Business Preferences</title>
+ <para>Set options on the Business tab of the <application>&app;</application> preferences, which is
+ accessed via <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>
+ (<menuchoice><guimenu>GnuCash</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice> on Mac OS X).
+ See Help manual chapter 10.3.3 Business Book Options Tab.
+ </para>
+
+ </sect1>
+
+ <sect1 id="bus-setupterms">
+ <title>Billing Terms</title>
+
+ <para>Billing Terms can be used to determine the payment due date and be a
+ guide for determining discount for early payment of invoices (or vendor bills).
+ </para>
+
+ <note>
+ <para>As of <application>&app;</application> 2.6.7, Billing Terms are only
+ partially supported. Date due is calculated using the Billing Terms
+ but discount amount is not.
+ </para>
+ <para>
+ Discount for early invoice payment is not implemented. There are 2 ways this may be done, although neither is recommended, and
+ professional advise should be used to confirm that regulations are being complied with:
+ <itemizedlist>
+ <listitem>
+ <para>After creating and posting a payment which pays the invoice in full, manually edit the payment transaction (usually strongly discouraged)
+ and split the payment to reduce it by the amount of the discount and a create a compensating split in an income (discount) account.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Alternatively, after creating and posting a payment for the discounted amount, create a credit note for the discount using a specific negative
+ sales income (discount) account for the transfer account.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </note>
+
+ <para>You can specify the billing terms on each invoice/bill.
+ Invoice billing terms will default from the customer billing terms.
+ Bill billing terms will default from the vendor billing terms.
+ </para>
+
+ <para>Billing Terms are maintained using the Billing Terms Editor which is accessed via menu
+ <menuchoice><guimenu>Business</guimenu><guimenuitem>Billing Terms Editor</guimenuitem></menuchoice>.
+ </para>
+
+ <figure pgwide="1">
+ <title>Billing Terms Editor</title>
+ <screenshot id="bus-termsmain">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_terms_main.png" format="PNG"
+ srccredit="Chris Good" width="510px" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_terms_main.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>Billing Terms Editor</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure pgwide="1">
+ <title>New Billing Term</title>
+ <screenshot id="bus-termsnew">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_terms_new.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_terms_new.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>New Billing Term</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Name</guilabel> The internal name of the billing term. For some examples of billing term names and descriptions see
+ <ulink url="http://wiki.gnucash.org/wiki/Terms" />.
+ </para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Description</guilabel> The description of the billing term, printed on invoices</para>
+ </listitem>
+ <listitem>
+ <para>There are 2 types of billing terms, with different information to be entered</para>
+ <itemizedlist>
+ <listitem>
+ <para>Type Days</para>
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Due Days</guilabel> The invoice or bill is due to be paid within this number of days after the post date</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount Days</guilabel> The number of days after the post date during which a discount will
+ be applied for early payment
+ </para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount %</guilabel> The percentage discount applied for early payment</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Type Proximo</para>
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Due Day</guilabel> The day of the month bills are due</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount Day</guilabel> The last day of the month for the early payment discount</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount %</guilabel> The discount percentage applied if paid early</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Cutoff Day</guilabel> The cutoff day for applying bills to the next month. After the
+ cutoff, bills are applied to the following month. Negative values
+ count backwards from the end of the month.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ </sect1>
+
+</chapter>
diff --git a/guide/C/ch_import_business_data.xml b/guide/C/ch_import_business_data.xml
index 56bc2d2..3732890 100644
--- a/guide/C/ch_import_business_data.xml
+++ b/guide/C/ch_import_business_data.xml
@@ -12,7 +12,7 @@ Author:
(translators put your name and email here)
-->
-<chapter id="ch_import_busisness_data">
+<chapter id="ch_import_bus_data">
<title>Importing Business Data</title>
diff --git a/guide/C/ch_oview.xml b/guide/C/ch_oview.xml
index 21bbe89..99dc4b3 100644
--- a/guide/C/ch_oview.xml
+++ b/guide/C/ch_oview.xml
@@ -461,8 +461,13 @@
<para><emphasis>Managing Business Finances</emphasis> discusses the
use of <application>&app;</application> in business accounting: <itemizedlist>
+
<listitem>
- <para><xref linkend="chapter_dep"></xref></para>
+ <para><xref linkend="chapter_bus_intro"></xref></para>
+ </listitem>
+
+ <listitem>
+ <para><xref linkend="chapter_bus_setup"></xref></para>
</listitem>
<listitem>
@@ -484,7 +489,20 @@
<listitem>
<para><xref linkend="chapter_other_assets"></xref></para>
</listitem>
- </itemizedlist></para>
+
+ <listitem>
+ <para><xref linkend="chapter_dep"></xref></para>
+ </listitem>
+
+ <listitem>
+ <para><xref linkend="ch_python_bindings"></xref></para>
+ </listitem>
+
+ <listitem>
+ <para><xref linkend="ch_import_bus_data"></xref></para>
+ </listitem>
+
+ </itemizedlist></para>
<para>This manual also includes several appendices, which contains extra information
you might want to know:</para>
diff --git a/guide/C/ch_python_bindings.xml b/guide/C/ch_python_bindings.xml
index e38ec1c..43fc129 100644
--- a/guide/C/ch_python_bindings.xml
+++ b/guide/C/ch_python_bindings.xml
@@ -12,7 +12,7 @@ Author:
(translators put your name and email here)
-->
-<chapter id="ch_python_bindigs">
+<chapter id="ch_python_bindings">
<title>Python Bindings</title>
<para>
<application>&app;</application> historically has always been a
diff --git a/guide/C/figures/bus_co_reg.png b/guide/C/figures/bus_co_reg.png
new file mode 100644
index 0000000..60c56b6
Binary files /dev/null and b/guide/C/figures/bus_co_reg.png differ
diff --git a/guide/C/figures/bus_tax_main.png b/guide/C/figures/bus_tax_main.png
new file mode 100644
index 0000000..077237e
Binary files /dev/null and b/guide/C/figures/bus_tax_main.png differ
diff --git a/guide/C/figures/bus_tax_new.png b/guide/C/figures/bus_tax_new.png
new file mode 100644
index 0000000..3683251
Binary files /dev/null and b/guide/C/figures/bus_tax_new.png differ
diff --git a/guide/C/figures/bus_terms_main.png b/guide/C/figures/bus_terms_main.png
new file mode 100644
index 0000000..c66d47d
Binary files /dev/null and b/guide/C/figures/bus_terms_main.png differ
diff --git a/guide/C/figures/bus_terms_new.png b/guide/C/figures/bus_terms_new.png
new file mode 100644
index 0000000..4e9ae3b
Binary files /dev/null and b/guide/C/figures/bus_terms_new.png differ
diff --git a/guide/C/gnucash-guide.xml b/guide/C/gnucash-guide.xml
index dd8bd15..4944f51 100644
--- a/guide/C/gnucash-guide.xml
+++ b/guide/C/gnucash-guide.xml
@@ -19,14 +19,16 @@
<!ENTITY chapter8 SYSTEM "ch_invest.xml">
<!ENTITY chapter9 SYSTEM "ch_capgain.xml">
<!ENTITY chapter10 SYSTEM "ch_currency.xml">
-<!ENTITY chapter11 SYSTEM "ch_dep.xml">
-<!ENTITY chapter12 SYSTEM "ch_bus_ar.xml">
-<!ENTITY chapter13 SYSTEM "ch_bus_ap.xml">
-<!ENTITY chapter14 SYSTEM "ch_bus_pay.xml">
-<!ENTITY chapter15 SYSTEM "ch_budgets.xml">
-<!ENTITY chapter16 SYSTEM "ch_oth_assets.xml">
-<!ENTITY chapter17 SYSTEM "ch_python_bindings.xml">
-<!ENTITY chapter18 SYSTEM "ch_import_business_data.xml">
+<!ENTITY chapter11 SYSTEM "ch_bus_intro.xml">
+<!ENTITY chapter12 SYSTEM "ch_bus_setup.xml">
+<!ENTITY chapter13 SYSTEM "ch_bus_ar.xml">
+<!ENTITY chapter14 SYSTEM "ch_bus_ap.xml">
+<!ENTITY chapter15 SYSTEM "ch_bus_pay.xml">
+<!ENTITY chapter16 SYSTEM "ch_budgets.xml">
+<!ENTITY chapter17 SYSTEM "ch_oth_assets.xml">
+<!ENTITY chapter18 SYSTEM "ch_dep.xml">
+<!ENTITY chapter19 SYSTEM "ch_python_bindings.xml">
+<!ENTITY chapter20 SYSTEM "ch_import_business_data.xml">
<!ENTITY appendixa SYSTEM "appendixa.xml">
<!ENTITY appendixb SYSTEM "appendixb.xml">
<!ENTITY appendixc SYSTEM "appendixc.xml">
@@ -488,6 +490,8 @@
&chapter16;
&chapter17;
&chapter18;
+&chapter19;
+&chapter20;
</part>
<part>
<title>Appendices</title>
commit bbe8ccc606d8360208d8fd763d5a1ae1ec3a3d7f
Author: Chris Good <chris.good at ozemail.com.au>
Date: Sun Sep 13 08:47:42 2015 +1000
Publish my Authorship
diff --git a/guide/C/gnucash-guide-C.omf b/guide/C/gnucash-guide-C.omf
index dc562d6..6c1ed55 100644
--- a/guide/C/gnucash-guide-C.omf
+++ b/guide/C/gnucash-guide-C.omf
@@ -29,6 +29,9 @@
Mike Evans
</contributor>
<contributor>
+ Chris Good
+ </contributor>
+ <contributor>
David Hampton
</contributor>
<contributor>
diff --git a/help/C/gnucash-help-C.omf b/help/C/gnucash-help-C.omf
index b72e694..724cc95 100644
--- a/help/C/gnucash-help-C.omf
+++ b/help/C/gnucash-help-C.omf
@@ -20,6 +20,9 @@
Frank H. Ellenberger
</contributor>
<contributor>
+ Chris Good
+ </contributor>
+ <contributor>
David Hampton
</contributor>
<contributor>
commit 3c6be9c5c561d300d1be7e23975879742a63e051
Author: John Ralls <jralls at ceridwen.us>
Date: Sun Sep 13 15:04:44 2015 -0700
Bug 705309 Document Billing Terms Editor and Tax Table Editor.
diff --git a/guide/C/ch_bus_ap.xml b/guide/C/ch_bus_ap.xml
index 345a73b..59902f5 100644
--- a/guide/C/ch_bus_ap.xml
+++ b/guide/C/ch_bus_ap.xml
@@ -19,7 +19,7 @@ corrected to be less describing of the interface and more tutorial oriented
<chapter id="chapter_bus_ap">
<title>Accounts Payable</title>
- <para>Accounts Payable (or A/P) refers to the accounting of products or services which a company has bought and needs to pay off.</para>
+ <para>Accounts Payable (or A/P) refers to the accounting of products or services which a company has bought and needs to pay for.</para>
<sect1 id="bus-ap-concepts1">
<title>Basic Concepts</title>
@@ -28,7 +28,11 @@ corrected to be less describing of the interface and more tutorial oriented
<sect1 id="bus-ap-setup1">
<title>Initial Setup</title>
- <para>To set up <application>&app;</application> to handle accounts payable for a company, two preliminary things must be done. The first is to build an appropriate Account Hierarchy and the second is to register the company in <application>&app;</application>.</para>
+ <para>To set up <application>&app;</application> to handle accounts payable for a company, four
+ preliminary things must be done. The first is to build an appropriate
+ Account Hierarchy. The second is set up tax tables. The third is to register the company in
+ <application>&app;</application>. The fourth is to set up billing terms.
+ </para>
<sect2 id="bus-ap-setupacct2">
<title>Account Setup</title>
@@ -54,6 +58,9 @@ Basic A/P Account Hierarchy:
-Bank
-Liabilities
-Accounts Payable
+ -Tax
+ -Tax on Purchases
+ -Tax on Sales
-Expenses
-AP Expenses
</literallayout>
@@ -66,18 +73,31 @@ Basic A/P Account Hierarchy:
changed or deleted in any way other than by using
<itemizedlist>
<listitem><para>post/unpost bill/invoice/voucher or</para></listitem>
- <listitem><para>process payment"</para></listitem>
+ <listitem><para>process payment</para></listitem>
</itemizedlist>
</para>
</sect2>
+ <sect2 id="bus-ap-setuptaxtables">
+ <title>Tax Tables</title>
+
+ <para>Vendor tax tables are set up in the same way as Customer tax tables. As the account tax is
+ posted to, is specified on each tax table, to keep transactions for tax collected from customer sales
+ separate from tax paid for vendor purchases, set up distinct tax tables for customers and vendors.
+ See <xref linkend="bus-ar-setuptaxtables" />
+ </para>
+
+ </sect2>
+
<sect2 id="bus-ap-setupcname2">
<title>Company Registration</title>
- <para>After you have built the account structure, register the <application>&app;</application>
- file as belonging to your company. To register your company, select
- <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem></menuchoice>:</para>
+ <para>After you have built the account structure, and defined your tax tables, register the <application>&app;</application>
+ file as belonging to your company. To register your company, select the <guilabel>Business</guilabel> tab
+ in the <guilabel>Book Options</guilabel> window accessible by selecting
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem>
+ </menuchoice>:</para>
<itemizedlist>
<listitem>
@@ -90,9 +110,22 @@ Basic A/P Account Hierarchy:
<para>Enter your company’s tax payer id number in the
<guilabel>Company ID</guilabel> field.</para>
</listitem>
+
+ <listitem>
+ <para>Set the default tax table applicable to most vendors.</para>
+ </listitem>
</itemizedlist>
</sect2>
+
+ <sect2 id="bus-ap-setupterms">
+ <title>Billing Terms</title>
+
+ <para>Vendor billing terms are set up in the same way as Customer billing terms.
+ See <xref linkend="bus-ar-setupterms" />
+ </para>
+
+ </sect2>
</sect1>
<sect1 id="bus-ap-components1">
diff --git a/guide/C/ch_bus_ar.xml b/guide/C/ch_bus_ar.xml
index 74992e8..1e14fdf 100644
--- a/guide/C/ch_bus_ar.xml
+++ b/guide/C/ch_bus_ar.xml
@@ -52,10 +52,10 @@ corrected to be less describing of the interface and more tutorial oriented
<sect1 id="bus-ar-setup1">
<title>Initial Setup</title>
- <para>To set up <application>&app;</application> to handle accounts receivable for a company two
+ <para>To set up <application>&app;</application> to handle accounts receivable for a company four
preliminary things must be done. The first is to build an appropriate
- Account Hierarchy and the second is to register the company in
- <application>&app;</application>.</para>
+ Account Hierarchy. The second is set up tax tables. The third is to register the company in
+ <application>&app;</application>. The fourth is to set up billing terms.</para>
<sect2 id="bus-ar-setupacct2">
<title>Account Setup</title>
@@ -86,10 +86,14 @@ corrected to be less describing of the interface and more tutorial oriented
Basic A/R Account Hierarchy:
-Assets
- -Checking
-Accounts Receivable
+ -Checking
-Income
-Sales
+-Liabilities
+ -Tax
+ -Tax on Purchases
+ -Tax on Sales
</literallayout>
<para>You need to add additional asset, expense, and income accounts to
@@ -104,6 +108,11 @@ Basic A/R Account Hierarchy:
per-customer reports based on the internal tracking.
</para>
+ <para>
+ If you deal with customers in more than one currency you will need a separate
+ <emphasis>Accounts Receivable</emphasis> account for each currency.
+ </para>
+
<para>Transactions involving an Accounts Receivable account should not be added,
changed or deleted in any way other than by using
<itemizedlist>
@@ -114,14 +123,133 @@ Basic A/R Account Hierarchy:
</note>
</sect2>
+
+ <sect2 id="bus-ar-setuptaxtables">
+ <title>Tax Tables</title>
+ <para>Tax Tables can used to determine the tax for customer invoices (or vendor bills).
+ </para>
+
+ <para> A tax table can be assigned to an invoice line or bill line.</para>
+
+ <para> The default invoice line tax table can be assigned to each customer and the default bill
+ line tax table can be assigned to each vendor.
+ </para>
+
+ <para>The default tax table for new customers or new vendors can be specified in the <emphasis>Book Options </emphasis>
+ window which can be accessed by
+ <menuchoice><guimenu>File</guimenu>
+ <guisubmenu>Properties</guisubmenu>
+ <guimenuitem>Business tab.</guimenuitem>
+ </menuchoice>
+ </para>
+
+ <para>Tax Tables are maintained using the <emphasis>Sales Tax Table</emphasis> editor which is accessed via menu
+ <menuchoice><guimenu>Business</guimenu><guimenuitem>Sales Tax Table</guimenuitem></menuchoice>.
+ </para>
+
+ <figure pgwide="1">
+ <title>Tax Tables</title>
+ <screenshot id="bus-ar-taxmain">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_ar_tax_main.png" format="PNG"
+ srccredit="Chris Good" width="510px" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_ar_tax_main.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>Sales Tax Tables Editor</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure pgwide="1">
+ <title>New Sales Tax Table</title>
+ <screenshot id="bus-ar-taxnew">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_ar_tax_new.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_ar_tax_new.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>New Sales Tax Table</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Name</guilabel> This is the tax table name.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Type</guilabel> Either <guilabel>Percent %</guilabel>
+ or <guilabel>Value $
+</guilabel>.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Value
+</guilabel>This is the percentage or value depending on <guilabel>Type</guilabel>.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Account</guilabel> This is the account to which tax will be posted.
+ For tax collected from customers, this should probably be a Liability account as it must be payed to the government.
+ For tax paid to vendors, if tax laws allow tax paid to vendors to offset tax collected from customers, this should probably
+ also be a Liability account (even though it will usually have a debit balance)
+ so that the net tax owed to the government can be easily observed.
+ </para>
+ <para>If you set up Tax on Purchases and Tax on Sales as subaccounts of Liabilities:Tax then the net tax will be rolled up
+ and can be seen in the <application>&app;</application> Accounts tab.
+ </para>
+ <para><emphasis>If unsure about tax law requirements, get professional advise. </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
<sect2 id="bus-ar-setupcname2">
<title>Company Registration</title>
- <para>After you have built the account structure, register the <application>&app;</application>
+ <para>After you have built the account structure and defined your tax tables, register the <application>&app;</application>
file as belonging to your company. To register your company, select the <guilabel>Business</guilabel> tab
in the <guilabel>Book Options</guilabel> window accessible by selecting
- <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem></menuchoice>. Here you can:</para>
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem>
+ </menuchoice>.
+ </para>
+
+ <figure pgwide="1">
+ <title>Company Registration</title>
+ <screenshot id="bus-ar-co-reg">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_ar_co_reg.png" format="PNG"
+ srccredit="Chris Good" width="510px" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_ar_co_reg.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>Company Registration</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <para>Here you can:</para>
<itemizedlist>
<listitem>
@@ -141,8 +269,140 @@ Basic A/R Account Hierarchy:
</listitem>
</itemizedlist>
</sect2>
- </sect1>
+ <sect2 id="bus-ar-setupterms">
+ <title>Billing Terms</title>
+
+ <para>Billing Terms can be used to determine the payment due date and be a guide for determining discount for early payment of invoices (or vendor bills).
+ </para>
+
+ <note>
+ <para>As of <application>&app;</application> 2.6.7, Billing terms are only partially supported. Date due is calculated but discount amount is not.
+ </para>
+ <para>
+ Discount for early invoice payment is not implemented. There are 2 ways this may be done, although neither is recommended, and
+ professional advise should be used to confirm that regulations are being complied with:
+ <itemizedlist>
+ <listitem>
+ <para>After creating and posting a payment which pays the invoice in full, manually edit the payment transaction (usually strongly discouraged)
+ and split the payment to reduce it by the amount of the discount and a create a compensating split in an income (discount) account.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Alternatively, after creating and posting a payment for the discounted amount, create a credit note for the discount using a specific negative
+ sales income (discount) account for the transfer account.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </note>
+
+ <para>You can specify the billing terms on each invoice/bill.
+ Invoice billing terms will default from the customer billing terms.
+ Bill billing terms will default from the vendor billing terms.
+ </para>
+
+ <para>Billing Terms are maintained using the Billing Terms Editor which is accessed via menu
+ <menuchoice><guimenu>Business</guimenu><guimenuitem>Billing Terms Editor</guimenuitem></menuchoice>.
+ </para>
+
+ <figure pgwide="1">
+ <title>Billing Terms Editor</title>
+ <screenshot id="bus-ar-termsmain">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_ar_terms_main.png" format="PNG"
+ srccredit="Chris Good" width="510px" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_ar_terms_main.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>Billing Terms Editor</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure pgwide="1">
+ <title>New Billing Term</title>
+ <screenshot id="bus-ar-termsnew">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/bus_ar_terms_new.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/bus_ar_terms_new.png" format="PNG"
+ srccredit="Chris Good" />
+ </imageobject>
+
+ <textobject>
+ <phrase>New Billing Term</phrase>
+ </textobject>
+
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Name</guilabel> The internal name of the billing term. For some examples of billing term names and descriptions see
+ <ulink url="http://wiki.gnucash.org/wiki/Terms" />
+ </para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Description</guilabel> The description of the billing term, printed on invoices</para>
+ </listitem>
+ <listitem>
+ <para>There are 2 types of billing terms, with different information to be entered</para>
+ <itemizedlist>
+ <listitem>
+ <para>Type Days</para>
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Due Days</guilabel> The invoice or bill is due to be paid within this number of days after the post date</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount Days</guilabel> The number of days after the post date during which a discount will
+ be applied for early payment
+ </para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount %</guilabel> The percentage discount applied for early payment</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Type Proximo</para>
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Due Day</guilabel> The day of the month bills are due</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount Day</guilabel> The last day of the month for the early payment discount</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount %</guilabel> The discount percentage applied if paid early</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Cutoff Day</guilabel> The cutoff day for applying bills to the next month. After the
+ cutoff, bills are applied to the following month. Negative values
+ count backwards from the end of the month.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+ </sect1>
+
<sect1 id="bus-ar-components1">
<title>System Components</title>
@@ -166,7 +426,9 @@ Basic A/R Account Hierarchy:
<para>In addition, GnuCash also has support for <guilabel>Credit Notes</guilabel>
which represent the inverse of Invoices. A credit note is usually handed to
a customer to correct items that were incorrectly invoiced or returned.</para>
- <para>Both document types will be set up using the same menu items.</para>
+ <para>Both document types will be set up using the same menu items. Credit notes were introduced starting with
+ <application>&app;</application> stable release 2.6.0.
+ </para>
</listitem>
<listitem>
diff --git a/guide/C/ch_invest.xml b/guide/C/ch_invest.xml
index 84f0dea..f8a6d7f 100644
--- a/guide/C/ch_invest.xml
+++ b/guide/C/ch_invest.xml
@@ -1812,9 +1812,13 @@ Income
<screenshot id="invest-dividendcash1">
<mediaobject>
- <imageobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_dividendcash.png"
+ format="PNG" srccredit="Daniel Dodson" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
<imagedata fileref="figures/invest_dividendcash.png"
- format="PNG" srccredit="Daniel Dodson"></imagedata>
+ format="PNG" srccredit="Daniel Dodson" ></imagedata>
</imageobject>
<textobject>
diff --git a/guide/C/figures/bus_ar_co_reg.png b/guide/C/figures/bus_ar_co_reg.png
new file mode 100644
index 0000000..60c56b6
Binary files /dev/null and b/guide/C/figures/bus_ar_co_reg.png differ
diff --git a/guide/C/figures/bus_ar_tax_main.png b/guide/C/figures/bus_ar_tax_main.png
new file mode 100644
index 0000000..077237e
Binary files /dev/null and b/guide/C/figures/bus_ar_tax_main.png differ
diff --git a/guide/C/figures/bus_ar_tax_new.png b/guide/C/figures/bus_ar_tax_new.png
new file mode 100644
index 0000000..3683251
Binary files /dev/null and b/guide/C/figures/bus_ar_tax_new.png differ
diff --git a/guide/C/figures/bus_ar_terms_main.png b/guide/C/figures/bus_ar_terms_main.png
new file mode 100644
index 0000000..c66d47d
Binary files /dev/null and b/guide/C/figures/bus_ar_terms_main.png differ
diff --git a/guide/C/figures/bus_ar_terms_new.png b/guide/C/figures/bus_ar_terms_new.png
new file mode 100644
index 0000000..4e9ae3b
Binary files /dev/null and b/guide/C/figures/bus_ar_terms_new.png differ
diff --git a/guide/C/figures/invest_dividendcash.png b/guide/C/figures/invest_dividendcash.png
index a3cc0d4..6e7f253 100644
Binary files a/guide/C/figures/invest_dividendcash.png and b/guide/C/figures/invest_dividendcash.png differ
diff --git a/help/C/Help_ch_Business.xml b/help/C/Help_ch_Business.xml
index d0bb82a..7dd5b57 100644
--- a/help/C/Help_ch_Business.xml
+++ b/help/C/Help_ch_Business.xml
@@ -40,9 +40,10 @@
<title>Initial Setup</title>
<para>To set up <application>&app;</application> to handle accounts receivable and accounts payable
- for a company two preliminary things must be done. The first is to build an appropriate
- Account Hierarchy and the second is to register the company in
- <application>&app;</application>.</para>
+ for a company four preliminary things must be done. The first is to build an appropriate
+ Account Hierarchy. The second is set up tax tables. The third is to register the company in
+ <application>&app;</application>. The fourth is to set up billing terms.
+ </para>
<sect2 id="busnss-setupacct2">
<title>Account Setup</title>
@@ -88,14 +89,159 @@
</sect2>
+ <sect2 id="busnss-ar-setuptaxtables">
+ <title>Tax Tables</title>
+
+ <para>Tax Tables can used to determine the tax for customer invoices (or vendor bills).
+ </para>
+
+ <para> A tax table can be assigned to an invoice line or bill line.</para>
+
+ <para> The default invoice line tax table can be assigned to each customer and the default bill
+ line tax table can be assigned to each vendor.
+ </para>
+
+ <para>The default tax table for new customers or new vendors can be specified in the <emphasis>Book Options </emphasis>
+ window which can be accessed by
+ <menuchoice><guimenu>File</guimenu>
+ <guisubmenu>Properties</guisubmenu>
+ <guimenuitem>Business</guimenuitem>
+ </menuchoice> tab.
+ </para>
+
+ <para>Tax Tables are maintained using the <emphasis>Sales Tax Table</emphasis> editor which is accessed via menu
+ <menuchoice><guimenu>Business</guimenu><guimenuitem>Sales Tax Table</guimenuitem></menuchoice>.
+ The following fields should be entered:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Name</guilabel> This is the tax table name.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Type</guilabel> Either <guilabel>Percent %</guilabel>
+ or <guilabel>Value $
+</guilabel>.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Value
+</guilabel>This is the percentage or value depending on <guilabel>Type</guilabel>.</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Account</guilabel> This is the account to which tax will be posted.
+ For tax collected from customers, this should probably be a Liability account as it must be payed to the government.
+ For tax paid to vendors, if tax laws allow tax paid to vendors to offset tax collected from customers, this should probably
+ also be a Liability account (even though it will usually have a debit balance)
+ so that the net tax owed to the government can be easily observed.
+ </para>
+ <para>If you set up Tax on Purchases and Tax on Sales as subaccounts of Liabilities:Tax then the net tax will be rolled up
+ and can be seen in the <application>&app;</application> Accounts tab.
+ </para>
+ <para><emphasis>If unsure about tax law requirements, get professional advise. </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ </sect2>
+
<sect2 id="busnss-setupcname">
<title>Company Registration</title>
- <para>After you have built the account structure, register the <application>&app;</application>
- file as belonging to your company by filling in the data requested in
- the <xref linkend="business-book-options" /> accessible from the
- <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem></menuchoice> menu item.</para>
+ <para>After you have built the account structure and defined your tax tables, register the <application>&app;</application>
+ file as belonging to your company by filling in the data requested in
+ the <xref linkend="business-book-options" /> accessible from the
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Properties</guimenuitem></menuchoice> menu item.
+ </para>
</sect2>
+
+ <sect2 id="busnss-ar-setupterms">
+ <title>Billing Terms</title>
+
+ <para>Billing Terms can be used to determine the payment due date and be a guide for determining discount for early payment of invoices (or vendor bills).
+ </para>
+
+ <note>
+ <para>As of <application>&app;</application> 2.6.7, Billing terms are only partially supported. Date due is calculated but discount amount is not.</para>
+ <para>
+ Discount for early invoice payment is not implemented. There are 2 ways this may be done, although neither is recommended, and
+ professional advise should be used to confirm that regulations are being complied with:
+ <itemizedlist>
+ <listitem>
+ <para>After creating and posting a payment which pays the invoice in full, manually edit the payment transaction (usually strongly discouraged)
+ and split the payment to reduce it by the amount of the discount and a create a compensating split in an income (discount) account.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Alternatively, after creating and posting a payment for the discounted amount, create a credit note for the discount using a specific negative
+ sales income (discount) account for the transfer account.
+ </para>
+ </listitem>
+
+ </itemizedlist>
+ </para>
+ </note>
+
+ <para>You can specify the billing terms on each invoice/bill.
+ Invoice billing terms will default from the customer billing terms.
+ Bill billing terms will default from the vendor billing terms.
+ </para>
+
+ <para>Billing Terms are maintained using the Billing Terms Editor which is accessed via menu
+ <menuchoice><guimenu>Business</guimenu><guimenuitem>Billing Terms Editor</guimenuitem></menuchoice>.
+ The following fields should be entered:
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Name</guilabel> The internal name of the billing term. For some examples of billing term names and descriptions see
+ <ulink url="http://wiki.gnucash.org/wiki/Terms" />
+ </para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Description</guilabel> The description of the billing term, printed on invoices</para>
+ </listitem>
+ <listitem>
+ <para>There are 2 types of billing terms, with different information to be entered</para>
+ <itemizedlist>
+ <listitem>
+ <para>Type Days</para>
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Due Days</guilabel> The invoice or bill is due to be paid within this number of days after the post date</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount Days</guilabel> The number of days after the post date during which a discount will
+ be applied for early payment
+ </para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount %</guilabel> The percentage discount applied for early payment</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Type Proximo</para>
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Due Day</guilabel> The day of the month bills are due</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount Day</guilabel> The last day of the month for the early payment discount</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Discount %</guilabel> The discount percentage applied if paid early</para>
+ </listitem>
+ <listitem>
+ <para><guilabel>Cutoff Day</guilabel> The cutoff day for applying bills to the next month. After the
+ cutoff, bills are applied to the following month. Negative values
+ count backwards from the end of the month.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </itemizedlist>
+ </sect2>
</sect1>
<sect1 id="busnss-ar-components1">
@@ -118,24 +264,29 @@
Basic A/R Account Hierarchy:
-Assets
- -Checking
- -Accounts Receivable
+ -Accounts Receivable
+ -Checking
-Income
- -Sales
+ -Sales
+ -Liabilities
+ -Tax
+ -Tax on Purchases
+ -Tax on Sales
+
</literallayout>
<note>
<para>You need to add additional asset, expense, and income accounts to
- this hierarchy for it to be useful. The important aspects of this
- hierarchy are the use of an income account and the <emphasis>Accounts Receivable</emphasis>
- asset account, with account type set to
- <emphasis>A/Receivable</emphasis>.</para>
+ this hierarchy for it to be useful. The important aspects of this
+ hierarchy are the use of an income account and the <emphasis>Accounts Receivable</emphasis>
+ asset account, with account type set to <emphasis>A/Receivable</emphasis>.
+ </para>
+ <para>
+ If you deal with customers in more than one currency you will
+ need a separate <emphasis>Accounts Receivable</emphasis>
+ account for each currency.
+ </para>
</note>
- <note><para>
- If you deal with customers in more than one currency you will
- need a separate <emphasis>Accounts Receivable</emphasis>
- account for each currency.
- </para></note>
<para>The transactions generated by the A/R system are recorded within the <emphasis>Accounts
Receivable</emphasis> account. You generally do not work directly with this account.
@@ -340,7 +491,8 @@
credit notes. In order to avoid repeating everything twice and to keep
the text easier to read it will refer only to invoices. You can apply
it equally to credit notes. Only where the behaviour of credit notes
- differs from invoices this will be explicitly mentioned.</para>
+ differs from invoices this will be explicitly mentioned. Credit notes were introduced starting with
+ <application>&app;</application> stable release 2.6.0.</para>
</note>
<sect2 id="busnss-ar-invoicenew2">
Summary of changes:
guide/C/Makefile.am | 2 +
guide/C/ch_bus_ap.xml | 438 ++++++++++++++------------------
guide/C/ch_bus_ar.xml | 122 +--------
guide/C/ch_bus_intro.xml | 42 +++
guide/C/ch_bus_setup.xml | 398 +++++++++++++++++++++++++++++
guide/C/ch_import_business_data.xml | 2 +-
guide/C/ch_invest.xml | 8 +-
guide/C/ch_oview.xml | 22 +-
guide/C/ch_python_bindings.xml | 2 +-
guide/C/figures/bus_co_reg.png | Bin 0 -> 72881 bytes
guide/C/figures/bus_tax_main.png | Bin 0 -> 15148 bytes
guide/C/figures/bus_tax_new.png | Bin 0 -> 23466 bytes
guide/C/figures/bus_terms_main.png | Bin 0 -> 27911 bytes
guide/C/figures/bus_terms_new.png | Bin 0 -> 24172 bytes
guide/C/figures/invest_dividendcash.png | Bin 76501 -> 76105 bytes
guide/C/gnucash-guide-C.omf | 3 +
guide/C/gnucash-guide.xml | 20 +-
help/C/Help_ch_Business.xml | 201 +++++++++++++--
help/C/gnucash-help-C.omf | 3 +
19 files changed, 868 insertions(+), 395 deletions(-)
create mode 100644 guide/C/ch_bus_intro.xml
create mode 100644 guide/C/ch_bus_setup.xml
create mode 100644 guide/C/figures/bus_co_reg.png
create mode 100644 guide/C/figures/bus_tax_main.png
create mode 100644 guide/C/figures/bus_tax_new.png
create mode 100644 guide/C/figures/bus_terms_main.png
create mode 100644 guide/C/figures/bus_terms_new.png
More information about the gnucash-changes
mailing list