OFX Message Support in MSN Money and Microsoft Money

Total Page:16

File Type:pdf, Size:1020Kb

OFX Message Support in MSN Money and Microsoft Money

OFX Message Support in MSN Money and Microsoft Money

OFX Message Support in MSN Money and Microsoft Money...... 3 1. Conventions...... 3 2. Structure...... 4 2.2 OFX Headers...... 4 Message Sets...... 5 2.4.6 Transaction Wrapper Request – XXXTRNRQ...... 5 2.5 Signon Message Set...... 6 2.5.2 USERPASS Change...... 7 2.6 External Data Support...... 7 3. Common Aggregates and Elements...... 8 4. Security...... 8 5. International...... 8 5.2 Currency...... 8 6. Data Synchronization...... 9 6.6 Synchronization Transaction Wrappers...... 9 7. FI Profile...... 10 7.1 Profile Request & Response...... 10 8. Activation & Account Information...... 13 8.4 Enrollment and Password Acquisition...... 13 8.5 Account Information...... 14 8.6 Service Activation...... 15 8.7 Name and Address Changes...... 16 8.8 Signup Message Set Profile Information...... 16 9. Customer to FI Communication...... 17 Generic Mail...... 17 9.3 Get HTML Page...... 19 9.4 Email Message Set Profile...... 19 10. Recurring Transactions...... 20 10.2 Recurring Instructions...... 20 10.2.1 Values for FREQ...... 20 11. Banking...... 21 Banking Support Summary...... 21 11.3 Common Banking Aggregates...... 22 11.4.1 Banking Statement Download...... 24 11.4.2 Credit Card Statement Download...... 26 11.5 Statement Closing Information...... 30 11.6 Stop Check...... 30 11.7 Intra-bank Funds Transfers...... 31 11.8 Inter-bank Transfer...... 32 11.9 Wire Transfer...... 32 11.10 Recurring Funds Transfer...... 32 11.11.1 Banking E-mail...... 33 11.12 Synchronization...... 35 11.12.7.2 Response ...... 39 11.13 Bank Message Sets and Profile...... 39 12. Payments...... 42 12.5 Common Bill Payment Aggregates...... 43 12.6 Payments Functions...... 46 12.6.2 Payment Modification...... 47 12.7 Recurring Payments...... 48 12.8 Payment Mail...... 51 12.9 Payee Lists...... 51 12.10 Payment Synchronization...... 53 12.10.2 Recurring Payment Synchronization...... 55 12.11.2 Bill Payment Message Set Profile ...... 56 Process Date Model...... 57 13. Investments...... 58 13.6 Investment Accounts...... 58 13.7 Investment Message Sets and Profile...... 60 13.8.1 Security Identification ...... 61 13.9 Investment Statement Download...... 66 13.9.2.6 Positions...... 76 13.9.2.7 Investment Balances ...... 77 13.10 Investment E-Mail...... 77 OFX 2.0...... 78 Support for OFX 2.0 and XML Header...... 78 401K support...... 78 OFX Message Support in MSN Money and Microsoft Money

1. Conventions

The conventions used in the tag descriptions include the following: Required tags are in bold. Regular face indicates tags that are optional. Required means that a client must always include the tag in a request, and a server must always include the tag in a response. Required tags occur once unless noted as one or more in the description, in which case the specification allows multiple occurrences. Optional tags occur once if present unless noted as zero or more in the description, in which case the specification allows multiple occurrences. A-n or N-n specifies those values that take an alphanumeric or numeric type value, where n indicates the maximum size. Common value types, such as a dollar amount, are referenced by name. Chapter 3 lists value types that are referenced by name.

Tag Description Required tag (1 or more) Required tag that occurs only once Optional tag; this tag can occur multiple times (0 or more) Values are A, B, and C Takes an alphanumeric value up to 32 characters, A-32 This document covers the OFX message sets supported in Microsoft Money versions 2004 and above. Refer to the end of this document for further information about support for the OFX 2.0 message set. NOTE: MSN Money supports a limited subset of the OFX Message Set supported by Microsoft Money. Support is specifically called out where appropriate.

Enterprise and Support Training Microsoft Confidential April 2018 4 OFX Message Support in MSN Money and Microsoft Money

2. Structure 2.2 OFX Headers Each OFX file must include the OFX header. Microsoft Money and MSN Money generate the header using the following rules:

Tag Value DATA: “OFXSGML” VERSION: “1.02”* “1.03”*** “2.00” “2.02”** “2.03”*** * MSN Money supports “1.02” only ** Money 2006+ only *** Money 2007+ only SECURITY: “NONE” Money does not support Application Encryption. ENCODING: ”USASCII” or “UNICODE” CHARSET: “1252” COMPRESSION: “NONE” OLDFILEUID: File UID of previous request file or “NONE”. Money may reject an OFX response which does not properly echo the NEWFILEUID and OLDFILEUID value in the OFX header. NEWFILEUID: File UID of current request file or “NONE” for Active Statement files.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 5

Message Sets The following table lists each message set in this area and level of support in Money. For Support in MSN Money, refer to specific sections.

Message/Aggr Description Supported in Supported in egate Money? MSN Money XXXTRNRQ Transaction wrapper request Yes Partial XXXTRNRS Transaction wrapper response Yes Partial SONRQ Sign-on request Yes Yes SONRS Sign-on response Yes Yes PINCHRQ Pin change request Yes Partial PINCHRS Pin change response Yes Partial

2.4.6 Transaction Wrapper Request – XXXTRNRQ The generic transaction wrappers are supported in Money.

Tag Description Money Usage Transaction-request aggregate Client-assigned globally unique Transaction GUID generated by ID for this transaction trnuid Money. Used to associate response transactions with requests. Data to be echoed in the Money 2005 and above do not transaction response A-32 send CLTCOOKIE Supplied by Money 2004. If supplied, must be echoed back by server. Transaction authorization TAN provided by user (see number; used in some below). countries with some types of transactions. Country-specific documentation will define messages that require a TAN, A-80 specific request Aggregate for the specific request

2.4.6 TAN Support in Money TANs are supported in Microsoft Money. If a provider has indicated in the provider.ini section of Money branding information that a TAN is required then the user is prompted for the TAN on the PIN dialog. The user is prompted for a single TAN. The TAN is then supplied in the XXXTRNRQ wrapper for each transaction in the request file. The TAN supplied for the user will only persist for the current session. If the call results in Crash Recovery then the TAN should be stored with the request file. In this case, Money does not prompt the user for the TAN.

Enterprise and Support Training Microsoft Confidential April 2018 6 OFX Message Support in MSN Money and Microsoft Money

2.5 Signon Message Set 2.5.1.1 Signon Request – SONRQ The Signon Request is supported in Microsoft Money and MSN Money.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 7

Tag Description Money & MSN Money Usage Record- request aggregate Date and time of the request Date Time from the client computer, Money does not specify datetime milliseconds in outgoing requests. User identification string. Use User ID & , or , but not both; A-32 User password on server. . Password Either & are used, or , but not both; A- 32 Login using previously Not Supported. authenticated context. Use & , or , but not both; A-64 Request server to return a Not supported USERKEY for future use, Boolean Session cookie, value received Supplied if received in previous in previous , not SONRS. sent if first login or if none sent by FI A-1000 Financial-Institution- identification aggregate Organization defining this FI Supplied if required by provider. name space, A-32 Indicated in Provider.ini section of branding files. Financial Institution ID (unique Supplied if required by provider. within ), A-32 Indicated in Provider.ini section of branding files. Requested language for text ISO CODE responses, language US/Canada English “ENG” French “FRE” UK “E NG” Rest of World “ENG”

ID of client application, A-5 “Money” Version of client application, “1400” – Money 2005 N-4. (6.00 encoded as 0600) “1500” – Money 2006 “1600” – Money 2007 and MSN Money Unique ID identifying OFX Money 2007 only after 1.03/2.03 client, A-36 enabled on MS branding server

Enterprise and Support Training Microsoft Confidential April 2018 8 OFX Message Support in MSN Money and Microsoft Money

2.5.1.2 Sign-on Response – SONRS Tag Description Money & MSN Money Usage Record-response aggregate Status aggregate, see list of Translated to text message in possible code values. Call Summary. If an error code. Date and time of the server Discarded response, datetime.

Use user key that instead of Never present, Money never USERID and USERPASS for requests. subsequent requests. TSKEYEXPIRE can limit lifetime. Date and time that USERKEY Never present, Money never expires. requests. Language used in text Money echoes. responses, language

Date and time of last update to Ignored, managed by dates in profile information for any FIPARTNR section of branding service supported by this FI files (see Chapter 7), datetime Date and time of last update to Ignored account information (see Chapter 8), datetime Financial-Institution- Included if indicated identification aggregate Session cookie that the client Stored for inclusion in should return on the next subsequent SONRQ. A-1000

2.5.2 USERPASS Change Supported in Microsoft Money, but not MSN Money except on first call if flag set in Provider.ini section of Money branding information or in response to SONRS 15000.

Message/Aggregate Description Supported Supported in MSN in Money? Money? Password change request Yes Only in response to 15000 or on first call if ChangePin=1 in Provider.ini section of Money branding information. Yes See above A challenge request is the No No first step in Type 1 application-level security No No

2.6 External Data Support Not supported in Money.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 9

3. Common Aggregates and Elements 3.2.1 Financial Institution Transaction ID Money supports FITID format A-255. 3.2.7 Date Start and Date End Money does not send DTEND in requests. This prevents errors associated with false system time on the client machine. 4. Security 4.1.5 Security Levels  Channel level – supported in Money  Application level – not supported in Money 5. International 5.2 Currency

Tag Description Money Usage or Currency aggregate Ratio of currency to currency, in decimal form, rate ISO-4217 3-letter currency identifier, A-3 or

Note: is supported in all supported aggregates.

Enterprise and Support Training Microsoft Confidential April 2018 10 OFX Message Support in MSN Money and Microsoft Money

6. Data Synchronization Microsoft Money support full Synchronization. MSN Money does not support Synchronization and does not send XXXSYNCRQ. 6.6 Synchronization Transaction Wrappers The following elements are common for all synchronization request transactions:

Tag Description Money Usage Sync transaction-request Server assigned token. Token supplied on previous sync response, “0” if no token present. Indicates whether client is just Not Sent by Money requesting a new token. Indicates whether client is Sent by Money on first call, or requesting refresh when 30 days have elapsed synchronization. since last call.

The following elements are common for all synchronization request responses:

Tag Description Money Usage Sync transaction-response Server assigned token. Stored in Money file for subsequent sync request. Server has determined, based Ignored. on token supplied, that synchronization records does not be returned to the client.

Money processes the following data when received in a SYNC response:  INTRARS  INTRACANCRS  INTRAMODRS  PAYEESYNCRS  PMTRS  PMTCANCRS  PMTMODRS  RECPMTRS  RECPMTCANCRS  RECPMTMODRS See the appropriate sections for further detail

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 11

