Уникальные запросы (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" }