8/1/13

Document Display

R12: Master Note: APMACR - Mass Additions Create Program - Functional Overview (Doc ID 1321002.1)
Modified: May 13, 2013 Type: BULLETIN Status: PUBLISHED Priority: 3

In this Document Purpose Scope Details References

APPLIES TO:
Oracle Payables - Version 12.0.1 to 12.1.3 [Release 12.0 to 12.1] Information in this document applies to any platform. Mass Additions Create Program - APMACR

PURPOSE
This document is created to provide a functional approach to the Mass Additions Program. In this note we can find details to understand what the Mass Additions is and how it runs. Details about the information required if a SR must be logged to solve an issue with this program have been also included.

DETAILS
Definition The Mass Additions Create Program (APMACR) is submitted from an Accounts Payable (AP) responsibility. It is used to transfer the costs of purchased items, reflected in invoice line distributions, from Oracle Payables to Oracle Assets if they meet the criteria to become an asset. It also interfaces adjustments to the invoice cost and discounts taken when the invoice is paid for assets that have already been interfaced to Oracle Assets.

Pre-requisites The invoice distributions must be compliant with the following pre-requisites to be transferred to Fixed Assets (FA): 1) Invoice must be validated and approved 2) The invoice distribution line must be charged to an account created as Asset type account in case of CIP or capitalized assets. It must be charged to an Expense type account for the expensed assets. On PO matched distributions, the evaluated account to determine if the line can be transferred to FA is the PO charge account 3) The 'Track as Asset' check box must remain as selected. This checkbox is automatically checked if the distribution charge account is an Asset type account and cannot be changed. This checkbox is automatically checked if the distribution charge account is an Asset type account and cannot be changed. For Expense type accounts, this box can be manually checked or unchecked.
https://support.oracle.com/epmos/faces/ui/km/SearchDocDisplay.jspx?_adf.ctrl-state=19ury7qx5m_514 1/6

8/1/13

Document Display

For other account types this check box remains greyed out and cannot be selected. Although this flag is enabled, this line might not be transferred to FA at the end as it just flag the line as 'candidate' to be transferred. That will be enabled even before checking any kind of setup at FA Mass Additions level 4) The accounting/GL date for the invoice line distribution must be the same or before the date specified for the Mass Additions Create request 5) Payables Operating Unit must be the same in General Ledger Set of Books and in Assets corporate book. 6) The Inventory Organization setup in the AP Financial Options is a requirement to get Assets transferred to Mass Additions

Types of Assets There are three types of assets: 1) Expensed Any invoice distribution charged to an expense account is eligible to be interfaced to Fixed Assets (FA) as an expense type asset whenever the 'Track as Asset' option is selected on the distribution line. These expenses are not depreciated in FA and they are reported as an expense. 2) Capitalized The invoice distributions must be charged to an account which type is 'Asset'. In this case, the 'Track as Asset' option will be automatically selected at invoice creation time. Capitalized assets will start to depreciate based on the depreciation method rules and the date placed in service. 3) Construction-In-Process (CIP) The invoice distributions for this kind of assets must be also charged to an 'Asset' account. Again, the 'Track as Asset' option will be automatically selected at invoice creation time. CIP assets do not depreciate until the asset is capitalized and placed into service in FA after they have been transferred.

Mass Additions Reports Program: Mass Additions Create Short Name: APMACR Executable: APMACR (PL/SQL stored procedure)

Parameters 1) Asset Book Type Code In OA release 12, a new column has been added in AP_INVOICE_DISTRIBUTIONS_ALL table, called asset_book_type_code. It is populated for the invoice distributions that have changed the assets_tracking_flag from N to Y This parameter represents the Assets book and it is matched against the value for this column in the involved invoices. 2) Accounting Date This is the accounting date or GL date for the involved invoice distributions.

Involved Tables 1) AP_INVOICE_DISTRIBUTIONS_ALL

https://support.oracle.com/epmos/faces/ui/km/SearchDocDisplay.jspx?_adf.ctrl-state=19ury7qx5m_514 2/6

8/1/13

Document Display

Stores the invoice distributions for a specific invoice. It also stores the mandatory 'Track as Asset' check box and the account code combination (ccid) for every invoice distribution line. The 'Assets Addition Flag' check box, used by the Mass Additions Create process, is also stored in this table. 2) FA_MASS_ADDITIONS_GT This temporary table stores the required data for all invoice distribution lines that have been transferred from the Payables module. Data are collected from this table by the FA packages to be transferred to the FA tables, if controls are passed. Otherwise, the records are marked as Rejected.

Involved Packages Package: AP_MASS_ADDITIONS_CREATE_PKG Package files: apmassab.pls / apmassas.pls

