Внешний интерфейс СБИС ЭДО версия 2

advertisement
Внешний интерфейс СБИС ЭДО версия 2 - обработка
ошибок
Дата последней модификации: 28.11.2015
Содержание
Общая информация....................................................................................................................... 2
Справочник кодов ошибок ............................................................................................................ 3
Варианты ошибок и их решения .................................................................................................... 4
"Не найден метод XXX", HTTP 404 "Not found". .......................................................................... 4
"HTTP ошибка 401 Not authorized". ............................................................................................ 5
"Cервис временно недоступен", HTTP 503 Service Unavailable. ................................................... 6
"HTTP 504 Gateway Timeout". ..................................................................................................... 7
"* Line XX, Column YY\n Missing '}' or object member name\n" .................................................... 7
"Вызов метода 'XXX' заблокирован согласно назначенным правам ............................................ 8
"Ни один из отправляемых документов не подписан действительным сертификатом" ............... 9
Ошибка при записи ЭЦП документа: Подпись недействительна ................................................ 9
"Не удалось определить отправителя, возможно, не подключен абонентский ящик", HTTP ошибка 500
Internal Server Error. .................................................................................................................10
"Абонентский ящик получателя [XXX] c ИНН YYY … отключен", HTTP ошибка 500 Internal Server Error.
"Контрагент не подключен к электронному документообороту. Документ не отправлен", HTTP ошибка 500
Internal Server Error. .................................................................................................................10
"Ошибки при форматно-логической проверке" .........................................................................11
"Не допускается совпадение отправителя и получателя", HTTP ошибка 500 Internal Server Error.12
"Неверное значение ИНН/КПП получателя (1234512345/66789): Неверно указан ИНН '1234512345'.
Неверная контрольная сумма."; "Неверное значение ИНН/КПП получателя (000000000000/): ИНН не может
состоять только из нулей". "Неверное значение ИНН/КПП получателя (774000076/683302001): Неверно
указан ИНН '774000076'. Должен состоять из 10 или 12 цифр." ................................................12
"Не найден документ", HTTP ошибка 500 Internal Server Error ..................................................12
"Ошибка установки значимых дат на событии", "Время, указанное в документе <...> ("..."), некорректно…"
.................................................................................................................................................13
"Указанный отправитель не является нашей организацией (ИНН=…)" .....................................14
"Филиал-отправитель (ИНН=…, КПП=…, КодФилиала=…), не опубликован, перед отправкой документов
контрагентам следует его опубликовать" .................................................................................14
"Документ закрыт от изменений" ..............................................................................................14
История изменений документа ..................................................................................................... 15
http://sbis.ru
1
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
Общая информация
Вызовы удалённых методов программного интерфейса СБИС ЭДО осуществляется на базе защищённого
протокола передачи данных HTTPS с передачей данных в формате JSON. При этом возможны ошибки на
следующих уровнях:
1.
2.
3.
4.
ошибки адресации сервера;
ошибки HTTP/HTTPS протокола (транспортный уровень);
ошибки в теле JSON-запроса;
ошибки авторизации на online.sbis.ru (неверный логин/пароль, недопустимый сертификат ключа ЭП,
отсутствие прав на доступ к методу);
5. ошибки в параметрах функций внешнего интерфейса (пример – отсутствие обязательного параметра);
6. ошибки при выполнении команд (пример – отсутствие запрашиваемого документа).
Анализ ответа на команду следует начинать с проверки HTTP кода ответа. Ответ, отличный от "HTTP/1.1 200
OK" означает ошибку и подлежит анализу.
Все ошибки делятся на два класса:


