Difference between revisions of "AP Check Import Guide"

Latest revision as of 09:01, 22 December 2022

General Data Import Notes

Refer to the Data Import General Information page for information and guidance on general import timeline, formatting import templates, as well as how to ensure you are using the most current template information for data imports.

AP Check Import Notes

Timing and Preparation

The AP Check Import should occur after the AP Invoice Import. This should ensure that all vendors have been imported, which should mean that all Address Book setup items have been completed, and all the General Ledger Chart of Accounts has been imported. The Address Book Setup Guide covers all the Rule Maintenance records that should be completed prior to importing vendor records.

General Notes

1099 Details - Do not use the AP Check Import to import historical 1099 details. Use the Vendor Import to convert historical 1099 amounts for year-to-date or for the previous year. The AP Check Import will not create the entries needed to accurately report 1099 details.

Invoice Balances - The AP Check Import does not update or affect the AP Invoice balance. AP Checks are imported as historical records, and it is possible to import check records that exceed the balance of the associated AP Invoice. Confirm that the AP Check totals align with the Ap Invoice balances prior to import.

The AP Check Import is designed to work with the AP Invoice Import to import historical AP invoices and mark them as paid. If the AP Check Import finds a matching AP invoice,it will record the payment against the indicated invoice and mark it as paid. However, the AP Check Import will also allow you to enter invalid invoices numbers, and the import will only create check log records, with invalid links to the AP invoice. The imported check log records are visible in the Check Info screen, and they will show up in the Bank Reconciliation application, but certain required details from the AP Invoice will not be available, and you may see issues when working with these records. AP checks imported without the associated AP invoice records will not be reportable on the AP Check Register. Best practices are to always import the associated AP invoice records using the AP Invoice Import along with the AP checks.

AP Checks that were processed on the legacy system but have not cleared the bank as of the most current bank statement used for the beginning bank balance in Bank Reconciliation should be imported so they can be cleared separately in Bank Reconciliation. When the AP Check Import is used to reconcile the initial balances in Bank Reconciliation, without importing the corresponding AP invoice records, be aware that certain AP invoice details will not be available and may prompt errors about missing information.

AP Check Import File Data Scrubbing

Every customer's data will have different issues that need addressing. Some of the issues will not make themselves visible until after the data has been imported and is in use during parallel testing. This is why it is critically important to perform an early import and keep accurate notes on issues that need to be addressed on a supplemental import, or for a complete re-import. Some common things that need attention during AP invoice data scrubbing include:

Payment Priority - This field may not have a counterpart in the customer's legacy data. Look for any similar field such as payment type or check type that can be converted to a payment priority equivalent value. Filter the source data to look for all variations on a corresponding field and make sure each variation is mapped to a hard-code payment priority value.

AP Check Import

Menu Location Transaction>>Import/Export>>Import Master

URL ImportMaster_S.htm?&mode=APCHK

File Name(Header)/Browse: Use the Browse button to locate and select the completed AP Check Header import template file (in XLS format). Note - both the Header and Distributions files are required and must be imported at the same time.

File Name(Dists)/Browse: Use the Browse button to locate and select the completed AP Check Distributions import template file (in XLS format). Note - both the Header and Distributions files are required and must be imported at the same time.

Export Template: Generates a blank AP Check Header or Distributions template file

Map Fields: Fields must be mapped prior to importing. If no changes have been made to the column headings, the mapping screen should show all green, and you can click OK to continue. If any of the Input Field Name columns on the left are red, single-click on the line on the left column, and then double-click the desired mapped field in the right column to complete the mapping. Repeat for any red lines on the left that should be mapped. If there are additional columns in the source file that should NOT be mapped, they can be left unmapped (displayed in red). Mandatory fields will require that they be mapped before clicking OK.

AccPac Data: This checkbox is no longer used

Validate to TXT file: Selecting this box will create a .TXT errors file listing any rows that would create errors such as invalid data, or duplicate records. If no errors are found in the file, the import will still process and no error file will be generated. Checking the validate box only prevents the import process if errors are encountered.

AP Check Import Header File Definitions

Required fields are indicated with an *

*f1 - Invno - AP invoice number

*f2 - Vendno - Vendor number in Adjutant

f3 - PPriority - Payment priority value. '2' is the most common entry.

*f4 - AprPay - Payment/Check amount

f5 - DisAmt - Discount amount

f6 - Amt1099 - This field is not in use

f7 - UDRef - Check reference number

*f8 - Checkno - AP Check number

*f9 - CheckDate - AP Check date (MM/DD/YYYY)

