# Registration

Source: https://developer.avalara.com/products/returns/integration-guides/managed-returns-emea/wdc7957731610967/

Guide: Avalara Managed Returns API (EMEA)

# Registration

Understand the end-to-end VAT Registration workflow in Avalara, using Great Britain as an example.

Once your Avalara Client Account and default Company are created, follow these steps to complete VAT Registration or transfer using Avalara.

These steps apply to the VAT Registration process across supported jurisdictions. The following workflow uses Great Britain (GB) as an example to illustrate the process.

The VAT Registration workflow includes the following steps:

1.  Review VAT Registration task
2.  Provide VAT Registration details
3.  Create VAT Registration application
4.  Open the authorization link
5.  Complete authorization
6.  Complete registration workflow

After completing these steps, Avalara updates the VAT Registration and the client is ready for downstream VAT services such as return preparation and filing.

## Review VAT Registration task

View the VAT Registration task created for your entity and retrieve pending registration actions using the API.

Review the VAT Registration task created for your entity in the Avalara VAT workflow.

Avalara creates a pending VAT Registration action for your entity in the VAT workflow. Your implementation or Avalara team uses this to start the registration flow. No action is required in this step.

Use the following query to retrieve pending VAT Registration actions.

**View request:**

```
query RegistrationActions() {
  vatRegistrationActions() {
    id
    applicationId
    nodeTaskId
    name
    createdDate
    completed
  }
}
```

**View response:**

```
{
  "data": {
    "vatRegistrationActions": [
      {
        "id": "84801c38-2439-11f1-8ef7-aa619259d58f",
        "applicationId": "1747624630",
        "nodeTaskId": "Activity_0unxrir",
        "name": "Seller data collection",
        "createdDate": "2026-03-20T08:48:07.992+00:00",
        "completed": false
      }
    ]
  }
}
```

## Provide VAT Registration details

Provide VAT Registration details for the client and submit them using the API.

Provide VAT Registration details for the pending registration action in the Avalara VAT workflow.

In the Avalara experience, or in your embedded platform, you’re prompted to enter:

-   Existing VAT Registration number
-   Effective registration date
-   VAT Returns start date

Use the following mutation to submit VAT Registration details for the pending action.

**View request:**

```
mutation SubmitRegistrationData($input: SubmitRegistrationDataInput!) {
  vatSubmitRegistrationData(input: $input) {
    success
    errors {
      message
    }
  }
}
```

**Variables example:**

```
{
  "input": {
    "entityId": "1493885669",
    "actionId": "84801c38-2439-11f1-8ef7-aa619259d58f",
    "staggerGroup": "Stagger 1",
    "returnsStartDate": "31-08-2023",
    "currentVatNumber": "553423606",
    "effectiveRegistrationDate": "01-01-2026"
  }
}
```

**View response:**

```
{
  "data": {
    "vatSubmitRegistrationData": {
      "success": true,
      "errors": null
    }
  }
}
```

## Create VAT Registration application

Create a VAT Registration application and review its registration and workflow status.

Once the registration details are submitted successfully, Avalara creates a VAT Registration application for Great Britain and associates it with the entity.

This application tracks both the tax registration status and the internal workflow status.

Use the following query to retrieve VAT Registration applications and their status.

**View request:**

```
query RegistrationApplications() {
  vatRegistrationApplications() {
    id
    status {
      registrationStatus
      workflowStatus
      statusDate
    }
    registrationType
    registrationAction
    jurisdiction
  }
}
```

**View response:**

```
{
  "data": {
    "vatRegistrationApplications": [
      {
        "id": "1747624630",
        "status": {
          "registrationStatus": "WaitingForFirstSoftCopy",
          "workflowStatus": "post:review",
          "statusDate": null
        },
        "registrationType": "Vat",
        "registrationAction": "Transfer",
        "jurisdiction": "spgb"
      }
    ]
  }
}
```

## Open the HMRC authorization link

Retrieve the HMRC authorization link and use it to authorize Avalara to act for VAT.

Avalara generates an authorization link that redirects you to the HMRC website. Use this link to sign in to your HMRC account and confirm that Avalara Europe Ltd is authorized to act for you for VAT. The link has an expiry date, so complete this step before it expires.

Use the following query to retrieve the HMRC authorization link for the application.

**View request:**

```
query RegistrationApplicationActions($entityId: String!, $applicationId: String!) {
  vatRegistrationApplicationActions(entityId: $entityId, applicationId: $applicationId) {
    id
    applicationId
    data {
      authorizationURL
      isAuthorizationCompleted
      authLinkExpirationDate
    }
  }
}
```

**Variables example:**

```
{
  "applicationId": "1747624630"
}
```

**View response:**

```
{
  "data": {
    "vatRegistrationApplicationActions": [
      {
        "id": "516bde59-243b-11f1-a156-8ec1b48d49ee",
        "applicationId": "1747624630",
        "data": {
          "authorizationURL": "https://www.tax.service.gov.uk/agent-client-relationships/appoint-someone-to-deal-with-HMRC-for-you/DNSZDGAR/avalara-europe-ltd/vat",
          "isAuthorizationCompleted": "false",
          "authLinkExpirationDate": "2026-04-10"
        }
      }
    ]
  }
}
```

## Complete authorization in HMRC

Complete authorization in HMRC and confirm the authorization in the VAT workflow.

After you finish the HMRC steps, HMRC confirms the authorization back to Avalara. Avalara then marks the authorization step as complete in the VAT workflow.

Use the following mutation to mark the registration authorization as completed.

**View request:**

```
mutation CompleteRegistrationAuthorization($input: CompleteRegistrationAuthorizationInput!) {
  vatCompleteRegistrationAuthorization(input: $input) {
    success
    errors {
      message
    }
  }
}
```

**Variables example:**

```
{
  "input": {
    "actionId": "516bde59-243b-11f1-a156-8ec1b48d49ee"
  }
}
```

**View response:**

```
{
  "data": {
    "vatCompleteRegistrationAuthorization": {
      "success": true,
      "errors": null
    }
  }
}
```

## Complete registration workflow

Complete the VAT Registration workflow and confirm that the client is ready for filing.

Once authorization is recorded, Avalara advances the VAT Registration workflow and creates or updates VAT registrations in the VAT workflow system.

At this point, the client is ready for downstream VAT services such as return preparation and filing.