Интеграция с сервисом "Расчеты с физлицами" банка Авангард из 1С

Банк Авангард  предоставляет своим клиентам сервис 'Расчеты с физическими лицами' (Далее - Расчеты с ФЛ).

Из 1С и других систем возможно обращение к сервису через api.

Данная публикация содержит внешнюю обработку для 1С: Бухгалтерия предприятия (Корп) 3 в которой реализованы все доступные методы, необходимые для полноценной работы с сервисом.

Для использования необходимо иметь действующий логин и пароль к мобильному приложению банка Авангард.

Документацию к api можно получить при необходимости по запросу к вашему менеджеру(банка).

Если вы собираетесь интегрировать вашу 1С БП 3 с сервисом Расчеты с ФЛ - то прилагаемая обработка может быть использована 'из коробки'. Т.е. после добавления во внешние печатные формы и обработки или открытия через Файл-Открыть  и запуска обработки при наличии логина и пароля возможно сразу перейти к отправке реестров на оплату.

При первом запуске  откроется форма с  активной страницей Настройки

Необходимо указать логин и пароль к мобильному приложению банка.

Далее необходимо нажать кнопку 'Получить список терминалов'  и если у вас в списке несколько терминалов - удалить лишние. Необходимо оставить терминал, на который будут отправляться реестры.

В поле 'Тип операции по умолчанию' необходимо выбрать из списка нужную вам операцию (ниже подробный список из описания api)

Обработка реально используется в компании занимающейся приемом лома металлов и они указали Тип операции по умолчанию = SECONDARY_METAL.

По гиперссылке "Настройки 1С"  можно открыть список дополнительных свойств и реквизитов, которые потребуются для корректной работы обработки.

По кнопке 'Создать доп. свойства и реквизиты'  будут автоматически созданы следующие дополнительные свойства и реквизиты:

• Номер реестра Авангард  (дополнительное свойство для документа Поступление товаров и услуг - строка). В дополнительные сведения по документу поступления  при успешной отправке реестра будет записан номер реестра. Также при подборе документа для реестра у документа поступления проверяется наличие значения в этом свойстве и если номер реестра указан - выдается сообщение, что документ уже был включен в реестр. Данное свойство необходимо для избегания дублирования документов в реестрах.
• Получатель ДС ((дополнительное свойство для документа Поступление товаров и услуг - тип справочник Контрагенты) - Получатель Денежных Средств. Если деньги планируется перечислить другому физическому лицу по соответствующему заявлению - то следует указать в этом доп. сведении нужное лицо.
• Номер карты ФЛ (дополнительный реквизит в справочнике Контрагенты)  - номер банковской карты, на которую следует перечислять деньги контрагенту. Если заполнен Получатель ДС в документе поступления - то данные в реестр в это полю попадут из данных этого реквизита именно у указанного получателя, иначе из данных Контрагента (Поставщика).
• Номер телефона для перевода СБП (дополнительный реквизит в справочнике Контрагенты)- номер телефона по которому (при оплате по СБП)следует перечислять деньги контрагенту. Если заполнен Получатель ДС в документе поступления - то данные в реестр в это полю попадут из данных этого реквизита именно у указанного получателя, иначе из данных Контрагента (Поставщика).
• БИК банка для перевода СБП (дополнительный реквизит в справочнике Контрагенты) - БИК банка, которому (при оплате по СБП) следует перечислять деньги контрагенту. Если заполнен Получатель ДС в документе поступления - то данные в реестр в это полю попадут из данных этого реквизита именно у указанного получателя, иначе из данных Контрагента (Поставщика).

Все заполненные настройки будут сохранены после закрытия формы и восстановятся при следующем открытии формы обработки.

Если настройки корректно заполнены можно переходить к формированию реестра на оплату.

Заполнение реестра начинается с выбора контрагента в шапке обработки.

Далее на странице Реестр по кнопке Добавить (+) в поле документ подбирается документ который планируется оплатить. Если документ был уже ранее отправлен (включен) в другой реестр и у него заполнено доп. сведение Номер реестра Авангард - будет выдано предупреждение и отказано в добавлении. Если очистить поле Номер реестра Авангард у этого документа - добавление станет доступным вновь. Также невозможно добавить один и тот же документ более одного раза в новый реестр. Производится проверка на дублирование.

Еще раз уточняю - если указано дополнительное сведение Получатель ДС в документе поступление товаров и услуг - то платежные реквизиты (номер карты или номер телефона для оплаты по СБП и Бик банка для оплаты по СБП) будут заполняться именно из соответствующих реквизитов контрагента. Если Получатель ДС не указан, то платежные реквизиты заполняются по данным именно контрагента документа поступления. Паспортные данные (СерияНомер паспорта слитно)  всегда из контрагента поступления. 

Данные паспорта разбираются из реквизита контрагента Документ (Документ удостоверяющий личность).

Ищутся цифры после слова 'серия' до первой запятой, первого символа 'в' или конца строки.

Пример:

Паспорт РФ, серия 68 00 999999, выдан Токаревским РОВД Тамбовской обл., 25.06.01 г., к.п. 682-027 - будет получено 6800999999

ФИО получателя всегда получается из полного наименования контрагента. Поэтому правильно указывать ФИО следует в полном наименовании как Иванов Иван Иванович.

После добавления документа(ов) в список следует пройти построчно процедуру проверки реквизитов по кнопке Проверить реквизиты

В этой форме  можно изменить способ оплаты (СБП - перевод на карту)

Если все верно - по кнопке Подтвердить документ получит в списке статус Проверен и может быть отправлен в реестр на оплату.

В реестр на оплату будут отправлены только документы, имеющие статус Проверен.

Если на форме поднят (установлен) флажок Объединить платежи по получателю ДС  - то в реестре на оплату по одинаковому получателю ДС и контрагенту будут свернуты в одну строку платежи с указанием расчетных документов.

После проверки корректности номера реестра и дат действия реестра (в шапке обработки) по кнопке Отправить реестр можно выгрузить реестр непосредственно в сервис Расчеты с ФЛ и в мобильном приложении выполнить реальную оплату.

При неудачной отправке в сообщениях будет выведено сообщение от сервиса - его можно при вопросах уточнить в описаниях ошибок в документации api.

Самые частые ошибки - это некорректно заполненные реквизиты или номер и даты реестра.

Данная обработка может служить полезным подспорьем при интеграции с сервисом Расчеты с ФЛ для других конфигураций 1С.