Page History
...
8. Обмен данными между приложением Assist mPOS и информационной системой предприятия
При получении данных заказа из информационной системы предприятия через веб-сервис или от собственного приложения предприятия в приложение Assist mPOS передаются необходимые входные данные в формате JSON.
Входные данные для приложения 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
8.1. Получение данных из информационной системы предприятия через веб-сервис
...