Общие сведения
При создании сервисов, интегрированных с прикладным решением 1С:Бухгалтерия, разработчики могут использовать механизм начального заполнения данных для передачи набора данных об организации сразу же после создания экземпляра приложения. Это позволяет пользователю интегрированного сервиса начать работу с приложением, уже заполненным ключевыми данными об организации.
В настоящий момент возможна передача следующих данных об организации:
- Организация
- Наименование
- ИНН
- КПП
- Юридический адрес
- Индивидуальный предприниматель
- ФИО
- ИНН
- Фактический адрес
- Вид деятельности
- Учетная политика
- Ответственные лица
- Сведения о расчетных счетах
Файл данных может быть передан в составе данных начального заполнения с помощью механизма Интеграция объектов, следующим образом:
- Файл с начальными данными должен быть упакован в zip-архив вместе с файлом манифеста manifest.json .
- В манифесте в качестве обработчика нужно указать значение base_data для данного файла.
Отправка файла данных
- Для отправки данных открывается сессия с помощью отправки запроса POST {{baseURL}}/integration/post
- Далее архив отправляется на адрес полученный в ответе первого запроса в заголовке Location.
Подробнее о процессе отправки данных в приложение 1С через механизм интеграции объектов описано соответствующем резделе.
После того как приложение 1С завершит получение данных об организации, будет предпринята попытка заполнения данных по ИНН с помощью сервиса 1С:Контрагент. При доступности данного сервиса будут заполнены данные об организации, включая коды налоговых органов, фондов, и другие данные, доступные в открытых источниках по этой организации. После этого создание организации в приложении 1С завершается, и пользователь может начинать работу с приложением.
Описание формата
Поля файла данных
Раздел \ Имя поля | Тип | Обязательно | Описание | Значение по умолчанию | Пример |
|---|---|---|---|---|---|
| organization | Раздел | Да | Данные организации | ||
| Строка | Да | Наименование организации | ООО Ромашка | |
| Строка(10) | Да | ИНН | 7725895602 | |
| Строка(9) | КПП | 772501001 | ||
| Строка | Юр. адрес | Москва г, Вавилова ул, дом № 1 | ||
| entrepreneur | Раздел | Да | Данные предпринимателя | ||
| Раздел | Да | ФИО | ||
| Строка | Да | Имя | Сергей | |
| Строка | Да | Фамилия | Шилов | |
| Строка | Отчество | Александрович | ||
| Строка(12) | Да | ИНН | 7725895602 | |
| Строка или Структура | Фактический адрес. Если указана строка, то будет предпринята попытка распознавания адреса. Если указана структура с данными ФИАС, то адрес будет заполнен по данным ФИАС. | |||
| Строка | Представление адреса. | 630090, Новосибирская область, город Новосибирск, улица Николаева, дом 12 | ||
| Строка | Идентификатор дома из ФИАС | 38a147d6-3b8e-4ad1-aa6f-7e8cd59640f2 | ||
| Строка | Описание помещения, например "квартира 9" или "офис 5". | офис 9409 | ||
| accounting_policy | Раздел | Учетная политика. Может быть не указана, тогда создается организация с налогообложением по умолчанию - УСН (доходы). Раздел настройки доступен только для стандартного интерфейса. | |||
| Перечисление | Система налогообложения. Может быть не указана, тогда используется система по умолчанию - УСН доходы. Возможные значения:
| usn_profit | usn_profit | |
| Булево | Признак, что ЕНВД совмещается с основной системой налогообложения. | false | false | |
| Булево | Признак, что патентная система налогообложения совмещается с основной системой налогобложения. Имеет смысл только для ИП. | false | false | |
| Булево | Признак, что организация уплачивает торговый сбор. | false | false | |
| Булево | Признак, что у ИП есть сотрудники и ему нужно оплачивать налоги на заработную плату. Имеет смысл только для ИП. | false | false | |
| responsible_persons | Раздел | Ответственные лица | |||
| Раздел | Генеральный директор | |||
| Раздел | ФИО | |||
| Строка | Имя | Сергей | ||
| Строка | Фамилия | Шилов | ||
| Строка | Отчество | Александрович | ||
| bank_accounts | Раздел[*] | Сведения о расчетных счетах. Может быть не указано. | |||
| Строка(9) | БИК банка, в котором открыт расчетный счет. | 044525225 | ||
| Строка(20) | Номер расчетного счета | 40802810900000003155 | ||
| Строка | Дата открытия счета в формате ISO | 2015-01-01T00:00:00 | ||
| Строка | Дата закрытия счета в формате ISO | 2019-01-01T00:00:00 | ||
| business_type | Строка | Вид деятельности Раздел настройки доступен только для стандартного интерфейса. Возможные значения:
Если не указан, то будет запрошен при входе в приложение при использовании стандартного интерфейса. | b2c_services | ||
enable_tax_payments | Булево | Признак того, что при интеграции с партнером доступно формирование платежных поручений для уплаты налогов и взносов в 1С. В противном случае, платежные поручения формируются на стороне партнера. | false | false | |
| enable_1c_report | Булево | Признак того, что при интеграции с партнером следует использовать 1С-Отчетность. В противном случае, используется ЭДО с контролирующими органами на стороне партнера. | false | true |
Возвращаемые коды ответов обработки данных
Код ответа | Описание |
|---|---|
| 10400 | Данные не обработаны из-за возникших ошибок:
|
| 10200 | Данные обработаны корректно. |
| 10240 | Данные обработаны, но в процессе обработки произошли не критичные ошибки:
|
| 10500 | Система налогообложения организации не подходит для включения простого интерфейса интеграции с банком. Другие внутренние ошибки. |
Особенности использования
Поведение системы в зависимости от доступности услуги "СтандартныйИнтерфейс"
Если пользователю не доступна услуга СтандартныйИнтерфейс, включается интерфейс приложения УСН 6% (упроценный интерфейс интеграции).
Если пользователю доступна услуга СтандартныйИнтерфейс:
- Независимо от системы налогообложения открывается интерфейс 1C:БизнесCтарт .
- Если вид деятельности не передается в начальных настройках, то при первом входе с интерфейсом 1C:БизнесCтарт открывается окно выбора вида деятельности.
Передача параметров при использовании простого интерфейса
При использовании простого интерфейса интеграции с банком нельзя передавать параметры:
- accounting_policy - учетная политика
- business_type - вид деятельности
Примеры файлов данных
Пример содержимого файла
{
"organization": {
"name": "ООО Хомяк",
"inn": "5408305181",
"kpp": "540801001",
"address": {
"representation": "630090, Новосибирская область, город Новосибирск, улица Николаева, дом 12",
"house_id": "38a147d6-3b8e-4ad1-aa6f-7e8cd59640f2",
"room": "офис 9409"
}
},
"accounting_policy": {
"tax_system": "usn_profit",
"envd": false,
"sales_tax": false
},
"responsible_persons": {
"director": {
"name": {
"first_name": "Виктор",
"second_name": "Агафонов",
"patronymic": "Леонидович"
}
}
},
"bank_accounts": [
{
"bank": "044525555",
"account": "40702810030050064519",
"opening_date": "2015-01-01T00:00:00"
},
{
"bank": "044525555",
"account": "40702810030050045198",
"opening_date": "2015-01-01T00:00:00"
}
],
"business_type": b2c_services
}
Пример настроек для простого интерфейса интеграции
{
"entrepreneur": {
"name": {
"first_name": "Петр",
"second_name": "Иванов",
"patronymic": "Георгиевич"
},
"inn": "100201900239",
"address": {
"representation": "630090, Новосибирская область, город Новосибирск, улица Николаева, дом 12",
"house_id": "38a147d6-3b8e-4ad1-aa6f-7e8cd59640f2",
"room": "офис 9409"
}
},
"bank_accounts": [
{
"bank": "044525555",
"account": "40702810030050064519",
"opening_date": "2015-01-01T00:00:00"
}
],
"enable_tax_payments": false
}