Open Interface Tables

Treasury Open Interface Tables

Open interface tables are used to stage external source data such as bank balances, current market data (such as interest rates, foreign exchange rates, bond prices, and so on), deal details, and external exposure detail for uploading into Oracle Treasury using Oracle SQL*Loader. Once the data is in the interface tables, it can then be imported into Oracle Treasury tables using concurrent programs.

Understanding Open Interface Tables

The Treasury open interface tables act as a staging area between your third-party application data and your Treasury data. You can use SQL*Loader to load third-party application data into Treasury. Once the data is loaded into the open interface tables, you can use concurrent programs to import the data from the open interface tables into Treasury tables. For a complete technical definition of all Treasury tables, see the eTRM.

NOT NULL Columns

If an interface column is designated as NOT NULL, you must enter a value in the column. It cannot be blank in order to be able to successfully save the data in the table. If a NOT NULL column is left blank, you will receive an error, and will not be able to save the record in the interface table.

Required Columns

A required columns is one in which you must enter data, while an optional field is one you may leave blank. If you do not enter a valid value in the required column field, the record will be rejected during import.

NULL Columns

Columns designated as NULL are columns which are to be left unpopulated. If NULL columns are not left unpopulated, the import process will fail.

Conditionally Required Columns

Enter values in a conditionally required column only if you have entered a value in another column that the conditionally required column is dependent on.

Optional Columns

You can use some columns in the interface tables to import additional information. Treasury imports the data that you load into these columns provided that the information passes the validation checks during the import process.

Internal ID Columns

These columns contain values that Treasury uses internally and that the user never sees. You can obtain these values only by looking in the Treasury tables. These ID columns correspond to other columns in the interface table. You do not need to enter a value for any of these ID columns if you enter a value in the corresponding column. For example, if you enter a BANK_NAME, you do not need to enter a BANK_ID.

If you enter values for both columns and the values do not match, the record will be rejected during import.

Reviewing and Correcting Import Errors

If you receive any errors when you import data from the open interface tables to Treasury, those errors are listed in the Deal Interface Summary window. You can use the Deal Interface Summary window to review and correct those errors. See: Deal Interface Summary.

Table Descriptions

The following section lists the columns in the Treasury Open Interface tables and indicates which columns require values to import information into Treasury.

Although columns are validated against columns in other tables, the tables have no foreign key relationships.

XTR_MARKET_DATA_INTERFACE

The XTR_MARKET_DATE_INTERFACE table is used to stage market rates, such as interest rates, foreign exchange rates, and bond prices, from external sources into the XTR_MARKET_PRICES table. Rates are imported as current or historical rates based on the rates' time stamp. Oracle Treasury provides several sample programs that can be used as a basis for transferring data from your external sources into the XTR_MARKET_DATA_INTERFACE table, see: Data Exchange Programs.

Once market rates are imported into Treasury they can be viewed in the Current System Rates window, see: Current System Rates.

SOURCE

The source of the market data. If you have not already defined the market data source in the Current System Rates window, set it up before import.

Validation: The source must be an existing, authorized import source in the Current System Rates window.

Destination: XTR_MARKET_PRICES

EXTERNAL_REF_CODE

The code used to identify the source of the market data.

Validation: The code must be an existing, authorized code in the Current System Rates window.

Destination: XTR_MARKET_PRICES

DATETIME

The date and time that the rate was last updated.

Validation: The date and time must be in valid date and time formats.

Destination: XTR_MARKET_PRICES

BID, ASK, MID, and SPREAD

The bid, ask, mid, and spread quotes for the rate.

Validation: None.

Destination: XTR_MARKET_PRICES

RETURN_CODE

The return code for the transfer.

Validation: None.

Destination: XTR_MARKET_PRICES

REF_CODE

The reference code for the market rate.

Validation: The code must be an existing, authorized rate in the Current System Rates window.

Destination: XTR_MARKET_PRICES

CREATED_BY

The user who loaded the market rate into the interface table.

Validation: None.

Destination: XTR_MARKET_PRICES

CREATION_DATE

The date the market rate was first entered into the interface table.

