FAQ JDOC

Короткі відповіді для роботи з кабінетом, API, webhook і результатами.

Кабінет API документація

Документи

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

PDF, PNG, JPG/JPEG, TIFF. Найкраще працюють чіткі PDF або якісні скани.

Скільки файлів можна надіслати?

Один файл або пакет до 100 файлів за один запит, якщо інше не обмежено тарифом чи налаштуваннями компанії.

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

Зазвичай один успішно оброблений документ списує 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.

Які поля читати з 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, якщо питання стосується конкретної операції.