Получение рейсов из A-TMS
Запросы HTTPS
Для запроса необходимо передать на адрес
https://atmsapi.alfasoft.by/v2/DataExchange/xml/LoadRoutes
запрос типа 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> 
	<PlanDate>07.10.2019</PlanDate> 
	<SourceId>1</SourceId> 
</Body>
Запрос по дате доставки:
<?xml version="1.0" encoding="utf-8"?>
<Body>
	<APIVersion>1</APIVersion>
	<APIKey>QWERTYUIOP</APIKey> 
	<APISecret>ASDFGHJKL</APISecret> 
	<DeliveryDate>07.10.2019</DeliveryDate> 
	<SourceId>1</SourceId> 
</Body>
Формат XML файла ответа
XML с результатами планирования за переданную дату PlanDate. При отсутствии рейсов сформированных логистом за PlanDate будет передан ответ с пустым тэгом <Routes/>. При заполненном в запросе SourceId, выгружены будут только заявки совпадающее по этому полю, используется для разделения результата планирования по нескольким учетным системам.
<?xml version="1.0" encoding="utf-8"?>
<Body>
	<APIKey>QWERTYUIOP</APIKey>
	<Routes>
		<Route>
			<RouteCode>011174</RouteCode>
			<Waybill>9548</Waybill>
			<StartDate>07.10.2016</StartDate>
			<StartTime>09:00</StartTime>
			<ExternalDriverId>0E42B289-02F7-4839-9FBF-1117A9C72894</ExternalDriverId>
			<DriverCode>1234ABCD</DriverCode>
			<DriverName>Кириллов В.В.</DriverName>
			<ExternalCarId>0DA76EAC-1FA0-4507-8518-DA9F43F813BE</ExternalCarId>
			<CarCode>АЕ1234-5</CarCode>
			<CarName>WV CRAFTER</CarName>
			<CarrierCode>123</CarrierCode>
			<CarrierName>Перевозчик</CarrierName>
			<WarehouseCode>17</WarehouseCode>
			<WarehouseName>Склад Витебск</WarehouseName>
			<RoutePaidLength>0</RoutePaidLength>
			<RouteLength>400.8</RouteLength>
			<RouteTime>15.6</RouteTime>
			<Cost>247.06</Cost>
			<CostTime>0</CostTime>
			<CostLength>160.32</CostLength>
			<CostTollLength>0</CostTollLength>
			<CostFixed>0</CostFixed>
			<CostPoints>71.1</CostPoints>
			<CostWeight>15.64</CostWeight>
			<CostStore>0</CostStore>
			<CostSleep>0</CostSleep>
			<CostRoute>0</CostRoute>
			<Status>Finished</Status>
			<Orders>
				<Order>
					<SourceId>1</SourceId>
					<OrderCode>DNS001084V</OrderCode>
					<OrderDate>06.10.2013</OrderDate>
					<DeliveryDate>07.10.2013</DeliveryDate>
					<DeliveryTime>10:45</DeliveryTime>
					<Number>1</Number>
					<PalletNum>1</PalletNum>
					<IndexOnPallet>1</IndexOnPallet>
					<UnloadIndex>1</UnloadIndex>
					<ConsignorCode/>
					<ConsignorName/>
					<CarriageCustomerCode/>
					<CarriageCustomerName/>
					<SalesRepTeam/>
					<ConsignmentNoteCode/>
					<ConsignmentNoteDate/>
					<Status>Planned</Status>
					<ExternalOrderId/>
					<ExternalOutletId/>					
					<DepartureTime>8:15</DepartureTime>
					<NumberForCost>1</NumberForCost>
					<CostPoints>3.1</CostPoints>
					<CostWeight>0.68</CostWeight>
					<OutletCategory>1</OutletCategory>
					<RouteLengthFromPrev>0.4</RouteLengthFromPrev>					
					<PointActions>
						<Action>
							<Code>Failed</Code>
							<Value>NoStamp</Value>
							<Unit>Accounting department</Unit>
						</Action>
						<Action>
							<Code>DriversNote</Code>
							<Value>Houston, we have a problem</Value>
						</Action>
					</PointActions>
					<OrderActions>
						<Action>
							<Code>PartlyFailed</Code>
							<Value>ClientRejected</Value>
						</Action>
						<Action>
							<Code>ActPhoto</Code>
			<Value>https://atmsapi.alfasoft.by/v2/Photo/KJGKGHFGFDGFDHFHG.jpg</Value>
						</Action>
					</OrderActions>
				</Order>
				<Order>
					...
				</Order>
				<Order>
					...
				</Order>
			</Orders>
		</Route>
	</Routes>
	<UnplannedOrders>
		<Order>
			<SourceId>1</SourceId>
			<OrderCode>AA0017224</OrderCode>
			<DeliveryDate>28.08.2020</DeliveryDate>
			<OrderDate>01.08.2020</OrderDate>
			<ExternalOrderId>92375b0e-d3df-11ea-ac73-005056b13af7</ExternalOrderId>
		</Order>
		<Order>
			<SourceId>1</SourceId>
			<OrderCode>BB0030574</OrderCode>
			<DeliveryDate>28.08.2020</DeliveryDate>
			<OrderDate>14.08.2020</OrderDate>
			<ExternalOrderId>49a7274b-de07-11ea-ac73-005056b13af7</ExternalOrderId>
		</Order>
	</UnplannedOrders>
</Body>
Made on
Tilda