5.7.2. Update contact¶

A contact update command is used to alter details of a contact.

The contact update command is an update element in the contact namespace (http://www.nic.cz/xml/epp/contact-1.6).

The command must be contained in the <update> command type.

5.7.2.1. Command element structure¶

The <contact:update> element must declare the contact namespace and schema and it must contain the following child elements:

<contact:id> (1) – the contact handle as fredcom:objIDType.
<contact:chg> (0..1) – comprises the new values of contact attributes that will be changed by this update. Omitted attributes will remain unchanged.
- <contact:postalInfo> (0..1) – change contact’s postal information:
  
  <contact:name> (0..1) – personal name as contact:postalLineType,
  
  <contact:org> (0..1) – organization name as contact:optPostalLineType,
  
  <contact:addr> (0..1) – address:
  
  <contact:street> (1..3) – street line 1–3 as contact:optPostalLineType,
  
  <contact:city> (1) – city as contact:postalLineType,
  
  <contact:sp> (0..1) – state or province as contact:optPostalLineType,
  
  <contact:pc> (1) – postal code as contact:pcType,
  
  <contact:cc> (1) – country code as contact:ccType,
- <contact:voice> (0..1) – change telephone number as contact:e164StringType,
- <contact:fax> (0..1) – change fax number as contact:e164StringType,
- <contact:email> (0..1) – change email as contact:emailCommaListType,
- <contact:authInfo> (0..1) – change authorization information (AuthInfo) as fredcom:authInfoType
- <contact:disclose> (0..1) – change contact information disclosure settings:
  
  @flag (R) – disclose flag as a xs:boolean: 0 – hide listed items, 1 – publish listed items,
  
  <contact:addr/> (0..1) – address disclosure setting (applies to all addresses) as an empty element,
  
  <contact:voice/> (0..1) – telephone disclosure setting as an empty element,
  
  <contact:fax/> (0..1) – fax disclosure setting as an empty element,
  
  <contact:email/> (0..1) – email disclosure setting as an empty element,
  
  <contact:vat/> (0..1) – VAT number disclosure setting as an empty element,
  
  <contact:ident/> (0..1) – identity document disclosure setting as an empty element,
  
  <contact:notifyEmail/> (0..1) – notification email disclosure setting as an empty element.
  
  Note
  
  Omitted items will be reset by the server according to its disclosure policy.
  
  Whether the new disclosure settings will have an effect, also depends on the server’s policy.
  
  If the whole <contact:disclose> element is omitted, it means no change of the disclosure preference.
  
  See also Policies & rules of disclosure, which contain examples of behaviour.
- <contact:vat> (0..1) – change VAT-payer identifier as a contact:vatT,
- <contact:ident> (0..1) – change identity-document identification:
  
  @type (R) – the type of the identity document as one of values: op (identity card number), passport (passport number), mpsv (number from the Ministry of Labour and Social Affairs), ico (company number), birthday (the date of birth),
  
  element content: an identification number as a contact:identValueT,
- <contact:notifyEmail> (0..1) – change notification email as contact:emailUpdCommaListType.

Example¶

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
   <command>
      <update>
         <contact:update xmlns:contact="http://www.nic.cz/xml/epp/contact-1.6"
          xsi:schemaLocation="http://www.nic.cz/xml/epp/contact-1.6 contact-1.6.6.xsd">
            <contact:id>CID-MYOWN</contact:id>
            <contact:chg>
               <contact:voice>+420.222333444</contact:voice>
               <contact:disclose flag="1">
                  <contact:voice/>
               </contact:disclose>
            </contact:chg>
         </contact:update>
      </update>
      <clTRID>rxzw005#17-07-18at12:03:30</clTRID>
   </command>
</epp>

FRED-client equivalent¶

> update_contact CID-MYOWN (() +420.222333444 NULL NULL NULL (y voice))

5.7.2.1.1. Mailing address extension¶

The <contact:update> element is used in the same way as described above.

The command extension can be used to set or remove the mailing address.

The command’s <extension> element must contain a single <extra-addr:update> element which declares the extra-addr namespace (http://www.nic.cz/xml/epp/extra-addr-1.0) and schema and contains:

<extra-addr:set> (0..1) – a new address will be set; if the contact already has a mailing address, it will be replaced:
- <extra-addr:mailing> (1) – mailing address container:
  
  <extra-addr:addr> (1) – address:
  
  <extra-addr:street> (1..3) – street line 1–3 as extra-addr:postalLineType,
  
  <extra-addr:city> (1) – city as extra-addr:postalLineType,
  
  <extra-addr:sp> (0..1) – state or province as extra-addr:postalLineType,
  
  <extra-addr:pc> (1) – postal code as extra-addr:pcType,
  
  <extra-addr:cc> (1) – country code as extra-addr:ccType,
<extra-addr:rem> (0..1) – an address will be removed from the contact:
- <extra-addr:mailing/> (1) – the mailing address must be specified as an empty element.

Important

Since FRED 2.48.0, server can be configured so that the AuthInfo must meet some basic requirements, such as minimum length (which can be configured).

[registry]
# Minimal length of authinfo
authinfo_length_min = 8

Calling update object with empty AuthInfo leads to removal of all object AuthInfos.

Example (set)¶

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
   <command>
      <update>
         <contact:update
          xmlns:contact="http://www.nic.cz/xml/epp/contact-1.6"
          xsi:schemaLocation="http://www.nic.cz/xml/epp/contact-1.6 contact-1.6.6.xsd">
            <contact:id>CID-EXTRAADDR</contact:id>
            <contact:chg>
               <contact:voice>+420.000000001</contact:voice>
               <contact:notifyEmail>foobar-notify@nic.cz</contact:notifyEmail>
            </contact:chg>
         </contact:update>
      </update>
      <extension>
         <extra-addr:update
          xmlns:extra-addr="http://www.nic.cz/xml/epp/extra-addr-1.0"
          xsi:schemaLocation="http://www.nic.cz/xml/epp/extra-addr-1.0 extra-addr-1.0.0.xsd">
            <extra-addr:set>
               <extra-addr:mailing>
                  <extra-addr:addr>
                     <extra-addr:street>Kratka 24</extra-addr:street>
                     <extra-addr:city>Praha</extra-addr:city>
                     <extra-addr:pc>11150</extra-addr:pc>
                     <extra-addr:cc>CZ</extra-addr:cc>
                  </extra-addr:addr>
               </extra-addr:mailing>
            </extra-addr:set>
         </extra-addr:update>
      </extension>
      <clTRID>zbab002#15-08-25at17:37:28</clTRID>
   </command>
</epp>

FRED-client equivalent (set)¶

> update_contact CID-EXTRAADDR (() +420.000000001 NULL NULL NULL () NULL () foobar-notify@nic.cz) ((('Kratka 24' Praha 11150 CZ)))

Example (remove)¶

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
   <command>
      <update>
         <contact:update xmlns:contact="http://www.nic.cz/xml/epp/contact-1.6"
          xsi:schemaLocation="http://www.nic.cz/xml/epp/contact-1.6 contact-1.6.6.xsd">
            <contact:id>CID-EXTRAADDR</contact:id>
            <contact:chg>
               <contact:voice>+420.000000001</contact:voice>
               <contact:notifyEmail>foobar-notify@nic.cz</contact:notifyEmail>
            </contact:chg>
         </contact:update>
      </update>
      <extension>
         <extra-addr:update
          xmlns:extra-addr="http://www.nic.cz/xml/epp/extra-addr-1.0"
          xsi:schemaLocation="http://www.nic.cz/xml/epp/extra-addr-1.0 extra-addr-1.0.0.xsd">
            <extra-addr:rem>
               <extra-addr:mailing/>
            </extra-addr:rem>
         </extra-addr:update>
      </extension>
      <clTRID>zbab002#15-08-25at17:37:28</clTRID>
   </command>
</epp>

FRED-client equivalent (remove)¶

> update_contact CID-EXTRAADDR (() +420.000000001 NULL NULL NULL () NULL () foobar-notify@nic.cz) (() mailing_addr)

5.7.2.2. Response element structure¶

The FRED EPP server responds with a plain result message which does not contain any response data (no <resData>).