Page History
...
Параметр | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание | ||
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |||
Login | Да | 20 символов | Логин пользователя сервиса от предприятия | |||
Password | Да | 30 символов | Пароль пользователя сервиса от предприятия | |||
| Billnumber | НетВеб-сервис для проведения фискализации | 16 цифр расширенный формат | Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист | |||
Payment_ID | 255 символов | Уникальный идентификатор чека в системе предприятияВеб-сервис для проведения фискализации | ||||
128 символов | E-mail адрес для отправки фискального чека | |||||
Phone | Число | Номер телефона для отправки фискального чека (без +7) | ||||
Type | Да | Строка | Тип фискализируемого платежа:
Если в запросе передается параметр Billnumber, то для фискализации платежа должен передаваться тип sell, а для фискализации отмены тип sell_refund. | |||
PaymentType | Число | |||||
ReceiptType | Строка | Тип чека:
| ||||
CorrectionType | Строка | Тип коррекции:
| ||||
CorrectionDocDate | DD.MM.YYYY | Дата корректируемого расчета | ||||
CorrectionDocID | Строка | Номер документа, на основании которого производится коррекция (для коррекции по предписанию) | ||||
| PaymentTypes | Да/НетВеб-сервис для проведения фискализации | Строка | Набор/массив пар значений видов оплаты и соответствующих им сумм:
| |||
TaxationSystem | Число | Из настроек предприятия или ККТ | ||||
Chequeitems | Строка в формате JSON | Позиции чека, см. «Работа с чеком». | ||||
Amount | Да | Число, 15 цифр (разделители «.», «,») | Сумма чека | |||
Format | Нет | Число | 1 | Формат возвращаемого ответа (1-CSV, 3-XML, 4-SOAP, 5-JSON) | ||
Language | Нет | RU - русский, EN - английский | Язык предприятия | Язык отправляемого письма (RU/EN) | ||
ReceiptLine | 128 символов | Позиция чека (для чеков с единственной позицией) | ||||
Tax | 10 символов | |||||
FPMode | Число | |||||
| LastName | Нет | 70 символов | Пусто | Фамилия покупателя | ||
| FirstName | Нет | 70 символов | Пусто | Имя покупателя | ||
| MiddleName | Нет | 70 символов | Пусто | Отчество покупателя | ||
| CustomerDocID | Нет | 11 символов | Пусто | Серия/номер паспорта покупателя | ||
| TaxpayerID | Нет | 12 символов | Пусто | ИНН покупателя | ||
| CompanyName | Нет | 256 символов | Пусто | Наименование компании (если покупатель – юридическое лицо) | ||
| PaymentAddress | Нет | 256 символов | Пусто | Адрес расчетов | ||
| PaymentPlace | Да/НетВеб-сервис для проведения фискализации | 256 символов | Пусто | Место расчетов | ||
| Cashier | Да/НетВеб-сервис для проведения фискализации | 64 символа | Пусто | Кассир | ||
| CashierINN | Да/НетВеб-сервис для проведения фискализации | 12 цифровых символов | Пусто | ИНН кассира | ||
| PaymentTerminal | Да/НетВеб-сервис для проведения фискализации | 20 символов | Пусто | Номер автоматического устройства | ||
| TransferOperatorPhoneВеб-сервис для проведения фискализации | Нет | 19 символов | Пусто | Телефон оператора перевода | ||
| TransferOperatorName | Нет | 64 символа | Пусто | Наименование оператора перевода | ||
| TransferOperatorAddress | Нет | 256 символов | Пусто | Адрес оператора перевода | ||
| TransferOperatorINN | Нет | 10 цифровых символов | Пусто | ИНН оператора перевода | ||
| PaymentReceiverOperatorPhoneВеб-сервис для проведения фискализации | Нет | 19 символов | Пусто | Телефон оператора по приёму платежей | ||
| PaymentAgentOperation | Нет | 24 символа | Пусто | Операция платёжного агента | ||
| PaymentAgentPhoneВеб-сервис для проведения фискализации | Нет | 19 символов | Пусто | Телефон платёжного агента | ||
| SupplierPhoneВеб-сервис для проведения фискализации | Нет | 19 символов | Пусто | Телефон поставщика | ||
| PaymentAgentMode | Нет | число | Пусто | Признак агента | ||
| DocumentRequisite | Нет | 16 символов | Пусто | Дополнительный реквизит чека | ||
| UserRequisites | Нет | структура {"name": <string(64)>, "value": <string(256)>} | Пусто | Дополнительные реквизиты пользователя |
...
4Обязательным является один из двух параметров PaymentType (если при платеже использовался единственный вид оплаты) и PaymentTypes (если для фискализируемого платежа использовались несколько видов оплаты). Если в запросе передается параметр Billnumber, то параметр PaymentType/PaymentTypes либо должен соответствовать операциям платежа (отмены) с этим номером, либо может вообще не передаваться, т.е. становится необязательным.
| Anchor | ||||
|---|---|---|---|---|
|
5Параметр является обязательным только для чека коррекции.
| Anchor | ||||
|---|---|---|---|---|
|
6Параметр TaxationSystem задается для всего чека в целом (не передается в позициях чека). Если параметр не передан, то его значение берется из настроек предприятия. Если у предприятия не настроено значение параметра TaxationSystem по умолчанию, то в ККТ этот параметр (тег 1055) не отправляется и ККТ будет проводить чек по собственным настройкам. Это возможно только в том случае, если в ККТ настроена только одна система налогообложения, в противном случае ККТ выдаст ошибку.
| Anchor | ||||
|---|---|---|---|---|
|
67Состав чека (поля с названием, стоимостью за единицу товара/услуги, ставкой налога и способом расчета по каждой позиции) определяется по следующим правилам.
...
если настройки предприятия для этих параметров отсутствуют, то обработка запроса завершается с ошибкой (недостаточно данных для выполнения операции).
| Anchor | ||||
|---|---|---|---|---|
|
78В зависимости от режима, в котором предприятие эксплуатирует ККТ, параметр может быть как обязательным, так и необязательным. Необходимость передачи этого параметра следует уточнить в отделе технической поддержки.
| Anchor | ||||
|---|---|---|---|---|
|
89Разрешается передавать либо параметр Cashier, либо параметр PaymentTerminal. Одновременно эти параметры передаваться не могут, поскольку соответствуют разным типам касс.
| Anchor | ||||
|---|---|---|---|---|
|
910Рекомендуется передавать телефонные номера в формате +7ХХХХХХХХХХ или 8ХХХХХХХХХХ.
...