# Обмен 1С и Platform

# ExchangeChangesFrom1C

Содержит описание набора методов web-сервиса "ExchangeChangesFrom1C", предназначенные для получения, проверки и отправки данных из 1С на Platform.

# Проверить доступ к web-сервису Ping

**Метод Ping позволит проверить доступ к WEB-сервису 1С для вашего ресурса.**

#### Авторизация

<details id="bkmrk-authorizations%3A-%C2%A0htt"><summary>Authorizations:</summary>

 HTTP: Basic Auth

Логин: User1

Пароль: \*\*\*\*\*\*\*\*\*\*

</details>#### Примеры кода

#### <span style="background-color: rgb(236, 240, 241); color: rgb(53, 152, 219);">Как использовать пример</span>

```json
http://<имя веб сервера>/<имя базы>/hs/ExchangeChangesFrom1C/ping
```

<table border="1" id="bkmrk-%D0%98%D0%BC%D1%8F-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%B0-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td style="border-color: rgb(206, 212, 217);">**<span style="background-color: rgb(255, 255, 255);">Имя параметра</span>**</td><td style="border-color: rgb(206, 212, 217);">**<span style="background-color: rgb(255, 255, 255);">Описание</span>**</td></tr><tr><td>&lt;имя веб сервера&gt;</td><td>Адрес базы данных, к WEB-сервису которой мы обращаемся.</td></tr><tr><td>&lt;имя базы&gt;</td><td>Имя базы данных к которой обращаемся.</td></tr></tbody></table>

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

```
http://web1c.noboring-finance.ru/unf_sandbox/hs/ExchangeChangesFrom1C/ping
```

#### Обработка ответа

<details id="bkmrk-200-it%27s-successful"><summary>HTTP-статус: 200</summary>

It's successful

</details>Доступ к WEB-сервису получен.

#### Обработка ошибок

<details id="bkmrk-http-%D1%81%D1%82%D0%B0%D1%82%D1%83%D1%81%3A-401-una"><summary>HTTP-статус: 401</summary>

<div><div>Unauthorized</div></div></details>Неверные учетные данные. Введите корректные доступы к системе.

<details id="bkmrk-403-%D0%9D%D0%B5%D0%B4%D0%BE%D1%81%D1%82%D0%B0%D1%82%D0%BE%D1%87%D0%BD%D0%BE-%D0%BF%D1%80%D0%B0"><summary>HTTP-статус: 403</summary>

Недостаточно прав для использования ресурса с данным HTTP методом

</details>Означает что у пользователя нет прав для работы с выбранным WEB-сервисом. Для предоставления такого доступа рекомендуется пользователю присвоить группу доступа в 1С "(MXSP) Доступ к WEB-сервису для Platform" (см. рис. 1).

