FAQ JDOC
Короткі відповіді для роботи з кабінетом, API, webhook і результатами.
КабінетAPI документаціяДокументи
Які формати підтримуються?
PDF, PNG, JPG/JPEG, TIFF. Найкраще працюють чіткі PDF або якісні скани.
Скільки файлів можна надіслати?
Один файл або пакет до 20 файлів за один запит, якщо інше не обмежено тарифом чи налаштуваннями компанії.
Що списується з балансу?
Зазвичай один успішно оброблений документ списує 1 документ з балансу.
API
Де взяти API-ключ?
У кабінеті, розділ API ключі. Повний ключ показується тільки один раз після створення.
Як авторизуватися?
Передайте заголовок Authorization: Bearer <API_KEY>.
Навіщо потрібен Idempotency-Key?
Він захищає від випадкового дублювання операцій при повторній відправці. Для кожного нового завантаження використовуйте нове значення.
Операції і результат
Де дивитися результат?
У кабінеті в розділі Операції або через GET /api/v1/operations/{operation_id}.
Що означає PROCESSED?
Документ оброблено, JSON готовий, критичних попереджень немає.
Що означає PROCESSED_WITH_WARNINGS?
Документ оброблено, але є попередження. Результат можна отримати, але перед імпортом варто перевірити warnings.
Що означає FAILED?
Документ не оброблено. Причина буде в полі error, errors або в картці операції.
Webhook
Webhook обовʼязковий?
Ні. Без webhook результат можна отримувати GET-запитом по operation_id.
Коли потрібен webhook?
Коли ваша система має автоматично отримувати результат після завершення обробки.
Де його налаштувати?
У кабінеті, розділ Webhook.
Інтеграція з 1С/BAS
Чи можна підключити 1С/BAS?
Так. Використовуйте HTTP API. Готові приклади функцій 1С 8 є у розділі Інтеграція з 1С/BAS.
Хто такі партнери 1С/BAS?
Партнери 1С/BAS — це незалежні інтегратори та фахівці, які можуть допомогти підключити JDOC до вашої бази 1С/BAS, налаштувати обробки, створення документів та автоматизацію роботи з первинними документами.
Чи JDOC сам налаштовує 1С/BAS?
Ні. JDOC не займається впровадженням і налаштуванням 1С/BAS у клієнтів. Ми надаємо сервіс розпізнавання документів, API та приклади інтеграції. Якщо вам потрібна допомога з підключенням до конкретної бази, перегляньте розділ Партнери 1С/BAS.
Які поля читати з JSON?
Номер і дату — result.document, контрагентів — result.parties, рядки — result.line_items, суми і ПДВ — result.totals та result.taxes.
Підтримка
Питання по кабінету, API або інтеграції надсилайте на support@jdoc.net.ua.
Юридичні документи
Договір публічної оферти та Політика конфіденційності.
Як звʼязатися з підтримкою?
Напишіть на support@jdoc.net.ua. У листі вкажіть email акаунта, company ID або operation_id, якщо питання стосується конкретної операції.