Как настроить обмен зарплатного проекта между 1С:ЗУП 3 и Ситибанком (Citibank)

← На главную

Настройка зарплатного проекта в 1С:Зарплата и Управление Персоналом 3.1 для работы с Ситибанком (Citibank) является нетривиальной задачей. В отличие от большинства крупных российских банков, Ситибанк не поддерживает стандартный протокол 1С:ДиректБанк. Это создает определенные трудности при интеграции, так как специалистам приходится вручную подбирать форматы обмена или использовать сторонние расширения.

В этой статье мы разберем технические особенности взаимодействия с системой CitiDirect BE, проанализируем доступные форматы файлов и выясним, как правильно настроить программу 1С для корректной выгрузки реестров на выплату заработной платы.

Основные сложности интеграции с Ситибанком

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

Разберем основные пути решения:

Использование универсального формата ISO 20022. Это международный стандарт, который Ситибанк поддерживает, но с определенными нюансами (диалектами).
Использование текстовых файлов фиксированной длины (Flat File). Традиционный и наиболее стабильный способ для этого банка.
Внешние обработки и расширения. Готовые модули, которые добавляют специфические настройки банка в конфигурацию.

Реализация через международный формат ISO 20022

Рассмотрим подробнее работу со стандартом ISO 20022 (pain.001). В 1С:ЗУП 3.1 при создании зарплатного проекта можно выбрать тип "Универсальный формат обмена". Однако стандартная выгрузка из 1С может не пройти валидацию в системе CitiDirect без дополнительной модификации.

Выясним причину: Ситибанк требует заполнения специфических тегов, таких как идентификатор дебитора Dbtr и коды видов валютных операций (VO codes), даже если транзакции проходят внутри страны. Кроме того, часто возникает необходимость в передаче резидентского статуса сотрудника.

Для корректной работы этого формата нам потребуется:

Создать расширение, которое перехватывает процедуру формирования XML.
Добавить маппинг полей из карточки сотрудника (например, латинское написание ФИО) в соответствующие теги XML-файла.
Убедиться, что кодировка файла строго соответствует требованиям банка (обычно UTF-8 без BOM).

Настройка формата Flat File (текстовый файл с фиксированной длиной строки)

Если формат XML вызывает сложности при импорте, разберем альтернативу — Flat File. Этот формат представляет собой текстовый документ, где каждый реквизит занимает строго определенное количество позиций. Например, номер счета может начинаться с 10-го символа и заканчиваться 30-м.

Проанализируем структуру типичного файла для Ситибанка:


01SITIRUSSIA  20231025SALARY_PAYMENT
0240702810000000000123IVANOV IVAN IVANOVICH       00000150000.00RUB

Для формирования такого файла в 1С рекомендуется использовать механизм внешних печатных форм или специализированных обработок выгрузки. Важно помнить, что Ситибанк крайне чувствителен к лишним пробелам или неправильной кодировке (часто требуется Windows-1251).

Обязательные данные в 1С:ЗУП для обмена с Citibank

Чтобы выгрузка прошла успешно, проверим заполнение следующих данных в информационной базе:

Латиница: В некоторых настройках CitiDirect ФИО сотрудников должны передаваться латинскими буквами. Если в ЗУП эти данные не заполнены, выгрузка может быть отклонена.
Код филиала (Branch Code): Ситибанк использует специфическую кодировку своих отделений, которую необходимо прописать в настройках зарплатного проекта в поле НомерОтделения.
Resident Status: Статус резидентства (резидент/нерезидент) критичен для валютного контроля банка.

Использование внешних обработок

Посмотрим на практический пример использования готовых решений. На профессиональных форумах (таких как Mista или Infostart) часто встречаются обработки, которые позволяют добавить "Ситибанк" как отдельный тип банковского сервиса в справочнике ЗарплатныеПроекты.

Алгоритм подключения такого решения обычно выглядит следующим образом:

Загружаем расширение через меню Администрирование — Печатные формы, отчеты и обработки — Расширения.
В справочнике Зарплатные проекты создаем новую запись.
В поле Банк выбираем наше новое расширение или указываем специфический формат обмена, который добавило расширение.
Заполняем параметры подключения к системе банка (если используется прямой канал связи) или пути выгрузки файлов.

Автоматизация через CitiConnect (Host-to-Host)

Для крупных организаций, обрабатывающих тысячи платежей, ручная загрузка файлов в CitiDirect становится неэффективной. В этом случае мы рассматриваем технологию Host-to-Host (CitiConnect).

Этот метод подразумевает прямую передачу зашифрованных данных между сервером 1С и банковским шлюзом по протоколу SFTP. Настройка такого обмена требует участия системного администратора и программиста 1С:

Необходимо настроить интеграцию с внешним ПО для шифрования (например, PGP).
Реализовать в 1С регламентное задание, которое будет мониторить появление новых реестров и отправлять их в банк.
Организовать получение обратных статусов (подтверждение банком приема файла).

Заключение

Интеграция 1С:ЗУП 3.1 и Ситибанка требует внимательного подхода к форматам данных. Поскольку штатный DirectBank не поддерживается, наиболее оптимальным путем является либо адаптация ISO 20022 через расширение конфигурации, либо использование проверенных внешних обработок для формирования файлов Flat File. Рекомендуем предварительно запросить у технической поддержки банка актуальное описание структуры файлов (Layout), так как требования могут меняться в зависимости от региона обслуживания и типа банковского продукта.