comment fix, add sdk

- исправлены комментарии в контрактах - добавлено sdk - определено qualified_for_work_with
Tinkoff · May 16, 2022 · 3c8beff · 3c8beff
1 parent eea3554
commit 3c8beff
Show file tree

Hide file tree

Showing 4 changed files with 25 additions and 4 deletions.
diff --git a/README.md b/README.md
@@ -64,6 +64,7 @@ API реализован на быстром, удобном и функцион
 * [php YII2](https://packagist.org/packages/metaseller/tinkoff-invest-api-v2-yii2)
 * [swift](https://github.com/JohnReeze/TinkoffInvestSwiftSDK)
 * [rust](https://github.com/ovr/tinkoff-invest-rust)
+* [c++](https://github.com/samoilovv/TinkoffInvestSDK)
 
 SDK на других языках в процессе разработки.
 

diff --git a/src/docs/contracts/operations.proto b/src/docs/contracts/operations.proto
@@ -56,7 +56,7 @@ message Operation {
   MoneyValue payment = 4; //Сумма операции.
   MoneyValue price = 5; //Цена операции за 1 инструмент. Для получения стоимости лота требуется умножить на лотность инструмента.
   OperationState state = 6; //Статус операции.
-  int64 quantity = 7; //Количество лотов инструмента.
+  int64 quantity = 7; //Количество единиц инструмента.
   int64 quantity_rest = 8; //Неисполненный остаток по сделке.
   string figi = 9; //Figi-идентификатор инструмента, связанного с операцией.
   string instrument_type = 10;  //Тип инструмента. Возможные значения: </br>**bond** — облигация; </br>**share** — акция; </br>**currency** — валюта; </br>**etf** — фонд; </br>**futures** — фьючерс.
@@ -122,7 +122,7 @@ message PortfolioPosition {
   string instrument_type = 2; //Тип инструмента.
   Quotation quantity = 3; //Количество инструмента в портфеле в штуках.
   MoneyValue average_position_price = 4; //Средневзвешенная цена позиции. **Возможна задержка до секунды для пересчёта**.
-  Quotation expected_yield = 5; //Текущая рассчитанная относительная доходность позиции.
+  Quotation expected_yield = 5; //Текущая рассчитанная доходность позиции.
   MoneyValue current_nkd = 6; // Текущий НКД.
   Quotation average_position_price_pt = 7; //Средняя цена лота в позиции в пунктах (для фьючерсов). **Возможна задержка до секунды для пересчёта**.
   MoneyValue current_price = 8; //Текущая цена за 1 инструмент. Для получения стоимости лота требуется умножить на лотность инструмента..
@@ -236,7 +236,7 @@ enum OperationType {
   OPERATION_TYPE_MARGIN_FEE = 14; //Удержание комиссии за непокрытую позицию.
   OPERATION_TYPE_BUY = 15; //Покупка ЦБ.
   OPERATION_TYPE_BUY_CARD = 16; //Покупка ЦБ с карты.
-  OPERATION_TYPE_INPUT_SECURITIES = 17; //Завод ценных бумаг из другого депозитария.
+  OPERATION_TYPE_INPUT_SECURITIES = 17; //Перевод ценных бумаг из другого депозитария.
   OPERATION_TYPE_SELL_MARGIN = 18; //Продажа в результате Margin-call.
   OPERATION_TYPE_BROKER_FEE = 19; //Удержание комиссии за операцию.
   OPERATION_TYPE_BUY_MARGIN = 20; //Покупка в результате Margin-call.

diff --git a/src/docs/contracts/users.proto b/src/docs/contracts/users.proto
@@ -134,7 +134,7 @@ message GetInfoRequest {
 message GetInfoResponse {
   bool prem_status = 1; //Признак премиум клиента.
   bool qual_status = 2; //Признак квалифицированного инвестора.
-  repeated string qualified_for_work_with = 3; //Набор требующих тестирования инструментов и возможностей, с которыми может работать пользователь.
+  repeated string qualified_for_work_with = 3; //Набор требующих тестирования инструментов и возможностей, с которыми может работать пользователь. [Подробнее](https://tinkoff.github.io/investAPI/faq_users/).
   string tariff = 4; //Наименование тарифа пользователя.
 }
 

diff --git a/src/docs/faq_users.md b/src/docs/faq_users.md
@@ -3,3 +3,23 @@
 Обычно новый счёт становится доступен для работы через TINKOFF INVEST API в течении часа после открытия. 
 В редких случаях эта задержка может составлять до двух часов.
 
+###Какие есть варианты значения поля qualified_for_work_with
+
+Поле qualified_for_work_with определяет, какие типы тестов пройдены клиентом в мобильном приложении, возможные варианты:
+
+По типам инструментов:
+
+* derivative - Фьючерсы и опционы
+* structured_bonds - Структурные облигации
+* closed_fund - Закрытые паевые фонды 
+* bond - Облигации с низким рейтингом 
+* structured_income_bonds - Облигации со структурным доходом
+* foreign_shares - Иностранные акции, не включенных в котировальные списки биржи
+* foreign_etf - Иностранные ETF
+* foreign_bond - Еврооблигации
+* russian_shares - Акции, не включенные в котировальные списки
+
+По типам сделок:
+
+* leverage - Маржинальная торговля, необеспеченные сделки на заемные средства
+* repo - Договора репо