Общие сведения

При создании сервисов, интегрированных с прикладным решением 1С:Бухгалтерия, разработчики могут использовать механизм начального заполнения данных для передачи набора данных об организации сразу же после создания экземпляра приложения. Это позволяет пользователю интегрированного сервиса начать работу с приложением, уже заполненным ключевыми данными об организации.

В настоящий момент возможна передача следующих данных об организации:

  • Организация
    • Наименование
    • ИНН
    • КПП
    • Юридический адрес
  • Индивидуальный предприниматель
    • ФИО
    • ИНН
  • Фактический адрес
  • Вид деятельности
  • Учетная политика
  • Ответственные лица
  • Сведения о расчетных счетах

Файл данных может быть передан в составе данных начального заполнения с помощью механизма Интеграция объектов, следующим образом:

  • Файл с начальными данными должен быть упакован в zip-архив вместе с файлом манифеста  manifest.json .
  • В манифесте в качестве обработчика нужно указать значение  base_data  для данного файла.

Отправка файла данных

  • Для отправки данных открывается сессия с помощью отправки запроса POST {{baseURL}}/integration/post
  • Далее архив отправляется на адрес полученный в ответе первого запроса в заголовке Location. 

Подробнее о процессе отправки данных в приложение 1С через механизм интеграции объектов описано соответствующем резделе.

После того как приложение 1С завершит получение данных об организации, будет предпринята попытка заполнения данных по ИНН с помощью сервиса 1С:Контрагент. При доступности данного сервиса будут заполнены данные об организации, включая коды налоговых органов, фондов, и другие данные, доступные в открытых источниках по этой организации. После этого создание организации в приложении 1С завершается, и пользователь может начинать работу с приложением.

Описание формата

Поля файла данных

Раздел \ Имя поля

Тип

Обязательно

Описание

Значение по умолчанию

Пример

organizationРазделДа

Данные организации



  • name
СтрокаДаНаименование организации
ООО Ромашка
  • inn
Строка(10)ДаИНН
7725895602
  • kpp
Строка(9)
КПП
772501001
  • address
Строка

Юр. адрес


Москва г, Вавилова ул, дом № 1
entrepreneurРазделДаДанные предпринимателя

  • name
РазделДаФИО

    • first_name
СтрокаДаИмя
Сергей
    • second_name
СтрокаДаФамилия
Шилов
    • patronymic
Строка
Отчество
Александрович
  • inn
Строка(12)ДаИНН
7725895602
  • address
Строка или Структура
Фактический адрес. Если указана строка, то будет предпринята попытка распознавания адреса. Если указана структура с данными ФИАС, то адрес будет заполнен по данным ФИАС.

    • representation
Строка
Представление адреса.
630090, Новосибирская область, город Новосибирск, улица Николаева, дом 12
    • house_id
Строка
Идентификатор дома из ФИАС
38a147d6-3b8e-4ad1-aa6f-7e8cd59640f2
    • room
Строка
Описание помещения, например "квартира 9" или "офис 5".
офис 9409
accounting_policyРаздел

Учетная политика. Может быть не указана, тогда создается организация с налогообложением по умолчанию - УСН (доходы).

Раздел настройки доступен только для стандартного интерфейса.




  • tax_system
Перечисление

Система налогообложения. Может быть не указана, тогда используется система по умолчанию - УСН доходы.

Возможные значения:

  • usn_profit - УСН 6% (доходы)
  • usn - УСН 15%  (доходы-расходы)
  • patent - только патентная система (только для ИП)
  • envd - только ЕНВД
  • common - общая система налогообложения
usn_profitusn_profit
  • envd
Булево
Признак, что ЕНВД совмещается с основной системой налогообложения.falsefalse
  • patent
Булево
Признак, что патентная система налогообложения совмещается с основной системой налогобложения. Имеет смысл только для ИП.falsefalse
  • sales_tax
Булево
Признак, что организация уплачивает торговый сбор.falsefalse
  • have_staff
Булево
Признак, что у ИП есть сотрудники и ему нужно оплачивать налоги на заработную плату. Имеет смысл только для ИП.falsefalse
responsible_personsРаздел
Ответственные лица

  • director
Раздел
Генеральный директор

    • name
Раздел
ФИО

      • first_name
Строка
Имя
Сергей
      • second_name
Строка
Фамилия
Шилов
      • patronymic
Строка
Отчество
Александрович
bank_accountsРаздел[*]
Сведения о расчетных счетах. Может быть не указано.


  • bank
Строка(9)
БИК банка, в котором открыт расчетный счет.
044525225
  • account
Строка(20)
Номер расчетного счета
40802810900000003155
  • opening_date
Строка
Дата открытия счета в формате ISO
2015-01-01T00:00:00
  • closing_date
Строка
Дата закрытия счета в формате ISO
2019-01-01T00:00:00
business_typeСтрока

Вид деятельности

Раздел настройки доступен только для стандартного интерфейса.

Возможные значения:

  • commission_agent_services- агентские услуги
  • wholesale - оптовая торговля
  • b2b_services - услуги организациям
  • manufacturing - производство
  • retail_store - розничный магазин
  • b2c_services - услуги населению
  • logistics_and_transportation- транспорт и логистика
  • online_store - интернет-магазин
  • construction_and_repair - строительство и ремонт
  • catering - ресторан, кафе, столовая
  • education - обучение
  • agriculture - сельское хозяйство
  • default - другое

Если не указан, то будет запрошен при входе в приложение при использовании стандартного интерфейса.


b2c_services

enable_tax_payments 

Булево 


Признак того, что при интеграции с партнером доступно формирование платежных поручений для уплаты налогов и взносов в 1С. В противном случае, платежные поручения формируются на стороне партнера.

falsefalse
enable_1c_reportБулево
Признак того, что при интеграции с партнером следует использовать 1С-Отчетность. В противном случае, используется ЭДО с контролирующими органами на стороне партнера.falsetrue

Возвращаемые коды ответов обработки данных

Код ответа

Описание

10400

Данные не обработаны из-за возникших ошибок:

  • В структуре JSON отсутствует обязательная структура organization или entrepreneur
  • В структуре JSON присутствуют взаимоисключающие структуры organization и entrepreneur
  • Для организации:
    • В структуре organization отсутствует обязательное поле inn
    • Длина поля organization.inn должна равняться 10 символам
    • В структуре organization для юридического лица отсутствует обязательное поле kpp
    • Длина поля organization.kpp должна равняться 9 символам
    • В структуре organization отсутствует обязательное поле name
  • Для предпринимателя:
    • В структуре entrepreneur отсутствует обязательное поле inn
    • Длина поля entrepreneur.inn должна равняться 12 символам
    • В структуре entrepreneur отсутствует обязательная структура name
    • В структуре entrepreneur.name отсутствует обязательная структура second_name
    • В структуре entrepreneur.name отсутствует обязательная структура first_name
    • В структуре entrepreneur.name отсутствует обязательная структура patronymic
  • Ошибки при недоступности стандартного интерфейса:
    • Недоступен стандартный интерфейс. В интерфейсе интеграции с банком нельзя вести учет юридического лица.
    • Недоступен стандартный интерфейс. Поле accounting_policy должно отсутствовать.
    • Недоступен стандартный интерфейс. Поле business_type должно отсутствовать.
  • Другие прикладные ошибки.
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
}