# Запрос на добавление отправителей

{% hint style="info" %}
Отправитель может состоять только из 11-ти латинских символов, цифр, пробелов и знаков "'?><,.-\_=+/"!@#$%^&\*() " или 15-ти цифр
{% endhint %}

## Запрос на добавление отправителей

<mark style="color:green;">`POST`</mark> `http://lk.mysmpp.ru/xml/add_originator.php`

#### Headers

| Name                                           | Type   | Description                    |
| ---------------------------------------------- | ------ | ------------------------------ |
| Content-type<mark style="color:red;">\*</mark> | String | **`text/xml; charset=utf-8;`** |

#### Request Body

| Name                                                            | Type   | Description                                                                                        |
| --------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------- |
| login.value<mark style="color:red;">\*</mark>                   | String | Ваш логин в системе                                                                                |
| token.value<mark style="color:red;">\*</mark>                   | String | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру |
| password.value<mark style="color:red;">\*</mark>                | String | Ваш пароль в системе                                                                               |
| originator.template<mark style="color:red;">\*</mark>           | String | Текст шаблона                                                                                      |
| originator.name\_counterparty<mark style="color:red;">\*</mark> | String | Имя контрагента                                                                                    |
| originator.OGRN<mark style="color:red;">\*</mark>               | Int    | ОГРН организации                                                                                   |
| originator.KPP<mark style="color:red;">\*</mark>                | Int    | КПП организации                                                                                    |
| originator.INN<mark style="color:red;">\*</mark>                | Int    | ИНН организации                                                                                    |
| originator<mark style="color:red;">\*</mark>                    | String | Отправитель, которого нужно добавить                                                               |
| operator.MNC                                                    | Int    | Мобильный код оператора                                                                            |
| operator.MCC                                                    | Int    | Мобильный код страны                                                                               |
| originator.comment                                              | String | Комментарий                                                                                        |
| file.id                                                         | Int    | id загружаемого файла                                                                              |
| file.href                                                       | String | Ссылка на загружаемый файл                                                                         |

{% tabs %}
{% tab title="200: OK В случае получения правильного XML-документа" %}

```xml
<?xml version="1.0" encoding="utf-8" ?>
<response>
     <originator id_originator="">Отправитель поставлен в очередь на регистрацию.</ originator>
</response>

```

{% endtab %}

{% tab title="400: Bad Request В случае возникновения ошибки в отправленном XML-документе" %}

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
     <error>текст ошибки</error>
</response>
```

{% endtab %}
{% endtabs %}

### Расшифровка параметров в ответах на запрос

<table><thead><tr><th width="170.33333333333331">Параметр</th><th width="133">Тип данных</th><th>Описание</th></tr></thead><tbody><tr><td>originator</td><td>String</td><td><p>Результат добавления отправителя. Может содержать следующие значения:</p><ul><li>Отправитель добавлен.</li><li>Отправитель поставлен в очередь на регистрацию. </li><li>Отправитель может состоять только из 11-ти латинских символов, цифр, пробелов и знаков "\'?>&#x3C;,.-_=+/"!@#$%^&#x26;*() " или 15-ти циф</li></ul></td></tr><tr><td>originator.id_originator</td><td>Int</td><td>Уникальный номер отправителя в системе</td></tr><tr><td>error</td><td>String</td><td><p>Текст ошибки может принимать следующие значения:</p><ul><li>Неправильный формат XML документа</li><li>Неправильный логин или пароль</li><li> POST данные отсутствуют</li></ul></td></tr></tbody></table>

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

```xml
<?xml  version="1.0" encoding="utf-8" ?>
<request>
    <security>
        <login value="логин" />
        <password value="пароль" />
    </security>
    <originator INN="ИНН" KPP="КПП" OGRN="ОГРН" name_counterparty="имя контрагента" template="текст шаблона" comment="комментарий" >Отправитель</originator>
    <operator MCC="" MNC=""/>
    …
    <operator MCC="" MNC=""/>
    <file href="http://..." id="1" />
    …
    <file href="http://..." id="4" />
</request>
```