Решение проблем интеграции с Порталом 1С:ИТС

Проверить актуальность расширения по интеграции с порталом ИТС для менеджера сервиса: команды меню Все функции  —  Управление расширениями конфигурации , расширение  ИнтеграцияСПорталомИТС .   

Если версия расширения не последняя — обновить расширение. Актуальная версия расширения доступна в составе продукта 1С:Предприятие. Облачная подсистема Фреш на сайте releases.1c.ru

Проверить основные настройки интеграции с порталом в менеджере сервиса: команды меню  Интеграция   —   Учетные системы , учетная система   Портал 1С:ИТС .

Нужно проверить, отправлены ли портал следующие данные:

Если какой либо из объектов не интегрирован и вместо значка  указан значок  , нужно проверить наличие ошибок в логе отправки. Лог отправки расположен в нижней части формы элемента после выбора пункта меню формы  Интеграция :

Нужно проверить, заполнен ли реквизит  Идентификатор  у обслуживающей организации, указанной в портале.

Для этого нужно открыть карточку обслуживающей организации в справочнике   Абоненты :

В поле Идентификатор нужно указать код партнера. Например, если Код партнера  000987-77, то указываем 000987, или 987

Открыть форму свойств активной подписки клиента и проверить наличие нужной услуги на вкладке   Услуги :

Если услуги нет, возможно в тарифе указан некорректный тариф поставщика Портала 1С:ИТС.

Симптомы проблемы

В списке  Подписки  у новых подписок не появляются значки интеграции, либо долго висят значки «часиков» .

В списке подписок не отправленные в портал подписки отображаются знаком  .

Решение

Интеграция с порталом использует общую очередь сообщений. Если в менеджере сервиса «забита» очередь сообщений, то возможны 2 варианта решения:

1. Дождаться освобождения очереди сообщений.

2. Отправить сообщения интеграции принудительно. Для этого нужно:

   1. Открыть элемент учетной системы  1С:Портал  в списке  Учетные системы  (команды меню  Интеграция  —  Учетные системы, учетная система  Портал 1С:ИТС) или переход по ссылке  e1cib/list/Справочник.УчетныеСистемы.
   2. Выбрать команду меню формы  Объекты к отправке.
   3. Нажать на кнопку «самолетик» .
   4. Все сообщения будут отправлены.
   5. Т.к. в портале процесс принятия сообщений разделен на 2 фазы: принятие к обработке и обработка, и между фазами возможен лаг 1-5 минут, процедуру отправки нужно будет при необходимости повторить через 5 минут.
   6. Если процедуру повторять 3 раза подряд, то сообщения заблокируются, но их можно разблокировать, нажатием на кнопку «замок» .

Открыть карточку абонента, выбрать в ней команду меню  Пользователи абонента , проверить состояние интеграции, показанное в левой колонке:

Причины неотправки абонентов в основном технические, возможны разные ситуации:

Портал 1С:ИТС: 500 - ошибка:
 FreshUser login 1c-fresh_0107@yopmail.com exist exception

Портал 1С:ИТС: 500 - ошибка:
 FreshSubscriber by freshGuid 55fa59c7-aa81-11e7-a5c6-0050568be947 not found

500 - ошибка:
 FreshUserRestClient#create(UUID,FreshUserInfo) failed and no fallback available

{
  "type":"FRESH_USER_NOT_FOUND",
  "text":"Пользователь(cd012524-30f1-11e8-80ce-8e51d7d8547d) не найден в системе.",
  "params": {
    "freshGuid":"cd012524-30f1-11e8-80ce-8e51d7d8547d"
  }
}

Расхождение данных Портала 1С:ИТС и менеджера сервиса. Например: на портале на 10 подписок больше чем в менеджере сервиса.

Причина состоит в непосредственном удалении объектов. Если объект Подписка,  Абонент,  Пользователь абонента  был создан ошибочно и сразу удалён из менеджера сервиса как объект без пометки удаления, то сообщение на портал не отправляется.

Чтобы объект также был удалён на портале, достаточно поставить пометку на удаление на соответствующий объект Подписки, Абонента или Пользователя абонента.

Интеграция с порталом использует общую очередь сообщений. Если в менеджере сервиса «забита» очередь сообщений, то возможны 2 варианта решения:

1. Дождаться освобождения очереди сообщений.

2. Отправить сообщения интеграции принудительно. Для этого нужно:

   1. Открыть элемент учетной системы  1С:Портал  в списке  Учетные системы  (команды меню  Интеграция  —  Учетные системы, учетная система  Портал 1С:ИТС)
      или переход по ссылке – e1cib/list/Справочник.УчетныеСистемы.
   2. Выбрать команду меню формы  Объекты к отправке.
   3. Нажать на кнопку «самолетик» .
   4. Все сообщения будут отправлены.
   5. Т.к. в портале процесс принятия сообщений разделен на 2 фазы: принятие к обработке и обработка, и между фазами возможен лаг 1-5 минут, процедуру отправки нужно будет при необходимости повторить через 5 минут.
   6. Если процедуру повторять 3 раза подряд, то сообщения заблокируются, но их можно разблокировать, нажатием на кнопку «замок» .

Для выяснения причин, почему подписка не была отправлена, нужно:

1. Вывести карточку свойств подписки и выбрать команду меню Интеграция .
2. Посмотреть описание состояния интеграции и лог отправки.