How Mass Additions Create Process runs After submitting the Mass Additions Create program, the first task is calling the AP_MASS_ADDITIONS_CREATE_PKG package. This package selects the invoice distribution records that meet the criteria to be collected, based in the GL date and book type code parameters entered when the process is submitted. Invoice distributions must meet the following criteria: 1) assets_addition_flag set to 'U' 2) asset_tracking_flag set to 'Y' 3) Posted Flag = Y (in OA release 11i distribution must have been posted to GL. In OA release 12 is not a requirement) The Mass Additions Create process determines which transactions are sent to FA based on the Accounting Class Assignments setup. By default, the following accounting classes will be evaluated to send to FA. Accrual Cost Discount Exchange Rate Variance (ERV) Expense Freight Interest Expense Invoice Price Variance (IPV) Item Expense Miscellaneous Expense Tax Exchange Rate Variance (TERV) Tax Invoice Price Variance (TIPV) Tax Rate Variance (TRV) The Charge distributions (i.e. freight, tax) will be transferred along with their master distribution (either item or acrual) if applicable per Accounting Class Assignments setup. These all distributions are inserted into a temporary table: FA_MASS_ADDITIONS_GT The next step is calling the FA_MASSADD_CREATE_PKG to create lines using the Create_Lines procedure. These lines can be either inserted in FA_MASS_ADDITIONS table (if they meet all requirements) or rejected (if they do not meet any of the requirements). If lines are inserted into FA_MASS_ADDITIONS table, they are marked as 'Processed' in FA_MASS_ADDITIONS_GT
https://support.oracle.com/epmos/faces/ui/km/SearchDocDisplay.jspx?_adf.ctrl-state=19ury7qx5m_514 3/6

8/1/13

Document Display

table. Otherwise they are marked as 'Rejected'. At this point, the control goes back to the AP Package (AP_MASS_ADDITIONS_CREATE_PKG) to do the following: a) if the status in FA_MASS_ADDITIONS_GT table is 'Processed', then the assets_addition_flag is set to 'Y' in AP_INVOICE_DISTRIBUTIONS_ALL table. b) if the status in FA_MASS_ADDITIONS_GT table is 'Rejected', then the assets_addition_flag is set to 'N' in AP_INVOICE_DISTRIBUTIONS_ALL table.

Troubleshooting Three main issues can arise in this process: 1) Issue: Mass Additions process is not picking invoice or some invoice distributions and it should Cause: most of the times issue is caused by a missing or wrong code Fix: apply latest available versions for the AP_MASS_ADDITIONS_CREATE_PKG (package file: apmassab.pls) 2) Issue: Poor performance in Mass Additions process Cause: Tuning of Select/Update statements and/or expensive queries performing full scans in tables. Fix: apply latest available versions for the AP_MASS_ADDITIONS_CREATE_PKG (package file: apmassab.pls) 3) Issue: Unrecoverable Tax Lines are not merged to the Item line when transferred to Fixed Assets through Mass Additions process Cause: obsolete code in Mass Additions Create package (AP_MASS_ADDITIONS_CREATE_PKG) Fix: apply latest available versions for the AP_MASS_ADDITIONS_CREATE_PKG (package file: apmassab.pls) 4) Issue: Why Invoice Price Variance (IPV) and Exchange Rate Variance (ERV) invoice lines are transferred to Fixed Assets by the Mass Additions Program (APMACR) ? Cause: Expected and designed behavior Fix: IPV and ERV invoice lines are defaulted as 'Track as Assets'. So that they will be picked by the Mass Additions Create Program to be transferred to Fixed Assets. In this way, Fixed Assets module will take the correct cost for assets purchases and they will be depreciated accordingly, using always the real cost.

Latest available versions for the main involved packages Latest available versions AP_MASS_ADDITIONS_CREATE_PKG, at the moment of delivering this note: *For OA release 12.0 -> apmassab.pls 120.19.12000000.52 / apmassas.pls 120.3.12000000.3 -> Patch:14314657:R12.AP.A *For OA release 12.1 -> apmassab.pls 120.22.12010000.41 / apmassas.pls 120.3.12010000.3 -> Patch:14314657:R12.AP.B

How the Unrecoverable Tax Invoice Lines are managed by Mass Additions process For OA release 12.0, the non-recoverable tax lines are included in the Mass Additions code from apmassab.pls 120.19.12000000.25 onwards. For OA release 12.1, this feature has been included since starting. However, after installing these package versions, the NONREC_TAX could not get transferred because this accounting class code has not been added to Mass Additions program for transfer (Bug:9675846). In this specific case, setup must be updated as follows: Responsibility: Payables Manager Navigation:
https://support.oracle.com/epmos/faces/ui/km/SearchDocDisplay.jspx?_adf.ctrl-state=19ury7qx5m_514 4/6

