39
Specification 2.0 Tax Extensions Version 1.0 June 30, 2000 © 2000 Intuit Inc., Microsoft Corp. All rights reserved

Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

  • Upload
    vannhu

  • View
    231

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

Specification 2.0Tax Extensions

Version 1.0

June 30, 2000

© 2000 Intuit Inc., Microsoft Corp. All rights reserved

Page 2: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

and

ncialon.

N,

Open Financial Exchange Specification Legend

Open Financial Exchange Specification ©1996-2000 by its publishers: CheckFree Corp., Intuit Inc.,Microsoft Corporation. All rights reserved.

A royalty-free, worldwide, and perpetual license is hereby granted to any party to use the Open FinaExchange Specification to make, use, and sell products and services that conform to this Specificati

THIS OPEN FINANCIAL EXCHANGE SPECIFICATION IS MADE AVAILABLE “AS IS” WITHOUTWARRANTY OF ANY KIND. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW,MICROSOFT, INTUIT AND CHECKFREE (“PUBLISHERS”) FURTHER DISCLAIM ALLWARRANTIES, INCLUDING WITHOUT LIMITATION ANY IMPLIED WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT, ALLOF WHICH ARE HEREBY DISCLAIMED. THE ENTIRE RISK ARISING OUT OF THE USE OFTHIS SPECIFICATION REMAINS WITH RECIPIENT. TO THE MAXIMUM EXTENT PERMITTEDBY APPLICABLE LAW, IN NO EVENT SHALL THE PUBLISHERS OF THIS SPECIFICATION BELIABLE FOR ANY CONSEQUENTIAL, INCIDENTAL, DIRECT, INDIRECT, SPECIAL, PUNITIVE,OR OTHER DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FORLOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATIOOR OTHER PECUNIARY LOSS) ARISING OUT OF ANY USE TO WHICH THIS SPECIFICATIONIS PUT, EVEN IF THE PUBLISHERS HEREOF HAVE BEEN ADVISED OF THE POSSIBILITY OFSUCH DAMAGES.

ii

Page 3: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

OF

TABLE OF CONTENTS

Chapter 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

NKN==q~ñ=lcu=sÉêëáçåë= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=P

NKO==`çåîÉåíáçåë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=P

NKP==píêìÅíìêÉ=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=P

NKQ==`çããçå=^ÖÖêÉÖ~íÉëI=bäÉãÉåíëI=~åÇ=a~í~=qóéÉë= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=P

NKR==cf=mêçÑáäÉ=Ñçê=q~ñ=cìåÅíáçå~äáíó=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=Q

Chapter 2 1099 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

OKN==NMVV=jÉëë~ÖÉ=pÉí=mêçÑáäÉ=fåÑçêã~íáçå= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=R

OKO==NMVV=açïåäç~Ç= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=S