f10 - VoidDate - AP Check voided date, also marks the check as a void (MM/DD/YYYY)

*f11 - ChkAcc - AP checking account associated with transaction

f12 - u1099 - This field is not in use

f13 - Typ1099 - This field is not in use

*f14 - CkType - Check type. Common entry is C for check, or M for manual

f15 - ClearDate - Sets the Bank Reconciliation clear date, and marks the check as cleared (MM/DD/YYYY)

AP Check Import Distribution File Definitions

Each AP Check should have at least two lines per invoice in this file - one line for the control account total amount, and additional distribution lines that total up to the original check amount.

Required fields are indicated with an *

*f1 - Invno - AP invoice number that links to the invoice number in the header file

*f2 - Vendno - Vendor number in Adjutant

f3 - UDRef - Detail reference number

*f4 - GLAcnt - GL Account associated with each line of distribution detail

*f5 - Amount - Distribution amount for the associated detail

*f6 - CtrlAcct - Enter 'Y' to code the line as the payable control account distribution entry. Leaving the CtrlAcct field empty sets the associated line as a balancing distribution entry. Each imported invoice should have a Ctrl Acct amount that matches the total of all distribution lines linked to the same check.

AP Check Import Reconciliation

Reconciling imported data should begin with spot-checking several records field-by-field for complete data import. Pick records withthe most data columns filled in. Verify that all source file data fields imported correctly and display as expected.

Review the AP Invoice Payments tab and spot-check several records.

Run the AP Check Register and verify that the imported checks show up with the correct dates and amounts.

Review the imported checks in the Payments tab of the Organization Air Hammer and confirm that data displays as expected.

Review Bank Reconciliation and verify that cleared checks are reported correctly.

AP Check Import Additional Steps

There are no additional steps required to complete the AP Check import.

AP Check Import Database Tables

CHECKLOG - Each imported check will create a unique KEYNO record in CHECKLOG. The KEYNO links to the DOCKEYNO value in the APDIST table. The CHECKNO field displays the imported check number.

APDIST - Each imported check distribution detail line will create an entry in the APDIST table. The DOCTYPE value will be 'APCHK' and the the DOCKEYNO value will link to the imported check KEYNO in the CHECKLOG table. There should be at least two APDIST records for each imported check.

@@ Line 1: / Line 1: @@
+__NOTOC__
+==General Data Import Notes==
-==General Import Template File Notes==
+Refer to the [[Data Import General Information]] page for information and guidance on general import timeline, formatting import templates, as well as how to ensure you are using the most current template information for data imports.
-*Template files are typically generated from their respective Import screen using an 'Export Template' button.
-*Using the 'Export Template' button from an updated system will help ensure that you provide the customer with the most up-to-date import file, and will help avoid errors.
-*Templates generally (but not in all cases) contain 3 rows of header information.
-**The first row is generally labelled with f1 through f## and is used to give a consistent column id to each data column. Do not remove this row unless instructed.
-**The second row is labelled with the column data/field name. The values in this row are used for the file mapping screen. Editing these values is generally not needed and may make the mapping process difficult.
-**The third row is labelled with the same values from row 2, an is available to create a customer-friendly name for the associated data column.
-***The third row should be removed from the source file prior to importing.  It will cause errors since it will be treated as the first import record on the file.
-*Import files MUST always be saved as 'Microsoft Excel 5.0/95 Workbook (*.xls)' format until further notice. The import screens will generate errors if the file type is not correct.
-*It is a good idea to perform a Mapping Table Import using a current source list before beginning on any imports.  Without a current mapping table, the quality of imports can be compromised.
-**Export a current list from a good source (such as ABIS)
-**Perform a Mapping Table Import on the target system with the XLS file from the step above
 ==AP Check Import Notes==
@@ Line 20: / Line 8: @@
 ===Timing and Preparation===
-The AP Check Import should occur after the AP Invoice Import.  This should ensure that all vendors have been imported, which should mean that all Address Book setup items have been completed, and all the General Ledger Chart of Accounts has been imported.  The [[Address Book Setup Guide]] covers all of the Rule Maintenance records that should be completed prior to importing vendor records.
+The AP Check Import should occur after the AP Invoice Import.  This should ensure that all vendors have been imported, which should mean that all Address Book setup items have been completed, and all the General Ledger Chart of Accounts has been imported.  The [[Address Book Setup Guide]] covers all the Rule Maintenance records that should be completed prior to importing vendor records.
 ===General Notes===
