Загрузить платежи из файла импорта

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

Чтобы загрузить файл импорта, пройдите три шага.

  1. Сформируйте файл. Чтобы система корректно считала файл, его содержимое должно строго соответствовать формату. Каждая строка отвечает за один платёж и может содержать 7 параметров.

    Описание Значение
    1 Идентификатор, по которому система будет определять, на какой договор зачислить платёж. В качестве идентификатора могут выступать различные данные — за это отвечает параметр «Тип идентификатора» Текст до 64 символов
    2 Тип идентификатора:
    • 0 — логин учётной записи
    • 1 — логин абонента
    • 2 — телефон абонента
    • 3 — IP-адрес учётной записи
    • 4 — имя абонента
    • 5 — номер договора
    • 6 — код оплаты
    • 7 — email абонента
    • 8 — номер счёта
    • 9 — ID учётной записи в LANBilling
    • 10 — ID абонента в LANBilling
    • 11 — ID договора в LANBilling
    • 18 — ИНН абонента
    Целое число
    3 Дата платежа в формате: YYYY-MM-DDTHH:MM:SS или YYYY-MM-DD HH:MM:SS Текст
    4 Сумма платежа в валюте договора Десятичная дробь
    5 Уникальный идентификатор платежа, например номер из внешней системы Текст до 32 символов
    6 Произвольный комментарий, например назначение платежа Текст
    7 Данные о банке в формате: Расчётный счёт банка|Название банка|Адрес банка|БИК Текст

    Между параметрами в файле должен стоять определённый символ, по умолчанию — табуляция. Этот разделительный символ можно изменить в настройках LANBilling.

    Пример файла с двумя оплатами по договорам «Contract-123» и «Contract-456»:

    Contract-123	5	2023-05-01T14:21:00	610.22	ae-28-744-bx-1	По счёту № 31225	13036758087342577700||ГСевастополь|687895508
    Contract-456	5	2023-05-02 14:23:00	309.78	ae-28-744-bx-7		54495446613646982773|МойЛюбимыйБанк|ГСевастополь|734973967
    

    ``

  2. Переименуйте файл. Расширение не имеет значения. Имя должно начинаться с логина платёжной системы из LANBilling. Например, для платёжной системы с логином «Grandpay» можно назвать файл «Grandpay-2023-05.csv».

  3. Переместите файл. Скопируйте его в специальную папку на сервере, где установлен модуль LBcore. По умолчанию это папка /pay_import/:

    cp Grandpay-2022-05-01.csv /usr/local/billing/pay_import/
    

    ``

Система обработает его в течение минуты.

  • Если файл корректен, платежи появятся в LANBilling. В качестве менеджера, который создал платежи, будет указана платёжная система. Система переместит файл в папку /pay_import/arc/.

  • Если есть ошибки, то ни один платёж не будет создан в LANBilling. Система переместит файл в директорию /pay_import/err/discard/.