e-Filing GB Middleware: SAP Exchange Infrastructure 

Use

Two distinct and separate Middleware can be used with the e-Filing for Great Britain solution. The Middleware you install depends on your current SAP release at the time of installation:

• SAP Business Connector (SAP BC) > Releases 46C – 5.00 (ERP 2004)
• SAP Exchange Infrastructure (SAP XI) > Releases 6.00 (ERP 2005) and above

The remainder of this document details the specific steps you must take to install the SAP Exchange Infrastructure Middleware.

To access comprehensive SAP Library Documentation on the SAP Exchange Infrastructure, choose the Documentation option on the Integration Builder start page.

 

Procedure

You must carry out two distinct sets of implementation work to configure and install the SAP Exchange Infrastructure (SAP XI) in your own systems:

1. Set up the SAP XI Landscape and XI Communication Processes

You carry out these activities in your SAP XI NetWeaver System

2. Create a HTTP Connection to the Government Gateway

You carry out this activity in your SAP (R/3) XI System.

 

To set up the SAP XI Landscape and XI Communication Processes for e-Filing GB, you must carry out the following seven implementation stages.

You execute these stages in your SAP XI NetWeaver System as follows:

 

Stage 1: Create a Product and Product Version and add a Software Component and a Software Component Version

1. Start the Integration Builder (transaction SXMB_IFR) from within your SAP (R/3) XI system.
2. Select System Landscape Directory and log on.
3. Select the Software option Software Catalog.

The Software Catalog is now opened for you.

4. Select Products using the drop-down menu assigned to the field Software Type.
5. Click the pushbutton New Product.
6. Assign a Vendor, Vendor Name and Version and click Create.

The Define Software Component screen opens and a message is displayed confirming that you have now created a product.

7. Enter the name of your Software Component and the Software Component Version as specified below and click Create:

Name :    E-FILING GB

Version : 1.0

8. Click Finish.

A message is displayed informing you that you have now created a Software Component and the Software Component Version.

9. Select the Home option to return to the System Landscape Directory start page.

 

Stage 2: Download the XI Content for the Software Component Versions

In this stage, you download the XI content for the Software Component Version E-FILING GB you created in Stage 1 and the Software Component SAP_HR 6.00 that must already exist in your landscape.

1. You download the XI Content for the SW Component SAP_HR 6.00 from the SAP Support Portal (alias /swdc) as follows:

1. 1. Access the SAP Support Portal at http://service.sap.com/swdc.
   2. Drill-down as follows: Download -> Support Packages and Patches -> Entry by Application Group -> SAP Application Components -> <SAP ERP> -> <2005> -> <XI CONTENT SAP HR> -> <XI CONTENT 6.0>.
2. E-FILING GB 1.0

You download the XI Content for E-FILING GB 1.0 from the SAP Support Portal as follows:

a.       Access the SAP Support Portal at http://service.sap.com/swdc.

b.       Drill-down as follows: Download -> Support Packages and Patches -> Entry by Application Group -> SAP Content -> Process Integration Content (XI Content) -> E-FILING GB -> Version1.0.

 

Stage 3: Import and Activate your Software Component Version

In this third stage, you import and activate your downloaded Software Components into the Software component you created in Stage 1.

The SAP Library for SAP NetWeaver contains detailed documentation on this importation and activation process. You can access this documentation from the SAP Help Portal at http://help.sap.com, as follows:

1. Select Documentation from the upper menu bar and SAP NetWeaver from the lower menu bar.
2. Select English as your language.

The SAP Library for SAP NetWeaver opens.

3. Drill down using the SAP Library Menu tree on the left of the screen as follows: SAP NetWeaver -> SAP NetWeaver Configuration -> SAP Exchange Infrastructure.
4. Open the SAP NetWeaver Library document Transporting Using the Change Management Service.

For more information on the import of XI content, we recommend you refer to SAP Note 836200: XI 7.0: Import of Process Integration Content.

 

Stage 4: Create Parties for the Components SAP HR 6.00 and e-Filing GB 1.0

Using the Integration Directory, select the Objects tab, then Party and the context menu item New.

If you have not yet defined them, enter the party names representing your SAP HR 6.00 component and your e-Filing GB 1.0 component.

You must define your parties for each component in a separate step.

For component SAP HR 6.00, you can select your own party name. For the e-Filing component, you must use the party name GovernmentGateway.

 

Stage 5: Create the Required Business Services for your Parties

[A] For the party GovernmentGateway:

Create the following three business services as follows:

1. Using the Objects tab in the Integration Directory, select the party GovernmentGateway and expand this node.
2. Repeat the following steps for each of the three Government Gateway Business Services delivered by SAP in the Integration Scenario. These are GG_submission, GG_poll and GGMailbox:
3. 1. Select the node Business Service and the context menu item New.
   2. Enter the name of the service.
   3. Click Ok.

 

[B] For the party representing the SAP HR 6.00 component:

Create one business ser-vice by repeating the steps outlined above in [A] using your own name for this business service.

 

Stage 6: Implement Integration Scenario

You must implement an Integration Scenario for both e-Filing Great Britain Outgoing and Incoming Solutions. The steps you must take for each solution are outlined below:

 

[A] e-Filing Outgoing

 

1. Open the Integration Directory and import the Outgoing integration scenario PAYE_EOY_GB into the Integration Directory by selecting Tools -> Transfer Integration Scenario from Integration Repository.
2. Select PAYE_EOY_GB using the F4 option and click OK. On the next screen click Continue. On the third screen click Finish.

