XFS-сервис класса CIM для DORS PMU-820

XFS-сервис для DORS PMU-820 поддерживает стандарт CEN/XFS версии 3.20. XFS-сервис обратно совместим с более ранними версиями стандарта CEN/XFS. В данном разделе описаны отличия в реализации XFS-сервиса от стандарта CEN/XFS версии 3.20 для устройств приема наличных (см. Extensions for Financial Services (XFS) interface specification Release 3.20 - Part 15: Cash-In Module Device Class Interface - Programmer’s Reference).

Модели устройства

XFS-сервис управляет следующими моделями DORS PMU-820:

  • DORS PMU-820M0 – устройство оснащено шаттером, принятые банкноты складируются в приемном кармане (escrow);

  • DORS PMU-820M1 – устройство оснащено шаттером, принятые банкноты складируются напрямую в кассету (сумку).

  • DORS PMU-820M2 – шаттер в устройстве отсутствует, принятые банкноты складируются напрямую в кассету (сумку).

../../_images/pmu820.png

Рисунок 29. Внешний вид DORS PMU-820 (слева – DORS PMU-820M0/DORS PMU-820M1, справа – DORS PMU-820M2 в составе DORS ADM-2030)

1 – подающий карман;

2 – карман отбраковки;

3 – шаттер (в DORS PMU-820M0 за ним находится приемный карман);

4 – лицевая панель для доступа к тракту DORS PMU-820M2.

Файлы XFS-сервиса

  • shqPS.CIM.DORS-PMU820.exe;

  • shqSPCIM.dll;

  • PMU820Swith.exe;

  • pmu820_persistents.xml (файл подписывается) – счетчики банкнот, настройки номиналов, кассеты и статусы операций приема. При повреждении структуры, удалении или переименовании данного файла создается новый файл pmu820_persistents.xml. Поврежденный файл при этом переименовывается.

Настройки XFS-сервиса

Раздел реестра: [HKEY_LOCAL_MACHINE\SOFTWARE\XFS\PHYSICAL_SERVICES\CIM-DORS-PMU820]

Параметры реестра:

  • PORT – наименование порта, к которому подключено устройство.

  • CASSETTE_CAPACITY – емкость кассеты в банкнотах. Возможные значения: от 1 до 30000. По умолчанию –15000. Емкость (максимум) логической кассеты устанавливается в 80% от установленного значения CASSETTE_CAPACITY. Емкость (максимум) физической кассеты определяется значением CASSETTE_CAPACITY. При достижении 80% от емкости статус логической кассеты перейдет в состояние HIGH («близка к переполнению»). Если после складирования пачки банкнот значение CASSETTE_CAPACITY будет достигнуто или превышено, то прием наличных останавливается, статус логической кассеты переходит в состояние FULL («переполнена»), а статус физической кассеты – в состояние HIGH.

  • DISABLE_CU_MANIPULATED – отключить отслеживание и перевод кассеты в состояние MANIPULATED (если кассета извлекалась вне рамок процедуры инкассации). Вставка извлеченной кассеты после проведения инкассации всегда устанавливает кассете рабочее состояние. Возможные значения:

    • 0, false, no – извлечение кассеты вне процедуры инкассации приведет к блокировке купюроприемника;

    • любое другое значение (по умолчанию) – извлечение кассеты вне процедуры инкассации допустимо.

  • DisplayControl – включить/отключить изменение анимации на дисплее при возникновении сбойных ситуаций. Возможные значения:

    • 0, false, no – управление дисплеем устройства не выполняется. Купюпрориемник самостоятельно независимо принимает решение, что показывать на дисплее.

    • любое другое значение (по умолчанию) – отображается базовый экран купюроприемника. В случаях возникновения сбоев меняется на анимацию устранения замятия и обратно после восстановления работы.

  • EXP_REDUCTION_TO_ZERO – приведение валют к нулевой экспоненте. Возможные значения:

    • 0, false, no – номиналы банкнот не будут отличаться от используемых устройством;

    • любое другое значение (по умолчанию) – номиналы будут иметь свои действительные значения, указанные на банкнотах (значение выходного параметра sExponent команды WFS_INF_CIM_CURRENCY_EXP – 0).

  • LIMIT_STACKER – максимальное количество банкнот, которое может принять устройство в процессе выполнения одной команды WFS_CMD_CIM_CASH_IN. Для DORS PMU-820M0 – емкость приемного кармана. Возможные значения: от 1 до 200. По умолчанию – 200.

  • Model – модель устройства. Необязательный параметр. Создается и изменяется автоматически в процессе работы XFS-драйвера. Используется при формировании результатов некоторых информационных запросов (в т.ч. WFS_INF_CIM_CAPABILITIES) для формирования ответа, если нет связи с устройством или устройство не работает. Возможные значения:

    • U820M0 – DORS PMU-820M0

    • U820M1 – DORS PMU-820M1

    • U820M2 – DORS PMU-820M2.

    Значение по умолчанию – U820M1.

  • StackingAfterJamming M0 – включить/отключить принудительное складирование банкот, пересчитанных и распознанныех при возникновения замятия во время выполнения WFS_CMD_CIM_CASH_IN. Возможные значения:

    • 0, false, no – WFS_CMD_CIM_CASH_IN_END не складирует пересчитанные и распознанные банкноты. Счетчики пересчитанных и распознанных банкнот не изменяются;

    • любое другое значение (по умолчанию) – WFS_CMD_CIM_CASH_IN_END складирует пересчитанные и распознанные банкноты. Счетчики пересчитанных и распознанных банкнот увеличиваются.

  • TimeoutFS365Starter – задержка в секундах перед уведомлением утилиты FS365.Starter (входит в комплект ПО ПроАТМ) о готовности устройства. По умолчанию 60 секунд. Отсчет времени начинается практически сразу после запуска XFS-драйвера. Если устройство готово до того, как истек указанный период, то о отчет не прерывается. Если указанный период истек, а устройство не готово, то уведомление будет отправлено по готовности устройства без задержки. Если указанный период истек, но устройство так и перешло в состояние готовности, то уведомление отправлено не будет.

Информационные запросы

Для информационных запросов описаны отличия в их обработке и поддерживаемых значениях параметров для моделей DORS PMU-820M0, DORS PMU-820M1 и DORS PMU-820M2. Если нет доступа к настройкам из реестра, то выполнение запроса завершается с результатом WFS_ERR_SOFTWARE_ERROR.

WFS_INF_CIM_STATUS

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

Таблица 31. Поддерживаемые значения

Поле

Значения

Описание

fwDevice

WFS_CIM_DEVONLINE

Устройство готово к работе.

WFS_CIM_DEVPOWEROFF

Нет связи с устройством, питание устройства отключено.

WFS_CIM_DEVHWERROR

Аппаратная ошибка, в т.ч. замятие банкнот .

WFS_CIM_DEVBUSY

На устройстве выполняется команда.

WFS_CIM_DEVNODEVICE

Устройство недоступно.

fwSafeDoor

WFS_CIM_DOORNOTSUPPORTED

fwAcceptor

WFS_CIM_ACCOK

Прием возможен.

WFS_CIM_ACCCUSTATE

Прием возможен, возможны предупреждения:

  1. логическая кассета близка к заполнению (WFS_CIM_STATCUHIGH);

  2. заполнен карман отбраковки.

WFS_CIM_ACCCUSTOP

Прием остановлен, возможные причины:

  1. логическая кассета заполнена (WFS_CIM_STATCUFULL);

  2. логическая кассета неработоспособна (WFS_CIM_STATCUINOP);

  3. логическая кассета извлечена (WFS_CIM_STATCUMISSING);

  4. логическая кассета извлекалась вне инкассации (WFS_CIM_STATCUMANIP);

  5. устройство требует извлечения банкнот из карманов;

  6. незакрытый шаттер;

  7. произошло замятие.

WFS_CIM_ACCCUUNKNOWN

Прием остановлен, возможные причины: устройство отключено.

fwIntermediateStacker

WFS_CIM_ISNOTSUPPORTED

M1/M2 всегда.

WFS_CIM_ISEMPTY

M0 приемный карман пуст.

WFS_CIM_ISNOTEMPTY

M0 приемный карман не пустой, количество банкнот отличается от значения параметра LIMIT_STACKER.

WFS_CIM_ISFULL

M0 приемный карман заполнен, возможные причины:

  1. количество банкнот в приемном кармане совпадает со значением параметра LIMIT_STACKER;

  2. количество банкнот в приемном кармане совпадает со свободным местом в кассете: значение ulMaximum (lppPhysical) - значение ulCount (lppPhysical) в ответе на запрос WFS_INF_CIM_CASH_UNIT_INFO.