8/1/13

Document Display

Setup / Accounting Setups / Sub ledger Accounting Setup --> Post-Accounting Programs 1. Query for Program Name 'Mass Additions Create' 2. Select the Assignment Definition 'Oracle Standard Assignment Code' 3. Select the 'Copy Assignment' to create a new assignment 4. Enter a new assignment code and assignment name. Enter a journal if you only want to modify the assignment for one ledger. 5. For the new assignment code, select the 'Accounting Class Assignments' button 6. Insert a row, selecting Non-Recoverable Tax from the LOV. 7. Commit your work. More information on this feature can be found in the following My Oracle Support notes: 1) Note:559980.1 - How To Include Nonrecoverable Tax In Mass Addition In R12 2) Note:1108322.1 - Payables Mass Additions Create Program (APMACR) is excluding Tax Lines

Item Lines and Tax, Misc, Freight Lines Normally, child lines (e.g. Tax, Misc, Freight) are interfaced to FA along with the Item line to which the child lines are allocated. However, there were several ER's created to allow customers more control over how their data was sent over to Fixed Assets. 1) Patch 14466506 for R12.1 customers introduces the flag Allow Unallocated Line Types on the FA Book Controls form which will allow tax only, freight only, or Misc only invoice lines to be interfaced to FA. Prior to this patch, all tax, misc, freight lines had to be allocated to a parent/item line which was interfaced, in order for the child/tax,misc,freight lines to also be interfaced. For more information please review Mass Addition Program is NOT Importing TAX , FREIGHT AND MISC Unallocated Invoices Lines into FA (Doc ID 1476773.1) 2) ER was created to add a new flag to the FA Book Controls form, Disable AutoMerge, which if checked will cause all invoice lines both parent and child, adjustments etc to interface to Fixed Assets on the NEW queue. It's the users choice on how they prepare these mass additions, they could choose to merge some with the parent or none and create assets from each invoice distribution that was interfaced. In order to disable the Auto-Merge functionality please review How to Disable the 'Auto-Merge' feature for Create Mass Additions in R12.1 ? (Doc ID 1540186.1)

Available Diagnostics Invoice Mass Additions Activity Diagnostics Test This diag test must be manually run after apply the following patch: *For OA release 12.0 -> apply Patch:9751975:R12.AP.A *For OA release 12.1 -> apply Patch:9751975:R12.AP.B More information on this diag script can be found in Note:1162886.1 and Note:1162973.1

https://support.oracle.com/epmos/faces/ui/km/SearchDocDisplay.jspx?_adf.ctrl-state=19ury7qx5m_514

5/6

8/1/13

Document Display

Mandatory information required at SR login time If a SR must finally be logged with Support Services, the below detailed information must be uploaded to get a faster answer/solution: 1) Log and Output files for the Mass Additions Create program (APMACR) 2) Debug Log file for the Mass Additions Create program (APMACR) -> see Note:1320716.1 for instructions 3) FND Debug Log for the Mass Additions Create program (APMACR) -> see Note:1320736.1 for instructions 4) Versions for the involved package AP_MASS_ADDITIONS_CREATE_PKG -> see Note:1320692.1 for instructions

Join our growing Oracle Payables Community and learn from your peers and Oracle on how to address your unique issues in AP.

REFERENCES
NOTE:1108322.1 - Payables Mass Additions Create Program (APMACR) is excluding Tax Lines NOTE:1162886.1 - R12 Mass Additions Diagnostics NOTE:1162973.1 - R12.1 Mass Additions Diagnostics NOTE:1320692.1 - R12: Main AP Packages Involved in Invoices Workbench (APXINWKB). How To Know Versions For These Packages? NOTE:1320716.1 - R12: How To Get a Debug Log File For a Concurrent Request NOTE:1320736.1 - R12: How To Get The FND Debug Log For On-Line Processes And For Concurrent Requests NOTE:1331545.1 - R12: Why IPV And ERV Invoice Lines Are Transferred To Fixed Assets ? NOTE:559980.1 - How To Include Nonrecoverable Tax In Mass Additions In R12? NOTE:1540186.1 - How to Disable the 'Auto-Merge' feature for Create Mass Additions in R12.1 ? NOTE:1473806.1 - FAXSUBCT New Feature "Allow Unallocated Line Types" Flag Missing NOTE:1450194.1 - R12 : Mandatory Datafix Before Running Mass Additions Create Program After Patch 14466506 is Applied NOTE:1476773.1 - Mass Addition Program is NOT Importing TAX , FREIGHT AND MISC Unallocated Invoices Lines into FA

https://support.oracle.com/epmos/faces/ui/km/SearchDocDisplay.jspx?_adf.ctrl-state=19ury7qx5m_514

6/6