-'''1099 Details''' - Do not use the AP CHeck Import to import historical 1099 details.  Use the Vendor Import to convert historical 1099 amounts for year-to-date or for the previous year.
+'''1099 Details''' - Do not use the AP Check Import to import historical 1099 details.  Use the Vendor Import to convert historical 1099 amounts for year-to-date or for the previous year.
 The AP Check Import will not create the entries needed to accurately report 1099 details.
 '''Invoice Balances''' - The AP Check Import does not update or affect the AP Invoice balance. AP Checks are imported as historical records, and it is possible to import check records that exceed the balance of the associated AP Invoice. Confirm that the AP Check totals align with the Ap Invoice balances prior to import.
+The AP Check Import is designed to work with the AP Invoice Import to import historical AP invoices and mark them as paid. If the AP Check Import finds a matching AP invoice,it will record the payment against the indicated invoice and mark it as paid. However, the AP Check Import will also allow you to enter invalid invoices numbers, and the import will only create check log records, with invalid links to the AP invoice. The imported check log records are visible in the Check Info screen, and they will show up in the Bank Reconciliation application, but certain required details from the AP Invoice will not be available, and you may see issues when working with these records. AP checks imported without the associated AP invoice records will not be reportable on the AP Check Register. Best practices are to always import the associated AP invoice records using the AP Invoice Import along with the AP checks.
+AP Checks that were processed on the legacy system but have not cleared the bank as of the most current bank statement used for the beginning bank balance in Bank Reconciliation should be imported so they can be cleared separately in Bank Reconciliation. When the AP Check Import is used to reconcile the initial balances in Bank Reconciliation, without importing the corresponding AP invoice records, be aware that certain AP invoice details will not be available and may prompt errors about missing information.
@@ Line 35: / Line 25: @@
 ==AP Check Import File Data Scrubbing==
-Every customer's data will have different issues that need addressing.  Some of the issues will not make themselves visible until after the data has been imported and is in use during parallel testing.  This is why it is critically important to perform an early import, and keep accurate notes on issues that need to be addressed on a supplemental import, or for a complete re-import. Some common things that need attention during AP invoice data scrubbing include:
+Every customer's data will have different issues that need addressing.  Some of the issues will not make themselves visible until after the data has been imported and is in use during parallel testing.  This is why it is critically important to perform an early import and keep accurate notes on issues that need to be addressed on a supplemental import, or for a complete re-import. Some common things that need attention during AP invoice data scrubbing include:
 * '''Payment Priority''' - This field may not have a counterpart in the customer's legacy data.  Look for any similar field such as payment type or check type that can be converted to a payment priority equivalent value.  Filter the source data to look for all variations on a corresponding field and make sure each variation is mapped to a hard-code payment priority value.
-* '''Terms''' - Make sure terms data is accurate and matches an entry in the TERMS rule. Any imported PTERMS value that does not exist in the TERMS rule will create a blank entry in the rule. Best practice is to match each invoice terms to a valid TERMS entry. In some systems, invoice terms are a text field and there is no standardization on the legacy system.  For these instances, it is best to scrub each term rule until it matches an existing TERM. Alternatively, you can create a catch-all TERM rule for unknown, incomplete, or undefined term details in the source data.
+==AP Check Import==
-==AP Check Import Screen (IMPORTAPCHK)==
+'''Menu Location''' Transaction>>Import/Export>>Import Master
-Menu Location: Transaction>>Importers/Exporters>>Accounting>>AP Check Import
+'''URL''' ImportMaster_S.htm?&mode=APCHK
 [[File:IMPORTAPCHK.png]]
@@ Line 60: / Line 50: @@
 '''AccPac Data:''' This checkbox is no longer used
-'''Validate to TXT file:''' Selecting this box will create an TXT errors file listing any rows that would create errors such as invalid data, or duplicate records. If no errors are found in the file, the import will still process and no error file will be generated. Checking the validate box only prevents the import process if errors are encountered.
+'''Validate to TXT file:''' Selecting this box will create a .TXT errors file listing any rows that would create errors such as invalid data, or duplicate records. If no errors are found in the file, the import will still process and no error file will be generated. Checking the validate box only prevents the import process if errors are encountered.
@@ Line 66: / Line 56: @@
 ==AP Check Import Header File Definitions==
-'''f1 - Invno''' - AP invoice number
+Required fields are indicated with an *
-'''f2 - Vendno''' - Vendor number in Adjutant
+'''*f1 - Invno''' - AP invoice number
+'''*f2 - Vendno''' - Vendor number in Adjutant
 '''f3 - PPriority''' - Payment priority value. '2' is the most common entry.