WFS_CIM_ISUNKNOWN

M0 нет связи с устройством, питание устройства отключено.

fwStackerItems

WFS_CIM_NOITEMS

M1/M2 всегда.

WFS_CIM_NOITEMS

M0 приемный карман пуст.

WFS_CIM_CUSTOMERACCESS

M0 в приемном кармане есть банкноты (датчик кармана).

WFS_CIM_ACCESSUNKNOWN

M0 нет связи с устройством, питание устройства отключено.

fwBanknoteReader

WFS_CIM_BNROK

WFS_CIM_BNRUNKNOWN

bDropBox

FALSE

lppPositions

lppPositions

lpszExtra

lpszExtra

dwGuidLights

WFS_CIM_GUIDANCE_NOT_AVAILABLE

wDevicePosition

WFS_CIM_DEVICEPOSNOTSUPP

usPowerSaveRecoveryTime

0

wMixedMode

WFS_CIM_MIXEDMEDIANOTACTIVE

wAntiFraudModule

WFS_CIM_AFMNOTSUPP
Таблица 32. lppPositions

Поле

Значения

Описание

fwPosition

WFS_CIM_POSINTOP

Подающий карман

WFS_CIM_POSOUTCENTER

Карман отбраковки

WFS_CIM_POSOUTBOTTOM

Приемный карман M0 или тракт M1/M2

fwShutter

WFS_CIM_SHTNOTSUPPORTED

Шаттер отсутствует (для fwPosition: WFS_CIM_POSINTOP)

WFS_CIM_SHTCLOSED

Шаттер закрыт (для fwPosition: WFS_CIM_POSOUTBOTTOM)

WFS_CIM_SHTOPEN

Шаттер открыт (для fwPosition: WFS_CIM_POSOUTBOTTOM)

WFS_CIM_SHTJAMMED

Шаттер заклинило (для fwPosition: WFS_CIM_POSOUTBOTTOM)

fwPositionStatus

WFS_CIM_PSEMPTY

Подающий карман/карман отбраковки/промежуточный стекер пустой

WFS_CIM_PSNOTEMPTY

Подающий карман/карман отбраковки/промежуточный стекер не пустой

WFS_CIM_PSUNKNOWN

Состояние неизвестно: устройство отключено или значение fwDevice отлично от WFS_CIM_DEVONLINE или WFS_CIM_DEVBUSY.

WFS_CIM_PSNOTSUPPORTED

M1/M2 всегда (для fwPosition: WFS_CIM_POSOUTBOTTOM).

fwTransport

WFS_CIM_TPOK

Верхний датчик тракта не перекрыт/нижние датчики тракта не перекрыты/во вторичном слистователе нет банкнот

WFS_CIM_TPINOP

Верхний датчик тракта перекрыт/один или два нижних датчика тракта перекрыты/Во вторичном слистователе есть банкноты

WFS_CIM_TPUNKNOWN

Состояние датчика/датчиков/наличие банкнот во вторичном слистывателе неизвестно

fwTransportStatus

WFS_CIM_TPSTATEMPTY

Верхний датчик тракта не перекрыт/нижние датчики тракта не перекрыты/во вторичном слистователе нет банкнот

WFS_CIM_TPSTATNOTEMPTYCUST

Верхний датчик тракта перекрыт/один или два нижних датчика тракта перекрыты/во вторичном слистователе есть банкноты

WFS_CIM_TPSTATNOTEMPTY_UNK

Состояние датчика/датчиков/наличие банкнот во вторичном слистывателе неизвестно
Таблица 33. lpszExtra

Поле

Значения

Описание

VENDOR

DORS [SYSTEMA]

PRODUCT

ProAtm/Xfs

VERSION

X.X.X.XXXXX

Версия ПроАТМ/XFS.

DEVICE

DORS PMU820

SERIAL

D820-XXX-XXXXXXXX

Серийный номер устройства.

VARIANT

U820M0

DORS PMU-820M0;

U820M1

DORS PMU-820M1;

U820M2

DORS PMU-820M2.

VERSION_CONTROLLER

X.X.XXXX

Версия прошивки устройства.

VERSION_VALIDATOR

X.X.XXX

Версия валидатора.

VERSION_CURRENCY_BASE

X.XX.XX

Версия базы валют.

VERSION_CCM

X.X.XXXX

Версия модуля CCM.

JAMMED

FALSE

Замятия нет.

TRUE

Обнаружено замятие.

Примечания

  1. Если WFS_INF_CIM_STATUS отправлен в процессе выполнения какой-либо команды, то в случае успешного выполнения он вернет информацию о состоянии устройства на момент запускма команды.

WFS_INF_CIM_CAPABILITIES

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

Таблица 34. Поддерживаемые значения

Поле

Значения

wClass

WFS_SERVICE_CLASS_CIM

fwType

WFS_CIM_SELFSERVICEBILL

wMaxCashInItems

Значение параметра LIMIT_STACKER

bCompound

FALSE

bShutter

TRUE

bShutterControl

FALSE

bSafeDoor

FALSE

bCashBox

FALSE

bRefill

FALSE

fwIntermediateStacker

Значение параметра LIMIT_STACKER M0

0 M1/M2

bItemsTakenSensor

TRUE

bItemsInsertedSensor

TRUE

fwPositions

WFS_CIM_POSINTOP, WFS_CIM_POSOUTCENTER, WFS_CIM_POSOUTBOTTOM

fwExchangeType

WFS_CIM_EXBYHAND

fwRetractAreas

WFS_CIM_RA_NOTSUPP

fwRetractTransportActions

WFS_CIM_NOTSUPP

fwRetractStackerActions

WFS_CIM_NOTSUPP

lpszExtra

lpszExtra

dwGuidLights

WFS_CIM_GUIDANCE_NOT_AVAILABLE

dwItemInfoTypes

NULL

bCompareSignatures

FALSE

bPowerSaveControl

FALSE

bReplenish

FALSE

fwCashInLimit

WFS_CIM_LIMITNOTSUPP

fwCountActions

WFS_CIM_COUNTNOTSUPP

bDeviceLockControl

FALSE

wMixedMode

WFS_CIM_MIXEDMEDIANOTSUPP

bMixedDepositAndRollback

FALSE

bAntiFraudModule

FALSE
Таблица 35. lpszExtra

Поле

Значения

Описание

VENDOR

DORS [SYSTEMA]

PRODUCT

ProAtm/Xfs

VERSION

X.X.X.XXXXX

Версия ПроАТМ/XFS.

DEVICE

DORS PMU820

WFS_INF_CIM_CASH_UNIT_INFO

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

Не предусмотрены.

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

Таблица 36. lpCashInfo

Поле

Значения

usCount

1

lppCashIn

lppCashIn
Таблица 37. lppCashIn

Поле

Значения

usNumber

1

fwType

WFS_CIM_TYPECASHIN

fwItemType

WFS_CIM_CITYPALL, WFS_CIM_CITYPUNFIT

cUnitID

LCAS1

cCurrencyID

Код валюты

ulValues

0

ulCashInCount

По стандарту

ulCount

По стандарту

ulMaximum

80% от значения параметра CASSETTE_CAPACITY

usStatus

WFS_CIM_STATCUOK

WFS_CIM_STATCUFULL

WFS_CIM_STATCUHIGH

WFS_CIM_STATCUINOP

WFS_CIM_STATCUMISSING

WFS_CIM_STATCUNOVAL

WFS_CIM_STATCUMANIP

bAppLock

По стандарту

lpNoteNumberList

По стандарту

usNumPhysicalCUs

1

lppPhysical

lppPhysical

lpszExtra

NULL

lpusNoteIDs

По стандарту

usCDMType

0

lpszCashUnitName

NULL

ulInitialCount

0

ulDispensedCount

0

ulPresentedCount

0

ulRetractedCount

0

ulRejectCount

0

ulMinimum

0
Таблица 38. lppPhysical

Поле

Значения

lpPhysicalPositionName

DROPBOX

cUnitID

PCAS1

ulCashInCount

По стандарту

ulCount

По стандарту

ulMaximum

Значение параметра CASSETTE_CAPACITY

usPStatus

WFS_CIM_STATCUOK

WFS_CIM_STATCUFULL

WFS_CIM_STATCUHIGH

WFS_CIM_STATCUINOP

WFS_CIM_STATCUMISSING

WFS_CIM_STATCUNOVAL

WFS_CIM_STATCUMANIP

bHardwareSensors

FALSE

lpszExtra

NULL

ulInitialCount

0

ulDispensedCount

0

ulPresentedCount

0

ulRetractedCount

0

ulRejectCount

0

WFS_INF_CIM_TELLER_INFO