6.10.1 File-Based Error Recovery Money does not support file-based error-recovery. Instead, if a call fails to complete when a customer is sending a transfer (INTRATRNRQ), a payment (PMTTRNRQ), or a recurring payment (RECPMTTRNRQ) request, Money prompts the user to synchronize their data to determine if the call was successful. 7. FI Profile 7.1 Profile Request & Response OFX allows a provider to indicate which services are supported and which capabilities are enabled for service via the Profile.

Message/Aggregate Description Supported in Money? Supported in MSN Money PROFRQ Profile request No No PROFRS Profile response No No

Money and MSN Money do not support Profile request and response. This information is stored in our branding files and servers. In each of the following sections, the individual message set profiles are listed. For each profile a mapping is provided to the Money branding elements.

Enterprise and Support Training Microsoft Confidential April 2018 12 OFX Message Support in MSN Money and Microsoft Money

7.2.1 Message Set Core Tag Description Money Usage Common-message-set- information aggregate Version number, N-5 (version OFXHeaderVer in Provider.ini 1.0 formatted as 100) section of Money branding information. ”102” , “200”, or “202” Service provider name, A-32 Some financial institutions out-source their OFX servers to a service provider. In such cases, the SPNAME element should be included in the MSGSETCORE. URL where messages in this URL in Provider.ini section of set are to be sent Money branding information. Security level required for this APPENCRYPTION in message set; see Chapter 4 Provider.ini section of Money branding information. Y if transport security must be Not Supported. Money requires used, N if not used; Boolean a secure channel. Signon realm to use with this Not Supported message set One or more languages Not Supported supported FULL for full synchronization FULL capability LITE for lite synchronization capability See Chapter 6 for more information. Y if server supports response- Not supported. file based error recovery, Boolean See Chapter 6 for more information.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 13

7.2.2 Signon Realms Money does not support the notion of a Signon realm.

Tag Description Money Usage Signon-information aggregate Identifies this realm Not Supported. Minimum number of password MIN in provider.ini section characters of Money branding information. Max number of password MAX in provider.ini section characters of Money branding information. Type of characters allowed in CHARTYPE in provider.ini password. section of Money branding information. Y if alphabetic characters are ALPHA in provider.ini allowed, Boolean section of Money branding information. Y if numeric characters are allowed, NUMERIC in provider.ini Boolean section of Money branding information. Y if password is case-sensitive, Always Y Boolean Money sends the password with the case entered by the user. Y if special characters are allowed, SPECIAL in provider.ini Boolean section of Money branding information. Y if spaces are allowed, Boolean SPACES in provider.ini section of Money branding information.

Enterprise and Support Training Microsoft Confidential April 2018 14 OFX Message Support in MSN Money and Microsoft Money

8. Activation & Account Information The following table lists level of support in Microsoft Money and MSN Money for the Activation and Account Information messages:

Message/Aggregate Description Supported in Money and MSN Money? ENROLLRQ Online enrollment request 8.4 No ENROLLRS Online enrollment response No ACCTINFORQ Account info request 8.5 Yes ACCTINFORS Account info response Yes ACCTRQ Account request 8.6 No ACCTRS Account response No ACCTSYNCRQ Service Activation Synchronization No request 8.6.2 ACCTSYNCRS Service Activation Synchronization No response CHGUSERINFORQ Name and address change request 8.7 No CHGUSERINFORS Name and address change response No

IMPORTANT NOTE: Microsoft requires support for the SIGNUP Message set and the ACCTINFORQ/RS aggregates for all OFX server certifications. 8.4 Enrollment and Password Acquisition Not supported in Money.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 15

8.5 Account Information 8.5.1 Account Info Request – ACCTINFORQ Support for this aggregate is required. Money 2005 and above send an ACCTINFORQ before sending a subsequent statement request call. Money 2004 and MSN Money only send this when setting up services for the first time, or when specifically launched by user.

Tag Description Money and MSN Money Usage Account-information-request aggregate Last received in Microsoft Money and MSN a response Money always send 19700101 8.5.2 Account Info Response – ACCTINFORS Tag Description Money Usage Account-information-response aggregate Date and time of last update to Ignored this information on the server Zero or more account See Below. information aggregates End of account information response

Enterprise and Support Training Microsoft Confidential April 2018 16 OFX Message Support in MSN Money and Microsoft Money

8.5.3 Account Information Aggregate – ACCTINFO Tag Description Money Usage MSN Money Usage Account-information- record aggregate Description of the No No account, A-80 Telephone number for No No the account, A-20 Service-specific account information, defined in each service chapter, one or more allowed Service-specific account Money MSN Money My identification Understands Accounts four types of understands account three types of information account records: information CCACCTINFO, records: BANKACCTINFO, CCACCTINFO, BPACCTINFO, BANKACCTINFO, and and INVACCTINFO. INVACCTINFO.

AVAIL = Available, but Money will MSN Money only not yet requested enable both handles ACTIVE and responses with PEND = Requested, but PEND. Server ACTIVE. not yet available will need to ACTIVE = In use handle requests from PENDING accounts with appropriate error codes. 8.6 Service Activation Not supported in Money.  ACCTTRNRQ  ACCTTRNRS  ACCTSYNCRQ  ACCTSYNCRS

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 17

8.7 Name and Address Changes Not supported in Money.  CHGUSERINFORQ  CHGUSERINFORS 8.8 Signup Message Set Profile Information This message set is not supported in Money. Information from this aggregate is supplied in the branding files on the Microsoft branding server.

Tag Description Money and MSN Money Usage Signup-message-set-profile- information aggregate Opening tag for V1 of the message set profile information Common message set information, defined in the profile chapter Enrollment options - only one of , , or is allowed Client-based enrollment supported Y if account number is required as part of enrollment Boolean Web-based enrollment supported URL to start enrollment process Some other enrollment process Message to give to consumer about what to do next (e.g. a phone number) A-80 Y if server supports client-based Not Supported user information changes Y if server can provide information AcctListAvail=Y in on accounts with SVCSTATUS provider.ini section of available, N means client should Money branding expect to ask user for specific information. Required account information Boolean Y if server allows clients to make Not Supported service activation requests, N if server will only advise clients via synchronization of service additions, changes, or deletions. Boolean

Enterprise and Support Training Microsoft Confidential April 2018 18 OFX Message Support in MSN Money and Microsoft Money

9. Customer to FI Communication Generic Mail OFX supports both generic Mail as well as Mail that is specific to the service. Money never sends a Generic Mail request but is prepared to handle a Generic Mail response when received in synchronization. Money supports the service specific e-mail. Refer to sections on Banking, Bill Payment, and Investment for more details on support of service specific e-mail.

Message/Aggregate Description Supported in Money? MAILRQ General mail request No MAILRS General mail response Yes – sync only MAILSYNCRQ General mail sync request Yes – Money 2004 and 2006 only, not supported in Money 2005 MAILSYNCRS General mail sync response Yes All OFX mail messages use the same MAIL aggregate. The MAIL aggregate is supported in Money as it is used in the service-specific e-mail request/responses. 9.2.2 Basic Mail Aggregate OFX supports both general e-mail as well as mail records that are specific by service. Money will never send a general e-mail request but is prepared to handle the general e- mail response when received in synchronization. Money does support the service specific e-mail. All OFX mail messages use the same MAIL aggregate.

Tag Description Money Usage Core e-mail aggregate User ID such as SSN User ID When message was created Current datetime. Sent in Mail datetime requests Money display date received in MAILRS Customer’s input for whom User ID message is from, A-32 Who e-mail should be delivered “Customer Service” to, A-32 Subject of message (plain text, Provided by user (or defaults not HTML), A-60 offered by Money). Body of message, HTML- Provided by user or financial encoded or plain text institution. depending on , A- 10000 End of message Include images in response, N Boolean Y if client wants an HTML N response, N if client wants plain text, Boolean

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 19

9.2.4 Email Synchronization Money 2004 and 2006 support the general mail synchronization requests and responses. Money 2005 does not support this aggregate All versions of Money support service specific mail sync requests and will send bank mail sync and payment mail sync if the server supports those. SPECIAL NOTE: If your server uses to respond to mail requests received in bank or payment mail requests, your customers will not receive those responses in Money 2005. Contact the Microsoft Money financial institution team at [email protected] if you would like to turn off all mail support in Money 2005.

Refer to sections on Banking, Bill Payment, and Investment for more details on support of service specific e-mail. Tag Description Money Usage E-mail-synchronization-request Money 2004 & aggregate 2006 Not supported by Money 2005 Client synchronization option; , , or Previous value of received for Supported this type of synchronization request from server; “0” if no token present in Money; token Request for just the current Not Supported without the history, Boolean Request for refresh of current state, Supported on Boolean new calls and calls over 30 days If Y, do not process requests if client Always N is out of date, Boolean Y if the client accepts mail with images in Always N the message body, N if the client does not accept mail with images in the message body, Boolean Y if client wants an HTML response, N if Always N client wants plain text, Boolean Mail-transaction-request aggregate (0 or Not Supported more)

Enterprise and Support Training Microsoft Confidential April 2018 20 OFX Message Support in MSN Money and Microsoft Money

Tag Description Money Usage E-mail-synchronization-response. aggregate Server history marker, token Supported Y if the token in the synchronization request is Supported older than the earliest entry in the server’s history table. In this case, some responses have been lost. N if the token in the synchronization request is newer than or matches a token in the server’s history table. Boolean Missing e-mail response transactions (0 or more) Supported

9.3 Get HTML Page MIME . Not supported in Money. See also section 2.6. 9.4 Email Message Set Profile Tag Description Money Usage E-mail-message-set-profile- information aggregate Opening tag for V1 of the message set profile information Common message set information, defined in the profile chapter Y if server supports generic Support for General Mail is on e-mail message by default in Money 2004 and 2006. It is off by default in Money 2005 and cannot be enabled. Money allows financial institutions to disable generic email support by setting the DisallowGenMail=1 in the Provider.ini section of Money branding information. Y if server supports get No MIME message

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 21

10. Recurring Transactions Recurring Payments are supported in Microsoft Money. The actual elements within a transaction that can be modified differ by service. See the recurring sections within Banking, and Payments for details. Not Supported:  Recurring Intra-bank Transfers, see section 11.10.  Recurring Inter-bank Transfers The following table describes Money’s usage of the RECURRINST aggregate that is present in the messages for recurring transactions. 10.2 Recurring Instructions Tag Description Money Usage Recurring-Instructions aggregate Number of instructions Number of instructions. If this tag is absent, the schedule is open-ended, N-3 Frequency. Refer to table below for supported frequencies.

10.2.1 Values for FREQ Value Description Money Usage WEEKLY Weekly Supported. BIWEEKLY Biweekly Supported. TWICEMONTHLY Twice a month Supported. MONTHLY Monthly Supported. FOURWEEKS Every four weeks Supported. BIMONTHLY Bimonthly Supported. QUARTERLY Quarterly Supported. SEMIANNUALLY Semiannually Supported. ANNUALLY Annually Supported.

