.. include:: defs.hrst

.. index:: Period, startDate, endDate
.. _period:

Period
======

Schema
------

:startDate:
    string, :ref:`date`

    |ocdsDescription|
    The start date for the period.

:endDate:
    string, :ref:`date`

    |ocdsDescription|
    The end date for the period.

`startDate` should always precede `endDate`.


.. _ExtendPeriod:

ExtendPeriod
============

Scheme
------

:startDate:
    string, :ref:`date`

    |ocdsDescription|
    The start date for the period.

:endDate:
    string, :ref:`date`

    |ocdsDescription|
    The end date for the period.

:maxExtendDate:
    string, :ref:`date`

    |ocdsDescription|
    The period cannot be extended beyond this date.

:durationInDays:
    integer

    |ocdsDescription|
    The maximum duration of this period in days. Where a start and end date are given, this field is optional, and should reflect the difference between those two days.

:duration:
    string, :ref:`date`

    |ocdsDescription|
    The duration of the period reflected in ISO format.

`startDate` should always precede `endDate`.


.. _Date:

Date
====

Date/time in :ref:`date-format`.

.. index:: ContractValue, Value, Currency, VAT
.. _ContractValue:

ContractValue
=============

Schema
------

:amount:
    float, required

    |ocdsDescription|
    Amount as a number.

    Should be positive.

:amountNet:
    float

    |ocdsDescription|
    Amount as a number.

    Should be positive.

:currency:
    string, required

    |ocdsDescription|
    The currency in 3-letter ISO 4217 format.

:valueAddedTaxIncluded:
    bool, required

.. index:: Value, Currency, VAT
.. _value:

Value
=====

Schema
------

:amount:
    float, required

    |ocdsDescription|
    Amount as a number.

    Should be positive.

    Absent in :ref:`esco`

:currency:
    string, required

    |ocdsDescription|
    The currency in 3-letter ISO 4217 format.

:valueAddedTaxIncluded:
    bool, required

Additionally in :ref:`esco`:

:annualCostsReduction:
    21-element list of Floats, required.

    Buyer’s annual costs reduction. A 21-element array where the 1st element indicates cost reduction starting from the period of tender notice publication date till the end of the year. Value can be changed only during active tendering period (active.tendering).

:yearlyPaymentsPercentage:
    float, required

    The percentage of annual payments in favor of Bidder.

    Possible values:

    * from 0.8 to 1 (from 80% to 100% respectively) if fundingKind:other.
    * from 0 to x, where x can vary from 0 to 0.8 (from 0% to x% respectively) if fundingKind:budget.

    Input precision - 3 digits after comma.

:amountPerformance:
    float, autogenerated

    Calculated energy service contract performance indicator. Calculated by the energy service contract performance indicator energy service contract performance indicator formula.

:amount:
    float, autogenerated

    Calculated energy service contract value. Calculated by the energy service contract value formula.

:contractDuration:

    :ref:`ContractDuration <contact_duration>`, required.


.. _contact_duration:

ContractDuration
================

Schema
------

:years: integer, required

    Possible values: 0-15

:days:  integer, not required

    Possible values: 0-364

    Default value: 0

.. index:: Revision, Change Tracking
.. _revision:

Revision
========

Schema
------

:date:
    string, :ref:`date`

    Date when changes were recorded.

:changes:
    List of `Change` objects


.. _BasicValue:

BasicValue
==========

Schema
------

:amount:
    float, required

    |ocdsDescription|
    Amount as a number.

    Should be positive.

:currency:
    string, required, default = `UAH`

    |ocdsDescription|
    The currency in 3-letter ISO 4217 format.


.. _BankAccount:

BankAccount
=====================

Schema
------

:id:
    string, required

    The unique identifier for BankAccount.

:scheme:
    string, required

    Possible string values are:

     * `IBAN` - International Bank Account Number

.. _OrganizationReference:

OrganizationReference
=====================

Schema
------


:bankAccount:
    string, :ref:`BankAccount`, required

:name:
    string, required

    A name field that repeats the name given in the parties section, provided for the convenience of users viewing the data, and to support detection of mistakes in cross-referencing.


.. _Reference:

Reference
=========

Schema
------