Validation: None.

Destination: XTR_MARKET_PRICES

LAST_UPDATED_BY

The user who last updated the market rates.

Validation: None.

Destination: XTR_MARKET_PRICES

LAST_UPDATED_DATE

The date the market rates were last updated.

Validation: None.

Destination: XTR_MARKET_PRICES

LAST_UPDATED_LOGIN

Standard Who Column

Validation: None.

Destination: XTR_MARKET_PRICES

XTR_DEALS_INTERFACE

The XTR_DEALS_INTERFACE table is used to import various deal types from external sources into Treasury. The required data set values is determined by the deal type. Each deal type is imported into Treasury using a different deal transfer package.

The basic definition, validation, and destination for each column is documented in the following section.

For additional definition, validation, and destination information for a specific deal type, see the individual deal transfer packages:

ACCOUNT_NO_A

The first account number of the deal.

Validation: The account number must be a defined, authorized account for a company or counterparty.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ACCOUNT_NO_B

The second account number of the deal.

Validation: The account number must be a defined, authorized account for a company or counterparty.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ACTION_CODE

The action code for the deal.

Validation: The action code must be a valid action code for the deal type.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

AMOUNT_A

The first amount for the deal

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

AMOUNT_B

The second amount for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

AMOUNT_C

The second amount for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

AMOUNT_TYPE

The amount type for the deal.

Validation: The amount type must be a valid amount type for the deal type.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

AMOUNT_HCE

The deal amount in the reporting currency.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE_CATEGORY

The category for the descriptive flexfield attached to the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE1

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE2

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE3

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE4

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE5

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE6

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE7

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE8

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE9

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE10

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE11

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE12

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE13

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE14

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

ATTRIBUTE15

Flexfield attribute.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

BANK_CODE_FROM

The bank account number the deal amount is being transferred from.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information

BANK_CODE_TO

The bank account number the deal amount is being transferred to.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

BROKERAGE_CODE

The brokerage party code for the deal.

Validation: The brokerage party must be a counterparty that is authorized for the deal type and currency of the deal.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

BROKERAGE_CURRENCY

The currency code for the brokerage amount for the deal.

Validation: The brokerage currency must be an authorized currency.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

CLIENT_CODE

The client code for the deal.

Validation: The client code must be an authorized counterparty.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

COMMENTS

Any internal comments or notes for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

COMPANY_CODE

The company code for the deal.

Validation: The company code must be an authorized company.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

CPARTY_ACCOUNT_NO

The counterparty bank account number for the deal.

Validation: The counterparty bank account number must be a defined, authorized account for the counterparty.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

CPARTY_CODE

The counterparty code for the deal.

Validation: The counterparty code must be an authorized counterparty.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

CPARTY_REF

The counterparty account reference code.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

CREATED_BY

Standard column.

Validation: None.

Destination: no destination.

CREATION_DATE

Standard column.

Validation: None.

Destination: no destination.

CURRENCY_A

The first currency for the deal.

Validation: The currency must be an authorized currency.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

CURRENCY_B

The second currency for the deal.

Validation: The currency must be an authorized currency.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

DATE_A

The first date for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

DATE_B

The second date for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

DEAL_LINKING_CODE

The deal linking code for the deal.

Validation: The deal linking code must be a defined deal linking code.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

DEAL_TYPE

The Treasury deal type (for example, FXO) of the deal being imported. The values for many other columns in the XTR_DEALS_INTERFACE table are dependent on the value in this field.

Validation: The deal type must be an authorized, defined deal type in the Deal/Product Type window.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

DEAL_SUBTYPE

The deal subtype for the deal.

Validation: The deal subtype must be an authorized subtype of the deal type for the deal.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

DEALER_CODE

The dealer code for the deal.

Validation: The dealer code must be an authorized counterparty.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

DUAL_AUTHORIZATION_BY

The vasodilator who must provide dual authorization for the deal.

Validation: The vasodilator must be a valid Treasury user.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

DUAL_AUTHORIZATION_ON

The date that the deal was authorized.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

EXPOSURE_TYPE

The exposure type for the deal.

