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 office@a-tms.net, 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@email.com</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>
Node файла XMLDescription Required Field
Body yes
APIKeyID company A-TMS
APISecretAPI Access Password
CancelledOrdersList of canceled orders
Orders List of orders for planning
OrderOrder for planning, contained in CancelledOrders and Orders
ItemsList of order items
Order element nodes Description Required Field
OrderCode Delivery request code (must be unique within the same Order Date) yes
ExternalOrderId request id in the external accounting system, number, text or guid
ConsignmentNoteCode Consignment Note number
ConsignmentNoteDate Consignment Note date
Cost Cost of goods
DeliveryDate Delivery date (dd.MM.yyyy) yes
OrderDate Order Date (dd.MM.yyyy)
DeliveryTimeFrom1 Delivery time from (HH: mm)
DeliveryTimeTo1 Delivery time to (HH: mm)
OrderLoadTime Duration of loading goods in the warehouse (HH: mm)
OrderUnloadTime Duration of unloading goods at the delivery point (HH: mm)
ConsignorCode Shipper code (product owner)
ConsignorName Shipper name (product owner)
CarriageCustomerCode Cargo shipping customer code
CarriageCustomerName Customer name
SourceId id of the accounting system, if XML exchange occurs with several accounting systems (integer or text up to 255 characters)
ClientCode Client code (delivery point owner)
ClientPhone Client Phone
ClientTIN Client TIN
ClientName Client Name
ClientContact Client Contact
DeliveryAddress Delivery address (for cities it is important to have the name of the city, street and house number, for villages the region and district, the name of the locality is important)
DeliveryAddressSegment Type of delivery point, complexity group of the delivery point, affecting delivery rates
DeliveryAddressLatitude Latitude of the delivery point in fractional degrees
DeliveryAddressLongitude Longitude of the delivery point in fractional degrees
DeliveryAddressComments Comment on the address of the delivery point, the name of the point, store
IsReverse Return (empty and 0 - no, 1 - yes)
WarehouseCode Shipment warehouse code
WarehouseName Warehouse name
WarehouseAddress Warehouse Address Yes
SalesRepTeam Sales Agent Team
SalesRepCode Sales Agent Code
SalesRepName Full name of the sales agent
SalesRepPhone Sales Agent Phone
SalesRepEmail Sales Agent Email
Comments Comment of the sales agent on the delivery order
UnloadTime Downtime at the delivery point (HH: mm)
Weight Weight of cargo, kg yes
Volume Volume of cargo, m3
Pallet Number of pallets
GoodsTag Tag of the compatibility of the orders (for example: grocery, fish, frozen food...)
OutletTag Tag of compatibility of delivery points
ZoneTag Delivery area tag
Item nodes Item Description Required
ItemBarCode Item barcode
ItemName Item Name yes
Quantity Quantity of goods (pieces)
Weight Weight, kg
Volume Volume, m3
Pallet Number of pallets
Cost The sum of the cost of the goods
ItemUnitCargoName Name of the unit of measure for cargo (box, barrel)
ItemUnitCargoK Number of pieces per unit of measure
ItemUnitCargoWight Unit Weight
ItemUnitCargoBarCode Cargo barcode
ItemGroup Product Group
ItemCategory Product category (subgroup)
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>
Response options in the Message field Description
OK Import was successful
ERROR There are errors in one or several orders (if there are orders without errors, they will still be imported)
missing OrderCode There is no order code in the order
missing DeliveryAddress The order has no delivery address
missing WarehouseAddress There is no warehouse address in the order
missing Weight Order weight is not filled
Made on
Tilda