Versions Compared

Key

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

...

Параметр

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

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

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

Описание

Merchant_ID

Да

Число


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

Login

Да

20 символов


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

Password

Да

30 символов


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

BillnumberНетВеб-сервис для проведения фискализации16 цифр расширенный формат
Расширенный номер платежа, соответствующий выполненному ранее платежу или выполненной ранее отмене в системе АПК Ассист

Payment_ID

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

255 символов


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

Email

Да/Нет3

128 символов


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

Phone

Да/Нет3

Число


Номер телефона для отправки фискального чека (без +7)

Type

Да

Строка


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

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

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

PaymentType

Да/Нет4

Число


Вид оплаты

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

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

Warning

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

TaxationSystem

Нет5

Число

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

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

Chequeitems

Да/Нет6

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


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

Amount

Да

Число, 15 цифр (разделители «.», «,»)


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

Format

Нет

Число

1

Формат возвращаемого ответа (1-CSV, 2-WDDX, 3-XML, 4-SOAP, 5-JSON)

Language

Нет

RU - русский,

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

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

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

ReceiptLine

Да/Нет6

128 символов


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

Tax

Да/Нет6

10 символов


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

FPMode

Да/Нет6

Число


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

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Нет12 символовПустоИНН оператора перевода
PaymentReceiverOperatorPhoneНет19 символовПустоТелефон оператора по приёму платежей
PaymentAgentOperationНет24 символаПустоОперация платёжного агента
PaymentAgentPhoneНет19 символовПустоТелефон платёжного агента
SupplierPhoneНет19 символовПустоТелефон поставщика
PaymentAgentModeНетчислоПустоПризнак агента
DocumentRequisiteНетJSON массив из строк по 16 символовПустоДополнительный реквизит чека
UserRequisitesНетструктура {"name": <string(64)>, "value": <string(256)>}ПустоДополнительные реквизиты пользователя

...

1Обязательным является один из двух параметров Payment_ID (если осуществляется фискализация внешнего платежа) и Billnumber (если осуществляется фискализация платежа в АПК Ассист, выполненного ранее). Если передается параметр Billnumber и фискальный чек по данной операции уже существует в любом статусе, то выдается ошибка «Фискальный чек уже создан».

Anchor
2
2


2Уникальность Payment_ID контролируется в рамках конкретного предприятия для типа чеков sell и sell_refund и статусов фискального чека:

Если для данного MerchantID, для данного Payment_ID и типов sell или sell_refund уже создан фискальный чек, то при статусах фискального чека New, InProgress, Requested, ErrorRe, Success выдается ошибка – «Фискальный чек создан или находится в обработке».

Если для данного MerchantID, данного Payment_ID и типов sell или sell_refund фискальный чек создан, но имеет статус Error или CreateError, - то создается новый чек.


1Должен быть передан хотя бы один из параметров Email и Phone. Если Email и Phone не указаны, то необходимые данные для контакта с плательщиком извлекаются из настроек предприятия. Если переданы оба параметра Email и Phone, то для контакта с плательщиком будет использоваться параметр Email.

...