Не поддерживается.

WFS_INF_CIM_CURRENCY_EXP

Детальное описание команды будет добавлено позднее.

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

Таблица 39. Поддерживаемые значения

Поле

Значения

Комментарий

cCurrencyID

Код валюты

Зависит от прошивки устройства

sExponent

0

Если EXP_REDUCTION_TO_ZERO не равен 0

-2

Если EXP_REDUCTION_TO_ZERO = 0

WFS_INF_CIM_BANKNOTE_TYPES

Поддерживается в соответствии со стандартом.

WFS_INF_CIM_CASH_IN_STATUS

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

Таблица 40. Поддерживаемые значения

Поле

Значения

wStatus

WFS_CIM_CIOK

WFS_CIM_CIROLLBACK M0

WFS_CIM_CIACTIVE

WFS_CIM_CIUNKNOWN

WFS_CIM_CIRESET

usNumOfRefused

По стандарту

lpNoteNumberList

По стандарту

lpszExtra

NULL

Примечания

  1. Значение usNumOfRefused неточное в силу аппаратных особенностей. В некоторых случаях устройство фиксирует отбраковку меньшего или большего числа банкнот, например, две банкноты идущие последовательно, но без зазора между собой, будут отбракованы как одна банкнота недопустимого размера.

WFS_INF_CIM_GET_P6_INFO

Не поддерживается.

WFS_INF_CIM_GET_P6_SIGNATURE

Не поддерживается.

WFS_INF_CIM_GET_ITEM_INFO

Не поддерживается.

WFS_INF_CIM_POSITION_CAPABILITIES

Не поддерживается.

WFS_INF_CIM_REPLENISH_TARGET

Не поддерживается.

WFS_INF_CIM_DEVICELOCK_STATUS

Не поддерживается.

WFS_INF_CIM_CASH_UNIT_CAPABILITIES

Не поддерживается.

Команды

Для команд описаны отличия в их выполнении и поддерживаемых значениях параметров для моделей DORS PMU-820M0, DORS PMU-820M1 и DORS PMU-820M2. Для каждой команды возможные результаты ее выполнения отсортированы по порядку диагностики неисправности XFS-сервисом. Если нет доступа к настройкам из реестра, то выполнение команды завершается с результатом WFS_ERR_SOFTWARE_ERROR.

WFS_CMD_CIM_CASH_IN_START

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

Таблица 41. Поддерживаемые значения

Поле

Значения

Описание

usTellerID

Любое

Значение игнорируется

bUseRecycleUnits

Любое

Значение игнорируется

fwOutputPosition

WFS_CIM_POSNULL

WFS_CIM_POSOUTCENTER

WFS_CIM_POSOUTBOTTOM

fwInputPosition

WFS_CIM_POSNULL

WFS_CIM_POSINTOP

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

Не предусмотрены.

Результаты

  1. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_EXCHANGEACTIVE – не закрыта транзакция инкассации. Выполните WFS_CMD_CIM_END_EXCHANGE.

  3. WFS_ERR_CIM_CASHINACTIVE – открыта транзакция приема наличных. Выполните WFS_CMD_CIM_CASH_IN_ROLLBACK, WFS_CMD_CIM_CASH_IN_END или WFS_CMD_CIM_RESET

  4. WFS_ERR_CIM_UNSUPPOSITION – указано неподдерживаемое значение fwInputPosition. Выполните команду с указанием поддерживаемого значения fwInputPosition.

  5. WFS_ERR_CIM_UNSUPPOSITION – указано неподдерживаемое значение fwOutputPosition. Выполните команду с указанием поддерживаемого значения fwOutputPosition.

  6. WFS_ERR_DEV_NOT_READY – устройство отключено или аппаратная ошибка (значение fwDevice в ответе на WFS_INF_CIM_STATUS отличается от WFS_CIM_DEVONLINE и WFS_CIM_DEVBUSY). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  7. WFS_ERR_DEV_NOT_READY – шаттер не закрыт. Выполните команду WFS_CMD_CIM_SHUTTER_CLOSE или закройте лицевую панель на DORS PMU-820M2.

  8. WFS_ERR_HARDWARE_ERROR – устройство отключено или аппаратная ошибка (не удалось получить статус устройства). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  9. WFS_ERR_DEV_NOT_READY – в приемном кармане/тракте устройства находятся банкноты (или сбоит датчик). Извлеките банкноты и выполните WFS_CMD_CIM_RESET.

  10. WFS_ERR_DEV_NOT_READY – сбой калибровки устройства. Очистите устройство от банкнот.

  11. WFS_ERR_HARDWARE_ERROR – не удалось получить или сбросить ограничения приема. Выполните WFS_CMD_CIM_RESET.

  12. WFS_SUCCESS.

События

Не предусмотрены.

Примечания

  1. WFS_CMD_CIM_CASH_IN_START очищает внутренние логи, запускает калибровку устройства и сбрасывает ограничение для транзакции приема на количество принимаемых банкнот.

  2. WFS_CMD_CIM_CASH_IN_START изменяет значения в файле pmu820_persistents.xml.

  3. Для текущей транзакции приема с помощью WFS_CMD_CIM_SET_CASH_IN_LIMIT можно установить ограничение только на количество принятых банкнот. Ограничение по сумме принятых банкнот не поддерживается.

  4. Для DORS PMU-820M1 и DORS PMU-820M2 при выполнении WFS_CMD_CIM_CASH_IN_START наличие банкнот за шаттером не контролируется.

  5. Сбой очистки логов не препятствует успешному выполнению WFS_CMD_CIM_CASH_IN_START.

WFS_CMD_CIM_CASH_IN

Примечание

В силу аппаратных особенностей пересчет и распознавание банкнот могут быть остановлены по причине заполнения кармана отбраковки, емкость которого ограничена 20-25 отбраковками. Это соответствует 20-50 банкнотам в зависимости от причин отбраковки (слипшиеся банкноты и пр.).

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

Не предусмотрены.

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

Таблица 42. Поддерживаемые значения

Поле

Значения

lpNoteNumberList

По стандарту

