Команда addCurrency

Команда addCurrency добавляет валюту в справочник валют. Атрибуты записи о валюте задаются обязательным параметром currency.  

Свойства параметра currency:

Свойство

Тип данных

Описание

currencycode

целочисленный(11)

Код валюты

status

объект

Статус валюты

shortname

строковый(4)

Обозначение (сокращенное наименование)

fullname

строковый(32)

Наименование

type

строковый(1)

Тип оплаты в ФР:

  • 1 – наличными,
  • 2 – электронными,
  • 3 – предварительная оплата (аванс),
  • 4 – последующая оплата (кредит),
  • 5 – иная форма оплаты (встречное предоставление),
  • 6..9 – расширенные типы оплаты.

decpoint

числовой(11)

Точность округления:

  • -2 – до сотых,
  • -1 – до десятых,
  • 0 – до целых,
  • 1 – до десятков,
  • 2 – до сотен.

round

числовой(11)

Режим округления:

  • roundToUp – округление до ближайшего большего,
  • roundMathematical – округление математически без потери,
  • roundMathematicalWithLoss – округление математически с потерей,
  • roundToDown – округление до ближайшего меньшего,
  • roundToDownWithLoss – округление до ближайшего меньшего с потерей.
mode

объект

Параметры валюты (флаги):

  • 1 – оплата только полностью,
  • 2 – оплата без сдачи,
  • 4 – не давать сдачу,
  • 256 – запрет оплаты в чеке продажи,
  • 512 – запрет оплаты в чеке возврата,
  • 1024 – печать дополнительного чека, если оплата была валютой,
  • 2048 – запрет оплаты части чека валютой, если в чеке присутствует товар с запрещенным отделом,
  • 4096 – оплата по QR на пин-паде (только для процессингов "Аркус", "Газпромбанк" и "Инпас"),
  • 8192 – обязательный ввод суммы вручную,
  • 16384 – оплата по QR покупателя (только для банковского терминала "Инпас"),
  • 32768 – оплата по биометрии (только для процессинга "Сбербанк"),
  • 65536 – вывод информации об оплате (только для процессинга "Расчетные решения").

(см. Правила использования битовых масок)

drawer

числовой(11)

Открывать ли денежный ящик

hidden

логический

Не показывать в меню кассира

operation

строковый

Тип оплаты в программе: 

  • none – наличные,
  • certificate – оплата сертификатом,
  • processing – электронные.

payprocmodule

строковый(4096)

Дополнительные параметры валюты в формате JSON

deptsforbiddanceобъектСписок отделов, для которых запрещена оплата данной валютой
payprocdirтекстПуть до рабочей директории процессинга

Свойства объекта status:

Свойство

Тип данных

Возможные значения

Описание

Примечания

basic

логический

  • true
  • false

Является ли валюта базовой

По умолчанию false

Свойства объекта mode:

Свойство

Тип данных

Возможные значения

Описание

Примечания

denyPartialSum

логический

  • true
  • false

Запрещено оплачивать часть суммы

По умолчанию false

denyExtraSum

логический

  • true
  • false

Разрешено оплачивать только без сдачи

По умолчанию false

denyPaymentForBack

логический

  • true
  • false

Запрещено оплачивать чек возврата

По умолчанию false

denyPaymentForSale

логический

  • true
  • false

Запрещено оплачивать чек продажи

По умолчанию false

printCopyRequired

логический
  • true
  • false
Печатать копию чекаПо умолчанию false
denyPaymentAnyDeptForbiddedлогический
  • true
  • false
Запрещать оплату части чека валютой, если в чеке
присутствует товар с запрещенным отделом 		По умолчанию false
paybyqrcodeonpinpadлогический
  • true
  • false
Оплата по QR-коду на пин-падеПо умолчанию false
denymakechangeлогический
  • true
  • false
Не давать сдачуПо умолчанию false
manualamountrequiredлогический
  • true
  • false
Обязательный ввод суммы вручнуюПо умолчанию false
paybycustomerqrcodeлогический
  • true
  • false

Оплата по QR-коду покупателя

(только для банковского терминала Инпас )

По умолчанию false
paybybiometryлогический
  • true
  • false

Оплата по биометрии

(только для процессинга Сбербанк)

По умолчанию false
showmoneyiteminfoлогический
  • true
  • false

Вывод информации об оплате

(только для процессинга "Расчетные решения").

По умолчанию false
Пример
{"command":"addCurrency",
"currency":
        {"currencycode":111,
        "status":
                {"basic": false
                },
        "shortname":"usd",
        "fullname":"доллар",
        "type":1,
        "decpoint":1,
        "round":"roundMathematicalWithLoss",
        "mode":
                {
				"denyPartialSum": false,
                "denyExtraSum": true,
                "denyPaymentForBack": false,
                "denyPaymentForSale": false,
                "printCopyRequired": false,
				"paybyqrcodeonpinpad": true,
                "denymakechange": false,
                "manualamountrequired": true
                 },
        "drawer": true,
        "hidden": false,
        "operation":"none",
        "deptsforbiddance":[1,2,3,4,5],
        "payprocdir": "/linuxcash/cash/payments/inpas2"
        }
}

Команда clearCurrency

Команда clearCurrency очищает справочник валют:

Пример
{
    "command": "clearCurrency"
}

Команда deleteCurrency

Команда deleteCurrency удаляет из справочника валют запись о валюте со всеми зависимыми записями.

Параметр: код валюты.

Пример
{
   "command": "deleteCurrency",
   "currencycode": "125"
}
  • No labels