Сервіси інтеграції.Інструкція для роботи з додатком «Автоклієнт»
Структура файлу у форматі dbf має відповідати вимогам:
Опис формату експорту транзакцій CSV
Структура файлу з експортованими виписками (транзакціями) у форматі CSV (ХХХ_opers.csv)
Опис формату експорту транзакцій DBF
Структура файлу з експортованими виписками (транзакціями) у форматі DBF (JBKL_REC.DBF)
Структура файлу виписки у форматі DBF (MJ {дата} .dbf)
Структура файлу оборотно-сальдової відомості у форматі DBF
3. Додатки для вашої облікової системи
Модуль «Автоклієнт» комплексу «Приват24 для бізнесу» призначений для обслуговування корпоративних клієнтів і приватних підприємців.
«Автоклієнт» – програмне забезпечення, що дає змогу налаштувати періодичне автоматичне отримання виписок / залишків за рахунками й імпортувати платежі в Приват24.
Підключити «Автоклієнт» може уповноважена / довірена особа підприємства в межах своїх повноважень (доступ до рахунків та операцій синхронні у вебверсії і додатку «Автоклієнт»).
Модуль має графічний вебінтерфейс, за допомогою якого можна додати нового автоклієнта з необхідними налаштуваннями.
Після того, як Автоклієнт буде підключений, додаток стає доступним на стартовій сторінці в розділі «Облік та звіти» - «Інтеграція (Автоклієнт)»
2.1. Для роботи в групі ФОП після підключення модуля необхідно переключитись на групу ФОП:
1. зліва зверху біля назви компанії натиснути на стрілку
2. з випадаючого списку вибрати групу ФОП
3. підключити необхідний додаток (Автоклієнт, модуль обміну, API)
Підключений додаток буде працювати в режимі групи ФОП
У разі вибору формату dbf виписка й оборотно-сальдова відомість будуть збережені в одному файлі за вибраними рахунками одного підприємства в кодуванні cp1251, у разі вибору формату csv – виписка та відомість будуть збережені в окремі файли за кожним вибраним рахунком одного підприємства або в одному файлі за всіма рахунками (для цього треба вибрати «Вивантажувати дані по всіх рахунках в один файл», як показано на скриншоті нижче). Також для зручності користуванням файлами csv автоматично встановлюється прапорець «Включати дату в найменування файлів» з ним в найменуванні файла буде вказана дата, за яку в ньому збережені дані.
У вкладці «Доступні рахунки» виберіть рахунки, за якими бажаєте налаштувати періодичне автоматичне отримання виписок/залишків (за замовчуванням вибрано всі рахунки).
У вкладці «Додаткові налаштування» можна встановити обмеження за IP-адресою та параметри проксі (якщо ваше підключення здійснюється через проксі-сервер).
Після вибору налаштувань натисніть кнопку «Зберегти».
Запуск декількох автоклієнтів
Потрібно встановити «Автоклієнт», виконавши кроки 1–7 для кожного підприємства.
Для активації/деактивації автоклієнта треба натиснути на значок «Активувати/Деактивувати», на який показує стрілка на скриншоті нижче.
Для вибору налаштувань потрібно натиснути на значок «Редагувати Автоклієнт» (на нього показує стрілка на скриншоті нижче), внести зміни в поля у формі, що з’явиться, і зберегти. Автоклієнт автоматично отримає нові налаштування й буде їх використовувати.
Для видалення автоклієнта натисніть на значок «Видалити Автоклієнт», на який показує стрілка на скриншоті нижче.
Вимоги:
Кроки для імпорту платежів:
Назва поля | Тип поля | Довжина | Дес. |
N_D | CHARACTER | 10 | 0 |
SUMMA | NUMERIC | 15 | 2 |
COUNT_A | CHARACTER | 29 | 0 |
NAME_B | CHARACTER | 40 | 0 |
MFO_B | CHARACTER | 9 | 0 |
COUNT_B | CHARACTER | 29 | 0 |
N_P | CHARACTER | 160 | 0 |
OKPO_B | CHARACTER | 10 | 0 |
SER_PAS_B | CHARACTER | 2 | 0 |
NOM_PAS_B | CHARACTER | 9 | 0 |
Сірим кольором позначені обов’язкові поля.
Назва поля | Опис поля | Приклад |
N_D | Номер документа | 77 |
SUMMA | Сума платежу | 2015.99 |
COUNT_A | Номер рахунку/картки платника | UA593052990000026001555777001 |
NAME_B | Найменування отримувача | ТОВ Львів |
MFO_B | МФО банку отримувача | 305299 |
COUNT_B | Номер рахунку/картки отримувача | UA453052990000026009444333002 |
N_P | Призначення платежу | Оплата згідно з угодою 22 від 01.01.2015, ПДВ... |
OKPO_B | Код ЄДРПОУ / ІПН отримувача | 13422702 |
SER_PAS_В | Серія паспорта отримувача | АК |
NOM_PAS_В | Номер паспорта / ID-паспорта отримувача | 126126 (126126126 для ID-паспорта) |
Структура файлу має відповідати опису, а необов’язкові поля можна залишити порожніми.
Найменування файлів автоматично формуються в такому форматі:
{14_останніх_цифр_номера_рахунку_або_IBAN_рахунок}{валюта}{дата} _opers.csv, наприклад:
UA453052990000026001222148856UAH0202201603022016_opers.csv;
{14_останніх_цифр_номера_рахунку}{валюта}{дата} _lastday.csv, наприклад:
UA453052990000026001222148856UAH0202201603022016_lastday.csv;
оборотно-сальдова відомість:
{14_останніх_цифр_номера_рахунку}{валюта}{дата}_saldo.csv, наприклад:
UA453052990000026001222148856UAH0202201603022016_saldo.csv.
Роздільник копійок у файлі – «.» (крапка).
Якщо в інтерфейсі не активовано чекбокc «Включати дату в найменування файлів», назва файлів буде без дати. Виписка буде формуватися в одному файлі за рахунком.
Опис полів, які експортуються:
Файл експорту виписки формується в кодуванні, вибраному клієнтом в інтерфейсі модуля.
Приклад файлу експорту оборотів:
Найменування файлів автоматично формуються в такому форматі:
Найменування поля | Тип поля | Довжина | Розшифрування найменування поля | Приклад значення |
TIP | Character | 4 | Crrp, Crrm | |
N_D | Character | 10 | Номер документа | G0418S2IPX |
DATE | Character | 8 | Клієнтська дата | 20160418 |
SUMMA | Numeric | 15.2 | Сума документа | 600.00 |
NAME_A | Character | 40 | Найменування рахунку платника | ПАРТНЕР КОНСАЛТИНГ, ТОВ |
COUNT_A | Character | 29 | Рахунок платника | UA453052990000026008052725794 |
MFO_A | Character | 9 | Код банку А | 305299 |
BANK_A | Character | 45 | Найменування банку A | АТ КБ "ПРИВАТБАНК" |
NAME_B | Character | 40 | Найменування рахунку отримувача | КИЇВСТАР, ПРАТ |
COUNT_B | Character | 29 | Рахунок отримувача | UA453052990000026008164716001 |
MFO_B | Character | 9 | МФО банку отримувача | 321842 |
BANK_B | Character | 45 | Найменування банку B | КИЇВСЬКЕ ГРУ АТ КБ "ПРИВАТБАНК", М. КИЇВ |
N_P | Character | 160 | Призначення платежу | Плата за послуги зв’язку, особовий рахунок 5204067, у т. ч. ПДВ 20% – 1666,67 грн. |
VAL | Character | 4 | Валюта документа | UAH |
OKPO_A | Character | 10 | Код ЄДРПОУ платника | 14360570 |
OKPO_B | Character | 10 | Код ЄДРПОУ отримувача | 21673832 |
TIME | Character | 17 | Дата й час операції | 20160418T01:31:00 |
COUNT | Character | 16 | Не використовується | |
REF | Character | 15 | Референс документа | HSKLG0418L04WA |
BRNM – чотиризначний код банку.
J_CS – рахунок відправника.
J_CR – рахунок одержувача.
J_S – сума платежу.
J_SV – сума в еквіваленті.
J_CURR – курс перерахунку.
J_CCY – валюта.
J_N – призначення платежу.
J_FIL – код МФО банку.
J_DDOC – дата документа.
J_DAV – дата здійснення платежу.
J_SNAME – найменування відправника.
J_SFIL – найменування банку відправника.
J_RFIL – найменування банку одержувача.
J_WHATF1 – призначення платежу.
J_REF – референс платежу.
J_TIME – час здійснення платежу.
(MO {дата} .dbf)
BRNM – чотиризначний код банку.
SC – номер рахунку, за яким сформовано оборотно-сальдову відомість.
NAME – найменування платника.
ON – вхідний залишок.
OK – вихідний залишок.
OBD – обороти ДТ – сумарний оборот за дебетом за день у валюті рахунку.
OBK – обороти КТ – сумарний оборот за кредитом за день у валюті рахунку.
ONV – вхідний залишок в еквіваленті.
OKV – вихідний залишок в еквіваленті.
OBDV – обороти ДТ в еквіваленті.
OBKV – обороти КТ в еквіваленті.
DPRD – дата формування файлу з відомістю.
DPD – дата виписки за попередній день.
CCY – валюта.
FIL – філія.
Windows Server 2008 64х, Windows Server 2012 64х, Windows 7 64х, Windows 8 64х, Windows 10 64х.
На папку зі встановленим «Автоклієнтом» мають бути права на читання й запис.
Не передавайте ID й токен третім особам. Якщо ви плануєте зберігати чи використовувати ID й токен не на своєму сервері або додатку, ознайомтеся з політикою конфіденційності та інформацією про безпеку, щоб знати, як будуть використовувати й захищати ваші дані.
Для розробників 2. Опис API |