Результаты

  1. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны настройки или persistent. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_EXCHANGEACTIVE – не закрыта транзакция инкассации. Выполните WFS_CMD_CIM_END_EXCHANGE.

  3. WFS_ERR_CIM_NOCASHINACTIVE – не открыта транзакция приема наличных. Выполните WFS_CMD_CIM_CASH_IN_START.

  4. WFS_ERR_CIM_TOOMANYITEMS M0 – заполнен приемный карман (fwIntermediateStacker: WFS_CIM_ISFULL). Складируйте (выполните WFS_CMD_CIM_CASH_IN_END) или верните (выполните WFS_CMD_CIM_CASH_IN_ROLLBACK) пересчитанные банкноты.

  5. WFS_ERR_CIM_CASHUNITERROR – кассета извлечена, заполнена или повреждена (значение usStatus для логической кассеты в ответе на запрос WFS_INF_CIM_CASH_UNIT_INFO отлично от WFS_CIM_STATCUOK или WFS_CIM_STATCUHIGH). Замените кассету.

  6. WFS_ERR_DEV_NOT_READY M0 – устройство отключено или аппаратная ошибка (значение поля fwDevice в ответе на запрос WFS_INF_CIM_STATUS отлично от WFS_CIM_DEVONLINE или WFS_CIM_DEVBUSY). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  7. WFS_ERR_HARDWARE_ERROR – устройство отключено или аппаратная ошибка (не удалось получить статус устройства). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  8. WFS_ERR_DEV_NOT_READY M1/M2 – устройство требует извлечения банкнот из карманов (или сбоят датчики). Извлеките банкноты из кармана отбраковки и приемного кармана.

  9. WFS_ERR_HARDWARE_ERROR M0 – устройство отключено или аппаратная ошибка (не удалось получить конфигурацию устройства). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  10. WFS_ERR_CIM_TOOMANYITEMS M0 – достигнуто ограничение приема наличных. Складируйте (выполните WFS_CMD_CIM_CASH_IN_END) или верните (выполните WFS_CMD_CIM_CASH_IN_ROLLBACK) пересчитанные банкноты.

  11. WFS_ERR_DEV_NOT_READY M0 – устройство требует извлечения банкнот из карманов (или сбоят датчики). Извлеките банкноты из кармана отбраковки и приемного кармана.

  12. WFS_ERR_CIM_POSITION_NOT_EMPTY – в результате предыдущего пересчета заполнен карман отбраковки (внутренний счетчик устройства достиг ограничения). Извлеките банкноты из кармана отбраковки.

  13. WFS_ERR_CIM_SHUTTERNOTCLOSED – шаттер не закрыт. Выполните WFS_CMD_CIM_SHUTTER_CLOSE или закройте лицевую панель на DORS PMU-820M2.

  14. WFS_ERR_CIM_POSITION_NOT_EMPTY – в кармане отбраковки обнаружены банкноты (появились или остались после предыдущего пересчета без отбраковки). Извлеките банкноты из кармана отбраковки.

  15. WFS_ERR_DEV_NOT_READY M0 – при нулевых счетчиках в приемном кармане обнаружены банкноты. Извлеките банкноты и еще раз выполните WFS_CMD_CIM_CASH_IN.

  16. WFS_ERR_DEV_NOT_READY M1/M2 – банкноты на путях движения и нет данных о неисправности. Извлеките банкноты и еще раз выполните WFS_CMD_CIM_CASH_IN.

  17. WFS_ERR_DEV_NOT_READY – предыдущий пересчет завершился с замятием. Извлеките банкноты и еще раз выполните WFS_CMD_CIM_CASH_IN.

  18. WFS_ERR_HARDWARE_ERROR – сбой складирования банкнот с целью устранения замятия. Выполните WFS_CMD_CIM_RESET.

  19. WFS_ERR_CIM_CASHUNITERROR – складирование банкнот с целью устранения замятие привело к заполнению кассеты. Замените кассету.

  20. WFS_ERR_CIM_POSITION_NOT_EMPTY – в кармане отбраковки остались банкноты предыдущей транзакции. Извлеките банкноты из кармана отбраковки.

  21. WFS_ERR_DEV_NOT_READY – сбой очистки памяти предыдущего пересчета. Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  22. WFS_ERR_CIM_TOOMANYITEMS – достигнуто ограничение приема наличных. Складируйте (выполните WFS_CMD_CIM_CASH_IN_END) или верните (выполните WFS_CMD_CIM_CASH_IN_ROLLBACK) пересчитанные банкноты.

  23. WFS_ERR_HARDWARE_ERROR – превышено ограничение приема наличных. Выполните WFS_CMD_CIM_RESET.

  24. WFS_ERR_HARDWARE_ERROR – устройство отключено в процессе ожидания банкнот в подающем кармане или возникла аппаратная ошибка (не удалось получить статус устройства). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  25. WFS_ERR_CIM_CASHUNITERROR – кассета извлечена в процессе ожидания банкнот в подающем кармане. Замените кассету.

  26. WFS_ERR_CIM_NOITEMS – устройство не смогло начать пересчет и распознавание банкнот.

  27. WFS_ERR_DEV_NOT_READY – пересчет и распознавание завершились, не получив ожидаемый результат пересчета. Выполните WFS_CMD_CIM_RESET.

  28. WFS_ERR_HARDWARE_ERROR – зафиксировано замятие или банкнота-диверсант или устройство требует вернуть деньги. Выполните WFS_CMD_CIM_RESET.

  29. WFS_ERR_CIM_CASHUNITERROR – в процессе пересчета и распознавания была извлечена кассета. Замените кассету.

  30. WFS_ERR_HARDWARE_ERROR – прочие ошибки пересчета и распознавания, исключая замятие банкнот. Выполните WFS_CMD_CIM_RESET.

  31. WFS_ERR_DEV_NOT_READY –– устройство отключено в процессе пересчета банкнот или возникла аппаратная ошибка (не удалось получить статус устройства). Извлеките банкноты, проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  32. WFS_ERR_CIM_NOITEMS – все банкноты попали в карман отбраковки.

  33. WFS_ERR_CIM_NOITEMS – пересчет и распознавание (вращение моторов) завершилось без банкнот.

  34. WFS_ERR_DEV_NOT_READY M0 – сумма пересчетов и распознаваний не совпадают с показаниями устройства.

  35. WFS_SUCCESS.

События

  • WFS_USRE_CIM_CASHUNITTHRESHOLD – поддерживается.

  • WFS_EXEE_CIM_CASHUNITERROR – кассета извлечена, заполнена, повреждена или заполнилась при устранении замятия.

  • WFS_EXEE_CIM_INPUT_P6 – не поддерживается.

  • WFS_EXEE_CIM_INPUTREFUSE – в процессе пересчета и распознавания часть банкнот попала в карман отбраковки (wPosition: WFS_CIM_POSOUTCENTER). Одно событие для всех отбракованных банкнот (точное количество банкнот определить невозможно). Примерное количество отбраковок можно получить, выполнив команду WFS_INF_CIM_CASH_IN_STATUS.

  • WFS_EXEE_CIM_NOTEERROR – не поддерживается.

  • WFS_EXEE_CIM_SUBCASHIN – не поддерживается.

  • WFS_SRVE_CIM_ITEMSINSERTED – только для подающего кармана (wPosition: WFS_CIM_POSINTOP).

  • WFS_SRVE_CIM_ITEMSTAKEN – только для подающего кармана (wPosition: WFS_CIM_POSINTOP) при извлечении банкнот до слистывания первой.

  • WFS_SRVE_CIM_ITEMSPRESENTED – только для кармана отбраковки (wPosition: WFS_CIM_POSOUTCENTER).

  • WFS_EXEE_CIM_INFO_AVAILABLE – не поддерживается.

  • WFS_EXEE_CIM_INSERTITEMS – если хотя бы один номинал разрешен к приему.

Примечания

  1. Если к приему разрешен хотя бы один номинал, то выполнение WFS_CMD_CIM_CASH_IN ждет, когда в подающем кармане появятся банкноты. Если запрещен прием всех номиналов, то после получения команды WFS_CMD_CIM_CASH_IN ожидается ее отмена.

  2. Выполнение WFS_CMD_CIM_CASH_IN изменяет значения в файле pmu820_persistents.xml.

  3. В DORS PMU-820M0 пересчитанные и распознанные банкноты остаются в приемном кармане, а в DORS PMU-820M1 и DORS PMU-820M2 – складируются напрямую в кассету.

  4. Когда устройство фиксирует замятие, на его мониторе появляется анимация с перечнем дальнейших действий клиента. В процессе устранения замятия после выполнения WFS_CMD_CIM_CASH_IN анимация на мониторе устройства отключается.

  5. В DORS PMU-820M1 и DORS PMU-820M2 открытие шаттера во время выполнения пересчета и распознавания банкнот может привести к неверному результату пересчета.

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

  7. Пересчет и распознавание при приближении к ограничению приема (остается от одной до четырех банкнот) останавливаются в случает отбраковки последних банкнот. Такое поведение связано с высокой вероятностью замятия при попытке отбраковать распознанную банкноту, перемещаемую в отбраковку из-за достижения ограничения пересчета.

  8. По умолчанию количество банкнот, которое может быть принято за одну команду WFS_CMD_CIM_CASH_IN, ограничено значением параметра LIMIT_STACKER. Для того чтобы ограничить количество банкнот, которое может быть принято за транзакцию приема, выполните команду WFS_CMD_CIM_SET_CASH_IN_LIMIT. В этом случае для каждой команды WFS_CMD_CIM_CASH_IN сравниваются значение входного параметра ulTotalItemsLimit команды WFS_CMD_CIM_SET_CASH_IN_LIMIT минус количество уже принятых банкнот за текущую транзакцию (N) и значение параметра LIMIT_STACKER:

  • Если (ulTotalItemsLimit - N) > LIMIT_STACKER, то при выполнении WFS_CMD_CIM_CASH_IN будет принято не более LIMIT_STACKER банкнот.

  • Если (ulTotalItemsLimit - N) < LIMIT_STACKER, то при выполнении WFS_CMD_CIM_CASH_IN будет принято не более ulTotalItemsLimit - N банкнот.

  • Если ulTotalItemsLimit - N = 0, то WFS_CMD_CIM_CASH_IN завершится с результатом WFS_ERR_CIM_TOOMANYITEMS, ни одной банкноты пересчитано и принято не будет.

WFS_CMD_CIM_CASH_IN_END

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

Не предусмотрены.

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

Таблица 43. lpCashInfo

Поле

Значения

usCount

1

lppCashIn

См. lppCashIn запроса WFS_INF_CIM_CASH_UNIT_INFO

