Transfer orders to A-TMS
HTTPS requests
For a request you must 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 access 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>
         <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 must repeat the request. Applications with the answer "OK" - successfully transmitted, they do not need to be resubmitted. If the Message Application does not contain "OK", then import of this application 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