HMRC VAT Setup - Service Connections

Use the OAuth Setup - HMRC VAT page to set up the OAuth authorization protocol for SOAP and OData web services for connection to Her Majesty's Revenue and Customs (HMRC). When Multi-Entity Management is used, you can select whether the OAuth authorization protocol for SOAP and OData web services is used with a single MEM entity or a MEM HMRC group.

Thw OAuth authorization protocol is a standard feature in Microsoft Dynamics 365 Business Central. For more information, see the Microsoft Dynamics 365 Business Central documentation: 

Set Up the Connection with HMRC

To set up the connection with the HMRC to be used with MEM entities, follow these steps: 

  1. From the MEM HMRC VAT Setup Status , select New.
  2. If no MEM HMRC groups currently exist or you want to create a group, select the MEM HMRC Group Setup action to open the corresponding page.
  3. On the HMRC VAT Setup - Service Connections page, select Request Authorization Code.
  4. A browser window opens to the United Kingdom government website where you get the authorization code.

  5. After you get the authorization code, return to the HMRC VAT Setup - Service Connections page and go to the Request Authorization Code FastTab.
  6. To use a MEM HMRC group, turn on Use MEM Entity and select the MEM HMRC group.
  7. To use a single MEM entity, turn off Use MEM Entity and select the MEM entity code.
  8. Enter the authorization code.
  9. When the dialog to open the Company Information page appears, select No.
  10. Depending on whether you are using a MEM HMRC group or a single MEM entity, when a dialog asking you to open the MEM HMRC Group Setup or MEM Entity Setup page appears, select Yes.
  11. Validate the VAT registration number.

Request Authorization Code

Appears after the Request Authorization Code action has been executed. The following field boxes are available: 

Field Description
Use MEM Entity

Indicates whether a single MEM entity or a MEM HMRC group is used for the OAuth authorization protocol:

  • On: A single entity code is used for the OAuth authorization protocol.
  • Off: A MEM HMRC group is used for the OAuth authorization protocol.

For new connections, this option is available. For existing connections, this option is read-only and cannot be changed.

MEM Entity/HMRC Group Depending on the value of Use MEM Entity, select a single MEM entity or a MEM HMRC group.

Actions

The following actions are available: 

Action Description
MEM HMRC Group Setup

Opens the MEM HMRC Group Setup page, where you can review the group setup.

This action is available when this page is opened from the MEM HMRC VAT Setup Status page for a record that uses a MEM HMRC group.