Сервис запросов на оценку

Обновлено 26 декабря 2023

Описание cервиса запросов на оценку

С помощью данного API Клиенты могут отправлять запросы на оценку клиентов и других участников на благонадежность при совершении финансовых и других сделок.

Используемые форматы перечислены здесь. С правилами формирования сообщения можно ознакомиться здесь

Параметры вызова и ответа

Параметр вызова	Значение
Endpoint	https://api.sberbank.ru:8443/prod/skif/chs/v1/requests
HTTP метод	POST
Request Parameters
RqUID (в заголовке)	470cba89fde34d9ebb1afa6decc5df6a
Authorization (в заголовке)	Bearer 29453357-7ef1-45bc-b8ab-4f1944fd0b80 Полученный токен по этой инструкции
Content-Type	application/xml; charset=UTF-8
Request Body	XML элемент типа srvGetCreditHistoryAndFraudScoreRq
Response Code	HTTP-код результата ответа
Response Parameters
Response Body	Для успешного ответа тело отсутствует. Возвращается статус 204 (No Content)

ошибки ответа Response Body может отличаться, т.к. зависит от источника:

<Map>
    <timestamp></timestamp>
    <status>400</status>
    <error>Validation Error. Request phase</error>
    <path>/skif/chs/v1/requests</path>
</Map>

Либо

{"httpCode":"401", "httpMessage":"Unauthorized", "moreInformation":"Invalid credentials"}

Классификация возвращаемых кодов

Код	Описание
204 "No Content"	Успешное создание запроса
400 "Bad Request"	Ошибки валидации как тела, так и параметров запроса
401 "Unauthorized"	Отсутствует заголовок Authorization, невалидный токен для данного запроса, использование чужого или пустого сертификата и пр.
403 "Forbidden"	Запрет доступа
404 "Not Found"	Некорректный url вызова API
405 "Method Not Allowed"	Использование запрещенного HTTP метода
500 "Internal Server Error"	Внутренние ошибки сервера. Необходимо обратиться в поддержку по адресу: SKIF@sberbank.ru для проведения анализа.

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

