API Docs / Schemas / UpdateHmrcSettingsRequest

UpdateHmrcSettingsRequest

A full replacement of the HMRC settings. The password is optional: omitted or null keeps the stored one. With
useSharedCredentials the tenant's own sender id, password and agent are discarded.

Properties

Name Type Description
useSharedCredentials*boolean

Use one of the owner's shared credentials

Use one of the owner's shared credentials

sharedCredentialsIdstring

The shared credentials to use (a code from /me/hmrc-credentials); required with useSharedCredentials

The shared credentials to use (a code from /me/hmrc-credentials); required with useSharedCredentials

senderType*enum

Employer, agent or acting in capacity

ActingInCapacity Agent Bureau Company Employer Government Individual Other Partnership Trust

Employer, agent or acting in capacity

ActingInCapacity Agent Bureau Company Employer Government Individual Other Partnership Trust

senderIdstring

The gateway user id

The gateway user id

passwordstring

The gateway password; null keeps the stored one

The gateway password; null keeps the stored one

officeNumberstring

The HMRC office number

The HMRC office number

payeReferencestring

The employer PAYE reference

The employer PAYE reference

accountsOfficeReferencestring

The accounts office reference

The accounts office reference

utrstring

The tenant's UTR

The tenant's UTR

testInLive*boolean

Send submissions to the live gateway flagged as tests

Send submissions to the live gateway flagged as tests

useTestGateway*boolean

Send submissions to HMRC's test gateway

Send submissions to HMRC's test gateway

agentHmrcAgentDto

The agent details, when the sender is an agent

The agent details, when the sender is an agent

JSON Example

{
  "useSharedCredentials": false,
  "sharedCredentialsId": "00000000-0000-0000-0000-000000000000",
  "senderType": "ActingInCapacity",
  "senderId": "string",
  "password": "string",
  "testInLive": false,
  "useTestGateway": false
}

Used By Operations