Результаты

  1. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_EXCHANGEACTIVE – не закрыта транзакция инкассации. Выполните WFS_CMD_CIM_END_EXCHANGE.

  3. WFS_ERR_CIM_NOCASHINACTIVE – не открыта транзакция приема наличных. Выполните WFS_CMD_CIM_CASH_IN_START.

  4. WFS_ERR_DEV_NOT_READY – устройство отключено (значение WFS_CIM_DEVPOWEROFF поля fwDevice в ответе на запрос WFS_INF_CIM_STATUS). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  5. WFS_ERR_CIM_CASHUNITERROR M0 – кассета извлечена, заполнена или повреждена (значение usStatus для логической кассеты в ответе на запрос WFS_INF_CIM_STATUS отлично от WFS_CIM_STATCUOK или WFS_CIM_STATCUHIGH). Замените кассету.

  6. WFS_ERR_DEV_NOT_READY M0 – не закрыт шаттер (значение поля fwShutter приемного кармана в ответе на запрос WFS_INF_CIM_STATUS отлично от WFS_CIM_SHTCLOSED). Выполните WFS_CMD_CIM_SHUTTER_CLOSE или закройте лицевую панель на DORS PMU-820M2.

  7. WFS_ERR_HARDWARE_ERROR – устройство отключено или аппаратная ошибка (не удалось получить статус устройства). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  8. WFS_ERR_CIM_NOITEMS – пересчет и распознавание завершены без банкнот.

  9. WFS_ERR_HARDWARE_ERROR M0– устройство отключено или его статус получить не удалось. Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  10. WFS_ERR_HARDWARE_ERROR M0 – сумма пересчетов и распознаваний не совпадает с показаниями устройства.

  11. WFS_ERR_DEV_NOT_READY M0 – предыдущий пересчет завершился с замятием при отключенном принудительном складировании пересчитанных и распознанных банкнот (StackingAfterJamming = 0, false или no).

  12. WFS_ERR_HARDWARE_ERROR M0 – устройство сообщает о неисправности. Выполнить WFS_CMD_CIM_RESET.

  13. WFS_ERR_HARDWARE_ERROR M0 – складирование банкнот завершилось с ошибкой. Выполнить WFS_CMD_CIM_RESET.

  14. WFS_ERR_HARDWARE_ERROR M0 – после сбойного складирования банкнот не удалось получить статус устройства. Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  15. WFS_ERR_CIM_CASHUNITERROR M0 – после складирования банкнот статус кассеты WFS_CIM_STATCUMISSING или банкноты остались в приемном кармане.

  16. WFS_SUCCESS.

События

  • WFS_USRE_CIM_CASHUNITTHRESHOLD – поддерживается.

  • WFS_SRVE_CIM_CASHUNITINFOCHANGED – поддерживается.

  • WFS_EXEE_CIM_CASHUNITERROR – кассета извлекается или извлечена.

  • WFS_EXEE_CIM_INPUT_P6 – не поддерживается.

  • WFS_EXEE_CIM_INFO_AVAILABLE – не поддерживается.

  • WFS_EXEE_CIM_NOTEERROR – не поддерживается.

  • WFS_SRVE_CIM_ITEMSTAKEN – не поддерживается.

  • WFS_SRVE_CIM_ITEMSPRESENTED – не поддерживается.

  • WFS_SRVE_CIM_COUNTS_CHANGED – не поддерживается.

Примечания

  1. Выполнение WFS_CMD_CIM_CASH_IN_END на DORS PMU-820M1 и DORS PMU-820M2 только завершает транзакцию приема наличных.

  2. При ошибках выполнения команды транзакция приема наличных будет закрыта со статусом WFS_CIM_CIUNKNOWN с потерей результатов пересчета.

  3. WFS_CMD_CIM_CASH_IN_END не сбрасывает ограничение для транзакции приема. Это делает команда WFS_CMD_CIM_CASH_IN_START.

  4. WFS_CMD_CIM_CASH_IN_END изменяет значения в файле pmu820_persistents.xml.

  5. Конструкция DORS PMU-820M0 допускает, что в процессе принудительного складирования банкнот, пересчитанных и распознанных при возникновении замятия во время выполнения WFS_CMD_CIM_CASH_IN (StackingAfterJamming), часть этих банкнот останется на колесах укладчика приемного кармана.

WFS_CMD_CIM_CASH_IN_ROLLBACK

Примечание

Поддерживается только для DORS PMU-820M0.

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

Не предусмотрены

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

Таблица 44. Поддерживаемые значения

Поле

Значения

lpCashInfo

NULL

Результаты

  1. WFS_ERR_UNSUPP_COMMAND M1/M2 – модель устройства отличается от DORS PMU-820M0.

  2. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  3. WFS_ERR_CIM_EXCHANGEACTIVE – не закрыта транзакция инкассации. Выполнить WFS_CMD_CIM_END_EXCHANGE.

  4. WFS_ERR_CIM_NOCASHINACTIVE – не открыта транзакция приема наличных. Выполнить WFS_CMD_CIM_CASH_IN_START.

  5. WFS_ERR_DEV_NOT_READY – устройство отключено (значение WFS_CIM_DEVPOWEROFF поля fwDevice в ответе на запрос WFS_INF_CIM_STATUS). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  6. WFS_ERR_CIM_NOITEMS – пересчет и распознавание завершены без банкнот.

  7. WFS_SUCCESS.

События

  • WFS_USRE_CIM_CASHUNITTHRESHOLD – не поддерживается.

  • WFS_EXEE_CIM_CASHUNITERROR – не поддерживается.

  • WFS_EXEE_CIM_INPUT_P6 – не поддерживается.

  • WFS_EXEE_CIM_INFO_AVAILABLE – не поддерживается.

  • WFS_EXEE_CIM_NOTEERROR – не поддерживается.

  • WFS_SRVE_CIM_ITEMSTAKEN – не поддерживается.

  • WFS_SRVE_CIM_ITEMSPRESENTED – генерируется при успешном выполнении WFS_CMD_CIM_CASH_IN_ROLLBACK, если в транзакции приема была распознана хотя бы одна банкнота.

  • WFS_SRVE_CIM_COUNTS_CHANGED – не поддерживается.

Примечания

  1. Для возврата банкнот необходимо открыть шаттер.

  2. WFS_CMD_CIM_CASH_IN_ROLLBACK не сбрасывает ограничение для транзакции приема. Это делает команда WFS_CMD_CIM_CASH_IN_START.

  3. WFS_CMD_CIM_CASH_IN_ROLLBACK изменяет значения в файле pmu820_persistents.xml.

WFS_CMD_CIM_RETRACT

Не поддерживается

WFS_CMD_CIM_OPEN_SHUTTER

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

Таблица 45. Поддерживаемые значения

Поле

Значения

lpfwPosition

WFS_CIM_POSNULL

WFS_CIM_POSOUTBOTTOM

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

Не предусмотрены.

Результаты

  1. WFS_ERR_SOFTWARE_ERROR M0/M1 – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_EXCHANGEACTIVE M0/M1 – не закрыта транзакция инкассации. Выполните WFS_CMD_CIM_END_EXCHANGE.

  3. WFS_ERR_CIM_UNSUPPOSITION M0/M1 – указано неподдерживаемое значение lpfwPosition. Выполните команду с указанием поддерживаемого значения lpfwPosition.

  4. WFS_ERR_CIM_SHUTTEROPEN M0/M1 – шаттер уже открыт.

  5. WFS_ERR_DEV_NOT_READY – устройство отключено (значение WFS_CIM_DEVPOWEROFF поля fwDevice в ответе на запрос WFS_INF_CIM_STATUS). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  6. WFS_ERR_SHUTTERNOTOPEN M0/M1 – не удалось открыть шаттер.

  7. WFS_SUCCESS.

Примечания

  1. Для DORS PMU-820M0 команду WFS_CMD_CIM_OPEN_SHUTTER следует выполнять для возврата принятых банкнот и устранения замятия. Для DORS PMU-820M1 и DORS PMU-820M2 – для устранения замятия, т.к. возврат принятых банкнот в данной модели не предусмотрен.

  2. Для DORS PMU-820M0 открытие шаттера во время транзакции приема наличных сбрасывает счетчики распознанных и отбракованных банкнот.

  3. Для DORS PMU-820M2 команду WFS_CMD_CIM_OPEN_SHUTTER всегда завершается с результатом WFS_SUCCESS.

  4. При сбойном состоянии шаттера запускается механизм самовосстановления, аналогичный перезагрузке модуля CCM при выполнении WFS_CMD_CIM_RESET.

WFS_CMD_CIM_CLOSE_SHUTTER

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

Таблица 46. Поддерживаемые значения

Поле

Значения

lpfwPosition

WFS_CIM_POSNULL

WFS_CIM_POSOUTBOTTOM

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

Не предусмотрены.