-'''f4 - PTerms''' - Payment terms for the selected invoice. Valid terms from the TERMS rule should be used. If an entry is found during import that doesn't match an existing TERMS rule record, that entry will be added to the TERMS rule with no other rule details. This allows the import to complete, but could add unwanted records to the TERMS rule.
+'''*f4 - AprPay''' - Payment/Check amount
-'''f5 - PurAmt''' - Original AP invoice amount
-'''f6 - PaidAmt''' - Cumulative amount paid toward this invoice. If also importing an AP Check file, this amount should match the total of all non-void checks linked to the invoice.
-'''f7 - Balance''' - AP invoice open balance
-'''f8 - UDRef''' - AP invoice reference #
+'''f5 - DisAmt''' - Discount amount
-'''f9 - APAcc''' - AP payable GL account stored in the APMAST table.  This is used for selecting AP invoice records by payable account on some reports. This value should match the account flagged as the control account in the AP Invoice Distribution import.
+'''f6 - Amt1099''' - This field is not in use
-'''f10 - PurDate''' - AP Invoice Date value
+'''f7 - UDRef''' - Check reference number
-'''f11 - TranDte''' - AP invoice Post Date value
+'''*f8 - Checkno''' - AP Check number
-'''f12 - DueDate''' - AP invoice Due Date value
+'''*f9 - CheckDate''' - AP Check date (MM/DD/YYYY)
-'''f13 - DisDate''' - AP invoice Discount Date value
+'''f10 - VoidDate''' - AP Check voided date, also marks the check as a void (MM/DD/YYYY)
-'''f14 - PDisc''' - Field not in use
+'''*f11 - ChkAcc''' - AP checking account associated with transaction
-'''f15 - PDays''' - Field not in use
+'''f12 - u1099''' - This field is not in use
-'''f16 - PNet''' - Field not in use
+'''f13 - Typ1099''' - This field is not in use
-'''f17 - Discount''' - Field not in use
+'''*f14 - CkType''' - Check type. Common entry is C for check, or M for manual
-'''f18 - DisAmt''' - AP invoice discount dollar amount. This value gets saved in the APMAST table as an approved discount amount. Any value imported will load into the Approve AP Invoice screen as a pre-set discount value.
+'''f15 - ClearDate''' - Sets the Bank Reconciliation clear date, and marks the check as cleared (MM/DD/YYYY)
-'''f19 - AdjAmt''' - AP invoice adjustment dollar amount. This value gets saved in the APMAST table as an approved adjustment amount. Any value imported will load into the Approve AP Invoice screen as a pre-set adjustment value.
-'''f20 - AprPay''' - Approved payable amount. Any entry here will set the approved to pay flag. Leave this blank to process approvals through the Approve to Pay process.  This amount should match the balance value, or if using discounts and adjustments, it should match the remaining balance.
-'''f21 - AprAdj''' - Marks the adjustment amount as approved
-'''f22 - Amt1099''' - AP invoice 1099 Amt value. The Remit To 1099 Type is used to set the 1099 Type on the invoice record.
-'''f23 - Buyer''' - Field not in use
-'''f24 - CheckNo''' - AP Check number for last check paid on this invoice. Check details imported on this file will only update the APMAST table, and will not create any records in the Payment tab. The AP Check Import must be used to create details in the AP Invoice Payment tab.
-'''f25 - CheckDate''' - AP Check date for last check paid on this invoice. Check details imported on this file will only update the APMAST table, and will not create any records in the Payment tab. The AP Check Import must be used to create details in the AP Invoice Payment tab.
-'''f26 - ChkAcc''' - AP Checking GL Account associated with this invoice
-'''f27 - Typ1099''' - This field is not used to set the 1099 Type.  In order to import 1099 amounts with AP Invoices, the vendor's Remit To record must be set up with the default 1099 Type, which will be used for any imported 1099 amounts on AP invoices.
-'''f28 - Descrip''' - AP Invoice Notes value
-'''f29 - Template''' - Enter 'Y' to mark the associated line as a template record
-'''f30 - Voucher''' - AP invoice Voucher field value
-'''f31 - VRemitTo''' - Remit To organization number
@@ Line 132: / Line 93: @@
 ==AP Check Import Distribution File Definitions==
