Передача заявок в A-TMS
Запросы HTTPS
Для запроса необходимо передать на адрес
https://atmsapi.alfasoft.by/DataExchange/UploadOrders
запрос типа POST с XML данными в теле запроса. При невозможности использовать HTTPS можно обращаться по тому же адресу через HTTP, но при этом данные не будут защищены при передаче.
Формат XML файла запроса
Тэг <Body> может быть произвольным контейнером, в том числе с вложенностью. Лишние тэги игнорируются. APIKey и APISecret можно получить обратившись в службу поддержки A-TMS atms@alfasoft.by
<?xml version="1.0" encoding="UTF-8"?>
<Body>
  <APIVersion>1</APIVersion>
   <APIKey>QWERTYUIOP</APIKey>
   <APISecret>ASDFGHJKL</APISecret>
   <CancelledOrders>
      <Order>
         <SourceId>1</SourceId>
         <OrderCode>AA0012345</OrderCode>
         <DeliveryDate>25.01.2016</DeliveryDate>
      </Order>
   </CancelledOrders>
   <Orders>
      <Order>
         <OrderCode>BBB000835</OrderCode>
         <Cost>55230.12</Cost>
         <DeliveryDate>25.01.2016</DeliveryDate>
         <OrderDate>24.01.2016</OrderDate>
         <OrderDeliveryTimeFrom>10:00</OrderDeliveryTimeFrom>
         <OrderDeliveryTimeTo>12:45</OrderDeliveryTimeTo>
         <DeliveryTimeFrom1>09:30</DeliveryTimeFrom1>
         <DeliveryTimeTo1>13:10</DeliveryTimeTo1>
         <DeliveryTimeFrom2>16:30</DeliveryTimeFrom2>
         <DeliveryTimeTo2>18:00</DeliveryTimeTo2>
         <ConsignorCode>11</ConsignorCode>
         <ConsignorName>Наименование грузоотправителя</ConsignorName>
         <SourceId>1</SourceId>
         <ClientCode>БВ00000621</ClientCode>
         <ClientPhone>+375216286545</ClientPhone>
         <ClientTIN>400362869</ClientTIN>
         <ClientName>Агро</ClientName>
         <ClientContact>Татьяна</ClientContact>
         <DeliveryAddress>ВИТЕБСКАЯ ОБЛАСТЬ, Оршанский р-н, Бабиничский с/с, аг. Бабиничи, УЛ. ЗАДНЕПРОВСКАЯ, маг."Новый"</DeliveryAddress>
         <DeliveryAddressSegment>Минимаркет</DeliveryAddressSegment>
         <DeliveryAddressLatitude>54.262027</DeliveryAddressLatitude>
         <DeliveryAddressLongitude>30.268465</DeliveryAddressLongitude>
         <DeliveryAddressSOATO>3245501000</DeliveryAddressSOATO>
         <DeliveryAddressRegion>ГОМЕЛЬСКАЯ ОБЛАСТЬ</DeliveryAddressRegion>
         <DeliveryAddressDistrict>Речицкий</DeliveryAddressDistrict>
         <DeliveryAddressCity>Речица</DeliveryAddressCity>
         <DeliveryAddressVilCouncil />
         <DeliveryAddressStreet>ЧАПАЕВА</DeliveryAddressStreet>
         <DeliveryAddressHouse>11</DeliveryAddressHouse>
         <DeliveryAddressHousing />
         <DeliveryAddressAppartment />
         <DeliveryAddressCityType>г.</DeliveryAddressCityType>
         <DeliveryAddressStreetType>11</DeliveryAddressStreetType>
         <DeliveryAddressComments>маг.50 "Юбилейный"</DeliveryAddressComments>
         <WarehouseCode>17</WarehouseCode>
         <WarehouseName>Склад дм Витебск</WarehouseName>
         <WarehouseAddress>Витебск, ул. Центральная 3</WarehouseAddress>
         <Comments>срочно! до [11:00]</Comments>
         <UnloadTime>0:40</UnloadTime>
         <Weight>300.2</Weight>
         <Volume>11.1</Volume>
         <Pallet>0.4</Pallet>
         <Length />
         <GoodsTag>Бакалея</GoodsTag>
         <OutletTag>Тарифная зона 2</OutletTag>
         <Items>
            <Item>
               <ItemBarCode>83579136489</ItemBarCode>
               <ItemName>Сухарики пшенично-ржаные  350г со вкусом краба х150</ItemName>
               <Quantity>796</Quantity>
               <Weight>0.38000</Weight>
               <Volume>0.00269</Volume>
               <Pallet>0.00190</Pallet>
               <Cost>230.78</Cost>
               <ItemUnitCargoName>кор.</ItemUnitCargoName>
               <ItemUnitCargoK>150</ItemUnitCargoK>
               <ItemUnitCargoWeight>5,7</ItemUnitCargoWeight>
               <ItemUnitCargoBarCode>4820047462243</ItemUnitCargoBarCode>
               <ItemGroup>ГРУППА 1</ItemGroup>
               <ItemCategory>Сухарики</ItemCategory>
            </Item>
            <Item>
               <ItemBarCode>98534688</ItemBarCode>
               <ItemName>Сухарики пшенично-ржаные  135г со вкусом краба х150</ItemName>
               <Quantity>796</Quantity>
               <Weight>0.38000</Weight>
               <Volume>0.00269</Volume>
               <Pallet>0.00190</Pallet>
               <Cost>230.78</Cost>
               <ItemUnitCargoName>кор.</ItemUnitCargoName>
               <ItemUnitCargoK>150</ItemUnitCargoK>
               <ItemUnitCargoWeight>5,7</ItemUnitCargoWeight>
               <ItemUnitCargoBarCode>4820047462243</ItemUnitCargoBarCode>
               <ItemGroup>ГРУППА 1</ItemGroup>
               <ItemCategory>Сухарики</ItemCategory>
            </Item>
         </Items>
      </Order>
   </Orders>
</Body>
Формат XML файла ответа
XML с результатом обмена: "ОК" при успехе, "ERROR" либо подробное описание при ошибке. При отсутствии ответа необходимо повторить запрос. Заявки с ответом "ОК" - переданы успешно, их не надо передавать повторно. Если Message Заявки не содержит "OK" - то импорт данной заявки не возможен, в этом случае поле Message содержит описание проблемы.
<?xml version="1.0" encoding="utf-8"?>
<Body>
	<APIVersion>1</APIVersion>
	<APIKey>QWERTYUIOP</APIKey>
	<Message>OK</Message>
	<Orders>
		<Order>
			<OrderCode>BRS00000083</OrderCode>
			<OrderDate>24.01.2016</OrderDate>
			<DeliveryDate>25.01.2016</DeliveryDate>
			<Message>OK</Message>
			<SourceId>1</SourceId>
		</Order>
	</Orders>
</Body>
Made on
Tilda