Versions Compared

Key

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

...

Веб-сервис предназначен для тех предприятий, которые используют услугу фискализации через АПК Ассист внешних платежей (проводимых на стороне предприятия). Кроме того, веб-сервис может использоваться тогда, когда появляется возможность сформировать чек, оплата по которому через АПК Ассист была проведена ранее. Также с помощью этого веб-сервиса при необходимости можно создать чек коррекции.

Note

Фискализация осуществляется для платежей только в  российских рублях (RUB).

Веб-сервис позволяет предприятию получить уникальный идентификатор сгенерированного в АПК Ассист фискального чека (или чека коррекции) на основе данных, переданных в запросе.

По идентификатору можно в свою очередь запросить фискальные данные чека из АПК Ассист через отдельный веб-сервис fiscalreceipt. Эти данные используются, например, в тех случаях, когда предприятие самостоятельно отправляет электронные копии чеков своим покупателям.

...

Параметр

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

Принимаемые значения

Значение по умолчанию

Описание

Merchant_ID

Да

Число


Идентификатор предприятия в системе АПК Ассист

Login

Да

20 символов


Логин пользователя сервиса от предприятия

Password

Да

30 символов


Пароль пользователя сервиса от предприятия

BillnumberНет116 цифр расширенный формат
Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист

Payment_ID

Нет1

255 символов


Уникальный идентификатор чека в системе предприятия2

Email

Да/Нет3

128 символов


E-mail адрес для отправки фискального чека

Phone

Да/Нет3

Число


Номер телефона для отправки фискального чека  - стандартный номер с кодом страны (без +), минимум 11 цифр.12

Type

Да

Строка


Тип фискализируемого платежа:

  • sell – оказание услуг;
  • sell_refund – возврат.

Если в запросе передается параметр Billnumber, то для фискализации платежа должен передаваться тип sell, а для фискализации отмены тип sell_refund.

PaymentType

Да/Нет4

Число


Вид оплаты

ReceiptType

Да/Нет5

Строка


Тип чека:

  • normal – чек при фискализации оплаты или отмены;
  • correct – чек коррекции.

CorrectionType

Да/Нет5

Строка


Тип коррекции:

  • self – самостоятельное решение о коррекции;
  • instruction – коррекция по предписанию надзорного органа.

CorrectionDocDate

Да/Нет5

DD.MM.YYYY


Дата корректируемого расчета

CorrectionDocID

Да/Нет5

Строка


Номер документа, на основании которого производится коррекция (для коррекции по предписанию)

PaymentTypesДа/Нет4Строка

Набор/массив пар значений видов оплаты и соответствующих им сумм:
{"Amount":<value>, "PaymentType":<PaymentType>}

Warning

Сумма значений Amount по всем использованным видам оплаты должна быть равна сумме чека.

TaxationSystem

Нет6

Число

Из настроек предприятия или ККТ

Система налогообложения

Chequeitems

Да/Нет7

Строка в формате JSON


Позиции чека, см. «Работа с чеком».

Amount

Да

Число, 15 знаков, два знака после разделителя (допустимые разделители «.», «,»)


Сумма чека
Если в запросе передается параметр Billnumber, то сумма чека должна равняться сумме платежа (или отмены).

Format

Нет

1 – CSV
3 – XML
4 - SOAP
5 - JSON

1

Формат возвращаемого ответа.

Language

Нет

RU - русский,

EN - английский

Язык предприятия

Язык отправляемого письма (RU/EN)

ReceiptLine

Да/Нет7

128 символов


Позиция чека (для чеков с единственной позицией)

Tax

Да/Нет7

10 символов


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

FPMode

Да/Нет7

Число


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

LastNameНет70 символовПустоФамилия покупателя
FirstNameНет70 символовПустоИмя покупателя
MiddleNameНет70 символовПустоОтчество покупателя
CustomerDocIDНет11 символовПустоСерия/номер паспорта покупателя
TaxpayerIDНет12 символовПустоИНН покупателя
CompanyNameНет256 символовПустоНаименование компании (если покупатель – юридическое лицо)
PaymentAddressНет256 символовПустоАдрес расчетов
PaymentPlaceДа/Нет8256 символовПустоМесто расчетов
CashierДа/Нет864 символаПустоКассир
CashierINN10Да/Нет812 цифровых символовПустоИНН кассира
PaymentTerminalДа/Нет920 символовПустоНомер автоматического устройства
TransferOperatorPhone10Нет1119 символовПустоТелефон оператора перевода - формат телефонного номера ХХХХХХХХХХХ (без +, без разделителей), начиная с кода страны, минимум 11 цифр.
TransferOperatorNameНет1164 символаПустоНаименование оператора перевода
TransferOperatorAddressНет11256 символовПустоАдрес оператора перевода
TransferOperatorINN10Нет1110 цифровых символовПустоИНН оператора перевода
PaymentReceiverOperatorPhone10Нет1119 символовПустоТелефон оператора по приёму платежей - формат телефонного номера ХХХХХХХХХХХ (без +, без разделителей), начиная с кода страны, минимум 11 цифр.
PaymentAgentOperationНет1124 символаПустоОперация платёжного агента
PaymentAgentPhone10Нет1119 символовПустоТелефон платёжного агента - формат телефонного номера ХХХХХХХХХХХ (без +, без разделителей), начиная с кода страны, минимум 11 цифр.
SupplierPhone10Нет1119 символовПустоТелефон поставщика - формат передачи телефонного номера ХХХХХХХХХХХ (без +, без разделителей), начиная с кода страны, минимум 11 цифр.
PaymentAgentModeНет11ЧислоПустоПризнак агента
ProductmarkinguuidДа/Нет12255 символов
Идентификатор запроса, полученный предприятием от системы маркировки «Честный знак» во время проверки товара.
ProductmarkingtimestampДа/Нет12Число
Время запроса, полученное предприятием от системы маркировки «Честный знак».
ProductmarkingfoivДа/Нет123 символа
Идентификатор ФОИВ
ProductmarkingdocdateДа/Нет12DD.MM.YYYY
Дата документа основания
ProductmarkingdocidДа/Нет1232 символа
Номер документа основания
DocumentRequisiteНет16 символовПустоДополнительный реквизит чека
UserRequisitesНетструктура {"name": <string(64)>, "value": <string(256)>}ПустоДополнительные реквизиты пользователя

