Difference between revisions of "AP Custom Priorities - APPP Rule"

From Adjutant Wiki

(Created page with "__NOTOC__ ===General Information=== '''Default Menu Location''' Maintain >> System >> Rule Maintenance '''Function''' This rule allows users to define profile colors used i...")
 
Line 4: Line 4:
 
'''Default Menu Location''' Maintain >> System >> Rule Maintenance
 
'''Default Menu Location''' Maintain >> System >> Rule Maintenance
  
'''Function'''  This rule allows users to define profile colors used in production labeling, reporting, and machine interfaces.
+
'''Function'''  This rule allows users to define custom AP Payment Priorities for Check and Non-Check Payments that override the system default payment priorities of 1 through 8 that only apply to check payment types.  
  
'''Special'''  Refer to the Special Reflexes section below for additional information on how the numbered profile rules work.
+
'''WARNING'''  Setting up this rule will disable the use of the legacy payment priority code of 'N' for Non-Check Payments. Implementing this new feature will require assistance from ABIS personnel to replace any existing uses of the 'N' payment priority code throughout Adjutant with a valid non-check payment code defined in the new APPP rule. This may include updates to any Vendor Remit To records with a code of 'N' as well as any open AP Invoices tied to a payment priority code of 'N'.  
  
[[File:Rule-PCOLORONE.png]]
+
'''Do not add this rule unless you are actively coordinating with ABIS personnel to adjust existing Vendor and AP Invoice data to work with the new rule settings.'''
 +
 
 +
[[File:Rule_Maintenance_APPP.png]]
  
  
 
===Rule Setup – Text Fields===
 
===Rule Setup – Text Fields===
  
'''Color:'''  Enter the profile color name (use ALL CAPS)
+
'''Priority Name: (max 20 characters) '''  Enter the name to show in the payment priority drop-down list
  
'''Description:'''  Enter an alternate description for the color
+
'''Priority Code: (max 1 character)'''  Enter a numeric or alpha code for the payment priority.
  
'''Color Code:''' Not in use.
+
'''Special notes regarding the Priority Code values'''
  
 
+
* The priority codes of 'C' (Credit Card), 'E' (EFT), 'M' (Manual Check), and the legacy code of 'N' (Non-Check) are reserved by the system and should not be used.
===Rule Setup – Number Fields===
+
* When defining custom codes, the codes MUST be sequential according to the check or non-check priority ranges. This is to allow ranges to work in the corresponding AP screens.
 
+
** For example, in the example above, codes 1 through 4 are used for check type priorities and codes 5-8 are used for non-check priorities. This will allow screens like Approve AP Invoices to recognize the range of priorities.
'''Color ID:'''   Assign a numerical ID for the profile color. This is used in several places in the database, make sure that the Color ID is unique per each record.  
+
** Letters can be used in the priority code field, but the reserved codes of C, E, M, and N cannot be used.
 +
** The alpha ranges of F through L may be used, or the ranges of O through Z can be also be used.
  
  
 
===Rule Setup – Logic Fields===
 
===Rule Setup – Logic Fields===
  
'''There are no Logic fields in use.'''  
+
'''Check Type:''' Select this box to define the custom payment priority as a check type payment
 
 
 
 
===Profile Rules Special Reflexes===
 
 
 
Profile Rule Maintenance records with number designations in the rule name have special reflexes designed to handle custom lists per item type. The reflexes use specific keywords in the associated item description to match item types to certain rule numbers. The item description names and their associated rule numbers are listed below.
 
 
 
*ONE: All profile rules with ONE in the rule name are coded to match against the following keywords in the item description
 
**PANEL
 
**TRIM
 
**SSR (SSR uses the PWIDTHTHREE rule for width, but uses ONE for all others)
 
 
 
 
 
*TWO: All profile rules with TWO in the rule name are coded to match against the following keywords in the item description
 
**CEE
 
**ZEE
 
