Show TOC

Function documentationError Handling

 

Sometimes, it is not possible to post an accounting document to Central Finance, for example, if the posting period is not yet open, a cost center is blocked, or master data is mapped incorrectly.

Activities

Error Handling for Initial Load

Errors relating to the initial load of cost objects and CO secondary posting documents can be handled in the Central Finance system using the SAP Application Interface Framework (SAP AIF). Errors from the initial load of FI postings are displayed in the Customizing activity Monitor Postings.

Error Correction with AIF

SAP AIF allows you to distribute messages to different users, use alerts, and carry out reporting. For Central Finance details about errors are displayed in SAP AIF, in the Central Finance namespace /FINCF.

In addition to the errors relating to, for example, the initial load for cost objects, errors for the online transfer after initial load from all scenarios (cost objects, FI postings, and CO secondary posting documents) can be handled in the Central Finance system using SAP AIF.

Before you Start

Before you start using SAP AIF, you must complete the following steps:

  • Install the current version of the SAP AIF add-on in the central system. The following software components are required:

    • SAP Application Interface Framework 3.0 – AIF 702 (main component)

    • SAP Application Interface Framework 3.0 – AIFX 702 (optional extension)

  • Implement SAP Note 2196783Information published on SAP site and install the BC sets delivered with the following SAP notes:

    • 2202650 for handling errors of replication of FI postings

    • 2202691 for handling errors of replication of CO postings and cost objects

  • If you want to use the transactions Interface Monitoring (/AIF/IFMON) and Monitoring and Error Handling (Web) (/AIF/ERR_WEB) and receive alerts via email, you must first make the following settings:

    • Assign the business user who is responsible for analyzing errors in AIF a user based on the role template SAP_AIF_USER. For more information about role templates, see the Master Guide for AIF on the SAP Help Portal.

    • Register your user for the scenarios that you want to analyze the errors for.

      You can register for using the SAP Menu under Start of the navigation path Cross-Application Components Next navigation step SAP Application Interface Framework Next navigation step Administration Next navigation step Configuration Next navigation step Recipients of a User End of the navigation path or by using transaction /AIF/RECIPIENTS.

      Enter the name of the user and create a new entry for the following:

      • Namespace: /FINCF

      • Recipient for Alert: CFIN_RECIPIENT

      • Message Type: Application Error or Technical Error

      • Select the Include on Overview Screen checkbox

Using AIF

From the Interface Monitor, you should see the Central Finance - /FINCF node as the top node of the tree. You can expand this node to see the different interfaces including the number of messages, warnings, and errors for each of the interfaces. By clicking on the number of errors, you can navigate to display where and when the errors occurred and when you click on a posting you can display the error messages for that posting.

Alternatively, you can use Monitoring and Error Handling (transaction /AIF/ERR) to view the details of the error.

You can also display the message structure for the replicated document and check the values that were replicated.

In most cases, documents cannot be posted because of an invalid mapping rule, missing Customizing, or master data. Once the mapping, Customizing, or master data is corrected the document can be reprocessed by choosing Restart.

Depending on your Customizing settings, you can also change values directly in the SAP AIF tool. If you change values using SAP AIF, you can repost the document with the changed values by choosing Repost with user changes.

To change values directly in Monitoring and Error Handling:

  1. Press return to make the Emergency Correction check box visible and select the check box.

  2. Select the message in question.

  3. Select the ACCIT structure.

  4. In the ACCIT structure, double-click the field you want to change. A pop-up window is displayed in which you can change the value.

  5. Choose Save.

  6. Once you have changed all required fields, choose Repost with User Changes.

Caution Caution

If you choose the Restart button, you discard the manual changes.

End of the caution.

For more information on SAP AIF, see SAP Library for SAP Application Interface Framework 3.0 on the SAP Help Portal at http://help.sap.comInformation published on SAP site.

Error Correction with SAP LT Replication Server

Before SAP Simple Finance, on-premise edition 1503 SPS 1508, errors from the replication of CO postings and cost objects could only be monitored in the application log of the SAP LT Replication Server.

As of SAP Simple Finance, on-premise edition 1503 SPS 1508, errors from all three replication scenarios can be handled in the Central Finance System using SAP AIF.

Only severe technical errors, for example, connectivity problems between the systems, can be found in the application log of the SAP LT Replication Server.

Error Correction with ECS

Recommendation Recommendation

You can still use ECS for handling FI postings but as of SAP Simple Finance, on-premise edition 1503 SPS 1508, SAP recommends that you use SAP AIF as SAP AIF offers a single place to handle errors from all Central Finance replication scenarios.

End of the recommendation.

If it is not possible to post a document in the Central Finance system due to an error in the posting, the document is displayed in ECS together with details about the error. The document can only be corrected in the Central Finance system; it is not possible to correct it from the source system.

Error Categories

There are three possible categories of error:

  • Incomplete mapping of master data

    This must be corrected in the Central Finance system.

  • Incomplete configuration of Customizing settings

    This must be corrected in the Central Finance system.

  • Errors that can be corrected directly in ECS

    Note Note

    ECS only deals with errors relating to postings into General Ledger.

    End of the note.
Customizing Settings

Before you start using ECS, you must ensure the Customizing settings are correct. For more information on the Customizing settings where you define the ECS environment that you want to use for processing postings to Central Finance, see Customizing for Financial Accounting (New) underStart of the navigation path Central Finance Next navigation step General Settings Next navigation step Choose ECS Environment End of the navigation path.

You can navigate to the general Customizing settings for ECS from the document for Choose ECS Environment using the Define ECS Environment link. Alternatively, see Customizing for Financial Accounting (New) under Start of the navigation path Financial Accounting Global Settings (New) Next navigation step Document Next navigation step Error Correction and Suspense Accounting Next navigation step General Settings End of the navigation path. From here you must define the ECS environment and create number ranges for document numbers in ECS.

You can assign error messages to error categories and group the error categories in compound categories and use these to classify erroneous documents. Additionally, if you want to manually correct documents in ECS before re-posting, and the relevant field is not editable by default, you can define additional fields for corrections to line items.

Recommendation Recommendation

We recommend that you avoid making manual corrections as much as possible. Instead, we recommend that you correct the Customizing settings and master data mapping before reposting the unchanged document in ECS.

End of the recommendation.

Once you have completed the Customizing settings for ECS, you can use ECS to review documents that have not been posted in the Central System and enter the necessary information (for example, company code and fiscal year) for the search. You can access ECS from the SAP Menu under Error Correction and Suspense Accounting or by using transaction ACC_ECS_MAINTAIN.

Using ECS

ECS displays the documents that have been transferred from the sender system but not yet replicated to the central system due to errors. By using the SendDoc.No. field, you can search for a specific document number from the sender system. Once you select the document you want to analyze, you can determine the reason for the error from the details of the line items.

Note Note

Note that, the ECS tool always displays the full history of error messages for the item, even if the source of the error has already been corrected.

End of the note.

After the error has been corrected in the Central System, you can reprocess the document from ECS by choosing Post and Next Item. Once all errors have been corrected, the system displays the message Last entry in the worklist has been reached and if you look for the document again in ECS, the document will no longer show up there.