OKOKN==NMVV=jÉëë~ÖÉ=pÉí=oÉèìÉëí=Yq^uNMVVjpdponsN[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=S

OKOKO==NMVV=jÉëë~ÖÉ=pÉí=oÉëéçåëÉ=Yq^uNMVVjpdpopsN[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=S

OKOKP==NMVV=qê~åë~Åíáçå=oÉèìÉëí=Yq^uNMVVqokon[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=S

OKOKQ==NMVV=qê~åë~Åíáçå=oÉëéçåëÉ=Yq^uNMVVqokop[=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=T

OKOKR==NMVV=oÉèìÉëí=Yq^uNMVVon[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=T

OKOKS==NMVV=oÉëéçåëÉ=Yq^uNMVVop[=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=U

OKOKT==m~óÉê=^ÇÇêÉëë=Y=m^vbo^aao[= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=U

OKOKU==oÉÅÉáîÉê=^ÇÇêÉëë=Y=ob`^aao[==K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=V

OKOKV==Yq^uNMVVjfp`|sNMM[= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=NM

OKOKNM===Yq^uNMVVo|sNMM[==K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=NN

OKOKNN==Yq^uNMVV_|sNMM[= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=NO

OKOKNO==Yq^uNMVVfkq|sNMM[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=NR

OKOKNP==Yq^uNMVVafs|sNMM[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=NS

OKOKNQ==Yq^uNMVVlfa|sNMM[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=NT

OKOKNR==pí~íìë=`çÇÉë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=NU

OKP==bñ~ãéäÉë==K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=NV

OKPKN==oÉèìÉëí= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=NV

OKPKO==oÉëéçåëÉ=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=OM

Chapter 3 W2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

PKN==tO=jÉëë~ÖÉ=pÉí=mêçÑáäÉ=fåÑçêã~íáçå= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=OP

PKO==tO=açïåäç~Ç= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=OP

PKOKN==tO=jÉëë~ÖÉ=pÉí=oÉèìÉëí=Yq^utOjpdponsN[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=OP

PKOKO==tO=jÉëë~ÖÉ=pÉí=oÉëéçåëÉ=Yq^utOjpdpopsN[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=OQ

PKOKP==tO=qê~åë~Åíáçå=oÉèìÉëí=Yq^utOqokon[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=OQ

X 2.0 Specification - Tax Extensions i6/30/00

Page 4: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

ii

PKOKQ==tO=qê~åë~Åíáçå=oÉëéçåëÉ=Yq^utOqokop[=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K OR

PKOKR==tO=oÉèìÉëí=Yq^utOon[=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K OR

PKOKS==tO=oÉëéçåëÉ=Yq^utOop[= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K OS

PKOKT==tO=a~í~=^ÖÖêÉÖ~íÉ=Yq^utO|sNMM[==K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K OT

PKOKU==Ybjmilvbo[=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K OV

PKOKV==Ybjmilvbb[= K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K OV

PKOKNM==Ypq^qbfkcl[= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K PM

PKOKNN==Yil`^ifkcl[=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K PM

PKOKNO==pí~íìë=`çÇÉë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K PM

PKP==bñ~ãéäÉë= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K PN

PKPKN==tO=oÉèìÉëí=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K PN

PKPKO==tO=oÉëéçåëÉ= =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K PO

OFX 2.0 Specification - TaxExtensions

6/30/00

Page 5: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

2 and.

causenges

rs.

like

CHAPTER 1 OVERVIEW

This document is a Tax extension to Open Financial Exchange (OFX) Specification 2.0 and covers W1099 information for tax year 2000. For an overview of OFX, see the OFX Specification, version 2.0

1.1 Tax OFX Versions

IRS Tax forms can change year to year, as the IRS requires different information from taxpayers. BeTax OFX messages closely mimic tax form information, they will also have to change as the IRS chatax forms.

The table below shows the mapping of the versioned OFX 1099 tax forms to the appropriate tax yea

1.2 Conventions

The conventions of this document follow those of the OFX Specification 2.0.

1.3 Structure

The structure of the Tax OFX is described in the OFX Specification 2.0, chapter 2.

1.4 Common Aggregates, Elements, and Data Types

All data types used for Tax OFX are described in the OFX Specification 2.0, chapter 3. However, unOFX as a whole, all amounts are in US Dollars.

Tax Form Appropriate Tax Year

<TAX1099MISC_V100> 2000

<TAX1099R_V100> 2000

<TAX1099B_V100> 2000

<TAX1099INT_V100> 2000

<TAX1099DIV_V100> 2000

<TAX1099OID_V100> 2000

<TAXW2_V100> 2000

OFX 2.0 Specification - Tax Extensions 36/30/00

Page 6: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

1.5 FI Profile for Tax Functionality

Profile information for Tax OFX Specification follows the same conventions as standard OFXSpecification 2.0.

4 1.5 FI Profile for Tax Functionality

Page 7: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

CHAPTER 2 1099

2.1 1099 Message Set Profile Information

If 1099 tax form download is supported, the following aggregate must be included in the profile<MSGSETLIST> response.

Tag Description

<TAX1099MSGSET> 1099 message set profile information aggregate

<TAX1099MSGSETV1> Opening tag for the message set profile information

<MSGSETCORE> Common message set information, defined in the OFX specification,Chapter 7, “FI Profile”

</MSGSETCORE>

<TAX1099DNLD> Y if server supports 1099 tax form download,Boolean

<EXTD1099B> Y if server supports the extended 1099 B form by providing ScheduleD proceeds detail information for security sales,Boolean

<TAXYEARSUPPORTED> Years supported for 1099 download for this server (1 or more). If morethan one year is supported, a <TAXYEARSUPPORTED> element issent for each year, in format “YYYY”,N4

</TAX1099MSGSETV1>

</TAX1099MSGSET>

OFX 2.0 Specification - Tax Extensions 56/30/00

Page 8: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

e FIuishRQ>

2.2 1099 Download

A client can request to download all available 1099 forms from an FI. The client will pass a SSN to thusing the <RECID>. If the <RECID> tag is not included, this implies the client does not wish to distingthe ID of the recipient from the signon account. The account itself may be determined from the <SONaggregate that is defined in the OFX Specification, chapter 2, section 5; "The Signon Message Set".

2.2.1 1099 Message Set Request <TAX1099MSGSRQV1>

2.2.2 1099 Message Set Response <TAX1099MSGSRSV1>

2.2.3 1099 Transaction Request <TAX1099TRNRQ>

Tag Description

<TAX1099MSGSRQV1> 1099 message set request

<TAX1099TRNRQ> 1099 request transaction aggregate (1 or more), defined in 2.2.3

</TAX1099TRNRQ>

</TAX1099MSGSRQV1>

Tag Description

<TAX1099MSGSRSV1> 1099 message set response

<TAX1099TRNRS> 1099 response transaction aggregate (1 or more), defined in 2.2.4

</TAX1099TRNRS>

</TAX1099MSGSRSV1>

Tag Description

<TAX1099TRNRQ> 1099 transaction request

<TRNUID> Client assigned transaction id,trnuid (A-36)

<CLTCOOKIE> Not used in 1099 messages, but part of the overall OFXspecification, included here for reference,A-32.

<TAN> Not used in 1099 messages, but part of the overall OFXspecification, included here for completeness,A-80.

<TAX1099RQ> 1099 request aggregate, defined in 2.2.5

</TAX1099RQ>

</TAX1099TRNRQ>

6 2.2 1099 Download

Page 9: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

sthe

2.2.4 1099 Transaction Response <TAX1099TRNRS>

2.2.5 1099 Request <TAX1099RQ>

This requests all types of 1099 tax forms from the server. The client requests the tax year of the formusing the <TAXYEAR> element. If this element is not provided, the server shall return tax forms forcurrent tax year.

Tag Description

<TAX1099TRNRS> 1099 transaction response

<TRNUID> Echoed transaction ID,trnuid (A-36)

<STATUS> Status aggregate, for details see OFX Spec 2.0, section 3.1.4

<CODE> Error code,N-6.

<SEVERITY> Severity of the error: INFO, WARN, or ERROR.

<MESSAGE> A textual explanation from the FI,A-255.

</STATUS>

<CLTCOOKIE> Not used in 1099 messages, but part of the overall OFX specification,included here for reference,A-32.

<TAX1099RS> 1099 response aggregate, defined in 2.2.6

</TAX1099RS>

</TAX1099TRNRS>

Tag Description

<TAX1099RQ> 1099 Request

<ACCTNUM> Account number of recipient, if different from RECIDA-32

<RECID> ID of recipient. Request is for all ID’s associated with this account ifRECID is not specified.A-32

<TAXYEAR> The tax year of the requested forms (0 or more), in format “YYYY”,N-4

</TAX1099RQ>

OFX 2.0 Specification - Tax Extensions 76/30/00

Page 10: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

sented

2.2.6 1099 Response <TAX1099RS>

A 1099 download response can include any type of 1099 tax form for any tax year. These are repreby the <TAX1099x_Vy> wildcard entry below. Tax forms for different years may be sent together.Different versions of the same tax forms (corresponding to different years) may be sent together.

2.2.7 Payer Address < PAYERADDR>

Tag Description

<TAX1099RS> 1099 Response

<ACCTNUM> Account number of recipient, if different from RECID,A-32

<RECID> ID of recipient,A-32

<TAX1099x_Vy> 1099 data aggregates. The x represents the various types of 1099 formsthat may be returned and the y represents the version of that form.(1 or more).

</TAX1099x_Vy>

</TAX1099RS>

Tag Description

<PAYERADDR> Payer Address aggregate

<PAYERNAME1> Name of payer, line 2,A-32

<PAYERNAME2> Name of payer, line 2,A-32

<ADDR1> Payer address, line 1,A-32

<ADDR2> Payer address, line 2, required if ADDR3 is specified,A-32

<ADDR3> Payer address, line 3,A-32

<CITY> Payer address, city,A-32

<STATE> Payer address, state,A-5

<POSTALCODE> Payer address, postal code,A-11

<PHONE> Payer telephone number,A-32

</PAYERADDR>

8 2.2 1099 Download

Page 11: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

2.2.8 Receiver Address < RECADDR>

Tag Description

<RECADDR> Receiver Address aggregate

<RECNAME1> Name of receiver, line 1,A-32

<RECNAME2> Name of receiver, line 2,A-32

<ADDR1> Receiver address, line 1,A-32

<ADDR2> Receiver address, line 2, required if ADDR3 is specified,A-32

<ADDR3> Receiver address, line 3,A-32

<CITY> Receiver address, city,A-32

<STATE> Receiver address, state,A-5

<POSTALCODE> Receiver address, postal code,A-11

</RECADDR>

OFX 2.0 Specification - Tax Extensions 96/30/00

Page 12: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

2.2.9 <TAX1099MISC_V100>

Tag Description

<TAX1099MISC_V100> 1099MISC aggregate

<SRVRTID> ID assigned by the server to the form,SVRVTID

<TAXYEAR> Tax year of this form, in format “YYYY”, N-4 .

<VOID> Y if the is form is void,Boolean

<CORRECTED> Y if this is a corrected form,Boolean

<RENTS> Rents,amount

<ROYALTIES> Royalties,amount

<OTHERINCOME> Other income,amount

<FEDTAXWH> Federal tax withheld,amount

<FISHBOATPRO> Fishing boat proceeds,amount

<MEDHEALTHPAY> Medical/health payments,amount

<NONEMPCOMP> Nonemployee compensation,amount

<SUBPMTS> Substitute payments in lieu of dividends or interest,amount

<PAYER5KSALES> Payer made direct sales of $5,000 or more of consumer products to abuyer (recipient) for resale,Boolean

<CROPINSPRO> Crop insurance proceeds,amount

<STTAXWH> State tax withheld,amount

<PAYERSTATE> Payer’s state code,A-2

<PAYERSTID> Payer's state ID number,A-32

<GROSSATTOR> Gross proceeds paid to an attorney (Code A),amount

<EXCSGLDN> Excess golden parachute payments (Code EPP),amount

<PAYERADDR> Payer address aggregate, defined in 2.2.7

</PAYERADDR>

<PAYERID> Payers Federal identification number,A-32

<RECADDR> Recipient addressaggregate, defined in 2.2.8

</RECADDR>

<RECID> Recipient's identification number,A-32

<RECACCT> Recipient account number,A-32

<TINNOT> Second TIN notification,Boolean

</TAX1099MISC_V100>

10 2.2 1099 Download

Page 13: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

2.2.10 <TAX1099R_V100>

Tag Description

<TAX1099R_V100> 1099R aggregate

<SRVRTID> ID assigned by the server to the form,SVRVTID

<TAXYEAR> Tax year of this form, in format “YYYY”, N-4.

<VOID> Y if the is form is void,Boolean

<CORRECTED> Y if this is a corrected form,Boolean

<GROSSDIST> Gross distribution,amount

<TAXAMT> Taxable amount,amount

<TAXAMTND> Taxable amount not determined,Boolean

<TOTALDIST> Total distribution,Boolean

<CAPGAIN> Capital gain,amount

<FEDTAXWH> Federal income tax withheld,amount

<EMPCONTINS> Employee contributions or insurance premiums,amount

<NETUNAPEMP> Net unrealized appreciation in employer's securities,amount

<DISTCODE> Distribution code (1 or more), A-1

<IRASEPSIMP> IRA/SEP/SIMPLE,BooleanThis tag is required if any of the following tags are present in the 1099Raggregate: GROSSDIST, TAXAMT, FEDTAXWH, STTAXWH, orLCLTAXWH.

<ANNCTRCTDIST> Annual contract distribution,amount

<ANNCTRCTPER> Annual contract percentage,rate

<PERTOTDIST> Your percentage of total distribution,rate

<TOTEMPCONT> Total employee contributions,amount

<STTAXWHAGG> State tax withheld aggregate (0 or more)

<AMOUNT> amountwithheld,amount

<PAYERSTATE> Payer’s state code,A-2

<PAYERSTID> Payer’s state ID number,A-32

<STDIST> State distribution,amount

</STTAXWHAGG>

<LCLTAXWHAGG> Local tax withheld aggregate (0 to more)

<AMOUNT> Amount withheld,amount

OFX 2.0 Specification - Tax Extensions 116/30/00

Page 14: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

is isoxest

2.2.11 <TAX1099B_V100>

The 1099B makes use of a special aggregate <PROCDET_V100> (defined in section 2.2.11.2). Thused to provide Schedule D details for individual securities sales and does not actually map to any bon the IRS 1099B form. Servers that provide this extension to the 1099B form will have signaled thacapability with the <EXDT1099B> element returned as “Y” in the <TAX1099MSGSET> aggregate.

<NAMELCL> Name of locality,A-32

<LCLDIST> Local distribution,amount

</LCLTAXWHAGG>

<PAYERADDR> Payer address aggregate, defined in 2.2.7

</PAYERADDR>

<PAYERID> Payers Federal identification number,A-32

<RECADDR> Recipient address aggregate, defined in 2.2.8

</RECADDR>

<RECID> Recipient's identification number,A-32

<RECACCT> Recipient account number,A-32

</TAX1099R_V100>

Tag Description

<TAX1099B_V100> 1099B aggregate

<SRVRTID> Id assigned tby the server to the form,SVRVTID

<TAXYEAR> Tax year of this form, in format “YYYY”,N-4.

<VOID> Y if the is form is void,Boolean

<CORRECTED> Y if this is a corrected form,Boolean

<DTSALE> Date of sale,date

<CUSIPNUM> Committee on Uniform Security Identity Procedures number,A-22

<STKBND> Stocks, bonds, etc. aggregate

<STKBNDAMT> Amount of stocks, bonds, etc.,amount

<SBGROS> Gross proceeds,Boolean

<SBGROSLESS> Gross proceeds less commissions and option premiums,Boolean

</STKBND>

Tag Description

12 2.2 1099 Download

Page 15: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

<BARTERING> Bartering,amount

<FEDTAXWH> Federal income tax withheld,amount

<DSCR> Description,A-64

<PROFIT> Profit or loss realized,amount

<UNRELPROFITPREV> Unrealized profit or loss on open contracts in previous tax year,amount

<UNRELPROFIT> Unrealized profit or loss on open contracts in this tax year,amount

<AGGPROFIT> Aggregate profit or loss,amount

<EXTDBINFO_V100> Opening tag for the 1099B extended information aggregate, see section2.2.11.1

</EXTDBINFO_V100>

<PAYERADDR> Payer address aggregate, defined in 2.2.7

</PAYERADDR>

<PAYERID> Payers Federal identification number,A-32

<RECADDR> Recipient address aggregate, defined in 2.2.8

</RECADDR>

<RECID> Recipient's identification number,A-32

<RECACCT> Recipient account number,A-32

<TINNOT> Second TIN notification,Boolean

</TAX1099B_V100>

Tag Description

OFX 2.0 Specification - Tax Extensions 136/30/00

Page 16: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

2.2.11.1 <EXTDBINFO_V100>

2.2.11.2 <PROCDET_V100>

Tag Description

<EXTDBINFO_V100> Extended 1099B information typically found in 1099B broker summaryreports.

<PROCDET_V100> Opening tag for proceeds detail data (0 or more) aggregate,see section 7.2.11.2

</PROCDET_V100> End tag for each proceeds detail data aggregate

<TEINTEREST> Tax-exempt interest ,amount

<PABINTEREST> Private activity bond interest included in total tax-exempt interest,amount

<TEINTDIVIDEND> Tax-exempt interest dividend,amount

<PABDIVIDEND> Private activity bond included in total tax-exempt interest dividends,amount

</EXTDBINFO_V100>

Tag Description

<PROCDET_V100> 1099B proceeds description aggregate

<DTAQD>

- or -

Date acquired. This may not always be known by an FI if the securitywas transferred from another FI,dateEither <DTAQD> or <DTVAR>, not both.

<DTVAR> Various acquire dates. The security was acquired over a period of timerather than on a single date,Boolean

<DTSALE> Date of sale,date

<SECNAME> Security name,A-32

<NUMSHRS> Number of shares,quantity

<COSTBASIS> Cost basis. This may not always be known by an FI if the security wastransferred from another FI,amount

<SALESPR> Sales price. This is the total price of the sale and not the price per share,amount

<LONGSHORT> Long-short. Indicates the holding period of the sale when the acquisitiondate should not be used for the term calculation, LONG or SHORT

<WASHSALE> Wash sale. Indicates the sale is subject to wash sale rules,Boolean

</PROCDET_V100>

14 2.2 1099 Download

Page 17: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

ection

2.2.12 <TAX1099INT_V100>

This form contains fields for reporting the standard taxable interest. To report tax-free interest, see s2.2.11.1.

Tag Description

<TAX1099INT_V100> 1099INT aggregate

<SRVRTID> ID assigned by the server to the form,SVRVTID

<TAXYEAR> Tax year of this form, in format “YYYY”, N-4.

<VOID> Y if the is form is void,Boolean

<CORRECTED> Y if this is a corrected form,Boolean

<PAYERRTN> Payer’s RTN,A-32

<INTINCOME> Interest income,amount

<ERLWITHPEN> Early withdrawal penalty,amount

<INTUSBNDTRS> Interest on U.S. Savings Bonds and Treasury obligations,amount

<FEDTAXWH> Federal income tax withheld,amount

<INVESTEXP> Investment expenses,amount

<FORTAXPD> Foreign tax paid,amount

<FORCNT> Foreign country or U.S. possession,A-32

<PAYERADDR> Payer address aggregate, defined in 2.2.7

</PAYERADDR>

<PAYERID> Payers Federal identification number,A-32

<RECADDR> Recipient address aggregate, defined in 2.2.8

</RECADDR>

<RECID> Recipient's identification number,A-32

<RECACCT> Recipient account number,A-32

<TINNOT> Second TIN notification,Boolean

</TAX1099INT_V100>

OFX 2.0 Specification - Tax Extensions 156/30/00

Page 18: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

ee

2.2.13 <TAX1099DIV_V100>

This form contains fields for reporting the standard taxable dividends. To report tax free dividends, ssection 2.2.11.1.

Tag Description

<TAX1099DIV_V100> 1099DIV aggregate

<SRVRTID> ID assigned by the server to the form,SVRVTID

<TAXYEAR> Tax year of this form, in format “YYYY”, N-4 .

<VOID> Y if the is form is void,Boolean

<CORRECTED> Y if this is a corrected form,Boolean

<ORDDIV> Ordinary dividends,amount

<TOTCAPGAIN> Total capital gain distribution,amount

<P28GAIN> 28% rate gain,amount

<UNRECSEC1250> Un-recap. Section 1250 gain,amount

<SEC1202> Section 1202 gain,amount

<NONTAXDIST> Nontaxable distributions,amount

<FEDTAXWH> Federal income tax withheld,amount

<INVESTEXP> Investment expenses,amount

<FORTAXPD> Foreign tax paid,amount

<FORCNT> Foreign country or U.S. possession,A-32

<CASHLIQ> Cash liquidation distribution,amount

<NONCASHLIQ> Non-cash liquidation distribution,amount

<PAYERADDR> Payer address aggregate, defined in 2.2.7

</PAYERADDR>

<PAYERID> Payers Federal identification number,A-32

<RECADDR> Recipient address aggregate, defined in 2.2.8

</RECADDR>

<RECID> Recipient's identification number,A-32

<RECACCT> Recipient account number,A-32

<TINNOT> Second TIN notification,Boolean

</TAX1099DIV_V100>

16 2.2 1099 Download

Page 19: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

2.2.14 <TAX1099OID_V100>

Tag Description

<TAX1099OID_V100> 1099OID aggregate

<SRVRTID> ID assigned by the server to the form,SVRVTID

<TAXYEAR> Tax year of this form, in format “YYYY”, N-4.

<VOID> Y if the is form is void,Boolean

<CORRECTED> Y if this is a corrected form,Boolean

<ORIGISDISC> Original issue discount,amount

<OTHERPERINT> Other periodic interest,amount

<ERLWITHPEN> Early withdrawal penalty,amount

<FEDTAXWH> Federal income tax withheld,amount

<DESCRIPTION> Description,A-1024

<OIDONUSTRES> Original issue discount on U.S. Treasury obligations,amount

<INVESTEXP> Investment expenses,amount

<PAYERADDR> Payer address aggregate, defined in 2.2.7

</PAYERADDR>

<PAYERID> Payers Federal identification number,A-32

<RECADDR> Recipient address aggregate, defined in 2.2.8

</RECADDR>

<RECID> Recipient's identification number,A-32

<RECACCT> Recipient account number,A-32

<TINNOT> Second TIN notification,Boolean

</TAX1099OID_V100>

OFX 2.0 Specification - Tax Extensions 176/30/00

Page 20: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

2.2.15 Status Codes

Code Meaning

0 Success (INFO)

2000 General error (ERROR)

2001 Invalid account (ERROR)

2002 General account error (ERROR)

2003 Account not found (ERROR)

2004 Account closed (ERROR)

2005 Account not authorized (ERROR)

14500 1099 forms not yet available for tax year (INFO)

14501 1099 forms not available for user ID (ERROR)

15000 Must change user password (INFO)

15500 Unsuccessful <SONRQ> (ERROR)

15501 Customer account already in use (ERROR)

15502 User password lockout (ERROR)

18 2.2 1099 Download

Page 21: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

2.3 Examples

2.3.1 Request

<?xml version="1.0" encoding="US-ASCII"?>

<?OFX OFXHeader="200" Version="200" Security="NONE"OldFileUID="NONE" NewFileUID="NONE"?>

<!DOCTYPE OFX PUBLIC "-//OFX//DTD OFX2.0.0//EN""http://www.ofx.net/XML/dtd/OFXTAX/2000/ofxtax2000.dtd">

<!--The above URL is an example only and is TBD. -->

<OFX>

<SIGNONMSGSRQV1>

<SONRQ>

<DTCLIENT>20000130132510</DTCLIENT>

<USERID>123-45-6789</USERID>

<USERPASS>money</USERPASS>

<LANGUAGE>ENG</LANGUAGE>

<APPID>TTAX</APPID>

<APPVER>2000</APPVER>

</SONRQ>

</SIGNONMSGSRQV1>

<TAX1099MSGSRQV1>

<TAX1099TRNRQ>

<TRNUID>12345</TRNUID>

<TAX1099RQ>

<RECID>123-45-6789</RECID>

<TAXYEAR>2000</TAXYEAR>

</TAX1099RQ>

</TAX1099TRNRQ>

</TAX1099MSGSRQV1>

</OFX>

OFX 2.0 Specification - Tax Extensions 196/30/00

Page 22: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

2.3.2 Response

<?xml version="1.0" encoding="US-ASCII"?>

<?OFX OFXHeader="200" Version="200" Security="NONE"OldFileUID="NONE" NewFileUID="NONE"?>

<!DOCTYPE OFX PUBLIC "-//OFX//DTD OFX2.0.0//EN""http://www.ofx.net/XML/dtd/OFXTAX/2000/ofxtax2000.dtd">

<!--The above URL is an example only and is TBD. -->

<OFX>

<SIGNONMSGSRSV1>

<SONRS>

<STATUS>

<CODE>0</CODE>

<SEVERITY>INFO</SEVERITY>

</STATUS>

<DTSERVER>20000130132510</DTSERVER>

<LANGUAGE>ENG</LANGUAGE>

<DTPROFUP>19961220000000</DTPROFUP>

<DTACCTUP>19970430132510</DTACCTUP>

</SONRS>

</SIGNONMSGSRSV1>

<TAX1099MSGSRSV1>

<TAX1099TRNRS>

<TRNUID>12345</TRNUID>

<STATUS>

<CODE>0</CODE>

<SEVERITY>INFO</SEVERITY>

</STATUS>

<TAX1099RS>

<RECID>123-45-6789</RECID>

<TAX1099INT_V100>

<TAXYEAR>2000</TAXYEAR>

<INTINCOME>3000.12</INTINCOME>

<FEDTAXWH>200.56</FEDTAXWH>

<PAYERADDR>

<PAYERNAME1>Charles Schwab</PAYERNAME1>

<ADDR1>123 Schwab Way</ADDR1>

<CITY>Philadelphia</CITY>

<STATE>PA</STATE>

20 2.3 Examples

Page 23: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

<POSTALCODE>26433</POSTALCODE>

</PAYERADDR>

<PAYERID>2331243</PAYERID>

<RECADDR>

<RECNAME1>Mr Investor</RECNAME1>

<ADDR1>464 Invester Way</ADDR1>

<CITY>Mountain View</CITY>

<STATE>CA</STATE>

<POSTALCODE>96433</POSTALCODE>

</RECADDR>

<RECID>123-45-6789</RECID>

<RECACCT>12345</RECACCT>

</TAX1099INT_V100>

<TAX1099DIV_V100>

<TAXYEAR>2000</TAXYEAR>

<TOTCAPGAIN>34000</TOTCAPGAIN>

<P28GAIN>34000</P28GAIN>

<PAYERADDR>

<PAYERNAME1>Charles Schwab</PAYERNAME1>

<ADDR1>123 Schwab Way</ADDR1>

<CITY>Philadelphia</CITY>

<STATE>PA</STATE>

<POSTALCODE>26433</POSTALCODE>

</PAYERADDR>

<PAYERID>2331243</PAYERID>

<RECADDR>

<RECNAME1>Mr Investor</RECNAME1>

<ADDR1>464 Invester Way</ADDR1>

<CITY>Mountain View</CITY>

<STATE>CA</STATE>

<POSTALCODE>96433</POSTALCODE>

</RECADDR>

<RECID>123-45-6789</RECID>

<RECACCT>12345</RECACCT>

</TAX1099DIV_V100>

</TAX1099RS>

</TAX1099TRNRS>

</TAX1099MSGSRSV1>

</OFX>

OFX 2.0 Specification - Tax Extensions 216/30/00

Page 24: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

22 2.3 Examples

Page 25: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

CHAPTER 3 W2

3.1 W2 Message Set Profile Information

If W2 tax form download is supported, the following aggregate must be included in the profile<MSGSETLIST> response.

3.2 W2 Download

A client will request to download a W2 form from a payroll service provider using the SSN of theemployee.

3.2.1 W2 Message Set Request <TAXW2MSGSRQV1>

Tag Description

<TAXW2MSGSET> 1099 message set profile information aggregate

<TAXW2MSGSETV1> Opening tag for the message set profile information

<MSGSETCORE> Common message set information, defined in the OFX specification,Chapter 7, “FI Profile”

</MSGSETCORE>

<TAXW2DNLD> Y if server supports W2 tax form download,Boolean

<TAXYEARSUPPORTED> Years supported for W2 download for this server (1 or more). If morethan one year is supported, a <TAXYEARSUPPORTED> element issent for each year, in format “YYYY”,N4

</TAXW2MSGSETV1>

</TAXW2MSGSET>

Tag Description

<TAXW2MSGSRQV1> W2 message set request

<TAXW2TRNRQ> W2 request transaction aggregate (1 or more), defined in 3.2.3.

</TAXW2TRNRQ>

</TAXW2MSGSRQV1>

OFX 2.0 Specification - Tax Extensions 236/30/00

Page 26: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

3.2.2 W2 Message Set Response <TAXW2MSGSRSV1>

3.2.3 W2 Transaction Request <TAXW2TRNRQ>

Tag Description

<TAXW2MSGSRSV1> W2 message set response

<TAXW2TRNRS> W2 response transaction aggregate (1 or more), defined in 3.2.4

</TAXW2TRNRS>

</TAXW2MSGSRSV1>

Tag Description

<TAXW2TRNRQ> W2 transaction request

<TRNUID> Client assigned transaction id,trnuid (A-36)

<CLTCOOKIE> Not used in W2 messages, but part of the overall OFX specification,included here for reference,A-32.

<TAN> Not used in W2 messages, but part of the overall OFX specification,included here for completeness,A-80.

<TAXW2RQ> W2 request aggregate, defined in 3.2.5

</TAXW2RQ>

</TAXW2TRNRQ>

24 3.2 W2 Download

Page 27: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

et tax

3.2.4 W2 Transaction Response <TAXW2TRNRS>

3.2.5 W2 Request <TAXW2RQ>

This requests the W2 tax form from the server. The client requests the tax year of the forms using th<TAXYEAR> element. If this element is not provided, the server shall return tax forms for the currenyear.

Tag Description

<TAXW2TRNRS> W2 transaction response

<TRNUID> Echoed transaction ID,trnuid (A-36)

<STATUS> Status aggregate, for details see OFX spec, section 3.1.4

<CODE> Error code,N-6.

<SEVERITY> Severity of the error: INFO, WARN, or ERROR.

<MESSAGE> A textual explanation from the FI,A-255.

</STATUS>

<CLTCOOKIE> Not used in W2 messages, but part of the overall OFX specification,included here for reference,A-32.

<TAXW2RS> W2 response aggregate, defined in 3.2.6

</TAXW2RS>

</TAXW2TRNRS>

Tag Description

<TAXW2RQ> W2 Request

<SSN> SSN of the employee,A-32

<TAXYEAR> The tax year of the requested forms (0 or more), in format “YYYY”,N-4

</TAXW2RQ>

OFX 2.0 Specification - Tax Extensions 256/30/00

Page 28: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

3.2.6 W2 Response <TAXW2RS>

A W2 download response can include W2 tax forms for any tax year. These are represented by the<TAXW2_Vy> wildcard entry below. Tax forms for different years may be sent together.

Tag Description

<TAXW2RS> W2 Response

<SSN> SSN of employee,A-32

<TAXW2_Vy> W2 data aggregates. The y represents the version of that form.(1 or more).

</TAXW2_Vy>

</TAXW2RS>

26 3.2 W2 Download

Page 29: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

3.2.7 W2 Data Aggregate <TAXW2_V100>

Tag Description

<TAXW2_V100> W2 aggregate for tax year 2000

<TAXYEAR> Tax year of this form, in format “YYYY”, N-4.

<CNTRLNO> Control number,A-32

<VOID> Y if this W2 is void and a new W2 will be provided,Boolean

<EMPLOYER> Employer info aggregate, section 3.2.7

</EMPLOYER>

<EMPLOYEE> Employee info aggregate, section 3.2.8

</EMPLOYEE>

<WAGES> Wages, tips, other compensation,amount

<FEDTAXWH> Federal tax withheld,amount

<SSWAGES> Social security wages,amount

<SSTAXWH> Social security tax withheld,amount

<MEDICAREWAGES> Medicare wages and tips,amount

<MEDICARETAXWH> Medicare tax withheld,amount

<SSTIPS> Social security tips,amount

<ALLOCATEDTIPS> Allocated tips,amount

<ADVANCEDEIC> Advance EIC payment,amount

<DEPCAREBENEFIT> Dependent care benefits,amount

<NONQUALPLAN> Non qualified plan,amount

<BENEFITSBOX1> Benefits included in Box 1,amount

<CODES> Code and amount aggregate (0 or more)

<CODE> Code,A-1

<CODEAMOUNT> Dollar amount,amount

</CODES>

<OTHER> Other aggregate. Description and amount for Box 14 (0 or more).

<OTHERDESC> Description,A-32

<OTHERAMOUNT> Dollar amount,amount

</OTHER>

<STATUTORY> Statutory employee,Boolean

<DECEASED> Deceased,Boolean

<PENSIONPLAN> Pension plan,Boolean

<LEGALREP> Legal representative,Boolean

<DEFERREDCOMP> Deferred compensation,Boolean

<STATEINFO> State info aggregate (0 or more), section 3.2.9

</STATEINFO>

<LOCALINFO> Local info aggregate (0 or more), section 3.2.10

OFX 2.0 Specification - Tax Extensions 276/30/00

Page 30: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

</LOCALINFO>

</TAXW2_V100>

Tag Description

28 3.2 W2 Download

Page 31: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

3.2.8 <EMPLOYER>

3.2.9 <EMPLOYEE>

Tag Description

<EMPLOYER>

<FEDIDNUMBER> Employer federal ID number,A-32

<NAME1> Employer name, line 1,A-32

<NAME2> Employer name, line 2, A-32

<ADDR1> Employer address, line 1,A-32

<ADDR2> Employer address, line 2,A-32

<ADDR3> Employee address, line 3,A-32

<CITY> Employee city,A-32

<STATE> Employee state or province,A-5

<POSTALCODE> Employee postal code,A-11

<COUNTRY> Employer country; 3-letter country code from ISO/DIS-3166,A-3

</EMPLOYER>

Tag Description

<EMPLOYEE>

<SSN> Employee SS number,A-32

<NAME> Employee name, A-32

<ADDR1> Employee address, line 1,A-32

<ADDR2> Employee address, line 2,A-32

<ADDR3> Employee address, line 3,A-32

<CITY> Employee city,A-32

<STATE> Employee state or province,A-5

<POSTALCODE> Employee postal code,A-11

<COUNTRY> Employee country; 3-letter country code from ISO/DIS-3166,A-3

</EMPLOYEE>

OFX 2.0 Specification - Tax Extensions 296/30/00

Page 32: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

3.2.10 <STATEINFO>

3.2.11 <LOCALINFO>

3.2.12 Status Codes

Tag Description

<STATEINFO>

<STATECODE> State code,A-2

<EMPLOYERSTID> Employer state ID,A-32

<STATEWAGES> State wages, tips etc.,amount

<STATETAXWH> State income tax withheld,amount

</STATEINFO>

Tag Description

<LOCALINFO>

<LOCALITY> Locality name,A-32

<LOCALWAGES> Local wages, tips etc.,amount

<LOCALTAXWH> Local tax withheld,amount

</LOCALINFO>

Code Meaning

0 Success (INFO)

2000 General error (ERROR)

2001 Invalid account (ERROR)

2002 General account error (ERROR)

2003 Account not found (ERROR)

2004 Account closed (ERROR)

2005 Account not authorized (ERROR)

14600 W2 forms not yet available for tax year (INFO)

14601 W2 forms not available for user ID (ERROR)

15000 Must change user password (INFO)

15500 Unsuccessful <SONRQ> (ERROR)

15501 Customer account already in use (ERROR)

15502 User password lockout (ERROR)

30 3.2 W2 Download

Page 33: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

3.3 Examples

3.3.1 W2 Request

<?xml version="1.0" encoding="US-ASCII"?>

<?OFX OFXHeader="200" Version="102" Security="NONE"OldFileUID="NONE" NewFileUID="NONE"?>

<!DOCTYPE OFX PUBLIC "-//OFX//DTD OFX2.0.0//EN""http://www.ofx.net/XML/dtd/OFXTAX/2000/ofxtax2000.dtd">

<!--The above URL is an example only and is TBD. -->

<OFX>

<SIGNONMSGSRQV1>

<SONRQ>

<DTCLIENT>20000130153909</DTCLIENT>

<USERID>123-45-6789</USERID>

<USERPASS>money</USERPASS>

<LANGUAGE>ENG</LANGUAGE>

<APPID>TTAX</APPID>

<APPVER>2000</APPVER>

</SONRQ>

</SIGNONMSGSRQV1>

<TAXW2MSGSRQV1>

<TAXW2TRNRQ>

<TRNUID>12345</TRNUID>

<TAXW2RQ>

<SSN>123-45-6789</SSN>

<TAXYEAR>2000</TAXYEAR>

</TAXW2RQ>

</TAXW2TRNRQ>

</TAXW2MSGSRQV1>

</OFX>

OFX 2.0 Specification - Tax Extensions 316/30/00

Page 34: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

3.3.2 W2 Response

<?xml version="1.0" encoding="US-ASCII"?>

<?OFX OFXHeader="200" Version="200" Security="NONE"OldFileUID="NONE" NewFileUID="NONE"?>

<!DOCTYPE OFX PUBLIC "-//OFX//DTD OFX2.0.0//EN""http://www.ofx.net/XML/dtd/OFXTAX/2000/ofxtax2000.dtd">

<!--The above URL is an example only and is TBD. -->

<OFX>

<SIGNONMSGSRSV1>

<SONRS>

<STATUS>

<CODE>0</CODE>

<SEVERITY>INFO</SEVERITY>

</STATUS>

<DTSERVER>20000130153910</DTSERVER>

<LANGUAGE>ENG</LANGUAGE>

<DTPROFUP>19961220000000</DTPROFUP>

<DTACCTUP>19970430132510</DTACCTUP>

</SONRS>

</SIGNONMSGSRSV1>

<TAXW2MSGSRSV1>

<TAXW2TRNRS>

<TRNUID>12345</TRNUID>

<STATUS>

<CODE>0</CODE>

<SEVERITY>INFO</SEVERITY>

</STATUS>

<TAXW2RS>

<SSN>123-45-6789</SSN>

<TAXW2_V100>

<TAXYEAR>2000</TAXYEAR>

<EMPLOYER>

<FEDIDNUMBER>12-2345678</FEDIDNUMBER>

<NAME>Joe Employer</NAME>

<ADDR1>1234 Joe Way.</ADDR1>

<CITY>Motor</CITY>

<POSTALCODE>54321</POSTALCODE>

</EMPLOYER>

32 3.3 Examples

Page 35: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

<EMPLOYEE>

<SSN>123-45-6678</SSN>

<NAME>Bill Employee</NAME>

<ADDR1>122 Maple Street</ADDR1>

<CITY>Motor</CITY>

<POSTALCODE>54322</POSTALCODE>

</EMPLOYEE>

<WAGES>50000</WAGES>

<FEDTAXWH>25000</FEDTAXWH>

<SSWAGES>55000</SSWAGES>

</TAXW2_V100>

</TAXW2RS>

</TAXW2TRNRS>

</TAXW2MSGSRSV1>

</OFX>

OFX 2.0 Specification - Tax Extensions 336/30/00

Page 36: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

34 3.3 Examples

Page 37: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

TAG INDEX

Conventions

qÜáë=áåÇÉñ=ìëÉë=íÜÉ=ÅçåîÉåíáçåë=ëÜçïå=áå=íÜÉ=ÑçääçïáåÖ=í~ÄäÉ=íç=áÇÉåíáÑó=ÇáÑÑÉêÉåí=Éåíêó=íóéÉëK

A^``qkrj=TI=U

^aaoN=UI=VI=OMI=ONI=OVI=POI=PP^aaoO=UI=VI=OV^aaoP=UI=VI=OV^as^k`babf`=OT^ddmolcfq=NP^iil`^qbaqfmp=OT^jlrkq=NNI=NN^kk`qo`qafpq=NN^kk`qo`qmbo=NN^mmfa=NVI=PN^mmsbo=NVI=PN

B_^oqbofkd=NP_bkbcfqp_luN=OT

C`^md^fk=NN`^peifn=NS`fqv=UI=VI=OMI=ONI=OVI=POI=PP`iq`llhfb=SI=TI=OQI=OR`kqoikl=OT

`lab=TI=OMI=ORI=OTI=PO`lab^jlrkq=OT`labp=OT`loob`qba=NMI=NNI=NOI=NRI=NSI=NT`lpq_^pfp=NQ`lrkqov=OVI=OV`olmfkpmol=NM`rpfmkrj=NO

Dab`b^pba=OTabcbooba`ljm=OTabm`^ob_bkbcfq=OTabp`ofmqflk=NT

afpq`lab=NNap`o=NPaq^``qrm=OMI=POaq^na=NQaq`ifbkq=NVI=PNaqmolcrm=OMI=POaqp^ib=NOI=NQaqpbosbo=OMI=POaqs^o=NQ

Ebd^iobm=OTbjm`lkqfkp=NNbjmilvbb=OTI=OVI=PPbjmilvbo=OTI=OVI=PObjmilvbopqfa=PMboitfqembk=NRI=NT

bu`pdiak=NMbuaqNMVV_=NObuqaNMVV_=Rbuqa_fkcl|sNMM=NPI=NQ

F

cbafakrj_bo=OVI=POcbaq^ute=NMI=NNI=NPI=NRI=NSI=NTI=OMI=OTI=PP

Entry Type Text Style

q~Ö=ÇÉÑáåáíáçå _çäÇ=íÉñí

q~Ö=ëÜçïå=áå=Éñ~ãéäÉ fí~äáÅ=íÉñí

q~Ö=ìëÉÇ=ïáíÜáå=ÄçÇó=çÑ=íÉñí

mä~áå=íÉñí

OFX 1.6 Specification 16/30/00

Page 38: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

cfpe_l^qmol=NMclo`kq=NRI=NScloq^uma=NRI=NS

Gdolpp^qqlo=NMdolppafpq=NN

Ifkqfk`ljb=NRI=OMfkqrp_kaqop=NRfksbpqbum=NRI=NSI=NTfo^pbmpfjm=NN

L

i^kdr^db=NVI=OMI=PNI=POi`iafpq=NOi`iq^ute^dd=NNil`^ifkcl=OTI=PMil`^ifqv=PMil`^iq^ute=PMil`^it^dbp=PMilkdpeloq=NQ

Mjbaeb^iqem^v=NMjbaf`^obq^ute=OT

jbaf`^obt^dbp=OTjbpp^db=TI=ORjpdpbq`lob=RI=OPjpdpbqifpq=RI=OP

Nk^jb=OVI=POI=PPk^jbN=OVk^jbO=OVk^jbi`i=NOkbqrk^mbjm=NNklk`^peifn=NS

klkbjm`ljm=NMklknr^imi^k=OTklkq^uafpq=NSkrjpeop=NQ

Olfalkrpqobp=NTloaafs=NSlofdfpafp`=NTlqebo=OTlqebo^jlrkq=OTlqeboabp`=OTlqebofk`ljb=NMlqebombofkq=NT

PmOUd^fk=NSI=ONm^_afsfabka=NQm^_fkqbobpq=NQm^vboRhp^ibp=NMm^vbo^aao=UI=NMI=NOI=NPI=NRI=NSI=NTI=OMI=ONm^vbofa=NMI=NOI=NPI=NRI=NSI=NTI=ONm^vbok^jbN=UI=OMI=ONm^vbok^jbO=Um^vbooqk=NRm^vbopq^q=NNm^vbopq^qb=NMm^vbopqfa=NMI=NNmbkpflkmi^k=OTmboqlqafpq=NNmelkb=Umlpq^i`lab=UI=VI=ONI=OVI=POI=PPmol`abq|sNMM=NOI=NQI=NQmolcfq=NP

Rob`^``q=NMI=NOI=NPI=NRI=NSI=NTI=ONob`^aao=VI=NMI=NOI=NPI=NRI=NSI=NTI=ONob`fa=SI=TI=UI=NMI=NOI=NPI=NRI=NSI=NTI=NVI=OMI=ONob`k^jbN=VI=ONob`k^jbO=Vobkqp=NM

2

Page 39: Specification 2.0 Tax Extensions - CoverPagesxml.coverpages.org/taxofx10.pdf · ii Open Financial Exchange Specification Legend Open Financial Exchange Specification ©1996-2000 by

olv^iqfbp=NM

Sp^ibpmo=NQp_dolp=NOp_dolpibpp=NOpb`NOMO=NSpb`k^jb=NQpbsbofqv=TI=OMI=ORI=POpfdklkjpdponsN=NVI=PNpfdklkjpdpopsN=OMI=POplkon=SI=NVI=PNplkop=OMI=POposoqfa=NMI=NNI=NOI=NRI=NSppk=ORI=OSI=OVI=PNI=POI=PPppq^ute=OTppqfmp=OTppt^dbp=OTI=PPpq^qb=UI=VI=OMI=ONI=OVpq^qb`lab=PMpq^qbfkcl=OTI=PMpq^qbq^ute=PM

pq^qbt^dbp=PMpq^qrp=TI=OMI=ORI=POpq^qrqlov=OTpqafpq=NNpqh_ka=NOpqh_ka^jq=NOpqq^ute=NMpqq^ute^dd=NNpr_mjqp=NM

Tq^k=SI=OQq^uNMVV_|sNMM=PI=NOq^uNMVVafs|sNMM=PI=NSI=ONq^uNMVVakia=Rq^uNMVVfkq|sNMM=PI=NRI=OMq^uNMVVjfp`|sNMM=PI=NMq^uNMVVjpdpbq=RI=NOq^uNMVVjpdpbqsN=Rq^uNMVVjpdponsN=SI=NVq^uNMVVjpdpops=Sq^uNMVVjpdpopsN=OM

q^uNMVVlfa|sNMM=PI=NTq^uNMVVo|sNMM=PI=NNq^uNMVVon=SI=TI=TI=NVq^uNMVVop=TI=UI=OMq^uNMVVqokon=SI=NVq^uNMVVqokop=SI=TI=OMq^u^jq=NNq^u^jqka=NNq^utO|sNMM=PI=OTI=POq^utOakia=OPq^utOjpdpbq=OPq^utOjpdpbqsN=OPq^utOjpdponsN=OPI=PNq^utOjpdpopsN=OQI=POq^utOon=ORI=PNq^utOop=ORI=OSI=POq^utOqokon=OPI=OQI=PNq^utOqokop=OQI=ORI=POq^uvb^o=TI=TI=NMI=NNI=NOI=NRI=NSI=NTI=NVI=OMI=

ONI=ORI=ORI=OTI=PNI=PO

q^uvb^oprmmloqba=RI=OPqbfkqafsfabka=NQqbfkqbobpq=NQqfkklq=NMI=NPI=NRI=NSI=NTqlq^iafpq=NNqlq`^md^fk=NSI=ONqlqbjm`lkq=NNqokrfa=SI=TI=NVI=OMI=OQI=ORI=PNI=PO

Urkob`pb`NORM=NSrkobimolcfq=NPrkobimolcfqmobs=NPrpbofa=NVI=PNrpbom^pp=NVI=PN

V

slfa=NMI=NNI=NOI=NRI=NSI=NTI=OT

Wt^dbp=OTI=PPt^pep^ib=NQ

OFX 1.6 Specification 36/30/00