3. Открыть описание объекта к отправке, показанное в списке  Данные к отправке:

   

4. Вывести сообщение с подробным описанием ошибки, нажав кнопку   в правой части поля  Сообщение.

По этим сведениям можно понять причину, после чего нужно эту причину устранить. Возможные причины делятся на 2 типа:

1. Бизнес-ошибка в подписке
2. Техническая ошибка на Портале 1С:ИТС

На каждый запрос идет проверка по логину и паролю от конкретного экземпляра сервиса Фреш.

Также выполняются проверки заполнения полей. Описание проверок приведены в п.6 документа Rest API Портала 1С:ИТС Fresh-Integration

Пример ошибки

Could not read JSON document: Can not deserialize value of type java.lang.Integer from String "ОО2": not a valid Integer value
at [Source: java.io.PushbackInputStream@5b26700c; line: 3, column: 16] (through reference chain:
ru.onec.freshIntegration.rest.api.tariffPurchase.model.TariffPurchaseRequest["partnerCode"]);
nested exception is com.fasterxml.jackson.databind.exc.InvalidFormatException: Can not deserialize value of type java.lang.Integer from String "ОО2": not a valid Integer value
at [Source: java.io.PushbackInputStream@5b26700c; line: 3, column: 16] (through reference chain:
ru.onec.freshIntegration.rest.api.tariffPurchase.model.TariffPurchaseRequest["partnerCode"])

Решение

У обслуживающей организации указан код партнера отличный от числа. Нужно чтобы у обслуживающей организации код партнера был числом.

Код партнера указывается в поле  Идентификатор  без последних цифр после "-". Например, если Код партнера  000987-123, то указываем 000987, или 987 :

Пример ошибки

422 - ошибка: 
 Тариф ИТСааС ПРОФ(bfb2113f-cfde-4001-a01e-b43c999b45fc) нельзя купить на 1 MONTHS.

Решение

Тариф, на который оформляется подписка, не может быть оформлен на указанный срок. Возможные сроки оформления подписок на тариф обычно указываются на вкладке  Описание  формы свойств тарифа поставщика услуг.

Тарифы поставщиков услуг доступны с помощью команды меню  Управление тарифами  —  Тарифы поставщиков услуг  или по ссылке  e1cib/list/Справочник.ТарифыПоставщиковУслуг.

Пример ошибки

500 - ошибка: 
 По заявке(ef408d7a-c2c6-11e6-bd3d-0050568be947) уже была произведена оплата, дальнейшая модификация не возможна.

Решение

Подписка была ранее получена порталом и изменена пользователем в срок, когда ее уже нельзя менять.

Партнер или оператор сервиса должен создать новую подписку. Эту подписку нужно вернуть в исходное состояние или пометить на удаление, если она не актуальна.

Пример ошибки

{ОбщийМодуль.УниверсальнаяИнтеграция.Модуль(92)}: Ошибка при вызове метода контекста (ОтправитьДляОбработки)
Ответ = УниверсальнаяИнтеграцияПовтИсп.Соединение(УчетнаяСистема).
ОтправитьДляОбработки(Запрос);
по причине:
Ошибка работы с Интернет: Превышено время ожидания

Решение

В момент отправки сообщения в портал на портале 1С:ИТС производились технические работы и сообщение не смогло доставиться после 3-х попыток отправки.

Нужно в карточке свойств объекта (например, подписки) выбрать команду меню  Интеграция  и открыть сообщение, показанное в списке  Данные к отправке:

В выведенной форме  Объект к отправке  нужно разблокировать сообщение, нажав на кнопку замка  и затем на кнопку отправки сообщения :

Если в сообщении отображается пиктограмка «часы» , это значит, что сообщение принято порталом и обрабатывается. Нужно подождать 2-5 минут, обычно после этого услуга уже будет доступна пользователю.

Такая проблема может быть массовой. В этом случае нужно проделать те же действия, но с большим числом сообщений. Для этого нужно открыть форму учетной системы  Портал 1С:ИТС  (Интеграция  —  Учетные системы, учетная система  Портал 1С:ИТС) и выбрать в ней команду меню  Объекты к отправке :

Здесь будут доступны те же кнопки    и  . Их можно использовать следующим образом:

• Если в списке выделен один элемент, то операция будет выполнена для всех элементов списка.
• Если в списке выделено несколько элементов, то операция будет выполнена только для выделенных элементов.

Также в этом списке можно открывать отдельные объекты к отправке и выполнять их отправку из формы свойств объекта.

Симптомы проблемы

Сообщения отправляются в течение часа или более:

27.10.2017 13:18:49 | 202 - ожидание.
27.10.2017 13:19:52 | 202 - ожидание.
27.10.2017 13:22:49 | 202 - ожидание.
27.10.2017 13:25:49 | 202 - ожидание.
27.10.2017 13:27:49 | 202 - ожидание.
27.10.2017 13:30:51 | 202 - ожидание.

Решение

Ошибка проявляется на тестовых и боевых серверах.

Возможные причины:

1. В инфраструктуре сервиса Портала 1С:ИТС идут какие-то нагрузочные тесты.

2. Возможно, отправляемое сообщение содержит некорректный код партнера.

   Код партнера должен быть из существующих кодов партнера.

   Нужно установить обслуживающей организации существующий код партнера, например  987  или  456.