/Transmission/Summary/Batch/BusinessTransaction/FinancialTransaction XML Schema Model

Treasury :: Bureau of the Fiscal Service

Enterprise Data Architecture

Transmission Data Exchange

Element Information
Name	FinancialTransaction
Definition	The management of funds between a payer and payee for a specific business event.
DataType	Container

Attribute Information
Attribute Name	Use	DataType	Definition
ID	required	String [0, 80]	An identifier for the record. For a receiving system, this value can be used to reconcile updates to an existing record and qualify new records. For a sending system, this value can be used to reconcile acknowledgements for the submitted records.
AgencyTransactionIdentifier	optional	String [0, 80]	Identifier for a transaction (may not be unique), as provided by an agency.
SettlementTransactionIdentifier	optional	String [0, 80]	Identifies a transaction (may not be unique) within a settlement service.
ChannelTransactionIdentifier	optional	String [0, 80]	Identifies a transaction (may not be unique) within a channel application.
CollectionStatusCode	optional	Cancelled [The financial transaction has been cancelled before submission to the settlement mechanism.], Rejected [The financial transaction has been rejected by the settlement mechanism.], Retired [No more collection efforts will be initiated on the financial item and the agency is debited for the uncollected funds.], Settled [The financial transaction has been settled.], In-Process [The financial transaction has been delivered to the settlement mechanism but has not settled.], Received [The financial transaction has been submitted to the channel.], Unknown [The status of the financial transaction is not known.]	Identifies the status of a transaction; i.e., where it is in its lifecycle.
CollectionTransactionType	optional	Adjustment [A financial transaction that represents a monetary adjustment to an existing transaction.], Chargeback [A card transaction where one or more items are returned.], Collection [A financial transaction that is the initial settlement of the payment.], Correction [A financial transaction that represents a change to classification and non-monetary information for an existing transaction.], Informational [A financial transaction that does not have a monetary accounting outcome.], Re-presentment [A financial transaction that is not the initial settlement of the payment.], Return/Reversal [A financial transaction where the payment was returned to the payer.], Unknown [Financial transactions of an unknown type.]	Standard transaction types which represent a high-level categorization of a financial transaction that is used to help identify what type of transaction activity the financial transaction represents.
PayerMechanismCode	optional	Cash [Coin or paper currency.], Check [Indicates a settlement using Check21 or paper method.], CreditCard [Indicates a settlement using a plastic card that was used to make a payment drawn on a line of credit.], DebitCard [Indicates a settlement using a plastic card that was used to make payment drawn on a bank account maintained for the cardholder.], SVC [Stored Value Card], ACH [A transaction that takes place across the Automated Clearing House (ACH) Network.], Book Entry [Indicates a settlement using an electronic general ledger entry.], Wire [A transaction done through the Federal Reserve Banks as a real-time electronic funds transfers.], EBT [Electronic Benefits Card], Western Union [Western Union]	Identifies the payment medium for the transaction.
IsCredit	required	1\|0	Indicates if the item is a debit or credit so it can be interpreted as a positive or negative value.
IsTax	optional	1\|0	Indicates if the item is a tax transaction.
BankPostingDate	optional	YYYY-MM-DD	The date that funds are credited to or debited from a Treasury account.
ProgramTraceIdentifier	optional	String [0, 80]	Identifier provided by the financial agent to support traceability through the collection lifecycle.
SettlementMechanismCode	optional	Cash [Coin or paper currency.], Cash/Und Check [Indicates settlement that is either cash and/or checks settled by Check21 or paper method.], Book Entry [Indicates a settlement using an electronic general ledger entry.], Check [Indicates a settlement using Check21 or paper method.], ACH [A transaction that takes place across the Automated Clearing House (ACH) Network.], Wire [A transaction done through the Federal Reserve Banks as a real-time electronic funds transfers.], Card [A transaction using a Plastic Card settlement service.], SVC [Stored Value Card], NSS [Net Settlement Service], IAS [FRB Integrated Account System], Other [Indicates a settlement used other than Cash, Cash/Und Check, Check, Book Entry, ACH, Wire, Card, SVC, NSS, IAS]	Identifies the mechanism by which a transaction is settled.
ReceiptMechanismCode	optional	Cash [Coin or paper currency.], Cash/Und Check [Indicates settlement that is either cash and/or checks settled by Check21 or paper method.], Book Entry [Indicates a settlement using an electronic general ledger entry.], Check [Indicates a settlement using Check21 or paper method.], ACH [A transaction that takes place across the Automated Clearing House (ACH) Network.], Wire [A transaction done through the Federal Reserve Banks as a real-time electronic funds transfers.], Card [A transaction using a Plastic Card settlement service.], SVC [Stored Value Card], NSS [Net Settlement Service], IAS [FRB Integrated Account System], Other [Indicates a settlement used other than Cash, Cash/Und Check, Check, Book Entry, ACH, Wire, Card, SVC, NSS, IAS]	The format of a financial instrument as received by a collections channel program.
ChannelType	optional	OTC [Over The Counter], Mail [Mail], Internet [Electronic], Phone [Phone], Bank [Bank]	Refers to the general channel category through which Fiscal Service receives a transaction: OTC, mail, Internet, phone, and bank.
ReasonText	optional	String [0, 100]	Description of the reason for the type of corrective or return transaction.
ReasonCode	optional	String [0, 35]	Internal code to identify the reason for the type of corrective or return transaction.
GatewayReceiptDate	optional	YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS	Indicates the date that a settlement gateway or provider receives financial data for processing.
SettlementStatusCode	optional	String [3, 3]	The settlement status code reported by the Debit Gateway that identifies how the transaction was settled.
IsNonDomestic	optional	1\|0	Indicates whether the entity or transaction is considered non domestic.
GroupIdentifier	optional	String [0, 80]	A generated identifier used to link transactions within the same lifecycle.
Amount	required	Decimal [20, 2]Min Inclusive: 0.00	The transaction amount.

Technical Information
Schema version	urn:us:gov:treasury
Cardinality	[0..unbounded]
Content Model	The <FinancialTransaction> element contains 12 children elements and has a multiple content model where there exists more than one content model (sequence, choice, all or some combination of these three content models). Please review the XML Schema document to fully understand the implications of the multiple content model.

For help, please contact the Treasury Bureau of the Fiscal Service Data Registry team.

Last Updated: 2015-01-17T06:09:53.339-05:00

This web site is informative only and may contain publishing errors/inconsistencies - please carefully review the appropriate XML Schema documents in the Download section.