Описание API v.2 ITkassa

Добавление чека с одной товарной позицией. 

POST: api.itkassa.ru/apim/add 

Параметры запроса: 

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключ в настройках магазина 

customer — (email/телефон) плательщика (например email: example@example.com; например телефон: +79111111111)

payment_id — id транзакции магазина 

payment_name — название платежа(например: Покупка карандашей)(максимальная длина строки:100 символов) 

payment_price — сумма чека 

payment_amount — кол-во покупаемого 

payment_trans — id транзакции в платежной системе 

payment_type – признак способа расчета возможные варианты( 

prepay=>‘ Предоплата 100%.’, 

partialpay=>Частичная предоплата. 

avance=>Аванс. 

full=>Полный расчёт. 

part_credit_pay=>Частичный расчёт и кредит. 

transferloan=>Передача в кредит. 

payloan=>Оплата кредита 

) может быть только один вариант  

payment_tax-% налога для платежа возможные варианты  ( 

        tax0=>без ндс, 

        tax10=>10, 

        tax20=>20, 

        tax10/120’=>110, 

        tax20/120=>120, 

 tax00=>ндс 0% 

)может быть только один вариант налога 

payment_kind-Предмет расчета(1 – Товар.2 – Подакцизный товар.3 – Работа.4 – Услуга.5 – Ставка азартной игры.6 – Выигрыш азартной игры.7 – Лотерейный билет.8 – Выигрыш лотереи.9 – Предоставление РИД (результата интеллектуальной деятельности).10 – Платёж. 11 – Агентское вознаграждение.12 – Составной предмет расчёта.13 – Иной предмет расчёта.14 – Имущественное право. 15 – Внереализационный доход.16 – Страховые взносы.17 – Торговый сбор.18 – Курортный сбор. )

*Требования к наименованию товаров и услуг
Поле payment_name не должно содержать спец. символов (например  #,%,nbsp). 

Response: id чека в системе itkassa 

Регистрация нескольких позиций в чеке: 

POST:api.itkassa.ru/apim/add 

Параметры запроса: 

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключ в настройках магазина 

customer — (email/телефон) плательщика (например email: example@example.com; например телефон: +79111111111)

payment_id — id транзакции магазина 

payment_param— json строка, содержащая в себе параметры (по каждой позиции в чеке): 

• payment_name — название операции(например: Покупка карандашей)(максимальная длина строки:100 символов), 
• payment_price — сумма товара 
• payment_amount — кол-во покупаемого 

payment_type – признак способа расчета возможные варианты( 

prepay=>‘ Предоплата 100%.’, 

partialpay=>Частичная предоплата. 

Advance=>Аванс. 

full=>Полный расчёт. 

part_credit_pay=>Частичный расчёт и кредит. 

transferloan=>Передача в кредит. 

payloan=>Оплата кредита 

) может быть только один вариант  

payment_tax-% налога для платежа возможные варианты  ( 

        tax0=>0, 

        tax10=>10, 

        tax20=>20, 

        tax10/120’=>110, 

        vat20/120=>120, 

)может быть только один вариант налога 

*Требования к наименованию товаров и услуг
Поле payment_name не должно содержать спец. символов (например  #,%,nbsp). 

Response: id чека в системе itkassa 

Статус чека: 

GET: api.itkassa.ru/apim/checkstatus 

Параметры запроса: 

numbercheck — id чека в системе itkassa 

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключ в настройках магазина 

Response: данные чека в системе itkassa 

Если чек выполнен то будет возвращены данные: 

fnd-Фискальный признак 

session-Номер смены 

check_id-Номер чека 

time_end-Время расчета(в формате  гггг-месяц-день час:минут:секунда. Например: 1970-01-06 12:08:14), 

В противном случае текущий статус чека 

• 2-В процессе, 
•  0-Ошибка (обратитесь к администрации) 

Возврат чека: 

POST:api.itkassa.ru/apim/chargeback 

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключ в настройках магазина 

custom_email — email плательщика (например email: example@example.com)

payment_id — id транзакции магазина 

payment_name — название платежа(например: Покупка карандашей) 

payment_price — сумма платежа 

payment_amount — кол-во покупаемого указанного в чеке 

payment_trans — id транзакции в платежной системе 

numbercheck — id чека в системе itkassa 

payment_desc — причина возврата(текст максимум 100 символов) 

Response: status* 

* 1-Выполнено, 2-В процессе, 0-Ошибка (обратитесь к администрации) 

Возврат позиции в чеке: 

POST: api.itkassa.ru/apim/checkposreject 

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключ в настройках магазина 

custom_email — email плательщика (например email: example@example.com)

payment_id — id транзакции магазина 

payment_name — название платежа(например: Покупка карандашей) 

payment_price — сумма платежа 

payment_amount — кол-во покупаемого указанного в позиции чека 

payment_trans — id транзакции в платежной системе 

numbercheck — id чека в системе itkassa 

payment_desc — причина возврата(текст максимум 100 символов) 

Response: status* 

• 1-Выполнено, 2-В процессе, 0-Ошибка (обратитесь к администрации) 

 Чек коррекции: 

POST: api.itkassa.ru/apim/ checkcorrection 

shop_id — Идентификатор магазина в системе 

sec_key — секретный ключ в настройках магазина 

payment_name — название чека(например: Чек коррекции №1 ) 

payment_price — сумма коррекции 

payment_desc — причина коррекции (текст максимум 100 символов) 

payment_type– тип коррекции (1=>”Коррекция Покупки”,2=>”Коррекция Продажи“)(число, может быть только один вариант налога) 

payment_tax– % налога возможные варианты  ( 

        tax0=>0, 

        tax10=>10, 

        tax20=>20, 

        tax10/120’=>110, 

        vat20/120=>120, 

)может быть только один вариант налога 

payment_how-() 

payment_who-причина коррекции(1=>Самостоятельно,2=>По предписанию налоговой)(число только одно значение) 

Response: status* 

• 1-Выполнено, 2-В процессе, 0-Ошибка (обратитесь к администрации) 

 Ошибки: 
“Error:Not find sec_key or shop”- не указан магазин или секретный код магазина 

“Error:Not find shop”-не указан магазин 

“Error:Not find number”-не найден чек при запросе статуса 

“0-Ошибка (обратитесь к администрации)”-  ошибка которая выпадает в случае проблем с кассой, при запросе статус пока чек не напечатан на кассе.