фатальные, не допускающие исправления при повторном вызове без изменения параметров запроса
или дополнительных действий;
нефатальные, которые могут исправиться при повторном запросе спустя некоторое время без
изменения параметров или дополнительных действий.
Общая рекомендация при получении единичной нефатальной ошибки – сделать паузу на 60 секунд и
повторить запрос.
Общая рекомендация при массовом получении нефатальных ошибок – прекратить запросы к online.sbis.ru на 510 минут, затем возобновить обмен запросами.
http://sbis.ru
2
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
Справочник кодов ошибок
Расширенные коды ошибок "внешнего интерфейса" имеют вид:
00000000-0000-0000-0000-1XXXXXXXXXXX, где X – шестнадцатиричное значение (0..9, А..F).
00000000-0000-0000-0000-100000000000 – ошибка общего вида, не имеющая классификации, как правило
фатальная.
Ошибки, не подразумевающих исправления в случае повторного запроса без изменения тела запроса имеют
вид:
00000000-0000-0000-0000-1FAXXXXXXXXX, из них ("FA" в коде от английского "fatal"):
00000000-0000-0000-0000-1FA00001XXXX – фатальные ошибки входных параметров;
00000000-0000-0000-0000-1FA00002XXXX – ошибки, связанные с криптографией;
00000000-0000-0000-0000-1FA00003XXXX – ошибки модуля работы с формализованными документами;
00000000-0000-0000-0000-1FA00004XXXX – ошибки запуска в документооборот.
00000000-0000-0000-0000-1FA0000FXXXX – ошибки форматно-логического контроля.
Ошибки, подразумевающие исправление при повторном запросе без изменения тела запроса:
00000000-0000-0000-0000-1AAXXXXXXXX – общая маска ошибок.
00000000-0000-0000-0000-1AA00001XXXX – ошибки внутренних сервисов.
http://sbis.ru
3
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
Варианты ошибок и их решения
"Не найден метод XXX", HTTP 404 "Not found".
Класс ошибки: фатальная.
Исходная ситуация
На вызов метода c названием "XXX" возвращается ошибка HTTP 404 "Not found", в расширенной части
сообщение "Не найден метод".
Причина 1
В запросе опечатка в имени метода или указан несуществующий метод.
Решение 1
Исправить опечатку в имени метода.
Решение 2
Отказаться от использования несуществующего метода.
Пример ответа на вызов несуществующего метода СБИС.СписокПолномочий:
HTTP/1.1 404 Not Found
Server: nginx/1.4.4
Date: Fri, 11 Apr 2014 09:48:04 GMT
Content-Type: application/json; charset=windows-1251
Content-Length: 513
Connection: keep-alive
Keep-Alive: timeout=30
Access-Control-Allow-Headers: Accept, Content-type
Access-Control-Allow-Origin: *
Set-Cookie: sid=00052820-00052821-00ba-78030bc0254d49c9; path=/; expires=Thu, 11-Apr-2024 09:48:04 GMT
X-SBISSessionID: 00052820-00052821-00ba-78030bc0254d49c9
Cache-Control: must-revalidate, max-age=0
{"jsonrpc":"2.0","error":{"code":-32601,"message":"Не найден метод СБИС.СписокПолномочий","details":"Не
найден метод СБИС.СписокПолномочий","type":"error","data":{"classid":"{1b4dbb13-ce61-483f-b1dd03558672d15a}","addinfo":null}},"id":0}
Причина 2
Кодировка, указанная в HTTP заголовке запроса отличается от кодировки запроса.
Решение
Исправить кодировку на правильную.
Пример неверного запроса (ошибка заключается в указании кодировки UTF-8, при этом в JSON части запроса
используется кодировка Win-1251, по тексту ниже это невозможно определить):
POST https://online.sbis.ru/service/?srv=1 HTTP/1.1
Content-Type: application/json; charset= utf-8
Accept: */*, application/json-rpcD
X-SBISSessionID: 0005281a-0005281b-00ba-3beb110a20594e21
{"jsonrpc":"2.0","method":"СБИС.СписокСлужебныхЭтапов","params":{"Фильтр":{}},"id":0}
Пример ответа:
HTTP/1.1 404 Not Found
Server: nginx/1.2.0
Content-Type: application/json; charset= utf-8
Content-Length: 240
X-SBISSessionID: 00001d8c-00001d8c-00ba-d297d42835bc46de
http://sbis.ru
4
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
{"jsonrpc":"2.0","error":{"code":-32601,"message":"","details":"Не найден метод
ВИ.РџРѕР"учитьСостояниеВнешнегоИнтерфейса","data":{"classid":"{1b4dbb1
3-ce61-483f-b1dd-03558672d15a}","addinfo":null}},"id":0}
Причина 3
В заголовке запроса указан неверный адрес (некоторые методы требуют указания специфичного адреса)
Решение
Указать правильный адрес запроса.
Пример ответа на вызов метода СБИС.СписокИзменений с указанием неправильного адреса сервера
(https://online.sbis.ru/auth/service/ вместо https://online.sbis.ru/service/?srv=1):
HTTP/1.1 404 Not Found
Server: nginx/1.4.4
Date: Fri, 11 Apr 2014 09:45:16 GMT
Content-Type: application/json; charset=windows-1251
Content-Length: 513
Connection: keep-alive
Keep-Alive: timeout=30
Set-Cookie: sid=00052820-00052821-00ba-1f333ebddb6a4b3a; path=/; expires=Thu, 11-Apr-2024 09:45:16 GMT
X-SBISSessionID: 00052820-00052821-00ba-1f333ebddb6a4b3a
Access-Control-Allow-Origin: *
Access-Control-Allow-Headers: Accept, Content-type
X-ExceptionType: error
X-Powered-By: ASP.NET
Cache-Control: must-revalidate, max-age=0
X-Dispatch: osr-dispatch1(online.sbis.ru)
X-Path: 10.76.100.193:80 404;
X-Server: Microsoft-IIS/7.5
X-QACheck: true
{"jsonrpc":"2.0","error":{"code":-32601,"message":"Не найден метод СБИС.СписокИзменений","details":"Не
найден метод СБИС.СписокИзменений","type":"error","data":{"classid":"{1b4dbb13-ce61-483f-b1dd03558672d15a}","addinfo":null}},"id":0}
"HTTP ошибка 401 Not authorized".
Класс ошибки: фатальная.
Исходная ситуация
Вызов метода приводит к возврату HTTP ошибки 401 "Not authorized" и сообщению "Not authorized".
Причина 1
Идентификатор сессии (X-SBISSessionID) в HTTP заголовке запроса не указан.
Пример неверного запроса (идентификатор сессии отсутствует):
POST https://online.sbis.ru/service/&srv=1 HTTP/1.1
Content-Type: application/json; charset=utf-8
{
"jsonrpc": "2.0",
"method": "СБИС.ПрочитатьДокумент",
"params": {
"Документ": {
"Идентификатор": "e1756445-f1be-4562-b5cf-4549968b5f4f"
}
},
"id": 0
}
Ответ:
HTTP/1.1 401 Unauthorized
Content-Type: application/json
{
"jsonrpc": "2.0",
"error": "Not authorized.",
"id": -1
http://sbis.ru
5
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
}
Решение
1. пройти процедуру аутентификации для получения нового идентификатора;
2. указать правильный идентификатор сессии как значение заголовка HTTP пакета " X-SBISSessionID".
Причина 2
Идентификатор сессии (X-SBISSessionID) в HTTP заголовке запроса устарел из-за большого периода
неактивности (отсутствия вызовов) или после окончания регламентных работ на online.sbis.ru.
Решение
1. пройти процедуру аутентификации для получения нового идентификатора;
2. указать правильный идентификатор сессии как значение заголовка HTTP пакета " X-SBISSessionID".
Причина 3
В запросе указан неверный адрес. Такое часто случается при выполнении методов аутентификации
СБИС.Аутентифицировать,
СБИС.АутентифицироватьПоСертификату,
СБИС.Выход,
СБИС.СписокСертификатовДляАутентификации
и
некоторых
других)
с
указанием
адреса
https://online.sbis.ru/service/?srv=1 вместо https://online.sbis.ru/auth/service/).
Решение
Указать правильный адрес в запросе.
Пример
ответа
на
запрос
авторизации
с
указанием
неправильного
сервера (https://online.sbis.ru/service/?srv=1 вместо https://online.sbis.ru/auth/service/):
адреса
HTTP/1.1 401 Unauthorized
Server: nginx/1.4.4
Date: Fri, 11 Apr 2014 09:42:14 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
Keep-Alive: timeout=30
Cache-Control: must-revalidate, max-age=0
X-Path: internal;
X-QACheck: true
34
{"jsonrpc":"2.0","error":"Not authorized.","id":-1}
"Cервис временно недоступен", HTTP 503 Service Unavailable.
Класс: не классифицируется, т.к. может исправиться без действий пользователя (доступ в Интернет
кратковременно пропал), так и потребовать действий пользователя (внести деньги на счёт услуги доступа в
интернет, заменить неисправный роутер и т.д.).
Исходная ситуация
В ответ на запрос возвращается HTTP ошибка 503 " Service Unavailable" ("Сервис недоступен").
Причина
На online.sbis.ru или вспомогательном сервисе производятся регламентные/внерегламентные работы.
Решение
1. зайти на заглавную страницу https://online.sbis.ru/ и ознакомиться с объявлением о регламентных
работах и сроке окончания или обратиться в службу технической поддержки;
2. повторить запросы после окончания регламентных работ, возможно, потребуется выполнить
аутентификацию.
http://sbis.ru
6
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
"HTTP 504 Gateway Timeout".
Класс ошибки: нефатальная.
Исходная ситуация
В ответ на запрос возвращается HTTP ошибка 504 "Gateway Тimeout" ("Шлюз не отвечает")
Причина
Неверная настройка вашего соединения с сетью Интернет, отсутствует доступ в сеть интернет.
Решение
Проверьте:




доступность сети интернет (например, откройте сайт http://www.kremlin.ru/);
работоспособность сетевого интерфейса;
параметры доступа к сети Интернет, настройки прокси-сервера;
отсутствие блокировок антивирусом.
Исправьте найденные проблемы или обратитесь в службу технической поддержки, для полноценной работы с
внешним интерфейсом сайт https://online.sbis.ru/ должен быть доступен из браузера.
"* Line XX, Column YY\n Missing '}' or object member name\n"
Исходная ситуация
В ответ на запрос возвращается ошибка, подобная "* Line 11, Column 2\n
declaration\n".
Missing ',' or '}' in object
Причина 1
Неверно сформирован JSON запрос.
Решение
Переформировать запрос в правильном виде.
Пример запроса с ошибкой (пропущена закрывающая фигурная скобка):
POST https://online.sbis.ru/service/?srv=1 HTTP/1.1
Cache-Control: no-cache
Connection: Keep-Alive
Pragma: no-cache
Content-Type: application/json-rpc;charset=utf-8
Accept: */*, application/json-rpc
Accept-Encoding: gzip
User-Agent: ApplicationName/version
X-CalledMethod: SBIS.SpisokNashihOrganizacziy
X-OriginalMethodName: 0KHQkdCY0KEu0KHQv9C40YHQvtC60J3QsNGI0LjRhdCe0YDQs9Cw0L3QuNC30LDRhtC40Lk=
X-CurrentMethod:
X-RequestDateTime: 18.04.14 12:48:43.414282000
X-SBISSessionID: 00056ae1-00056ae2-00ba-5ebaa001619d44e8
X-Timeout: 60000
Content-Length: 253
Host: online.sbis.ru
{
"jsonrpc": "2.0",
"method": "СБИС.СписокНашихОрганизаций",
"params": {
"Фильтр": {
"Навигация": {
"Страница": "0"
}
},
"id": 0
}
http://sbis.ru
7
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
Пример ответа:
HTTP/1.1 500 Internal Server Error
Server: nginx/1.4.4
Date: Fri, 18 Apr 2014 08:49:26 GMT
Content-Type: application/json; charset=utf-8
Connection: keep-alive
Keep-Alive: timeout=30
Access-Control-Allow-Headers: Accept, Content-type
Access-Control-Allow-Origin: *
Set-Cookie: sid=00056ae1-00056ae2-00ba-5ebaa001619d44e8; path=/; expires=Thu, 18-Apr-2024 08:49:26 GMT
X-Application-Task: 73797
X-ExceptionType: error
X-SBISSessionID: 00056ae1-00056ae2-00ba-5ebaa001619d44e8
X-Powered-By: ASP.NET
Cache-Control: must-revalidate, max-age=0
X-Dispatch: fix-online-dispatch1.unix.tensor.ru(online.sbis.ru)
X-Path: 10.76.156.253:80 500;
X-Server: Microsoft-IIS/8.0
X-QACheck: true
Content-Length: 513
{"jsonrpc":"2.0","error":{"code":-32700,"message":"","details":"* Line 11, Column 2\n
in object declaration\n","type":"error","data":{"classid":"{f4101a18-9ea7-447d-9f989a951643f9f0}","addinfo":null}},"id":null}
Missing ',' or '}'
Причина 2
Неверно указана длина передаваемых данных в HTTP заголовке "Content-Length".
Решение
Указать правильный размер передаваемых данных.
"Вызов метода 'XXX' заблокирован согласно назначенным правам
Класс ошибки: фатальная.
Исходная ситуация
В ответ на запрос возвращается ошибка "Вызов метода 'XXX' заблокирован согласно назначенным правам",
HTTP ошибка 500 Internal Server Error".
Расширенный код ошибки: 00000000-0000-0000-0000-1fa0000e0000
Причина 1
Пользователю запрещено правами в системе СБиС вызывать данный метод.
Решение



войти в личный кабинет с правами администратора, изменить набор прав для пользователя,
вызывающего метод;
повторить аутентификацию пользователем с изменёнными правами;
повторить запрос.
Причина 2
Вход в кабинет доступен под несколькими пользователями с разными правами. Аутентификация произведена
под пользователем, у которого нет прав на вызов данного метода. При этом у другого пользователя нужные
права назначены (например, вход с данными "менеджера Иванов И.И." при необходимости входа как директор
"Петров П.П.").
Решение


повторить аутентификацию под пользователем с требуемыми правами;
повторить запрос.
http://sbis.ru
8
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
"Ни один из отправляемых документов не подписан действительным
сертификатом"
Класс ошибки: фатальная.
Исходная ситуация
При подписании документа в ответ на запрос возвращается ошибка "Ни один из отправляемых документов не
подписан действительным сертификатом, по ИНН соответствующим организации-отправителю", HTTP ошибка
500 Internal Server Error".
Причина
Для запуска документооборота не хватает электронных подписей под документами, требуемых по регламенту.
Решение 1 (подписать локальным ключом)



прочитать документ (СБИС.ПрочитатьДокумент);
убедиться, что все документы, требующие подписания, подписаны валидным сертификатом ЭП (для
проверки сертификата можно использовать метод СБИС.ПроверитьСертификаты или web-форму на
сайте http://www.gosuslugi.ru/pgu/eds). Если сертификат не валиден (устарел, отозван, выдан не
аккредитованным в соответствующих органах удостоверяющим центром) – заменить;
повторите отправку документа.
Решение 2 (подписать серверным ключом)



убедитесь, что пользователь, под учётными данными которого произведена аутентификация, имеет
права на использование серверного сертификата, выбранного для подписи;
убедитесь, что выбранный для подписи серверный сертификат активирован;
повторите отправку документа.
Ошибка при записи ЭЦП документа: Подпись недействительна
Класс ошибки: фатальная.
Исходная ситуация
На вызов метода c названием "СБИС.ВыполнитьДействие" возвращается ошибка HTTP 500 Internal Server Error,
в расширенной части сообщение "Ошибка при записи ЭЦП документа: Подпись недействительна".
Причина 1

Вложение было изменено на сервере, например, в результате вызова СБИС.ПодготовитьДействие, а
подпись сгенерирована для устаревшей копии
Причина 2

Сгенерированная подпись приложена к неправильному вложению, хеш вложения не совпадает с
подписанным хешем в ЭП
Причина 3

Вместо двоичных данных документа подпись выполнена для хеша вложения (т.е. подписан хеш хеша)
Причина 4

Для подписания использован сертификат, не являющийся валидным на момент проверки ЭП, выдан на
иную организацию
Решение
Для исходящего документа повторить отправку с вызова СБИС.ЗаписатьДокумент, в вызов
СБИС.ВыполнитьДействие передать верную ЭП. Для входящего документа повторить попытку выполнения
действия этапа документооборота (с вызова СБИС.ПодготовитьДействие)
http://sbis.ru
9
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
"Не удалось определить отправителя, возможно, не подключен абонентский
ящик", HTTP ошибка 500 Internal Server Error.
Класс ошибки: фатальная.
Исходная ситуация
При загрузке документа в СБиС в ответ на запрос возвращается ошибка "Не удалось определить отправителя,
возможно не подключен абонентский ящик", HTTP ошибка 500 Internal Server Error".
Причина 1
В личном кабинете отсутствует "Наша организация", от реквизитов которой производится отправка документа.
Решение


В web-интерфейсе личного кабинета зарегистрируйте недостающую "Нашу организацию" и подключите
у неё абонентский ящик (подробности на http://help.sbis.ru/);
повторите отправку документа.
Причина 2
В реквизитах отправителя документа "Документ.НашаОрганизация" допущены ошибка.
Решение


внесите исправление в реквизиты документа или параметры запроса;
повторите отправку документа.
Причина 3
Если ваша учётная система работает с несколькими личными кабинетами на online.sbis.ru, возможно,
произведена аутентификация не в том личном кабинете.
Решение


завершите сеанс обмена в кабинете (СБИС.Выход);
аутентифицируйтесь в правильном кабинете, в котором заведена и подключена организацияотправитель документа.
Причина 4
У "Нашей организации" – отправителя не подключен абонентский ящик.
Решение

В web-интерфейсе личного кабинета подключите у требуемой "нашей организации" абонентский ящик
(подробности на http://help.sbis.ru/).
"Абонентский ящик получателя [XXX] c ИНН YYY … отключен", HTTP ошибка 500
Internal Server Error.
"Контрагент не подключен к электронному документообороту. Документ не
отправлен", HTTP ошибка 500 Internal Server Error.
Класс ошибки: фатальная.
Исходная ситуация
При запуске документооборота в ответ на запрос возвращается ошибка "Абонентский ящик получателя [XXX] c
ИНН YYY … отключен" или "Контрагент не подключен к электронному документообороту. Документ не
отправлен", HTTP ошибка 500 Internal Server Error.
http://sbis.ru
10
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
Причина 1
Получатель документа отказался от электронного обмена документами по указанным реквизитам.
Решение 1
Свяжитесь с представителями контрагента (получателя) и
документами с ним. Возможно, это будет "бумажный вариант".
выясните
допустимые
варианты
обмена
Решение 2
Свяжитесь с вашим менеджером или технической поддержкой компании "Тензор" и попросите выяснить
причину отключения абонентского ящика контрагента.
Причина 2
Организация получателя ликвидирована, его личный кабинет деактивирован, А/Я отключен.
Решение
Свяжитесь с вашим менеджером или технической поддержкой компании "Тензор" и попросите выяснить
причину отключения абонентского ящика контрагента.
"Ошибки при форматно-логической проверке"
Класс ошибки: фатальная.
Исходная ситуация
После определения формата отправляемых документов сервер зафиксировал ошибки при форматнологическом контроле.
Примеры расширенной части сообщения:


"Файл
ON_SCHET_2BEcf64bba310444f5daed3cc864750e188_2BE7ed0b1f69af611e3845e005056b76e76_20140411_
fc2c44c6-c131-11e3-ac8c-005056b74802.xml
ошибки:
[
Отсутствует
обязательный
атрибут
\"Файл.Документ.СвСчет.СвПокуп.ИдСв.СвФЛ.ФИОИП.Имя\"]"
"Файл
ON_SCHET_2BE50afaf555e874a7cbd5d0d5ab3abc4f0_2BE7ed0b1f69af611e3845e005056b76e76_20140411_
4469965e-c13c-11e3-9f08-005056b74802.xml
ошибки:
[
Значение
\"2/4стр23Б\"
атрибута
\"Файл.Документ.СвСчет.СвПокуп.Адрес.АдрРФ.Дом\" больше максимально допустимой длины (8)]"
Причина 1
При отправке вложения
утвержденному формату.
утвержденного
формата,
формат
вложения
документа
не
соответствует
Решение



проверьте соответствие отправляемых вложений документа утверждённым форматам (для этого
удобно пользоваться страницей https://online.sbis.ru/CheckXML.html), исправьте формат вложений
документа;
если вы указываете тип вложения при отправке (Документ.Вложение.Тип), проверьте соответствие
отправляемого значения реальному типу вложения;
повторите отправку документа.
Причина 2
При отправке вложения близкого к утвержденному формату, online.sbis.ru неправильно классифицирует
неутвержденный формат и принимает его за утвержденный с ошибками.
Решение
http://sbis.ru
11
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок

Свяжитесь с технической поддержкой компании "Тензор" и приложите описание вашего формата.
Возможно, мы зарегистрируем ваш формат в справочнике форматов, используемых при загрузке, либо
дадим рекомендации по внесению исправлений, которые позволят исключить ошибку определения.
"Не допускается совпадение отправителя и получателя", HTTP ошибка 500
Internal Server Error.
Класс ошибки: фатальная.
Исходная ситуация
При вызове метода в ответ на запрос возвращается ошибка: "Не допускается совпадение отправителя и
получателя", HTTP ошибка 500 Internal Server Error.
Причина 1
Реквизиты (ИНН для ИП, ИНН и КПП для ЮЛ) отправителя ("Документ.НашаОрганизация") и получателя
документов ("Документ.Контрагент") совпадают. Допущена ошибка в реквизитах.
Решение


исправить реквизиты;
повторить отправку документа.
Причина 2
Реквизиты (ИНН для ИП, ИНН и КПП для ЮЛ) отправителя ("Документ.НашаОрганизация") и получателя
документов ("Документ.Контрагент") совпадают. Попытка отправить документы в пределах одной организации
по регламенту внешнего документооборота.
Решение
Не существует. Обмен документами по регламентам внешнего документооборота в пределах одной
организации (с одинаковым ИНН для ИП, одинаковыми ИНН и КПП для ЮЛ) не допускается.
"Неверное значение ИНН/КПП получателя (1234512345/66789): Неверно указан
ИНН '1234512345'. Неверная контрольная сумма.";
"Неверное значение ИНН/КПП получателя (000000000000/): ИНН не может
состоять только из нулей".
"Неверное значение ИНН/КПП получателя (774000076/683302001): Неверно
указан ИНН '774000076'. Должен состоять из 10 или 12 цифр."
Класс ошибки: фатальная.
Исходная ситуация
При вызове метода в ответ на запрос возвращается одна из вышеописанных ошибок.
Причина
Ошибка в реквизитах получателя документов.
Решение


исправить реквизиты в параметрах запроса (Документ.Контрагент.ИНН/КПП) или в теле документов;
повторить отправку документа.
"Не найден документ", HTTP ошибка 500 Internal Server Error
Класс ошибки: фатальная.
Исходная ситуация
http://sbis.ru
12
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
При вызове метода в ответ на запрос возвращается ошибка "Не найден документ", документ на online.sbis.ru
не найден.
Пример сообщения (расширенная часть): "Не найден документ с идентификатором '9948ca65-1890-4d79-8396973e9c0d9d73'".
Причина 1
Указанный документ, никогда не отправлялся в личный кабинет online.sbis.ru.
Решение


Исправьте ошибку в вашей информационной системе, из-за которой документ считается отправленным
или не зафиксировано его удаление;
Повторите отправку документа, либо удалите информацию о несуществующем документе из вашей
информационной системы.
Причина 2
Указанный документ удален из личного кабинета. Запрошенный документ был помещён в корзину в личном
кабинете, затем удалён из корзины, при этом вся информация о документе утрачена.
Решение
Восстановите документ:



из архива в вашей учётной системе;
запросите электронную копию документа у вашего контрагента;
обратитесь в службу технической поддержки компании "Тензор", и в случаях, когда на операторе есть
охраненные документы, их можно будет восстановить.
"Ошибка установки значимых дат на событии", "Время, указанное в документе
<...> ("..."), некорректно…"
Класс ошибки: фатальная.
Код ошибки: 00000000-0000-0000-0000-1FA0000B0000
Подробное сообщение:
"Время, указанное в документе <...> ("..."), некорректно, оно находится в периоде, предшествующем отправке
документа ("..."), время должно быть указано в часовом поясе UTC+3 (Москва)"
"Время, указанное в документе <...> ("..."), некорректно, оно превышает текущее время ("..."), время должно
быть указано в часовом поясе UTC+3 (Москва)"
Исходная ситуация
Ошибка может возникать при выполнении действий этапа "Утверждение", действия "Обработать служебное".
Причина 1

Дата/время, используемое в теле XML вложения, не является московским
Причина 2

Один или несколько реквизитов, задающих дату/время в теле прикладываемого XML вложения не
является правильной (предшествует моменту отправки документа или превышает текущее время).
Решение


Переведите вашу учётную систему на работу с московским временем (при взаимодействии с
online.sbis.ru)
Исправьте реквизит и отправьте исправленный документ.
http://sbis.ru
13
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
"Указанный отправитель не является нашей организацией (ИНН=…)"
Класс ошибки: фатальная.
Код ошибки: 00000000-0000-0000-0000-1FA000010000
Исходная ситуация
Ошибка может возникать при выполнении команды СБИС.ЗаписатьДокумент, СБИС.ВыполнитьДействие.
Причина

В списке наших организаций отсутствует организация с переданными реквизитами.
Решение


Добавьте "нашу организацию", подключите документооборот, повторите отправку.
Исправьте некорректные реквизиты "нашей организации" на корректные.
"Филиал-отправитель (ИНН=…, КПП=…, КодФилиала=…), не опубликован, перед
отправкой документов контрагентам следует его опубликовать"
Класс ошибки: фатальная.
Код ошибки: 00000000-0000-0000-0000-1FA000010000
Исходная ситуация
Ошибка может возникать при выполнении команды СБИС.ЗаписатьДокумент, СБИС.ВыполнитьДействие.
Причина

Данные по филиалу "нашей организаций" не опубликован.
Решение


Опубликуйте реквизиты филиала, повторить отправку
Исправьте некорректные реквизиты филиала "нашей организации" на корректные.
"Документ закрыт от изменений"
Класс ошибки: фатальная.
Код ошибки: 00000000-0000-0000-0000-1FA0000E0000
Исходная ситуация
Вызов метода, изменяющего документ (загрузка редакции или удаления документа) ведёт к возврату ошибки.
Причина 1
На документе установлен флаг "Закрыт от изменений"
Причина 2
На документе установлен флаг "Помечен плюсом"
Решение


Снимите флаг, блокирующий изменения
Откажитесь от попытки изменения
http://sbis.ru
14
Внешний интерфейс СБИС ЭДО версия 2 - обработка ошибок
История изменений документа
27.10.2014

Добавлен классификатор кодов ошибок.
17.04.2015

Добавлено описание ошибки при выполнении действия и неверной даты из тела документа.
21.08.2015

Из адресов запросов удалены ненужные "sbis-rpc-service300.dll", исправлено поле UserAgent.
24.08.2015

Товарные знаки "СБиС" и "сбис++" заменены на "СБИС" и "сбис" соответственно.
28.11.2015


Добавлена ошибка "Документ закрыт от изменений", код 00000000-0000-0000-0000-1FA0000E0000.
Дополнено описание "Ошибка при записи ЭЦП документа: Подпись недействительна".
http://sbis.ru
15
Download