Published using Google Docs
Інструкція “Автоклієнт”
Updated automatically every 5 minutes

Сервіси інтеграції.Інструкція для роботи з додатком «Автоклієнт»

Загальний опис        

Додавання нового автоклієнта        

Запуск декількох автоклієнтів        

Додаткові функції        

Імпорт платежів        

Системні вимоги        

Опис формату експорту транзакцій CSV        

Структура файлу з експортованими виписками (транзакціями) у форматі CSV        

Опис формату експорту транзакцій DBF        

Структура файлу з експортованими виписками (транзакціями) у форматі DBF (JBKL_REC.DBF)        

Структура файлу виписки у форматі DBF (MJ {дата} .dbf)        

Структура файлу оборотно-сальдової відомості у форматі DBF        

Опис API        

Загальний опис

Модуль «Автоклієнт» комплексу «Приват24 для бізнесу» призначений для обслуговування корпоративних клієнтів і приватних підприємців.

«Автоклієнт» – програмне забезпечення, що дає змогу налаштувати періодичне автоматичне отримання виписок / залишків за рахунками й імпортувати платежі в Приват24.

Підключити «Автоклієнт» може уповноважена / довірена особа підприємства в межах своїх повноважень (доступ до рахунків та операцій синхронні у вебверсії і додатку «Автоклієнт»).

Модуль має графічний вебінтерфейс, за допомогою якого можна додати нового автоклієнта з необхідними налаштуваннями.

Додавання нового автоклієнта

  1. Для додавання нового автоклієнта або оновлення потрібно вибрати підприємство, потім перейти в меню «Каталог послуг». 
  2. У меню «Каталог послуг» виберіть розділ «Автоклієнт» і натисніть кнопку «Підключити», потім – «Відкрити».

Після того, як Автоклієнт буде підключений, додаток стає доступним на стартовій сторінці в розділі «Облік та звіти» - «Автоклієнт»

  1. Для додавання нового автоклієнта натисніть кнопку «Підключити додаток» та у випадаючому списку виберіть «Автоклієнт».

  1. У вікні генерації автоклієнта введіть найменування, виберіть формат файлу для експорту виписки, інтервал виконання наступного запиту на отримання виписки й залишків, а також шлях для збереження оборотно-сальдової відомості, шлях для збереження файлів виписки, шлях для збереження файлу з платежами, підготовленими до імпорту, шлях для збереження файлу з імпортованими платежами, шлях для збереження відхилених платежів. За замовчуванням відомість (залишки) й виписка зберігаються до папки balance і statements, дані для імпорту платежів – до папок prepared, saved, rejected, які містяться в папці додатка «Автоклієнт». Ознайомтесь з умовами та правилами використання додатку та встановіть відповідний прапорець.

У разі вибору формату dbf виписка й оборотно-сальдова відомість будуть збережені в одному файлі за вибраними рахунками одного підприємства в кодуванні cp1251, у разі вибору формату csv – виписка та відомість будуть збережені в окремі файли за кожним вибраним рахунком одного підприємства або в одному файлі за всіма рахунками (для цього треба вибрати «Вивантажувати дані по всіх рахунках в один файл», як показано на скриншоті нижче). Також для зручності користуванням файлами csv автоматично встановлюється прапорець «Включати дату в найменування файлів» з ним в найменуванні файла буде вказана дата, за яку в ньому збережені дані.

У вкладці «Доступні рахунки» виберіть рахунки, за якими бажаєте налаштувати періодичне автоматичне отримання виписок/залишків (за замовчуванням вибрано всі рахунки).

У вкладці «Додаткові налаштування» можна встановити обмеження за IP-адресою та параметри проксі (якщо ваше підключення здійснюється через проксі-сервер).

Після вибору налаштувань натисніть кнопку «Зберегти».

  1. У журналі з’явиться створений автоклієнт, який потрібно завантажити й запустити. Натисніть на значок «Встановити», на який показує стрілка на скриншоті нижче. 
  2. У вікні, що з’явиться, завантажте «Автоклієнт», натиснувши кнопку «Завантажити». Для оновлення «Автоклієнта» потрібно деінсталювати додаток, який було встановлено раніше (за допомогою деінсталятора unins000.exe, що міститься в папці «Автоклієнту», або через системне керування додатками на вашому персональному комп’ютері), і встановити новий.
  3. Натисніть autoclientInstaller_1141979494.exe (1141979494 - це ідентифікатор вашого підприємства, тому ці цифри можуть відрізнятись), прийміть умови угоди, виберіть шлях для встановлення «Автоклієнта» та запустіть додаток. За замовчуванням буде створено папку з назвою ID підприємства, наприклад 123456. 

