Webhook: уведомление о готовом разборе
Webhook позволяет вашей системе узнать о готовности разбора без опроса. Разбираем, как это устроено и чего в текущей версии нет.
Готовой интеграции по API нет: на этапе пилота данные передаются файлом. Мы пишем это прямо здесь, чтобы вы не узнали об этом после оплаты.
Как данные попадают в систему
Ваша система указывает адрес, на который присылать уведомление.
После обработки документа отправляется запрос с идентификатором и статусом.
По идентификатору ваша система забирает результат.
Соответствие полей
Чего нет
- В текущей версии исходящих webhook **нет**: это описание того, как задача решается в принципе.
- Подпись запроса и защита от повторов обязательны на стороне приёмника.
Что делать сегодня
Пока полноценной интеграции нет, порядок работы всё равно есть — и он даёт результат уже на этой неделе.
- 1Пока webhook не подключён, проверяйте статус в кабинете — документов на пилоте немного.
- 2Заранее решите, по какому идентификатору вы будете связывать документ со своей системой.
- 3Продумайте повторную доставку: приёмник обязан быть готов получить одно уведомление дважды.
Вопросы про Webhook
Webhook уже работает?
Нет. На пилоте статус виден в кабинете, а исходящих уведомлений мы не отправляем. Обещать работающую интеграцию, которой нет, мы не будем.
Почему приёмник должен быть готов к повторам?
Потому что доставка по сети не гарантирует однократности: при таймауте отправитель повторяет запрос. Обработчик должен быть идемпотентным — это общее правило, а не наша особенность.
Проверим на ваших документах и вашем Webhook
Первый счёт разбираем вручную и настраиваем набор колонок так, чтобы файл грузился в вашу систему без доработки.
Первый счёт разбираем вручную под ваш формат. Списание разовое, автопродления нет. Источник перехода: seo/integracii/webhook.
Другие интеграции