Version: eXtendRoyalties all versions
Audience: All

Overview

eXtendRoyalties uses a fallback pattern to determine royalty data. The system checks invoice line column fields first, then falls back to item record fields if the column values are empty or missing.

Priority Order

1. Invoice column fields (Primary)

  • custcol_extend_royalties_rate
  • custcol_extend_royalties_rate_type
  • custcol_extend_royalty_recipient

2. Item fields (Fallback)

  • custitem_extend_royalties_rate
  • custitem_extend_royalties_rate_type
  • custitem_extend_royalties_recipient

Use Cases

Invoice column fields are used when:

  • Invoice line has transaction-specific royalty data
  • Rate or recipient differs from the item's default

Item fields are used when:

  • Invoice column fields are not populated
  • Item has default royalty configuration
  • Transaction uses item-level royalty settings

This pattern allows line-level overrides while maintaining item-level defaults.