Запуск декількох автоклієнтів 

Потрібно встановити «Автоклієнт», виконавши кроки 1–7 для кожного підприємства. 

Додаткові функції

Для активації/деактивації автоклієнта треба натиснути на значок «Активувати/Деактивувати», на який показує стрілка на скриншоті нижче.

 Для вибору налаштувань потрібно натиснути на значок «Редагувати Автоклієнт» (на нього показує стрілка на скриншоті нижче), внести зміни в поля у формі, що з’явиться, і зберегти. Автоклієнт автоматично отримає нові налаштування й буде їх використовувати. 

 Для видалення автоклієнта натисніть на значок «Видалити Автоклієнт», на який показує стрілка на скриншоті нижче. 

Імпорт платежів

Вимоги: 

Кроки для імпорту платежів:

  1. Перенесіть файл із платежами до папки prepared.
  2. Якщо «Автоклієнт» вимкнуто, треба його запустити, якщо увімкнуто, то імпорт почнеться за наступного запиту даних.
  3. Файл з успішно збереженими платежами буде в папці saved, файл із платежами, у реквізитах яких є помилки, разом із лог-файлом опису, що містить поле помилки, – у папці rejected.

Структура файлу у форматі dbf має відповідати вимогам:

Назва поля

Тип поля

Довжина

Дес.

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-паспорта)

Структура файлу має відповідати опису, а необов’язкові поля можна залишити порожніми. 

Опис формату експорту транзакцій CSV

Найменування файлів автоматично формуються в такому форматі:

{14_останніх_цифр_номера_рахунку_або_IBAN_рахунок}{валюта}{дата} _opers.csv, наприклад:

UA453052990000026001222148856UAH0202201603022016_opers.csv;

{14_останніх_цифр_номера_рахунку}{валюта}{дата} _lastday.csv, наприклад:

UA453052990000026001222148856UAH0202201603022016_lastday.csv;

оборотно-сальдова відомість:

{14_останніх_цифр_номера_рахунку}{валюта}{дата}_saldo.csv, наприклад:

UA453052990000026001222148856UAH0202201603022016_saldo.csv.

Роздільник копійок у файлі – «.» (крапка).

Якщо в інтерфейсі не активовано чекбокc «Включати дату в найменування файлів», назва файлів буде без дати. Виписка буде формуватися в одному файлі за рахунком.

Структура файлу з експортованими виписками (транзакціями) у форматі CSV (ХХХ_opers.csv)


Опис полів, які експортуються:

Файл експорту виписки формується в кодуванні, вибраному клієнтом в інтерфейсі модуля.

Приклад файлу експорту оборотів: 

Опис формату експорту транзакцій DBF 

Найменування файлів автоматично формуються в такому форматі:

Структура файлу з експортованими виписками (транзакціями) у форматі DBF (JBKL_REC.DBF)

Найменування поля

Тип поля

Довжина

Розшифрування найменування поля

Приклад значення

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

Структура файлу виписки у форматі DBF (MJ {дата} .dbf)

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 – час здійснення платежу.

Структура файлу оборотно-сальдової відомості у форматі DBF

(MO {дата} .dbf)

BRNM – чотиризначний код банку.

SC – номер рахунку, за яким сформовано оборотно-сальдову відомість.

NAME – найменування платника.

ON – вхідний залишок.

OK – вихідний залишок.

OBD – обороти ДТ – сумарний оборот за дебетом за день у валюті рахунку.

OBK – обороти КТ – сумарний оборот за кредитом за день у валюті рахунку.

ONV – вхідний залишок в еквіваленті.

OKV – вихідний залишок в еквіваленті.

OBDV – обороти ДТ в еквіваленті.

OBKV – обороти КТ в еквіваленті.

DPRD – дата формування файлу з відомістю.

DPD – дата виписки за попередній день.

CCY – валюта.

FIL – філія.

Додатки для вашої облікової системи

  • «Автоклієнт» – для будь-якої облікової системи.
  • «Модуль обміну з Приват24» – для бухгалтерських облікових систем, розроблених в Україні. Завантажити можна через «Приват24 для бізнесу» в меню «Каталог послуг» → «Модуль обміну з Приват24».

Системні вимоги

Windows Server 2008 64х, Windows Server 2012 64х, Windows 7 64х, Windows 8 64х, Windows 10 64х.

На папку зі встановленим «Автоклієнтом» мають бути права на читання й запис.

Не передавайте ID й токен третім особам. Якщо ви плануєте зберігати чи використовувати ID й токен не на своєму сервері або додатку, ознайомтеся з політикою конфіденційності та інформацією про безпеку, щоб знати, як будуть використовувати й захищати ваші дані.

Для розробників

Опис API