Привязать фискальный чек API

Привязывает данные фискального чека, сформированного на стороне мерчанта, к успешно оплаченной транзакции Paylov. Этот endpoint не создаёт новый чек и не отправляет его в OFD.

Примечание: У мерчанта должен быть включён API фискализации и выбран тип фискализации CLIENT_SIDE.

Endpoint

Метод: POST
URL: BASE_URL/merchant/fiscalization/set-receipt/
Заголовок:

Authorization: Bearer <ACCESS_TOKEN>

Тело запроса

Поле	Тип	Обязательно	Описание
transactionId	string (UUID)	Да	Идентификатор успешно оплаченной транзакции, принадлежащей мерчанту
externalId	string	Нет	Уникальный внешний идентификатор чека
terminalId	string	Да	Идентификатор терминала OFD; не более 32 символов
dateTime	string	Да	Дата и время чека в формате YYYYMMDDHHMMSS
fiscalSign	string	Да	Фискальный признак; не более 64 символов
qrCodeUrl	string	Да	URL чека с протоколом HTTPS и доменом ofd.soliq.uz
receiptId	integer	Да	Идентификатор чека OFD; значение должно быть не меньше 1

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

{
  "transactionId": "e2da46c6-8c89-400e-8bd9-037297b2e8b1",
  "externalId": "merchant-receipt-12345",
  "terminalId": "EP000000000378",
  "dateTime": "20250915143025",
  "fiscalSign": "947030008479",
  "qrCodeUrl": "https://ofd.soliq.uz/epi?t=EP000000000378&r=173723",
  "receiptId": 173723
}

Успешный ответ

{
  "result": {
    "success": true,
    "error": null
  }
}

Ответ с ошибкой

{
  "result": null,
  "error": {
    "code": "field_not_valid",
    "message": "field_not_valid",
    "data": {
      "field": "dateTime"
    }
  }
}

Коды ошибок

Код ошибки	Описание
validation_error	Обязательное поле отсутствует или не соответствует ограничениям сериализатора
permission_denied	Фискализация отключена или мерчант не использует тип фискализации CLIENT_SIDE
field_not_valid	Некорректный формат transactionId, dateTime или qrCodeUrl; имя поля возвращается в data.field
external_id_already_exists	Фискальный чек с указанным externalId уже существует
transaction_not_found	Транзакция не существует или не принадлежит мерчанту
receipt_not_available_for_operation	Транзакция не была успешно оплачена
ofd_check_already_generated	К транзакции уже привязан фискальный чек
ofd_too_many_requests_for_this_receipt	Превышено допустимое количество попыток создания фискального чека для транзакции