FAQ

Зміст

1. Початок роботи

Як почати роботу з JDOC?

1. Зареєструйтеся в JDOC.
2. Підтвердьте email за посиланням або кодом із листа.
3. Увійдіть у кабінет.
4. У лівому меню відкрийте «API ключі», створіть ключ і одразу скопіюйте його.
5. Завантажте обробку саме для своєї конфігурації 1С/BAS.
6. Відкрийте відповідну покрокову інструкцію і виконайте початкові налаштування.

Подивитися коротке відео про реєстрацію та створення API-ключа — близько 2 хвилин.

Де зареєструватися?

Натисніть «Реєстрація», заповніть форму та підтвердьте email. Після цього входьте через кабінет JDOC.

Скільки документів нараховується після реєстрації?

Після успішної реєстрації та підтвердження email на баланс компанії нараховується 10 документів для тестування сервісу.

Де взяти API-ключ?

1. Увійдіть у кабінет JDOC.
2. У лівому меню натисніть «API ключі».
3. Натисніть кнопку створення нового ключа.
4. Одразу скопіюйте повний ключ. Після закриття вікна він повторно повністю не показується.
5. Вставте ключ у поле «API-ключ» в обробці та натисніть «Перевірити ключ».

Відео: де зареєструватися і як створити API-ключ.

Email, пароль або код з листа — це API-ключ?

Ні. Email використовується для входу, пароль — для захисту акаунта, код із листа — для підтвердження. API-ключ створюється окремо в кабінеті у розділі «API ключі».

Чи можна використовувати один API-ключ для кількох компаній?

Так, можна. Один API-ключ можна вказати в кількох обробках або інформаційних базах і використовувати для документів різних організацій. Важливо: всі операції та списання будуть відображатися в тій компанії JDOC, для якої створено цей API-ключ.

Що робити, якщо лист підтвердження не прийшов?

Перевірте папки «Спам» і «Промоакції». Якщо листа немає, напишіть на support@jdoc.net.ua та вкажіть email, який використовували під час реєстрації.

2. Обробки для 1С/BAS

Яку обробку завантажити?

Чи потрібен програміст для початку роботи?

Для підтримуваних конфігурацій — ні. Завантажте готову зовнішню обробку та виконайте кроки з відповідної інструкції. Для нестандартної конфігурації або індивідуальної логіки може знадобитися ваш фахівець 1С/BAS.

Де вибрати тип документа і роль нашої організації?

Це робиться не на сайті, а всередині відкритої обробки 1С/BAS.

• BAS Бухгалтерія 2.1: відкрийте верхню вкладку «Налаштування». У синьому блоці «Універсальне завантаження (Шаблони)» виберіть поле «Тип документа JDOC», а нижче — «Роль нашої організації». Після заповнення натисніть другу кнопку зліва із зображенням дискети — «Зберегти налаштування».
• УТ 2.3 / УТП 1.2 / УПП: відкрийте вкладку «Налаштування», виберіть «Тип документа», потім у полі «Універсальний режим сторін» виберіть потрібний сценарій. Сірі поля ролей заповняться автоматично. Після цього натисніть кнопку з дискеткою для збереження.

Точне розташування полів показане на скриншотах у відповідній інструкції: BAS Бухгалтерія 2.1 або УТ / УТП / УПП.

Чи потрібно налаштовувати кожний тип документа окремо?

Так, але тільки один раз. Виберіть, наприклад, рахунок, вкажіть роль організації та інші параметри, а потім збережіть налаштування. Після цього окремо виберіть накладну, налаштуйте її та збережіть. Так само зробіть для акта. Надалі обробка використовуватиме збережений шаблон відповідного типу.

Які документи можуть створювати обробки?

Залежно від типу документа, ролі організації та конфігурації обробка може створити:

• рахунок на оплату покупцю;
• рахунок від постачальника;
• надходження товарів і послуг;
• реалізацію товарів і послуг;
• документ за актом відповідно до налаштування;
• авансовий звіт із розпізнаних чеків.

Чому документ створюється непроведеним?

Це захист від автоматичної помилки. Спочатку бухгалтер перевіряє всі реквізити, а потім самостійно записує або проводить документ.

3. Файли, баланс і списання

Які формати підтримуються?

PDF, PNG, JPG/JPEG і TIFF. Найкращий результат дають чіткі PDF, скани або фото без обрізаних країв, сильних тіней і перекриття документів.

Що саме списується з балансу?

У звичайному режимі за кожні розпочаті 5 сторінок одного документа списується 1 документ з балансу: 1–5 сторінок — 1 документ, 6–10 сторінок — 2 документи, 11–15 сторінок — 3 документи, 16–20 сторінок — 4 документи, 21–25 сторінок — 5 документів, 26–30 сторінок — 6 документів, 31–35 сторінок — 7 документів, 36–40 сторінок — 8 документів, 41–45 сторінок — 9 документів, 46–50 сторінок — 10 документів, 51–55 сторінок — 11 документів, 56–60 сторінок — 12 документів.

Якщо в одному файлі система розпізнає кілька окремих документів, кожен додатковий документ також списується з балансу окремо. У режимі «Супер AI» списання утричі більше за звичайне. Для ввімкнення режиму потрібно щонайменше 11 документів на балансі.

Коли потрібно вмикати «Супер AI»?