The Configuration Wizard is opened.

3. Configure the scenario PAYE_EOY_GB using the Configuration Wizard and save your entries.

You must follow the following procedure exactly when you execute Step 2 of the wizard Assign Services:

1. Execute Step 2 Assign Services.

The Assign Services to Application Components dialog box opens, displaying the product SAP ERP Version 2005.

2. On the Tab Business System Services for A2A, use the F4 help and select the business system on which the SAP HR component 6.00 resides in your system landscape.
3. Click OK.
4. On the Tab Business Services for B2B, use the F4 help and select the party representing the SAP HR component you created in Stage 4 and the business service you created in Stage 5.
5. Click OK.
6. Using the selection arrows assigned to the field Role, select the next role.

The role GG Site for EOYR submissions is displayed.

7. On the Tab Business Services for B2B, use the F4 help and select the party GovernmentGateway and the business service GG_submission.
8. Using the selection arrows assigned to the field Role, select the next role.

The role GG Site for polling is displayed.

9. On the Tab Business Services for B2B, use the F4 help and select the party GovernmentGateway and the business service GG_poll.
10. Click Assign and proceed with the execution of the wizard.

We recommend you accept all the settings suggested by the wizard when configuring this scenario.

 

[B] e-Filing Incoming

1. Open the Integration Directory and import the Incoming integration scenario Employee_tax_code_update into the Integration Directory by selecting Tools -> Transfer Integration Scenario from Integration Repository.
2. Select Employee_tax_code_update using the F4 option and click OK. On the next screen click Continue. On the third screen click Finish.

The Configuration Wizard is opened.

3. Configure the scenario Employee_tax_code_update using the Configuration Wizard and save your entries.

You must follow the following procedure exactly when you execute Step 2 of the wizard -Assign Services:

1. Execute Step 2 Assign Services.

The Assign Services to Application Components dialog box opens, displaying the productSAP ERP Version 2005.

2. On the Tab Business System Services for A2A, use the F4 help and select on the next screen the business system on which the SAP HR component 6.00 resides in your system landscape.
3. Click OK.
4. On the Tab Business Services for B2B, use the F4 help and select the party representing the SAP HR component you created in Stage 4 and the business service you created in Stage 5.
5. Click OK.
6. Using the selection arrows assigned to the field Role, select the next role.

The role GG Mailbox is displayed.

7. On the Tab Business Services for B2B, use the F4 help and select the party GovernmentGateway and the business service GGMailbox.
8. Click Assign and proceed with the execution of the wizard.

We recommend you accept all the settings suggested by the wizard when configuring this scenario.

 

For more information on the functions available when you use the Integration Builder, see the SAP Library for NetWeaver under:

SAP NetWeaver Configuration -> SAP Exchange Infrastructure -> Design and Configuration Time -> Integration Builder

 

Stage 7: Determine Receiver Conditions (e-Filing Outgoing only)

1. Open the Integration Directory and select the scenario PAYE_EOY_GB.
2. Expand the node Receiver Determination and select the object containing the value that appears in the key field Interface: HR_GB_EFO_RESP_OUT.
3. In the right-hand screen window, in the Group Box Configured Receivers, select the line containing the service GG_submission. In this line, select the F4 help assigned to the field Condition.

The dialog box Condition Editor appears.

4. In the field Left Operand, select the F4 help.

The Expression Editor opens.

5. Select the radio button xPath and expand the structure shown in the table.
6. Select the line containing the node ResponseEndPoint and click OK.

The dialog box Condition Editor reappears.

7. In the field Op., select =.
8. In the field Right Operand, insert the following value:

https://secure.gateway.gov.uk/submission.

You must now check that the value located in the Preview field corresponds to the following pattern:

(/ns:GovTalkMessage/ns:Header/ns:MessageDetails/ns:ResponseEndPoint= https://secure.gateway.gov.uk/submission)

[ns = Namespace Prefix]

9. Click Ok.
10. In the right hand screen window, in the Group Box Configured Receivers, select the line containing the service GG_poll. In this line, select the F4 help assigned to the field Condition.

The dialog box Condition Editor appears.

11. In the field Left Operand, select the F4 help.

The Expression Editor opens.

12. Select the radio button xPath and expand the structure shown in the table.
13. Select the line containing the node ResponseEndPoint and click OK.

The dialog box Condition Editor reappears.

14. In the field Op., select =.
15. In the field Right Operand, insert the following value:

https://secure.gateway.gov.uk/poll

You must now check that the value located in the Preview field corresponds to the following pattern:

(/ns:GovTalkMessage/ns:Header/ns:MessageDetails/ns:ResponseEndPoint= https://secure.gateway.gov.uk/poll)

[ns = Namespace Prefix]

16. Click Ok.
17. Save the current Receive Determination object you have amended and activate the entire scenario.

 

Result

You have now configured and installed the SAP Exchange Infrastructure (SAP XI) for both the e-Filing Outgoing and Incoming solutions in your own systems.

Firewalls and Access to the Internet

It is common business practice to install a separate SAP XI instance on a separate machine for productive runs. SAP XI is a communication middleware and must be able to access the Internet from within your network. SAP XI is also connected to your SAP system. To minimise the risk to your internal systems, you must keep your productive machines and the SAP XI that connects to your productive machines behind a firewall.

You must ensure that SAP XI is able to access the following URLs from within that firewall:

https://secure.gateway.gov.uk/GGMSSOAP/GGMSAPI.WSDL

https://secure.gateway.gov.uk/submission