Page History
| Table of Contents |
|---|
Основные положения
Веб-сервис предназначен для тех предприятий, которые используют услугу фискализации через АПК Ассист внешних платежей (проводимых на стороне предприятия). Кроме того, веб-сервис может использоваться тогда, когда появляется возможность сформировать чек, оплата по которому через АПК Ассист была проведена ранее. Также с помощью этого веб-сервиса при необходимости можно создать чек коррекции.
...
Параметр | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание | ||
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |||
Login | Да | 20 символов | Логин пользователя сервиса от предприятия | |||
Password | Да | 30 символов | Пароль пользователя сервиса от предприятия | |||
| Billnumber | НетВеб-сервис для проведения фискализации1 | 16 цифр расширенный формат | Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист | |||
Payment_ID | 255 символов | Уникальный идентификатор чека в системе предприятияВеб-сервис для проведения фискализации2 | ||||
128 символов | E-mail адрес для отправки фискального чека | |||||
Phone | Число | Номер телефона для отправки фискального чека (без +7) | ||||
Type | Да | Строка | Тип фискализируемого платежа:
Если в запросе передается параметр Billnumber, то для фискализации платежа должен передаваться тип sell, а для фискализации отмены тип sell_refund. | |||
PaymentType | Число | |||||
ReceiptType | Строка | Тип чека:
| ||||
CorrectionType | Строка | Тип коррекции:
| ||||
CorrectionDocDate | DD.MM.YYYY | Дата корректируемого расчета | ||||
CorrectionDocID | Строка | Номер документа, на основании которого производится коррекция (для коррекции по предписанию) | ||||
| PaymentTypes | Да/НетВеб-сервис для проведения фискализации4 | Строка | Набор/массив пар значений видов оплаты и соответствующих им сумм:
| |||
TaxationSystem | Число | Из настроек предприятия или ККТ | ||||
Chequeitems | Строка в формате JSON | Позиции чека, см. «Работа с чеком». | ||||
Amount | Да | Число, 15 знаков, два знака после разделителя (допустимые разделители «.», «,») | Сумма чека | |||
Format | Нет | 1 – CSV | 1 | Формат возвращаемого ответа. | ||
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 | Да/НетВеб-сервис для проведения фискализации8 | 256 символов | Пусто | Место расчетов | ||
| Cashier | Да/НетВеб-сервис для проведения фискализации8 | 64 символа | Пусто | Кассир | ||
| CashierINN | Да/НетВеб-сервис для проведения фискализации8 | 12 цифровых символов | Пусто | ИНН кассира | ||
| PaymentTerminal | Да/НетВеб-сервис для проведения фискализации9 | 20 символов | Пусто | Номер автоматического устройства | ||
| TransferOperatorPhoneВеб-сервис для проведения фискализации10 | НетВеб-сервис для проведения фискализации11 | 19 символов | Пусто | Телефон оператора перевода | ||
| TransferOperatorName | НетВеб-сервис для проведения фискализации11 | 64 символа | Пусто | Наименование оператора перевода | ||
| TransferOperatorAddress | НетВеб-сервис для проведения фискализации11 | 256 символов | Пусто | Адрес оператора перевода | ||
| TransferOperatorINN | НетВеб-сервис для проведения фискализации11 | 10 цифровых символов | Пусто | ИНН оператора перевода | ||
| PaymentReceiverOperatorPhoneВеб-сервис для проведения фискализации10 | НетВеб-сервис для проведения фискализации11 | 19 символов | Пусто | Телефон оператора по приёму платежей | ||
| PaymentAgentOperation | НетВеб-сервис для проведения фискализации11 | 24 символа | Пусто | Операция платёжного агента | ||
| PaymentAgentPhoneВеб-сервис для проведения фискализации10 | НетВеб-сервис для проведения фискализации11 | 19 символов | Пусто | Телефон платёжного агента | ||
| SupplierPhoneВеб-сервис для проведения фискализации10 | НетВеб-сервис для проведения фискализации11 | 19 символов | Пусто | Телефон поставщика | ||
| PaymentAgentMode | НетВеб-сервис для проведения фискализации11 | число | Пусто | Признак агента | ||
| DocumentRequisite | Нет | 16 символов | Пусто | Дополнительный реквизит чека | ||
| UserRequisites | Нет | структура {"name": <string(64)>, "value": <string(256)>} | Пусто | Дополнительные реквизиты пользователя |
...
Если запрос на фискализацию не может быть обработан, в результате запроса вернутся ненулевые значения параметров firstcode, secondcode.
Сервис пакетной фискализации
Веб-сервис предназначен для одновременной фискализации нескольких операций (пакета операций). Пакетная фискалиация может использоваться, например, в следующих случаях:
...
Параметр | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание |
Merchant_ID | Да | Число | Идентификатор предприятия в системе АПК Ассист | |
Login | Да | 20 символов | Логин пользователя сервиса от предприятия | |
Password | Да | 30 символов | Пароль пользователя сервиса от предприятия | |
Billnumber | Да | 16 цифр расширенный формат | Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист | |
Да/Нет1 | 128 символов | E-mail адрес для отправки фискального чека | ||
Phone | Да/Нет1 | Число | Номер телефона для отправки фискального чека (без +7) | |
Language | Нет | RU - русский, EN - английский | Язык предприятия | Язык отправляемого письма (RU/EN) |
Cheques | Да, хотя бы один элемент | Строка в формате JSON | Набор/массив данных чеков. Каждый чек содержит параметры, используемые сервисом fiscalize.cfm (кроме параметров login / password / billnumber / Payment_ID /Email / Phone), а также дополнительный параметр chequeid (см. табл. ниже). |
...
веб-сервиса получения фискального чека fiscalreceipt.cfm.