1. Preamble.

I am primarily sending this e-mail HOWTO because I have used Open Tax
Solver for 2 years now, and I want to share with others a "success
story" and that there is a 100% open source solution to calculate taxes.
 (Of course, you could probably use a spreadsheet or calculator, and
also have a 100% open source solution...)

Open Tax Solver will compute the US Form 1040 including Schedule A in
one form, Schedule C in another form, yet does NOT have Schedule SE
capabilities (but you can use a PDF manually there).  Open Tax Solver
also supports several state forms, including the California 540 form.

For my example, I am a California resident, and I file the long form
(1040, not 1040EZ) and I do itemized deductions (Schedule A), and also
report some business and self-employed income (Schedule C -and- Schedule
SE).   If you follow a different pattern, you should be able to learn
from this HOWTO but will need to read the documentation to develop your
own approach.


2. Pre-requisites.

Create a working directory: (mkdir ~/taxes-2010; cd ~/taxes-2010)

The remainder of this document will assume the present directory is this
working directory.

>From the http://www.irs.gov/app/picklist/list/formsPublications.html
site, search for "1040" and then use the browser to Right-Click and save
the appropriate PDF files (for 1040, Schedule A, Schedule C, Schedule
SE) into the working directory.

The files should be saved as f1040.pdf f1040sa.pdf f1040sc.pdf
f1040sse.pdf.  You'll need these at the end...

Repeat for the 10_540.pdf and 10_540ca.pdf files from
http://www.ftb.ca.gov/forms/search/index.aspx


3. Software Preparation.

Download OpenTaxSolver from http://opentaxsolver.sourceforge.net/ and
save it in the working directory

Unpack the software distribution:  tar xzvf OpenTaxSolver2010_8.04.tgz

(If rebuilding the software from source, change into the
OpenTaxSolver2010_8.04 directory and run the sh script that starts with
"Build_taxsolve...")  I can't help or support if your system does not
build the binaries correctly, but the binaries in the distribution have
worked for me.  From this point on, I will assume the binaries will run
from ./OpenTaxSolver2010_8.04/bin - if you build and install elsewhere,
adjust the instructions.


4. Make local copies of template forms.

Copy the proper examples to your working directory, renaming from
'template' to 'mine' (or your name or initials or whatever you can use
to remember that they contain your data).  The 'template' files you are
copying from are empty templates with 0's (or empty string) values in
the various fields.

cp
OpenTaxSolver2010_8.04/examples_and_templates/US_1040/US_1040_template.dat
./US_1040_mine.dat

cp
OpenTaxSolver2010_8.04/examples_and_templates/US_1040_Sched_C/US_1040Sched_C_2010_template.dat
./US_1040_Sched_C_mine.dat

cp
OpenTaxSolver2010_8.04/examples_and_templates/CA_540/CA_540_2010_template.dat
./CA_540_2010_mine.dat


5. Use the OpenTaxSolver GUI to fill in the Schedule C form (if needed).

./OpenTaxSolver2010_8.04/bin/ots_gui ./US_1040_Sched_C_mine.dat

# enter in the Schedule C values from any 1099-misc or other business income
# Click SAVE and save it back to the file you specified on the
commandline then click 'Exit' -- for Schedule C, don't click the
'Compute Tax' button in the GUI, see Step 6 below


6. Use the 'taxsolve' CLI tool to solve the Schedule C dat file and save
the results to an out file.

./OpenTaxSolver2010_8.04/bin/taxsolve_US_2010_Sched_C_2010
./US_1040_Sched_C_mine.dat > ./US_1040_Sched_C_mine.out

less ./US_1040_Sched_C_mine.out
# inspect the computed output values, save this file for later


7. Use Evince or Acroread to fill-in the f1040sse.pdf form (only
necessary if you have self-employment income.  Read the IRS document on
self-employment and Schedule SE)

Line 2 of this Schedule SE PDF needs the value from Schedule C computed
output.  This PDF needs to be computed by hand - before continuing on to
the 1040 form.


8. Use the OpenTaxSolver GUI to fill in the US 1040 form.

./OpenTaxSolver2010_8.04/bin/ots_gui ./US_1040_mine.dat

# enter in the values for form 1040 and Schedule A

# note: Line27 on Page 4 and L56 on Page 9 come from the Schedule SE you
calculated by hand in the PDF form (if you have any self-employment
income or taxes)

# When all completed, click SAVE to save the 1040 dat file back to the
file you specified on the invoking commandline

# Click 'Compute Tax' button. The gui will call the taxsolve CLI and
write it to a new out file in the working directory.


9. Inspect the computed results

less ./US_1040_mine.out

* Observe that OpenTaxSolver has computed:
  - all necessary lines for 1040 form
  - Schedule D, if needed (Capital Gain/Loss)
  - Schedule A, itemized deductions
  - Schedule L, itemized deductions (if necessary)
  - AMT form 6251 (Alternative Minimum Tax, if applicable)
  - Schedule M,
  - Any other worksheets used to determine eligibilities
  - Tax from tax tables


10.  Fill in the PDF forms.

Use evince or acroread to open the f1040.pdf, f1040sa.pdf, f1040sc.pdf &
f1040sse.pdf files (and other files if you are affected by Schedule D,
L, M or AMT)

Transfer the values from the 1040 output file to the proper locations in
the f1040 and f1040sa PDFs.  Transfer the values from the ScheduleC
output to the f1040sc.pdf. Double-check the Schedule SE PDF.

This part is a few more minutes of tedious work.  (It would be nice of
there was an application that could read the output text file and do
automatic form-filling of all the PDF files.)

Save the PDF files.  I could get evince to edit the form values, but it
failed to write out a new PDF when I wanted to save the file.  Acroread
worked perfectly.

Print, sign and mail your forms.


Repeat Steps 8-10 with the CA 540 form. (California Residents)  You will
need to run the CLI taxsolve utility on the CA_540 dat file (instead of
clicking the 'Compute Tax' button in the GUI.


I had, towards the end of the process tonight, discovered that I had
neglected to include one tax line from one of my W2's that I had
pre-paid last year.  I basically ran steps 8-10 again, by loading my
1040 dat file, clicked forward a few pages, adjusted the value and
clicked the 'Compute Tax' button.  It updated all the right values.  I
then just walked back through my PDF file and adjusted the few locations
that had changed while walking through the 'out' file.

It only took about 5 minutes to adjust everything once I had noticed my
mistake, and was worth about $350 to have corrected the error to receive
the correct refund.  It doesn't quite do the "bubble-up" approach of the
commercial tax prep packages, but it is still quite usable once you get
the workflow down.



11.  Back-up files.

When you are completely finished, you should be able to back-up the
entire working directory, including the government-issue PDF forms, your
data input and output files, and the OpenTaxSolver software itself.  I
have not tried resurrecting and re-running previous versions of the
software, but the (text-file) formats are open, and the software is open
source, so theoretically you should be able to repeat this process
whenever you need to in the future.  I plan on keeping any version of
software used along with my data files.


12.  Disclaimer

This message is informational only on use of open-source software.  No
tax calculation advice is implied by me.  If you have doubts of the
accuracy of Open Tax Solver, or suspect an error, you may wish to
re-compute your tax using another method, or consult a licensed tax
professional.  There is no warranty or implied expectation of
performance of this software or HOWTO document.


_______________________________________________
LinuxUsers mailing list
LinuxUsers@socallinux.org
http://socallinux.org/cgi-bin/mailman/listinfo/linuxusers

Reply via email to