Results for “zx_validation_errors_gt”

AI-generated from documented ETRM metadata — verify critical details on the linked pages.

Overview

ZX_VALIDATION_ERRORS_GT is a global temporary table owned by the ZX schema, the database account that supports the E-Business Tax (EBTax) module in Oracle E-Business Suite 12.1.1 and 12.2.2. The table serves a narrowly scoped but operationally important purpose: it returns validation errors raised when imported transactions are evaluated from a tax perspective. Rather than persisting diagnostic output permanently, the table acts as a transient staging area where tax validation routines publish error rows for a given session, allowing upstream or calling processes to retrieve and present those errors to the user.

Because the object is a global temporary table, its contents are session- or transaction-scoped depending on how the temporary table was defined. Rows are visible only to the session that inserted them and are purged on commit or session termination. This makes the table unsuitable as a system of record and appropriate only as a communication buffer between the tax engine and the calling interface. In the ETRM metadata the object is classified as standalone under the heuristic Data Vault classification, meaning it has no downstream dependencies in the mined foreign-key structure. As a modeling suggestion, this suggests the table behaves less like a conventional hub or link and more like a transient satellite of validation events keyed to an interface or transaction line, with no independent business identity of its own.

Key Information Stored

The table exposes 17 documented columns. The most significant include:

• APPLICATION_ID, ENTITY_CODE, EVENT_CLASS_CODE — identify the application, entity, and event class that contextualize the transaction being validated.
• TRX_ID, TRX_LEVEL_TYPE, TRX_LINE_ID — identify the transaction, its level (header or line), and the specific transaction line. TRX_LINE_ID is the documented foreign key referencing CN_TRX_LINES_ALL.
• INTERFACE_LINE_ID, INTERFACE_LINE_ENTITY_CODE, INTERFACE_TAX_LINE_ID, INTERFACE_TAX_ENTITY_CODE — identify the interface (staging) line and tax line that produced the error, linking the diagnostic back to the inbound interface payload.
• MESSAGE_NAME, MESSAGE_TEXT — the error identifier and human-readable description returned by the tax validation routine.
• SUMMARY_TAX_LINE_NUMBER — the tax line number used for summarization and reporting.
• OTHER_DOC_APPLICATION_ID, OTHER_DOC_ENTITY_CODE, OTHER_DOC_EVENT_CLASS_CODE, OTHER_DOC_TRX_ID — identify an associated source document when the error involves cross-document validation.

No surrogate primary key or unique index is documented in the ETRM metadata; the table is populated by a validation routine and read back by the same session, so uniqueness is not enforced at the schema level.

Common Use Cases and Queries

The primary use case is error retrieval following tax validation of imported transactions. A typical pattern is:

• Interface error reporting — after running a tax validation program, the calling concurrent program or form queries ZX_VALIDATION_ERRORS_GT filtered by TRX_ID or INTERFACE_LINE_ID to display messages.
• Line-level diagnostics — joining TRX_LINE_ID to CN_TRX_LINES_ALL to correlate errors with transaction line attributes.
• Message aggregation — grouping by MESSAGE_NAME to identify the most frequent validation failures during an interface run.

Sample query:

SELECT TRX_ID, TRX_LINE_ID, MESSAGE_NAME, MESSAGE_TEXT FROM ZX_VALIDATION_ERRORS_GT WHERE INTERFACE_LINE_ID = :p_interface_line_id;

Reports should filter explicitly by session-critical identifiers because the table may hold rows from multiple validation passes within a single session.

Related Objects

• CN_TRX_LINES_ALL — referenced via TRX_LINE_ID; the primary FK relationship documented.
• ZX_LINES — E-Business Tax transaction tax lines that the validation compares against.
• ZX_INTERFACE_LINES — inbound interface staging tables whose lines are validated.
• ZX_API_PUB — public API package that invokes tax validation and populates error output.
• ZX_TRX_LINES — tax transaction line detail used in validation logic.
• ZX_ERRORS_GT — companion temporary table for non-validation tax errors.
• RA_CUSTOMER_TRX_ALL / RA_CUSTOMER_TRX_LINES_ALL — source transaction tables validated during import.