Validation: The exposure type must be a defined, authorized exposure type.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

EXTERNAL_DEAL_ID

The deal ID from the external application.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

EXTERNAL_COMMENTS

The external comments for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

EXTERNAL_CPARTY_NO

The external counterparty for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

INTERNAL_TICKET_NO

The internal reference number for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

LAST_UPDATED_BY

Standard who column.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

LAST_UPDATED_DATE

Standard who column.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

LAST_UPDATE_LOGIN

Standard who column.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

LOAD_STATUS_CODE

The status of the deal being uploaded. For more information, see: Deal Import Statuses

Note: Note that if the status column is blank, it is treated as if the status is NEW.

Validation: None.

Destination: no destination.

LIMIT_CODE

The first limit that is applied to the deal.

Validation: The limit must be a defined, authorized limit.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

LIMIT_CODE_B

The second limit that is applied to the deal.

Validation: The limit must be a defined, authorized limit.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

MARKET_DATA_SET

The market data set used to revalue the deal.

Validation: None.

Destination: XTR_INTERGROUP_TRANSFERS

MIRROR_DEAL

Flag that indicates whether the deal is the mirror side of an intercompany funding deal (Y) or not (N).

Validation: None.

Destination: XTR_INTERGROUP_TRANSFERS

MIRROR_DEAL_NUMBER

The Deal ID for one side of a company to company intercompany funding deal. Combined with the MIRROR_TRANSACTION_NUMBER, this column forms a unique ID for each side of a mirror deal.

Validation: None.

Destination: XTR_INTERGROUP_TRANSFERS

MIRROR_TRANSACTION_NUMBER

The transaction number for one side of a company to company intercompany funding deal. Combined with the MIRROR_DEAL_NUMBER, this column forms a unique ID for each side of a mirror deal.

Validation: None.

Destination: XTR_INTERGROUP_TRANSFERS

MIRROR_LIMIT_CODE_FUND

The fund type limit code for the mirror side of an intercompany funding deal.

Validation: None.

Destination: XTR_INTERGROUP_TRANSFERS

MIRROR_LIMIT_CODE_INVEST

The invest type limit code for the mirror side of an intercompany funding deal.

Validation: None.

Destination: XTR_INTERGROUP_TRANSFERS

MIRROR_PORTFOLIO_CODE

The fund type limit code for the mirror side of an intercompany funding deal.

Validation: None.

Destination: XTR_INTERGROUP_TRANSFERS

MIRROR_PRODUCT_TYPE

The product type for the mirror side of an intercompany funding deal.

Validation: None.

Destination: XTR_INTERGROUP_TRANSFERS

NO_OF_DAYS

The number of days per year used to calculate interest on the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

OVERRIDE_LIMIT

A flag indicating whether you want to override the limits that are applied to the deal (Y), or not (N).

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

PORTFOLIO_CODE

The date the market rates were last updated.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

PRICING_MODEL

The pricing model for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

PRODUCT_TYPE

The product type for the deal.

Validation: The product type must be a defined, authorized product type for the deal type.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

RATE_A

The first rate for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

RATE_B

The second rate for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

RATE_C

The third rate for the deal.

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

SETTLE_ACTION_REQD

A flag indicating whether you want to settle the transaction in Treasury (YES), or not (NO).

Validation: None.

Destination: For most deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

STATUS_CODE

The status for the deal. The default status is CURRENT.

Validation: The status must be a valid status type for the deal type.

Destination: For all deals, XTR_DEALS. See individual deal transfer package descriptions for more information.

FX Deal Transfer Package

When you import foreign exchange spot and forward deals, the FX Deal Transfer package requires certain unique values.

The destination column is listed for some of those values. If no destination column is listed, then the destination column has the same name as the column in the XTR_DEALS_INTERFACE table. The unique values required for FX deals are as follows:

IG Deal Transfer Package

When you import intercompany transfer deals, the IG Deal Transfer package requires certain unique values.

The destination column is listed for some of those values. If no destination column is listed, then the destination column has the same name as the column in the XTR_DEALS_INTERFACE table. The unique values required for IG deals are as follows:

