Формирование второго чека

В формате ФФД 1.2 магазины, принимающие оплаты с признаками способа расчета «аванс», «предоплата» или «предоплата 100%», должны после поставки товара или оказания услуги выбить итоговый кассовый чек с признаком способа расчета «полный расчёт».

Важно

Сервис доступен только магазинам и партнёрам, которые принимают платежи и проводят фискализацию через Robokassa. Услуга бесплатна, но на одну операцию можно выбить не более двух чеков.

Для второго (итогового) чека параметр payment_method принимает значение full_payment, а в параметре operation нужно передавать только значение sell.

Пример запроса

Основные параметры совпадают с первым фискальным чеком. Дополнительно требуются параметры ниже.

{
  "merchantId": "robokassa_sell",
  "id": "14",
  "originId": "13",
  "operation": "sell",
  "sno": "osn",
  "url": "https://www.robokassa.ru/",
  "total": 100,
  "items": [
    {
      "name": "Товар",
      "quantity": 1,
      "sum": 100,
      "tax": "none",
      "payment_method": "full_payment",
      "payment_object": "commodity",
      "nomenclature_code": "04620034587217"
    }
  ],
  "client": {
    "email": "test@test.ru",
    "phone": "71234567890"
  },
  "payments": [
    {
      "type": 2,
      "sum": 100
    }
  ],
  "vats": [
    {
      "type": "none",
      "sum": 0
    }
  ]
}

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

Параметр	Значение
`merchantId`	Обязателен. Идентификатор магазина в Robokassa, указанный при создании магазина.
`id`	Обязателен. Номер заказа для итогового чека. Целое число от 1 до 9223372036854775807, не должно совпадать с `originId`.
`originId`	Обязателен. Номер заказа (InvId), по которому уже есть чек и требуется сформировать второй чек. Целое число.
`operation`	Обязателен. Тип чека. Для итогового чека всегда `sell`.
`url`	Обязателен. Адрес сайта, на котором совершена продажа.
`total`	Обязателен. Итоговая сумма чека в рублях. Положительное число: целая часть до 8 знаков, дробная — до 2.
`client.email`	Обязателен, если не передан `client.phone`. Email покупателя.
`client.phone`	Обязателен, если не передан `client.email`. Телефон покупателя.
`payments.type`	Обязателен. Тип платежа. Для зачёта аванса используйте значение `2` — предварительная оплата.
`payments.sum`	Обязателен. Сумма платежа. Положительное число с целой частью до 8 знаков и дробной до 2.
`vats.type`	Необязателен. Налоговая ставка: `none`, `vat0`, `vat5`, `vat7`, `vat10`, `vat110`, `vat20`, `vat22`, `vat120`, `vat122`, `vat105`, `vat107`.
`vats.sum`	Необязателен. Сумма налога для соответствующего товара.

Формирование запроса в BASE64

Закодируйте тело запроса в base64 без символов =.
Добавьте пароль магазина (Пароль #1) к полученной строке и вычислите Signature по выбранному алгоритму (например, MD5).
Закодируйте Signature в base64 и удалите символы =.
Соберите финальный запрос: <тело_в_base64>.<signature_в_base64>.
Отправьте POST-запрос на URL https://ws.roboxchange.com/RoboFiscal/Receipt/Attach.

Пример запроса

eyJtZXJjaGFudElkIjogInJvYm9rYXNzYV9zZWxsIiwiaWQiOiAiMTQiLCJvcmlnaW5JZCI6ICIxMyIsIm9wZXJhdGlvbiI6ICJzZWxsIiwKInNubyI6ICJvc24iLCJ1cmwiOiAiaHR0cHM6Ly93d3cucm9ib2thc3NhLnJ1LyIsInRvdGFsIjogMTAwLCJpdGVtcyI6IFt7Im5hbWUiOiAi0KLQvtCy0LDRgCIsInF1YW50aXR5IjogMSwic3VtIjogMTAwLCJ0YXgiOiAibm9uZSIsInBheW1lbnRfbWV0aG9kIjogImZ1bGxfcGF5bWVudCIsInBheW1lbnRfb2JqZWN0IjogImNvbW1vZGl0eSJ9XSwiY2xpZW50IjogeyJlbWFpbCI6ICJ0ZXN0QHRlc3QucnUiLCJwaG9uZSI6ICI3MTIzNDU2Nzg5MCJ9LCJwYXltZW50cyI6IFt7InR5cGUiOiAyLCJzdW0iOiAxMDB9XSwidmF0cyI6IFt7InR5cGUiOiAibm9uZSIsInN1bSI6IDB9XX0.MzAwMTU4NjIwMTE0M2RhNDIzMjg5NmM0NDI0NGJkYmI

Ответ на формирование чека

Успешный ответ сервиса:

{
  "ResultCode": "0",
  "ResultDescription": "ok"
}

Параметр	Значение
`ResultCode`	Статус получения данных. Возможные значения: `1` — ожидание регистрации, `2` — чек зарегистрирован, `3` — ошибка регистрации, `1000` — внутренняя ошибка запроса.
`ResultDescription`	Описание результата обработки.

Получение статуса чека

Создайте запрос в кодировке UTF-8:

{
  "merchantId": "robokassa_state",
  "id": "34"
}

Параметр	Значение
`merchantId`	Идентификатор магазина, указанный при создании.
`id`	Идентификатор операции.

Вычислите Signature тем же способом, что и для формирования чека, и отправьте POST-запрос на https://ws.roboxchange.com/RoboFiscal/Receipt/Status.

Пример ответа статуса

{
  "Code": "0",
  "Description": "ok",
  "Statuses": [
    {
      "Id": "245932797",
      "Code": "Done",
      "Description": "Done",
      "FnNumber": "7381440800567076",
      "FiscalDocumentNumber": "3054",
      "FiscalDocumentAttribute": "2382159011",
      "Num": "1",
      "FiscalType": "Income",
      "FiscalDate": "21.11.2025 15:51:00"
    }
  ]
}

Параметр	Значение
`Code`	Код обработки запроса.
`Description`	Описание результата обработки запроса.
`Statuses`	Массив со статусами фискализации. Если запрос обработан с ошибкой, возвращается `null`.

Коды поля Code в ответе:

Значение	Описание
`0`	Запрос обработан успешно.
`1000`	Некорректный запрос.
`1001`	Некорректная подпись запроса.

Поля объекта в Statuses:

Параметр	Значение
`Id`	Идентификатор записи о статусе.
`Code`	Статус фискализации второго чека. Возвращается строковым значением.
`Description`	Текстовое описание статуса.
`FnNumber`	Номер фискального накопителя.
`FiscalDocumentNumber`	Фискальный номер документа.
`FiscalDocumentAttribute`	Фискальный признак документа.
`Num`	Порядковый номер чека в ответе.
`FiscalType`	Тип фискального события.
`FiscalDate`	Дата и время формирования фискального чека.

Возможные значения Statuses[].Code:

Статус	Внутренний код	Описание
`None`	`0`	Фискализация еще не началась. Состояние до начала обработки чека.
`Wait`	`1`	Фискализация запущена, ожидается выдача чека.
`Done`	`2`	Чек успешно зарегистрирован.
`Fail`	`3`	При фискализации произошла ошибка.
`NotProvided`	`4`	Чек не будет сформирован, например если схема фискализации не выбрана или операция отменена.