API - Организации » История » Редакция 8
Редакция 7 (Александр Кварацхелия, 18.04.2014 16:14) → Редакция 8/9 (Александр Кварацхелия, 06.11.2014 16:09)
h1. API - Организации
{{toc}}
h2. Перечисления
h3. Тип организации
* 1 - Юридическое лицо (ООО, ЗАО, ОАО и проч.)
* 2 - Физическое лицо (Индивидуальные предприниматели)
h3. Тип банковского счета
* 1 - Расчетный счет
* 2 - Депозитный счет
* 3 - Прочий банковский счет
h2. Ресурс: Организация
Все операции в рамках ресурса "Организация" требуют [[API#Аутентификация-внешнего-приложения|аутентификации]].
*Операция*: Получение списка организаций в аккаунте
*Аутентификация*: Да
*URL*: https://nebopro.ru/core/company-profile/list
*Тип запроса*: "GET"
*Параметры*: нет
*Ответ*: Массив со списком организаций в текущем аккаунте пользователя
<pre>
Пример ответа для двух организаций в аккаунте:
<code class="json">
{
"data": [{
"pfr_number": "",
"fullname": "akvarats@nebopro.ru",
"uid": "0b99755d-53ee-447e-8f77-3379b42d6562",
"manager_job_title": "",
"pfr_code": "",
"fax": "",
"ogrn": "",
"okpo": "",
"phone": "",
"fss_name": "",
"cashier_fio": "",
"manager_fio": "",
"oktmo": "",
"okved": "",
"filial": "",
"id": 668,
"inn": "0000000000",
"entity_form": {
"id": 1,
"name": "\u042e\u0440\u0438\u0434\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043b\u0438\u0446\u043e"
},
"kpp": "000000000",
"okato": "",
"chief_accountant_job_title": "",
"fss_number": "",
"name": "akvarats@nebopro.ru",
"fss_code": "",
"chief_accountant_fio": "",
"inc_form": 99,
"pfr_name": "",
"ifns_code": "1633",
"shortname": "akvarats@nebopro.ru",
"tfoms": "",
"email": ""
}, {
"pfr_number": "000000000000",
"fullname": "\u041a\u043e\u043c\u043f\u0430\u043d\u0438\u044f \u0438\u0437 47 \u0440\u0435\u0433\u0438\u043e\u043d\u0430",
"uid": "482a9466-a0eb-4e23-abba-8ec3d624a3d3",
"manager_job_title": "\u0414\u0438\u0440\u0435\u043a\u0442\u043e\u0440",
"pfr_code": "000000",
"fax": "",
"ogrn": "0000000000000",
"okpo": "0000000000",
"phone": "(812) 555 22 33",
"fss_name": "",
"cashier_fio": "",
"manager_fio": "\u0418\u0432\u0430\u043d\u043e\u0432 \u0418.\u0418.",
"oktmo": "00000000000",
"okved": "01.11.5",
"filial": "",
"id": 9148,
"inn": "0000000000",
"entity_form": {
"id": 1,
"name": "\u042e\u0440\u0438\u0434\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043b\u0438\u0446\u043e"
},
"kpp": "000000000",
"okato": "00000000000",
"chief_accountant_job_title": "\u0414\u0438\u0440\u0435\u043a\u0442\u043e\u0440",
"fss_number": "0000000000",
"name": "\u041a\u043e\u043c\u043f\u0430\u043d\u0438\u044f \u0438\u0437 47 \u0440\u0435\u0433\u0438\u043e\u043d\u0430",
"fss_code": "",
"chief_accountant_fio": "\u041f\u0435\u0442\u0440\u043e\u0432 \u041f.\u041f.",
"inc_form": 99,
"pfr_name": "000000000000000000000000",
"ifns_code": "4712",
"shortname": "\u041a\u043e\u043c\u043f\u0430\u043d\u0438\u044f \u0438\u0437 47 \u0440\u0435\u0433\u0438\u043e\u043d\u0430",
"tfoms": "000000000000000",
"email": ""
}],
"success": true
}
</code>
</pre>
h2. Ресурс: Банковский счет организации
Доступ через основной интерфейс Неба: "Моя организация" > "Реквизиты", вкладка "Банковские счета".
Все операции в рамках ресурса "Банковский счет организации" требуют [[API#Аутентификация-внешнего-приложения|аутентификации]] и [[API#Рабочая-организация|установки рабочей организации]].
h3. Модель банковского счета организации
<pre>
<code class="json">
{
"id": 1234,
"type": {
"id": 1,
"name": "Расчетный счет"
},
"schet": "40702810400000007734",
"kschet": "30101810200000000593",
"bank_name": "ОАО \"АЛЬФА-БАНК\"",
"bik": "044525593",
"bank_city": "г. МОСКВА",
"bank_address": "УЛ.КАЛАНЧЕВСКАЯ,27",
"bank_phone": "(495)9742515,7555830",
"is_master": true
}
</code>
</pre>
* @type@ - значение перечисления [[API_-_Организации#Тип-банковского-счета|Тип банковского счета]] (обязательно);
* @rschet@ - номер счета (20 символов, обязательно)
* @kschet@ - номер корреспондирующего счета (20 символов, обязательно)
* @bank_name@ - наименование банка (макс. 100 символов, обязательно)
* @bik@ - БИК (9 символов, обязательно)
* @bank_city@ - город, в котором располагается банк (необязательно)
* @bank_address@ - адрес банка
* @bank_phone@ - контактный телефон банка
* @is_master@ - признак того, что это основной банковский счет организации (true/false)
h3. Операции
*name*: Получение списка банковских счетов (LIST)
*desc*: Возвращает список банковских счетов текущей рабочей организации
*URL*:
*url*: /core/company-bank-accounts/list
*Параметры*: *params*: Стандартные параметры операции [[API#Операция-LIST|LIST]]
h3. *name*: Получение данных банковского счета
*desc*: Возвращает модель банковского счета по указанному идентификатору
*URL*:
*url*: /core/company-bank-accounts/read
*Параметры*: *params*: @id@ - идентификатор банковского счета
Операции create, update, delete выполняются [[API#Операция-CREATE|стандартным способом]] (записи идентифицируются значением @id@). При создании и изменении данных банковского счета организации проверяется корректность указания реквизитов счетов согласно "данному алгоритму":http://base.consultant.ru/cons/cgi/online.cgi?req=doc;base=LAW;n=16053;fld=134;dst=4294967295.
{{toc}}
h2. Перечисления
h3. Тип организации
* 1 - Юридическое лицо (ООО, ЗАО, ОАО и проч.)
* 2 - Физическое лицо (Индивидуальные предприниматели)
h3. Тип банковского счета
* 1 - Расчетный счет
* 2 - Депозитный счет
* 3 - Прочий банковский счет
h2. Ресурс: Организация
Все операции в рамках ресурса "Организация" требуют [[API#Аутентификация-внешнего-приложения|аутентификации]].
*Операция*: Получение списка организаций в аккаунте
*Аутентификация*: Да
*URL*: https://nebopro.ru/core/company-profile/list
*Тип запроса*: "GET"
*Параметры*: нет
*Ответ*: Массив со списком организаций в текущем аккаунте пользователя
<pre>
Пример ответа для двух организаций в аккаунте:
<code class="json">
{
"data": [{
"pfr_number": "",
"fullname": "akvarats@nebopro.ru",
"uid": "0b99755d-53ee-447e-8f77-3379b42d6562",
"manager_job_title": "",
"pfr_code": "",
"fax": "",
"ogrn": "",
"okpo": "",
"phone": "",
"fss_name": "",
"cashier_fio": "",
"manager_fio": "",
"oktmo": "",
"okved": "",
"filial": "",
"id": 668,
"inn": "0000000000",
"entity_form": {
"id": 1,
"name": "\u042e\u0440\u0438\u0434\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043b\u0438\u0446\u043e"
},
"kpp": "000000000",
"okato": "",
"chief_accountant_job_title": "",
"fss_number": "",
"name": "akvarats@nebopro.ru",
"fss_code": "",
"chief_accountant_fio": "",
"inc_form": 99,
"pfr_name": "",
"ifns_code": "1633",
"shortname": "akvarats@nebopro.ru",
"tfoms": "",
"email": ""
}, {
"pfr_number": "000000000000",
"fullname": "\u041a\u043e\u043c\u043f\u0430\u043d\u0438\u044f \u0438\u0437 47 \u0440\u0435\u0433\u0438\u043e\u043d\u0430",
"uid": "482a9466-a0eb-4e23-abba-8ec3d624a3d3",
"manager_job_title": "\u0414\u0438\u0440\u0435\u043a\u0442\u043e\u0440",
"pfr_code": "000000",
"fax": "",
"ogrn": "0000000000000",
"okpo": "0000000000",
"phone": "(812) 555 22 33",
"fss_name": "",
"cashier_fio": "",
"manager_fio": "\u0418\u0432\u0430\u043d\u043e\u0432 \u0418.\u0418.",
"oktmo": "00000000000",
"okved": "01.11.5",
"filial": "",
"id": 9148,
"inn": "0000000000",
"entity_form": {
"id": 1,
"name": "\u042e\u0440\u0438\u0434\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043b\u0438\u0446\u043e"
},
"kpp": "000000000",
"okato": "00000000000",
"chief_accountant_job_title": "\u0414\u0438\u0440\u0435\u043a\u0442\u043e\u0440",
"fss_number": "0000000000",
"name": "\u041a\u043e\u043c\u043f\u0430\u043d\u0438\u044f \u0438\u0437 47 \u0440\u0435\u0433\u0438\u043e\u043d\u0430",
"fss_code": "",
"chief_accountant_fio": "\u041f\u0435\u0442\u0440\u043e\u0432 \u041f.\u041f.",
"inc_form": 99,
"pfr_name": "000000000000000000000000",
"ifns_code": "4712",
"shortname": "\u041a\u043e\u043c\u043f\u0430\u043d\u0438\u044f \u0438\u0437 47 \u0440\u0435\u0433\u0438\u043e\u043d\u0430",
"tfoms": "000000000000000",
"email": ""
}],
"success": true
}
</code>
</pre>
h2. Ресурс: Банковский счет организации
Доступ через основной интерфейс Неба: "Моя организация" > "Реквизиты", вкладка "Банковские счета".
Все операции в рамках ресурса "Банковский счет организации" требуют [[API#Аутентификация-внешнего-приложения|аутентификации]] и [[API#Рабочая-организация|установки рабочей организации]].
h3. Модель банковского счета организации
<pre>
<code class="json">
{
"id": 1234,
"type": {
"id": 1,
"name": "Расчетный счет"
},
"schet": "40702810400000007734",
"kschet": "30101810200000000593",
"bank_name": "ОАО \"АЛЬФА-БАНК\"",
"bik": "044525593",
"bank_city": "г. МОСКВА",
"bank_address": "УЛ.КАЛАНЧЕВСКАЯ,27",
"bank_phone": "(495)9742515,7555830",
"is_master": true
}
</code>
</pre>
* @type@ - значение перечисления [[API_-_Организации#Тип-банковского-счета|Тип банковского счета]] (обязательно);
* @rschet@ - номер счета (20 символов, обязательно)
* @kschet@ - номер корреспондирующего счета (20 символов, обязательно)
* @bank_name@ - наименование банка (макс. 100 символов, обязательно)
* @bik@ - БИК (9 символов, обязательно)
* @bank_city@ - город, в котором располагается банк (необязательно)
* @bank_address@ - адрес банка
* @bank_phone@ - контактный телефон банка
* @is_master@ - признак того, что это основной банковский счет организации (true/false)
h3. Операции
*name*: Получение списка банковских счетов (LIST)
*desc*: Возвращает список банковских счетов текущей рабочей организации
*URL*:
*url*: /core/company-bank-accounts/list
*Параметры*: *params*: Стандартные параметры операции [[API#Операция-LIST|LIST]]
h3. *name*: Получение данных банковского счета
*desc*: Возвращает модель банковского счета по указанному идентификатору
*URL*:
*url*: /core/company-bank-accounts/read
*Параметры*: *params*: @id@ - идентификатор банковского счета
Операции create, update, delete выполняются [[API#Операция-CREATE|стандартным способом]] (записи идентифицируются значением @id@). При создании и изменении данных банковского счета организации проверяется корректность указания реквизитов счетов согласно "данному алгоритму":http://base.consultant.ru/cons/cgi/online.cgi?req=doc;base=LAW;n=16053;fld=134;dst=4294967295.