Автоматическая выгрузка платежей из CSV

Описание

Где этот интерфейс и как им пользоваться?

• Вносить платежи нужно на вкладке "Сервис".
• Подойдёт любая папка. На картинке выше "Абоненты" - просто пример. Платежи всё равно будут зачислены всем абонентам, которые есть в выгрузке, а не только из этой папки.
• Вносить платежи из CSV могут только администраторы из группы root.
• Загрузив файл с платежами, биллинга напишет об этом сообщение
  

Как биллинг определит кому занести платёж?

По-умолчанию поиск абонента происходит по номеру договора. Параметр в конфигурационном файле:

contract_number: 0  # Параметр поиска абонента

Но можно иначе: по одному из реквизитов, например по ИНН. Для этого в конфигурационном файле нужно задать два параметра:

contract_number: 0  # Параметр поиска абонента
special_search_param: 'attr 4'  # Специальный параметр поиска, например 'attr 4' = реквизит 4, то есть ИНН

Как избежать дублей платежей?

При загрузке биллинг проверяет уникальность платежа, чтобы при повторной загрузке платежи не дублировались. Полезно, если:

• Вы повторно загружаете тот же файл, например с исправленными ошибками;
• При загрузке платежей уже поступивших в биллинг из платёжной системы для сверки и исправления ошибок.

Проверка проходит по паре параметров pay_id_str и pay_operator. Поиск по pay_operator регистронезависимый, то есть значения Sberbank и SBERBANK - идентичны.

54-ФЗ, онлайн-чеки

Как отправлять чеки в онлайн-кассу по платежам физлиц 54-ФЗ?

В конфигурационном файле платёжной системы должна быть включена опция:

prevent_submit_check: 0

Как не отправлять чеки по платежам физлиц?

В конфигурационном файле платёжной системы должна быть включена опция:

prevent_submit_check: 1

Нужны ли чеки по платежам юрлиц?

Биллинг не отправляет чеки по любым платежам юрлиц.

Чтобы отдавать налоговой данные по платежам юрлиц, интегрируйте биллинг с 1С.

Настройка

Для того чтобы платежи выгрузить из CSV автоматически нужно:

1. Зайти в chroot /app/asr_billing

   chroot /app/asr_billing
   

2. Создать папку /cfg/autocsv с правами chmod 755 /cfg/autocsv

   mkdir /cfg/autocsv/
   chmod 755 /cfg/autocsv/
   

3. В этой папке создаются конфигурации для автоматической выгрузки. Они должны иметь расширение *.autocsv и прав 755:

   chmod 755 /cfg/autocsv/*.autocsv
   

4. Например, pochtarf.autocsv, содержание которого, может быть следующим

   # Обязательные параметры
   csv_path: '/var/autocsv/pochtarf/'
   contract_number: 0  # Параметр поиска абонента
   sum_in: 1  # Сумма платежа
   pay_id_str: 2  # Уникальный номер платежа
   # Необязательные параметры
   operator_date_in: 3  # Дата платежа
   operator_datetime_date_in: 31 # Дата платежа состоит из двух столбцов, столбец с датой
   operator_datetime_time_in: 32 # Дата платежа состоит из двух столбцов, столбец со временем
   # Столбцы даты и времени соединяются пробелом и заменяют operator_date_in
   date_format: '%Y.%m.%d %H:%M:%S' # Формат даты и времени платежа
   csv_comment: '#' # Символ комментария (в начале строки для пропуска)
   csv_delimiter: ';'  # Разделитель CSV-файла, по умолчанию - ;
   pay_operator: 'Почта РФ'  # Название оператора, по умолчанию - Загрузка из CSV
   skip: 2  # Количество строк, которые нужно пропустить, по умолчанию - 0
   encoding: 'windows-1251'  # Входная кодировка, по умолчанию - utf-8
   special_search_param: 'attr 4'  # Специальный параметр поиска, например 'attr 4' = реквизит 4, то есть ИНН
   special_pay_id_param_list: [30, 31, 33]  # Специальный список параметров для создания номера платежа, если нет уникального поля
   prevent_submit_check: 0 # параметр, отвечающий за отправку чеков в налоговую: 0 - отправлять чеки, 1 - не отправлять чеки, по умолчанию - 0
   incoming_sign: {id: 27, value: C}  # Специальный параметр признака поступления, будут загружаться только те платежи, у которых в колонке под номером 27 установлено значение "C"
   

   Где числа от 0 до 3 - это номера колонок в CSV-файле.
   Колонки 0, 1, 2 обязательны.
   Если колонки 3 не существует, то и в конфигурации её быть не должно.
   Поддерживаемые форматы даты:

   Поддерживаемые форматы даты

   %Y.%m.%d (2016.10.26)
   %Y.%m.%d %H:%M:%S (2016.10.26 10:01:32)
   %Y%m%d%H%M%S (20161026100132)
   

   Пример файла

   BILL0005;500;ABC015;20161026100132
   BILL0006;1000;AVC014;2016.10.26 10:01:32
   

5. Выйдите из контейнера биллинг:

   exit
   

6. Для вступления изменений в силу перезапустите контейнер биллинга командой:

   /app/asr_billing/service restart
   

Выгружать файлы можно следующими способами:

1. По протоколу SSH в путь, который был указан в csv_path
2. Через web-интерфейс вкладка операции у любой группы абонентов (Для этого способа так же необходимо создать конфигурационный файл, по примеру, который указан выше)

*Разделитель "табуляция" следует заводить так: csv_delimiter: '\t'

Решение проблем

1. Ошибки импорта пишутся в лог воркера. Просмотрите лог:
   Команда для просмотра лога

   fgrep csv_loading /app/asr_billing/var/log/worker.log
   

   Пример ошибки

   2019-01-09 21:25:38,559 - worker - csv_loading - ERROR - Абонент с номером договора 123456 не существует или удалён - пропускаем
   

2. Посмотрите список платежей, которые не были загружены. Неверные данные помещаются в файл: incomings.csv.error.
   Дынные отброшенные обработчиком

   /app/asr_billing/var/autocsv/pochtarf/bad/incomings.csv.error
   

   В каталоге может содержаться несколько файлов, по одному на каждую попытку загрузки с ошибками.

Возможные ошибки

При попытке загрузить данные зафиксирована ошибка в логе worker

 2020-08-15 10:20:35,502 - worker - csv_loading - ERROR - Ошибка при обработке выгрузки csv: file_name=/var/autocsv/sber/SB_3000_01082020.csv
 2020-08-15 10:20:35,503 - worker - csv_loading - ERROR - 'utf8' codec can't decode byte 0xc4 in position 49: invalid continuation byte

Необходимо проверить, в какой кодировке на данный момент загружается файл csv и выставить соответствующие настройки в обработчике /app/asr_billing/cfg/autocsv/name.autocsv