**EAVE STRUT
 
**PRESS BRAKE
 
**CHANNEL
 
 
 
 
 
*THREE: The only profile rule with THREE in the rule name is Profile Width Three (PWIDTHTHREE) and is matched against SSR in the item description.
 
 
 
 
 
If the associated item description has text that exactly matches any of the bulleted items above, the profile drop-down list will be limited to only rule entries from the corresponding numbered rule. For example, if editing the profile color details for an item with 'PRESS BRAKE' in the item description, only items from PCOLORTWO will show up in the drop-down as valid for 'PRESS BRAKE' items.
 
 
 
If the associated item description does not have any text that matches any of the bulleted items above, the drop-down list will include ALL of the entries from ONE and TWO (and THREE for the Width drop-down). For example, if editing the profile color details for an item with the description 'Generic Item', the drop-down for profile color will include ALL of the entries from PCOLORONE and PCOLORTWO.
 
 
 
This can mean that items with descriptions that do not fall exclusively into the keywords above can end up displaying duplicate values in the drop-downs if the same profile names appear in both the ONE and TWO versions of the rule. Selecting either of the duplicated displayed profile detail options is generally fine, since they are both valid options. It will not matter if the option is selected from the ONE or TWO rule record.
 
 
 
 
 
  
===Profile Naming Best Practices===
+
'''Non-Check Type''' Select this box to define the custom payment priority as a non-check type payment
  
For consistency, and to avoid issues with conflicting details, you should always use ALL CAPS for the profile text1 values. There are several layers of coding to match the profile details and profile keys to various machine interfaces. Many of the third-party interfaces will generate errors or fail to validate details if they are not passed in ALL CAPS.
 
  
To avoid errors and possible data mismatch issues, we recommend using ALL CAPS for the profile rule details.
 
  
 
[[Category:Rule Maintenance]]
 
[[Category:Rule Maintenance]]
 
[[Category:Accounts Payable]]
 
[[Category:Accounts Payable]]

Revision as of 14:58, 9 January 2023

General Information

Default Menu Location Maintain >> System >> Rule Maintenance

Function This rule allows users to define custom AP Payment Priorities for Check and Non-Check Payments that override the system default payment priorities of 1 through 8 that only apply to check payment types.

WARNING Setting up this rule will disable the use of the legacy payment priority code of 'N' for Non-Check Payments. Implementing this new feature will require assistance from ABIS personnel to replace any existing uses of the 'N' payment priority code throughout Adjutant with a valid non-check payment code defined in the new APPP rule. This may include updates to any Vendor Remit To records with a code of 'N' as well as any open AP Invoices tied to a payment priority code of 'N'.

Do not add this rule unless you are actively coordinating with ABIS personnel to adjust existing Vendor and AP Invoice data to work with the new rule settings.

Rule Maintenance APPP.png


Rule Setup – Text Fields

Priority Name: (max 20 characters) Enter the name to show in the payment priority drop-down list

Priority Code: (max 1 character) Enter a numeric or alpha code for the payment priority.

Special notes regarding the Priority Code values

  • The priority codes of 'C' (Credit Card), 'E' (EFT), 'M' (Manual Check), and the legacy code of 'N' (Non-Check) are reserved by the system and should not be used.
  • When defining custom codes, the codes MUST be sequential according to the check or non-check priority ranges. This is to allow ranges to work in the corresponding AP screens.
    • For example, in the example above, codes 1 through 4 are used for check type priorities and codes 5-8 are used for non-check priorities. This will allow screens like Approve AP Invoices to recognize the range of priorities.
    • Letters can be used in the priority code field, but the reserved codes of C, E, M, and N cannot be used.
    • The alpha ranges of F through L may be used, or the ranges of O through Z can be also be used.


Rule Setup – Logic Fields

Check Type: Select this box to define the custom payment priority as a check type payment

Non-Check Type Select this box to define the custom payment priority as a non-check type payment