Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

При получении данных заказа из информационной системы предприятия через веб-сервис или от собственного приложения предприятия в приложение Assist mPOS передаются необходимые входные данные.

...

Параметр

Обяза-тельный

Описание

Комментарий

Пример в формате JSON

ordernum

Нет

Уникальный номер заказа из внешней системы

На входе используется валидация. Regex для проверки "[^\\w\\(\\){}\\[\\]№\\s\"\'+!%*+,./:;=?@^_`|~-]"

"ordernum":"12354_5678"

amount

Да

Сумма заказа

Если значение отличается от значения произведения переданных в строке items значений price и quantity

"amount":"1234.56"

amount_prepaid

Нет

Сумма ранее полученной преоплаты


"amount_prepaid":"1000.00"

currency

Нет

Валюта заказа, ISO код

В настоящий момент возможна оплата заказов только в рублях.

"currency":"RUB"

merchantid

Нет/Да

Идентификатор предприятия в АПК Ассист. Параметр обязателен, если его значение отсутствует в настройках приложения.


"merchant_id":"223344"

merchant_name

Нет

Для печати в чеке. Пример: ООО "Яркий фотомаркет"


"merchant_name":"ООО Мерчант"

comment

Нет

Комментарий к заказу


"comment":"скидка 8 марта"

clientname

Нет

Имя покупателя


"clientname":"Иван"

clientemail

Нет

Email адрес покупателя


"clientmail":"client@mail.ru"

clientphone

Нет

Номер мобильного телефона покупателя


"clientphone":"12345678"

payment_address

Нет

Место расчета для печати в чеке


"payment_address":"ул. Новая, д.23"

cashier

Нет

Фамилия кассира для печати в чеке


"cashier":"Иванов"

taxation_system

Нет/Да

Идентификатор системы налогообложения

Код в соответствии со справочником типов системы налогообложения

"taxation_system":"0"

items

Нет

Товарные позиции в формате json :

{"items":[

{

"id": "Позиция в чеке",

"product" : "Код номенклатуры",

"type" : "Предмет расчета"

"name" : "Наименование",

"display_name" : "Опциональное название позиции, только для отображения в приложении" "price" : "Цена за единицу номенклатуры, без учета скидки",

"quantity" : "Количество",

"tax" : "Идентификатор ставки налога",

"amount" : "Стоимость позиции итого"

"discount_amount" : "Скидка по позиции итого"

"payment_method" : "Способ расчета"},

...

] }

Валидация данных:

  • обязательные поля для позиции:
  • name;
  • price;
  • tax;
  • quatity;
    • в поле price учитываются только два знака после запятой, остальные знаки обрезаются;
    • вырезаются невалидные для xml символы: <, >,&.

"items":[

{"id":"1",

"product":"16537615",

"type":1,

"name":"Чехол FUJIFILM LC-X100F для X100F, коричневый",

"display_name": "Компактный фотик"

"price":"6500.00",

"quantity":1,

"tax":"vat0",

"amount":"6500.00",

"discount_amount":"490.00",

"payment_method":"4"}

]

allow_edit_item_quantity

Нет

Разрешено ли пользователю изменять количество позиций заказа

Допустимые значения false или true (по умолчанию false)

"allow_edit_item_quantity":true

allow_remove_item

Нет

Разрешено ли пользователю удалять позиции заказа

Допустимые значения false или true (по умолчанию false)

"allow_remove_item":true

Получение данных из информационной системы предприятия через веб-сервис

Для получения приложением Assist mPOS данных заказа через веб-сервис сначала необходимо настроить соответствующие параметры (URL информационной системы предприятия, наименование учетной записи пользователя и пароль для доступа к веб-сервису информационной системы предприятия) в Личном кабинете АПК Ассист. Настройка параметров описана в п.8.2.11 «Настройки mPOS» инструкции по работе с Личным кабинетом».

...

где XXXX – уникальный идентификатор пользователя в системе предприятия (номер заказа).

Получение данных от собственного приложения предприятия

Собственное приложение предприятия, установленное на том же мобильном устройстве, инициирует оплату заказа, передавая приложению Assist mPOS данные заказа.

...

Section
Column
width50%

для приложения под ОС Android

В случае завершения операции оплаты (успешно или неуспешно) возвращается код результата Activity.RESULT_OK.

Если операция оплаты была прервана, то возвращается код результата Activity.RESULT_CANCELED.

При неуспешном завершении операции оплаты передаются следующие выходные параметры:

Параметр (JSON имя поля)

Обязательный

Описание

error_code

Нет

Код ошибки

error_message

Нет

Сообщение об ошибке

Column
width50%

для приложения под ОС iOS

В случае возникновения ошибки обратный вызов не осуществляется.

...