Фискализация

Фискализация в Robokassa

Описание процесса передачи товарной номенклатуры в чек при использовании фискальной схемы "Кассовое" - "Учёт.Касса-Онлайн".

Выберите вариант подключения

Официальные виджеты и модули

Включите передачу номенклатуры в настройках официального модуля Robokassa на стороне сайта. После активации позиции из карточек товаров автоматически попадут в чек. Официальные модули доступны для Битрикс24, InSales, WordPress WooCommerce, OpenCart, Joomla, VirtueMart и 1С-Битрикс.

Дополнительные особенности:

WIX: номенклатура передается по умолчанию.
Amo CRM: включите фискализацию во вкладке «Настройки платежа» — названия и цены возьмутся из счёта в сделке.
МойСклад: активируйте фискализацию во вкладке «Платежи» — данные подтянутся из счета на вкладке «Счета покупателям».

Сторонние модули

Формат передачи номенклатуры зависит от разработчика интеграции. Проверьте настройки модуля или уточните детали у автора. При необходимости используйте руководство по популярным CMS.

Своя интеграция

Если вы подключаете Robokassa напрямую к сайту или приложению, добавляйте номенклатуру в параметр Receipt в запросе на создание платежа. Структура параметра описана ниже, а номенклатура передается в момент инициации оплаты.

Параметр Receipt

Receipt передается в формате JSON вместе с остальными параметрами платежа и обязательно участвует в контрольной подписи запроса.

Как передавать Receipt

Название параметра — Receipt.
Формат — JSON.
Значение включается в подпись: MerchantLogin:OutSum:InvId:Receipt:Пароль#1.
Из-за объема номенклатуры используйте метод POST.
Перед добавлением в строку для подписи значение Receipt нужно URL-кодировать.

Пример содержимого Receipt

{
  "items": [
	{
	  "name": "Название товара 1",
	  "quantity": 1,
	  "sum": 100,
	  "tax": vat12,
	  "barcode": "32456789523435463245654324567",
	  "ntin": "2345"
	},
	{
	  "name": "Название товара 2",
	  "quantity": 3,
	  "sum": 450,
	  "tax": vat12,
	  "barcode": "32456789523435463245654324567",
	  "ntin": "2345"
	}
  ]
}

Поля Receipt

Общие поля

Параметр	Назначение
`items`	Массив данных о позициях чека.

Поля товарной позиции

Параметр	Назначение
`name`	Обязательное поле. Наименование товара или услуги (до 128 символов, специальные символы экранируйте).
`quantity`	Обязательное поле. Количество товаров.
`sum`	Полная сумма за позицию с учетом скидок и бонусов. Дробная часть — до 2 знаков.
`tax`	Обязательное поле. Налоговая ставка в ККТ для позиции.
`barcode`	Необязательное поле. Штрих код GTIN.
`ntin`	Необязательное поле. Штрих код NTIN.

Налоговая ставка (`tax`)

Обязательное поле. Это поле устанавливает налоговую ставку в ККТ. Определяется для каждого вида товара по отдельности, но за все единицы конкретного товара вместе.

none — без НДС.
vat0 — НДС 0%.
vat5 — НДС 5%.
vat12 — НДС 12%.
vat16 — НДС 16%.

Правила формирования чека

В чеке должна быть минимум одна позиция.
Наименование каждой позиции — не длиннее 128 символов и без спецсимволов.
Цена и сумма позиции неотрицательны, общая сумма позиций больше нуля и равна сумме операции.
Сумма передается в тенге за всё количество товара с учётом скидок и бонусов.
Телефоны в личном кабинете указываются в формате «+Ц» без скобок и дефисов (до 18 цифр).
Наименование организации содержит только русские или английские символы без спецсимволов.