# Добавление отправителей

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

Спецификация для добавления отправителей: XML

{% tabs %}
{% tab title="XML" %}
Метод отправки **`POST`**

Кодировка XML-документов: **`UTF-8`**

Обязательный заголовок: **`Content-type: text/xml; charset=utf-8;`**

Адрес для запроса: **`https://my3.webcom.mobi/xml/add_originator.php`**

### Параметры запроса на отправку сообщения <a href="#parametry-zaprosa-na-otpravku-soobsheniya-2" id="parametry-zaprosa-na-otpravku-soobsheniya-2"></a>

<table><thead><tr><th width="210">Параметр</th><th width="110.66666666666666">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><p>request</p><p><mark style="color:blue;">.security</mark></p><p><mark style="color:blue;">.login</mark></p><p><mark style="color:orange;">[value]</mark>*</p></td><td>String</td><td>Ваш логин в системе</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.security</mark></p><p><mark style="color:blue;">.password</mark></p><p><mark style="color:orange;">[value]</mark>*</p></td><td>String</td><td>Ваш пароль в системе</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.security</mark></p><p><mark style="color:blue;">.token</mark></p><p><mark style="color:orange;">[value]</mark>*</p></td><td>String</td><td>Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.originator</mark>*</p></td><td>String</td><td>Отправитель, которого нужно добавить</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.originator</mark></p><p><mark style="color:green;">[inn]</mark></p></td><td>Int</td><td>ИНН организации</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.originator</mark></p><p><mark style="color:green;">[kpp]</mark></p></td><td>Int</td><td>КПП организации</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.originator</mark></p><p><mark style="color:green;">[ogrn]</mark></p></td><td>Int</td><td>ОГРН организации</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.originator</mark></p><p><mark style="color:green;">[name_counterparty]</mark></p></td><td>String</td><td>Имя контрагента</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.originator</mark></p><p><mark style="color:green;">[template]</mark></p></td><td>String</td><td>Текст шаблона</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.originator</mark></p><p><mark style="color:green;">[comment]</mark></p></td><td>String</td><td>Комментарий</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.operator</mark></p><p><mark style="color:green;">[mcc]</mark></p></td><td>Int</td><td>Мобильный код страны</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.operator</mark></p><p><mark style="color:green;">[mnc]</mark></p></td><td>Int</td><td>Мобильный код оператора</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.file</mark></p><p><mark style="color:green;">[href]</mark></p></td><td>String</td><td>Ссылка на загружаемый файл</td></tr><tr><td><p>request</p><p><mark style="color:blue;">.file</mark></p><p><mark style="color:green;">[id]</mark></p></td><td>Int</td><td>Id загружаемого файла</td></tr></tbody></table>

\*- обязательный параметр

### В случае получения правильного XML-документа

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

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

### &#x20;В случае возникновения ошибки в отправленном XML-документе

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

<table><thead><tr><th width="197.66666666666666">Параметр</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><p>response</p><p><mark style="color:blue;">.error</mark></p></td><td>String</td><td><p>Текст ошибки может принимать следующие значения:</p><ul><li>Неправильный формат XML документа </li><li>Ваш аккаунт заблокирован</li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul></td></tr></tbody></table>

### &#x20;Пример 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>
```

{% endtab %}
{% endtabs %}