Получение погрузочных листов из A-TMS
Запросы HTTPS
Для запроса необходимо передать на адрес
https://atmsapi.alfasoft.by/v2/DataExchange/xml/GetLoadingList
запрос типа POST с XML данными в теле запроса. При невозможности использовать HTTPS можно обращаться по тому же адресу через HTTP, но при этом данные не будут защищены при передаче.
Формат XML файла запроса
Тэг <Body> может быть произвольным контейнером, в том числе с вложенностью. Лишние тэги игнорируются. APIKey и APISecret можно получить обратившись в службу поддержки A-TMS atms@alfasoft.by
Запрос по дате планирования:
<?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>
	<LoadingLists>
		<LoadingList>
			<LoadingListCode>TMS000042</LoadingListCode>
			<StartDate>07.10.2016</StartDate>
			<StartTime>09:00</StartTime>
			<DriverCode>1234ABCD</DriverCode>
			<DriverName>Кириллов В.В.</DriverName>
			<CarCode>АЕ1234-5</CarCode>
			<CarName>WV CRAFTER</CarName>
			<CarrierCode>123</CarrierCode>
			<CarrierName>Перевозчик</CarrierName>
			<WarehouseCode>17</WarehouseCode>
			<WarehouseName>Склад Витебск</WarehouseName>
			<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>
					<ConsignorCode/>
					<ConsignorName/>
					<CarriageCustomerCode/>
					<CarriageCustomerName/>
					<SalesRepTeam/>
					<ConsignmentNoteCode/>
					<ConsignmentNoteDate/>
					<Status>Planned</Status>
					<ExternalOrderId/>
					<ExternalOutletId/>
					<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>
					<SourceId>1</SourceId>
					<OrderCode>DNS001081V</OrderCode>
					<OrderDate>06.10.2013</OrderDate>
					<DeliveryDate>07.10.2013</DeliveryDate>
					<DeliveryTime>12:20</DeliveryTime>
					<Number>2</Number>
					<ConsignorCode/>
					<ConsignorName/>
					<CarriageCustomerCode/>
					<CarriageCustomerName/>
					<SalesRepTeam/>
					<ConsignmentNoteCode/>
					<ConsignmentNoteDate/>
					<Status>Planned</Status>
					<ExternalOrderId/>
					<ExternalOutletId/>
					<PointActions/>
					<OrderActions/>
				</Order>
				<Order>
					<SourceId>1</SourceId>
					<OrderCode>DNS001085V</OrderCode>
					<OrderDate>06.10.2013</OrderDate>
					<DeliveryDate>07.10.2013</DeliveryDate>
					<DeliveryTime>16:30</DeliveryTime>
					<Number>3</Number>
					<ConsignorCode/>
					<ConsignorName/>
					<CarriageCustomerCode/>
					<CarriageCustomerName/>
					<SalesRepTeam/>
					<ConsignmentNoteCode/>
					<ConsignmentNoteDate/>
					<Status>Planned</Status>
					<ExternalOrderId/>
					<ExternalOutletId/>
					<PointActions/>
					<OrderActions/>
				</Order>
			</Orders>
		</LoadingList>
	</LoadingLists>
</Body>
Made on
Tilda