Результаты

  1. WFS_ERR_SOFTWARE_ERROR M0/M1 – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_EXCHANGEACTIVE M0/M1 – не закрыта транзакция инкассации. Выполните WFS_CMD_CIM_END_EXCHANGE.

  3. WFS_ERR_CIM_UNSUPPOSITION M0/M1 – указано неподдерживаемое значение lpfwPosition. Выполните команду с указанием поддерживаемого значения lpfwPosition.

  4. WFS_ERR_CIM_SHUTTERCLOSED M0/M1 – шаттер уже закрыт.

  5. WFS_ERR_DEV_NOT_READY – устройство отключено (значение WFS_CIM_DEVPOWEROFF поля fwDevice в ответе на запрос WFS_INF_CIM_STATUS). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  6. WFS_ERR_CIM_SHUTTERNOTCLOSED M0/M1 – не удалось закрыть шаттер или открыта верхняя крышка устройства.

  7. WFS_SUCCESS.

Примечания

  1. Для DORS PMU-820M2 команду WFS_CMD_CIM_CLOSE_SHUTTER всегда завершается с результатом WFS_SUCCESS.

  2. При сбойном состоянии шаттера запускается механизм самовосстановления, аналогичный перезагрузке модуля CCM при выполнении WFS_CMD_CIM_RESET.

WFS_CMD_CIM_SET_TELLER_INFO

Не поддерживается.

WFS_CMD_CIM_SET_CASH_UNIT_INFO

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

Таблица 47. lpCashInfo

Поле

Значения

usCount

1

lppCashIn

lppCashIn
Таблица 48. lppCashIn

Поле

Значения

Описание

fwType

Совпадает с текущим

fwItemType

Совпадает с текущим

cUnitID

Любое

cCurrencyID

Совпадает с текущим

ulValues

Совпадает с текущим

ulCashInCount

Совпадает с текущим

ulCount

Совпадает с текущим

ulMaximum

Совпадает с текущим

usStatus

Любое

Значение игнорируется

bAppLock

Любое

Значение игнорируется

lpNoteNumberList

Совпадает с текущим

usNumPhysicalCUs

1

lppPhysical

lppPhysical

lpszExtra

Любое

Значение игнорируется

lpusNoteIDs

Любое

Значение игнорируется

usCDMType

Любое

Значение игнорируется

lpszCashUnitName

Любое

Значение игнорируется

ulInitialCount

Любое

Значение игнорируется

ulDispensedCount

Любое

Значение игнорируется

ulPresentedCount

Любое

Значение игнорируется

ulRetractedCount

Любое

Значение игнорируется

ulRejectCount

Любое

Значение игнорируется

ulMinimum

Любое

Значение игнорируется
Таблица 49. lppPhysical

Поле

Значения

Описание

lpPhysicalPositionName

Совпадает с текущим

cUnitID

Любое

Значение игнорируется

ulCashInCount

Совпадает с текущим

ulCount

Совпадает с текущим

ulMaximum

Любое

Значение игнорируется

usPStatus

Любое

Значение игнорируется

bHardwareSensors

Любое

Значение игнорируется

lpszExtra

Любое

Значение игнорируется

ulInitialCount

Любое

Значение игнорируется

ulDispensedCount

Любое

Значение игнорируется

ulPresentedCount

Любое

Значение игнорируется

ulRetractedCount

Любое

Значение игнорируется

ulRejectCount

Любое

Значение игнорируется

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

Не предусмотрены.

Результаты

  1. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_EXCHANGEACTIVE – не закрыта транзакция инкассации. Выполните WFS_CMD_CIM_END_EXCHANGE.

  3. WFS_ERR_CIM_INVALIDCASHUNIT – номер кассеты не совпадает с текущим.

  4. WFS_SUCCESS.

События

  • WFS_USRE_CIM_CASHUNITTHRESHOLD – не поддерживается.

  • WFS_SRVE_CIM_CASHUNITINFOCHANGED – идентификаторы логической и/или физической кассеты изменены, включен/отключен прием для кассеты.

  • WFS_EXEE_CIM_CASHUNITERROR – не поддерживается.

Примечания

  1. WFS_CMD_CIM_SET_CASH_UNIT_INFO изменяет значения cUnitID (идентификаторы логической и физической кассеты) и bAppLock. Эти изменения сохраняются в файле pmu820_persistents.xml.

WFS_CMD_CIM_START_EXCHANGE

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

Таблица 50. Поддерживаемые значения

Поле

Значения

fwExchangeType

WFS_CIM_EXBYHAND

usTellerID

Любое

usCount

1

lpusCUNumList

Одна кассета с идентификатором 1

