Search Results range_of_days_from




Overview

The AR_DUNNING_LETTER_SET_LINES table is a core transactional entity within Oracle E-Business Suite Receivables (AR) that defines the specific rules and sequence for generating dunning correspondence. It functions as the detailed configuration table for a dunning letter set, which is a tiered collection of dunning letters sent to customers based on the aging of their overdue invoices. Each row in this table represents a distinct step or level within the dunning process, linking a specific aging period (a range of overdue days) to a specific dunning letter template. This table is essential for automating and managing the collections communication workflow, ensuring the appropriate letter is triggered at the correct time.

Key Information Stored

The table stores the configuration that maps aging periods to dunning letter templates. Its structure is defined by a composite primary key and critical foreign keys. The primary columns include DUNNING_LETTER_SET_ID, which links the line to its parent set defined in AR_DUNNING_LETTER_SETS, and DUNNING_LINE_NUM, which dictates the processing order of lines within the set. The RANGE_OF_DAYS_FROM column specifies the starting point of the overdue days range for which this line is applicable, establishing the aging tier. The DUNNING_LETTER_ID is a foreign key to AR_DUNNING_LETTERS_B, identifying the exact letter template (content, format) to be used for this tier. Other supporting columns typically include creation and last update dates, and the line's enabled status.

Common Use Cases and Queries

This table is central to configuring and auditing the dunning process. A primary use case is the setup and maintenance of dunning strategies via the Receivables "Dunning Letters" form, where users define the sequence of letters. For reporting and analysis, common queries involve joining to related tables to list the complete aging schedule for a dunning set or to identify which letter template is used for a specific overdue period. For example, to audit the configuration of a specific dunning letter set, a technical consultant might use a query such as:

  • SELECT dll.dunning_line_num, dll.range_of_days_from, dlb.name AS letter_name FROM ar_dunning_letter_set_lines dll, ar_dunning_letters_b dlb WHERE dll.dunning_letter_id = dlb.dunning_letter_id AND dll.dunning_letter_set_id = :set_id ORDER BY dll.dunning_line_num;

This table is also frequently referenced in custom reports that analyze the effectiveness of different dunning tiers or in data fixes to correct misconfigured aging ranges.

Related Objects

The AR_DUNNING_LETTER_SET_LINES table has defined relationships with two key parent tables, as documented in the provided ETRM metadata.

  • AR_DUNNING_LETTER_SETS: This is the parent table for the set definition. The foreign key from DUNNING_LETTER_SET_ID in AR_DUNNING_LETTER_SET_LINES to AR_DUNNING_LETTER_SETS enforces that every line must belong to a valid dunning letter set.
  • AR_DUNNING_LETTERS_B: This table stores the master definitions of dunning letter templates. The foreign key from DUNNING_LETTER_ID in AR_DUNNING_LETTER_SET_LINES to AR_DUNNING_LETTERS_B ensures each line points to a valid, existing letter template that will be used for document generation.

These relationships are critical for maintaining referential integrity and are fundamental to any data model or join condition involving dunning configuration.