Основные правила XML обмена v1

HTTP, HTTPS XML обмен Учетной системы и A-TMS

Передача заявок в XML формате может быть настроена в учетной системе, как автоматическая отправка запросов каждые несколько минут, либо XML файлы заявок можно загружать вручную через импорт XML заявок в приложении.

1

Учетная система отправляет XML запрос по расписанию

Корректно отформатированный XML содержащий ApiVersion, ApiKey и ApiSecret. Оптимальный интервал обмена 5-20 минут.

2

A-TMS производит обработку
и возвращает ответ

XML с результатом обмена: "ОК" при успехе, "ERROR" либо подробное описание при ошибке.

3

Учетная система получает данные и статус обмена

При отсутствии ответа "ОК" необходимо повторить запрос по расписанию. Заявки с ответом "ОК" помечаются как успешно переданные, и не передаются повторно.

Запросы HTTPS

Для запроса необходимо передать на адрес
https://atmsapi.alfasoft.by/v2/DataExchange/xml/[НАЗВАНИЕ_СЕРВИСА]
(СМ. КОНКРЕТНЫЕ ЗАПРОСЫ) запрос типа POST с XML данными в теле запроса. При невозможности использовать HTTPS можно обращаться по тому же адресу через HTTP, но при этом данные не будут защищены при передаче.

Формат XML файла запроса

Тэг <Body> может быть произвольным тэгом, если это требуется учетной системой, его имя игнорируется. Не известные тэги игнорируются. APIKey и APISecret можно получить обратившись в службу поддержки A-TMS atms@alfasoft.by

<?xml version="1.0" encoding="utf-8" ?> 
<Body>
  <APIKey>QWERTYUIOP</APIKey>
  <APISecret>ASDFGHJKL</APISecret>
  <!-- ЗДЕСЬ XML ДАННЫЕ ЗАПРОСА, СМ. ОПИСАНИЕ КОНКРЕТНЫХ  ЗАПРОСОВ -->
</Body>

Формат XML файла ответа

<?xml version="1.0" encoding="utf-8" ?> 
<Body>
  <APIKey>QWERTYUIOP</APIKey> 
  <!-- ПОДРОБНОСТИ ОТВЕТА, НАПРИМЕР, ПО ЗАЯВКАМ -->
</Body>