Page History
...
Параметр | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание | ||||
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |||||
Login | Да | 20 символов | Логин пользователя сервиса от предприятия | |||||
Password | Да | 30 символов | Пароль пользователя сервиса от предприятия | |||||
| Billnumber | Нет 1 | 16 цифр расширенный формат | Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист | |||||
Payment_ID | Нет 1 | 255 символов | Уникальный идентификатор чека в системе предприятия 2 | |||||
Да/Нет 3 | 128 символов | E-mail адрес для отправки фискального чека | ||||||
Phone | Да/Нет 3 | Число | Номер телефона для отправки фискального чека - стандартный номер с кодом страны (без +), минимум 11 цифр. | |||||
Type | Да | Строка | Тип фискализируемого платежа:
Если в запросе передается параметр Billnumber, то для фискализации платежа должен передаваться тип sell, а для фискализации отмены тип sell_refund. | |||||
TaxationSystem | Нет 4 | Число | Из настроек предприятия или ККТ | |||||
Chequeitems | Да/Нет 5 | Строка в формате JSON | Позиции чека, см. «Работа с чеком». | |||||
Amount | Да | Число, 15 знаков, два знака после разделителя (допустимые разделители «.», «,») | Сумма чека | |||||
Format | Нет | 1 – CSV | 1 | Формат возвращаемого ответа. | ||||
Language | Нет | RU - русский, EN - английский | Язык предприятия | Язык отправляемого письма (RU/EN) | ||||
ReceiptLine | Да/Нет 5 | 128 символов | Позиция чека (для чеков с единственной позицией) | |||||
Tax | Да/Нет 5 | 10 символов | ||||||
PaymentType | Да/Нет 6 | Число | ||||||
PaymentTypes | Да/Нет 6 | Строка | Набор/массив пар значений видов оплаты и соответствующих им сумм:
| |||||
| LastName | Нет | 70 символов | Пусто | Фамилия покупателя | ||||
| FirstName | Нет | 70 символов | Пусто | Имя покупателя | ||||
| MiddleName | Нет | 70 символов | Пусто | Отчество покупателя | ||||
| TaxpayerID | Нет | 12 символов | Пусто | ИИН покупателя | ||||
| PaymentPlace | Да | 256 символов | Пусто | Код отдела | ||||
| Cashier | Нет | 64 символа | Пусто | Кассир | ||||
| CashierINN | Да | 12 цифровых символов | Пусто | Код кассира (максимально возможное значение параметра 2147483647) | ||||
| Parentticketnumber | Да/Нет 7 | Строка | Фискальный признак чека основания для возврата | |||||
| Parentticketdatetime | Да/Нет 7 | Дата/время | Дата и время операции родительского чека | |||||
| Parenttickettotal | Да/Нет 7 | Число | Общая сумма покупки или продажи чека основания для возврата | |||||
| Parentticketoffline | Да/Нет 7 | 0 - неавтономный 1 - автономный | Признак автономности чека основания для возврата | |||||
| Kkmregnum | Да/Нет 7 | Строка | Регистрационный номер ККМ КГД чека основания для возврата |
| Anchor | ||||
|---|---|---|---|---|
|
1 Обязательным является один из двух параметров Payment _ ID (если осуществляется фискализация внешнего платежа) и Billnumber (если осуществляется фискализация платежа в АПК Ассист, выполненного ранее). Если передается параметр Billnumber и фискальный чек по данной операции уже существует в любом статусе, то выдается ошибка « Фискальный чек уже создан ».
...
Название | Значение |
fiscalreceipt_ID | Идентификатор созданного фискального чека |
Payment_ID | Идентификатор чека в системе предприятия (если есть) |
Type | Тип фискализируемого платежа:
|
receipttype | Тип чека:
|
Receipt_status | Статус созданного фискального чека
|
Процесс фискализации является асинхронным, поэтому в ответе веб-сервиса в большинстве случаев будет возращен статус чека New. Это означает, что чек создан и поставлен в очередь на кассу для фискализации. После получения данных о создании фискального чека в статусе New рекомендуется через несколько минут дополнительно запросить данные фискального чека с помощью веб-сервиса fiscalreceipt (о веб-сервисе fiscalreceipt подробнее см. «Получение фискального чека »), чтобы убедиться в успешном завершении создания фискального чека.
Полученный в ответе на запрос статус CreateError означает, что чек не может быть сформирован и отправлен на фискализацию. В этом случае следует убедиться в корректности отправляемых данных (состав позиций чека, наличие обязательных атрибутов фискализации, непротиворечивость параметров и т.д.), также рекомендуется запросить данные с помощью веб-сервиса fiscalreceipt и проверить полученный в поле errortext текст ошибки, затем можно повторно направить скорректированный запрос на фискализацию .
Если чек находится в статусе New , то отправлять его на фискализацию повторно нельзя .
...
Параметр | Обязательное поле | Принимаемые значения | Описание |
Paymethod | Нет | Строка | Способ оплаты (карта, QR-код) |
Payid | Нет | Строка | Идентификатор оплаты (для карт – уникальное значение номера операции, для QR-кода – уникальный идентификатор платежа QR-кодом) |
Payterminal | Нет | Строка | Уникальный идентификатор терминала (только для карт) |
| Paytype | Нет | 20 символов | Тип карты (для карты) или тип оплаты QR-кодом (для QR-кода) |
Payauthcode | Нет | 32 цифровых символа | Код авторизации (только для карт) |
Payreceiptnumber | Нет | 32 цифровых символа | Номер чека в системе банка (только для карт) |