-Each AP Invoice should have at least two lines per invoice in this file - one line for the control account total amount, and additional distribution lines that total up to the original invoice balance.
+Each AP Check should have at least two lines per invoice in this file - one line for the control account total amount, and additional distribution lines that total up to the original check amount.
-'''f1 - Invno''' - AP invoice number that links to the invoice number in the header file
+Required fields are indicated with an *
-'''f2 - Vendno''' - Vendor number in Adjutant
+'''*f1 - Invno''' - AP invoice number that links to the invoice number in the header file
-'''f3 - UDRef''' - Field not in use
+'''*f2 - Vendno''' - Vendor number in Adjutant
-'''f4 - GLAcnt''' - GL Account associated with each line of distribution detail
+'''f3 - UDRef''' - Detail reference number
-'''f5 - Amount''' - Distribution amount for the associated detail
+'''*f4 - GLAcnt''' - GL Account associated with each line of distribution detail
-'''f6 - CtrlAcct''' - Enter 'Y' to code the line as the payable control account distribution entry. This sets the GL Account and the Amount as the Control Account entries in the GL Distribution tab. Leaving the CtrlAcct field empty sets the associated line as a balancing distribution entry.  Each imported invoice should have a Ctrl Acct amount that matches the total of all distribution lines linked to the same invoice.
+'''*f5 - Amount''' - Distribution amount for the associated detail
-'''f7 - Descrip''' - Distribution note entry for non-control account lines
+'''*f6 - CtrlAcct''' - Enter 'Y' to code the line as the payable control account distribution entry. Leaving the CtrlAcct field empty sets the associated line as a balancing distribution entry.  Each imported invoice should have a Ctrl Acct amount that matches the total of all distribution lines linked to the same check.
@@ Line 152: / Line 113: @@
 ==AP Check Import Reconciliation==
-Reconciling imported data should begin with spot-checking several records field-by-field for complete data import.  Pick records from the source file that have the most data columns filled in.  Verify that all source file data fields imported correctly and display as expected.
+Reconciling imported data should begin with spot-checking several records field-by-field for complete data import.  Pick records withthe most data columns filled in.  Verify that all source file data fields imported correctly and display as expected.
-Review the TERMS rule for any unexpected records added to the rule. Depending on the number of records involved, the rule maintenance records can be cleaned up, and the associated Remit To records can be manually updated.  Otherwise, clean up the TERMS rule, then delete the imported records, re-scrub the source file, and re-import.
-Run the AP Aging Report and compare the open AP balance against the AP control account GL balance.  If the source data was provided along with a clear GL cutoff balance, the two balances should be equal. Look for any data issues, such as incorrect aging, or missing details.
-Run the AP Invoice Report and compare against imported data. Make sure all records and all data fields report as expected.
+Review the AP Invoice Payments tab and spot-check several records.
-Run the Approve AP Invoices process and spot-check a few individual invoices for approval balances and settings. Try approving a single invoice using the 'A2P' button and look for any issues with approval amounts.
+Run the AP Check Register and verify that the imported checks show up with the correct dates and amounts.
-Verify that all 1099 amounts imported correctly by spot-checking several different vendors.
+Review the imported checks in the Payments tab of the Organization Air Hammer and confirm that data displays as expected.
-Review the imported invoices in the Organization Air Hammer and confirm that data displays as expected.
+Review Bank Reconciliation and verify that cleared checks are reported correctly.
@@ Line 170: / Line 127: @@
 ==AP Check Import Additional Steps==
-There are no additional steps required to complete the AP Invoice import.  The AP Check Import can be run after the AP Invoice Import, if requested.
+There are no additional steps required to complete the AP Check import.
@@ Line 176: / Line 133: @@
 ==AP Check Import Database Tables==
-'''APMAST''' - Each imported invoice from the Header file creates a new KEYNO in the APMAST TABLE, linked to the imported APINVNO value. The APMAST KEYNO value is the link to the APDIST table (as KEYNOH in APDIST).
+'''CHECKLOG''' - Each imported check will create a unique KEYNO record in CHECKLOG. The KEYNO links to the DOCKEYNO value in the APDIST table.  The CHECKNO field displays the imported check number.
-'''APDIST''' - Each imported distribution detail line will create an entry in the APDIST table. The KEYNOH value should match the APMAST KEYNO value for the associated AP invoice. The PTYPE will be 'D' for distribution details, and 'C' for Control lines. Note that imported AP Check details will also create details in the APDIST table, so be careful of deleting any unintended records.
+'''APDIST''' - Each imported check distribution detail line will create an entry in the APDIST table. The DOCTYPE value will be 'APCHK' and the the DOCKEYNO value will link to the imported check KEYNO in the CHECKLOG table. There should be at least two APDIST records for each imported check.
-'''CHECKLOG''' -
 [[Category: Accounts Payable]]
-[[Category: Conversion Guides]]
+[[Category: Import Guides]]
+[[Category: Import/Export]]