[![image.png](https://wiki.noboring-finance.ru/uploads/images/gallery/2025-02/scaled-1680-/HBeimage.png)](https://wiki.noboring-finance.ru/uploads/images/gallery/2025-02/HBeimage.png)

Рисунок 1 - Группа доступа для использования WEB-сервиса.

# Получить измененные данные из 1С GetChangedData

**Метод GetChangedData позволяет получить массив именных в 1С объектов.**

#### Авторизация

<details id="bkmrk-authorizations%3A-%C2%A0htt"><summary>Authorizations:</summary>

 HTTP: Basic Auth

Логин: User1

Пароль: \*\*\*\*\*\*\*\*\*\*

</details>#### Параметры метода

<table border="1" id="bkmrk-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-st" style="border-collapse: collapse; width: 100%; height: 154.75px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px;">**<span style="background-color: rgb(255, 255, 255);">Название</span>**

`тип`

</td><td class="align-left" style="height: 29.7969px;">**<span style="background-color: rgb(255, 255, 255);">Описание</span>**</td></tr><tr style="height: 124.953px;"><td style="height: 124.953px;">stop  
`integer`  
</td><td style="height: 124.953px;">Параметр используется для управления постраничной навигацией.

Размер страницы результатов задается пользователем. В случае отсутствия параметра в запросе, возвращает все страницы в одном запросе.

</td></tr></tbody></table>

#### Примеры кода

#### <span style="background-color: rgb(236, 240, 241); color: rgb(53, 152, 219);">Как использовать пример</span>

```
http://web1c.noboring-finance.ru/unf_sandbox/hs/ExchangeChangesFrom1C/get/changed/data?stop=5
```

#### Обработка ответа

<details id="bkmrk-http-%D1%81%D1%82%D0%B0%D1%82%D1%83%D1%81%3A-200-%7B%C2%A0-"><summary>HTTP-статус: 200</summary>

{  
 "Value": \[  
 {  
 "Ref\_Key": "0678427d-e399-11ef-8682-3cecefa65c6f",  
 "Object\_Type": "Document\_АктВыполненныхРабот",  
 "DeletionMark": false  
 },  
 {  
 "Ref\_Key": "21b20b04-e399-11ef-8682-3cecefa65c6f",  
 "Object\_Type": "Document\_АктВыполненныхРабот",  
 "DeletionMark": false  
 },  
 {  
 "Ref\_Key": "5a882007-e399-11ef-8682-3cecefa65c6f",  
 "Object\_Type": "Document\_АктВыполненныхРабот",  
 "DeletionMark": false  
 },  
 {  
 "Ref\_Key": "78e4af01-e399-11ef-8682-3cecefa65c6f",  
 "Object\_Type": "Document\_АктВыполненныхРабот",  
 "DeletionMark": false  
 },  
 {  
 "Ref\_Key": "8f28d433-e399-11ef-8682-3cecefa65c6f",  
 "Object\_Type": "Document\_АктВыполненныхРабот",  
 "DeletionMark": false  
 }  
 \],  
 "PackageNumber": 1,  
 "Amount": 5  
}

</details>
#### Возвращаемые данные

<table border="1" id="bkmrk-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D1%82%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td><span class="align-left" style="background-color: rgb(255, 255, 255);">**Название**</span>

`тип`

</td><td>**<span style="background-color: rgb(255, 255, 255);">Описание</span>**</td></tr><tr><td>Value  
`array`  
</td><td>Корневой элемент ответа. Содержит массив из объектов, содержащих информацию об измененных объектах.

Массив объектов, вида:

```
{
 "Ref_Key": "000dd874-dfc7-11ef-8682-3cecefa65c6f",
 "Object_Type": "Document_АктВыполненныхРабот",
 "DeletionMark": false
}
```

где

- Ref\_Key - Уникальный идентификатор объекта
- Object\_Type - тип объекта
- DeletionMark - статус документа (содержит `true` если объект помечен на удаление)

</td></tr><tr><td>PackageNumber

`integer`

</td><td>Номер сообщения отправки данных.</td></tr><tr><td>Amount

`integer`

</td><td>Общее количество переданных элементов.</td></tr></tbody></table>


#### Обработка ошибок

<details id="bkmrk-http-%D1%81%D1%82%D0%B0%D1%82%D1%83%D1%81%3A-400-%7B-%C2%A0"><summary>HTTP-статус: 400</summary>

<div><div>{</div><div> "Error": "-",</div><div> "Error_Description": "Failed to convert the value of the parameter 'stop' to a number"</div><div>}</div></div></details><table border="1" id="bkmrk-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D1%82%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8-1" style="border-collapse: collapse; width: 100%; height: 117.375px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 57.7812px;"><td style="height: 57.7812px;">**Название**

`тип`

</td><td style="height: 57.7812px;">**Описание**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Error

`string`

</td><td style="height: 29.7969px;">Строковый код ошибки. Состоит из цифр.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Error\_Description

`string`

</td><td style="height: 29.7969px;">Текстовое описание ошибки. </td></tr></tbody></table>

#### Возможные коды ошибок

<table border="1" id="bkmrk-%D0%9A%D0%BE%D0%B4-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D0%97%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8" style="border-collapse: collapse; width: 100%; height: 89.3907px;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Код**</td><td style="height: 29.7969px;">**Описание**</td><td style="height: 29.7969px;">**Значение**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">101</td><td style="height: 29.7969px;">Invalid value for the parameter 'stop' in the request</td><td style="height: 29.7969px;">Неверно передано значение параметра в запросе.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">102</td><td style="height: 29.7969px;">Failed to convert the value of the parameter 'stop' to a number</td><td style="height: 29.7969px;">Ошибка преобразования переданного параметра в число.</td></tr></tbody></table>

# Передать результат обработки данных DataReceived

**Метод DataReceived позволяет сообщить 1С о тех наборах данных которые были обработаны сервисом.**

#### Авторизация

<details id="bkmrk-authorizations%3A-%C2%A0htt"><summary>Authorizations:</summary>

 HTTP: Basic Auth

Логин: User1

Пароль: \*\*\*\*\*\*\*\*\*\*

</details>#### Параметры метода

<table border="1" id="bkmrk-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-st" style="border-collapse: collapse; width: 100%; height: 154.75px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td class="align-left" style="height: 29.7969px;">**<span style="background-color: rgb(255, 255, 255);">Название</span>**

`тип`

</td><td class="align-left" style="height: 29.7969px;">**<span style="background-color: rgb(255, 255, 255);">Описание</span>**</td></tr><tr style="height: 124.953px;"><td style="height: 124.953px;"><div><div>PackageNumbers</div></div>`array`</td><td style="height: 124.953px;">Содержит массив номеров сообщений полученных методом GetChangedData. Номер сообщения содержится в обязательном параметре "PackageNumber". Параметр обязателен при отправке сообщения о получении данных.

</td></tr></tbody></table>

#### Примеры кода

#### <span style="background-color: rgb(236, 240, 241); color: rgb(53, 152, 219);">Как использовать пример</span>

```
http://web1c.noboring-finance.ru/unf_sandbox/hs/ExchangeChangesFrom1C/data/received
```

#### Обработка ответа

<details id="bkmrk-http-%D1%81%D1%82%D0%B0%D1%82%D1%83%D1%81%3A-200-%7B%C2%A0-"><summary>HTTP-статус: 200</summary>

<div><div>{</div><div> "Result": true</div><div>}</div></div></details>
#### Возвращаемые данные

<table border="1" id="bkmrk-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D1%82%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td><span class="align-left" style="background-color: rgb(255, 255, 255);">**Название**</span>

`тип`

</td><td>**<span style="background-color: rgb(255, 255, 255);">Описание</span>**</td></tr><tr><td>Result  
`boolean`  
</td><td>Корневой элемент ответа, содержит `true` в случае успеха.</td></tr></tbody></table>


#### Обработка ошибок

<details id="bkmrk-http-%D1%81%D1%82%D0%B0%D1%82%D1%83%D1%81%3A-400-%7B-%C2%A0"><summary>HTTP-статус: 400</summary>

<div><div>{</div><div> "Error": "-",</div><div> "Error_Description": "Invalid values for parameter {PackageNumbers}"</div><div>}</div></div></details><table border="1" id="bkmrk-%D0%9D%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D1%82%D0%B8%D0%BF-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8-1" style="border-collapse: collapse; width: 100%; height: 117.375px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 57.7812px;"><td style="height: 57.7812px;">**Название**

`тип`

</td><td style="height: 57.7812px;">**Описание**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Error

`string`

</td><td style="height: 29.7969px;">Строковый код ошибки. Состоит из цифр.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Error\_Description

`string`

</td><td style="height: 29.7969px;">Текстовое описание ошибки. </td></tr></tbody></table>

#### Возможные коды ошибок

<table border="1" id="bkmrk-%D0%9A%D0%BE%D0%B4-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D0%97%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8" style="border-collapse: collapse; width: 100%; height: 262.766px;"><colgroup><col style="width: 33.3745%;"></col><col style="width: 33.3745%;"></col><col style="width: 33.3745%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Код**</td><td style="height: 29.7969px;">**Описание**</td><td style="height: 29.7969px;">**Значение**</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">201</td><td style="height: 46.5938px;">An empty array was passed in parameter {PackageNumbers}</td><td style="height: 46.5938px;">Передан пустой массив значений.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">202</td><td style="height: 46.5938px;">Invalid values for parameter {PackageNumbers}</td><td style="height: 46.5938px;">Передано неверное значение в параметр "PackageNumbers".</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">203</td><td style="height: 63.3906px;">Could not find value for parameter {PackageNumbers}</td><td style="height: 63.3906px;">Значение для параметра "PackageNumbers" отсутствует в переданных данных.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">204</td><td style="height: 29.7969px;">-</td><td style="height: 29.7969px;">Внутренняя ошибка сервера.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">205</td><td style="height: 46.5938px;">Parameter 'PackageNumbers' must be array</td><td style="height: 46.5938px;">Переданный параметр не является массивом.</td></tr></tbody></table>