EXP Deal Transfer Package

When you import exposure deals, the EXP Deal Transfer package requires certain unique values.

The destination column is listed for some of those values. If no destination column is listed, then the destination column has the same name as the column in the XTR_EXPOSURE_TRANSACTIONS table. The unique values required for EXP deals are as follows:

NI Deal Transfer Package

When you import exposure deals, the NI Deal Transfer package requires certain unique values.

The destination column is listed for some of those values. If no destination column is listed, then the destination column has the same name as the column in the XTR_DEALS_INTERFACE table. The unique values required for NI deals are as follows:

XTR_TRANSACTION_INTERFACE

This table is designed to hold common transaction information and is a temporary staging area for deal data awaiting transfer to the actual transaction tables.

This table is used to store NI data.

AMOUNT_A

The size of the parcel.

Validation: The value must be greater than zero.

Destination: No mapping, gives number of parcels. The number here equals the number of times the row information is duplicated in the XTR_ROLLOVER_TRANSACTIONS table.

AMOUNT_B

The face value.

Validation: See table below.

Destination: For NI deals, the BALANCE_OUT column of XTR_ROLLOVER_TRANSACTIONS.

AMOUNT_C

The consideration.

Validation: See table below.

Destination: For NI deals, the INITIAL_FAIR_VALUE column of XTR_ROLLOVER_TRANSACTIONS.

AMOUNT_D

The interest.

Validation: See table below.

Destination: For NI deals, the INTEREST column of XTR_ROLLOVER_TRANSACTIONS.

DEAL_TYPE

The deal or instrument type.

Validation: The deal type must be an authorized, defined deal type in the Deal/Product Type window.

Destination: For NI deals, XTR_ROLLOVER_TRANSACTIONS.

EXTERNAL_DEAL_ID

Stores the external unique primary identifier for each deal.

Validation: None

Destination: For NI deals, XTR_ROLLOVER_TRANSACTIONS.

OPTION_A

Used for NI to indicate if a parcel is available for resale.

Validation: None

Destination: For NI deals, XTR_PARCEL_SPLITS.AVAILABLE_FOR_RESALE column of XTR_ROLLOVER_TRANSACTIONS.

TRANSACTION_NUMBER

The transaction number.

Validation: None

Destination: For NI deals, XTR_ROLLOVER_TRANSACTIONS.

VALUE_A

The serial number for NI.

Validation: Only relevant for Issue subtypes.

Destination: For NI deals, XTR_PARCEL_SPLITS.SERIAL_NUMBER column of XTR_ROLLOVER_TRANSACTIONS.

Validation

The system performs validation on the values in the XTR_TRANSACTION_INTERFACE table. The rules to decide which values are calculated and which values are imported are explained below.

If an interest value is specified, the interest rate must fall inside established tolerances defined by the interest override feature and the interest value is imported. If the interest value is not specified, then treasury calculates it.

If the Discount/Yield basis is Discount, then you must provide a face value.

If the Discount/Yield basis is Yield, then you must provide either face value or consideration. If one of these values is specified, then the other is calculated. If both these values are specified, the system produces an XTR_INV_CONSIDERATION error message.

The table below lists the results when each of the specific values are provided.

Face Value Consideration Interest Discount (D) or Yield (Y) Result
         
X X X Y Invalid
X X N/A Y Invalid
X N/A X Y If interest falls inside tolerance, face value and interest are imported and consideration is calculated.
X N/A N/A Y Face value is imported, consideration and interest are calculated.
N/A X X Y If interest falls inside tolerance, consideration and interest are imported and face value is calculated.
N/A X N/A Y Consideration is imported, face value and interest are calculated.
N/A N/A X Y Invalid
N/A N/A N/A Y Invalid
X X X D Invalid
X X N/A D Invalid
X N/A X D If interest falls inside tolerance, face value and interest are imported and consideration is calculated.
X N/A N/A D Face value is imported, consideration and interest are calculated.
N/A X X D Invalid
N/A X N/A D Invalid
N/A N/A X D Invalid
N/A N/A N/A D Invalid