...

10 Если параметр будет передан в формате, не соответствующем указанному, то при фискализации его значение будет изменено на null..

Anchor
11
11


11Параметр может заполняться только для ФФД 1.05 и 1.1. Для ФФД 1.2 параметр передается только в позициях чека.

Anchor
12
Anchor
1212


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

...

Название

Значение

fiscalreceipt_ID

Идентификатор созданного фискального чека

Payment_ID

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

Type

Тип фискализируемого платежа:

  • sell – оказание услуг;
  • sell_refund – возврат.

receipttype

Тип чека:

  • normal – чек при фискализации оплаты или отмены;
  • correct – чек коррекции.

Receipt_status

Статус созданного фискального чека (чека коррекции)

или

Сообщение об ошибке (если переданы некорректные параметры или не все обязательные параметры)

:

  • New – чек подготовлен к формированию;
  • CreateError - при создании чека возникла ошибка.

Процесс фискализации является асинхронным, поэтому в ответе веб-сервиса в большинстве случаев будет возращен статус чека New. Это означает, что чек создан и поставлен в очередь на кассу для фискализации. После получения данных о создании фискального чека в статусе New рекомендуется После получения данных о создании фискального чека в статусах New, InProgress, ErrorRe, Requested рекомендуется через несколько минут дополнительно запросить данные фискального чека с помощью веб-сервиса fiscalreceipt (о веб-сервисе fiscalreceipt подробнее см.  «Получение фискального чека») для того , чтобы убедиться , что создание фискального чека успешно завершенов успешном завершении создания фискального чека. 

Полученный в ответе на запрос статус CreateError означает, что чек не может быть сформирован и отправлен на фискализацию.  В этом случае следует убедиться в корректности отправляемых данных (состав позиций чека, наличие обязательных атрибутов фискализации, непротиворечивость параметров и т.д.), также рекомендуется  запросить данные с помощью веб-сервиса fiscalreceipt и проверить полученный в поле errortext текст ошибки, затем можно повторно направить скорректированный запрос на фискализацию
Если чек находится в статусе New, то отправлять его на фискализацию повторно нельзя.

Warning
titleВнимание!

Если в ответе на запрос данных фискального чека через веб-сервис fiscalreceipt в течение длительного времени (несколько часов) по-прежнему приходит статус New (особенно в том случае, когда поле errortext ответа не пустое), следует обратиться в службу технической поддержки support@assist.ru.

Если запрос на фискализацию не может быть обработан, в результате запроса вернутся ненулевые значения параметров параметров firstcode, secondcode.

Веб-сервис пакетной фискализации

...

Сообщение об ошибке (если переданы некорректные параметры или не все обязательные параметры)

Название

Значение

billnumber

Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист

cheques

Набор/массив данных чеков






Параметры элемента массива чеков

Название

Значение

chequeid

Идентификатор чека в массиве

fiscalreceipt_ID

Идентификатор созданного фискального чека

status

Статус созданного фискального чека (чека коррекции)

или

Статус созданного фискального чека (чека коррекции):

  • New – чек подготовлен к формированию;
  • CreateError - при создании чека возникла ошибка.

Процесс фискализации является асинхронным, поэтому для большинства чеков в ответе будет возвращен статус New - чек подготовлен к формированию. Результат фискализации и подробности по каждому отдельному чеку могут быть получены с помощью веб-сервиса получения фискального чека fiscalreceipt.cfm или веб-сервиса получения нескольких фискальных чеков fiscalreceipts.cfm.

Пример запроса с минимальным набором параметров:

...

Code Block
languagexml
{
    "billnumber":"123445678899012.1",
    "cheques":[
        {
            "chequeid":1,
            "fiscalreceiptid":"12123123",
            "status":"NEWNew"
        },
        {
            "chequeid":2,
            "fiscalreceiptid":"12123124",
            "status":"IN_PROGRESSNew"
        }
    ]
}

Подробности по каждому отдельному чеку могут быть получены с помощью

...


Наверх