Get a demo Downloads Contacts API
Transfer orders to A-TMS

HTTPS requests
For a request you need to send to the address
https://atm.a-tms.net/v2/DataExchange/xml/UploadOrders
POST request with XML data in the request body. If it is not possible to use HTTPS, you can use the same address via HTTP, but the data will not be protected during transmission.
Request XML File Format
Tag <Body> can be an arbitrary container, including an attachment. Another tags will be ignored.
APIKey & APISecret can be obtained by writing to support A-TMS [email protected], including during the demo period.
<?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>
         <ExternalOrderId>14a5ccbb-7c63-11e9-addb-0050569c2164</ExternalOrderId>
         <ConsignmentNoteCode>NT 5298222</ConsignmentNoteCode>
         <ConsignmentNoteDate>25.05.2019</ConsignmentNoteDate>
         <Cost>55230.12</Cost>
         <DeliveryDate>25.01.2019</DeliveryDate>
         <OrderDate>24.01.2019</OrderDate>
         <DeliveryTimeFrom1>09:30</DeliveryTimeFrom1>
         <DeliveryTimeTo1>13:10</DeliveryTimeTo1>
         <OrderLoadTime>00:10</OrderLoadTime>
         <OrderUnloadTime>00:15</OrderUnloadTime>
         <ConsignorCode>sample text</ConsignorCode>
         <ConsignorName>sample text</ConsignorName>
         <CarriageCustomerCode>51</CarriageCustomerCode>
         <CarriageCustomerName>sample text</CarriageCustomerName>
         <SourceId>1</SourceId>
         <ClientCode>БВ00000621</ClientCode>
         <ClientPhone>+175216286545</ClientPhone>
         <ClientTIN>400362869</ClientTIN>
         <ClientName>sample text</ClientName>
         <ClientContact>sample text</ClientContact>
         <ExternalOutletId>7618070c-d661-11e7-a2f8-005056853dad</ExternalOutletId>
         <DeliveryAddress></DeliveryAddress>
         <DeliveryAddressSegment>Supermarket</DeliveryAddressSegment>
         <DeliveryAddressLatitude>37.331441</DeliveryAddressLatitude>
         <DeliveryAddressLongitude>121.854037</DeliveryAddressLongitude>
         <DeliveryAddressComments>Fresco</DeliveryAddressComments>
         <IsReverse>0</IsReverse>
         <WarehouseCode>17</WarehouseCode>
         <WarehouseName>FrescoWarehouse</WarehouseName>
         <WarehouseAddress>1070 Story Rd</WarehouseAddress>
         <SalesRepTeam>SalesRepTeam</SalesRepTeam>
         <SalesRepCode>Otp0116</SalesRepCode>
         <SalesRepName>John</SalesRepName>
         <SalesRepPhone>+225216286545</SalesRepPhone>
         <SalesRepEmail>[email protected]</SalesRepEmail>
         <Comments>urgent [11:00]</Comments>
         <UnloadTime>00:40</UnloadTime>
         <Weight>300.2</Weight>
         <Volume>11.1</Volume>
         <Pallet>0.4</Pallet>
         <GoodsTag>Grocery</GoodsTag>
         <OutletTag>Тariff zone</OutletTag>
         <ZoneTag>Delivery area</ZoneTag>
         <Items>
            <Item>
               <ItemName>Fruits</ItemName>
               <Quantity>796</Quantity>
               <Weight>0.38000</Weight>
               <Volume>0.00269</Volume>
               <Pallet>0.00190</Pallet>
               <Cost>230.78</Cost>
               <ItemUnitCargoName>box.</ItemUnitCargoName>
               <ItemUnitCargoK>150</ItemUnitCargoK>
               <ItemUnitCargoWeight>5,7</ItemUnitCargoWeight>
               <ItemUnitCargoBarCode>4820047462243</ItemUnitCargoBarCode>
               <ItemGroup>Group1</ItemGroup>
               <ItemCategory>Fruits</ItemCategory>
            </Item>
            <Item>
               <ItemBarCode>98534688</ItemBarCode>
               <ItemName>Fruits</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>Group1</ItemGroup>
               <ItemCategory>Fruits</ItemCategory>
            </Item>
         </Items>
      </Order>
   </Orders>
</Body>
XML response file format
XML with the result of the exchange: "OK" on success, "ERROR" or a detailed description on error. If there is no response, you should repeat the request. Orders with the answer "OK" - successfully transmitted, they do not need to be resubmitted. If the Message of the order does not contain "OK", then import of this order is not possible. In this case the Message field contains a description of the problem.
<?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