Здесь собраны частые ошибки при интеграции и способы их решения. Если документ не отправляется — начните отсюда.
Формат ответа с ошибкой
Ошибки возвращаются в едином формате:
json
{
"success": false,
"message": "Понятное описание ошибки",
"errors": { "facturaid": ["ID должен содержать 24 символа"] }
}
HTTP-коды
| Код | Значение | Что делать |
|---|---|---|
400 |
Некорректный запрос | Проверьте логику: документ уже отправлен / нельзя изменить |
401 |
Не авторизован | Токен отсутствует или истёк — получите новый |
403 |
Нет прав | Действие доступно только владельцу (продавцу/покупателю) |
404 |
Не найдено | Документ с таким facturaid не существует |
422 |
Ошибка валидации | Смотрите объект errors — какое поле неверно |
Частые ситуации
Документ не проходит валидацию (422)
Чаще всего причина в обязательных полях. Проверьте:
facturaid— ровно 24 символа, получен через/api/utils/idsellertin/buyertin— корректные ИНН/ПИНФЛproductlist— не пустой список товаров
Нельзя отредактировать документ (400)
Редактирование и удаление доступны только до отправки (статус < 1). После
отправки контрагенту документ изменить нельзя — создайте корректирующий.
Нет прав на действие (403)
Убедитесь, что действие выполняет правильная сторона: редактирует продавец, принимает покупатель. См. Статусы документа.
Tip
Если ошибка повторяется и причина неясна — сохраните facturaid, текст
message и время запроса, затем обратитесь в поддержку. Это ускорит разбор.