Enterprise and Support Training Microsoft Confidential April 2018 22 OFX Message Support in MSN Money and Microsoft Money

11. Banking Banking Support Summary The following table lists level of Money support for each Banking message set. The remaining sections in this chapter discuss the specific implementation of each supported message.

Message/Aggregate Description Supported Supported in in Money? MSN Money? STMTRQ Statement request Yes Yes STMTRS Statement response Yes Yes CCSTMTRQ Credit Card statement request Yes Yes 11.4.2 CCSTMTRS Credit Card statement response Yes Yes STMTENDRQ Statement closing data request No No 11.5.1 STMTENDRS Statement closing data response No No CCSTMTENDRQ Credit Card closing statement data No No request 11.5.3 CCSTMTENDRS Credit Card closing statement data No No response STPCHKRQ Stop check request 11.6.1 No No STPCHKRS Stop check response No No INTRARQ Intra-bank transfer request 11.7.1 Yes No INTRARS Intra-bank transfer response Yes No INTRAMODRQ Intra-bank transfer modification No No request 11.7.2 INTRAMODRS Intra-bank transfer modification Yes No response INTRACANRQ Intra-bank transfer request 11.7.3 Yes No INTRACANRS Intra-bank transfer response Yes No INTERRQ Inter-bank transfer request 11.8.2 No No INTERRS Inter-bank transfer response No No INTERMODRQ Inter-bank transfer modification No No request 11.8.3 INTERMODRS Inter-bank transfer modification No No response INTERCANRQ Intra-bank transfer cancel request No No 11.8.4 INTERCANRS Intra-bank transfer cancel response No No WIRERQ Wire transfer request 11.9.1 No No WIRERS Wire transfer response No No WIRECANRQ Wire transfer cancellation request No No 11.9.2 WIRECANRS Wire transfer cancellation response No No

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 23

Message/Aggregate Description Supported Supported in in Money? MSN Money? RECINTRARQ Recurring Intra-bank transfer No No request 11.10.1 RECINTRARS Recurring Intra-bank transfer No No response RECINTRAMODRQ Recurring Intra-bank transfer No No modification request 11.10.2 RECINTRAMODRS Recurring Intra-bank transfer No No modification response RECINTRACANRQ Recurring Intra-bank transfer No No cancellation request 11.10.3 RECINTRACANRS Recurring Intra-bank transfer No No cancellation response RECINTERRQ Recurring Inter-bank transfer No No request 11.10.4 RECINTERRS Recurring Inter-bank transfer No No response RECINTERMODRQ Recurring Inter-bank transfer No No modification request 11.10.5 RECINTERMODRS Recurring Inter-bank transfer No No modification response RECINTERCANRQ Recurring Inter-bank transfer No No cancellation request 11.10.6 RECINTERCANRS Recurring Inter-bank transfer No No cancellation response BANKMAILRQ Bank mail request 11.11.1 Yes No BANKMAILRS Bank mail response Yes No CHKMAILRS Return check notification Yes No response 11.11.3.1 DEPMAILRS Return deposit notification Yes No response 11.11.3.2

11.3 Common Banking Aggregates Tag Description Money & MSN Money Usage BANKACCTFROM & Identify an account at an FI 11.3.1 All elements supported BANKACCTTO ACCTTYPE Account Type: CHECKING; All elements supported SAVINGS; MONEYMRKT; CREDITLINE 11.3.1.1 CCACCTFROM & Identify a credit card account at an FI All elements supported 11.3.2 CCACCTTO

Enterprise and Support Training Microsoft Confidential April 2018 24 OFX Message Support in MSN Money and Microsoft Money

11.3.3 Bank Account Information – BANKACCTINFO Only partial support for the BANKACCTINFO aggregate is implemented in Money and MSN Money.

Tag Description Money and MSN Money Usage Bank-account-information aggregate Bank-account-from aggregate Supported, see above. Y if account supports No – See below transaction detail downloads, N if it is balance-only Boolean Y if account is enabled as a No – See below source for an intra- or inter- bank transfer Boolean Y if account is enabled as a No – See below destination for an intra- or inter-bank transfer Boolean Status of the account Money and MSN Money ignore accounts with anything other than ACTIVE Microsoft Money and MSN Money allow statement requests from any account enabled for banking services. Microsoft Money allows transfer requests to and from any account enabled for banking services. Servers should code appropriate error codes if these requests are received from an account that does not support them.

11.3.4 Credit Card Account Information – CCACCTINFO Only partial support for the CCACCTINFO aggregate is implemented in Money.

Tag Description Money Usage Credit-card-account-information aggregate Credit-card-account-from aggregate Supported, see above Y if account supports transaction detail No – See below downloads, N if it is balance-only, Boolean Y if account is enabled as a source for No – See below an intra-bank or inter-bank transfer, Boolean Y if account is enabled as a No – See below destination for an intra-bank or inter- bank transfer, Boolean Status of the account Money and MSN Money ignore accounts with anything other than ACTIVE Microsoft Money and MSN Money allow statement requests from any account enabled for banking services. Microsoft Money allows transfer requests to and from any account enabled for banking services. Servers should code appropriate error codes if these requests are received from an account that does not support them.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 25

11.3.5 IntraXfer Information – XFERINFO All of the elements and aggregates of XFERINFO are supported in Money. 11.3.6 Transfer Processing Status – XFERPRCSTS All of the elements and aggregates of XFERPRCSTS are supported in Money. 11.4.1 Banking Statement Download 11.4.1.1 Statement Request – STMTRQ Statement Requests are generated by Microsoft Money and MSN Money My Accounts.

Tag Description Money & MSN Money Usage Statement-request aggregate Bank-account-from BANKACCTFROM elements aggregate populated with values retrieved during Setup. Routing & transit number Supported Bank identifier for Supported in International international banks products only Account number Supported Type of account Supported Checksum for international Supported in International banks products only Include-transactions aggregate Start date of statement Money and MSN Money default requested, datetime to current date minus 30 days on first call. Money users can modify Subsequent calls send DTEND from pervious call. End date of statement Money does not send this requested, datetime Include transactions flag, Y Boolean

Enterprise and Support Training Microsoft Confidential April 2018 26 OFX Message Support in MSN Money and Microsoft Money

11.4.1.2 Statement Response – STMTRS Statement response is supported in Microsoft Money and MSN Money.

Tag Description Money & MSN Money Usage Statement-response aggregate Default currency for the Supported statement Account from aggregate. Statement-transaction-data aggregate Start date for transaction data, date Value that client should Displayed as statement date. send in next request to insure that it does Stored for use as DTSTART in not miss any transactions, subsequent STMTRQ When date sending, Money & MSN Money crop any timestamp portion and only returns date value. Opening tag for each statement transaction (0 or more) End tag for each statement transaction Ledger balance aggregate Ledger balance amount, Balance. amount NOTE: This should be signed from the perspective of the user. For CREDITLINE accounts this amount should be negative if the customer owes money on the account. Balance date, datetime Ignored – Money uses DTEND

Available balance aggregate Available balance amount, Discarded. amount Balance date, datetime Discarded. Marketing information (at Discarded most 1), A-360.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 27

11.4.2 Credit Card Statement Download 11.4.2.1 Credit Card Statement Request – CCSTMTRQ Microsoft Money and MSN Money will generate the whenever a statement is to be retrieved for an account of type CREDIT CARD.

Tag Description Money & MSN Money Usage Credit-card-download- request aggregate Credit-card-account-from CCACCTFROM elements aggregate populated with values retrieved during Setup. Account number Supported Checksum for international Supported in International banks products only Include transactions Start date of statement Money and MSN Money default requested, datetime to current date minus 30 days on first call. Money users can modify Subsequent calls send DTEND from pervious call. Ending date of statement Money does not send this requested, datetime Include transactions flag, Y Boolean

Enterprise and Support Training Microsoft Confidential April 2018 28 OFX Message Support in MSN Money and Microsoft Money

11.4.2.2 Credit Card Statement Response – CCSTMTRS Credit Card Statement Response is supported in Microsoft Money and MSN Money.

Tag Description Money Usage Credit-card-download- response aggregate Default currency for the Supported statement Account from aggregate. Opening tag for statement transaction data Start date for transaction data, date Value client should send in Displayed as statement date. next request to insure that it does not miss Stored for use as DTSTART in any transactions, date subsequent STMTRQ When sending, Money and MSN Money crop any timestamp portion and only returns date value. Opening tag for each statement transaction (0 or more).

End tag for each statement transaction Ledger-balance aggregate Ledger balance amount, Balance. amount NOTE: This should be signed from the perspective of the user. For Credit Card accounts, this amount should be negative if the customer owes money on the account. Balance date, datetime Ignored – Money uses DTEND for statement date Available balance aggregate Available balance amount, Discarded. amount Balance date, datetime Discarded. Marketing information (at No most 1), A-360

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 29

11.4.2.3.1 Statement Transaction – STMTTRN The Statement Transaction is supported in Microsoft Money and MSN Money My Accounts.

Tag Description Money & MSN Money Usage Statement-transaction aggregate Transaction type. Money accepts all values in this tag. MSN Money ignores this tag. Date transaction was posted Posting date of transaction. to account, datetime NOTE: Server should ensure that this is accurately displayed for all time zones. Microsoft recommends that server either send actual server time of posting, or time that equates to Noon GMT, such as CCYYMMDD120000. Date user initiated Discarded. transaction, if known, datetime Date funds are available, Discarded. datetime Amount of transaction, Transaction amount. Used in amount reconciliation. Transaction ID issued by Stored as unique statement financial institution, A-10. transaction identifier. Used in Used to detect duplicate reconciliation to detect downloads duplicate transactions. This must be unique and persistent. If present, the FITID of a Discarded previously sent transaction that is corrected by this record. This transaction replaces the transaction that it corrects. Actions can be REPLACE Discarded or DELETE. REPLACE replaces the transaction referenced by CORRECTFITID; DELETE deletes it. Server assigned transaction Stored and used in ID; used for transactions reconciliation. initiated by client, such as payment or funds transfer Check (or other reference) Stored and used in number, A-12 reconciliation. Reference number that Discarded uniquely identifies the transaction. Can be used in addition to or instead of a , A-32 Standard Industrial Code, Used to assign default N-6 categories. Payee identifier if available Stored and used in reconciliation.

Enterprise and Support Training Microsoft Confidential April 2018 30 OFX Message Support in MSN Money and Microsoft Money

Tag Description Money & MSN Money Usage Name of payee or Microsoft Money - Stored and description of transaction, used to create a payee in the or A-32 user’s Money file. NOTE: Provide NAME or PAYEE, not both Payee aggregate, see section 12.2 or Extra information (not in Appended to the memo field of ), A-255 the transaction in Money. Can be turned off in Tools Options. Ignored by MSN Money Currency, if different from Used to convert transaction to or CURDEF account currency in Money if Currency aggregate is present. Ignored by MSN Money where all transactions are assumed to be USD. ORIGCURRENCY is ignored