POST https://api.sberbank.ru:8443/prod/skif/chs/v1/requests HTTP/1.1
Authorization: Bearer 29453357-7ef1-45bc-b8ab-4f1944fd0b80 - подставить полученный токен
RqUID: 470cba89fde34d9ebb1afa6decc5df6a
Content-Type: application/xml; charset=UTF-8
 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<srvGetCreditHistoryAndFraudScoreRq>
    <header>
        <rqUid>9d80b949c362419584faeca9d8567b63</rqUid>
        <rqTm>2021-02-16T12:39:59Z</rqTm>
        <SPName>urn:sbrfsystems:99-portalda</SPName>
        <storageTime>600</storageTime>
    </header>
    <request>
        <dealInfo>
            <ids>
                <externalId>a33f07bbbdd54bb4858b64a09cd32211</externalId>
                <addId>93b43dfd-0190-4059-aa6a-a088982ae911</addId>
            </ids>
            <creationDateTime>2021-02-09T19:10:54+03:00</creationDateTime>
            <reasonForEnquiry>01</reasonForEnquiry>
            <scoreRules>INVEST</scoreRules>
        </dealInfo>
        <participants>
            <participant>
                <ids>
                    <externalId>a33f07bbbdd54bb4858b64a09cd32241</externalId>
                    <addId>93b43dfd-0190-4059-aa6a-a088982ae941</addId>
                </ids>
                <rolesList>
                    <role>4</role>
                </rolesList>
                <scoreRules>INVEST</scoreRules>
                <organization>
                    <fullName>Full name</fullName>
                    <inn>8568155370</inn>
                    <ogrn>1236548521230</ogrn>
                    <okpo>17274730</okpo>
                    <kpp>123654852</kpp>
                    <registrationDate>2020-04-01</registrationDate>
                </organization>
                <addresses>
                    <address>
                        <type>FACT</type>
                        <index>567888</index>
                        <region>
                            <regionId>00</regionId>
                        </region>
                        <city>
                            <cityName>Москва</cityName>
                        </city>
                        <streetAddress>
                            <street>
                                <streetName>Немосковская</streetName>
                            </street>
                            <houseNumber>555</houseNumber>
                            <buildingNumber/>
                            <blockNumber>5</blockNumber>
                            <flatNumber>555</flatNumber>
                        </streetAddress>
                    </address>
                    <address>
                        <type>REG</type>
                        <index>434321</index>
                        <region>
                            <regionId>00</regionId>
                        </region>
                        <city>
                            <cityName>Москва</cityName>
                        </city>
                        <streetAddress>
                            <street>
                                <streetName>Выдуманная</streetName>
                            </street>
                            <houseNumber>222</houseNumber>
                            <buildingNumber/>
                            <blockNumber/>
                            <flatNumber>1</flatNumber>
                        </streetAddress>
                    </address>
                </addresses>
            </participant>
            <participant>
                <ids>
                    <externalId>a33f07bbbdd54bb4858b64a09cd32242</externalId>
                    <addId>93b43dfd-0190-4059-aa6a-a088982ae942</addId>
                </ids>
                <rolesList>
                    <role>1</role>
                </rolesList>
                <scoreRules>INVEST</scoreRules>
                <organization>
                    <fullName>AO БЕДНЫЙ ЙОРИК</fullName>
                    <inn>2553081140</inn>
                    <ogrn>1552463059257</ogrn>
                    <okpo>39372574</okpo>
                    <kpp>193125713</kpp>
                    <registrationDate>2015-04-08</registrationDate>
                </organization>
                <phone>
                    <number>+74959988988111</number>
                </phone>
                <addresses>
                    <address>
                        <type>FACT</type>
                        <index>151515</index>
                        <region>
                            <regionId>00</regionId>
                        </region>
                        <city>
                            <cityName>Москва</cityName>
                        </city>
                        <streetAddress>
                            <street>
                                <streetName>Наноорыднка</streetName>
                            </street>
                            <houseNumber>10</houseNumber>
                            <buildingNumber/>
                            <blockNumber/>
                            <flatNumber>12</flatNumber>
                        </streetAddress>
                    </address>
                    <address>
                        <type>REG</type>
                        <index>151515</index>
                        <region>
                            <regionId>00</regionId>
                        </region>
                        <city>
                            <cityName>Самара</cityName>
                        </city>
                        <streetAddress>
                            <street>
                                <streetName>Виртуальная Ордынка</streetName>
                            </street>
                            <houseNumber>10</houseNumber>
                            <buildingNumber>4</buildingNumber>
                            <blockNumber/>
                            <flatNumber>12</flatNumber>
                        </streetAddress>
                    </address>
                </addresses>
            </participant>
            <participant>
                <ids>
                    <externalId>a33f07bbbdd54bb4858b64a09cd32243</externalId>
                    <addId>93b43dfd-0190-4059-aa6a-a088982ae943</addId>
                </ids>
                <rolesList>
                    <role>4</role>
                </rolesList>
                <scoreRules>INVEST</scoreRules>
                <naturalPerson>
                    <inn>528921661284</inn>
                    <pensionNumber>032-627-873 52</pensionNumber>
                    <currentPersonData>
                        <lastName>Виртуальный</lastName>
                        <firstName>Александр</firstName>
                        <middleName>Сергеевич</middleName>
                        <birthDate>1988-08-19</birthDate>
                    </currentPersonData>
                    <primaryId>
                        <idType>01</idType>
                        <serie>1234</serie>
                        <number>123456</number>
                        <issueDate>2020-07-01</issueDate>
                        <issueAuthority>ОВД Пулково</issueAuthority>
                        <authorityCode>171644</authorityCode>
                    </primaryId>
                </naturalPerson>
                <addresses>
                    <address>
                        <type>FACT</type>
                        <index>325112</index>
                        <region>
                            <regionId>00</regionId>
                        </region>
                        <city>
                            <cityName>Москва</cityName>
                        </city>
                        <streetAddress>
                            <street>
                                <streetName>Тестовая</streetName>
                            </street>
                            <houseNumber>32432</houseNumber>
                        </streetAddress>
                    </address>
                    <address>
                        <type>REG</type>
                        <index>112345</index>
                        <region>
                            <regionId>00</regionId>
                        </region>
                        <city>
                            <cityName>Тестовый</cityName>
                        </city>
                        <streetAddress>
                            <street>
                                <streetName>Виртуальная</streetName>
                            </street>
                            <houseNumber>1</houseNumber>
                            <blockNumber>А</blockNumber>
                        </streetAddress>
                    </address>
                </addresses>
            </participant>
        </participants>
    </request>
</srvGetCreditHistoryAndFraudScoreRq>

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

В качестве ответа, в случае успешной обработки запроса, придет пустое сообщение с HTTP статусом 204.

HTTP/1.1 204 OK
Server: nginx/1.50.1
Date: Mon, 10 Oct 2021 14:34:55 GMT
Content-Type: application/xml;charset=UTF-8
Content-Length: 4182
Connection: keep-alive
X-Gravitee-Transaction-Id: 8e7e9515-8800-4636-be95-15880086366e
X-Gravitee-Request-Id: 8e7e9515-8800-4636-be95-15880086366e
X-Rate-Limit-Limit: 20
X-Rate-Limit-Remaining: 19
X-Rate-Limit-Reset: 1634567695951
x-introspect-rquid: 1590f5ba5b80b0796345afc3f506d3d8
Accept-Ranges: bytes