Уникальные запросы (rid)
Параметр rid используется для того, чтобы однозначно идентифицировать ту или иную транзакцию.
Использоваться он должен после первого шифрования вот так:
{
"ab":"GYBhagdYGWgahjGDHASgdjhas...ASDGd",
"de":"GYBhagdYGWgahjGDHASgdjhas...ASDGd",
"kassaid":"123456",
"kassatoken":"3212312312312",
"check_type":"standart",
"rid":"2020_123456789abc123456789123456789abc"
"test":"1"
}
Структура параметра rid должна быть такая:
YYYY_hash.
Первые 4 символа должны быть годом, когда отправляется транзакция. В нашем случае это 2020. Затем нижнее подчеркивание и уникальный вами генерируемый хэш. Он тоже должен соответствовать правилам: не менее 25 символов и не более 35. Регистр не имеет значения, все символы будут переведены в нижний регистр. Только цифры и буквы, без спецсимволов.
В ответ на ваш запрос с верным rid параметром будет такой:
{
"status":"success",
"success":"added army record to nanokassa.ru",
"nuid":"123456",
"qnuid":"3212312312312",
"rid":"2020_abc123cde456789123456789123"
}
Если ваш запрос с уникальным параметром, вы уже посылали к нам на наш сервер, скажет вам об этом и ваш запрос НЕ БУДЕТ фискализироваться!
Ответ будет таким:
{
"status":"error",
"error":"we have already registered this request-id (rid)",
"nuid":"123456789123456789",
"qnuid":"123456789123456789",
"rid":"2020_abc123cde456789123456789123"
}
Это значит, такой запрос вы к нам посылали, в ответ же мы отдадим вам данные, по которому вы можете идентифицировать ваш запрос. При этом эти запросы не будут видны в личном кабинете, тк мы их никак не принимаем и просто сообщаем вам об этом. Кроме того, ответ сервера будет 409 (Conflict).
В случае, если вы неправильно сформировали параметр rid, ответ сервера будет примерно таким, но запрос все равно БУДЕТ фискализироваться, просто без учета уникального параметра:
{
"status":"success",
"success":"added army record to nanokassa.ru",
"nuid":"123456789123456789",
"qnuid":"123456789123456789",
"rid_error":"Parameter rid ne sootvetstvuet dokumentacii"
}