# Сообщение admi.010

Сообщение admi.010 должно соответствовать XSD схеме сообщения admi.010.001.02 стандарта ISO20022 и правилам заполнения документа, указанным в таблице ниже. Если поле не отмечено как опциональное, то оно является обязательным.

<table data-full-width="false"><thead><tr><th width="103.25">№</th><th width="151.5">Наименование</th><th width="136.75">XML-тег</th><th width="111.5">Опциональность</th><th>Описание</th></tr></thead><tbody><tr><td>0</td><td>StaticDataReport</td><td>StatcDataRpt</td><td> </td><td>Результат запроса данных</td></tr><tr><td>1</td><td>MessageIdentification</td><td>MsgId</td><td> </td><td>Идентификатор сообщения (формат должен соответствовать описанному в <a data-mention href="../../generaciya-unikalnykh-identifikatorov-dlya-soobshenii">generaciya-unikalnykh-identifikatorov-dlya-soobshenii</a>)</td></tr><tr><td>2</td><td>ReportDetails</td><td>RptDtls</td><td> </td><td> </td></tr><tr><td>2.1</td><td>Type</td><td>Tp</td><td> </td><td><p>Тип получаемых данных.</p><p>Должно принимать значение: </p><ul><li><em>QR - для адаптационной модели;</em></li><li><em>QR_V2 - для целевой модели.</em></li></ul></td></tr><tr><td>2.2</td><td>RequestReference</td><td>ReqRef</td><td> </td><td>Сквозной идентификатор из запроса данных admi.009, указанный с ключом END_TO_END_ID (формат должен соответствовать описанному в <a data-mention href="../../generaciya-unikalnykh-identifikatorov-dlya-soobshenii">generaciya-unikalnykh-identifikatorov-dlya-soobshenii</a>) . Соответствует значению HTTP заголовка end-to-end-id</td></tr><tr><td>2.3</td><td>ReportKey</td><td>RptKey</td><td> </td><td>Массив</td></tr><tr><td>2.3.1</td><td>Key</td><td>Key</td><td> </td><td><p>Может принимать значения: </p><ul><li>QR</li></ul></td></tr><tr><td>2.3.2</td><td>ReportData</td><td>RptData</td><td> </td><td><p>Массив.</p><p>Информация в виде «ключ-значение»:</p><ul><li><strong>в теге</strong> <strong>&#x3C;Nm></strong> - передается ключ;</li><li><strong>в теге &#x3C;Val></strong> - передается соответствующее указанному ключу значение.</li></ul><p>Не допускается указывать один и тот же ключ дважды.</p><p>Список используемых ключей:</p><ul><li><strong>MSG_CREATION_TIME</strong> – дата и время создания сообщения, обязательный. Указывается в формате UTC (см. <a data-mention href="../../format-daty-i-vremeni-v-biznes-soobshenii-isodatetime-i-isodate">format-daty-i-vremeni-v-biznes-soobshenii-isodatetime-i-isodate</a>).</li><li><strong>SENDER_PROVIDER_ID</strong> - идентификатор банка отправителя запроса, обязательный. Идентификатор, присвоенный банку Платформой (provider  id). (см. <a data-mention href="../../poluchenie-informacii-o-bankakh-i-statuse-api">poluchenie-informacii-o-bankakh-i-statuse-api</a>). В сообщениях, сформированных Платформой, будет передаваться в качестве идентификатора Платформы значение - 00000000-0000-0000-0000-000000000000</li><li><strong>RECEIVER_PROVIDER_ID</strong> - идентификатор банка получателя запроса, обязательный. Идентификатор, присвоенный банку Платформой (provider  id). (см. <a data-mention href="../../poluchenie-informacii-o-bankakh-i-statuse-api">poluchenie-informacii-o-bankakh-i-statuse-api</a>).</li><li><strong>ERROR_CODE</strong> – информация об ошибке, условно обязательный (обязательный в случае ошибки). Возможные значения см. в <a data-mention href="../../kody-oshibok">kody-oshibok</a></li><li><strong>ERROR_DESCRIPTION</strong> - описание ошибки, максимальная длина: 105 символов, условно обязательный (обязательный в случае ошибки).</li><li><strong>QR_DATA_TYPE</strong> - тип запрашиваемых данных,  обязательное, если данные по QR_ID найдены успешно. Может принимать значения: </li></ul><p><em>-    001 (оплата по QR-коду, используется для операций типа C2B2);</em></p><p><em>-    002 (оплата в рамках электронной коммерции, используется для операций типа C2B2E);</em></p><p><em>-    003 (возврат по проведенной оплате, используется для операций типа C2BR);</em></p><p><em>-    004 (оплата по QR-коду, используется для операций типа C2B2_V2 в рамках целевой модели);</em> </p><p><em>-    005 (возврат по проведенной оплате, используется для операций типа C2BR_V2 в рамках целевой модели)</em></p><p></p><ul><li><strong>QR_TYPE</strong> -     тип QR кода, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002. Принимает значения:</li></ul><p><em>-       STATIC - для статического QR-кода</em></p><p><em>-       DYNAMIC - для динамического QR-кода</em></p><p></p><ul><li><strong>POS_ID</strong> – идентификатор торговой точки (point of sale identification),  максимальная длина: 35 символов, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002.</li><li><strong>BIC</strong> – БИК банка поставщика товара, работы или услуги (бенефициара), 8 символов (латинский алфавит и цифры), обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002.</li><li><strong>ACCOUNT_NUMBER</strong> – IBAN счета поставщика товара, работы или услуги (бенефициара), обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002. <strong>Шаблон:^[0-9A-Z]{20}$</strong></li><li><strong>MCC</strong> – 4-значный код категории продавца, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002.</li><li><strong>COMPANY_ID</strong> – ИИН/БИН поставщика товара, работы или услуги, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002.</li><li><strong>COMPANY_NAME</strong> – наименование поставщика товара, работы или услуги,  максимальная длина: 140 символов, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002.</li><li><strong>COUNTRY_OF_RESIDENCE</strong> – код страны резидентства поставщика товара, работы или услуги, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002. Значение в соответствии с ISO 3166-1 alpha 2, для Казахстана - «KZ».</li><li><strong>CITY</strong> – город физического местонахождения поставщика товара, работы или услуги,  максимальная длина: 35 символов, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002.</li><li><strong>CURRENCY</strong> – код валюты (буквенный), принимает значение KZT, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002.</li><li> <strong>AMOUNT</strong> – сумма платежа, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002 для динамических QR-кодов, не используется для статических QR-кодов, не должно превышать 100 000 000 000 00, должна передаваться в тиын (см. <a data-mention href="../../pravilo-peredachi-znachenii-denezhnykh-summ">pravilo-peredachi-znachenii-denezhnykh-summ</a>).</li><li><strong>KNP</strong> – код назначения платежа,  3 символа (цифры), обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002.</li><li><strong>KNP_MESSAGE</strong> - описание КНП, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002. Длина: до  140 символов.</li><li><strong>BENEFICIARY_CODE</strong> – код бенефициара, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002. Значение этого поля состоит из двух цифр: первая цифра указывает признак резидентства (1 или 2), вторая сектор экономики <em>(принимает значение от 1 до 9)</em>.</li><li><strong>SME</strong> - признак того, что  поставщика товара, работы или услуги является представителем малого или среднего бизнеса, обязательный в случае успешного ответа при QR_DATA_TYPE=001, 002. Принимает значения: <em>значение: 0 – не является МСБ, 1 – является МСБ</em>. </li><li><strong>MERCHANT_CHANNEL</strong> - канал транзакции, необязательное. Трехзначная цифра. Значения каналов транзакции приведены в таблице ниже.</li><li><strong>QR_ID</strong> - идентификатор QR-кода, должен соответствовать значению, указанному в admi.009 с ключом QR_ID,  шаблон: [0-9A-Za-z_=-]{8,50}, обязательный</li></ul></td></tr><tr><td>2.3.2.1</td><td>Name</td><td>Nm</td><td> </td><td>Ключ (Upper Camel Case)</td></tr><tr><td>2.3.2.2</td><td>Value</td><td>Val</td><td> </td><td>Значение</td></tr><tr><td>3</td><td>SupplementaryData</td><td>SplmtryData</td><td>Обязательный в случае успешного ответа (при QR_DATA_TYPE=004)</td><td>Дополнительные данные о мерчанте. Массив. Параметры запроса в виде «ключ-значение»: - в теге - передается ключ; - в теге - передается соответствующее указанному ключу значение. Не допускается указывать один и тот же ключ дважды. Список используемых ключей приведен в <a href="https://app.gitbook.com/o/u7C7n84gFFfiAp8eDPnO/s/oKJIIe9wXRYlANVFHqJE/~/edit/~/changes/103/mezhbankovskaya-sistema-perevodov-i-platezhei/opisanie-struktury-zaprosov/formaty-soobshenii/soobshenie-admi.010-dlya-celevoi-modeli-c2b2_v2">Сообщение admi.010 (для целевой модели C2B2_V2)</a></td></tr><tr><td>3.1</td><td>PlaceAndName</td><td>PlcAndNm</td><td></td><td>Ключ</td></tr><tr><td>3.2</td><td>Envelope</td><td>Envlp</td><td></td><td></td></tr><tr><td>3.2.1</td><td>EnvlpValue</td><td>EnvlpValue</td><td></td><td>Значение</td></tr></tbody></table>

