Передача транспорта в A-TMS
Запросы HTTPS
Для запроса необходимо передать на адрес
https://atmsapi.alfasoft.by/v2/DataExchange/xml/UploadCars
запрос типа POST с XML данными в теле запроса. При невозможности использовать HTTPS можно обращаться по тому же адресу через HTTP, но при этом данные не будут защищены при передаче.
Формат XML файла запроса
Тэг <Body> может быть произвольным контейнером, в том числе с вложенностью. Лишние тэги игнорируются. APIKey и APISecret можно получить обратившись в службу поддержки A-TMS [email protected], в том числе и во время тестового периода.
<?xml version="1.0" encoding="UTF-8"?>
<Body>
   <APIKey>QWERTYUIOP</APIKey>
   <APISecret>ASDFGHJKL</APISecret>
   <Drivers>
      <Driver>
		<ExternalDriverId>0E42B289-02F7-4839-9FBF-1117A9C72894</ExternalDriverId>
		<Code>123</Code>
		<FirstName>Иван</FirstName>
		<LastName>Иванов</LastName>
		<MiddleName>Петрович</MiddleName>
		<Carrier>ОАО Перевозчик</Carrier>
		<PhoneNumber>+1234567890</PhoneNumber>
		<Email>[email protected]</Email>
		<WorkTimeFrom>09:00</WorkTimeFrom>
		<WorkTimeTo>18:00</WorkTimeTo>
		<Note>Примечание (до 255 символов)</Note>
		<Field1>Примечание1</Field1>
		<Field2>Примечание2</Field2>
		<Field3>Примечание3</Field3>
      </Driver>
   </Drivers>
   <Cars>
      <Car>
        <ExternalCarId>0DA76EAC-1FA0-4507-8518-DA9F43F813BE</ExternalCarId>
		<Code>12345 EA-7</Code>
		<Name>HYUNDAI HD 78</Name>
		<Carrier>ООО Перевозчик</Carrier>
		<MaxWeight>4000</MaxWeight>
		<MaxVolume>15</MaxVolume>
		<MaxPallet>12</MaxPallet>
		<MaxLength>5</MaxLength>
		<MaxOutlets>25</MaxOutlets>
		<MaxRoutes>1</MaxRoutes>
		<ParkingName>Стоянка 1</ParkingName>
		<ParkingAddress>г. Москва, ул. Звёздный бульвар, 32</ParkingAddress>
		<IsActive>1</IsActive>
		<ExternalDriverId>0E42B289-02F7-4839-9FBF-1117A9C72894</ExternalDriverId>
		<ExternalCarrierId>8851ff82-c68b-4cf5-94b4-f7b2a06cec63</ExternalCarrierId>
		<Field1>Примечание1</Field1>
		<Field2>Примечание2</Field2>
		<Field3>Примечание3</Field3>
      </Car> 
   </Cars>
 </Body>
Формат XML файла ответа
XML с результатом обмена: "ОК" при успехе, "ERROR" либо подробное описание при ошибке. При отсутствии ответа необходимо повторить запрос.
<?xml version="1.0" encoding="utf-8"?>
<Body>
	<APIVersion>1</APIVersion>
	<APIKey>QWERTYUIOP</APIKey>
	<Message>OK</Message>
</Body>
Made on
Tilda