Оглавление |
---|
...
Поле | Тип данных | Обязательно | Описание | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Purchase – общие данные чека | ||||||||||||||||||||||||||||||
| long | Нет | Идентификатор транзакции (не заполняется при передаче, заполняется Процессингом и только в том случае, если по чеку были какие-либо скидки или операции с бонусными баллами) | |||||||||||||||||||||||||||
| long | Centrum - да | Номер магазина | |||||||||||||||||||||||||||
| long | Нет | Номер чека | |||||||||||||||||||||||||||
| long | Нет | Номер смены | |||||||||||||||||||||||||||
| long | Нет | Номер кассы | |||||||||||||||||||||||||||
| double | Нет | Сумма чека (в рублях). Должна равняться сумме стоимости всех позиций в чеке. |
| datetime | Да | Дата регистрации чека. Дата и время записываются в формате ISO-8601, пример: 2017- | |||||||||||||||||||||||
| Double | Нет | Сумма скидок по чеку
| |||||||||||||||||||||||||||
| datetime | Да | Дата регистрации чека. Дата и время записываются в формате ISO-8601, пример: 2017-07-20T10:45:15.000+06:00, однако не следует передавать таймзону здесь. | |||||||||||||||||||||||||||
| boolean | Нет | Игнорировать дополнительные карты/купоны клиента.
Вместе с основной картой клиента приходят и его купоны, флаг со значением
| |||||||||||||||||||||||||||
Position – данные позиции чека | ||||||||||||||||||||||||||||||
| long | Нет | Возвращается номер позиции, если в результате расчета было произведено разделение позиций (не заполняется при передаче, заполняется Процессингом) | |||||||||||||||||||||||||||
| string | Да | Код товара | |||||||||||||||||||||||||||
| double | Нет | Стоимость единицы товара в данной позиции, используется для расчета скидок (в рублях). Если не указана, то возьмётся из бд Set10. | |||||||||||||||||||||||||||
| double | Да | Количество товаров в позиции чека, может быть нецелым (для весового товара, например). Десятичный разделитель - точка. | |||||||||||||||||||||||||||
| long | Да | Номер отдела | |||||||||||||||||||||||||||
| long | Да | Оригинальный номер позиции в исходном чеке | |||||||||||||||||||||||||||
| boolean | Да | Признак участия товара в расчете скидок. true если участвует и false в противном случае. | |||||||||||||||||||||||||||
https://crystals.atlassian.net/browse/SR-4903 https://crystals.atlassian.net/browse/
| Double | Да | Цена товара с учетом всех скидок. | |||||||||||||||||||||||||||
Payment – данные оплат чека | ||||||||||||||||||||||||||||||
| string | Нет | Код типа оплаты | |||||||||||||||||||||||||||
| string | Нет | Не используется, заполнять не требуется | |||||||||||||||||||||||||||
| double | Нет | Сумма оплаты данным типом оплат | |||||||||||||||||||||||||||
DiscountCard – данные дисконтных карт и купонов | ||||||||||||||||||||||||||||||
| string | Нет | Номер дисконтной карты или купона | |||||||||||||||||||||||||||
| double | Нет | Заполняется серверным калькулятором, содержит величину активных бонусных баллов на счете клиента. Активные бонусные баллы могут быть использованы немедленно. Величина в рублях с точностью до двух знаков после запятой. | |||||||||||||||||||||||||||
| double | Нет | Заполняется серверным калькулятором, содержит суммарную величину активных и неактивных бонусных баллов на счету клиента. В отличие от активных, неактивные баллы не могут быть использованы немедленно, но станут доступны в будущем. Величина в рублях с точностью до двух знаков после запятой. | |||||||||||||||||||||||||||
| double | Нет | Это поле используется и клиентом, и процессингом. В случае, если это поле не задано, при наличии действующей акции "Бонусы как скидка", оно будет заполнено максимальной величиной бонусных баллов, доступных для списания в данном чеке. Если действует та же акция и это поле заполнено клиентом, калькулятор принимает величину в поле amountToWriteoff как величину, которую необходимо списать с бонусного баланса клиента, тем самым применив бонусы как скидку. Если оплата была равна максимальной величине списания бонусов для данного чека, в ответе это поле не возвращается. В противном случае, если оплата оказалась меньше максимальной, возвращается величина баллов, всё ещё доступных для оплаты в данном чеке. Попытка оплатить бонусными баллами величиной большей, чем максимально допустимая, приведёт к ошибке. | |||||||||||||||||||||||||||
| string | Нет | Заполняется только процессингом и только в случае, если переданный купон или карта не участвовали в расчете скидок. Если это поле не заполнено, купон или карта участвовали в расчете скидок. Поле принимает фиксированный диапазон значений:
| |||||||||||||||||||||||||||
| Date | Нет | Заполняется только процессингом и только в случае, если карта или купон не применены по причинам DOES_NOT_FIT или MORE_PROFITABLE_DISCOUNT_APPLIED. Поле не заполняется при условии, если купон действует бессрочно. Отображает дату, до которой действует карта или купон. |
...
Поле или структура | Тип данных | Описание | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
advertise – данные рассчитанных РА | ||||||||||||||||||||||
| String | Признак проведения операции расчета РА (accept– успешно, reject– неуспешно) | ||||||||||||||||||||
| String | Описание причины неуспешного проведения операции расчета. Актуально при operation = ‘reject’ | ||||||||||||||||||||
customer – данные о владельце Внутренних карт | ||||||||||||||||||||||
| Long | Идентификатор клиента | ||||||||||||||||||||
| String | Имя владельца ДК | ||||||||||||||||||||
| String | Номер Внутренней карты | ||||||||||||||||||||
appliedAction – описание примененных в чеке рекламных акций | ||||||||||||||||||||||
| String | Тип скидки
| ||||||||||||||||||||
| String | Название акции | ||||||||||||||||||||
| Long | Идентификатор акции | ||||||||||||||||||||
| String | Идентификатор акции в внешней системе. | ||||||||||||||||||||
| Datetime | Дата и время начала действия рекламной акции | ||||||||||||||||||||
| Datetime | Дата и время окончания действия рекламной акции. null, если акция действует бесконечно. | ||||||||||||||||||||
appliedCard- описание карт и купонов, по которым сработала описываемая акция (если акция действует не по карте, блок не заполняется) | ||||||||||||||||||||||
| String | Тип карты (InternalCard – внутренняя дисконтная карта, ExternalCard - внешняя карта, Coupon – купон) | ||||||||||||||||||||
| String | Номер карты | ||||||||||||||||||||
discount – данные о рассчитанных в чеке скидках | ||||||||||||||||||||||
| Integer | Номер позиции, на которую применена скидка. Если 0 – скидка применена на весь чек | ||||||||||||||||||||
| Long | Сумма скидки | ||||||||||||||||||||
| Long | Идентификатор РА (описание акции в секции appliedAction) | ||||||||||||||||||||
| Integer | Количество товара, на которое применена скидка | ||||||||||||||||||||
bonus – данные о бонусных операциях | ||||||||||||||||||||||
| Double | Количество начисленных баллов в "рублях" | ||||||||||||||||||||
| String | Номер карты, на которую начислены баллы | ||||||||||||||||||||
| Datetime | Дата начала действия начисленных баллов (не заполняется, если начисленные бонусы действуют с текущего момента) | ||||||||||||||||||||
| Datetime | Дата окончания действия начисленных баллов (не заполняется, если начисленные бонусы действуют бессрочно) | ||||||||||||||||||||
| Long | Код типа бонусного счета | ||||||||||||||||||||
| Long | Идентификатор РА (описание акции в секции appliedAction) | ||||||||||||||||||||
bonusPosition - информация о том, как распределились бонусы по позициям | ||||||||||||||||||||||
| Double | Количество бонусов. Если начисленные бонусы, то значение больше нуля. Если списанные - меньше | ||||||||||||||||||||
| Integer | Номер позиции, на которой распределились бонусы | ||||||||||||||||||||
сообщения кассиру и покупателю | ||||||||||||||||||||||
| String | Сообщение кассиру | ||||||||||||||||||||
| String | Сообщение покупателю | ||||||||||||||||||||
coupons - список купонов, которые являлись результатом применения рекламной акции | ||||||||||||||||||||||
| String | Баркод купона. Заполняется только при операции commit. При операции doProcessDiscount с параметром check=true, даже если результатом применения рекламной акции был купон, его номер не показывается, поскольку на этом этапе ещё можно отменить транзакцию. Выполнение операции commit означает, что транзакция завершена, заказ оплачен и только тогда пользователь может получить номер купона, который можно использовать. | ||||||||||||||||||||
| String | Название купона. Купон может не иметь названия. | ||||||||||||||||||||
| String | Описание купона. Купон может не иметь описания. | ||||||||||||||||||||
| Datetime | Дата и время без учета таймзоны, при наступлении которой купон становится активным. null, если становится активным сразу по выдаче. | ||||||||||||||||||||
| Datetime | Дата и время без учета таймзоны, по истечении которой купон перестаёт быть активным. null, если купон бессрочный. | ||||||||||||||||||||
| Long | (только для скидочных купонов) Величина скидки, которую предоставляет этот купон. Единицы величины описываются полем type купона. | ||||||||||||||||||||
| Long | (только для скидочных купонов) Максимальная величина скидки, которую предоставляет этот купон. | ||||||||||||||||||||
| String | (только для скидочных купонов) Тип скидки купона. Возможные значения:
| ||||||||||||||||||||
| String | Определяет категорию купонов. Это поле необходимо для того, чтобы различать типы купонов между собой. Возможные значения:
| ||||||||||||||||||||
| Long | Guid акции, результатом которой стала выдача этого купона. | ||||||||||||||||||||
position - дополнительные возвращаемые значения в позиции | ||||||||||||||||||||||
| Double | ставка НДС по позиции | ||||||||||||||||||||
| Double | сумма НДС по позиции | ||||||||||||||||||||
| Double | Итоговая стоимость позиции (в рублях). | ||||||||||||||||||||
discountable | Boolean | Применена скидка | ||||||||||||||||||||
cost | Double | Стоимость позиции | ||||||||||||||||||||
count | Double | Количество товара в позиции | ||||||||||||||||||||
departNumber | Integer | Номер отдела | ||||||||||||||||||||
goodsCode | String | Код товара | ||||||||||||||||||||
id | Integer | Код позиции в строке | ||||||||||||||||||||
order | String | Номер заказа |
...
Учет скидки по сроку годности
https://crystals.atlassian.net/browse/SR-4685
...
Устаревшая версия Jira | ||||||
---|---|---|---|---|---|---|
|
Устаревшая версия Jira | ||||||
---|---|---|---|---|---|---|
|
Статус | ||
---|---|---|
|
Атрибут добавляется в блок позиций чека в методе doProcessPurchase, для возможности передачи срока годности конкретной позиции в SetOmni и расчёта скидки по сроку годности.
Данный атрибут должен быть также указан в возвращаемом блоке позиций для рассчитанного чека.
...