*Значения каналов транзакции:*

<table data-full-width="false"><thead><tr><th>Значение (цифра) 1 - средство предъявления QR-кода</th><th>Значение (цифра) 2 - место транзакции</th><th>Значение (цифра) 3 - присутствие поставщика товара, работы или услуги</th></tr></thead><tbody><tr><td>«0» – печатное (стикер со штриховым кодом поставщика товара, работы или услуги)</td><td>«0» – в месторасположении поставщика товара, работы или услуги/зарегистрированного адреса</td><td><p>«0» – необходимо присутствие поставщика товара, работы или услуги</p><p> </p></td></tr><tr><td>«1» – печатное (квитанция, счет на оплату)</td><td>«1» – не в месторасположении поставщика товара, работы или услуги/зарегистрированного адреса</td><td>«1» – отсутствие поставщика товара, работы или услуги</td></tr><tr><td>«2» – печатное (журнал)</td><td><p>«2» – электронная коммерция</p><p> </p></td><td>«2» – кассы самообслуживания</td></tr><tr><td>«3» – печатное (другое)</td><td><p>«3» – другое</p><p> </p></td><td><p>«3» – другое</p><p> </p></td></tr><tr><td>«4» – электронное (пункт продажи)</td><td>-</td><td>-</td></tr><tr><td>«5» - электронное (вебсайт)</td><td>-</td><td>-</td></tr><tr><td>«6» - электронное (приложение)</td><td>-</td><td>-</td></tr><tr><td>«7» - электронное (другое);</td><td>-</td><td>-</td></tr></tbody></table>