# New incorporation schema 3.8

**URL:** <https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804>\
**Category:** Incorporation\
**Created:** [September 4, 2025, 9:59am UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804 "2025-09-04T09:59:56Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![oliver](https://xmlforum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/o/85f322/32.png) [@oliver](https://xmlforum.companieshouse.gov.uk/u/oliver)\
**Post date:** [September 4, 2025, 9:59am UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804/1 "2025-09-04T09:59:56Z")

</div>

The new incorporation schema - CompanyIncorporation-v3-8.xsd -([http://xmlgw.companieshouse.gov.uk/v1-0/schema/forms/CompanyIncorporation-v3-8.xsd](http://xmlgw.companieshouse.gov.uk/v1-0/schema/forms/CompanyIncorporation-v3-8.xsd)) includes 3 examples:

- [Incorporation with Verification Details Limited by Shares](http://xmlgw.companieshouse.gov.uk/examples/Incorporation%20with%20Verification%20Details%20Limited%20by%20Shares.xml)
- [Incorporation with Verification Details for LLP](http://xmlgw.companieshouse.gov.uk/examples/Incorporation%20with%20Verification%20Details%20for%20LLP.xml)
- [Incorporation without Registers](http://xmlgw.companieshouse.gov.uk/examples/Incorporation%20without%20Registers.xml)

We cannot see anything in the Ltd by share schemas that do or do not include information about the new changes regarding keeping registers on the public record or not. So we do not understand why there are 2 different examples here?

The only difference we can see is that there are different authentication methods:

[Incorporation with Verification Details Limited by Shares] uses **memorandum/authoriser personal authentication enums** (`*_AGREES_NAME_USED_TO_AUTHENTICATE`). We understand this to be the new and correct method.

[Incorporation without Registers] uses **detailed Q&A style authentication** with `<PersonalAttribute>` and `<PersonalData>` pairs. Why is this included - we thought this authentication method is being removed?

Thank you.

---

<div class="post-metadata">

**Author:** ![snicholas](https://xmlforum.companieshouse.gov.uk/user_avatar/xmlforum.companieshouse.gov.uk/snicholas/32/81_2.png) [@snicholas](https://xmlforum.companieshouse.gov.uk/u/snicholas)\
**Post date:** [September 5, 2025, 11:09am UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804/2 "2025-09-05T11:09:12Z")

</div>

I will get these looked at Oli.

SDN

---

<div class="post-metadata">

**Author:** ![oliver](https://xmlforum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/o/85f322/32.png) [@oliver](https://xmlforum.companieshouse.gov.uk/u/oliver)\
**Post date:** [September 25, 2025, 6:42am UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804/3 "2025-09-25T06:42:39Z")

</div>

Hi Simon. Any update on this, please?

---

<div class="post-metadata">

**Author:** ![snicholas](https://xmlforum.companieshouse.gov.uk/user_avatar/xmlforum.companieshouse.gov.uk/snicholas/32/81_2.png) [@snicholas](https://xmlforum.companieshouse.gov.uk/u/snicholas)\
**Post date:** [September 25, 2025, 7:32am UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804/4 "2025-09-25T07:32:14Z")

</div>

Hi,

We are working through a great number of queries at the moment - I am not sure if this has been looked at yet, I will check.

SDN

---

<div class="post-metadata">

**Author:** ![user46](https://xmlforum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/u/c37758/32.png) [@user46](https://xmlforum.companieshouse.gov.uk/u/user46)\
**Post date:** [October 10, 2025, 7:59am UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804/5 "2025-10-10T07:59:17Z")

</div>

Following this thread. Had the same question while making the integration for the newer schema changes.

---

<div class="post-metadata">

**Author:** ![oliver](https://xmlforum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/o/85f322/32.png) [@oliver](https://xmlforum.companieshouse.gov.uk/u/oliver)\
**Post date:** [October 14, 2025, 12:48pm UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804/6 "2025-10-14T12:48:24Z")

</div>

Just to follow up on this Simon we are submitting test CS01 and have found, we believe, that CH is always expecting a value for `NameMismatchReason`. Our understanding is that this should be optional as the vast majority of individuals with UIDs will have the same name as was used in their IDV process, so they do not need to/ cannot submit a `NameMismatchReason`.

This is the relevant section of the test submission, which does not include `NameMismatchReason`.

```auto
<VerificationStatement>
            <Director>
              <Person>
                <Title>MR</Title>
                <Forename>PERSON</Forename>
                <Surname>NAME</Surname>
                <DOB>1967-08-13</DOB>
                <VerificationDetails>
                  <CompaniesHousePersonalCode>XWJ22222222</CompaniesHousePersonalCode>
                  <VerificationStatements>
                    <VerificationStatementForIndividual>INDIVIDUAL_VERIFIED</VerificationStatementForIndividual>
                  </VerificationStatements>
                </VerificationDetails>
              </Person>
            </Director>
          </VerificationStatement>

```

This is the error response we receive:

`[{:raised_by=>"ConfirmationAndVerificationStatement", :number=>"9999", :type=>"fatal", :text=>"Invalid Name Mismatch Reason", :location=>""}]`

---

<div class="post-metadata">

**Author:** ![snicholas](https://xmlforum.companieshouse.gov.uk/user_avatar/xmlforum.companieshouse.gov.uk/snicholas/32/81_2.png) [@snicholas](https://xmlforum.companieshouse.gov.uk/u/snicholas)\
**Post date:** [October 15, 2025, 1:06pm UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804/7 "2025-10-15T13:06:02Z")

</div>

name mismatch in the baseType is min occurs = 0  
which means optional, so we are not sure why you are getting a failure.  
\<xs:element name=“NameMismatchReason” type=“NameMismatchReason” minOccurs=“0”/\>

Can you send the xml test submission instance to [xml@companieshouse.gov.uk](mailto:xml@companieshouse.gov.uk) please.

SDN

---

<div class="post-metadata">

**Author:** ![user46](https://xmlforum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/u/c37758/32.png) [@user46](https://xmlforum.companieshouse.gov.uk/u/user46)\
**Post date:** [October 17, 2025, 5:26am UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804/8 "2025-10-17T05:26:59Z")

</div>

> [Incorporation without Registers] uses **detailed Q&A style authentication** with `<PersonalAttribute>` and `<PersonalData>` pairs. Why is this included - we thought this authentication method is being removed?

Hi Simon, Any update on this part, please?

---

<div class="post-metadata">

**Author:** ![snicholas](https://xmlforum.companieshouse.gov.uk/user_avatar/xmlforum.companieshouse.gov.uk/snicholas/32/81_2.png) [@snicholas](https://xmlforum.companieshouse.gov.uk/u/snicholas)\
**Post date:** [October 17, 2025, 6:33am UTC](https://xmlforum.companieshouse.gov.uk/t/new-incorporation-schema-3-8/1804/9 "2025-10-17T06:33:16Z")

</div>

Sorry, still being discussed internally - there is so much to do at the moment - please be assured I have not forgotten you though.

SDN
