Передача заявок в A-TMS
Запросы HTTPS
Для запроса необходимо передать на адрес
https://atmsapi.alfasoft.by/v2/DataExchange/xml/UploadOrders
запрос типа POST с XML данными в теле запроса. При невозможности использовать HTTPS можно обращаться по тому же адресу через HTTP, но при этом данные не будут защищены при передаче.
Формат XML файла запроса
Тэг <Body> может быть произвольным контейнером, в том числе с вложенностью. Лишние тэги игнорируются. APIKey и APISecret можно получить обратившись в службу поддержки A-TMS [email protected], в том числе и во время тестового периода.
<?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>
         <OrderField1>Примечание1</OrderField1>
         <OrderField2>Примечание2</OrderField2>
         <OrderField3>Примечание3</OrderField3>
         <OrderField4>Примечание4</OrderField4>
         <OrderField5>Примечание5</OrderField5>
         <ConsignmentNoteCode>NT 5298222</ConsignmentNoteCode>
         <ConsignmentNoteDate>25.05.2019</ConsignmentNoteDate>
         <Cost>55230.12</Cost>
         <DeliveryDate>25.01.2019</DeliveryDate>
         <OrderDate>24.01.2019</OrderDate>
         <OrderDeliveryTimeFrom>08:30</OrderDeliveryTimeFrom>
         <OrderDeliveryTimeTo>15:10</OrderDeliveryTimeTo>
         <DeliveryTimeFrom1>09:30</DeliveryTimeFrom1>
         <DeliveryTimeTo1>13:10</DeliveryTimeTo1>
         <OrderLoadTime>00:10</OrderLoadTime>
         <OrderUnloadTime>00:15</OrderUnloadTime>
         <UnloadTime>00:30</UnloadTime>
         <ConsignorCode>Код грузоотправителя</ConsignorCode>
         <ConsignorName>Наименование грузоотправителя</ConsignorName>
         <CarriageCustomerCode>51</CarriageCustomerCode>
         <CarriageCustomerName>Наименование заказчика грузоперевозки</CarriageCustomerName>
         <SourceId>1</SourceId>
         <ClientCode>БВ00000621</ClientCode>
         <ClientPhone>+175216286545</ClientPhone>
         <ClientTIN>400362869</ClientTIN>
         <ClientName>Агро</ClientName>
         <ClientContact>Татьяна</ClientContact>
         <ClientField1>Примечание1</ClientField1>
         <ClientField2>Примечание2</ClientField2>
         <ClientField3>Примечание3</ClientField3>
         <OutletCode>55</OutletCode>
         <ExternalOutletId>7618070c-d661-11e7-a2f8-005056853dad</ExternalOutletId>
         <DeliveryAddress>Россия, Москва, Звёздный бульвар, 32</DeliveryAddress>
         <DeliveryAddressSegment>Минимаркет</DeliveryAddressSegment>
         <DeliveryAddressLatitude>55.814153</DeliveryAddressLatitude>
         <DeliveryAddressLongitude>37.626160</DeliveryAddressLongitude>
         <DeliveryAddressComments>маг.50 "Юбилейный"</DeliveryAddressComments>
         <OutletField1>Примечание1</OutletField1>
         <OutletField2>Примечание2</OutletField2>
         <OutletField3>Примечание3</OutletField3>
         <IsReverse>0</IsReverse>
         <IsFragile>0</IsFragile>
         <IsLight>0</IsLight>
         <DedicatedPallet>0</DedicatedPallet>
         <WarehouseCode>17</WarehouseCode>
         <WarehouseName>Склад</WarehouseName>
         <WarehouseAddress>Москва, Рябиновая улица, 45</WarehouseAddress>
         <SalesRepTeam>Сектор продаж 2</SalesRepTeam>
         <SalesRepCode>Otp0116</SalesRepCode>
         <SalesRepName>Евгений Юрьевич</SalesRepName>
         <SalesRepPhone>+225216286545</SalesRepPhone>
         <SalesRepEmail>[email protected]</SalesRepEmail>
         <Comments>срочно! до [11:00]</Comments>
         <SalesRepField1>Примечание1</SalesRepField1>
         <SalesRepField2>Примечание2</SalesRepField2>
         <SalesRepField3>Примечание3</SalesRepField3>
         <Weight>300.2</Weight>
         <Volume>11.1</Volume>
         <Pallet>0.4</Pallet>
         <Length>3.5</Length>
         <OrderTags>Бакалея, Фрукты, Напитки</OrderTags>
         <GoodsTag>Бакалея</GoodsTag>
         <OutletTag>Тарифная зона 2</OutletTag>
         <ZoneTag>Регион</ZoneTag>
         <Items>
            <Item>
               <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>
               <OrdersGoodsField1>Примечание1</OrdersGoodsField1>
               <OrdersGoodsField2>Примечание2</OrdersGoodsField2>
            </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>
               <OrdersGoodsField1>Примечание1</OrdersGoodsField1>
               <OrdersGoodsField2>Примечание2</OrdersGoodsField2>
            </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