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-logistics@yandex.ru
<?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>
Made on
Tilda