Contact Create Command
======================

This command follows standard EPP Contact mapping `RFC-5733`_ with some restrictions
and a simple extension for private and legal persons which are residents of Latvia.

.. note::

  It would be preferable to avoid creating multiple EPP contact objects which describe one
  and the same person or legal entity (especially, if it is used as a registrant for domain names)
  if the contact information stays the same.

.. note::
  Element <contact:fax> is being ignored and fax cannot be set

Client request
--------------

* Creates legal person (because ``<contact:org>`` element is present) registered in Latvia:

.. code-block:: xml

    <?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>
        <create>
          <contact:create
           xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
           xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 contact-1.0.xsd">
            <contact:id>josh-12647</contact:id>
            <contact:postalInfo type="loc">
              <contact:name>James Black</contact:name>
              <contact:org>"Shark 'n' Hammer, SIA"</contact:org>
              <contact:addr>
                <contact:street>Neverending st.1111</contact:street>
                <contact:city>Rīga</contact:city>

                <contact:pc>LV-2000</contact:pc>
                <contact:cc>LV</contact:cc>
              </contact:addr>
            </contact:postalInfo>
            <contact:voice x=''>+371.12345678</contact:voice>
            <contact:fax x=''>+371.87654321</contact:fax>
            <contact:email>ghepardhus@snailmail.lv</contact:email>
            <contact:authInfo>
              <contact:pw>g34gzgh</contact:pw>
            </contact:authInfo>
          </contact:create>
        </create>

        <extension>
          <lvcontact:create xmlns:lvcontact='http://www.nic.lv/epp/schema/lvcontact-ext-1.0'>
            <lvcontact:vatNr>LV12345678901</lvcontact:vatNr>
            <lvcontact:regNr>12345678901</lvcontact:regNr>
          </lvcontact:create>
        </extension>
        <clTRID>nypjBNmRCbUVGjWnrvhe</clTRID>
      </command>
    </epp>

* Creates Latvian private person (no ``<contact:org>`` element and ``<lvcontact:regnr>``
  contains Latvian person code)

.. code-block:: xml

    <?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>
        <create>
          <contact:create
           xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
           xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 contact-1.0.xsd">
            <contact:id>memy-981234</contact:id>
            <contact:postalInfo type="loc">
              <contact:name>Me Myself</contact:name>
              <contact:addr>
                <contact:street>Gurķu 22</contact:street>
                <contact:city>Dobele</contact:city>

                <contact:pc>LV-3019</contact:pc>
                <contact:cc>LV</contact:cc>
              </contact:addr>
            </contact:postalInfo>
            <contact:voice x=''>+371.12345678</contact:voice>
            <contact:email>writetomeslowly@snailmail.lv</contact:email>
            <contact:authInfo>
              <contact:pw>zZzZzziIi</contact:pw>
            </contact:authInfo>
          </contact:create>
        </create>

        <extension>
          <lvcontact:create xmlns:lvcontact='http://www.nic.lv/epp/schema/lvcontact-ext-1.0'>
            <lvcontact:regNr>040383-10940</lvcontact:regNr>
          </lvcontact:create>
        </extension>
        <clTRID>nypjBNmRCbUVGjWnrvhe</clTRID>
      </command>
    </epp>

Server response
---------------

* Example response:

.. code-block:: xml

    <?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">
      <response>
        <result code="1000">
          <msg lang="en">Command completed successfully</msg>
        </result>
        <resData>
          <contact:creData xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0 contact-1.0.xsd">
            <contact:id>memy-981234</contact:id>
            <contact:crDate>2011-11-15T16:01:28+02:00</contact:crDate>
          </contact:creData>
        </resData>
        <trID>
          <clTRID>nypjBNmRCbUVGjWnrvhe</clTRID>
          <svTRID>testregistrar-20111115-45baf1a7553cd8b9185c4af2462d3da6-5</svTRID>
        </trID>
      </response>
    </epp>

.. *** include external reference links: ***
.. include:: /ref_links.rst