The STMTRN may contain an optional CURRENCY aggregate for each transaction. If this aggregate is provided the driver must perform the currency conversion using the data provided.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 31

11.4.2.3.1.1 Transaction Types used in TRNTYPE Below is the description of the transaction types in the OFX Specification. Also included is the appropriate signage for Money implementation. Microsoft Money will reject or ignore individual transactions that are incorrectly signed. MSN Money My Accounts ignores TRNTYPE and accepts any signage NOTE: While Money accepts any signage for all transactions, positively signed debits and negatively signed credits is an indication that the data is incorrect. Servers should try to avoid this.

Type Description Money Signage CREDIT Generic credit Either DEBIT Generic debit Either INT Interest earned or paid Either NOTE: depends on signage of amount DIV Dividend Either FEE FI fee Either SRVCHG Service charge Either DEP Deposit Either ATM ATM debit or credit Either NOTE: depends on signage of amount POS Point of sale debit or credit Either NOTE: depends on signage of amount Either XFER Transfer CHECK Check Either PAYMENT Electronic payment Either CASH Cash withdrawal Either DIRECTDEP Direct deposit Either DIRECTDEBIT Merchant initiated debit Either REPEATPMT Repeating payment/standing order Either OTHER Other Either 11.5 Statement Closing Information Statement Closing Information is not supported in Money. The following messages are not supported:  STMTENDRQ  STMTENDRS  CCSTMTENDRQ  CCSTMTENDRS 11.6 Stop Check Stop Check messages are not supported in Money. The following messages are not supported:  STPCHKRQ  STPCHKRS

Enterprise and Support Training Microsoft Confidential April 2018 32 OFX Message Support in MSN Money and Microsoft Money

11.7 Intra-bank Funds Transfers 11.7.1.1 Intra-bank Transfer Request – INTRARQ Intra-bank Transfer Request is supported in Money.

Tag Description Money Usage Intra-bank-transfer-request aggregate Transfer information aggregate. Yes 11.7.1.2 Intra-bank Transfer Response – INTRARS Intra-bank Transfer Response is supported in Money.

Tag Description Money Usage Intra-bank-transfer-response aggregate Default currency for the intra- Supported bank transfer response Server ID for this transfer Stored. Used in subsequent INTRACANRQ. Transfer information aggregate, see section

Transfer-date options. Choose either or Projected date of the Posting Date. transfer; response can contain either a . or a but not both; datetime Or Actual date of the transfer, Posting Date. datetime NOTE: Server should ensure that DTXFERPTJ or DTPOSTED are accurately displayed for all time zones. Microsoft recommends that server either send actual server time or time that equates to Noon GMT, such as CCYYMMDD120000. If the response is generated Ignored by a recurring transfer model, this ID references it, see section 11.10 Transfer-processing status, Yes see section 11.3.6

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 33

11.7.2 Intra-bank Transfer Modification Intra-bank Transfer Modifications Request is not supported in Money. The following messages are not supported:  INTRAMODRQ Money 2004 and 2006 process INTRAMODRS when received in an INTRASYNCRS. This allows servers that support future dated transfers to notify customer if a scheduled transfer fails.

Tag Description Money Usage Modification-response Supported aggregate ID assigned by the server to Stored. Used in to identify the transfer being modified, transfer to modify. SRVRTID Transfer information aggregate Transfer processing status 11.7.3 Intra-bank Transfer Cancellation Intra-bank Transfer Cancellations are supported in Money. If server does not support cancellation of immediate transfers, server should return appropriate error code indicating transfer has been processed. 11.8 Inter-bank Transfer Inter-bank Transfers are not supported in Money. Money uses the OFX bill payment message set to support payment mechanisms that allow Inter-bank transfers. The following messages are not supported:  INTERRQ  INTERRS  INTERMODRQ  INTERMODRS  INTERCANRQ  INTERCANRS 11.9 Wire Transfer Wire transfers are not supported in Money. The following messages are not supported:  WIRERQ  WIRERS  WIRECANRQ  WIRECANRS 11.10 Recurring Funds Transfer Recurring Intra-bank Transfers are not supported in Money. The following messages are not supported:  RECINTRARQ  RECINTRARS  RECINTRACANRQ  RECINTRACANRS

Enterprise and Support Training Microsoft Confidential April 2018 34 OFX Message Support in MSN Money and Microsoft Money

