.. include:: defs.hrst

.. _Party:

Party
=====

Schema
------

:name:
    string

    |ocdsDescription|
    A common name for this organization or other participant in the contracting process. The identifier object provides an space for the formal legal name, and so this may either repeat that value, or could provide the common name by which this organization or entity is known. This field may also include details of the department or sub-unit involved in this contracting process.
    
:identifier:
    :ref:`Identifier`
    
    |ocdsDescription|
    The primary identifier for this organization or participant. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.
    
:additionalIdentifiers:
    List of :ref:`identifier` objects

:address:
    :ref:`Address`, required

:contactPoint:
    :ref:`ContactPoint`, required

:roles:
    List of strings

    |ocdsDescription|
    The party’s role(s) in the contracting process.

    Possible values are:

        * sas
        * risk_indicator (this value used for old monitorings)

:datePublished:
   string, :ref:`date`, autogenerated

.. _Identifier:

Identifier
==========

Schema
------

:scheme:
   string

   |ocdsDescription|
   Organization identifiers be drawn from an existing identification scheme. 
   This field is used to indicate the scheme or codelist in which the
   identifier will be found.  This value should be drawn from the
   Organization Identifier Scheme.

:id:
   string, required
   
   |ocdsDescription| The identifier of the organization in the selected
   scheme.

   The allowed codes are the ones found in `"Organisation Registration Agency"
   codelist of IATI
   Standard <http://iatistandard.org/codelists/OrganisationRegistrationAgency/>`_
   with addition of `UA-EDR` code for organizations registered in Ukraine
   (EDRPOU and IPN).

:legalName:
   string, multilingual

   |ocdsDescription|
   The legally registered name of the organization.

:uri:
   uri

   |ocdsDescription|
   A URI to identify the organization, such as those provided by Open
   Corporates or some other relevant URI provider.  This is not for listing
   the website of the organization: that can be done through the url field
   of the Organization contact point.


.. _Address:

Address
=======

Schema
------

:streetAddress:
    string, required
    
    |ocdsDescription|
    The street address. For example, 1600 Amphitheatre Pkwy.
    
:locality:
    string, required
    
    |ocdsDescription|
    The locality. For example, Mountain View.
    
:region:
    string, required
    
    |ocdsDescription|
    The region. For example, CA.
    
:postalCode:
    string, required
    
    |ocdsDescription|
    The postal code. For example, 94043.
    
:countryName:
    string, multilingual, required
    
    |ocdsDescription|
    The country name. For example, United States.


.. index:: Person, Phone, Email, Website, ContactPoint

.. _ContactPoint:

ContactPoint
============

Schema
------

:name:
    string, multilingual, required
    
    |ocdsDescription|
    The name of the contact person, department, or contact point, for correspondence relating to this contracting process.
    
:email:
    email
    
    |ocdsDescription|
    The e-mail address of the contact point/person.
    
:telephone:
    string
    
    |ocdsDescription|
    The telephone number of the contact point/person. This should include the international dialling code.
    
:faxNumber:
    string
    
    |ocdsDescription|
    The fax number of the contact point/person. This should include the international dialling code.
    
:url:
    url
    
    |ocdsDescription|
    A web address for the contact point/person.

:availableLanguage:
    string
    
    Possible values are:

    * `uk`
    * `en`
    * `ru`

    Specifies the language of communication. 

Either `email` or `telephone` field has to be provided.