Versions Compared

Key

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

Table of Contents

Чек в заказе

Чек передается в авторизационном запросе . Для этого необходимо в запросе передать дополнительный параметр ChequeItems,в котором передаётся структура в формате JSON, как в следующем примере.

...

Code Block
languagexml
{"items":[
{"id": 1,
    "product": "123460176",
    "name": "Первый товар",
    "price": 201.45,
    "quantity": 42.345,
    "amount": 8530.40,
    "tax": "vat10",
    "hscodesubjtype": "8528722001"1,
    "fpmode": 1},
{"id": 2,
    "product": "123460189",
    "name": "Второй товар",
    "price": 15301.01,
    "quantity": 0.128,
    "amount": 1958.53,
    "tax": "vat20",
    "fpmode": 1}
]}

...

hscode

Название

Обязательноеполе

Тип значения

Описание

id

Да

int

Позиция в чеке (уникальное число для чека)

product

Да/Нет*

string(50)

Код товара по справочнику товаров магазина

name

Да/Нет*

string(250128)

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

price

Да

float(10.2)

Стоимость единицы товара (услуги) в российских рублях (RUB)

quantity

Да

float

Количество/объем товара/услуги в единицах измерения товара (может быть дробным числом)

measure

Нет1

string(25)

Единица измерения товара

amount

Да

float(15.2)

Стоимость позиции price*quantity

tax

Да**2

string(10)

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

eancodeНет3string(14)EAN-8/UPC-E, EAN-13/UPC-A, ITF-14 код маркировки товара
gs1codeНет3string(120)

GS1 DataMatrix/"Честный Знак" код маркировки товара
Примечание. Код должен быть дополнительно преобразован в BASE64 (URL safe)

furcodeКод номенклатуры товара (код ТН ВЭД 10 цифр)Нет3string(20)Код маркировки мехового изделия в формате СС-DDDDDD-СССССССССС (C-символ, D-цифра)
uncodeНет3string(30)Неопознанный код маркировки товара
productmarkinguuidДа/Нет4string(255)Идентификатор запроса, полученный предприятием от системы маркировки «Честный знак» во время проверки товара.

productmarkingtimestamp

Да/Нет4intВремя запроса, полученное предприятием от системы маркировки «Честный знак».

productmarkingfoiv

 Да/Нет4string(3)Идентификатор ФОИВ

productmarkingdocdate

 Да/Нет4string(DD.MM.YYYY)Дата документа основания

productmarkingdocid

 Да/Нет4string(32)Номер документа основания
subjtypeНет5intПризнак предмета расчета

fpmode

Нет2

fpmode

Нет**

int

Способ расчета

AgentModeНетintПризнак агента по предмету расчета
TransferOperatorPhoneНетstring(19)Телефон оператора перевода
TransferOperatorNameНетstring(64)Наименование оператора перевода
TransferOperatorAddressНетstring(256)Адрес оператора перевода
TransferOperatorINNНетstring(12)ИНН оператора перевода
PaymentReceiverOperatorPhoneНетstring(19)Телефон оператора по приёму платежей
PaymentAgentOperationНетstring(24)Операция платёжного агента
PaymentAgentPhoneНетstring(19)Телефон платёжного агента
SupplierPhoneНетstring(19)Телефон поставщика

*Должен быть определен один из параметров -  код товара или его наименование, либо оба параметра должны быть переданы (при формировании чека они объединяются в одну строку).

SupplierNameНетstring(64)Наименование поставщика
SupplierINNНетstring(12)ИНН поставщика
ExciseНетnumber(15,2)Акциз
CountryOfOriginНетstring(3)Код страны происхождения товара
NumberOfCustomsDeclarationНетstring(32)Номер таможенной декларации
LineAttributeНетstring(64)Дополнительный реквизит предмета расчета
DiscountНетstring(25)Размер скидки по позиции (для информирования покупателя)

Anchor
1
1


1Параметр может заполняться только для ФФД 1.2.

Anchor
2
2


2**Параметры tax и fpmode не передаются в запросе на отмену или возврат средств.

Anchor
3
3


3Только один из этих кодов маркировки товара может быть передан в позиции чека, передача нескольких кодов недопустима. Внимание! Для формата фискальных данных версии 1.2 не разрешается передавать неопознанный код маркировки товара uncode, следует использовать только один из распознаваемых кодов маркировки (eancode, gs1code или furcode).

Anchor
4
4


4Параметр обязателен для маркированных товаров, подлежащих обязательной проверке перед продажей. Для обсуждения возможности использования параметра следует обратиться в службу поддержки support@assist.ru.