«Супер AI» — режим покращеного розпізнавання складних документів у всіх підтримуваних форматах. Увімкніть його для:

• складних фото або сканів;
• кількох чеків на одному зображенні;
• ТТН із дрібним шрифтом;
• PDF, що складаються із зображень;
• текстових PDF зі складною структурою;
• складної або погано видимої табличної частини.

Скільки списується за «Супер AI»?

У режимі «Супер AI» списання утричі більше за звичайне. Для ввімкнення режиму потрібно щонайменше 11 документів на балансі.

Чи працює «Супер AI» з текстовими PDF?

Так. Режим працює з текстовими PDF та іншими підтримуваними форматами.

Що таке мультидокумент?

Це один файл, у якому JDOC знайшов кілька окремих документів. Наприклад, один PDF містить два рахунки. Після розпізнавання кожний рахунок зʼявиться окремим рядком зі своїм номером і результатом.

Що означає полегшений мультидокументний режим?

JDOC автоматично виявив кілька документів у звичайному режимі. Це не помилка. Якщо документи розміщені складно, текст дуже дрібний або на зображенні кілька чеків, краще повторити обробку з увімкненим «Супер AI».

4. Контрагенти, номенклатура і створення документа

Як обробка знаходить контрагента?

Спочатку обробка визначає, де в документі наша організація, а де інша сторона. Потім вона шукає контрагента:

1. за ЄДРПОУ або ІПН;
2. за точним найменуванням;
3. за дуже близьким збігом назви.

Якщо є кілька майже однакових кандидатів і немає надійного збігу, обробка не повинна вибирати один навмання.

Коли створюється новий контрагент?

Тільки якщо в налаштуваннях увімкнено створення контрагентів і надійного збігу в базі не знайдено. Після створення відкрийте картку та перевірте найменування, ЄДРПОУ/ІПН, адресу, банківські й податкові реквізити.

Як обробка знаходить номенклатуру?

Для кожного рядка пошук виконується послідовно:

1. артикул;
2. код;
3. штрихкод;
4. точне коротке або повне найменування;
5. нечіткий збіг назви, якщо цей режим увімкнено.

Що таке нечіткий пошук номенклатури?

Обробка порівнює дуже схожі назви, навіть якщо відрізняються регістр, пробіли або розділові знаки. Але бухгалтеру обовʼязково потрібно перевірити товари з різною фасовкою, обʼємом, моделлю, кольором або артикулом.

Що обовʼязково перевірити перед проведенням документа?

• нашу організацію;
• покупця і постачальника;
• контрагента та договір;
• номенклатуру, артикул і одиницю вимірювання;
• кількість, ціну та суму;
• ПДВ;
• склад;
• банківські реквізити, якщо вони використовуються.

5. Чеки та авансовий звіт

Як розпізнати складний чек?

Спочатку увімкніть «Супер AI» для файла. На вкладці «Документи» знайдіть рядок потрібного чека, поставте звичайний прапорець вибору, а потім натисніть окремий прапорець у колонці з жовтою зіркою. Підтвердьте ввімкнення режиму і тільки після цього запускайте розпізнавання.

Як перенести чеки в авансовий звіт?

1. Розпізнайте чек і перевірте результат.
2. На вкладці «Документи» виберіть потрібні чеки.
3. Натисніть «Перенести в авансовий звіт».
4. Відкрийте вкладку «Авансовий звіт».
5. Перевірте рядки та виберіть для кожного потрібний розділ витрат.
6. Створіть документ і ще раз перевірте його перед проведенням.

Повний сценарій зі скриншотами є в інструкції для BAS Бухгалтерія 2.1 та в інструкції для УТ / УТП / УПП.

6. Кабінет та API

Чи обовʼязково користуватися API напряму?

Ні. Для готової обробки потрібен API-ключ, але бухгалтеру не потрібно писати код або розбирати JSON. Пряме використання API потрібне переважно для власної інтеграції.

Де дивитися результат?

• В обробці: виберіть рядок документа і натисніть «Показати результат».
• У кабінеті: відкрийте розділ «Операції».
• У власній інтеграції: отримайте результат через API.

Webhook обовʼязковий?

Ні. Webhook потрібен тільки для власної автоматичної інтеграції, коли ваша система має сама отримувати результат. Для роботи через готову обробку або кабінет налаштовувати його не потрібно.

Де знайти технічну документацію?

Для програміста або інтегратора доступні:

• API документація — запити, статуси та формат JSON;
• Інтеграція з 1С/BAS — приклади підключення;
• кабінет JDOC — API-ключі, операції та webhook.

7. Помилки та підтримка

Що робити, якщо документ довго обробляється?

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

Що робити, якщо виникла помилка?

1. Прочитайте повний текст повідомлення в колонці помилки або в журналі.
2. Перевірте API-ключ, баланс, формат і розмір файла.
3. Переконайтеся, що для складного фото або кількох чеків увімкнено «Супер AI».
4. Якщо проблема не зникає, напишіть у підтримку.

Як звʼязатися з підтримкою?

Напишіть на support@jdoc.net.ua. У листі вкажіть:

• email вашого акаунта;
• назву файла;
• company ID або operation_id, якщо вони відомі;
• скриншот помилки;
• короткий опис того, що ви натиснули перед появою помилки.

Юридичні документи

Договір публічної оферти та Політика конфіденційності.