PROCEDURE Error_InvalidHSvcTypeCode(sTypeCode VARCHAR2);

Вызывает exception “Неизвестный код типа услуги”.

PROCEDURE Error_InvalidHServiceType(iID PLS_INTEGER);

Вызывает exception “Тип услуги не существует”.

PROCEDURE Error_InvalidHService(iID PLS_INTEGER);

Вызывает exception “Услуга не существует”.

PROCEDURE Error_InvalidHServiceCode(iServiceTypeID PLS_INTEGER, iServiceCode PLS_INTEGER);

Вызывает exception “Неизвестный код услуги”.

FUNCTION GetHServiceTypeName(iID PLS_INTEGER, iNameKind PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает наименование типа услуги.
Параметры:

• iID - ID типа услуги в справочнике “Типы услуг ГИС ЖКХ”;
  
• iNameKind - вид наименования: 1 - отображаемое; 2 - техническое (код);
  
• iStrict - определяет поведение при некорректном значении.

FUNCTION GetHServiceName(iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает наименование услуги.
Параметры:

• iID - ID услуги в справочнике “Услуги ГИС ЖКХ”;
  
• iStrict - определяет поведение при некорректном значении.

FUNCTION DecodeServiceType(sTypeCode VARCHAR2, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Декодирует тип услуги.
Параметры:

• sTypeCode - код типа услуги;
  
• iStrict - определяет поведение при некорректном значении.
  

Возвращает ID записи в справочнике “Типы услуг ГИС ЖКХ”.

FUNCTION DecodeService(iServiceTypeID PLS_INTEGER, iServiceCode PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Декодирует вид услуги.
Параметры:

• iServiceTypeID - ID типа услуги в справочнике “Типы услуг ГИС ЖКХ”;
  
• iServiceCode - код услуги по справочнику ГИС ЖКХ;
  
• iStrict - определяет поведение при отсутствии соответствия.
  

Возвращает ID записи в справочнике “Услуги ГИС ЖКХ”.

PROCEDURE ParseCommonError(iErrorTagID PLS_INTEGER, sNSURI VARCHAR2, sErrCode OUT VARCHAR2, sErrDesc OUT VARCHAR2);

Выполняет разбор сообщения об ошибке.
Входные параметры:
iErrorTagID - ID тега error;
sNSURI - URI пространства имён common.
Выходные параметры:

• sErrCode - код ошибки;
  
• sErrDesc - описание ошибки.
  

Если тег не содержит обязательных элементов, возникает exception.

PROCEDURE ParseNsiRef(iOwnerTagID PLS_INTEGER, sTagName VARCHAR2, sNSURI VARCHAR2, sNSURICom VARCHAR2, iStrict PLS_INTEGER, NsiRef OUT TNsiRef);

Разбирает NsiRef.
Входные параметры:

• iOwnerTagID - ID родительского тега;
  
• sTagName - наименование тега;
  
• sNSURI - URI пространства имён тега;
  
• sNSURICom - URI пространства имён common;
  
• iStrict - определяет поведение при отсутствии тега.
  

Выходные параметры:

• NsiRef - заполняемая запись.
  

Если обязательные данные отсутствуют или некорректны, возникает ошибка.

FUNCTION GetExportDebtRequestStatus(sErrorCode VARCHAR2) RETURN PLS_INTEGER;

Определяет статус межведомственного запроса ВС «Выгрузка из ГИС ЖКХ ответов поставщиков жилищно-коммунальных
услуг на запросы о наличии задолженности по оплате», соответствующего коду ошибки. Статус определяется по
справочнику соответствия SIS_HCS_Debt_ErrCodes.
Параметры:

• sErrorCode - код ошибки ГИС ЖКХ (значение элемента error-code).
  

Возвращает ID записи из таблицы uszn.dic_interdept_request_states.
Если запись соответствия не найдена, возвращается универсальный код ошибки pkInterDept.IReqStatus_Error.

FUNCTION CreateExportDebtRequest(
  iRegionID PLS_INTEGER, iiRequestPDocIDs uszn.pkGen.TIntegers, iSMEVVersionID PLS_INTEGER,
  iAudOriginID PLS_INTEGER, sAudNotes VARCHAR2 := NULL) RETURN PLS_INTEGER;

Выполняет межведомственный запрос с использованием ВС «Выгрузка из ГИС ЖКХ ответов поставщиков жилищно-коммунальных
услуг на запросы о наличии задолженности по оплате» по списку документов.
Параметры:

• iRegionID - ID района;
  
• iiRequestPDocIDs - список ID первичных документов запроса (не более 100 штук) «Запрос В ГИС ЖКХ о наличии задолженности по оплате ЖКУ», ID класса = 18404;
  
• iSMEVVersionID - ID версии схемы СМЭВ; если null, используется версия по умолчанию;
  
• iAudOriginID - ID источника события для аудита по документам;
  
• sAudNotes - примечания для аудита по документам.
  

Возвращает ID запроса, отправленного в СМЭВ-3.
Также заполняет соответствующие данные в документах.
Если документы не существуют, относятся к другому классу, заблокированы, не были получены положительные ответы об
отправке или пользователь не имеет достаточных привилегий, возникает exception.

FUNCTION CreateExportDebtRequest(
  iRegionID PLS_INTEGER, iRequestPDocID PLS_INTEGER, iSMEVVersionID PLS_INTEGER,
  iAudOriginID PLS_INTEGER, sAudNotes VARCHAR2 := NULL) RETURN PLS_INTEGER;

Выполняет межведомственный запрос с использованием ВС «Выгрузка из ГИС ЖКХ ответов поставщиков жилищно-коммунальных
услуг на запросы о наличии задолженности по оплате» по одному документу.
Параметры:

• iRegionID - ID района;
  
• iRequestPDocID - ID первичного документа запроса «Запрос В ГИС ЖКХ о наличии задолженности по оплате ЖКУ», ID класса = 18404;
  
• iSMEVVersionID - ID версии схемы СМЭВ; если null, используется версия по умолчанию;
  
• iAudOriginID - ID источника события для аудита по документам;
  
• sAudNotes - примечания для аудита по документам.
  

Возвращает ID запроса, отправленного в СМЭВ-3.
Также заполняет соответствующие данные в документе.
Если документ не существуют, относится к другому классу, заблокирован, не был получен положительный ответ об
отправке или пользователь не имеет достаточных привилегий, возникает exception.

PROCEDURE ProcessExportDebtRequestResult(
  iMessageID PLS_INTEGER, iDataRootTagID PLS_INTEGER,
  LOG IN OUT NOCOPY uszn.pkServerOps.TServerOpLog, iLogLevel IN OUT NOCOPY PLS_INTEGER,
  iErrorCount IN OUT NOCOPY PLS_INTEGER, iWarningCount IN OUT NOCOPY PLS_INTEGER,
  iAudOriginID PLS_INTEGER, sAudNotes VARCHAR2);
 
/*********************************************************************************************************************
 Выгрузка информации о начислениях, о произведенных платежах и характеристиках объектов жилищного фонда
*********************************************************************************************************************/
 
-- Возвращает новый ID записи запроса сведений о начислениях в заданном районе.
FUNCTION  AllocateNewHspRequestID(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Обрабатывает разобранные данные ответа на запрос с использованием ВС «Выгрузка из ГИС ЖКХ ответов поставщиков
жилищно-коммунальных услуг на запросы о наличии задолженности по оплате».
Параметры:

• iMessageID - ID входящего сообщения СМЭВ-3;
  
• iDataRootTagID - ID тега ExportDebtRequestsResponse;
  
• Log - протокол;
  
• iLogLevel - уровень отступа для протоколирования;
  
• iErrorCount - количество сбоев в процессе обработки;
  
• iWarningCount - количество предупреждений в процессе обработки;
  
• iAudOriginID - ID источника события для аудита;
  
• sAudNotes - дополнительные примечания для аудита.

FUNCTION AllocateNewHspRequestID(iRegionID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает новый ID записи запроса сведений о начислениях в заданном районе.

PROCEDURE ProcessHSPRResults(
  iRegionID PLS_INTEGER, iCallID PLS_INTEGER, iRcpPDocID PLS_INTEGER,
  iTaskRecID PLS_INTEGER, LOG IN OUT NOCOPY uszn.pkServerOps.TServerOpLog,
  iErrorCount IN OUT NOCOPY PLS_INTEGER, iWarningCount IN OUT NOCOPY PLS_INTEGER, iLogLevel PLS_INTEGER,
  iAudOriginID PLS_INTEGER, sAudNotes VARCHAR2);
 
END;
 
/
CREATE OR REPLACE PACKAGE BODY uszn.pkSisHcsSmev IS
 
Resource_Busy EXCEPTION;
PRAGMA exception_init(Resource_Busy, -54);
 
-- Ключи видов сведений:
-- -- Выгрузка из ГИС ЖКХ ответов поставщиков жилищно-коммунальных услуг на запросы о наличии задолженности по оплате
IDK_RgnID_ExportDebtRq      CONSTANT PLS_INTEGER := 0;
IDK_ID_ExportDebtRq         CONSTANT PLS_INTEGER := 72;
 
/*********************************************************************************************************************
 Типы данных для ВС "Выгрузка из ГИС ЖКХ ответов поставщиков жилищно-коммунальных услуг на запросы о наличии

Обрабатывает данные последнего ответа на запрос по ВС “Выгрузка информации о начислениях, о произведенных платежах
и характеристиках объектов жилищного фонда”.
Параметры:

• iRegionID, iCallID - ключ записи об отправке запроса;
  
• iRcpPDocID - ID документа “Сведения о предоставленных и оплаченных ЖКУ и услугах связи”, class_id=4629; null, если обрабатываются все документы, включённые в запрос;
  
• iTaskRecID - ID записи серверной операции; null, если запуск выполняется без серверной операции;
  
• Log - протокол обработки;
  
• iErrorCount - количестсво сбоев при обработке;
  
• iWarningCount - количестсво предупреждений при обработке;
  
• iLogLevel - стартовый уровень отступа в протоколе;
  
• iAudOriginID - ID источника события для аудита;
  
• sAudNotes - примечаня для аудита.