Anchor
5
5


5Параметр является обязательным для формата фискальных данных версии 1.2 

Значения параметров price и amount всех позиций в чеке должны быть в одной валюте, и эта валюта должна совпадать с валютой заказа (параметр OrderCurrency в авторизационном запросе).

...

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


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

Code Block
languagexml
{"items":[
{"id": 1,
    "name": "Первый товар",
    "price": 201.45,
    "quantity": 42.345,
    "amount": 8530.40,
    "gs1code": "<код маркировки GS1 DataMatrix/"Честный Знак">",
    "productmarkinguuid": "<идентификатор запроса>",
    "productmarkingtimestamp": "1692691702065"
    "tax": "vat10",
    "subjtype": 1,
    "fpmode": 1},
{"id": 2,
    "name": "Второй товар",
    "price": 15301.01,
    "quantity": 0.128,
    "amount": 1958.53,
    "tax": "vat20",
    "fpmode": 1}
]}

Чек при подтверждении

При двустадийном механизме работы финансовое подтверждение интернет-магазин может осуществить в течение 4 дней в Личном кабинете либо с помощью веб-сервиса.

...

Code Block
languagexml
{"items":[
{"id": 1,
    "product": "123460176",
    "name": "Первый товар",
    "price": 201.45,
    "quantity": 21.12,
    "amount": 8530.40,
    "tax": "vat10",
    "fpmode": 1}
{"id": 2,
    "product": "123460189",
    "name": "Второй товар",
    "price": 15301.01,
    "quantity": 0.064,
    "amount": 979.26,
    "tax": "vat20",
    "fpmode": 1}
]}

...

Code Block
languagexml
<chequeitem>
  <id>1</id>
  <product>123460176</product>
  <name>Первый товар</name>
  <price>201.45</price>
  <quantity>21.12</quantity>
  <amount>8530.40</amount>
  <tax>vat10</tax>
  <fpmode>1</fpmode>
</chequeitem>
<chequeitem>
  <id>2</id>
  <product>123460176</product>
  <name>Первый товар</name>
  <price>15301.01</price>
  <quantity>0.064</quantity>
  <amount>979.26</amount>
  <tax>vat20</tax>
  <fpmode>1</fpmode>
</chequeitem>

...

Для каждой позиции чека подтверждения параметры product id, name, price должны быть безусловно эквивалентны этим параметрам соответствующей позиции чека оплаты.

...

URL запроса для отмены или возврата средств и список параметров запроса отмены оплаты совпадают с указанными здесь значениями . Для передачи чека отмены добавляется лишь повторяющаяся структура ChequeItem, в которой передаются позиции чека, как в следующем примере.

...

Code Block
languagexml
<chequeitem>
  <id>1</id>
  <product>123460176</product>
  <name>Первый товар</name>
  <price>201.45</price>
  <quantity>21.12</quantity>
  <amount>8530.40</amount>
  <tax>vat20</tax>
</chequeitem>

В случае проведения отмены на полную сумму не обязательно передавать набор структур ChequeItem соответствующий всему чеку, переданному в заказе. Для отмены на полную сумму чек не является обязательным.

...

Для каждой позиции чека отмены параметры product id, name, price должны быть безусловно эквивалентны этим параметрам соответствующей позиции чека оплаты или чека подтверждения при двустадийном механизме работы.

...

Code Block
languagexml
{"items":[
{"id": 1,
    "product": "123460176",
    "name": "Первый товар",
    "price": 201.45,
    "quantity": 21.12,
    "amount": 8530.40,
    "tax": "vat10",
    "fpmode": 1}
{"id": 2,
    "product": "123460189",
    "name": "Второй товар",
    "price": 15301.01,
    "quantity": 0.064,
    "amount": 979.26,
    "tax": "vat20",
    "fpmode": 1}
]}

...

Code Block
languagexml
<chequeitem>
  <id>1</id>
  <product>123460176</product>
  <name>Первый товар</name>
  <price>201.45</price>
  <quantity>21.12</quantity>
  <amount>8530.40</amount>
  <tax>vat10</tax>
  <fpmode>1</fpmode>
</chequeitem>
<chequeitem>
  <id>2</id>
  <product>123460176</product>
  <name>Первый товар</name>
  <price>15301.01</price>
  <quantity>0.064</quantity>
  <amount>979.26</amount>
  <tax>vat20</tax>
  <fpmode>1</fpmode>
</chequeitem>

...