:id:
    string, required

    An id used to cross-reference the entry in the parties section that contains full information on entity;

:title:
    string, required

    A title field that repeats the title given in the parties section, provided for the convenience of users viewing the data, and to support detection of mistakes in cross-referencing.


.. _LegislationItem:

LegislationItem
===============

Schema
------

:version:
    string

:identifier:
    :ref:`Identifier`

:type:
    string

    Possible values are:
     * `NATIONAL_LEGISLATION`

:article:
    string



.. _Change:

Change
======

Schema
------

:id:
    uid, auto-generated

    The identifier for this Change.

:rationale:
    string, multilingual, required

    Reason for contract change

:rationaleTypes:
    List of strings, required

    Type of the rationale behind contract change

    Changes to the contract can be made in cases described in the 4th part of Article 36 of the Law “On the Public Procurement”.

    Possible string values are:

    * `volumeCuts` - Reduction of the procurement’s volume

      reduction of the procurement’s volume, particularly taking into account the actual expenditures of the procuring entity;

    * `itemPriceVariation` - Change in the unit’s price

      change in the unit’s price (no more than 10%) due to product’s price fluctuations on the market, provided that the said change will not increase the sum of money specified in the contract;

    * `qualityImprovement` - Improvement of the procurement item’s quality

      improvement of the item's quality, provided that such improvement will not increase the sum of money specified in the contract;

    * `durationExtension` - Extension of the period of the contract duration (due to documented objective circumstances)

      extension of the period of the contract duration and obligations fulfilment regarding the transfer of goods, implementation of works and provision of services in case of documented objective circumstances that led to such extension, including force majeure, delays in funding of procuring entity’s  expenditures, provided that such changes will not increase the sum of money specified in the contract;

    * `priceReduction` - Coordinated price reduction

      coordinated downward price change (without changing the quantity (volume) and quality of goods, works, and services);

    * `taxRate` - Price changes due to changes in tax rates and fees

      price changes due to changes in tax rates and fees in proportion to changes of those rates;

    * `thirdParty` - Change of the third-party indicators (rate, indices...)

      changes of established under the law by the State Statistics Service consumer price index, changes in foreign currency, changes in stock prices or Platts indices, regulated prices (rates) and standards that are used in the procurement contract if the price change order is specified in the procurement contract;

    * `fiscalYearExtension` - Extension of the period of the contract duration to the next year

      changes in contract terms according to the provisions of part 5 of Article 36.

      Article 36 Part 5. Effect of the procurement contract may be continued for a period sufficient for conduction of the procurement procedure at the beginning of the next year in volume that does not exceed 20% of the sum specified in the contract concluded in the previous year, if expenditures for this purpose are approved in the prescribed manner.

:date:
    string, :ref:`date`, auto-generated

:dateSigned:
    string, :ref:`date`

:contractNumber:
    string

:status:
    string, required

    The current status of the change.

    Possible values are:

    * `pending` - this change has been added.

    * `active` - this change has been confirmed.

Workflow
--------

.. graphviz::

    digraph G {
        A [ label="pending*" ]
        B [ label="active"]
         A -> B;
    }

\* marks initial state


.. _CauseDetails:

CauseDetails
============

Scheme
------

:title:
    string, required for **negotiation** and **negotiation.quick** procedures.
    Also it is required for **reporting** procedure if field `procurementMethodRationale` is empty, `procuringEntity.kind` is not other and tender value amount is bigger than:

        * 100 000 for goods,
        * 200 000 for services,
        * 1 500 000 for works.

    Causes for using reporting, negotiation or negotiation.quick procedures.

    Possible values in `tender causes law 922 <https://github.com/ProzorroUKR/standards/blob/master/codelists/tender/tender_cause_law_922.json>`_
    and `tender causes decree 1178 <https://github.com/ProzorroUKR/standards/blob/master/codelists/tender/tender_cause_decree_1178.json>`_ dictionaries.


    Only in :ref:`limited`.

:scheme:
    string, required

    Type of tender cause schema.
    Possible values are:

    * `LAW922`
    * `DECREE1178`

:description:
    string, multilingual

    Reasoning behind usage of reporting, negotiation or negotiation.quick procedures.

    Only in :ref:`limited`