Внешняя обработка предназначена для массового получения сведений о контрагентах по списку ИНН и создания отсутствующих элементов справочника «Контрагенты».
Для получения реквизитов используется штатный сервис «1С:Контрагент». Подключение к сторонним сервисам и хранение дополнительных API-ключей не требуется.
Обработка разработана для конфигурации:
- 1С:Бухгалтерия предприятия, редакция 3.0;
- проверено на релизе 3.0.202.14;
- управляемое приложение.
Назначение обработки
Обработка позволяет быстро создать карточки контрагентов по большому списку ИНН без необходимости вручную открывать справочник и нажимать кнопку заполнения для каждого контрагента.
Пользователь вставляет список ИНН в многострочное поле формы, переносит его в таблицу (кнопкой "Заполнить список") и запускает загрузку сведений.
Для каждого ИНН обработка:
- Проверяет формат и контрольные цифры ИНН.
- Проверяет наличие ИНН в текущем списке.
- Выполняет поиск контрагента в информационной базе.
- Если контрагент уже существует, повторный элемент не создаётся.
- Если контрагент отсутствует, сведения запрашиваются через сервис «1С:Контрагент».
- На основании полученных данных создаётся новый элемент справочника «Контрагенты».
- Результат обработки отображается в таблице формы.
Возможности обработки
- массовая вставка списка ИНН из Excel, текстового файла или буфера обмена;
- ввод ИНН построчно;
- поддержка ИНН организаций и индивидуальных предпринимателей;
- проверка длины ИНН;
- проверка наличия недопустимых символов;
- проверка контрольных цифр ИНН;
- автоматическое удаление пробелов, табуляции, точек и дефисов;
- пропуск пустых строк;
- пропуск заголовка «ИНН»;
- исключение повторяющихся ИНН;
- поиск существующих контрагентов;
- предотвращение создания дублей;
- получение реквизитов через штатный сервис «1С:Контрагент»;
- создание новых контрагентов;
- заполнение основных реквизитов;
- заполнение юридического адреса;
- заполнение контактной информации, если она возвращена сервисом;
- вывод результата отдельно по каждому ИНН;
- запись ошибок в журнал регистрации.
Какие данные заполняются
Состав заполняемых реквизитов зависит от сведений, возвращённых сервисом «1С:Контрагент».
Обработка может заполнять:
- ИНН;
- КПП;
- краткое наименование;
- полное наименование;
- ОГРН или ОГРНИП;
- признак юридического или физического лица;
- страну регистрации;
- юридический адрес;
- адрес места жительства индивидуального предпринимателя;
- телефон;
- сведения о руководителе;
- другие реквизиты, совпадающие по имени с полями карточки контрагента.
Работа со списком ИНН
На форме обработки предусмотрено многострочное поле «Список ИНН».
В него можно вставить данные следующего вида:
7707083893
7728168971
7812014560
1653001805
Также поддерживаются значения, разделённые:
- переносом строки;
- табуляцией;
- запятой;
- точкой с запятой.
Это позволяет скопировать целый столбец ИНН из Excel и вставить его в обработку одной операцией.
После нажатия кнопки «Заполнить список» ИНН переносятся в таблицу формы.
Команды формы
Заполнить список
Разбирает содержимое многострочного поля и заполняет таблицу ИНН.
Во время заполнения:
- удаляются пробелы и лишние символы;
- пропускаются пустые строки;
- пропускается строка заголовка «ИНН»;
- исключаются повторяющиеся значения.
Загрузить сведения
Запускает проверку списка, поиск существующих контрагентов, получение сведений через «1С:Контрагент» и создание новых элементов.
Очистить результаты
Удаляет из таблицы статусы, ссылки на найденных контрагентов и тексты ошибок. Сам список ИНН сохраняется.
Очистить список
Очищает многострочное поле и таблицу ИНН.
Результаты обработки
По каждой строке отображаются:
- ИНН;
- статус обработки;
- ссылка на найденного или созданного контрагента;
- комментарий или текст ошибки.
Возможные статусы:
Ожидает обработки
ИНН загружен в таблицу, но обработка ещё не запускалась.
Создан
Контрагент отсутствовал в базе и был успешно создан.
Уже существует
В справочнике уже найден контрагент с указанным ИНН. Новый элемент не создавался.
Дубликат
ИНН повторяется в текущем списке.
Некорректный ИНН
ИНН имеет неправильную длину, содержит недопустимые символы или не прошёл проверку контрольных цифр.
Ошибка
Во время обращения к сервису или записи элемента произошла ошибка. Подробное описание выводится в колонке «Комментарий».
Защита от дублей
Перед обращением к сервису обработка выполняет поиск в справочнике «Контрагенты» по реквизиту ИНН.
Если контрагент найден:
- запрос к сервису не выполняется;
- новый элемент не создаётся;
- в таблице устанавливается статус «Уже существует»;
- в колонке «Контрагент» выводится ссылка на найденный элемент.
Контрагенты, помеченные на удаление, при поиске не учитываются.
Проверка ИНН
Обработка выполняет полную проверку ИНН.
Для организаций проверяется ИНН длиной 10 цифр.
Для индивидуальных предпринимателей и физических лиц проверяется ИНН длиной 12 цифр.
Проверяются:
- длина;
- наличие только цифровых символов;
- контрольная цифра для десятизначного ИНН;
- две контрольные цифры для двенадцатизначного ИНН.
Некорректные значения не передаются в сервис «1С:Контрагент».
Требования
Для работы обработки необходимо:
- действующее подключение интернет-поддержки пользователей;
- подключённый сервис «1С:Контрагент»;
- наличие доступных обращений по тарифу сервиса;
- доступ 1С к сети Интернет.
Проверить работу сервиса можно штатным способом:
- Открыть справочник «Контрагенты».
- Создать нового контрагента.
- Ввести ИНН.
- Нажать кнопку штатного заполнения реквизитов.
Если штатное заполнение работает, обработка также сможет получать сведения.
Порядок использования
Открыть внешнюю обработку.
Скопировать список ИНН из Excel или другого источника.
Вставить значения в поле «Список ИНН».
Нажать «Заполнить список».
Проверить сформированную таблицу.
Нажать «Загрузить сведения».
Дождаться завершения обработки.
Проверить статусы и комментарии по каждой строке.
При необходимости открыть созданного контрагента по ссылке из таблицы.
Ограничения
Обработка выполняет запросы к сервису последовательно — по одному ИНН.
Рекомендуется обрабатывать за один запуск:
- до 100 строк — оптимальный объём;
- до 200–300 строк — допустимый объём при стабильном соединении;
- более крупные списки рекомендуется разделять на части.
Фактическое количество запросов ограничивается тарифом подключённого сервиса «1С:Контрагент».
Если контрагент уже существует в базе, обращение к сервису для него не выполняется.
Обработка по умолчанию не обновляет существующих контрагентов и не перезаписывает их реквизиты.
Особенности реализации
Обработка является внешней и не требует изменения типовой конфигурации.
Вся логика размещена в модуле управляемой формы.
Внешние HTTP-запросы напрямую не выполняются. Для получения сведений используются штатные механизмы конфигурации и действующее подключение к сервису «1С:Контрагент».
Ошибки отдельных строк не прерывают обработку всего списка. Если по одному ИНН произошла ошибка, обработка переходит к следующему значению.
Подробная информация об ошибках записывается в журнал регистрации с событием:
ЗагрузкаКонтрагентовПоИНН
Поддержка конфигураций
Основная версия обработки предназначена для:
Бухгалтерия предприятия, редакция 3.0
Релиз 3.0.202.14
Для других релизов Бухгалтерии предприятия 3.0 может потребоваться адаптация вызовов общих модулей, структуры ответа сервиса или реквизитов контактной информации.
Для других конфигураций, включая УТ, КА и ERP, требуется отдельная проверка состава справочника «Контрагенты».
Проверено на следующих конфигурациях и релизах:
- Бухгалтерия предприятия, редакция 3.0, релизы 3.0.202.14
- Бухгалтерия предприятия КОРП, редакция 3.0, релизы 3.0.202.14
Вступайте в нашу телеграмм-группу Инфостарт