Общие сведения
При создании сервисов, интегрированных с прикладным решением 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 }