lpOutput`

Любое

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

Таблица 51. Поддерживаемые значения

Поле

Значения

lpCUInfo

lpCashInfo

Результаты

  1. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_EXCHANGEACTIVE – не закрыта транзакция инкассации. Выполните WFS_CMD_CIM_END_EXCHANGE.

  3. WFS_ERR_CIM_CASHINACTIVE (WFS_ERR_DEV_NOT_READY) – не закрыта транзакция приема наличных. Выполните команду WFS_CMD_CIM_CASH_IN_ROLLBACK, WFS_CMD_CIM_CASH_IN_END или WFS_CMD_CIM_RESET.

  4. WFS_SUCCESS.

События

  • WFS_EXEE_CIM_CASHUNITERROR – кассета извлечена.

  • WFS_EXEE_CIM_NOTEERROR – не поддерживается.

  • WFS_USRE_CIM_CASHUNITTHRESHOLD – не поддерживается.

  • WFS_SRVE_CIM_CASHUNITINFOCHANGED – не поддерживается.

Примечания

  1. Неисправности оборудования (кассета, моторы, подключении и прочее) не препятствуют началу транзакции инкассации (например, отсутсвующая кассета приведет только к генерации WFS_EXEE_CIM_CASHUNITERROR).

  2. Выполнение команды изменяет значения pmu820_persistents.xml.

WFS_CMD_CIM_END_EXCHANGE

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

Таблица 52. Поддерживаемые значения

Поле

Значения

Описание

lpCUInfo

NULL

lpCUInfo

Счетчики кассеты не изменяются.

Счетчики кассеты изменяются.
Таблица 53. lpCUInfo

Поле

Значения

usCount

1

lppCashIn

lppCashIn
Таблица 54. lppCashIn

Поле

Значения

usNumber

1

fwType

совпадает со значением lpCashInfo

fwItemType

совпадает со значением lpCashInfo

cUnitID

любое

cCurrencyID

совпадает со значением lpCashInfo

ulValues

совпадает со значением lpCashInfo

ulCashInCount

0

ulCount

0

ulMaximum

любое

usStatus

любое

bAppLock

любое

lpNoteNumberList

пустое

usNumPhysicalCUs

1

lppPhysical

lppPhysical

lpszExtra

NULL

lpusNoteIDs

любое

usCDMType

любое

lpszCashUnitName

любое

ulInitialCount

любое

ulDispensedCount

любое

ulPresentedCount

любое

ulRetractedCount

любое

ulRejectCount

любое

ulMinimum

любое
Таблица 55. lppPhysical

Поле

Значения

lpPhysicalPositionName

совпадает со значением lpCashInfo

cUnitID

любое

ulCashInCount

0

ulCount

0

ulMaximum

любое

usPStatus

любое

bHardwareSensors

любое

lpszExtra

любое

ulInitialCount

любое

ulDispensedCount

любое

ulPresentedCount

любое

ulRetractedCount

любое

ulRejectCount

любое

Результаты

  1. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_NOEXCHANGEACTIVE – не открыта транзакция инкассации. Выполните команду WFS_CMD_CIM_START_EXCHANGE.

  3. WFS_ERR_CIM_CASHUNITERROR – кассета извлечена и значение DISABLE_CU_MANIPULATED равно 0, false или no. Замените кассету.

  4. WFS_SUCCESS.

События

  • WFS_USRE_CIM_CASHUNITTHRESHOLD – не поддерживается.

  • WFS_SRVE_CIM_CASHUNITINFOCHANGED – счетчики кассеты изменены (успешно сброшены).

  • WFS_EXEE_CIM_CASHUNITERROR – кассета извлечена.

Примечания

  1. WFS_CMD_CIM_END_EXCHANGE позволяет установить только нулевые счетчики. Не поддерживается изменение структуры кассет, изменение валют и номиналов, порогов ulMaximum/ulMinimum.

  2. Выполнение WFS_CMD_CIM_END_EXCHANGE изменяет значения в файле pmu820_persistents.xml.

WFS_CMD_CIM_OPEN_SAFE_DOOR

Не поддерживается.

WFS_CMD_CIM_RESET

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

Таблица 56. Поддерживаемые значения

Поле

Значения

Описание

lpResetIn

NULL

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

lpResetIn
Таблица 57. lpResetIn

Поле

Значения

Описание

usNumber

0

M0 Не перемещать обнаруженные в транспорте банкноты или M1/M2 переместить обнаруженные в транспорте банкноты в кассету, если банкноты обнаружены на датчиках, раcположенных после перенаправителя ближе к кассете.

1

Переместить обнаруженные в транспорте банкноты в кассету.

целое число больше 1

Принудительно сначала выключить, а потом включить устройство.

lpRetractArea

lpRetractArea

Значение игнорируется.

fwOutputPosition

любое

Значение игнорируется.
Таблица 58. lpRetractArea

Поле

Значения

Описание

fwOutputPosition

Любое

Значение игнорируется

usRetractArea

любое

Значение игнорируется

usIndex

любое

Значение игнорируется

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

Не предусмотрены.

Результаты

  1. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_EXCHANGEACTIVE CEN/XFS 3.02 или ниже – не закрыта транзакция инкассации. Выполнить WFS_CMD_CIM_END_EXCHANGE.

  3. WFS_ERR_CIM_CASHINACTIVE CEN/XFS 3.02 или ниже – открыта транзакция приема наличных. Выполнить WFS_CMD_CIM_CASH_IN_END или WFS_CMD_CIM_CASH_IN_ROLLBACK.

  4. WFS_ERR_HARDWARE_ERROR – исчерпаны попытки восстановить работу устройства, состояние устройства получить не удалось. Проверьте подключение устройства. Выполните WFS_CMD_CIM_RESET.

  5. WFS_ERR_CIM_CASHUNITERROR – исчерпаны попытки восстановить работу устройства, кассета отсутствует или зафиксировано замятие в слоте кассеты. Замените кассету. Выполните WFS_CMD_CIM_RESET.

  6. WFS_ERR_HARDWARE_ERROR – исчерпаны попытки восстановить работу устройства, но зафиксирован сбой в работе устройства. Проверьте датчики и моторы устройства. Извлеките банкноты из карманов и траспорта устройства, при их наличии. Выполните WFS_CMD_CIM_RESET.

  7. WFS_SUCCESS.

События

  • WFS_USRE_CIM_CASHUNITTHRESHOLD – не поддерживается.

  • WFS_EXEE_CIM_CASHUNITERROR – если касета извлечена или извлекается или зафиксировано замятие в слоте кассеты.

  • WFS_SRVE_CIM_MEDIADETECTED – если обнаружены банкноты в карманах или в транспорте устройства, без параметров.

  • WFS_EXEE_CIM_INPUT_P6 – не поддерживается.

  • WFS_SRVE_CIM_ITEMSTAKEN – не поддерживается.

  • WFS_EXEE_CIM_INFO_AVAILABLE – не поддерживается.

Примечания

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

  2. Выполнение WFS_CMD_CIM_RESET для DORS PMU-820M0 и DORS PMU-820M1 профилактически закрывает незакрытый шаттер.

  3. В процессе выполнения WFS_CMD_CIM_RESET последовательно сбрасываются результаты предыдущего пересчета, перезагружается модуль CCM, перезагружается устройство и подаются команды специальной электронике на отключение и включение питания.

  4. WFS_CMD_CIM_RESET закрывает активную транзакцию приема и транзакцию инкассации. При этом WFS_CMD_CIM_RESET не сбрасывает ограничение для транзакции приема. Это делает команда WFS_CMD_CIM_CASH_IN_START.

  5. Выполнение WFS_CMD_CIM_RESET изменяет значения в файле pmu820_persistents.xml.

  6. Перезагрузка устройства с банкнотами внутри или отрытым трактом аппаратно ограничена. Во время такой перезагрузке на экране устройства появится индикация «POST ERROR» с остановкой загрузки устройства. После извлечения банкнот (для DORS PMU-820M1/M2 – закрытия тракта) устройство продолжит загрузку и выйдет в работу.

  7. Для DORS PMU-820M0, если для usNumber задано значение 0 и в приемном кармане устройства остались банкноты, то WFS_CMD_CIM_RESET завершится с результатом WFS_ERR_HARDWARE_ERROR в силу аппаратных особенностей т.к. остановится загрузка устройства. Дальнейшая работа с устройством будет невозможна. Рекомендуется оставить банкноты в зоне, доступной сервис-инженеру.

WFS_CMD_CIM_CONFIGURE_CASH_IN_UNITS

Не поддерживатся.

WFS_CMD_CIM_CONFIGURE_NOTETYPES

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

В соответствии со стандартом.

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

Не предусмотрены.

Результаты

  1. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_CIM_EXCHANGEACTIVE – не закрыта транзакция инкассации. Выполните WFS_CMD_CIM_END_EXCHANGE.

  3. WFS_ERR_CIM_CASHINACTIVE – открыта транзакция приема наличных и принята хотя бы одна банкнота. Выполните WFS_CMD_CIM_CASH_IN_ROLLBACK, WFS_CMD_CIM_CASH_IN_END или WFS_CMD_CIM_RESET.

  4. WFS_ERR_DEV_NOT_READY CEN/XFS 3.03 или ниже – открыта транзакция приема наличных и принята хотя бы одна банкнота.

  5. WFS_ERR_UNSUPP_DATA – один из указанных номиналов не поддерживается устройством.

  6. WFS_ERR_DEV_NOT_READY – устройство отключено (значение WFS_CIM_DEVPOWEROFF поля fwDevice в ответе на запрос WFS_INF_CIM_STATUS). Проверьте подключение устройства, выполните WFS_CMD_CIM_RESET.

  7. WFS_ERR_HARDWARE_ERROR – не удалось получить или установить настройки устройства. Выполните WFS_CMD_CIM_RESET.

  8. WFS_SUCCESS.

Примечания

  1. WFS_CMD_CIM_CONFIGURE_NOTETYPES может выполняться, если нет активной транзакции приема наличных и, если транзакция приема наличных открыта, но ни одна банкнота еще не принята.

WFS_CMD_CIM_CREATE_P6_SIGNATURE

Не поддерживатся.

WFS_CMD_CIM_SET_GUIDANCE_LIGHT

Не поддерживатся.

WFS_CMD_CIM_CONFIGURE_NOTE_READER

Не поддерживатся.

WFS_CMD_CIM_COMPARE_P6_SIGNATURE

Не поддерживатся.

WFS_CMD_CIM_POWER_SAVE_CONTROL

Не поддерживатся.

WFS_CMD_CIM_REPLENISH

Не поддерживатся.

WFS_CMD_CIM_SET_CASH_IN_LIMIT

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

Таблица 59. Поддерживаемые значения

Поле

Значения

ulTotalItemsLimit

по стандарту

lpAmountLimit

NULL

lpAmountLimit
Таблица 60. lpAmountLimit

Поле

Значения

Описание

cCurrencyID

код валюты

код, поддерживаемый устройством, согласно ISO 4217

три пробела

ограничение для всех поддерживаемых валют

ulAmount

любое

значение игнорируется

Результаты

  1. WFS_ERR_SOFTWARE_ERROR – повреждены или недоступны либо настройки XFS-сервиса, либо файл pmu820_persistents.xml. Проверьте привилегии и предоставьте полный доступ к файлу pmu820_persistents.xml и настройкам.

  2. WFS_ERR_UNSUPP_DATA – указана неподдерживаемая валюта. Укажите в параметре cCurrencyID поддерживаемую валюту (см. выходные параметры WFS_INF_CIM_BANKNOTE_TYPES) или три пробела.

  3. WFS_ERR_CIM_EXCHANGEACTIVE – не закрыта транзакция инкассации. Выполните WFS_CMD_CIM_END_EXCHANGE (закрыть транзакцию инкасации).

  4. WFS_ERR_SEQUENCE_ERROR – выполнение команды запрошено невовремя. Выполнить WFS_CMD_CIM_CASH_IN_START (начать транзакцию приема).

  5. WFS_SUCCESS.

События

Не предусмотрены.

Примечания

  1. С помощью WFS_CMD_CIM_SET_CASH_IN_LIMIT можно установить ограничение только на количество принимаемых банкнот.

  2. Сбрасывает ограничение для транзакции приема команда WFS_CMD_CIM_CASH_IN_START.

  3. Допускается выполнить WFS_CMD_CIM_SET_CASH_IN_LIMIT после отмены одной или нескольких команд WFS_CMD_CIM_CASH_IN без внесения банкнот.

  4. Ограничение может превышать емкость свободного места в физической кассете (lppPhysical), но пересчет и распознавание банкнот при заполнении кассеты останавливаются.

WFS_CMD_CIM_CASH_UNIT_COUNT

Не поддерживатся.

WFS_CMD_CIM_DEVICE_LOCK_CONTROL

Не поддерживатся.

WFS_CMD_CIM_SET_MODE

Не поддерживатся.

WFS_CMD_CIM_PRESENT_MEDIA

Не поддерживатся.

События

WFS_SRVE_CIM_SAFEDOOROPEN

Не поддерживается.

WFS_SRVE_CIM_SAFEDOORCLOSED

Не поддерживается.

WFS_USRE_CIM_CASHUNITTHRESHOLD

Событие поддерживается в соответствии со стандартом для команд WFS_CMD_CIM_CASH_IN и WFS_CMD_CIM_CASH_IN_END.

Событие не поддерживается для команд WFS_CMD_CIM_SET_CASH_UNIT_INFO, WFS_CMD_CIM_START_EXCHANGE, WFS_CMD_CIM_END_EXCHANGE, WFS_CMD_CIM_RESET, WFS_CMD_CIM_CASH_IN_ROLLBACK.

WFS_SRVE_CIM_CASHUNITINFOCHANGED

Событие генерируется во время выполнения следующих команд:

  • WFS_CMD_CIM_CASH_IN_END – в соответствии со стандартом;

  • WFS_CMD_CIM_SET_CASH_UNIT_INFO, если идентификаторы логической и/или физической кассеты изменены, включен/отключен прием для кассеты.

  • WFS_CMD_CIM_END_EXCHANGE, если счетчики кассеты изменены (успешно сброшены).

WFS_SRVE_CIM_TELLERINFOCHANGED

Не поддерживается.

WFS_EXEE_CIM_CASHUNITERROR

Событие генерируется во время выполнения следующих команд:

  • WFS_CMD_CIM_CASH_IN, если кассета извлечена, заполнена, повреждена или заполнилась при устранении замятия.

  • WFS_CMD_CIM_CASH_IN_END, если кассета извлекается или извлечена.

  • WFS_CMD_CIM_START_EXCHANGE, если кассета извлечена.

  • WFS_CMD_CIM_END_EXCHANGE, если кассета извлечена.

  • WFS_CMD_CIM_RESET, если касета извлечена, извлекается или зафиксировано замятие в слоте кассеты.

Событие не поддерживается для команд WFS_CMD_CIM_SET_CASH_UNIT_INFO, WFS_CMD_CIM_CASH_IN_ROLLBACK.

WFS_SRVE_CIM_ITEMSTAKEN

Событие генерируется во время выполнения WFS_CMD_CIM_CASH_IN только для подающего кармана (wPosition: WFS_CIM_POSINTOP). Вне выполнения WFS_CMD_CIM_CASH_IN – только для кармана отбраковки (wPosition: WFS_CIM_POSOUTCENTER) и приемного кармана (wPosition: WFS_CIM_POSOUTBOTTOM).

WFS_SRVE_CIM_COUNTS_CHANGED

Не поддерживается.

WFS_EXEE_CIM_INPUTREFUSE

Принято решение не различать причины отбраковки банкнот.

Генерируется только одно событие во время выполнения WFS_CMD_CIM_CASH_IN для любого количества отбракованных банкнот.

Параметры

Поле

Значение

lpusReason

WFS_CIM_INVALIDBILL

WFS_SRVE_CIM_ITEMSPRESENTED

Событие генерируется во время выполнения WFS_CMD_CIM_CASH_IN для кармана отбраковки (wPosition: WFS_CIM_POSOUTCENTER), если в процессе пересчета в этот карман попали банкноты.

Событие генерируется во время выполнения WFS_CMD_CIM_CASH_IN_ROLLBACK для приемного кармана (wPosition: WFS_CIM_POSOUTBOTTOM) при наличии в нем банкнот.

WFS_SRVE_CIM_ITEMSINSERTED

Событие генерируется только для подающего кармана в рамках транзакции приема.

WFS_EXEE_CIM_NOTEERROR

Не поддерживается.

WFS_EXEE_CIM_SUBCASHIN

Не поддерживается.

WFS_SRVE_CIM_MEDIADETECTED

Поддерживается в соответствии со стандартом.

WFS_EXEE_CIM_INPUT_P6

Не поддерживается.

WFS_EXEE_CIM_INFO_AVAILABLE

Не поддерживается.

WFS_EXEE_CIM_INSERTITEMS

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

WFS_SRVE_CIM_DEVICEPOSITION

Не поддерживается.

WFS_SRVE_CIM_POWER_SAVE_CHANGE

Не поддерживается.

Дополнительная информация

Запуск и выключение устройства

При штатной работе инициализация устройства выполняется после того как специальная электроника подаст на DORS PMU-820 электропитание. Инициализация включает в себя следующие шаги:

  1. Включение питания устройства.

  2. Ожидание загрузки устройства.

  3. Установка конфигурации устройства.

Для загрузки и выхода в рабочий режим после подачи электропитания устройству требуется около 30 секунд.

В случае завершения работы XFS-сервиса питание устройства будет отключено. В случае потери связи с устройством специальная электроника включает и выключает устройство (операция длится около 35 секунд). Для полного выключения после отключения электропитания устройству требуется около 3-5 секунд.

Устранение замятия

Клиент

Терминальное ПО

Команда или событие XFS

Выбирает прием банкнот.

Просит клиента немного подождать.

Открывает транзакцию приема.

WFS_CMD_CIM_CASH_IN_START

Запускает прием наличных.

WFS_CMD_CIM_CASH_IN

WFS_EXEE_CIM_INSERTITEMS

Запрашивает банкноты.

Кладет банкноты в подающий карман.

WFS_SRVE_CIM_ITEMSINSERTED

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

Заминает банкноты.

WFS_CMD_CIM_CASH_IN завершается кодом WFS_SUCCESS или WFS_ERR_CIM_NOITEMS.

Отображает пересчитанные банкноты и предлагает продолжение или завершение приема.

Запускает прием наличных и анализирует состояние купюроприемника.

WFS_CMD_CIM_CASH_IN 1

WFS_CMD_CIM_CASH_IN завершается кодом WFS_ERR_DEV_NOT_READY.

WFS_INF_CIM_STATUS 1

Фиксирует замятие и просит клиента немного подождать.

Открывает шаттер и просит клиента извлечь все банкноты.

WFS_CMD_CIM_OPEN_SHUTTER

Забирает оставшиеся в карманах банкноты, вынимает замятые банкноты.

WFS_SRVE_CIM_ITEMSTAKEN

Подтверждает, что устранил замятие.

Закрывает шаттер.

WFS_CMD_CIM_CLOSE_SHUTTER

Запускает прием наличных (или выполняет сброс купюроприемника).

WFS_CMD_CIM_CASH_IN 2

WFS_CMD_CIM_CASH_IN завершается кодом WFS_SUCCESS или WFS_ERR_CIM_NOITEMS.

( WFS_CMD_CIM_RESET 2 )

Отображает пересчитанные банкноты и предлагает продолжение или завершение приема.
1(1,2)

О том, что в процессе приема банкнот произошло замятие говорит выполнение WFS_CMD_CIM_CASH_IN с результатом WFS_ERR_DEV_NOT_READY или статус устройства WFS_CIM_DEVHWERROR в ответе на запрос WFS_INF_CIM_STATUS. Рекомендуется выполнить WFS_CMD_CIM_CASH_IN и отправить WFS_INF_CIM_STATUS.

2(1,2)

Замятая банкнота может может быть недоступна клиенту, если он не увидит или не сможет вынуть. И при выполнении WFS_CMD_CIM_RESET и при выполнении второй команды WFS_CMD_CIM_CASH_IN такая банкнота будет сброшена в кассету, однако она будет зачислена только при выполнении WFS_CMD_CIM_CASH_IN. Рекомендуется после закрытия шаттера еще раз выполнять WFS_CMD_CIM_CASH_IN. WFS_CMD_CIM_RESET рекомендуется выполнять, если результат второй команды WFS_CMD_CIM_CASH_IN отличается от WFS_SUCCESS или WFS_ERR_CIM_NOITEMS.

Утилита PMU820Swith

PMU820Swith посылает команду специальной электронике подать на DORS PMU-820 электропитание или отключить его.

Для загрузки и выхода в рабочий режим после подачи электропитания устройству требуется около 30 секунд. Для полного выключения после отключения электропитания требуется около 3-5 секунд.

Формат запуска:

PMU820Swith.exe <параметр>

PMU820Swith.exe

Параметры запуска:

  • on – включить устройство;

  • off – выключить устройство.

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

Коды завершения работы:

  • 0 – успешное завершение работы или утилита запущена с неизвестным параметром;

  • -1 – выведен список параметров утилиты;

  • -2 – не удалось включить устройство;

  • -3 – не удалось выключить устройство.

Интервал между командой включения устройства и любой другой должен составлять не менее 30 секунд, а между командами выключения и включения устройства – не менее 3 секунд.