11.10.2 Recurring Intra-bank Funds Transfer Modification Recurring Inter-bank Transfers Modifications are not supported in Money. The following messages are not supported:  RECINTRAMODRQ  RECINTRAMODRS 11.10.4 Recurring Inter-bank Transfers Recurring Inter-bank Transfers are not supported in Money. The following messages are not supported:  RECINTERRQ  RECINTERRS  RECINTERMODRQ  RECINTERMODRS  RECINTERCANRQ  RECINTERCANRS 11.11.1 Banking E-mail OFX supports both generic banking e-mail as well as several types of specific e-mail notification records (e.g. notification of returned deposit. In some cases, OFX mail elements are appended to the message body before being displayed to the user. 11.11.1.1 Banking E-mail Request – BANKMAILRQ Banking E-mail is supported in Money. This mail is sent to the server when user chooses to send a “General purpose letter about Online Banking” in Money.

Tag Description Money Usage Bank-e-mail-request aggregate Account-from aggregate. Account details based on account selection in UI.

or Credit card account from Account details based on aggregate. account selection in UI. To, from, message Refer to section on general information, 9.2.2 Mail support.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 35

11.11.1.2 Banking E-mail Response – BANKMAILRS The Banking E-mail Response is supported in Money.

Tag Description Money Usage Bank-e-mail-response aggregate Account-from aggregate. Account details based on account selection in UI. or Credit card account from Account details based on aggregate. account selection in UI. To, from, message Refer to section on general information, see section Mail support. 9.2.2 Money hides echo BANKMAILRS received in response to a BANKMAILRQ. Money only displays unsolicited MAIL messages. 11.11.2 Notifications 11.11.3.1 Return Check Notification E-mail Response – CHKMAILRS The Return Deposit Notification E-mail Response is only returned from the server when the client requests banking mail synchronization. This message is supported in Money.

Tag Description Money Usage Notification-message- response aggregate Account-from aggregate Account number. To, from, message Refer to section on general Mail information, see 9.2.2 support. Check number, A-12 Appended to message body on separate line as: Returned Check Number: . Amount of check, Appended to message body on amount separate line as: Returned check amount: $ Customer date on Appended to message body on check, date separate line as: Customer date on returned check: Fee assessed for NSF, Appended to message body on amount separate line as: Return check fee: $

Enterprise and Support Training Microsoft Confidential April 2018 36 OFX Message Support in MSN Money and Microsoft Money

11.11.3.2 Return Deposit Notification E-mail Response – DEPMAILRS Return Deposit Notification E-mail is supported in Money.

Tag Description Money Usage Notification-message- response aggregate Account-from aggregate. Account number. To, from, message Refer to section on general information, see 9.2.2 Mail support. Amount of deposit, amount Appended to message body on separate line as: Deposit amount: $ Customer date of deposit, Appended to message body on date separate line as: Date of deposit: Fee assessed for NSF, Appended to message body on amount separate line as: Return deposit fee: $

11.12 Synchronization The following table lists the level of support implemented in Money for Banking related synchronization messages.

Sync Message Description Money Usage STPCHKSYNCRQ Sync request for stop checks. No Support STPCHKSYNCRS Sync response for stop checks. No Support

INTRASYNCRQ Sync request for intra-bank xfer. Supported *

INTRASYNCRS Sync response for intra-bank xfer. Supported * INTERSYNCRQ Sync request for inter-bank xfer. No Support INTERSYNCRS Sync response for inter-bank xfer. No Support WIRESYNCRQ Sync request for wires. No Support WIRESYNCRS Sync response for wires No Support RECINTRASYNCRQ Sync request for recurring intra-bank xfers. No Support RECINTRASYNCRS Sync response for recurring intra-bank xfers. No Support RECINTERSYNCRQ Sync request for recurring inter-bank xfers. No Support RECINTERSYNCRS Sync response for recurring inter-bank xfers. No Support BANKMAILSYNCRQ Sync request for banking mail. 11.12.7 Full Support BANKMAILSYNCRS Sync response for banking mail. Full Support * Money 2005 does not support INTRASYNCRQ/RS. Support for INTRASYNCRQ/RS returns in Money 2006.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 37

11.12.2.1 Request Tag Description Money Usage Synchronization-request aggregate Yes (supported in all but Money 2005) Client synchronization option; , , or Previous value of Yes received for this type of synchronization request from server; 0 for first-time requests in Money 2001 and 2002; token Request for just the current Not Supported without the history, Boolean Request for refresh of current Sent by Money on first state, Boolean call, or when 30 days have elapsed since last call. If Y, do not process requests if Always N client is out of date, Boolean Bank account of interest; token Yes must be interpreted in terms of this account Intra-bank-funds-transfer No – Money sends transactions (0 or more) INTRATRNRQ outside of INTRASYNCRQ wrapper.

Enterprise and Support Training Microsoft Confidential April 2018 38 OFX Message Support in MSN Money and Microsoft Money

11.12.2.2 Response Tag Description Money Usage Synchronization-response aggregate Yes (supported in all but Money 2005) New synchronization token, token Stored by Money Y if the token in the synchronization Ignored request is older than the earliest entry in the server’s history table. In this case, some responses have been lost. N if the token in the synchronization request is newer than or matches a token in the server’s history table. Boolean Bank account of interest; token must be Yes interpreted in terms of this account Intra-bank-funds-transfer transactions (0 or Yes more)

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 39

11.12.7.1 Request Tag Description Money Usage Synchronization-request aggregate Client synchronization option; , , or Previous value of Yes received for this type of synchronization request from server; “0” if no token present in Money 2001 and 2002; token Request for just the current Not Supported without the history, Boolean Request for refresh of current Sent by Money state, Boolean on first call, or when 30 days have elapsed since last call. If Y, do not process requests if Always N client is out of date, Boolean Y if the client accepts mail with Always N images in the message body. N if the client does not accept mail with images in the message body. Boolean Y if client wants an HTML Always N response, N if client wants plain text, Boolean

Account-from options. Choose either or . Account-from aggregate, see section 11.3.1. -or- Credit-card-account-from aggregate, see section 11.3.2. Bank-mail transactions (0 or more) Yes

Enterprise and Support Training Microsoft Confidential April 2018 40 OFX Message Support in MSN Money and Microsoft Money

11.12.7.2 Response Tag Description Money Usage Synchronization-response aggregate New synchronization token, token Y if the token in the synchronization request is older than the earliest entry in the server’s history table. In this case, some responses have been lost. N if the token in the synchronization request is newer than or matches a token in the server’s history table. Boolean

Account-from options. Choose either or . Account-from aggregate, see section 11.3.1 -or- Credit-card-account-from aggregate, see section Bank-mail transactions (0 or more) 11.13 Bank Message Sets and Profile Sync Message Description Money & MSN Money Usage BANKMSGSET Banking No CREDITCARDMSGSET Credit Card No INTERXFERMSGSET Inter-bank Funds Transfer No WIREXFERMSGSET Wire Transfer No

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 41

11.13.2 Bank Message Set Profile This message set is not supported. Microsoft Money obtains the required information from Branding files.

Tag Description Money Usage Message set for banking Version 1 of message set Common message-set core Account type not supported Not Supported. in ; 1 or more of account types, see section for values Closing statement Not Supported. information available, Boolean Intra-bank transfer profile Days of week that no Not Supported. Microsoft processing occurs; 0 or Money allows transfers any more of (MONDAY, day of the week. TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY) Time of day that day’s Not Supported. processing ends, time Supports scheduled INTRAXFERCANSCHED in transfers, Boolean Provider.ini section of Money branding information. Supports recurring transfers, INTRAXFERCANRECUR in Boolean. Requires Provider.ini section of Money branding information. Permit modifications to Not Supported. Money does transfers, i.e. not allow modification of , Boolean xfers. Permit modifications to Not Supported. Money does models, i.e. not allow modification of , xfers. Boolean Model window; the number Not Supported. of days before a recurring transaction is scheduled to be processed that it is instantiated on the system, N-3 Number of days before Not Supported processing date that funds are withdrawn, N-3 Default number of days to DfltDays in Banking pay, N-3 Capabilities in provider.ini section of Money branding information. To enable INTRASYNC in Microsoft Money 2004 or 2006, use the IntraSyncSupp line in Banking Capabilities in provider.ini section of Money branding information.

Enterprise and Support Training Microsoft Confidential April 2018 42 OFX Message Support in MSN Money and Microsoft Money

Tag Description Money Usage Stop check profile Stop checks not supported. Days of week that no Not Supported. processing occurs; 0 or more of (MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY) Time of day that day’s Not Supported. processing ends, time Can stop a range of checks, Not Supported. Boolean. Can stop by description, Not Supported. Boolean. Default stop check free Not Supported. Amount E-mail profile Supports generalized BANKMAIL in Provider.ini banking e-mail, Boolean section of Money branding information. Supports notification (of any Not Supported. kind), Boolean End of bank message set version 1 End of bank message set 11.13.3 Credit Card Message Set Profile The CREDITCARD line in the in Banking Capabilities section of the in provider.ini section of Money branding information indicates whether or not the server supports Credit Cards for banking services. 11.13.4 Inter-bank Transfer Message Set Profile Money does not support the Inter-bank Message Set; therefore, all of the elements in this table are not supported. 11.13.5 Wire Transfer Message Set Profile Wire Transfers are not supported in Money.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 43

12. Payments The following table lists level of support for each Bill Payment message set in Microsoft Money. The remaining sections in this chapter discuss the specific implementation of each supported message.

Message/Aggregate Description Supported in Money? PAYEE Payee 12.5.2.1 Yes PMTINFO Payment info 12.5.2 Yes EXTDPMT Extended Payment 12.5.2.2 No – Money may fault if received EXTDPAYEE Extended Payee 12.5.2.3 Yes PMTPRCSTS Current processing status for a Yes payment 12.5.2.4 PMTRQ Payment request 12.6.1.1 Yes PMTRS Payment response Yes PMTMODRQ Payment modify request 12.6.2.2 No PMTMODRS Payment modify response Yes PMTCANCRQ Payment cancel request 12.6.3.1 Yes PMTCANCRS Payment cancel response 12.6.3.2 Yes PMTINQRQ Payment status request 12.6.4.1 No PMTINQRS Payment status response No RECPMTRQ Recurring payment request 12.7.1.1 Yes RECPMTRS Recurring payment response Yes RECPMTMODRQ Recurring payment modify request No 12.7.2.1 RECPMTMODRS Recurring payment modify response Yes in Money 2005 Ignored in Money 2006 and above RECPMTCANCRQ Recurring payment cancellation Yes request 12.7.3.1 RECPMTCANCRS Recurring payment cancellation Yes response PMTMAILRQ Payment mail request 12.8.1.1 Yes PMTMAILRS Payment mail response 12.8.1.2 Yes PMTMAILSYNCRQ Payment mail sync request 12.8.2.1 Yes PMTMAILSYNCRS Payment mail sync response 12.8.2.2 Yes PAYEERQ Payee request 12.9.1.1 No Money adds and modifies payees implicitly in PMTRQ messages. PAYEERS Payee response 12.9.1.2 Yes PAYEEMODRQ Payee modify request 12.9.2.1 No Money adds and modifies payees implicitly in PMTRQ messages. PAYEEMODRS Payee modify response 12.9.2.2 Yes

Enterprise and Support Training Microsoft Confidential April 2018 44 OFX Message Support in MSN Money and Microsoft Money

Message/Aggregate Description Supported in Money? PAYEEDELRQ Payee delete request 12.9.3.1 No PAYEEDELRS Payee delete response 12.9.3.2 Yes PAYEESYNCRQ Payee sync request 12.9.4.1 Yes PAYEESYNCRS Payee sync response 12.9.4.2 Yes PMTSYNCRQ Payment sync request 12.10.1.1 Yes PMTSYNCRS Payment sync response Yes RECPMTSYNCRQ Recurring payment sync request Yes 12.10.2.1 RECPMTSYNCRS Recurring payment sync response Yes

12.5 Common Bill Payment Aggregates 12.5.1 Payments Account Information Tag Description Money Usage Payments-account-information aggregate Bank-account-from aggregate Refer to Banking section. Status of the account Yes

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 45

12.5.2 Payment Information – PMTINFO The Payment Information aggregate is supported in Money.

Tag Description Money Usage Account-from aggregate, Populated using Online see section 11.3.1 Account Details. Payment amount Payment Amount provided by user. Server payee identifier Payee ID provided by server in (required if assigned) a PAYEESYNCRS when provider supports bill pay via Payee ID. Always sent if available. Complete payee-billing Payee address provided by information. user when provider supports bill pay via address. Always sent if PAYEELSTD is not available. Payee list ID (required if Payee List ID returned from assigned) server. Supplied for all PMTRQs when known. Destination account Not Supported information, for systems that pay by transfers ( also required) Extended Payment Ignored. aggregate, optional Payer account number with User’s account number at the the payee Payee Payment due date Due Date. NOTE: Money always sends with time stamp of Midnight GMT, as CCYYMMDD120000 format. In PMTRS, server should ensure that DTDUE is accurately displayed for all time zones. Microsoft recommends that server either send actual server time or time that equates to Noon GMT, such as CCYYMMDD120000. Memo from user to payee Memo text provided by user.

Enterprise and Support Training Microsoft Confidential April 2018 46 OFX Message Support in MSN Money and Microsoft Money

12.5.2.1 Payee – PAYEE The PAYEE aggregate is supported in Money.

Tag Description Money Usage Name of payee Name of payee Payee’s address lines (1 to 3) Payee’s address lines (1 to 3) Payee’s city City Payee’s state State –Money allows US Postal codes for all US States as well as DC, Military bases, and US protectorates. Payee’s zip code Zip Payee’s country Country Payee’s telephone number Phone Number

12.5.2.3 Extended Payee – EXTDPAYEE The Extended Payee aggregate is returned from the provider. This aggregate is supported in Money only when received in the PAYEEMODRS. It is ignored when received within a PAYEERS.

Tag Description Money Usage Extended-payee aggregate Server-assigned payee ID Payee ID stored for use in subsequent payments to this payee. Scope of the payee ID; one of Money uses this to determine if {GLOBAL, USER }, where Payee can be paid from any FI for this provider. GLOBAL = the payee ID is valid across the entire payments system USER = the payee ID is valid with all FI accounts set up for the user’s payments account Standard payee name Used if not received in the payee aggregate. Minimum number of business Days to Pay is updated for use in days needed to process scheduling subsequent payments to this payee.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 47

12.6 Payments Functions OFX specification does not currently have a way to allow a provider to support EPAY without supporting APAY. Money adds capability to support this by including the field, DisallowRecPayment, in the [BillPayCapabilities] section of the Provider.ini section of Money branding information. 2.6.1.1 Payment Request – PMTRQ The Payment Request is supported in Money. The PMTRQ contains only a PMTINFO aggregate.

Tag Description Money Usage Payment-request aggregate Payment Information Refer to section above on aggregate6. PMTINFO support. 12.6.1.2 Payment Response – PMTRS The Payment Response is supported in Money.

Tag Description Money Usage Payment-response aggregate ID assigned by the server to Transaction ID. Stored for use the payment being created in subsequent actions/inquiries against this transaction. Server-assigned payee list Discarded. Money stores record ID for this payee PAYEELSTID received in PAYEERS. Default currency for the Supported Recurring Payment Response Payment Information Refer to section above for aggregate. PMTINFO support. Standard payee information if Money 2004, 2005, & 2006 payee is a standard payee or ignore EXTDPAYEE within the payee has non-default PMTRS. processing day parameters. Check number Check number. Payment processing status PMTPRCCODE= “WILLPROCESSON” ”PROCESSEDON” ”FAILEDON” ”NOFUNDSON” ”CANCELEDON”

Enterprise and Support Training Microsoft Confidential April 2018 48 OFX Message Support in MSN Money and Microsoft Money

Tag Description Money Usage Payment processing date; Payment posting date in register interpretation depends on updated with DTPMTPRC. NOTE: Server should ensure that DTPMTPRC is accurately displayed for all time zones. Microsoft recommends that server either send actual server time or time that equates to Noon GMT, such as CCYYMMDD120000. Money defaults to using this date for entering payments into the register. Money allows the user to revert to DTDUE date in Tools/Options. References the payment if it Model ID. was generated by a recurring payment

12.6.2 Payment Modification 12.6.2.2 Payment Modification Request Not supported in Money. 12.6.2.3 Payment Modification Response Money processes PMTMODRS.

Tag Description Money Usage Payment-modification-response this references ID assigned by the server to the payment Used to identify being modified, SRVRTID payment to modify Payment Information aggregate Payment processing status Money displays processing status in the Register 12.6.3 Payment Cancellation Supported in Money  PMTCANCRQ  PMTCANCRS 12.6.4 Payment Status Inquiry Not Support in Money.  PMTINQRQ  PMTINQRS

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 49

12.7 Recurring Payments 12.7.1.1 Recurring Payment Request – RECPMTRQ Recurring Payment Request is supported in Money.

Tag Description Money Usage Recurring-payment-request aggregate Recurring Instructions Refer to section on recurring aggregate, see section 10.2. transactions above. Payment-Information Refer to section on PMTINFO aggregate. earlier in this section. amount of the initial payment, Not supported. if different than the following payments amount of the final payment, if Not supported. different than the preceding payments

Enterprise and Support Training Microsoft Confidential April 2018 50 OFX Message Support in MSN Money and Microsoft Money

12.7.1.2 Recurring Payment Response – RECPMTRS Recurring Payment Response is supported in Money.

Tag Description Money Usage Recurring-payment-response aggregate Server-assigned ID for this Model ID. transaction Server-assigned record ID for this Discarded. Money payee record stores PAYEELSTID received in PAYEERS. Default currency for the Recurring Supported Payment Response Recurring-instructions aggregate, Refer to section on see section 10.2. recurring transactions above. Payment-Information aggregate. Refer to section on PMTINFO earlier in this section. amount of the initial payment, if Ignored. different than the following payments amount of the final payment, if Ignored. different than the preceding payments Extended payee information. .

12.7.2.1 Request Not supported in Money.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 51

12.7.2.2 Response Money 2004 and 2005 will process RECPMTMODRS. Ignored in Money 2006/2007.

Tag Description Money Usage Modification-response aggregate ID assigned by the server to the Model ID of the Apay payment being modified, SRVRTID Model to modify Recurring-Instructions aggregate, see section 10.2 Payment-Information aggregate Amount of the initial payment, if Ignored different than the following payments, amount Amount of the final payment, if Ignored different than the preceding payments, amount Y if the client requested that the Ignored server modify pending and future payments. N if the client did not request that the server modify pending and future payments., Boolean

12.7.3.1 Recurring Payment Cancellation Request – RECPMTCANCRQ Recurring Payment Cancellations are supported in Money.

Tag Description Money Usage Cancellation-request aggregate ID assigned by the server Model ID of the Model to be to the payment being canceled. canceled BOOLEAN; if Yes, cancel Y in Money 2005 and above all currently generated payments N in Money 2004 12.7.3.2 Recurring Payment Cancellation Response – RECPMTCANCRS Recurring Payment Cancellation Response is supported in Money. Money will process cancellation responses even if they originated outside of Money.

Enterprise and Support Training Microsoft Confidential April 2018 52 OFX Message Support in MSN Money and Microsoft Money

12.8 Payment Mail 12.8.1.1 Payment Mail Request – PMTMAILRQ Payment Mail Requests are supported in Money.

Tag Description Money Usage Payment e-mail-request aggregate General e-mail aggregate Refer to Mail section earlier in document. Transaction ID of the payment Transaction ID supplied if user that is the subject of the chooses to send a specific correspondence payment mail. Payment Information Sent in Money 2004 and 2006. aggregate. Not sent in Money 2005. 12.8.1.2 Payment Mail Response – PMTMAILRS Payment Mail Responses are supported in Money.

Tag Description Money Usage Payment e-mail-response aggregate General e-mail aggregate, see Refer to Mail section earlier in Chapter 9 document. Transaction ID of the payment Discarded that is the subject of the correspondence Payment Information Discarded aggregate. Money only displays unsolicited MAIL messages, not echoes of PMTMAILRQs sent by Money. 12.9 Payee Lists 12.9.1.1 Payee Request Not supported in Money. Money adds and modifies payees implicitly in PMTRQ messages. 12.9.1.2 Payee Response Supported in Money when received in a . 12.9.2.1 Payee Modification Request Not supported in Money. 12.9.2.2 Payee Modification Response Supported in Money when received in a . 12.9.3 Payee Deletion Request Not Supported in Money. 12.9.3.2 Payee Deletion Response While Money does not remove a payee it receives a PAYEEDELRS, will remove all PAYEEID and PAYEELSTID from this payee.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 53

12.9.4 Payee List Synchronization Request Supported in Money.

Tag Description Money Usage Payee-list-request aggregate Client synchronization option; , , or Previous value of Yes received for this type of synchronization request from server; “0” if no token present in Money ; token Request for just the current No without the history, Boolean Request for refresh of current Sent by Money on first state, Boolean call, or when 30 days have elapsed since last call. If Y, do not process requests if No client is out of date, Boolean Payee transactions (0 or more)

12.9.4 Payee List Synchronization Response Supported in Money.

Tag Description Money Usage Payee-list-request aggregate New synchronization token, token Y if the token in the synchronization request is No older than the earliest entry in the server’s history table. In this case, some responses have been lost. N if the token in the synchronization request is newer than or matches a token in the server’s history table. Boolean Payee transactions (0 or more) Yes

Enterprise and Support Training Microsoft Confidential April 2018 54 OFX Message Support in MSN Money and Microsoft Money

12.10 Payment Synchronization Money support full synchronization. Money will process the following when received in a Sync response.  PMTRS  PMTCANCRS  PMTMODRS 12.10.1.1 Request Tag Description Money Usage Synchronization-request aggregate Client synchronization option; , , or Previous value of Yes received for this type of synchronization request from server; “0” if no token present in Money; token Request for just the current No without the history, Boolean Request for refresh of current state, Sent by Money on Boolean first call, or when 30 days have elapsed since last call. If Y, do not process requests if client N is out of date, Boolean Opening tag for account from Yes aggregate, see section 11.3.1 Payment transactions (0 or more) Yes

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 55

12.10.1.2 Response Tag Description Money Usage Synchronization-response aggregate New synchronization token, token Yes Y if the token in the synchronization No request is older than the earliest entry in the server’s history table. In this case, some responses have been lost. N if the token in the synchronization request is newer than or matches a token in the server’s history table. Boolean Opening tag for account from aggregate, Yes see section 11.3.1 Payment transactions (0 or more) Yes

Enterprise and Support Training Microsoft Confidential April 2018 56 OFX Message Support in MSN Money and Microsoft Money

12.10.2 Recurring Payment Synchronization Money support full synchronization. Money will process the following when received in a Sync response.  RECPMTRS  RECPMTCANCRS  RECPMTMODRS 12.10.2.1 Request Tag Description Money Usage Synchronization-request aggregate Client synchronization option; , , or Previous value of received Yes for this type of synchronization request from server; “0” if no token present in Money; token Request for just the current No without the history, Boolean Request for refresh of current state, Sent by Money on Boolean first call, or when 30 days have elapsed since last call. If Y, do not process requests if client N is out of date, Boolean Opening tag for account from aggregate, see section 11.3.1 Recurring-payment transactions (0 or Yes more)

12.10.2.2 Response Tag Description Money Description Synchronization-response aggregate New synchronization token, token Yes Y if the token in the synchronization request N is older than the earliest entry in the server’s history table. In this case, some responses have been lost. N if the token in the synchronization request is newer than or matches a token in the server’s history table. Boolean Opening tag for account from aggregate, see section 11.3.1 Recurring-payment transactions (0 or more)

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 57

12.11.2 Bill Payment Message Set Profile As in other message sets, Money uses the MNN files to set this information.

Tag Description Money Usage Number of days before DAYSWITH in Provider.ini processing date that funds section of Money branding are withdrawn for payment information. NOTE: (except by transfer) -1 is not supported Default number of days to DFLTDAYSTOPAY in pay by check (except by Provider.ini section of transfer) Money branding information. Number of days before Not Supported processing date that funds are withdrawn for payment by transfer Default number of days to Not Supported pay by transfer Days of week that no Not Supported. processing occurs; 0 or more of (MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY) Time of day that day’s Not supported processing ends Model window; the number Not Supported. of days before a recurring transaction is scheduled to be processed that it is instantiated on the system Number of days after a Not Supported. transaction is processed that it is accessible for status inquiries If Y, server supports Not Supported. communication of server- initiated payment status changes by means of the PMTMODRS message The payment provider PMTBYADDR in supports payments to Provider.ini section of payees identified by billing Money branding address, that is, the information. PAYEE aggregate, Boolean The payment provider Not Supported supports payments to payees identified by destination account, Boolean

Enterprise and Support Training Microsoft Confidential April 2018 58 OFX Message Support in MSN Money and Microsoft Money

Tag Description Money Usage The payment provider Not Supported, although supports payments to Money will store any payees identified by a PAYEEID values returned user-supplied payee ID, in PAYEERS. Boolean User can add payees. if Not Supported. no, the user is restricted to payees added to the user’s payee list by the payment system, Boolean Supports the EXTDPMT Not Supported. business payment aggregate, Boolean Permits modifications to Not Supported. payments, that is PMTMODRQ, Boolean Permits modifications to Not Supported. models, that is REQPMTMODRQ, Boolean Support for specifying a Not Supported. different amount for the first payment generated by a model, Boolean Support for specifying a Not Supported. different amount for the last payment generated by a model, Boolean

Process Date Model Some financial institutions require their customers to submit the process date for a payment rather than the due date. Microsoft Money 2004 and above have a flag in the PROVIDER.ini section of Money branding information to adjust for this when displaying prompts for dates and payment status. If your financial institution supports a bill payment model on your web site where customers indicate when to process a payment, rather than when the payment needs to be received by the payee, contact [email protected] to discuss this.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 59

13. Investments 13.6 Investment Accounts 13.6.1 INVACCTFROM (13.6.1) The INVACCTFROM is used in any context that an investment account needs to be identified.

Tag Description Money & MSN Money Usage Account at FI. < BROKERID > Unique identifier for Microsoft Money and MSN Money My the FI, Accounts - From BrokerID field in the [OFX] section of the Provider.ini section of Money branding information. Account number at FI’s account number for this account FI. End tag for account from aggregate

13.6.2 Investment Account Information Tag Description Money & MSN Money Usage Investment-account- information-record aggregate Account at FI Yes Classification of account. Yes See next section for values Whether the account has Ignored check writing privileges, Y or N Activation status for MSN Money ignores any investment statement accounts that are not returned downloads for the account. as AVAIL. ACTIVE (signed up), PEND (in the process of signing Microsoft Money enable both up), AVAIL (have not signed ACTIVE and PEND. Server will up). need to handle requests from PENDING accounts with appropriate error codes. Type of account. Ignored INDIVIDUAL, JOINT, TRUST, CORPORATE Text description of option Discarded trading privileges

Enterprise and Support Training Microsoft Confidential April 2018 60 OFX Message Support in MSN Money and Microsoft Money

13.6.2.1 Values for Microsoft Money stores this information with account. MSN Money ignores it. If this is a new account Money can guess at the tax-deferred status from this field.

Product Type Description Money Usage 401K A 401(K) account Yes 403B A 403(B) account Yes IRA An IRA account Yes KEOGH Keogh (Money Purchase/Profit Sharing) Yes OTHER Other account type Yes SARSEP Salary Reduction Simplified Employer Pension plan Yes SIMPLE Savings Incentive Match Plan for employees Yes NORMAL Regular account Yes TDA Tax Deferred Annuity Yes TRUST Trust (including UTMA) Yes UGMA Custodial account Yes

Microsoft Money Handling of 401K and 403B Designated Accounts Since 401(k) and 403(B) accounts are not taxed based upon capital gains but as income, Money simplified the manual and online reconciliation of securities in accounts designated as one of these types of retirement accounts. When Money 2004 receives a statement for an account that designated as a 401K or 403B Money processes the positions and clears out any cash in the contributions (cash) account. Money ignores any transactions in the OFX response. If a server provides statement data, and the user wishes to have Money process it, there is a work around. User can change the account type from a retirement account to an Investment account in Account Details. Then turn it back to a retirement account so that it can be managed such in the Financial Planner and other tools. Set it as another type of retirement account, such as Other (For Employee). NOTE: Any other type of retirement account will process statements. This behavior only affects 401(K) and 403(B) designated accounts. For a work around to this issue, please see http://support.microsoft.com/default.aspx?scid=kb;en-us;822766.

Money 2005 and above resolves this by allowing the user to choose for all account types whether they wish to view positions only, or to receive statements data as well.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 61

13.7 Investment Message Sets and Profile Microsoft Money and MSN Money My Accounts use the branding files to set this information. 13.7.1.1 Investment Statement Message Set Profile Tag Description Money & MSN Money Usage Investment-statement- message-set-profile aggregate Version 1 message set Common message set information, see Chapter 7 Whether the FI server Yes – Microsoft Money downloads investment statement transactions, No – MSN Money My Accounts Boolean Money - On by default, disabled by DisallowInvTranDownload field in the [Investment Capabilities] section of the Provider.ini section of Money branding information. Whether the FI server NO downloads investment open orders, Boolean Whether the FI server Yes - downloads investment statement positions, Money - On by default, disabled Boolean by DisallowPositionDownload field in the [Investment Capabilities] section of the Provider.ini section of Money branding information. MSN Money My Accounts – Not supported Whether the FI server Yes - downloads investment balances, Boolean Money & MSN Money My Accounts - - On by default, disabled by DisallowInvBalanceDownload field in the [InvestmentCapabilities] section of the Provider.ini section of Money branding information. Whether the FI supports NO e-mail, Boolean

13.7.2 Security Information Not used by Money

Enterprise and Support Training Microsoft Confidential April 2018 62 OFX Message Support in MSN Money and Microsoft Money

13.8.1 Security Identification SECID is used in any context that a security needs to be identified. The SECID includes a field for ID and a field to define the nature of the ID. In the U.S., a type of ID called CUSIP is the recommended IDTYPE; however this is not required for 100% of the cases due to broker needs.

Tag Description Money & MSN Money Usage Opening tag for the security identifier Unique identifier for the Stored security. CUSIP for US FIs. Name space for the unique Stored ID. CUSIP for US FIs.

13.8.2.1 Security List Transaction Request Not supported by Money 13.8.2.2 Security List Request Not supported by Money 13.8.3.1 Security List Transaction Response Not supported in Money. Ignored. 13.8.3.3 Security List Response Not supported in Money.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 63

13.8.4 Security List Supported in Microsoft Money and MSN Money. 13.8.5.1 General Securities Information Required for each security referenced in the Investment Message Set. Tag Description Money &MSN Money Usage

Security-information aggregate Security-identifier aggregate Yes Full name of security, A-120 Yes – A-70, Security name must be unique within first 70 characters. Ticker symbol (at most one), A-32 Yes FI ID number for this security (at most one), A-32 Ignored Rating, A-10 Ignored Current price of security, unitprice Ignored Date as of for the unit price, datetime Ignored Overriding currency aggregate for unit price, see Ignored section 5.2 Supported in Microsoft Money only Memo Ignored

Enterprise and Support Training Microsoft Confidential April 2018 64 OFX Message Support in MSN Money and Microsoft Money

13.8.5.2 Debt Information Microsoft Money can associate a DEBTINFO type security with either a Bond or a Discounted Bond based on the value of the DEBTTYPE field (Coupon = bond, Zero = Discounted Bond). MSN Money My Accounts does not store this level of detail.

Tag Description Money & MSN Money Usage Opening tag for debt information aggregate Security information aggregate Par value, amount Ignored Presumed Par Value is always 100. Debt type (at most one) Supported COUPON = coupon ZERO = zero coupon Classification of debt. TREASURY, Ignored MUNICIPAL, CORPORATE, OTHER. Bond coupon rate for next closest call date (at Ignored most one), rate Maturity date for next coupon, date Ignored When coupons mature. One of the following Ignored values: MONTHLY, QUARTERLY, SEMIANNUAL, ANNUAL, or OTHER. Bond call price (at most one), unitprice Ignored Yield to next call, rate Ignored Next call date (at most one), date Ignored Type of next call. CALL, PUT, PREFUND, Ignored MATURITY Yield to maturity, rate Ignored Debt maturity date (at most one), date Supported Asset Class (at most one), DOMESTICBOND, Ignored INTLBOND, LARGESTOCK SMALLSTOCK, INTLSTOCK, MONEYMRKT, OTHER Text string containing an FI defined asset Ignored class, A-32

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 65

13.8.5.3 Mutual Fund Information Microsoft Money and MSN Money ignore the type-specific tags in MFINFO (other than what is specified in SECINFO).

Tag Description Money & MSN Money Usage Mutual-fund-information aggregate Security-information aggregate Yes Mutual fund type. OPENEND, Ignored CLOSEEND, OTHER Current yield reported as portion of the Ignored fund’s assets (at most one), rate As-of date for yield value, datetime Ignored Asset class breakdown for the mutual fund Ignored Portion of the mutual fund with a specific Ignored asset classification (one or more) Asset Class, DOMESTICBOND, Ignored INTLBOND, LARGESTOCK SMALLSTOCK, INTLSTOCK, MONEYMRKT, OTHER Percentage of the fund that falls under this Ignored asset class, rate Ignored FI defined asset class breakdown for the Ignored mutual fund Portion of the mutual fund with a specific Ignored asset classification (one or more) Text string containing an FI defined asset Ignored class, A-32 Percentage of the fund that falls under this Ignored asset class, rate

Enterprise and Support Training Microsoft Confidential April 2018 66 OFX Message Support in MSN Money and Microsoft Money

13.8.5.4 Option Information Money 2003 and higher have support for security type Option, however support for options is not suggested in Money 2003. For further information on issues with Options in Money 2003, please review http://www.microsoft.com/money/partner/tools/TroubleshootingOFX.doc.

Tag Description Money & MSN Money Usage Option-information aggregate Security-information aggregate Supported Option type: Supported PUT = put CALL = call Strike price unitprice Supported Expiration date, date Supported Shares per contract, N-5 Supported Security ID of the underlying Ignored security In Money 2003+, customer should manually add this information. Asset Class (at most one), Ignored DOMESTICBOND, INTLBOND, LARGESTOCK SMALLSTOCK, INTLSTOCK, MONEYMRKT, OTHER Text string containing an FI defined Ignored asset class, A-32

13.8.5.5 Other Security Type Information Money and MSN Money maps to Mutual Funds

Tag Description Money & MSN Money Usage Other aggregate. Security information aggregate Supported Description of security type, A-32 Asset Class (at most one), DOMESTICBOND, OTHER Only INTLBOND, LARGESTOCK SMALLSTOCK, INTLSTOCK, MONEYMRKT, OTHER Text string containing an FI defined asset class, A-32

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 67

13.8.5.6 Stock Information Tag Description Money & MSN Money Usage Stock-information aggregate Security-information aggregate Supported Stock type: COMMON, PREFERRED, Ignored CONVERTIBLE, OTHER Current yield reported as the dividend Ignored expressed as a portion of the current stock price (at most one), rate As-of date for yield value, datetime Ignored Asset Class (at most one): DOMESTICBOND, Ignored INTLBOND, LARGESTOCK SMALLSTOCK, INTLSTOCK, MONEYMRKT, OTHER Text string containing an FI defined asset Ignored class, A-32

13.9 Investment Statement Download Microsoft Money supports investment statement data. MSN Money My Accounts, ignores statements, and processes only positions. 13.9.1.1 Investment Statement Transaction Request Tag Description Money Usage Transaction-request aggregate Client-assigned globally unique ID for this transaction, trnuid Data to be echoed in the transaction Supported response, A-32 Transaction authorization number; used in Supported in some countries with some types of International transactions. Country-specific versions only documentation will define messages that require a , A-80 Aggregate for the investment statement Supported download request (see section 13.9.1.2)

Enterprise and Support Training Microsoft Confidential April 2018 68 OFX Message Support in MSN Money and Microsoft Money

13.9.1.2 Investment Statement Request Tag Description and Type Money Usage

Investment-request aggregate Account-from aggregate Include-transactions aggregate (at most one) Start date of request, datetime Money - Current date minus 30 days on first call. User can customize. Subsequent calls of all versions send DTEND from pervious call. Ending date of request (at most Not sent one),.datetime Whether to include transactions in the statement download, Boolean Y by default in Money 2004 and 2005. DissallowInvTranDownlo ad=1 in Provider.ini section of Money branding information will force N value Money 2006 will also set N value if user indicates that they want to track Positions only.

Always N in MSN Money. Include investment open orders in Always N response, Boolean Include investment positions in Supported response Date that positions should be sent Today down for, datetime Whether to include positions in the statement download, Boolean Include investment balance in Supported response, Boolean

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 69

13.9.2 Investment Statement Response 13.9.2.1 Investment Statement Transaction Response 13.9.2.2 Investment Statement Response Tag Description Money Usage

Investment-response aggregate As of date & time for the statement Ignored download, datetime Default currency for the statement, Supported currsymbol Which account at FI Begin transaction list (at most one) Start date for transaction data, datetime This is the value that should be sent in the Used as next request to insure that DTSTART for next no transactions are missed, datetime call. (investment transaction Investment statement transaction aggregates) aggregates (zero or more); see section 13.9.2.4.4. Banking-related transactions for the Supported by investment account (zero or more) Microsoft Money Ignored by MSN Money (See section 13.9.2.3) End of investment transaction list Beginning of investment position list (at Supported most one) Security type specific position aggregates (zero or more): POSMF, POSSTOCK, POSDEBT, POSOPT, POSOTHER End of investment position list Balances aggregate, see section 13.9.2.7 Supported Beginning of investment open order list (at Ignored most one) Action and security type specific open order aggregates (zero or more) End of investment open order list Marketing information (at most one), A- Ignored 360.

Enterprise and Support Training Microsoft Confidential April 2018 70 OFX Message Support in MSN Money and Microsoft Money

13.9.2.3 Bank Transactions INVBANKTRAN contains a transaction that applies only to the cash account – the transaction has no effect on any shares held. INVBANKTRAN contains a STMTTRN aggregate that is separated out and processed as if it was a banking Statement transaction for the cash account by Microsoft Money only.

Tag Description Money Usage Banking related transactions for the investment account Bank (cash) transaction aggregates Supported in Money, not in MSN Money My Accounts See STMTTRN (banking) (See chapter 11) The sub-account associated with the Discarded, Money only funds for the transaction. has one associated cash account per investment account 13.9.2.4.1 General Transaction Aggregate Tag Description Money Usage Investment-transaction-response aggregate Unique FI-assigned transaction ID. Supported This ID is used to detect duplicate downloads. FITID Server assigned transaction ID, Ignored SRVRTID Trade date; for stock splits, day of Supported - Transaction record, datetime date for all transactions except for splits. NOTE: Server should ensure that DTTRADE and DTSETTLE are accurately displayed for all time zones. Microsoft recommends that server either send actual server time or time that equates to Noon GMT, such as CCYYMMDD120000. Settlement date; for stock splits, Supported only as execution date, datetime transaction date for splits. Other information about transaction (at Supported in Microsoft most one), memo Money only 13.9.2.4.2 Transaction Aggregate Elements Because so many fields are re-used in investment transactions, descriptions will not be included in this section. The complete list is in table 13.9.2.4.2 in the OFX investment specification.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 71

13.9.2.4.3 Investment Buy/Sell Aggregates / Buys and Sells in OFX have unique transaction descriptions based on security type, however all of these transactions are based on an INVBUY or INVSELL type. The tables listed below include the transaction signage expected by Money. An OFX response that is not signed as expected. Microsoft Money rejects individual transactions if improperly signed, rather than the entire response. INVBUY Elements Money Usage Money Signage aggregate See INVTRAN aggregate Identifies security

Number of shares or bonds, based Positive on sec. type Price Positive * Positive Yes ** Positive Yes ** Positive Yes ** Positive Yes ** Positive Total *** Negative

aggregate Yes Discarded aggregate Discarded Discarded

Enterprise and Support Training Microsoft Confidential April 2018 72 OFX Message Support in MSN Money and Microsoft Money

INVSELL Elements Money Usage Money Signage aggregate See INVTRAN aggregate Identifies security Number of shares or bonds, based Negative on sec. type Price Positive Yes Positive Yes * Positive Yes * Positive Yes * Positive Yes * Positive Yes * Positive Discarded Positive Total ** Positive Discarded aggregate Yes Discarded aggregate Discarded Discarded * The Commission recorded in the Microsoft Money register is the sum of COMMISSION, TAXES, FEES, LOAD, and WITHHOLDING. ** TOTAL should equal (UNITS * UNITPRICE +/- Total Commission). For Mutual Funds, Total must compute to within 5¢. All others must compute to within 2¢. Microsoft Money rejects individual transactions that do not compute.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 73

13.9.2.4.4 Investment Transaction Aggregates See OFX specification for description of tags. See notes at the end of this section for specific implementation issues.

Aggregate Name Elements Money Usage aggregate Supported Supported aggregate Supported Supported Ignored aggregate Supported Supported Supported aggregate Supported aggregate Supported Supported aggregate Ignored ALL aggregate aggregate Supported aggregate Supported Supported Supported Ignored Ignored Ignored Ignored aggregate Supported aggregate Ignored aggregate Supported aggregate Supported Supported Ignored Ignored aggregate Supported aggregate Ignored aggregate Ignored ALL aggregate Ignored ALL aggregate aggregate Supported in all versions but aggregate Money 2005 aggregate Ignored Supported Ignored aggregate Supported aggregate Supported Supported Supported Ignored Supported Supported Supported Supported Supported Supported Ignored aggregate Supported aggregate Ignored

Enterprise and Support Training Microsoft Confidential April 2018 74 OFX Message Support in MSN Money and Microsoft Money

Aggregate Name Elements Money Usage Supported Supported Supported Ignored Ignored aggregate Supported aggregate Ignored aggregate Supported Ignored Supported aggregate Supported Supported Ignored Ignored aggregate Supported Supported ** Supported** Ignored Ignored Ignored N aggregate Supported aggregate Supported Supported aggregate Supported aggregate Supported Ignored Ignored Ignored * Supported - INT * Supported - INT aggregate Supported aggregate Ignored Supported Ignored aggregate Supported aggregate Supported Ignored Supported Supported Supported aggregate Ignored Ignored Supported Supported Buys While the BUYTYPE fields is not stored permanently, Money does make short-term use of them to assist in lot matching during reconcile.  BUY (stocks, MF) or BUYTOOPEN (options) indicates a new lot should be created (Activity = Buy)  BUYTOCOVER or BUYTOCLOSE indicates an existing short lot should be closed. (Activity = Cover Short) Closures A closure activity happens, for instance, when an option expires. For Money’s purposes, the effect is the same as a sell (the shares are removed from the person’s holdings, and there is a tax effect and possible cash flow). Because Money has no closure transaction, Money will ignore the aggregate. The OFX spec requires that a buy or sell of the underlying security will be sent as an additional INVTRAN. The Expire option is simply ignored. During Position reconciling, an appropriate Remove Shares transaction will be entered to compensate for the difference due to the Expire or Exercise.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 75

Income The mapping from INCOMETYPE to transaction type in Money is as follows:  CGLONG L-Term Cap Gains Dist  CGSHORT S-Term Cap Gains Dist  DIV Dividend  INTEREST Interest  MISC Other Expense Sell Similarly to buy, the SELLTYPE fields are not stored perpetually but help in lot selection when reconciling.  SELL, SELLTOCLOSE indicates an existing lot is being sold (Activity = Sell)  SELLSHORT, SELLTOOPEN indicates a new lot should be created (Activity = Short Sell) ACCRDINT for a or is included as a separate cash transaction in the associated cash account. should be less than or equal to zero for . Conversely, should be greater than or equal to zero for . If the signage of with respect to and is incorrect Money will not enter the transaction into the cash account. SHPERCTRCT Money presumes SHPERCTRCT of Options is always 100. Splits  OLDUNITS and NEWUNITS - Ignored by Money.  NUMERATOR and DENOMINATOR - Used by Money to calculate split. NOTE: Money requires these values to be integers. Server should round up to the nearest whole number, or use the lowest common denominator.  UNITPRICE -Closing price on the trading day before the split date, adjusted for the split ratio. Transfers  TFERACTION = IN - The transfer will be handled as an Add Shares.  TFERACTION = OUT, the transfer will be handled as a Remove Shares.

Enterprise and Support Training Microsoft Confidential April 2018 76 OFX Message Support in MSN Money and Microsoft Money

13.9.2.4.5 Valid Transactions by Security Type Money rejects individual transactions if the transaction type is not supported in the OFX Specification for the security type. Debt Mutual Fund Option Other Stock BUYDEBT v BUYMF v BUYOPT v BUYOTHER v v v BUYSTOCK v CLOSUREOPT v INCOME v v v v v INVEXPENSE v v v v v JRNLFUND JRNLSEC v v v v v MARGININTEREST REINVEST v v v v RETOFCAP v v v v v SELLDEBT v SELLMF v SELLOPT v SELLOTHER v SELLSTOCK v SPLIT v v TRANSFER v v v v v

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 77

13.9.2.5 Open Orders Not supported. 13.9.2.6 Positions Microsoft Money and MSN Money use the position information to make sure calculations of positions based on all transactions matches the numbers from the brokerage. Money adds or removes shares based upon this information. 13.9.2.6.1 Investment Position Information Tag Description Money & MSN Money Usage General-position aggregate Security identifier Yes Sub-account type Discarded CASH, MARGIN, SHORT, OTHER SHORT = Writer for options, Short Yes in Money and MSN for all others. Money My Accounts LONG = Holder for options, Long Determines sign of UNITS* for all others. For stocks, MFs, other, number of Yes shares held. Bonds = face value. MSN Money My Accounts - Options = number of contracts Positions are noted as quantity LONG or SHORT based upon signage. For stocks, MFs, other, price per Microsoft Money uses this share. data if creating a position Bonds = percentage of par adjustment. Otherwise, Option = premium per share of Money does not update underlying security data with this value. Prices unitprice are obtained from Quote feed. MSN Money My Accounts displays the UNITPRICE value. Market value of this position, Used but not stored amount Date and time of unit price and Discarded market value. Can be 0 if unit price and market value are unknown, datetime Currency information if different from default currency. Comment, memo Ignored. * If POSTYPE is SHORT, the number of shares held is negative; if POSTYPE is LONG, the number of shares held is positive. Note: Money may receive multiple position records for a single security – separate long and short positions, perhaps even held in different sub-accounts. Money sums all of these to arrive at a single aggregate shares held number.

Enterprise and Support Training Microsoft Confidential April 2018 78 OFX Message Support in MSN Money and Microsoft Money

13.9.2.6.2 Investment Positions Investment Position Elements Money & MSN Aggregates Money Usage aggregate Supported aggregate Supported Ignored Ignored Ignored Ignored aggregate Supported Ignored aggregate Supported aggregate Supported Ignored Ignored Ignored

13.9.2.7 Investment Balances Tag Description Money Usage Balances aggregate Cash balance across all sub-accounts. Used to display Should include sweep funds. amount balance of cash account if MARGINBALANCE is 0. Margin balance. A positive balance Used to display indicates a positive cash balance, balance of cash while a negative balance indicates the account customer has borrowed funds. amount Market value of all short positions, Ignored amount Buying power, amount Ignored Beginning of Investment balance list Ignored (at most one) Balance aggregates (one or more) Ignored See Chapter 3 13.10 Investment E-Mail Not supported.

Enterprise and Support Training Microsoft Confidential April 2018 OFX Message Support in MSN Money and Microsoft Money 79

OFX 2.0 Microsoft Money supports the OFX 2.0 message set for all message sets supported by Money. Money 2006 also supports sending and receiving OFX messages sets in OFX 2.02. Money 2006, however, will ignore the new tags in that specification, such as the REVERSALFITID tag in the investment message set or the BALLIST in a bank massage set. Support for OFX 2.0 and XML Header Money has an entry in the Provider.ini section of Money branding information, OfxHeadVer. The default setting is OfxHeadVer=102 to indicate 1.02 support. If OfxHeadVer=200, this indicates that the OFX 2.0 specification is supported. If 2.0 support is indicated, Money sends all requests with the OFX 2.0 XML header, and sends end tags for all tags. Money 2006 also supports OFX 2.02, and will send OfxHeadVer=202, if our branding data indicates support for this. The OFX consortium has published an XML schema for the OFX 2.02 spec which is available at http://www.ofx.net/ofx/downloads/collaborate/architecture/OFX_XML_Schema.zip. 401K support While Microsoft Money can support the OFX 2.0 and 2.02 message sets, it ignores the 401K specific aggregates included in these specifications. Review the Microsoft Money Handling of 401K and 403B Designated Accounts section earlier in this document for further information on how Microsoft Money handles these accounts. For a work around to this issue, please see http://support.microsoft.com/default.aspx?scid=kb;en-us;822766.

Enterprise and Support Training Microsoft Confidential April 2018

Recommended publications