Skip to Content
Author's profile photo Michal Krawczyk

Michal’s Tips: AIF – alert recipient based on error message class and message ID

When integration related error handling needs to be solved quickly we need to make sure correct users are getting notified. When AIF is correctly implemented (with a clear guidelines on what kind of integration patterns should be done in SAP PO and what needs to be done in SAP AIF) we already have the first level of speeding up the error handling as technical users don’t receive any alerts from SAP AIF since they go directly to the business users. Sometimes however it’s not enough to send all SAP AIF alerts even from a single interface to a single specific person or group as a single IDOC can have many times of errors like master data, SD customizing, MM customizing, FI related. With SP04 for SAP AIF SAP has came up to the rescue in such cases. We can now create AIF alerts for different support groups and assign only specific error messages to each of them.

Steps required for setting up this new funcionality will require creating a new, custom alert category which will be used to receive the alerts by e-mail, creating a new recipient assignment table, creating a new message category (which in this case will hold all sales module related errors), assigning error message classes and error message IDs to the message category, populating recipient assignment table and assining the configuration in AIF customizing.

Step 1

Create a new alert category of type SAP Application Interface Framework with transaction ALRTCATDEF and populate it with some text which will help the business users to understand which message is the one they should be looking similarly as per figure below.


Step 2

Next step is to create a new recipient assignment table by copying the template table /AIF/RECA_TMPL which will store the assignments created in further steps.


Step 3

Transaction /AIF/MSG_CAT_DEF allows us to create a new message category like SALES_ERRORS which will be later assigned to the AIF recipient.


Step 4

Transaction /AIF/MSG_CAT_ASGN is used to assign all message classes and respective message numbers to the AIF message category created in the previous step as shown in figure below.


Step 5

As the next customizing step we need to create a new alert customizing where we will assign the recipient assignment table and custom alert category. This step can be done using the following menu: /AIF/CUST -> Error Handling -> Define Namespace-Specific Features -> Configure Alerts


Step 6

We also need to create as many recipients as different teams which will be receiving the alerts as shown in the figure below.


Step 7

As the last customizing activity we can populate the recipient assignment table with interface related info, message category and recipient who will receive all alerts from a specified message category as shown in figure below.



As a result each time your interface will encouter any of the errors specified in step 4 an recipient of type specified in step 6 will be triggred and the users assigned to this recipient will receive an e-mail customized in step 1.

Further information:

SAP page about this configuration –

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Gaurav Jain
      Gaurav Jain

      Thanks Michal for your blog, it's helpful.

      It will also helpful if you write about how can we generate email with customize email template which will have some logo, image, links and different fonts as well?


      Author's profile photo Former Member
      Former Member


      Please let me know how to connect OData service to SAP AIF. I'm working on a POC

      Author's profile photo Narendra Rajput
      Narendra Rajput

      Hi Michal,

      Firstly thank you for wonderful blog.

      I follow Step 3 Transaction code /AIF/MSG_CAT_DEF and enter field name Namespace and press enter. In my userid I have SAP ALL Authorization. But Still I got Authorization required message.

      Kindly help me.

      Thank in Advance...!!!



      Author's profile photo Former Member
      Former Member


      Did you get any lucky with this issue?


      Author's profile photo Antonio Vaz
      Antonio Vaz

      Hi Narendra,

      In case you still have this issue, the problem is that there are some entries missing in /AIF/V_AUTH_VCL.

      Please check notes:

      2490397 - Some entries are missing for /AIF/V_AUTH_VCL

      2479620 - Some entries are missing for /AIF/V_AUTH_VCL


      Best regards,

      António Vaz

      Author's profile photo Salil Vaidya
      Salil Vaidya

      Hi  Michal,


      Thanks for the wonderful blog. I tried to implement the steps mentioned by you but the email is not getting triggered. I am not sure what to look at and where to look at.




      Author's profile photo Former Member
      Former Member

      Hi Salil, did you create a new table (copy of /AIF/RECA_TMPL) as suggested in step   2?

      How would we know if this table is already created previously.


      For you case did you check SOST and RSCONN00 job is running? They are mostly switched off in Dev systems.

      Author's profile photo Salil Vaidya
      Salil Vaidya

      Hi Amit,

      I copied the table and have maintained the entries but still it doesn't seem to work. Basis has configured my email id in SOST to receive emails but during testing I see that SOST does not have anything stuck for my scenario.

      Author's profile photo Salil Vaidya
      Salil Vaidya


      Looks like I am not able to find the config setting wherein I can create user id's for the team specified to get the email notification. Per above example, he has used SALES_TEAM. How do we add recipients to this group in customizing. Or if I have to just send email to my self for my POC, can I put my email id, instead of the group.

      Author's profile photo Peter Babbington
      Peter Babbington

      Hi Salil,

      Run tcode /AIF/CUST

      Goto [Assign Recipients]


      Select your Namespace, then Recipient for Alert [e.g SALES_TEAM]

      Click on [New Entries] to assign new abap user

      Select Message Type [e.g Application Error or Technical Error]

      [F1 help] per field if you want to learn more.





      Peter Babbington



      Author's profile photo Hubert Palatynski
      Hubert Palatynski

      Hi Michal

      in step 4 you suggest to assign all message classes and respective message numbers to the AIF message category created in the previous step. Do we really need to do ? I mean is there any easy solution to send all warnings,information and errors? I don't want to limit it to identifies items. I want to be sure that AIF alert will send all messages to my user mailbox.


      Best regards